@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/mcp/skills.d.ts

@@ -5,123 +5,123 @@ export declare const PM_MCP_SKILLS_EXTENSION: "io.modelcontextprotocol/skills";
 export declare const PM_MCP_SKILLS_DRAFT_REVISION: "SEP-2640@a3e147ca2710f68214247aecc729731ee1ae8d03";
 /** Server-side draft capability advertised through discovery. */
 export declare const PM_MCP_SKILLS_SERVER_CAPABILITY: Readonly<{
-    revision: "SEP-2640@a3e147ca2710f68214247aecc729731ee1ae8d03";
-    status: "draft";
-    directoryRead: true;
+revision: "SEP-2640@a3e147ca2710f68214247aecc729731ee1ae8d03";
+status: "draft";
+directoryRead: true;
 }>;
 /** Require exact draft negotiation for a skills method. */
 export declare function assertPmMcpSkillsCapability(context: PmMcpRequestContext, directoryRead?: boolean): void;
 /** Security and context limits applied independently to every skill origin. */
 export declare const PM_MCP_SKILL_LIMITS: Readonly<{
-    maxFilesPerSkill: 512;
-    maxFileBytes: number;
-    maxSkillBytes: number;
-    defaultPageSize: 20;
-    maxPageSize: 100;
+maxFilesPerSkill: 512;
+maxFileBytes: number;
+maxSkillBytes: number;
+defaultPageSize: 20;
+maxPageSize: 100;
 }>;
 /** Origin from which a skill was loaded. */
 export type PmMcpSkillOrigin = "package" | "workspace";
 /** One immutable file advertised by a skill. */
 export interface PmMcpSkillResource {
-    /** Addressable skill resource URI. */
-    uri: string;
-    /** SEP-2640 SHA-256 digest of the exact bytes returned by reads. */
-    digest: string;
-    /** Exact byte length. */
-    size: number;
+/** Addressable skill resource URI. */
+uri: string;
+/** SEP-2640 SHA-256 digest of the exact bytes returned by reads. */
+digest: string;
+/** Exact byte length. */
+size: number;
 }
 /** Discoverable skill descriptor from the current SEP draft. */
 export interface PmMcpSkillDescriptor {
-    /** URI of the skill's mandatory SKILL.md. */
-    uri: string;
-    /** Parsed, verbatim frontmatter object. */
-    frontmatter: Record<string, unknown>;
-    /** Every bounded file in the skill directory. */
-    resources: PmMcpSkillResource[];
-    /** pm-specific compatibility and trust provenance. */
-    _meta: {
-        contractVersion: 1;
-        extensionRevision: typeof PM_MCP_SKILLS_DRAFT_REVISION;
-        origin: PmMcpSkillOrigin;
-        packageVersion: string;
-        protocolVersion: typeof PM_MCP_PROTOCOL_VERSION;
-        trust: "untrusted";
-        estimatedTokens: number;
-    };
+/** URI of the skill's mandatory SKILL.md. */
+uri: string;
+/** Parsed, verbatim frontmatter object. */
+frontmatter: Record<string, unknown>;
+/** Every bounded file in the skill directory. */
+resources: PmMcpSkillResource[];
+/** pm-specific compatibility and trust provenance. */
+_meta: {
+contractVersion: 1;
+extensionRevision: typeof PM_MCP_SKILLS_DRAFT_REVISION;
+origin: PmMcpSkillOrigin;
+packageVersion: string;
+protocolVersion: typeof PM_MCP_PROTOCOL_VERSION;
+trust: "untrusted";
+estimatedTokens: number;
+};
 }
 /** Inputs for loading the canonical package skills plus repository overrides. */
 export interface LoadPmMcpSkillsOptions {
-    /** pm package root containing `.agents/skills`. */
-    packageRoot: string;
-    /** Workspace root whose `.agents/skills` override package skills by name. */
-    workspaceRoot?: string;
-    /** Exact package version included in compatibility metadata. */
-    packageVersion: string;
+/** pm package root containing `.agents/skills`. */
+packageRoot: string;
+/** Workspace root whose `.agents/skills` override package skills by name. */
+workspaceRoot?: string;
+/** Exact package version included in compatibility metadata. */
+packageVersion: string;
 }
 /** List request inputs with opaque cursor pagination. */
 export interface ListPmMcpSkillsOptions {
-    /** Opaque cursor returned by a previous page. */
-    cursor?: string;
-    /** Requested page size, bounded to 100. */
-    limit?: number;
+/** Opaque cursor returned by a previous page. */
+cursor?: string;
+/** Requested page size, bounded to 100. */
+limit?: number;
 }
 /** One deterministic list page. */
 export interface ListPmMcpSkillsResult {
-    /** Skills in lexical URI order. */
-    skills: PmMcpSkillDescriptor[];
-    /** Opaque continuation cursor when more skills exist. */
-    nextCursor?: string;
-    /** Explicit completeness signal. */
-    hasMore: boolean;
+/** Skills in lexical URI order. */
+skills: PmMcpSkillDescriptor[];
+/** Opaque continuation cursor when more skills exist. */
+nextCursor?: string;
+/** Explicit completeness signal. */
+hasMore: boolean;
 }
 /** Exact read result for one skill resource. */
 export interface ReadPmMcpSkillResourceResult {
-    /** Resource content returned as UTF-8 text or lossless Base64 bytes. */
-    contents: Array<{
-        uri: string;
-        mimeType: "text/markdown" | "text/plain";
-        text: string;
-        _meta: {
-            digest: string;
-            origin: PmMcpSkillOrigin;
-            trust: "untrusted";
-        };
-    } | {
-        uri: string;
-        mimeType: "application/octet-stream";
-        blob: string;
-        _meta: {
-            digest: string;
-            origin: PmMcpSkillOrigin;
-            trust: "untrusted";
-        };
-    }>;
+/** Resource content returned as UTF-8 text or lossless Base64 bytes. */
+contents: Array<{
+uri: string;
+mimeType: "text/markdown" | "text/plain";
+text: string;
+_meta: {
+digest: string;
+origin: PmMcpSkillOrigin;
+trust: "untrusted";
+};
+} | {
+uri: string;
+mimeType: "application/octet-stream";
+blob: string;
+_meta: {
+digest: string;
+origin: PmMcpSkillOrigin;
+trust: "untrusted";
+};
+}>;
 }
 /** Direct-child directory listing defined by the current SEP draft. */
 export interface ReadPmMcpSkillDirectoryResult {
-    /** Direct child file and directory resources in lexical URI order. */
-    resources: Array<{
-        uri: string;
-        name: string;
-        mimeType: "application/octet-stream" | "inode/directory" | "text/markdown" | "text/plain";
-    }>;
-    /** Opaque continuation cursor when more direct children exist. */
-    nextCursor?: string;
-    /** Explicit completeness signal for this directory page. */
-    hasMore: boolean;
+/** Direct child file and directory resources in lexical URI order. */
+resources: Array<{
+uri: string;
+name: string;
+mimeType: "application/octet-stream" | "inode/directory" | "text/markdown" | "text/plain";
+}>;
+/** Opaque continuation cursor when more direct children exist. */
+nextCursor?: string;
+/** Explicit completeness signal for this directory page. */
+hasMore: boolean;
 }
 /** Immutable in-memory registry for one request's package/workspace origins. */
 export declare class PmMcpSkillRegistry {
-    #private;
-    private constructor();
-    /** Load package skills and apply validated workspace overrides by name. */
-    static load(options: LoadPmMcpSkillsOptions): Promise<PmMcpSkillRegistry>;
-    /** List skills in deterministic pages without loading file bodies. */
-    list(options?: ListPmMcpSkillsOptions): ListPmMcpSkillsResult;
-    /** Get one skill descriptor by its SKILL.md URI. */
-    get(uri: string): PmMcpSkillDescriptor;
-    /** Read one digest-bound skill resource without following filesystem links. */
-    read(uri: string): ReadPmMcpSkillResourceResult;
-    /** List one directory's direct children with opaque cursor pagination. */
-    readDirectory(uri: string, options?: ListPmMcpSkillsOptions): ReadPmMcpSkillDirectoryResult;
+#private;
+private constructor();
+/** Load package skills and apply validated workspace overrides by name. */
+static load(options: LoadPmMcpSkillsOptions): Promise<PmMcpSkillRegistry>;
+/** List skills in deterministic pages without loading file bodies. */
+list(options?: ListPmMcpSkillsOptions): ListPmMcpSkillsResult;
+/** Get one skill descriptor by its SKILL.md URI. */
+get(uri: string): PmMcpSkillDescriptor;
+/** Read one digest-bound skill resource without following filesystem links. */
+read(uri: string): ReadPmMcpSkillResourceResult;
+/** List one directory's direct children with opaque cursor pagination. */
+readDirectory(uri: string, options?: ListPmMcpSkillsOptions): ReadPmMcpSkillDirectoryResult;
 }

package/dist/sdk/mcp/subscriptions.d.ts

@@ -11,23 +11,23 @@ export declare const PM_MCP_SUBSCRIPTION_ID_META_KEY = "io.modelcontextprotocol/
 export type PmMcpSubscriptionId = string | number;
 /** Notification families a client may opt into on one listen stream. */
 export interface PmMcpSubscriptionFilter {
-    /** Receive notifications when the tool list changes. */
-    toolsListChanged?: boolean;
-    /** Receive notifications when the prompt list changes. */
-    promptsListChanged?: boolean;
-    /** Receive notifications when the resource list changes. */
-    resourcesListChanged?: boolean;
-    /** Receive updates for these exact resource URIs. */
-    resourceSubscriptions?: string[];
+/** Receive notifications when the tool list changes. */
+toolsListChanged?: boolean;
+/** Receive notifications when the prompt list changes. */
+promptsListChanged?: boolean;
+/** Receive notifications when the resource list changes. */
+resourcesListChanged?: boolean;
+/** Receive updates for these exact resource URIs. */
+resourceSubscriptions?: string[];
 }
 /** One JSON-RPC notification emitted by a subscription. */
 export interface PmMcpSubscriptionNotification {
-    /** JSON-RPC revision. */
-    jsonrpc: "2.0";
-    /** Notification method. */
-    method: string;
-    /** Correlated notification parameters. */
-    params: Record<string, unknown>;
+/** JSON-RPC revision. */
+jsonrpc: "2.0";
+/** Notification method. */
+method: string;
+/** Correlated notification parameters. */
+params: Record<string, unknown>;
 }
 /** Sink used by stdio and HTTP adapters to write subscription messages. */
 export type PmMcpSubscriptionSink = (notification: PmMcpSubscriptionNotification) => void | Promise<void>;
@@ -37,29 +37,29 @@ export declare function parseMcpSubscriptionFilter(value: unknown): PmMcpSubscri
 export declare function resolveMcpAcknowledgedSubscriptionFilter(requested: PmMcpSubscriptionFilter, capabilities: PmMcpServerCapabilities): PmMcpSubscriptionFilter;
 /** Manage concurrent stateless subscriptions without retaining client sessions. */
 export declare class PmMcpSubscriptionRegistry {
-    #private;
-    /** Create a registry shared by one concrete transport process. */
-    constructor(input: {
-        capabilities: PmMcpServerCapabilities;
-        serverInfo: PmMcpImplementation;
-    });
-    /** Number of currently open request-scoped subscription streams. */
-    get size(): number;
-    /** Open a subscription and emit its required first acknowledgment. */
-    open(input: {
-        id: PmMcpSubscriptionId;
-        notifications: unknown;
-        sink: PmMcpSubscriptionSink;
-    }): Promise<PmMcpSubscriptionFilter>;
-    /** Emit one list-change notification only to streams that opted into it. */
-    emitListChanged(family: "tools" | "prompts" | "resources"): Promise<number>;
-    /** Emit a resource update only to streams that opted into the exact URI. */
-    emitResourceUpdated(uri: string): Promise<number>;
-    /** Gracefully close one subscription and return its final modern result. */
-    close(id: PmMcpSubscriptionId): Record<string, unknown> | undefined;
-    /** Gracefully close every stream and preserve stable creation order. */
-    closeAll(): Array<{
-        id: PmMcpSubscriptionId;
-        result: Record<string, unknown>;
-    }>;
+#private;
+/** Create a registry shared by one concrete transport process. */
+constructor(input: {
+capabilities: PmMcpServerCapabilities;
+serverInfo: PmMcpImplementation;
+});
+/** Number of currently open request-scoped subscription streams. */
+get size(): number;
+/** Open a subscription and emit its required first acknowledgment. */
+open(input: {
+id: PmMcpSubscriptionId;
+notifications: unknown;
+sink: PmMcpSubscriptionSink;
+}): Promise<PmMcpSubscriptionFilter>;
+/** Emit one list-change notification only to streams that opted into it. */
+emitListChanged(family: "tools" | "prompts" | "resources"): Promise<number>;
+/** Emit a resource update only to streams that opted into the exact URI. */
+emitResourceUpdated(uri: string): Promise<number>;
+/** Gracefully close one subscription and return its final modern result. */
+close(id: PmMcpSubscriptionId): Record<string, unknown> | undefined;
+/** Gracefully close every stream and preserve stable creation order. */
+closeAll(): Array<{
+id: PmMcpSubscriptionId;
+result: Record<string, unknown>;
+}>;
 }

package/dist/sdk/mcp/tasks.d.ts

@@ -8,100 +8,100 @@ export declare const PM_MCP_TASK_STATUSES: readonly ["working", "input_required"
 export type PmMcpTaskStatus = (typeof PM_MCP_TASK_STATUSES)[number];
 /** JSON-RPC error retained by a failed task. */
 export interface PmMcpTaskError {
-    /** JSON-RPC or MCP error code. */
-    code: number;
-    /** Bounded human-readable failure summary. */
-    message: string;
-    /** Optional structured diagnostics. */
-    data?: Record<string, unknown>;
+/** JSON-RPC or MCP error code. */
+code: number;
+/** Bounded human-readable failure summary. */
+message: string;
+/** Optional structured diagnostics. */
+data?: Record<string, unknown>;
 }
 /** Common public fields returned for every task state. */
 export interface PmMcpTask {
-    /** Stable server-minted task identifier. */
-    taskId: string;
-    /** Current extension lifecycle state. */
-    status: PmMcpTaskStatus;
-    /** Optional bounded human-readable state summary. */
-    statusMessage?: string;
-    /** ISO 8601 creation timestamp. */
-    createdAt: string;
-    /** ISO 8601 last mutation timestamp. */
-    lastUpdatedAt: string;
-    /** Milliseconds from creation before server retention may end. */
-    ttlMs: number | null;
-    /** Suggested client polling interval. */
-    pollIntervalMs?: number;
-    /** Additional forward-compatible extension fields. */
-    [key: string]: unknown;
+/** Stable server-minted task identifier. */
+taskId: string;
+/** Current extension lifecycle state. */
+status: PmMcpTaskStatus;
+/** Optional bounded human-readable state summary. */
+statusMessage?: string;
+/** ISO 8601 creation timestamp. */
+createdAt: string;
+/** ISO 8601 last mutation timestamp. */
+lastUpdatedAt: string;
+/** Milliseconds from creation before server retention may end. */
+ttlMs: number | null;
+/** Suggested client polling interval. */
+pollIntervalMs?: number;
+/** Additional forward-compatible extension fields. */
+[key: string]: unknown;
 }
 /** Detailed public task state returned by `tasks/get`. */
 export type PmMcpDetailedTask = (PmMcpTask & {
-    status: "working";
+status: "working";
 }) | (PmMcpTask & {
-    status: "input_required";
-    inputRequests: PmMcpInputRequests;
+status: "input_required";
+inputRequests: PmMcpInputRequests;
 }) | (PmMcpTask & {
-    status: "completed";
-    result: Record<string, unknown>;
+status: "completed";
+result: Record<string, unknown>;
 }) | (PmMcpTask & {
-    status: "failed";
-    error: PmMcpTaskError;
+status: "failed";
+error: PmMcpTaskError;
 }) | (PmMcpTask & {
-    status: "cancelled";
+status: "cancelled";
 });
 /** Task handle returned instead of a synchronous tool result. */
 export type PmMcpCreateTaskResult = PmMcpTask & {
-    /** Official extension result discriminator. */
-    resultType: "task";
+/** Official extension result discriminator. */
+resultType: "task";
 };
 /** Construction options for one filesystem-backed task provider. */
 export interface PmMcpTaskStoreOptions {
-    /** Tracker root whose ignored runtime area owns task records. */
-    pmRoot: string;
-    /** Lock owner retained in diagnostics. */
-    owner?: string;
-    /** Deterministic clock seam used by conformance tests. */
-    now?: () => Date;
-    /** Deterministic task-id seam used by conformance tests. */
-    taskIdFactory?: () => string;
-    /** Process identifier used for restart recovery. */
-    workerPid?: number;
+/** Tracker root whose ignored runtime area owns task records. */
+pmRoot: string;
+/** Lock owner retained in diagnostics. */
+owner?: string;
+/** Deterministic clock seam used by conformance tests. */
+now?: () => Date;
+/** Deterministic task-id seam used by conformance tests. */
+taskIdFactory?: () => string;
+/** Process identifier used for restart recovery. */
+workerPid?: number;
 }
 /** Filesystem-backed provider for official MCP task methods and state changes. */
 export declare class PmMcpTaskStore {
-    #private;
-    /** Create one task store scoped to a tracker runtime directory. */
-    constructor(options: PmMcpTaskStoreOptions);
-    /** Durably create a working task before returning its public handle. */
-    create(input: {
-        principal: string;
-        ttlMs?: number | null;
-        pollIntervalMs?: number;
-        statusMessage?: string;
-    }): Promise<PmMcpCreateTaskResult>;
-    /** Return authoritative task state, applying expiry and restart recovery. */
-    get(taskId: string, principal: string): Promise<PmMcpDetailedTask>;
-    /** Transition a nonterminal task to an MRTR input-required state. */
-    requireInput(input: {
-        taskId: string;
-        principal: string;
-        requestContext: PmMcpRequestContext;
-        inputRequests: unknown;
-        statusMessage?: string;
-    }): Promise<PmMcpDetailedTask>;
-    /** Accept outstanding task inputs, ignoring unknown and duplicate response keys. */
-    update(taskId: string, principal: string, inputResponses: unknown): Promise<{
-        acceptedKeys: string[];
-        remainingKeys: string[];
-    }>;
-    /** Retrieve and clear accepted task inputs for a resumed worker. */
-    takeInputResponses(taskId: string, principal: string): Promise<PmMcpInputResponses>;
-    /** Record one immutable successful terminal result. */
-    complete(taskId: string, principal: string, result: Record<string, unknown>): Promise<PmMcpDetailedTask>;
-    /** Record one immutable JSON-RPC terminal failure. */
-    fail(taskId: string, principal: string, error: PmMcpTaskError): Promise<PmMcpDetailedTask>;
-    /** Cooperatively cancel a nonterminal task and acknowledge terminal tasks idempotently. */
-    cancel(taskId: string, principal: string): Promise<PmMcpDetailedTask>;
+#private;
+/** Create one task store scoped to a tracker runtime directory. */
+constructor(options: PmMcpTaskStoreOptions);
+/** Durably create a working task before returning its public handle. */
+create(input: {
+principal: string;
+ttlMs?: number | null;
+pollIntervalMs?: number;
+statusMessage?: string;
+}): Promise<PmMcpCreateTaskResult>;
+/** Return authoritative task state, applying expiry and restart recovery. */
+get(taskId: string, principal: string): Promise<PmMcpDetailedTask>;
+/** Transition a nonterminal task to an MRTR input-required state. */
+requireInput(input: {
+taskId: string;
+principal: string;
+requestContext: PmMcpRequestContext;
+inputRequests: unknown;
+statusMessage?: string;
+}): Promise<PmMcpDetailedTask>;
+/** Accept outstanding task inputs, ignoring unknown and duplicate response keys. */
+update(taskId: string, principal: string, inputResponses: unknown): Promise<{
+acceptedKeys: string[];
+remainingKeys: string[];
+}>;
+/** Retrieve and clear accepted task inputs for a resumed worker. */
+takeInputResponses(taskId: string, principal: string): Promise<PmMcpInputResponses>;
+/** Record one immutable successful terminal result. */
+complete(taskId: string, principal: string, result: Record<string, unknown>): Promise<PmMcpDetailedTask>;
+/** Record one immutable JSON-RPC terminal failure. */
+fail(taskId: string, principal: string, error: PmMcpTaskError): Promise<PmMcpDetailedTask>;
+/** Cooperatively cancel a nonterminal task and acknowledge terminal tasks idempotently. */
+cancel(taskId: string, principal: string): Promise<PmMcpDetailedTask>;
 }
 /** Build a filesystem-backed task provider for a tracker runtime root. */
 export declare function createMcpTaskStore(options: PmMcpTaskStoreOptions): PmMcpTaskStore;

package/dist/sdk/mcp/transport.d.ts

@@ -2,12 +2,12 @@
 export type PmMcpHttpHeaders = Record<string, string | readonly string[] | undefined>;
 /** One statically reachable `x-mcp-header` annotation. */
 export interface PmMcpHeaderAnnotation {
-    /** Suffix used to construct `Mcp-Param-{name}`. */
-    name: string;
-    /** Exact property path in tool-call arguments. */
-    path: string[];
-    /** Primitive schema type permitted by the specification. */
-    type: "boolean" | "integer" | "string";
+/** Suffix used to construct `Mcp-Param-{name}`. */
+name: string;
+/** Exact property path in tool-call arguments. */
+path: string[];
+/** Primitive schema type permitted by the specification. */
+type: "boolean" | "integer" | "string";
 }
 /** Encode a name or primitive parameter into the protocol's safe header form. */
 export declare function encodeMcpHttpHeaderValue(value: string | number | boolean): string;
@@ -17,14 +17,14 @@ export declare function decodeMcpHttpHeaderValue(value: string, header: string):
 export declare function collectMcpHeaderAnnotations(schema: unknown): PmMcpHeaderAnnotation[];
 /** Build required Streamable HTTP headers for one modern client request. */
 export declare function buildMcpHttpRequestHeaders(input: {
-    request: Record<string, unknown>;
-    toolSchema?: unknown;
+request: Record<string, unknown>;
+toolSchema?: unknown;
 }): Record<string, string>;
 /** Validate required Streamable HTTP headers against the JSON-RPC body. */
 export declare function validateMcpHttpRequestHeaders(input: {
-    headers: PmMcpHttpHeaders;
-    request: Record<string, unknown>;
-    toolSchema?: unknown;
+headers: PmMcpHttpHeaders;
+request: Record<string, unknown>;
+toolSchema?: unknown;
 }): void;
 /** Required protocol version exposed for clients constructing headers manually. */
 export declare const PM_MCP_HTTP_PROTOCOL_VERSION: "2026-07-28";

package/dist/sdk/merge/abandoned-receipts.d.ts

@@ -6,10 +6,10 @@ import type { GlobalOptions } from "../../core/shared/command-types.js";
 import { type MergeDecisionReceipt } from "./receipts.js";
 /** Preview or record restored-origin dispositions without treating them as applied merges. */
 export declare function settleAbandonedMergeReceipts(params: {
-    cwd: string | null;
-    receipts: readonly MergeDecisionReceipt[];
-    dryRun: boolean;
-    author?: string;
-    message?: string;
-    global: GlobalOptions;
+cwd: string | null;
+receipts: readonly MergeDecisionReceipt[];
+dryRun: boolean;
+author?: string;
+message?: string;
+global: GlobalOptions;
 }): Promise<string[]>;