@unbrained/pm-cli 2026.7.7 → 2026.7.9

package/dist/sdk/runtime.d.ts

@@ -2,16 +2,39 @@ 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 AggregateOptions, type AggregateResult, type ExtensionCommandOptions, type ExtensionCommandResult, type UpgradeCommandOptions, type UpgradeResult } 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 { AppendCommandOptions, AppendResult } from "../cli/commands/append.js";
+import type { ClaimResult, ReleaseResult } from "../cli/commands/claim.js";
+import type { CloseResult } from "../cli/commands/close.js";
 import { type ContractsCommandOptions, type ContractsResult } from "../cli/commands/contracts.js";
+import type { CopyResult } from "../cli/commands/copy.js";
+import type { CreateResult } from "../cli/commands/create.js";
+import type { DeleteResult } from "../cli/commands/delete.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 { FocusResult } from "../cli/commands/focus.js";
+import type { RestoreResult } from "../cli/commands/restore.js";
+import type { UpdateResult } from "../cli/commands/update.js";
 import type { UpdateManyCommandOptions } from "../cli/commands/update-many.js";
+import type { CommentsCommandOptions, CommentsResult } from "../cli/commands/comments.js";
+import type { ConfigCommandOptions, ConfigResult } from "../cli/commands/config.js";
+import type { DepsCommandOptions, DepsResult } from "../cli/commands/deps.js";
+import type { DocsCommandOptions, DocsResult } from "../cli/commands/docs.js";
+import type { FilesCommandOptions, FilesDiscoverOptions, FilesDiscoverResult, FilesResult } from "../cli/commands/files.js";
+import type { GcCommandOptions, GcResult } from "../cli/commands/gc.js";
+import type { HealthResult, RunHealthOptions } from "../cli/commands/health.js";
+import type { InitCommandOptions, InitResult } from "../cli/commands/init.js";
+import type { LearningsCommandOptions, LearningsResult } from "../cli/commands/learnings.js";
+import type { NotesCommandOptions, NotesResult } from "../cli/commands/notes.js";
+import type { ProfileApplyCommandOptions, ProfileApplyResult, ProfileLintResult, ProfileListResult, ProfileResult, ProfileShowResult, ProfileSubcommand } from "../cli/commands/profile.js";
+import type { SchemaAddFieldCommandOptions, SchemaAddFieldResult, SchemaAddStatusCommandOptions, SchemaAddStatusResult, SchemaAddTypeCommandOptions, SchemaAddTypeInferCommandOptions, SchemaAddTypeInferResult, SchemaAddTypeResult, SchemaApplyPresetCommandOptions, SchemaApplyPresetResult, SchemaInspectResult, SchemaListFieldsResult, SchemaListResult, SchemaRemoveFieldCommandOptions, SchemaRemoveFieldResult, SchemaRemoveStatusCommandOptions, SchemaRemoveStatusResult, SchemaRemoveTypeCommandOptions, SchemaRemoveTypeResult, SchemaShowFieldResult, SchemaShowResult, SchemaShowStatusResult, SchemaSubcommand } from "../cli/commands/schema.js";
+import type { ValidateCommandOptions, ValidateResult } from "../cli/commands/validate.js";
+export type { ClaimResult, CloseResult, CopyResult, CreateResult, DeleteResult, FocusResult, ReleaseResult, RestoreResult, UpdateResult, };
 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";
@@ -51,6 +74,8 @@ export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTempl
 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";
 export type { GlobalOptions } from "../core/shared/command-types.js";
+export type PackageCommandOptions = ExtensionCommandOptions;
+export type PackageCommandResult = ExtensionCommandResult;
 export type { Dependency, ItemDocument, ItemMetadata, ItemStatus, ItemType, LinkedDoc, LinkedFile, LinkedTest, LogNote, PmSettings, } from "../types/index.js";
 /**
  * Documents the get contracts options payload exchanged by command, SDK, and package integrations.
@@ -88,6 +113,37 @@ export type PmActionName = PmToolAction | (string & {});
  * Plain object option bag forwarded to the same command runners used by MCP.
  */
 export type PmActionOptions = Record<string, unknown>;
+/**
+ * Union returned by the generic schema customization helper.
+ */
+export type SchemaResult = SchemaInspectResult | SchemaListResult | SchemaShowResult | SchemaShowStatusResult | SchemaListFieldsResult | SchemaShowFieldResult | SchemaAddTypeResult | SchemaRemoveTypeResult | SchemaAddStatusResult | SchemaRemoveStatusResult | SchemaAddFieldResult | SchemaRemoveFieldResult | SchemaApplyPresetResult | SchemaAddTypeInferResult;
+/**
+ * Result returned by the SDK `startTask` lifecycle shortcut.
+ */
+export interface StartTaskResult {
+    id: string;
+    action: "start_task";
+    claim: ClaimResult;
+    update: UpdateResult;
+}
+/**
+ * Result returned by the SDK `pauseTask` lifecycle shortcut.
+ */
+export interface PauseTaskResult {
+    id: string;
+    action: "pause_task";
+    update: UpdateResult;
+    release: ReleaseResult;
+}
+/**
+ * Result returned by the SDK `closeTask` lifecycle shortcut.
+ */
+export interface CloseTaskResult {
+    id: string;
+    action: "close_task";
+    close: CloseResult;
+    release: ReleaseResult;
+}
 /**
  * Complete high-level action request for {@link runAction}.
  */
@@ -124,6 +180,11 @@ export type PmClientMutationOptions = PmActionOptions & {
     /** Return only mutation item ids when supported by the action. */
     idOnly?: boolean;
 };
+/**
+ * Mutation options accepted by typed SDK convenience helpers that always return
+ * full command result envelopes.
+ */
+export type PmClientFullMutationOptions = Omit<PmClientMutationOptions, "fullChangedFields" | "idOnly">;
 /**
  * Stable defaults applied by {@link PmClient} to every action it runs.
  */
@@ -187,54 +248,246 @@ export declare class PmClient {
      * Return project tracker statistics with the same sections as `pm stats`.
      */
     stats(options?: StatsCommandOptions): Promise<StatsResult>;
+    /**
+     * List, add, edit, or delete item comments.
+     */
+    comments(id: string, options?: CommentsCommandOptions): Promise<CommentsResult>;
+    /**
+     * List or append private item notes.
+     */
+    notes(id: string, options?: NotesCommandOptions): Promise<NotesResult>;
+    /**
+     * List or append durable item learnings.
+     */
+    learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>;
+    /**
+     * Add, remove, clear, or list linked project files for an item.
+     */
+    files(id: string, options?: FilesCommandOptions): Promise<FilesResult>;
+    /**
+     * Discover and optionally attach changed files for an item.
+     */
+    filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>;
+    /**
+     * Add, remove, clear, or list linked documentation for an item.
+     */
+    docs(id: string, options?: DocsCommandOptions): Promise<DocsResult>;
+    /**
+     * Inspect item dependency relationships.
+     */
+    deps(id: string, options?: DepsCommandOptions): Promise<DepsResult>;
+    /**
+     * Append markdown/body text to an item through the mutation pipeline.
+     */
+    append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>;
+    /**
+     * Initialize a workspace with the same semantics as `pm init`.
+     */
+    init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>;
+    /**
+     * Read or update project/global configuration.
+     */
+    config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>;
+    /**
+     * Run the schema customization surface.
+     */
+    schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>;
+    /**
+     * List built-in, custom, and extension-provided schema types/statuses.
+     */
+    schemaList(): Promise<SchemaListResult>;
+    /**
+     * Show a schema item type definition.
+     */
+    schemaShow(name: string): Promise<SchemaShowResult>;
+    /**
+     * Register or replace a custom item type.
+     */
+    schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>;
+    /**
+     * Remove a custom item type.
+     */
+    schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>;
+    /**
+     * Register or replace a custom status.
+     */
+    schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>;
+    /**
+     * Remove a custom status.
+     */
+    schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>;
+    /**
+     * Register or replace a runtime custom field.
+     */
+    schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>;
+    /**
+     * Remove a runtime custom field.
+     */
+    schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>;
+    /**
+     * List runtime custom fields.
+     */
+    schemaListFields(): Promise<SchemaListFieldsResult>;
+    /**
+     * Show one runtime custom field definition.
+     */
+    schemaShowField(name: string): Promise<SchemaShowFieldResult>;
+    /**
+     * Apply a built-in type preset to the workspace schema.
+     */
+    schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>;
+    /**
+     * Infer item types from the current tracker and optionally apply them.
+     */
+    schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>;
+    /**
+     * Show one runtime status definition.
+     */
+    schemaShowStatus(name: string): Promise<SchemaShowStatusResult>;
+    /**
+     * Run the profile customization surface.
+     */
+    profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>;
+    /**
+     * List available project profiles.
+     */
+    profileList(): Promise<ProfileListResult>;
+    /**
+     * Show a project profile.
+     */
+    profileShow(name: string): Promise<ProfileShowResult>;
+    /**
+     * Apply a project profile.
+     */
+    profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>;
+    /**
+     * Lint a project profile.
+     */
+    profileLint(name: string): Promise<ProfileLintResult>;
+    /**
+     * Run project validation checks.
+     */
+    validate(options?: ValidateCommandOptions): Promise<ValidateResult>;
+    /**
+     * Run project health checks.
+     */
+    health(options?: RunHealthOptions): Promise<HealthResult>;
+    /**
+     * Run tracker cache/runtime garbage collection.
+     */
+    gc(options?: GcCommandOptions): Promise<GcResult>;
     /**
      * Create an item using the same mutation path as `pm create`.
      */
-    create(options?: PmClientMutationOptions): Promise<unknown>;
+    create(options?: PmClientFullMutationOptions): Promise<CreateResult>;
     /**
      * Update an item using the same mutation path as `pm update`.
      */
-    update(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    update(id: string, options?: PmClientFullMutationOptions): Promise<UpdateResult>;
     /**
      * Close an item using the same mutation path as `pm close`.
      */
-    close(id: string, reason: string, options?: PmClientMutationOptions): Promise<unknown>;
+    close(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseResult>;
     /**
      * Claim an item using the same mutation path as `pm claim`.
      */
-    claim(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>;
     /**
      * Release an item's active claim using the same mutation path as `pm release`.
      */
-    release(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>;
     /**
      * Copy an item using the same mutation path as `pm copy`.
      */
-    copy(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>;
     /**
      * Delete an item using the same mutation path as `pm delete`.
      */
-    delete(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>;
     /**
      * Restore an item to a history version or timestamp using `pm restore`.
      */
-    restore(id: string, target: string, options?: PmClientMutationOptions): Promise<unknown>;
+    restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>;
     /**
      * Set, clear, or read workspace focus using the same path as `pm focus`.
      */
-    focus(id?: string, options?: PmClientMutationOptions): Promise<unknown>;
+    focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>;
     /**
      * Claim an item and transition it to the workspace in-progress status.
      */
-    startTask(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>;
     /**
      * Move an item back to the workspace open status and release the claim.
      */
-    pauseTask(id: string, options?: PmClientMutationOptions): Promise<unknown>;
+    pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>;
     /**
      * Close an item and release its active assignment.
      */
-    closeTask(id: string, reason: string, options?: PmClientMutationOptions): Promise<unknown>;
+    closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>;
+    /**
+     * Run the extension lifecycle surface with the same result shape as `pm extension`.
+     */
+    extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
+    /**
+     * List project or global extensions without constructing command-line argv.
+     */
+    extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
+    /**
+     * Enable an installed extension using the same action as `pm extension activate`.
+     */
+    extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
+    /**
+     * Disable an installed extension using the same action as `pm extension deactivate`.
+     */
+    extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
+    /**
+     * Run the package lifecycle surface with package vocabulary preserved.
+     */
+    package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * List project or global packages through the package lifecycle primitive.
+     */
+    packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Install a package or extension source using the same action as `pm package install`.
+     */
+    packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Uninstall a package or extension using the same action as `pm package uninstall`.
+     */
+    packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Read package lifecycle diagnostics using the same action as `pm package doctor`.
+     */
+    packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Inspect managed package state using the same action as `pm package manage`.
+     */
+    packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Describe installed package surfaces using the same action as `pm package describe`.
+     */
+    packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Reload installed package extensions using the same action as `pm package reload`.
+     */
+    packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Read bundled package catalog metadata using the same action as `pm package catalog`.
+     */
+    packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Enable an installed package using the same action as `pm package activate`.
+     */
+    packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Disable an installed package using the same action as `pm package deactivate`.
+     */
+    packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Upgrade the pm CLI and/or managed packages through the public SDK dispatcher.
+     */
+    upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>;
 }
 /**
  * Return the same context snapshot produced by `pm context` without constructing
@@ -270,54 +523,246 @@ export declare function aggregate(options?: AggregateOptions, clientOptions?: Pm
  * without constructing a reusable client.
  */
 export declare function stats(options?: StatsCommandOptions, clientOptions?: PmClientOptions): Promise<StatsResult>;
+/**
+ * List, add, edit, or delete item comments without constructing a reusable client.
+ */
+export declare function comments(id: string, options?: CommentsCommandOptions, clientOptions?: PmClientOptions): Promise<CommentsResult>;
+/**
+ * List or append private item notes without constructing a reusable client.
+ */
+export declare function notes(id: string, options?: NotesCommandOptions, clientOptions?: PmClientOptions): Promise<NotesResult>;
+/**
+ * List or append durable item learnings without constructing a reusable client.
+ */
+export declare function learnings(id: string, options?: LearningsCommandOptions, clientOptions?: PmClientOptions): Promise<LearningsResult>;
+/**
+ * Manage linked item files without constructing a reusable client.
+ */
+export declare function files(id: string, options?: FilesCommandOptions, clientOptions?: PmClientOptions): Promise<FilesResult>;
+/**
+ * Discover linked item files without constructing a reusable client.
+ */
+export declare function filesDiscover(id: string, options?: FilesDiscoverOptions, clientOptions?: PmClientOptions): Promise<FilesDiscoverResult>;
+/**
+ * Manage linked item docs without constructing a reusable client.
+ */
+export declare function docs(id: string, options?: DocsCommandOptions, clientOptions?: PmClientOptions): Promise<DocsResult>;
+/**
+ * Inspect item dependency relationships without constructing a reusable client.
+ */
+export declare function deps(id: string, options?: DepsCommandOptions, clientOptions?: PmClientOptions): Promise<DepsResult>;
+/**
+ * Append markdown/body text to an item without constructing a reusable client.
+ */
+export declare function append(id: string, body: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<AppendResult>;
+/**
+ * Initialize a workspace without constructing a reusable client.
+ */
+export declare function init(prefix?: string, options?: InitCommandOptions, clientOptions?: PmClientOptions): Promise<InitResult>;
+/**
+ * Read or update configuration without constructing a reusable client.
+ */
+export declare function config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions, clientOptions?: PmClientOptions): Promise<ConfigResult>;
+/**
+ * Run the schema customization surface without constructing a reusable client.
+ */
+export declare function schema(subcommand: SchemaSubcommand, options?: PmActionOptions, clientOptions?: PmClientOptions): Promise<SchemaResult>;
+/**
+ * List schema definitions without constructing a reusable client.
+ */
+export declare function schemaList(clientOptions?: PmClientOptions): Promise<SchemaListResult>;
+/**
+ * Show a schema item type without constructing a reusable client.
+ */
+export declare function schemaShow(name: string, clientOptions?: PmClientOptions): Promise<SchemaShowResult>;
+/**
+ * Register a custom item type without constructing a reusable client.
+ */
+export declare function schemaAddType(name: string, options?: SchemaAddTypeCommandOptions, clientOptions?: PmClientOptions): Promise<SchemaAddTypeResult>;
+/**
+ * Remove a custom item type without constructing a reusable client.
+ */
+export declare function schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions, clientOptions?: PmClientOptions): Promise<SchemaRemoveTypeResult>;
+/**
+ * Register a custom status without constructing a reusable client.
+ */
+export declare function schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions, clientOptions?: PmClientOptions): Promise<SchemaAddStatusResult>;
+/**
+ * Remove a custom status without constructing a reusable client.
+ */
+export declare function schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions, clientOptions?: PmClientOptions): Promise<SchemaRemoveStatusResult>;
+/**
+ * Register a custom field without constructing a reusable client.
+ */
+export declare function schemaAddField(name: string, options?: SchemaAddFieldCommandOptions, clientOptions?: PmClientOptions): Promise<SchemaAddFieldResult>;
+/**
+ * Remove a custom field without constructing a reusable client.
+ */
+export declare function schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions, clientOptions?: PmClientOptions): Promise<SchemaRemoveFieldResult>;
+/**
+ * List custom fields without constructing a reusable client.
+ */
+export declare function schemaListFields(clientOptions?: PmClientOptions): Promise<SchemaListFieldsResult>;
+/**
+ * Show a custom field without constructing a reusable client.
+ */
+export declare function schemaShowField(name: string, clientOptions?: PmClientOptions): Promise<SchemaShowFieldResult>;
+/**
+ * Apply a schema preset without constructing a reusable client.
+ */
+export declare function schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions, clientOptions?: PmClientOptions): Promise<SchemaApplyPresetResult>;
+/**
+ * Infer schema types without constructing a reusable client.
+ */
+export declare function schemaInferTypes(options?: SchemaAddTypeInferCommandOptions, clientOptions?: PmClientOptions): Promise<SchemaAddTypeInferResult>;
+/**
+ * Show a custom status without constructing a reusable client.
+ */
+export declare function schemaShowStatus(name: string, clientOptions?: PmClientOptions): Promise<SchemaShowStatusResult>;
+/**
+ * Run the profile customization surface without constructing a reusable client.
+ */
+export declare function profile(subcommand: ProfileSubcommand, options?: PmActionOptions, clientOptions?: PmClientOptions): Promise<ProfileResult>;
+/**
+ * List profiles without constructing a reusable client.
+ */
+export declare function profileList(clientOptions?: PmClientOptions): Promise<ProfileListResult>;
+/**
+ * Show a profile without constructing a reusable client.
+ */
+export declare function profileShow(name: string, clientOptions?: PmClientOptions): Promise<ProfileShowResult>;
+/**
+ * Apply a profile without constructing a reusable client.
+ */
+export declare function profileApply(name: string, options?: ProfileApplyCommandOptions, clientOptions?: PmClientOptions): Promise<ProfileApplyResult>;
+/**
+ * Lint a profile without constructing a reusable client.
+ */
+export declare function profileLint(name: string, clientOptions?: PmClientOptions): Promise<ProfileLintResult>;
+/**
+ * Validate a tracker without constructing a reusable client.
+ */
+export declare function validate(options?: ValidateCommandOptions, clientOptions?: PmClientOptions): Promise<ValidateResult>;
+/**
+ * Run health checks without constructing a reusable client.
+ */
+export declare function health(options?: RunHealthOptions, clientOptions?: PmClientOptions): Promise<HealthResult>;
+/**
+ * Run cache/runtime garbage collection without constructing a reusable client.
+ */
+export declare function gc(options?: GcCommandOptions, clientOptions?: PmClientOptions): Promise<GcResult>;
 /**
  * Create an item without constructing a reusable client.
  */
-export declare function create(options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function create(options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<CreateResult>;
 /**
  * Update an item without constructing a reusable client.
  */
-export declare function update(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function update(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<UpdateResult>;
 /**
  * Close an item without constructing a reusable client.
  */
-export declare function close(id: string, reason: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function close(id: string, reason: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<CloseResult>;
 /**
  * Claim an item without constructing a reusable client.
  */
-export declare function claim(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function claim(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<ClaimResult>;
 /**
  * Release an item's active claim without constructing a reusable client.
  */
-export declare function release(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function release(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<ReleaseResult>;
 /**
  * Copy an item without constructing a reusable client.
  */
-export declare function copy(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function copy(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<CopyResult>;
 /**
  * Delete an item without constructing a reusable client.
  */
-export declare function deleteItem(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function deleteItem(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<DeleteResult>;
 /**
  * Restore an item without constructing a reusable client.
  */
-export declare function restore(id: string, target: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function restore(id: string, target: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<RestoreResult>;
 /**
  * Set, clear, or read workspace focus without constructing a reusable client.
  */
-export declare function focus(id?: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function focus(id?: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<FocusResult>;
 /**
  * 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>;
+export declare function startTask(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<StartTaskResult>;
 /**
  * Move an item to open and release it without constructing a client.
  */
-export declare function pauseTask(id: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+export declare function pauseTask(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<PauseTaskResult>;
 /**
  * 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>;
+export declare function closeTask(id: string, reason: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<CloseTaskResult>;
+/**
+ * Run the extension lifecycle surface without constructing a reusable client.
+ */
+export declare function extension(target?: string, options?: ExtensionCommandOptions, clientOptions?: PmClientOptions): Promise<ExtensionCommandResult>;
+/**
+ * List extensions without constructing a reusable client.
+ */
+export declare function extensionList(options?: ExtensionCommandOptions, clientOptions?: PmClientOptions): Promise<ExtensionCommandResult>;
+/**
+ * Enable an extension without constructing a reusable client.
+ */
+export declare function extensionActivate(target: string, options?: ExtensionCommandOptions, clientOptions?: PmClientOptions): Promise<ExtensionCommandResult>;
+/**
+ * Disable an extension without constructing a reusable client.
+ */
+export declare function extensionDeactivate(target: string, options?: ExtensionCommandOptions, clientOptions?: PmClientOptions): Promise<ExtensionCommandResult>;
+/**
+ * Run the package lifecycle surface without constructing a reusable client.
+ */
+export declare function packageLifecycle(target?: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * List packages without constructing a reusable client.
+ */
+export declare function packageList(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Install a package or extension source without constructing a reusable client.
+ */
+export declare function packageInstall(target: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Uninstall a package or extension without constructing a reusable client.
+ */
+export declare function packageUninstall(target: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Read package lifecycle diagnostics without constructing a reusable client.
+ */
+export declare function packageDoctor(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Inspect managed package state without constructing a reusable client.
+ */
+export declare function packageManage(target?: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Describe package surfaces without constructing a reusable client.
+ */
+export declare function packageDescribe(target?: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Reload package extensions without constructing a reusable client.
+ */
+export declare function packageReload(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Read bundled package catalog metadata without constructing a reusable client.
+ */
+export declare function packageCatalog(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Enable a package without constructing a reusable client.
+ */
+export declare function packageActivate(target: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Disable a package without constructing a reusable client.
+ */
+export declare function packageDeactivate(target: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Upgrade the pm CLI and/or managed packages without constructing a reusable client.
+ */
+export declare function upgrade(target?: string, options?: UpgradeCommandOptions, clientOptions?: PmClientOptions): Promise<UpgradeResult>;
 /**
  * Implements get workspace contracts for the public runtime surface of this module.
  */
@@ -384,3 +829,4 @@ declare global {
     var __pmCliActionRunnerTestHooks: typeof actionRunnerTestHooks | undefined;
 }
 export type { ContractsCommandOptions, ContractsResult };
+export type { AppendCommandOptions, AppendResult, CommentsCommandOptions, CommentsResult, ConfigCommandOptions, ConfigResult, DepsCommandOptions, DepsResult, DocsCommandOptions, DocsResult, ExtensionCommandOptions, ExtensionCommandResult, FilesCommandOptions, FilesDiscoverOptions, FilesDiscoverResult, FilesResult, GcCommandOptions, GcResult, HealthResult, InitCommandOptions, InitResult, LearningsCommandOptions, LearningsResult, NotesCommandOptions, NotesResult, ProfileApplyCommandOptions, ProfileApplyResult, ProfileLintResult, ProfileListResult, ProfileResult, ProfileShowResult, ProfileSubcommand, RunHealthOptions, SchemaAddFieldCommandOptions, SchemaAddFieldResult, SchemaAddStatusCommandOptions, SchemaAddStatusResult, SchemaAddTypeCommandOptions, SchemaAddTypeInferCommandOptions, SchemaAddTypeInferResult, SchemaAddTypeResult, SchemaApplyPresetCommandOptions, SchemaApplyPresetResult, SchemaInspectResult, SchemaListFieldsResult, SchemaListResult, SchemaRemoveFieldCommandOptions, SchemaRemoveFieldResult, SchemaRemoveStatusCommandOptions, SchemaRemoveStatusResult, SchemaRemoveTypeCommandOptions, SchemaRemoveTypeResult, SchemaShowFieldResult, SchemaShowResult, SchemaShowStatusResult, SchemaSubcommand, UpgradeCommandOptions, UpgradeResult, ValidateCommandOptions, ValidateResult, };