@unbrained/pm-cli 2026.7.19 → 2026.7.20

package/dist/sdk/runtime.d.ts

@@ -16,6 +16,7 @@ import { type HistoryCompactBulkCommandOptions, type HistoryCompactBulkResult, t
 import { type HistoryRedactCommandOptions, type HistoryRedactResult } from "./history-redact.js";
 import { type HistoryRepairAllResult, type HistoryRepairCommandOptions, type HistoryRepairResult } from "./history-repair.js";
 import { actionGlobalOptions as globalOptions, closeManyOptionsFromFlat, extensionOptionsFromArgs, mutationListOptions, normalizeActionName, normalizeCommandPath, normalizeMcpOptionsArrays, normalizeMcpUpdateOptions, optionsWithAuthor, readRuntimeScalarString as readScalarString, readRuntimeScalarStringAllowBlank as readScalarStringAllowBlank, readRuntimeStringArray as readStringArray, updateManyOptionsFromFlat, withAddNoteOption, withFilesDiscoveryOptions, withMutationCompaction } from "./runtime-input.js";
+import type { PmCloseActionOptions, PmCreateActionOptions, PmUpdateActionOptions } from "./cli-contracts/typed-action-inputs.js";
 import { type GraphCommandOptions, type GraphResult, type GraphSubcommand } from "./graph/run.js";
 import type { ContextOptions, ContextResult } from "../cli/commands/context.js";
 import type { GetOptions, GetResult } from "../cli/commands/get.js";
@@ -68,7 +69,7 @@ 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 ListFullResult, type ListCompactResult, type ListedItem, type ListOptions, type ListProjectedItem, type ListResult, type ListResultItem, type ListSortField, type ListSortOrder, type ListTreeItem, type ListTreeMetadata, type ListVerboseResult, } from "./query/list.js";
+export { runList, type ListFullResult, type ListCompactResult, type ListedItem, type ListOptions, type ListProjectedItem, type ListProjectedItemCore, type ListResult, type ListResultItem, type ListSortField, type ListSortOrder, type ListTreeItem, type ListTreeMetadata, type ListVerboseResult, } from "./query/list.js";
 export { runClose, type CloseCommandOptions } from "../cli/commands/close.js";
 export { runUpdate, type UpdateCommandOptions, } from "../cli/commands/update.js";
 export { NEXT_OUTPUT_VALUES, runNext, type NextActionableItem, type NextBlockerRef, type NextOptions, type NextOutputFormat, type NextRecommendation, type NextResult, } from "../cli/commands/next.js";
@@ -115,11 +116,11 @@ export interface WorkspaceContracts {
     types: string[];
     /** Value that configures or reports statuses for this contract. */
     statuses: string[];
-    /** Lifecycle state reported for openthe record. */
+    /** Configured status id representing the open lifecycle state. */
     openStatus: string;
-    /** Lifecycle state reported for closethe record. */
+    /** Configured status id representing the closed lifecycle state. */
     closeStatus: string;
-    /** Lifecycle state reported for canceledthe record. */
+    /** Configured status id representing the canceled lifecycle state. */
     canceledStatus: string;
 }
 /**
@@ -184,6 +185,8 @@ export type PmClientRunArgs = Omit<PmActionInput, "action"> & {
     idOnly?: boolean;
     action?: never;
 };
+/** Typed close-option bag accepted by {@link PmClient.close}: the contract-derived close options minus the positional `reason` parameter and its MCP `text` alias. */
+export type PmClientCloseActionOptions = Omit<PmCloseActionOptions, "reason" | "text">;
 /** Command options accepted by PmClient mutation convenience methods. */
 export type PmClientMutationOptions = PmActionOptions & {
     /** Return full `changed_fields` arrays for this mutation instead of the compact SDK default. */
@@ -202,7 +205,7 @@ export interface ClaimNextOptions extends PmClientFullMutationOptions {
  * Stable defaults applied by {@link PmClient} to every action it runs.
  */
 export interface PmClientOptions {
-    /** Tracker root to pass as the SDK equivalent of `--path`. */
+    /** Tracker root to pass as the SDK equivalent of `--pm-path`. */
     pmRoot?: string;
     /** Working directory used for workspace and extension resolution. */
     cwd?: string;
@@ -358,12 +361,12 @@ export declare class PmClient {
     planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>;
     /** Materialize selected plan steps into governed tracker items. */
     planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
-    /** Create an item using the same mutation path as `pm create`. */
-    create(options?: PmClientFullMutationOptions): Promise<CreateResult>;
-    /** Update an item using the same mutation path as `pm update`. */
-    update(id: string, options?: PmClientFullMutationOptions): Promise<UpdateResult>;
-    /** Close an item using the same mutation path as `pm close`. */
-    close(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseResult>;
+    /** Create an item using the same mutation path as `pm create`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
+    create(options?: PmCreateActionOptions): Promise<CreateResult>;
+    /** Update an item using the same mutation path as `pm update`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
+    update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>;
+    /** Close an item using the same mutation path as `pm close`. Options are contract-typed (pm-x29o); the close reason is the positional parameter, so the option bag omits `reason`/`text`. */
+    close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>;
     /** Claim an item using the same mutation path as `pm claim`. */
     claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>;
     /** Atomically claim the highest-ranked available item using the public next-work filters. */
@@ -511,11 +514,11 @@ export declare function historyCompact(id: string, options?: HistoryCompactComma
 /** Compact selected history streams without constructing a reusable client. */
 export declare function historyCompactBulk(options: HistoryCompactBulkCommandOptions, clientOptions?: PmClientOptions): Promise<HistoryCompactBulkResult>;
 /** Create an item without constructing a reusable client. */
-export declare function create(options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<CreateResult>;
+export declare function create(options?: PmCreateActionOptions, clientOptions?: PmClientOptions): Promise<CreateResult>;
 /** Update an item without constructing a reusable client. */
-export declare function update(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<UpdateResult>;
+export declare function update(id: string, options?: PmUpdateActionOptions, clientOptions?: PmClientOptions): Promise<UpdateResult>;
 /** Close an item without constructing a reusable client. */
-export declare function close(id: string, reason: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<CloseResult>;
+export declare function close(id: string, reason: string, options?: PmClientCloseActionOptions, clientOptions?: PmClientOptions): Promise<CloseResult>;
 /** Claim an item without constructing a reusable client. */
 export declare function claim(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<ClaimResult>;
 /** Atomically select and claim ranked work without constructing a reusable client. */

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]="24d809ae-5fa7-5634-bf07-98a909167346")}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]="3c871a52-7441-592b-9522-4c1b3f0c3ed5")}catch(e){}}();
 export { PM_GITIGNORE_END, PM_GITIGNORE_START, ensurePmGitignore, getPmGitignoreBlock, } from "./workspace.js";
 import path from "node:path";
 import { createEmptyExtensionCommandRegistry, createEmptyExtensionHookRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionRegistrationRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionServiceRegistry, } from "../core/extensions/extension-registries.js";
@@ -422,18 +422,18 @@ export class PmClient {
     planMaterialize(id, options) {
         return this.plan("materialize", id, options);
     }
-    /** Create an item using the same mutation path as `pm create`. */
+    /** Create an item using the same mutation path as `pm create`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
     create(options = {}) {
         return this.runTyped("create", splitFullClientMutationOptions(options));
     }
-    /** Update an item using the same mutation path as `pm update`. */
+    /** Update an item using the same mutation path as `pm update`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
     update(id, options = {}) {
         return this.runTyped("update", {
             id,
             ...splitFullClientMutationOptions(options),
         });
     }
-    /** Close an item using the same mutation path as `pm close`. */
+    /** Close an item using the same mutation path as `pm close`. Options are contract-typed (pm-x29o); the close reason is the positional parameter, so the option bag omits `reason`/`text`. */
     close(id, reason, options = {}) {
         return this.runTyped("close", {
             id,
@@ -1826,4 +1826,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=24d809ae-5fa7-5634-bf07-98a909167346
+//# debugId=3c871a52-7441-592b-9522-4c1b3f0c3ed5