@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/sdk/relationships.d.ts

@@ -9,79 +9,79 @@ import { type RelationshipKindDefinition } from "./relationship-kinds/contract.j
 export { BUILTIN_RELATIONSHIP_KINDS, type RelationshipCardinality, type RelationshipDirection, type RelationshipHierarchyDirection, type RelationshipKindDefinition, type RelationshipLifecycle, type RelationshipOutcomeTraversal, type RelationshipPrecedence, type RelationshipTemporalOrder, type RelationshipTraversalFamily, } from "./relationship-kinds/contract.js";
 /** One normalized relationship edge indexed by the graph kernel. */
 export interface RelationshipEdge {
-    /** Source node identifier. */
-    source: string;
-    /** Target node identifier. */
-    target: string;
-    /** Canonical relationship kind. */
-    kind: string;
-    /** Optional creation timestamp retained from storage. */
-    createdAt?: string;
-    /** Optional author retained from storage. */
-    author?: string;
-    /** Optional application-owned edge payload. */
-    payload?: Readonly<Record<string, unknown>>;
+/** Source node identifier. */
+source: string;
+/** Target node identifier. */
+target: string;
+/** Canonical relationship kind. */
+kind: string;
+/** Optional creation timestamp retained from storage. */
+createdAt?: string;
+/** Optional author retained from storage. */
+author?: string;
+/** Optional application-owned edge payload. */
+payload?: Readonly<Record<string, unknown>>;
 }
 /** Direction used by adjacency, closure, and path traversal. */
 export type RelationshipTraversalDirection = "outgoing" | "incoming" | "both";
 /** Shared bounded-query controls. */
 export interface RelationshipQueryOptions {
-    /** Edge kinds to traverse after alias normalization. */
-    kinds?: readonly string[];
-    /** Traversal direction relative to each visited node. */
-    direction?: RelationshipTraversalDirection;
-    /** Maximum number of returned nodes, excluding the starting node. */
-    limit?: number;
-    /** Maximum traversal depth. */
-    maxDepth?: number;
-    /** Abort signal checked throughout traversal. */
-    signal?: AbortSignal;
+/** Edge kinds to traverse after alias normalization. */
+kinds?: readonly string[];
+/** Traversal direction relative to each visited node. */
+direction?: RelationshipTraversalDirection;
+/** Maximum number of returned nodes, excluding the starting node. */
+limit?: number;
+/** Maximum traversal depth. */
+maxDepth?: number;
+/** Abort signal checked throughout traversal. */
+signal?: AbortSignal;
 }
 /** Cost and truncation metadata returned by every graph query. */
 export interface RelationshipQueryMeta {
-    /** Number of nodes removed from the traversal frontier. */
-    visitedNodes: number;
-    /** Number of candidate edges inspected. */
-    inspectedEdges: number;
-    /** Whether a configured bound stopped traversal. */
-    truncated: boolean;
-    /** Deterministic continuation cursor for the final returned node. */
-    nextCursor?: string;
+/** Number of nodes removed from the traversal frontier. */
+visitedNodes: number;
+/** Number of candidate edges inspected. */
+inspectedEdges: number;
+/** Whether a configured bound stopped traversal. */
+truncated: boolean;
+/** Deterministic continuation cursor for the final returned node. */
+nextCursor?: string;
 }
 /** Generic bounded graph query result. */
 export interface RelationshipQueryResult<T> {
-    /** Deterministically ordered query value. */
-    value: T;
-    /** Explicit query work and truncation metadata. */
-    meta: RelationshipQueryMeta;
+/** Deterministically ordered query value. */
+value: T;
+/** Explicit query work and truncation metadata. */
+meta: RelationshipQueryMeta;
 }
 /** One neighbor row pairing an adjacent node with the edge that connects it. */
 export interface RelationshipNeighborEdge {
-    /** Adjacent node identifier. */
-    id: string;
-    /** Edge connecting the queried node to this neighbor. */
-    edge: RelationshipEdge;
+/** Adjacent node identifier. */
+id: string;
+/** Edge connecting the queried node to this neighbor. */
+edge: RelationshipEdge;
 }
 /** Induced subgraph returned by bounded traversal. */
 export interface RelationshipSubgraph {
-    /** Deterministically ordered node identifiers. */
-    nodes: string[];
-    /** Deterministically ordered edges whose endpoints are both present. */
-    edges: RelationshipEdge[];
+/** Deterministically ordered node identifiers. */
+nodes: string[];
+/** Deterministically ordered edges whose endpoints are both present. */
+edges: RelationshipEdge[];
 }
 /** Mutable registry with immutable snapshots and collision-safe extension registration. */
 export declare class RelationshipKindRegistry {
-    #private;
-    /** Create a registry initialized with the stable built-in ontology by default. */
-    constructor(definitions?: readonly RelationshipKindDefinition[]);
-    /** Register one definition after validating its identifier, version, and aliases. */
-    register(definition: RelationshipKindDefinition): this;
-    /** Resolve a canonical kind or compatibility alias. */
-    resolve(kind: unknown): RelationshipKindDefinition | undefined;
-    /** Resolve a kind or throw a precise error suitable for command adapters. */
-    require(kind: string): RelationshipKindDefinition;
-    /** Return a deterministic immutable registry snapshot. */
-    list(): readonly RelationshipKindDefinition[];
+#private;
+/** Create a registry initialized with the stable built-in ontology by default. */
+constructor(definitions?: readonly RelationshipKindDefinition[]);
+/** Register one definition after validating its identifier, version, and aliases. */
+register(definition: RelationshipKindDefinition): this;
+/** Resolve a canonical kind or compatibility alias. */
+resolve(kind: unknown): RelationshipKindDefinition | undefined;
+/** Resolve a kind or throw a precise error suitable for command adapters. */
+require(kind: string): RelationshipKindDefinition;
+/** Return a deterministic immutable registry snapshot. */
+list(): readonly RelationshipKindDefinition[];
 }
 /** Create a registry containing the built-in relationship ontology. */
 export declare function createRelationshipKindRegistry(): RelationshipKindRegistry;
@@ -102,31 +102,31 @@ export declare function isOrderingRelationshipKind(kind: string, registry?: Rela
 export declare function assertRelationshipEdgeAllowed(source: string, target: string, kind: string, registry?: RelationshipKindRegistry): RelationshipKindDefinition;
 /** Build an immutable, deterministic in-memory relationship index. */
 export declare class RelationshipGraph {
-    #private;
-    /** Validate and index nodes and edges without reading tracker storage. */
-    constructor(nodes: Iterable<string>, edges: Iterable<RelationshipEdge>, registry?: RelationshipKindRegistry);
-    /** Build the graph directly from item metadata, including hierarchy and legacy blocker fields. */
-    static fromItems(items: readonly Pick<ItemMetadata, "id" | "parent" | "blocked_by" | "dependencies">[], registry?: RelationshipKindRegistry): RelationshipGraph;
-    /** Return the deterministic immutable edge snapshot. */
-    edges(): readonly RelationshipEdge[];
-    /** Return the deterministic immutable edges incident to one node. */
-    incidentEdges(id: string): readonly RelationshipEdge[];
-    /** Return the deterministic immutable node snapshot. */
-    nodes(): readonly string[];
-    /** Report whether an identifier names an indexed node. */
-    hasNode(id: string): boolean;
-    /** Return the registry that interprets this graph's relationship kinds. */
-    registry(): RelationshipKindRegistry;
-    /** Return one-hop adjacent node identifiers. */
-    adjacency(id: string, options?: RelationshipQueryOptions): RelationshipQueryResult<string[]>;
-    /** Return deterministic one-hop neighbor rows paired with each connecting edge. */
-    neighborEdges(id: string, options?: RelationshipQueryOptions): RelationshipQueryResult<RelationshipNeighborEdge[]>;
-    /** Return bounded transitive closure in breadth-first discovery order. */
-    closure(id: string, options?: RelationshipQueryOptions): RelationshipQueryResult<string[]>;
-    /** Return a deterministic shortest path, or an empty array when disconnected. */
-    shortestPath(source: string, target: string, options?: RelationshipQueryOptions): RelationshipQueryResult<string[]>;
-    /** Return the induced subgraph over a bounded closure including the root. */
-    subgraph(id: string, options?: RelationshipQueryOptions): RelationshipQueryResult<RelationshipSubgraph>;
+#private;
+/** Validate and index nodes and edges without reading tracker storage. */
+constructor(nodes: Iterable<string>, edges: Iterable<RelationshipEdge>, registry?: RelationshipKindRegistry);
+/** Build the graph directly from item metadata, including hierarchy and legacy blocker fields. */
+static fromItems(items: readonly Pick<ItemMetadata, "id" | "parent" | "blocked_by" | "dependencies">[], registry?: RelationshipKindRegistry): RelationshipGraph;
+/** Return the deterministic immutable edge snapshot. */
+edges(): readonly RelationshipEdge[];
+/** Return the deterministic immutable edges incident to one node. */
+incidentEdges(id: string): readonly RelationshipEdge[];
+/** Return the deterministic immutable node snapshot. */
+nodes(): readonly string[];
+/** Report whether an identifier names an indexed node. */
+hasNode(id: string): boolean;
+/** Return the registry that interprets this graph's relationship kinds. */
+registry(): RelationshipKindRegistry;
+/** Return one-hop adjacent node identifiers. */
+adjacency(id: string, options?: RelationshipQueryOptions): RelationshipQueryResult<string[]>;
+/** Return deterministic one-hop neighbor rows paired with each connecting edge. */
+neighborEdges(id: string, options?: RelationshipQueryOptions): RelationshipQueryResult<RelationshipNeighborEdge[]>;
+/** Return bounded transitive closure in breadth-first discovery order. */
+closure(id: string, options?: RelationshipQueryOptions): RelationshipQueryResult<string[]>;
+/** Return a deterministic shortest path, or an empty array when disconnected. */
+shortestPath(source: string, target: string, options?: RelationshipQueryOptions): RelationshipQueryResult<string[]>;
+/** Return the induced subgraph over a bounded closure including the root. */
+subgraph(id: string, options?: RelationshipQueryOptions): RelationshipQueryResult<RelationshipSubgraph>;
 }
 /** Convert one stored dependency into the public relationship edge contract. */
 export declare function dependencyToRelationship(source: string, dependency: Dependency, registry?: RelationshipKindRegistry): RelationshipEdge;

package/dist/sdk/reproducibility/process.d.ts

@@ -1,9 +1,9 @@
 import { type ReproducibleExecutionSettings, type ReproducibleExecutionRunner } from "../../core/reproducibility/context.js";
 /** Stable environment-variable names understood by every pm process transport. */
 export declare const PM_REPRODUCIBLE_PROCESS_ENV: Readonly<{
-    readonly clock: "PM_CLOCK";
-    readonly tickMs: "PM_CLOCK_TICK_MS";
-    readonly seed: "PM_SEED";
+readonly clock: "PM_CLOCK";
+readonly tickMs: "PM_CLOCK_TICK_MS";
+readonly seed: "PM_SEED";
 }>;
 /** Environment-shaped input accepted by the reproducible process adapter. */
 export type ReproducibleProcessEnvironment = Readonly<Record<string, string | undefined>>;

package/dist/sdk/runtime/context.d.ts

@@ -16,20 +16,20 @@ type ExtensionActivationResult = Awaited<ReturnType<typeof activateExtensions>>;
  * disabled, no workspace exists yet, or activation failed (see {@link withActiveExtensions}).
  */
 type ActiveExtensionRuntime = {
-    registrations: ExtensionActivationResult["registrations"];
-    commands: ExtensionActivationResult["commands"];
-    pmRoot: string;
-    packages: readonly PmContextIntentPackageModule[];
+registrations: ExtensionActivationResult["registrations"];
+commands: ExtensionActivationResult["commands"];
+pmRoot: string;
+packages: readonly PmContextIntentPackageModule[];
 };
 /** Normalized action arguments and active runtime state passed to a built-in handler. */
 interface McpActionDispatchContext {
-    action: string;
-    args: Record<string, unknown>;
-    options: Record<string, unknown>;
-    id: string | undefined;
-    force: boolean;
-    global: GlobalOptions;
-    activeExtensions: ActiveExtensionRuntime | null;
+action: string;
+args: Record<string, unknown>;
+options: Record<string, unknown>;
+id: string | undefined;
+force: boolean;
+global: GlobalOptions;
+activeExtensions: ActiveExtensionRuntime | null;
 }
 /** Built-in action handler returning a value or asynchronous result before read projection. */
 type McpActionHandler = (ctx: McpActionDispatchContext) => Promise<unknown> | unknown;

package/dist/sdk/runtime-action-aliases.d.ts

@@ -1,6 +1,6 @@
 interface SdkActionAlias {
-    action: string;
-    options?: Record<string, unknown>;
+action: string;
+options?: Record<string, unknown>;
 }
 /** Canonical action and default-option routing for every SDK alias. */
 export declare const SDK_ACTION_ALIASES: Readonly<Record<string, SdkActionAlias>>;

package/dist/sdk/runtime-extended-actions.d.ts

@@ -6,14 +6,14 @@
 import type { GlobalOptions } from "../core/shared/command-types.js";
 /** Minimal dispatch context shared with the generic runtime action registry. */
 export interface RuntimeExtendedActionContext {
-    /** Canonical action selected after alias normalization. */
-    action: string;
-    /** Complete action request, including transport-level fields. */
-    args: Record<string, unknown>;
-    /** Normalized command options. */
-    options: Record<string, unknown>;
-    /** Workspace and rendering controls shared by direct SDK runners. */
-    global: GlobalOptions;
+/** Canonical action selected after alias normalization. */
+action: string;
+/** Complete action request, including transport-level fields. */
+args: Record<string, unknown>;
+/** Normalized command options. */
+options: Record<string, unknown>;
+/** Workspace and rendering controls shared by direct SDK runners. */
+global: GlobalOptions;
 }
 /** Dispatch search relevance evaluation through the public SDK runner. */
 export declare function runRuntimeEvalAction(context: RuntimeExtendedActionContext): Promise<unknown>;

package/dist/sdk/runtime-input.d.ts

@@ -43,9 +43,9 @@ export declare function readRuntimeStringArray(value: unknown): string[];
 export declare function extensionOptionsFromArgs(args: Record<string, unknown>, options: Record<string, unknown>): Record<string, unknown>;
 /** Mutation tools (create/update/close/append/update-many) return a verbose `changed_fields` array. On the agent path we drop it to a `changed_field_count` by default for token efficiency, restoring the full array only when the caller explicitly passes the MCP-level fullChangedFields=true control. Mutation options are forwarded unchanged so runtime fields named `full` remain valid user data. */
 export declare function withMutationCompaction(args: Record<string, unknown>, options?: Record<string, unknown> | null): {
-    changedFields: "full" | "compact";
-    idOnly: boolean;
-    runnerOptions: Record<string, unknown>;
+changedFields: "full" | "compact";
+idOnly: boolean;
+runnerOptions: Record<string, unknown>;
 };
 /** Translate flat MCP filter parameters into the shared list-option shape. */
 export declare function mutationListOptions(options: Record<string, unknown>): ListOptions;

package/dist/sdk/runtime-public-contracts.d.ts

@@ -16,42 +16,42 @@ import type { WorkflowPolicyActionResult } from "./governance/workflow-policy.js
 import type { SchemaAddFieldResult, SchemaAddStatusResult, SchemaAddTypeInferResult, SchemaAddTypeResult, SchemaApplyPresetResult, SchemaEvolutionMigrationResult, SchemaInspectResult, SchemaListFieldsResult, SchemaListResult, SchemaRemoveFieldResult, SchemaRemoveStatusResult, SchemaRemoveTypeResult, SchemaShowFieldResult, SchemaShowResult, SchemaShowStatusResult } from "./schema.js";
 /** Options accepted by the SDK contracts snapshot helper. */
 export interface GetContractsOptions extends ContractsCommandOptions {
-    /** Explicit tracker root. */
-    pmRoot?: string;
-    /** Workspace resolution directory. */
-    cwd?: string;
-    /** Disable workspace extension discovery. */
-    noExtensions?: boolean;
-    /** Suppress non-result output. */
-    quiet?: boolean;
-    /** Include profile timing data. */
-    profile?: boolean;
+/** Explicit tracker root. */
+pmRoot?: string;
+/** Workspace resolution directory. */
+cwd?: string;
+/** Disable workspace extension discovery. */
+noExtensions?: boolean;
+/** Suppress non-result output. */
+quiet?: boolean;
+/** Include profile timing data. */
+profile?: boolean;
 }
 /** Options accepted by the workspace contract resolver. */
 export interface WorkspaceContractsOptions {
-    /** Pre-resolved extension registrations, or null to disable them. */
-    extensionRegistrations?: ExtensionRegistrationRegistry | null;
-    /** Disable workspace extension discovery. */
-    noExtensions?: boolean;
-    /** Workspace resolution directory. */
-    cwd?: string;
+/** Pre-resolved extension registrations, or null to disable them. */
+extensionRegistrations?: ExtensionRegistrationRegistry | null;
+/** Disable workspace extension discovery. */
+noExtensions?: boolean;
+/** Workspace resolution directory. */
+cwd?: string;
 }
 /** Runtime-configured project contracts exposed to SDK consumers. */
 export interface WorkspaceContracts {
-    /** Active item type ids. */
-    types: string[];
-    /** Active lifecycle status ids. */
-    statuses: string[];
-    /** Status id representing the open lifecycle state. */
-    openStatus: string;
-    /** Status id representing the closed lifecycle state. */
-    closeStatus: string;
-    /** Status id representing the canceled lifecycle state. */
-    canceledStatus: string;
-    /** Runtime custom fields accepted by create and update actions. */
-    fields?: WorkspaceFieldContract[];
-    /** Activated extension commands available through generic dispatch. */
-    extensionCommands?: WorkspaceExtensionCommandContract[];
+/** Active item type ids. */
+types: string[];
+/** Active lifecycle status ids. */
+statuses: string[];
+/** Status id representing the open lifecycle state. */
+openStatus: string;
+/** Status id representing the closed lifecycle state. */
+closeStatus: string;
+/** Status id representing the canceled lifecycle state. */
+canceledStatus: string;
+/** Runtime custom fields accepted by create and update actions. */
+fields?: WorkspaceFieldContract[];
+/** Activated extension commands available through generic dispatch. */
+extensionCommands?: WorkspaceExtensionCommandContract[];
 }
 /** Native or extension-contributed action accepted by generic dispatch. */
 export type PmActionName = PmToolAction | (string & {});
@@ -61,77 +61,77 @@ export type PmActionOptions = Record<string, unknown>;
 export type SchemaResult = WorkflowPolicyActionResult | SchemaInspectResult | SchemaListResult | SchemaShowResult | SchemaShowStatusResult | SchemaListFieldsResult | SchemaShowFieldResult | SchemaAddTypeResult | SchemaRemoveTypeResult | SchemaAddStatusResult | SchemaRemoveStatusResult | SchemaAddFieldResult | SchemaRemoveFieldResult | SchemaApplyPresetResult | SchemaAddTypeInferResult | SchemaEvolutionMigrationResult;
 /** Result returned by the SDK `startTask` lifecycle shortcut. */
 export interface StartTaskResult {
-    /** Stable item identifier. */
-    id: string;
-    /** Lifecycle shortcut discriminator. */
-    action: "start_task";
-    /** Claim operation result. */
-    claim: ClaimResult;
-    /** Update operation result. */
-    update: UpdateResult;
+/** Stable item identifier. */
+id: string;
+/** Lifecycle shortcut discriminator. */
+action: "start_task";
+/** Claim operation result. */
+claim: ClaimResult;
+/** Update operation result. */
+update: UpdateResult;
 }
 /** Result returned by the SDK `pauseTask` lifecycle shortcut. */
 export interface PauseTaskResult {
-    /** Stable item identifier. */
-    id: string;
-    /** Lifecycle shortcut discriminator. */
-    action: "pause_task";
-    /** Update operation result. */
-    update: UpdateResult;
-    /** Release operation result. */
-    release: ReleaseResult;
+/** Stable item identifier. */
+id: string;
+/** Lifecycle shortcut discriminator. */
+action: "pause_task";
+/** Update operation result. */
+update: UpdateResult;
+/** Release operation result. */
+release: ReleaseResult;
 }
 /** Result returned by the SDK `closeTask` lifecycle shortcut. */
 export interface CloseTaskResult {
-    /** Stable item identifier. */
-    id: string;
-    /** Lifecycle shortcut discriminator. */
-    action: "close_task";
-    /** Close operation result. */
-    close: CloseResult;
-    /** Release operation result. */
-    release: ReleaseResult;
+/** Stable item identifier. */
+id: string;
+/** Lifecycle shortcut discriminator. */
+action: "close_task";
+/** Close operation result. */
+close: CloseResult;
+/** Release operation result. */
+release: ReleaseResult;
 }
 /** Complete high-level action request for generic SDK dispatch. */
 export type PmActionInput = PmActionOptions & {
-    /** Native or extension-contributed action name. */
-    action: PmActionName;
-    /** Command-runner options after MCP-compatible normalization. */
-    options?: PmActionOptions;
+/** Native or extension-contributed action name. */
+action: PmActionName;
+/** Command-runner options after MCP-compatible normalization. */
+options?: PmActionOptions;
 };
 /** Per-call arguments accepted by the generic SDK client runner. */
 export type PmClientRunArgs = Omit<PmActionInput, "action"> & {
-    /** Return full changed-field arrays for mutation actions. */
-    fullChangedFields?: boolean;
-    /** Return only mutation item ids where supported. */
-    idOnly?: boolean;
-    /** The action is supplied as the runner's first parameter. */
-    action?: never;
+/** Return full changed-field arrays for mutation actions. */
+fullChangedFields?: boolean;
+/** Return only mutation item ids where supported. */
+idOnly?: boolean;
+/** The action is supplied as the runner's first parameter. */
+action?: never;
 };
 /** Close options excluding positional reason aliases. */
 export type PmClientCloseActionOptions = Omit<PmCloseActionOptions, "reason" | "text">;
 /** Command options accepted by mutation convenience methods. */
 export type PmClientMutationOptions = PmActionOptions & {
-    /** Return full changed-field arrays for this mutation. */
-    fullChangedFields?: boolean;
-    /** Return only mutation item ids where supported. */
-    idOnly?: boolean;
+/** Return full changed-field arrays for this mutation. */
+fullChangedFields?: boolean;
+/** Return only mutation item ids where supported. */
+idOnly?: boolean;
 };
 /** Mutation options for helpers that always return full command envelopes. */
 export type PmClientFullMutationOptions = Omit<PmClientMutationOptions, "fullChangedFields" | "idOnly">;
 /** Options for atomic next-work selection. */
 export interface ClaimNextOptions extends PmClientFullMutationOptions {
-    /** Maximum ranked candidates to attempt, from 1 through 100 inclusive. */
-    maxAttempts?: number | string;
+/** Maximum ranked candidates to attempt, from 1 through 100 inclusive. */
+maxAttempts?: number | string;
 }
 /** Stable defaults applied by the reusable SDK client. */
 export interface PmClientOptions {
-    /** Tracker root passed as the SDK equivalent of `--pm-path`. */
-    pmRoot?: string;
-    /** Working directory used for workspace and extension resolution. */
-    cwd?: string;
-    /** Default mutation author forwarded when absent. */
-    author?: string;
-    /** Disable extension loading for every action. */
-    noExtensions?: boolean;
+/** Tracker root passed as the SDK equivalent of `--pm-path`. */
+pmRoot?: string;
+/** Working directory used for workspace and extension resolution. */
+cwd?: string;
+/** Default mutation author forwarded when absent. */
+author?: string;
+/** Disable extension loading for every action. */
+noExtensions?: boolean;
 }