@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/core/validate/missing-by-type.d.ts

@@ -9,10 +9,10 @@
  */
 /** One missing required metadata field observed on an item of a specific type. */
 export interface MissingFieldOccurrence {
-    /** Item type name as stored in item metadata (e.g. "Task"). */
-    item_type: string;
-    /** Required metadata field that is missing on the item. */
-    field: string;
+/** Item type name as stored in item metadata (e.g. "Task"). */
+item_type: string;
+/** Required metadata field that is missing on the item. */
+field: string;
 }
 /** Aggregate missing-field occurrences into `{ type: { field: count } }` with both levels sorted lexicographically for stable, diff-friendly output. Zero counts never appear (only observed occurrences are aggregated). */
 export declare function buildMissingByTypeCounts(occurrences: Iterable<MissingFieldOccurrence>): Record<string, Record<string, number>>;

package/dist/core/validate/missing-link-owners.d.ts

@@ -16,45 +16,45 @@
 export type StaleLinkClassification = "moved" | "deleted" | "malformed";
 /** Documents the stale link owner input payload exchanged by command, SDK, and package integrations. */
 export interface StaleLinkOwnerInput {
-    /** Value that configures or reports item id for this contract. */
-    item_id: string;
-    /** Normalized workspace-relative path that no longer resolves. */
-    path: string;
-    /** Which link list of the owning item the path lives in. */
-    link_kind: "files" | "docs";
-    /** Value that configures or reports classification for this contract. */
-    classification: StaleLinkClassification;
+/** Value that configures or reports item id for this contract. */
+item_id: string;
+/** Normalized workspace-relative path that no longer resolves. */
+path: string;
+/** Which link list of the owning item the path lives in. */
+link_kind: "files" | "docs";
+/** Value that configures or reports classification for this contract. */
+classification: StaleLinkClassification;
 }
 /** Documents the missing linked path owner payload exchanged by command, SDK, and package integrations. */
 export interface MissingLinkedPathOwner {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Owning item type, `"Unknown"` if metadata is absent. */
-    type: string;
-    /** Owning item title, `""` if absent. */
-    title: string;
-    /** Owning item status, `""` if absent. */
-    status: string;
-    /** The link list the path lives in (= the input `link_kind`). */
-    field: "files" | "docs";
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Owning item type, `"Unknown"` if metadata is absent. */
+type: string;
+/** Owning item title, `""` if absent. */
+title: string;
+/** Owning item status, `""` if absent. */
+status: string;
+/** The link list the path lives in (= the input `link_kind`). */
+field: "files" | "docs";
 }
 /** Documents the missing linked path row payload exchanged by command, SDK, and package integrations. */
 export interface MissingLinkedPathRow {
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports classification for this contract. */
-    classification: StaleLinkClassification;
-    /** Value that configures or reports items for this contract. */
-    items: MissingLinkedPathOwner[];
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports classification for this contract. */
+classification: StaleLinkClassification;
+/** Value that configures or reports items for this contract. */
+items: MissingLinkedPathOwner[];
 }
 /** Documents the owner item metadata payload exchanged by command, SDK, and package integrations. */
 export interface OwnerItemMetadata {
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: string;
-    /** Value that configures or reports title for this contract. */
-    title?: string;
-    /** Lifecycle state reported for status. */
-    status?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: string;
+/** Value that configures or reports title for this contract. */
+title?: string;
+/** Lifecycle state reported for status. */
+status?: string;
 }
 /**
  * Group stale-link owner inputs by linked path and attach owning-item metadata.

package/dist/core/validate/stale-file-classification.d.ts

@@ -17,14 +17,14 @@
 export type StaleLinkedPathClassification = "moved" | "deleted" | "malformed";
 /** Documents the classified stale linked path payload exchanged by command, SDK, and package integrations. */
 export interface ClassifiedStaleLinkedPath {
-    /** Normalized workspace-relative stale linked path. */
-    path: string;
-    /** Value that configures or reports classification for this contract. */
-    classification: StaleLinkedPathClassification;
-    /** Candidate new locations (same basename, different path), sorted and capped at `candidateLimit`. Empty for `deleted` and `malformed`. */
-    candidates: string[];
-    /** True when more candidates existed than `candidateLimit` allowed. */
-    candidates_truncated: boolean;
+/** Normalized workspace-relative stale linked path. */
+path: string;
+/** Value that configures or reports classification for this contract. */
+classification: StaleLinkedPathClassification;
+/** Candidate new locations (same basename, different path), sorted and capped at `candidateLimit`. Empty for `deleted` and `malformed`. */
+candidates: string[];
+/** True when more candidates existed than `candidateLimit` allowed. */
+candidates_truncated: boolean;
 }
 /** Fallback stale path candidate limit used when callers do not provide an override. */
 export declare const DEFAULT_STALE_PATH_CANDIDATE_LIMIT = 3;

package/dist/mcp/http-server.d.ts

@@ -10,24 +10,24 @@ import { type PmMcpHttpAuthorizationPolicy, type PmMcpProtectedResourceMetadata
 import { type JsonRpcRequest } from "./server.js";
 /** Runtime options for one real Streamable HTTP server. */
 export interface PmMcpHttpServerOptions {
-    /** Local bind host. Defaults to the DNS-rebinding-safe loopback address. */
-    host?: string;
-    /** TCP port. Zero requests an ephemeral port. */
-    port?: number;
-    /** Single modern MCP POST endpoint. */
-    endpointPath?: string;
-    /** Exact browser origins permitted when an Origin header is present. */
-    allowedOrigins?: readonly string[];
-    /** Optional RFC 9728/OAuth resource-server policy. */
-    authorization?: PmMcpHttpAuthorizationPolicy;
-    /** Metadata served at RFC 9728 well-known paths. */
-    protectedResourceMetadata?: PmMcpProtectedResourceMetadata;
-    /** Maximum accepted JSON request bytes. */
-    maximumBodyBytes?: number;
-    /** SSE comment interval; zero disables keep-alives. */
-    keepAliveMs?: number;
-    /** Optional embedding dispatcher; defaults to the canonical pm MCP handler. */
-    requestHandler?: (request: JsonRpcRequest) => unknown | Promise<unknown>;
+/** Local bind host. Defaults to the DNS-rebinding-safe loopback address. */
+host?: string;
+/** TCP port. Zero requests an ephemeral port. */
+port?: number;
+/** Single modern MCP POST endpoint. */
+endpointPath?: string;
+/** Exact browser origins permitted when an Origin header is present. */
+allowedOrigins?: readonly string[];
+/** Optional RFC 9728/OAuth resource-server policy. */
+authorization?: PmMcpHttpAuthorizationPolicy;
+/** Metadata served at RFC 9728 well-known paths. */
+protectedResourceMetadata?: PmMcpProtectedResourceMetadata;
+/** Maximum accepted JSON request bytes. */
+maximumBodyBytes?: number;
+/** SSE comment interval; zero disables keep-alives. */
+keepAliveMs?: number;
+/** Optional embedding dispatcher; defaults to the canonical pm MCP handler. */
+requestHandler?: (request: JsonRpcRequest) => unknown | Promise<unknown>;
 }
 /** Write one SSE event and wait for transport backpressure to clear. */
 export declare function writePmMcpSseEvent(response: ServerResponse, payload: unknown): Promise<void>;
@@ -41,20 +41,20 @@ export declare function closePmMcpHttpServer(server: Server): Promise<void>;
 export declare function startPmMcpHttpServer(options?: PmMcpHttpServerOptions): Promise<ReturnType<typeof createPmMcpHttpServer>>;
 /** Resolve loopback-safe bind defaults without opening a socket. */
 export declare function resolvePmMcpHttpListenAddress(options?: Pick<PmMcpHttpServerOptions, "host" | "port">): {
-    host: string;
-    port: number;
+host: string;
+port: number;
 };
 /** Resolve and harden executable HTTP options from an environment map. */
 export declare function resolvePmMcpHttpServerOptionsFromEnvironment(processEnvironment?: NodeJS.ProcessEnv): PmMcpHttpServerOptions;
 /** Internal HTTP transport seams used only by direct integration tests. */
 export declare const _testOnly: {
-    /** Return the first active request-scoped transport key for one server. */
-    activeSubscriptionKey: (server: Server) => symbol | undefined;
-    /** Open a stream against one server runtime without a network socket. */
-    openHttpSubscription: (server: Server, request: JsonRpcRequest, response: ServerResponse) => Promise<void>;
-    /** Exercise committed-response handling without a network race. */
-    writeMcpHttpDispatchError: typeof writeMcpHttpDispatchError;
-    /** Exercise the terminal request rejection handler without a live socket. */
-    destroyFailedMcpHttpResponse: typeof destroyFailedMcpHttpResponse;
+/** Return the first active request-scoped transport key for one server. */
+activeSubscriptionKey: (server: Server) => symbol | undefined;
+/** Open a stream against one server runtime without a network socket. */
+openHttpSubscription: (server: Server, request: JsonRpcRequest, response: ServerResponse) => Promise<void>;
+/** Exercise committed-response handling without a network race. */
+writeMcpHttpDispatchError: typeof writeMcpHttpDispatchError;
+/** Exercise the terminal request rejection handler without a live socket. */
+destroyFailedMcpHttpResponse: typeof destroyFailedMcpHttpResponse;
 };
 export {};

package/dist/mcp/legacy-adapter.d.ts

@@ -8,33 +8,33 @@ import { type AgentClientInfo } from "../sdk/runtime-primitives.js";
 import { PM_MCP_LEGACY_PROTOCOL_VERSIONS, type PmMcpImplementation, type PmMcpServerCapabilities } from "../sdk/mcp/protocol.js";
 /** Minimal request shape consumed by the compatibility adapter. */
 export interface LegacyMcpRequest {
-    /** Legacy method name. */
-    method?: string;
-    /** Legacy method parameters. */
-    params?: Record<string, unknown>;
+/** Legacy method name. */
+method?: string;
+/** Legacy method parameters. */
+params?: Record<string, unknown>;
 }
 /** Host callbacks keep this adapter separate from canonical SDK policy. */
 export interface LegacyMcpAdapterOptions {
-    /** Immutable server identity. */
-    serverInfo: PmMcpImplementation;
-    /** Compatibility-era capabilities. */
-    capabilities: PmMcpServerCapabilities;
-    /** Model-facing usage instructions. */
-    instructions: string;
-    /** Parse bounded historical client identity. */
-    parseClientInfo: (value: unknown) => AgentClientInfo | undefined;
-    /** Resolve legacy tool definitions. */
-    listTools: (params: Record<string, unknown> | undefined) => Promise<Record<string, unknown>>;
-    /** Execute one legacy tool call. */
-    callTool: (params: Record<string, unknown> | undefined, clientInfo: AgentClientInfo | undefined) => Promise<Record<string, unknown>>;
-    /** List legacy resources. */
-    listResources: () => Record<string, unknown>;
-    /** Read one legacy resource. */
-    readResource: (params: Record<string, unknown> | undefined) => Promise<Record<string, unknown>>;
-    /** List legacy prompts. */
-    listPrompts: () => Record<string, unknown>;
-    /** Render one legacy prompt. */
-    getPrompt: (params: Record<string, unknown> | undefined) => Record<string, unknown>;
+/** Immutable server identity. */
+serverInfo: PmMcpImplementation;
+/** Compatibility-era capabilities. */
+capabilities: PmMcpServerCapabilities;
+/** Model-facing usage instructions. */
+instructions: string;
+/** Parse bounded historical client identity. */
+parseClientInfo: (value: unknown) => AgentClientInfo | undefined;
+/** Resolve legacy tool definitions. */
+listTools: (params: Record<string, unknown> | undefined) => Promise<Record<string, unknown>>;
+/** Execute one legacy tool call. */
+callTool: (params: Record<string, unknown> | undefined, clientInfo: AgentClientInfo | undefined) => Promise<Record<string, unknown>>;
+/** List legacy resources. */
+listResources: () => Record<string, unknown>;
+/** Read one legacy resource. */
+readResource: (params: Record<string, unknown> | undefined) => Promise<Record<string, unknown>>;
+/** List legacy prompts. */
+listPrompts: () => Record<string, unknown>;
+/** Render one legacy prompt. */
+getPrompt: (params: Record<string, unknown> | undefined) => Record<string, unknown>;
 }
 /**
  * Resolve the legacy revision a handshake negotiates, or refuse with the full
@@ -47,13 +47,13 @@ export interface LegacyMcpAdapterOptions {
 export declare function resolveLegacyProtocolVersion(requestedVersion: unknown): (typeof PM_MCP_LEGACY_PROTOCOL_VERSIONS)[number];
 /** Explicit compatibility adapter with no cross-process or modern-session role. */
 export declare class LegacyMcpAdapter {
-    #private;
-    /** Create one process-local legacy stdio adapter. */
-    constructor(options: LegacyMcpAdapterOptions);
-    /** Read the bounded identity most recently supplied to legacy initialize. */
-    getClientInfo(): AgentClientInfo | undefined;
-    /** Validate and answer the historical initialize handshake. */
-    initialize(params: Record<string, unknown> | undefined): Record<string, unknown>;
-    /** Dispatch one unversioned request through the finite legacy method set. */
-    dispatch(request: LegacyMcpRequest): Promise<Record<string, unknown>>;
+#private;
+/** Create one process-local legacy stdio adapter. */
+constructor(options: LegacyMcpAdapterOptions);
+/** Read the bounded identity most recently supplied to legacy initialize. */
+getClientInfo(): AgentClientInfo | undefined;
+/** Validate and answer the historical initialize handshake. */
+initialize(params: Record<string, unknown> | undefined): Record<string, unknown>;
+/** Dispatch one unversioned request through the finite legacy method set. */
+dispatch(request: LegacyMcpRequest): Promise<Record<string, unknown>>;
 }

package/dist/mcp/runtime-capabilities.d.ts

@@ -9,26 +9,26 @@ import { type WorkspaceContracts, type WorkspaceExtensionCommandContract } from
 import { type ToolDefinition } from "./tool-definitions.js";
 /** Environment configuration accepted by the MCP profile resolver. */
 export interface McpProfileEnvironment {
-    /** Named built-in or custom MCP surface profile. */
-    PM_MCP_PROFILE?: string;
-    /** Comma-separated exact tool allowlist used by the custom profile. */
-    PM_MCP_TOOLS?: string;
+/** Named built-in or custom MCP surface profile. */
+PM_MCP_PROFILE?: string;
+/** Comma-separated exact tool allowlist used by the custom profile. */
+PM_MCP_TOOLS?: string;
 }
 /** Fully resolved MCP tool surface for one request workspace. */
 export interface ResolvedMcpToolSurface {
-    /** Resolved profile after environment validation. */
-    profile: PmMcpToolProfile;
-    /** Runtime-filtered and workspace-enriched MCP definitions. */
-    tools: ToolDefinition[];
-    /** Extension action names reachable through the selected surface. */
-    extensionActions: string[];
+/** Resolved profile after environment validation. */
+profile: PmMcpToolProfile;
+/** Runtime-filtered and workspace-enriched MCP definitions. */
+tools: ToolDefinition[];
+/** Extension action names reachable through the selected surface. */
+extensionActions: string[];
 }
 /** Profile decision for one tool call without projecting every tool schema. */
 export interface ResolvedMcpToolAccess {
-    /** Resolved profile after environment validation. */
-    profile: PmMcpToolProfile;
-    /** Whether the requested tool is callable in that profile and workspace. */
-    available: boolean;
+/** Resolved profile after environment validation. */
+profile: PmMcpToolProfile;
+/** Whether the requested tool is callable in that profile and workspace. */
+available: boolean;
 }
 declare function workspaceFields(workspace: Pick<WorkspaceContracts, "fields">): NonNullable<WorkspaceContracts["fields"]>;
 declare function workspaceExtensionCommands(workspace: Pick<WorkspaceContracts, "extensionCommands">): NonNullable<WorkspaceContracts["extensionCommands"]>;
@@ -51,7 +51,7 @@ export declare function resolveMcpToolAccess(availableTools: readonly ToolDefini
 export declare function normalizeWorkspaceToolArguments(toolName: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
 /** Internal compatibility helpers exposed only for exhaustive fallback tests. */
 export declare const _testOnlyMcpRuntimeCapabilities: {
-    workspaceExtensionCommands: typeof workspaceExtensionCommands;
-    workspaceFields: typeof workspaceFields;
+workspaceExtensionCommands: typeof workspaceExtensionCommands;
+workspaceFields: typeof workspaceFields;
 };
 export {};

package/dist/mcp/server.d.ts

@@ -6,14 +6,14 @@ import { PmMcpInputRequiredError } from "../sdk/mcp/interactions.js";
 import { type PmMcpSubscriptionId, type PmMcpSubscriptionSink } from "../sdk/mcp/subscriptions.js";
 /** JSON-RPC request shape accepted by pm MCP transport adapters. */
 export interface JsonRpcRequest {
-    /** JSON-RPC revision marker when supplied by the transport. */
-    jsonrpc?: string;
-    /** Correlation identifier omitted only for notifications. */
-    id?: string | number | null;
-    /** Protocol operation selected by the caller. */
-    method?: string;
-    /** Operation inputs including request-local MCP metadata. */
-    params?: Record<string, unknown>;
+/** JSON-RPC revision marker when supplied by the transport. */
+jsonrpc?: string;
+/** Correlation identifier omitted only for notifications. */
+id?: string | number | null;
+/** Protocol operation selected by the caller. */
+method?: string;
+/** Operation inputs including request-local MCP metadata. */
+params?: Record<string, unknown>;
 }
 declare function runMcpAction(args: PmActionInput): Promise<unknown>;
 type PmMcpTransportSubscriptionKey = PmMcpSubscriptionId | symbol;
@@ -32,15 +32,15 @@ declare function boundMcpClientProvenance(value: unknown): Record<string, string
 declare function emitMcpChangeNotifications(action: string | undefined): Promise<void>;
 /** Open one modern subscription through a concrete transport-owned sink. */
 export declare function openMcpSubscription(input: {
-    request: JsonRpcRequest;
-    key?: PmMcpTransportSubscriptionKey;
-    sink: PmMcpSubscriptionSink;
+request: JsonRpcRequest;
+key?: PmMcpTransportSubscriptionKey;
+sink: PmMcpSubscriptionSink;
 }): Promise<void>;
 /** Gracefully close one active subscription by its request identifier. */
 export declare function closeMcpSubscription(id: PmMcpSubscriptionId, key?: PmMcpTransportSubscriptionKey): Record<string, unknown> | undefined;
 declare function closeStdioMcpSubscriptions(): Array<{
-    id: PmMcpSubscriptionId;
-    result: Record<string, unknown>;
+id: PmMcpSubscriptionId;
+result: Record<string, unknown>;
 }>;
 /** Resolve the current workspace-enriched tool schema for HTTP header checks. */
 export declare function resolveMcpToolSchemaForRequest(request: JsonRpcRequest): Promise<unknown>;
@@ -60,42 +60,42 @@ export declare function startMcpServer(): void;
 export declare function isInvokedAsMcpMainModule(argvPath: string | undefined, moduleUrl: string): boolean;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    boundMcpClientProvenance: typeof boundMcpClientProvenance;
-    createMcpInputRequiredError: (input: ConstructorParameters<typeof PmMcpInputRequiredError>[0]) => PmMcpInputRequiredError;
-    createMcpProtocolError: (message: string, code: number, data?: Record<string, unknown> | undefined) => PmMcpProtocolError;
-    readonly closeManyOptionsFromFlat: typeof import("../sdk/runtime-input.js").closeManyOptionsFromFlat;
-    detectUnexpectedOptionKeys: typeof detectUnexpectedOptionKeys;
-    detectUnexpectedTopLevelKeys: typeof detectUnexpectedTopLevelKeys;
-    collectMutationGuardWarnings: typeof collectMutationGuardWarnings;
-    closeStdioMcpSubscriptions: typeof closeStdioMcpSubscriptions;
-    errorContent: typeof errorContent;
-    emitMcpChangeNotifications: typeof emitMcpChangeNotifications;
-    expireMcpSubscriptionRecord: (id: PmMcpSubscriptionId, key?: PmMcpTransportSubscriptionKey) => Record<string, unknown> | undefined;
-    getMcpClientInfo: () => AgentClientInfo | undefined;
-    readonly extensionOptionsFromArgs: typeof import("../sdk/runtime-input.js").extensionOptionsFromArgs;
-    readonly globalOptions: typeof import("../sdk/runtime-input.js").actionGlobalOptions;
-    readonly mutationListOptions: typeof import("../sdk/runtime-input.js").mutationListOptions;
-    nearestDeclaredKey: typeof nearestDeclaredKey;
-    mcpTaskPrincipal: typeof mcpTaskPrincipal;
-    resultContent: typeof resultContent;
-    resolveMcpRequestContext: typeof resolveMcpRequestContext;
-    shouldCreateMcpTask: typeof shouldCreateMcpTask;
-    settleMcpTaskExecution: typeof settleMcpTaskExecution;
-    subscriptionCount: () => number;
-    readonly normalizeActionName: typeof import("../sdk/runtime-input.js").normalizeActionName;
-    readonly normalizeCommandPath: typeof import("../sdk/runtime-input.js").normalizeCommandPath;
-    readonly normalizeMcpOptionsArrays: typeof import("../sdk/runtime-input.js").normalizeMcpOptionsArrays;
-    readonly normalizeMcpUpdateOptions: typeof import("../sdk/runtime-input.js").normalizeMcpUpdateOptions;
-    readonly optionsWithAuthor: typeof import("../sdk/runtime-input.js").optionsWithAuthor;
-    readonly readRequiredString: typeof readRequiredString;
-    readonly readScalarString: typeof import("../sdk/runtime-input.js").readRuntimeScalarString;
-    readonly readScalarStringAllowBlank: typeof import("../sdk/runtime-input.js").readRuntimeScalarStringAllowBlank;
-    readonly readStringArray: typeof import("../sdk/runtime-input.js").readRuntimeStringArray;
-    runAction: typeof runMcpAction;
-    readonly updateManyOptionsFromFlat: typeof import("../sdk/runtime-input.js").updateManyOptionsFromFlat;
-    readonly withAddNoteOption: typeof import("../sdk/runtime-input.js").withAddNoteOption;
-    readonly withFilesDiscoveryOptions: typeof import("../sdk/runtime-input.js").withFilesDiscoveryOptions;
-    readonly withMutationCompaction: typeof import("../sdk/runtime-input.js").withMutationCompaction;
-    writeError: typeof writeError;
+boundMcpClientProvenance: typeof boundMcpClientProvenance;
+createMcpInputRequiredError: (input: ConstructorParameters<typeof PmMcpInputRequiredError>[0]) => PmMcpInputRequiredError;
+createMcpProtocolError: (message: string, code: number, data?: Record<string, unknown> | undefined) => PmMcpProtocolError;
+readonly closeManyOptionsFromFlat: typeof import("../sdk/runtime-input.js").closeManyOptionsFromFlat;
+detectUnexpectedOptionKeys: typeof detectUnexpectedOptionKeys;
+detectUnexpectedTopLevelKeys: typeof detectUnexpectedTopLevelKeys;
+collectMutationGuardWarnings: typeof collectMutationGuardWarnings;
+closeStdioMcpSubscriptions: typeof closeStdioMcpSubscriptions;
+errorContent: typeof errorContent;
+emitMcpChangeNotifications: typeof emitMcpChangeNotifications;
+expireMcpSubscriptionRecord: (id: PmMcpSubscriptionId, key?: PmMcpTransportSubscriptionKey) => Record<string, unknown> | undefined;
+getMcpClientInfo: () => AgentClientInfo | undefined;
+readonly extensionOptionsFromArgs: typeof import("../sdk/runtime-input.js").extensionOptionsFromArgs;
+readonly globalOptions: typeof import("../sdk/runtime-input.js").actionGlobalOptions;
+readonly mutationListOptions: typeof import("../sdk/runtime-input.js").mutationListOptions;
+nearestDeclaredKey: typeof nearestDeclaredKey;
+mcpTaskPrincipal: typeof mcpTaskPrincipal;
+resultContent: typeof resultContent;
+resolveMcpRequestContext: typeof resolveMcpRequestContext;
+shouldCreateMcpTask: typeof shouldCreateMcpTask;
+settleMcpTaskExecution: typeof settleMcpTaskExecution;
+subscriptionCount: () => number;
+readonly normalizeActionName: typeof import("../sdk/runtime-input.js").normalizeActionName;
+readonly normalizeCommandPath: typeof import("../sdk/runtime-input.js").normalizeCommandPath;
+readonly normalizeMcpOptionsArrays: typeof import("../sdk/runtime-input.js").normalizeMcpOptionsArrays;
+readonly normalizeMcpUpdateOptions: typeof import("../sdk/runtime-input.js").normalizeMcpUpdateOptions;
+readonly optionsWithAuthor: typeof import("../sdk/runtime-input.js").optionsWithAuthor;
+readonly readRequiredString: typeof readRequiredString;
+readonly readScalarString: typeof import("../sdk/runtime-input.js").readRuntimeScalarString;
+readonly readScalarStringAllowBlank: typeof import("../sdk/runtime-input.js").readRuntimeScalarStringAllowBlank;
+readonly readStringArray: typeof import("../sdk/runtime-input.js").readRuntimeStringArray;
+runAction: typeof runMcpAction;
+readonly updateManyOptionsFromFlat: typeof import("../sdk/runtime-input.js").updateManyOptionsFromFlat;
+readonly withAddNoteOption: typeof import("../sdk/runtime-input.js").withAddNoteOption;
+readonly withFilesDiscoveryOptions: typeof import("../sdk/runtime-input.js").withFilesDiscoveryOptions;
+readonly withMutationCompaction: typeof import("../sdk/runtime-input.js").withMutationCompaction;
+writeError: typeof writeError;
 };
 export {};

package/dist/mcp/tool-definitions.d.ts

@@ -8,37 +8,37 @@ import type { PmToolAction } from "../sdk/cli-contracts/enum-contracts.js";
  * the server itself stays the single consumer of the dispatch handlers.
  */
 export interface ToolDefinition {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports description for this contract. */
-    description: string;
-    /** Value that configures or reports input schema for this contract. */
-    inputSchema: Record<string, unknown>;
-    /** Optional negotiated extension metadata projected during tools/list. */
-    _meta?: Record<string, unknown>;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports description for this contract. */
+description: string;
+/** Value that configures or reports input schema for this contract. */
+inputSchema: Record<string, unknown>;
+/** Optional negotiated extension metadata projected during tools/list. */
+_meta?: Record<string, unknown>;
 }
 /** MCP transport parameters layered over every canonical action schema. */
 export declare const TOOL_SCHEMA_BASE: {
-    readonly type: "object";
-    readonly properties: {
-        readonly cwd: {
-            readonly type: "string";
-            readonly description: "Workspace directory to run the native pm operation in. Defaults to the MCP server process cwd.";
-        };
-        readonly path: {
-            readonly type: "string";
-            readonly description: "Optional pm data root, equivalent to PM_PATH/global --path. Leave unset for real repository tracking.";
-        };
-        readonly author: {
-            readonly type: "string";
-            readonly description: "Optional mutation author override. Otherwise pm uses PM_AUTHOR, project settings, or detected harness identity.";
-        };
-        readonly tokenAccounting: {
-            readonly type: "boolean";
-            readonly description: "Attach the same bounded per-section token-cost receipt emitted by CLI --token-accounting.";
-        };
-    };
-    readonly additionalProperties: true;
+readonly type: "object";
+readonly properties: {
+readonly cwd: {
+readonly type: "string";
+readonly description: "Workspace directory to run the native pm operation in. Defaults to the MCP server process cwd.";
+};
+readonly path: {
+readonly type: "string";
+readonly description: "Optional pm data root, equivalent to PM_PATH/global --path. Leave unset for real repository tracking.";
+};
+readonly author: {
+readonly type: "string";
+readonly description: "Optional mutation author override. Otherwise pm uses PM_AUTHOR, project settings, or detected harness identity.";
+};
+readonly tokenAccounting: {
+readonly type: "boolean";
+readonly description: "Attach the same bounded per-section token-cost receipt emitted by CLI --token-accounting.";
+};
+};
+readonly additionalProperties: true;
 };
 /** Canonical SDK action backing each dedicated MCP tool schema. */
 export declare const NARROW_TOOL_ACTIONS: Readonly<Record<string, PmToolAction>>;
@@ -50,14 +50,14 @@ export declare const NARROW_TOOL_ACTIONS: Readonly<Record<string, PmToolAction>>
 export declare const TOOLS: ToolDefinition[];
 /** Stable projection of one MCP tool definition for the contract golden file (pm-4os2): tool name, description, required top-level fields, and the full inputSchema shape. Any drift (typo'd property, dropped required field, changed TOOL_SCHEMA_BASE) shows up in `pnpm contracts:check`. */
 export interface McpToolContract {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports description for this contract. */
-    description: string;
-    /** Value that configures or reports required for this contract. */
-    required: string[];
-    /** Value that configures or reports input schema for this contract. */
-    input_schema: Record<string, unknown>;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports description for this contract. */
+description: string;
+/** Value that configures or reports required for this contract. */
+required: string[];
+/** Value that configures or reports input schema for this contract. */
+input_schema: Record<string, unknown>;
 }
 /** Implements build mcp tool contracts for the public runtime surface of this module. */
 export declare function buildMcpToolContracts(): McpToolContract[];

package/dist/sdk/agent/closed-domain-contracts.d.ts

@@ -1,23 +1,23 @@
 /** A closed-domain refusal that can be executed and recovered automatically. */
 export interface PmClosedDomainContract {
-    /** Stable assurance identity. */
-    probe_id: string;
-    /** Public command accepting the constrained flag. */
-    command: string;
-    /** Constrained option spelling. */
-    flag: string;
-    /** Invalid token used to prove the refusal path. */
-    rejected_value: string;
-    /** Exact argv that must refuse the invalid token. */
-    refusal_args: readonly string[];
-    /** Complete stable core domain accepted by the command. */
-    allowed_values: readonly string[];
-    /** Exact argv expected in the refusal's executable recovery. */
-    suggested_retry_args: readonly string[];
-    /** Stable machine-readable error code that owns the refusal. */
-    error_code: "package_upgrade_modes_mutually_exclusive" | "projection_options_mutually_exclusive" | "unknown_context_intent" | "unknown_field_projection";
-    /** Whether a complete accepted-value domain is required in the refusal. */
-    allowed_values_required?: boolean;
+/** Stable assurance identity. */
+probe_id: string;
+/** Public command accepting the constrained flag. */
+command: string;
+/** Constrained option spelling. */
+flag: string;
+/** Invalid token used to prove the refusal path. */
+rejected_value: string;
+/** Exact argv that must refuse the invalid token. */
+refusal_args: readonly string[];
+/** Complete stable core domain accepted by the command. */
+allowed_values: readonly string[];
+/** Exact argv expected in the refusal's executable recovery. */
+suggested_retry_args: readonly string[];
+/** Stable machine-readable error code that owns the refusal. */
+error_code: "package_upgrade_modes_mutually_exclusive" | "projection_options_mutually_exclusive" | "unknown_context_intent" | "unknown_field_projection";
+/** Whether a complete accepted-value domain is required in the refusal. */
+allowed_values_required?: boolean;
 }
 /** Return the complete stable core refusal corpus shared by every public surface. */
 export declare function listCoreClosedDomainContracts(): PmClosedDomainContract[];

package/dist/sdk/agent/command-recovery.d.ts

@@ -1,3 +1,7 @@
+/** Identify presentation intent that must not be silently dropped from an unknown-option retry. */
+export declare function isReadProjectionRecoveryFlag(flag: string): boolean;
+/** Keep lexical corrections within read projection or mutation receipt semantics. */
+export declare function isCompatibleRecoveryFlag(requested: string, candidate: string): boolean;
 /** Resolve a recovery command without interpreting global option values as command tokens. */
 export declare function resolveRecoveryCommandName(invocationArgv: string[] | undefined): string | undefined;
 /** Resolve the truthful placeholder for a missing flag from its contract. */

package/dist/sdk/agent/command-recovery.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d5c48881-420f-5673-8696-e770db353cfc")}catch{}})();import{renderPmCommand}from"../command-line.js";import{resolveSubcommandFlagContractsForCommand}from"../cli-contracts/flag-contracts.js";import{parseBootstrapCommandName}from"../cli-contracts/bootstrap-command-scanner.js";function normalizeMissingFlag(label){return label.trim().match(/--[a-z0-9][a-z0-9_-]*/i)?.[0]?.replaceAll("_","-").toLowerCase()}function resolveRecoveryCommandName(invocationArgv){if(!(!Array.isArray(invocationArgv)||invocationArgv.length===0))return parseBootstrapCommandName(invocationArgv)}function resolveMissingOptionPlaceholder(commandName,missingLabel){const flag=normalizeMissingFlag(missingLabel);if(!flag)return;const contract=resolveSubcommandFlagContractsForCommand(commandName).find(entry=>entry.flag===flag||entry.aliases?.includes(flag));return contract?contract.value_type==="boolean"?null:`<${contract.value_name??"value"}>`:"<value>"}function renderMissingOptionRetry(invocationArgv,commandName,missingLabels){const retry=[...invocationArgv],terminatorIndex=retry.indexOf("--");let insertionIndex=terminatorIndex<0?retry.length:terminatorIndex;for(const label of missingLabels){const flag=normalizeMissingFlag(label);if(!flag||retry.slice(0,insertionIndex).some(token=>token===flag||token.startsWith(`${flag}=`)))continue;const placeholder=resolveMissingOptionPlaceholder(commandName,flag),recoveredOption=placeholder?[flag,placeholder]:[flag];retry.splice(insertionIndex,0,...recoveredOption),insertionIndex+=recoveredOption.length}return retry.length===invocationArgv.length?void 0:renderPmCommand(retry)}export{renderMissingOptionRetry,resolveMissingOptionPlaceholder,resolveRecoveryCommandName};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7249e95a-4744-55b8-8b83-2d84f3e48805")}catch{}})();import{renderPmCommand}from"../command-line.js";import{resolveSubcommandFlagContractsForCommand}from"../cli-contracts/flag-contracts.js";import{parseBootstrapCommandName}from"../cli-contracts/bootstrap-command-scanner.js";import{READ_OUTPUT_DIMENSION_FLAGS,READ_OUTPUT_COMPOSITION_FLAGS}from"../read-output/options.js";const READ_PROJECTION_FLAGS=new Set([...Object.values(READ_OUTPUT_DIMENSION_FLAGS),...READ_OUTPUT_COMPOSITION_FLAGS,"--full","--brief","--compact","--summary","--fields","--section","--token-budget"]),MUTATION_RECEIPT_FLAGS=new Set(["--full-changed-fields","--no-changed-fields","--id-only"]);function isReadProjectionRecoveryFlag(flag){const normalized=flag.split("=",1)[0].replaceAll("_","-");return READ_PROJECTION_FLAGS.has(normalized)||normalized.length>=5&&[...READ_PROJECTION_FLAGS].some(candidate=>candidate.startsWith(normalized))}function isCompatibleRecoveryFlag(requested,candidate){const unknownFlag=requested.split("=",1)[0].replaceAll("_","-");return isReadProjectionRecoveryFlag(unknownFlag)?!MUTATION_RECEIPT_FLAGS.has(candidate):MUTATION_RECEIPT_FLAGS.has(unknownFlag)?!isReadProjectionRecoveryFlag(candidate):!0}function normalizeMissingFlag(label){return label.trim().match(/--[a-z0-9][a-z0-9_-]*/i)?.[0]?.replaceAll("_","-").toLowerCase()}function resolveRecoveryCommandName(invocationArgv){if(!(!Array.isArray(invocationArgv)||invocationArgv.length===0))return parseBootstrapCommandName(invocationArgv)}function resolveMissingOptionPlaceholder(commandName,missingLabel){const flag=normalizeMissingFlag(missingLabel);if(!flag)return;const contract=resolveSubcommandFlagContractsForCommand(commandName).find(entry=>entry.flag===flag||entry.aliases?.includes(flag));return contract?contract.value_type==="boolean"?null:`<${contract.value_name??"value"}>`:"<value>"}function renderMissingOptionRetry(invocationArgv,commandName,missingLabels){const retry=[...invocationArgv],terminatorIndex=retry.indexOf("--");let insertionIndex=terminatorIndex<0?retry.length:terminatorIndex;for(const label of missingLabels){const flag=normalizeMissingFlag(label);if(!flag||retry.slice(0,insertionIndex).some(token=>token===flag||token.startsWith(`${flag}=`)))continue;const placeholder=resolveMissingOptionPlaceholder(commandName,flag),recoveredOption=placeholder?[flag,placeholder]:[flag];retry.splice(insertionIndex,0,...recoveredOption),insertionIndex+=recoveredOption.length}return retry.length===invocationArgv.length?void 0:renderPmCommand(retry)}export{isCompatibleRecoveryFlag,isReadProjectionRecoveryFlag,renderMissingOptionRetry,resolveMissingOptionPlaceholder,resolveRecoveryCommandName};
 //# sourceMappingURL=command-recovery.js.map