@unbrained/pm-cli 2026.10.11 → 2026.10.13

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

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

@@ -1,3 +1,5 @@
+/** Resolve the longest exact misplaced suffix under registered namespaces only when one canonical command owns it. */
+export declare function resolveMisnestedCommandPath(unknownPath: string, availablePaths: readonly string[]): string | undefined;
 /** Score one command path for a guessed command token; lower is better. */
 export declare function scoreCommandPathMatch(commandPath: string, queryToken: string): number;
 /** Rank available command paths for one guessed token. */

package/dist/sdk/agent/command-suggestions.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]="a48c9a1f-b959-54a4-a27f-4f662ae7fd31")}catch{}})();import{levenshteinDistanceWithinLimit}from"../../core/shared/levenshtein.js";import{PM_COMMAND_ALIAS_CONTRACTS,resolvePmCommandOperation}from"../cli-contracts/command-aliases.js";const COMMAND_SYNONYMS={add:["create","append"],fetch:["get"],inspect:["get","health"],log:["history","comments","notes"],ls:["list"],pause:["release"],read:["get"],remove:["delete"],rm:["delete"],show:["get"],start:["start-task"]};function scoreCommandPathMatch(commandPath,queryToken){const normalizedPath=commandPath.trim().toLowerCase(),normalizedToken=queryToken.trim().toLowerCase();if(normalizedToken.length===0)return Number.POSITIVE_INFINITY;const segments=normalizedPath.split(" "),semanticIndex=COMMAND_SYNONYMS[normalizedToken]?.indexOf(resolvePmCommandOperation(normalizedPath));if(semanticIndex!==void 0&&semanticIndex>=0)return semanticIndex;if(normalizedPath===normalizedToken)return 10;if(segments.includes(normalizedToken))return 11;if(segments.some(segment=>segment.startsWith(normalizedToken)))return 12;const maxDistance=normalizedToken.length>=5?2:1;let bestDistance=Number.POSITIVE_INFINITY;for(const segment of segments){const distance=levenshteinDistanceWithinLimit(segment,normalizedToken,maxDistance);distance!==null&&(bestDistance=Math.min(bestDistance,distance))}return Number.isFinite(bestDistance)?20+bestDistance:normalizedPath.includes(normalizedToken)?30:Number.POSITIVE_INFINITY}function rankCommandPaths(commandPaths,queryToken){return commandPaths.map(path=>({path,score:scoreCommandPathMatch(path,queryToken)})).filter(entry=>Number.isFinite(entry.score)).sort((left,right)=>left.score!==right.score?left.score-right.score:left.path===right.path?0:left.path<right.path?-1:1).map(entry=>entry.path)}function canonicalizeCommandSuggestions(candidates,availablePaths,queryToken){const available=new Set(availablePaths),aliases=PM_COMMAND_ALIAS_CONTRACTS.filter(alias=>alias.lifecycle==="deprecated").slice().sort((left,right)=>right.alias.length-left.alias.length),preferred=[],resolved=candidates.flatMap(candidate=>{const alias=aliases.find(entry=>candidate===entry.alias||candidate.startsWith(`${entry.alias} `));let canonical=candidate;if(alias){const suffix=candidate.slice(alias.alias.length);if(!available.has(`${alias.canonical}${suffix}`))return[];canonical=`${alias.canonical_argv.join(" ")}${suffix}`}return queryToken!==void 0&&scoreCommandPathMatch(candidate,queryToken)<10&&preferred.push(canonical),[canonical]});return[...new Set(preferred.length>0?preferred:resolved)]}export{canonicalizeCommandSuggestions,rankCommandPaths,scoreCommandPathMatch};
+(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]="12066389-daef-5fce-b7a6-0ecffa926d66")}catch{}})();import{levenshteinDistanceWithinLimit}from"../../core/shared/levenshtein.js";import{PM_COMMAND_ALIAS_CONTRACTS,resolvePmCommandAlias,resolvePmCommandOperation}from"../cli-contracts/command-aliases.js";function resolveMisnestedCommandPath(unknownPath,availablePaths){const tokens=unknownPath.trim().split(/\s+/u);if(!(tokens.length<2||availablePaths.includes(tokens.join(" "))))for(let namespaceLength=1;namespaceLength<tokens.length;namespaceLength+=1){if(!availablePaths.includes(tokens.slice(0,namespaceLength).join(" ")))return;const suffix=tokens.slice(namespaceLength).join(" "),alias=resolvePmCommandAlias(suffix),candidates=new Set(availablePaths.filter(candidate=>candidate===suffix||candidate.endsWith(` ${suffix}`)||candidate===alias?.canonical).map(candidate=>resolvePmCommandAlias(candidate)?.canonical??candidate).filter(candidate=>availablePaths.includes(candidate)));if(candidates.size>0)return candidates.size===1?[...candidates][0]:void 0}}const COMMAND_SYNONYMS={add:["create","append"],fetch:["get"],inspect:["get","health"],log:["history","comments","notes"],ls:["list"],pause:["release"],read:["get"],remove:["delete"],rm:["delete"],show:["get"],start:["start-task"]};function scoreCommandPathMatch(commandPath,queryToken){const normalizedPath=commandPath.trim().toLowerCase(),normalizedToken=queryToken.trim().toLowerCase();if(normalizedToken.length===0)return Number.POSITIVE_INFINITY;const segments=normalizedPath.split(" "),semanticIndex=COMMAND_SYNONYMS[normalizedToken]?.indexOf(resolvePmCommandOperation(normalizedPath));if(semanticIndex!==void 0&&semanticIndex>=0)return semanticIndex;if(normalizedPath===normalizedToken)return 10;if(segments.includes(normalizedToken))return 11;if(segments.some(segment=>segment.startsWith(normalizedToken)))return 12;const maxDistance=normalizedToken.length>=5?2:1;let bestDistance=Number.POSITIVE_INFINITY;for(const segment of segments){const distance=levenshteinDistanceWithinLimit(segment,normalizedToken,maxDistance);distance!==null&&(bestDistance=Math.min(bestDistance,distance))}return Number.isFinite(bestDistance)?20+bestDistance:normalizedPath.includes(normalizedToken)?30:Number.POSITIVE_INFINITY}function rankCommandPaths(commandPaths,queryToken){return commandPaths.map(path=>({path,score:scoreCommandPathMatch(path,queryToken)})).filter(entry=>Number.isFinite(entry.score)).sort((left,right)=>left.score!==right.score?left.score-right.score:left.path===right.path?0:left.path<right.path?-1:1).map(entry=>entry.path)}function canonicalizeCommandSuggestions(candidates,availablePaths,queryToken){const available=new Set(availablePaths),aliases=PM_COMMAND_ALIAS_CONTRACTS.filter(alias=>alias.lifecycle==="deprecated").slice().sort((left,right)=>right.alias.length-left.alias.length),preferred=[],resolved=candidates.flatMap(candidate=>{const alias=aliases.find(entry=>candidate===entry.alias||candidate.startsWith(`${entry.alias} `));let canonical=candidate;if(alias){const suffix=candidate.slice(alias.alias.length);if(!available.has(`${alias.canonical}${suffix}`))return[];canonical=`${alias.canonical_argv.join(" ")}${suffix}`}return queryToken!==void 0&&scoreCommandPathMatch(candidate,queryToken)<10&&preferred.push(canonical),[canonical]});return[...new Set(preferred.length>0?preferred:resolved)]}export{canonicalizeCommandSuggestions,rankCommandPaths,resolveMisnestedCommandPath,scoreCommandPathMatch};
 //# sourceMappingURL=command-suggestions.js.map

package/dist/sdk/agent/identity-config.d.ts

@@ -7,52 +7,52 @@
  */
 /** Persisted legacy-author interpretation vocabulary. */
 export interface AgentIdentityVocabulary {
-    /** Monotonic interpretation revision. */
-    version: number;
-    /** Exact legacy author spelling to canonical harness namespace. */
-    aliases: Record<string, string>;
+/** Monotonic interpretation revision. */
+version: number;
+/** Exact legacy author spelling to canonical harness namespace. */
+aliases: Record<string, string>;
 }
 /** Privacy-safe vocabulary projection used by config get/list/export. */
 export interface AgentIdentityVocabularySummary {
-    /** Current interpretation revision. */
-    version: number;
-    /** Number of exact legacy spellings configured. */
-    alias_count: number;
+/** Current interpretation revision. */
+version: number;
+/** Number of exact legacy spellings configured. */
+alias_count: number;
 }
 /** Supported vocabulary mutations. */
 export type AgentIdentityVocabularyOperation = "add" | "remove" | "clear";
 /** One typed vocabulary mutation and optional residual-coverage census. */
 export interface AgentIdentityVocabularyMutationInput {
-    /** Exact operation applied to the vocabulary. */
-    operation: AgentIdentityVocabularyOperation;
-    /** Exact legacy spelling required by add/remove. */
-    legacy_author?: string;
-    /** Canonical lowercase harness namespace required by add. */
-    canonical_harness?: string;
-    /** Optional bounded author census used only to count still-unmapped values. */
-    observed_authors?: readonly string[];
+/** Exact operation applied to the vocabulary. */
+operation: AgentIdentityVocabularyOperation;
+/** Exact legacy spelling required by add/remove. */
+legacy_author?: string;
+/** Canonical lowercase harness namespace required by add. */
+canonical_harness?: string;
+/** Optional bounded author census used only to count still-unmapped values. */
+observed_authors?: readonly string[];
 }
 /** Privacy-safe dry-run or committed mutation preview. */
 export interface AgentIdentityVocabularyMutationPreview {
-    /** Operation that was evaluated. */
-    operation: AgentIdentityVocabularyOperation;
-    /** Whether persistence would change. */
-    changed: boolean;
-    /** Revision before the operation. */
-    version_before: number;
-    /** Revision after the operation, equal when idempotent. */
-    version_after: number;
-    /** Alias count after the operation. */
-    alias_count: number;
-    /** Unique non-canonical authors not covered after the operation. */
-    residual_author_count: number;
+/** Operation that was evaluated. */
+operation: AgentIdentityVocabularyOperation;
+/** Whether persistence would change. */
+changed: boolean;
+/** Revision before the operation. */
+version_before: number;
+/** Revision after the operation, equal when idempotent. */
+version_after: number;
+/** Alias count after the operation. */
+alias_count: number;
+/** Unique non-canonical authors not covered after the operation. */
+residual_author_count: number;
 }
 /** Planned vocabulary plus a privacy-safe result preview. */
 export interface AgentIdentityVocabularyMutationPlan {
-    /** Complete value suitable for settings persistence. */
-    vocabulary: AgentIdentityVocabulary;
-    /** Public mutation result with no alias spellings. */
-    preview: AgentIdentityVocabularyMutationPreview;
+/** Complete value suitable for settings persistence. */
+vocabulary: AgentIdentityVocabulary;
+/** Public mutation result with no alias spellings. */
+preview: AgentIdentityVocabularyMutationPreview;
 }
 /** Return only the revision and count suitable for config discovery surfaces. */
 export declare function summarizeAgentIdentityVocabulary(vocabulary: AgentIdentityVocabulary | undefined): AgentIdentityVocabularySummary;

package/dist/sdk/agent/item-addressing.d.ts

@@ -1,13 +1,13 @@
 /** Result of normalizing one item-addressed invocation. */
 export interface ItemAddressInvocationResult {
-    /** Canonical argv with an `--id` value moved into positional-id location. */
-    argv: string[];
-    /** Whether argv changed. */
-    changed: boolean;
-    /** Whether both positional and named item ids were supplied. */
-    conflict: boolean;
-    /** Resolved named item id when one was present. */
-    itemId?: string;
+/** Canonical argv with an `--id` value moved into positional-id location. */
+argv: string[];
+/** Whether argv changed. */
+changed: boolean;
+/** Whether both positional and named item ids were supplied. */
+conflict: boolean;
+/** Resolved named item id when one was present. */
+itemId?: string;
 }
 /** Return whether a command participates in the shared item-id alias contract. */
 export declare function supportsItemIdAlias(commandName: string | undefined): boolean;

package/dist/sdk/agent/refusal-closure-census.d.ts

@@ -12,37 +12,37 @@ import type { PmGrammarRefusalContract } from "./refusal-corpus-contracts.js";
 export type PmRefusalEvidenceKind = "owned_state" | "closed_domain" | "grammar";
 /** One complete-catalog closure row. */
 export interface PmRefusalClosureCensusRow {
-    /** Declared machine-readable error code. */
-    code: string;
-    /** Canonical compatibility-group code. */
-    canonical_code: string;
-    /** Whether at least one executable probe reaches the compatibility group. */
-    disposition: "executable" | "uncovered";
-    /** Evidence families contributing executable probes. */
-    evidence_kinds: PmRefusalEvidenceKind[];
-    /** Stable executable probe identities. */
-    probe_ids: string[];
+/** Declared machine-readable error code. */
+code: string;
+/** Canonical compatibility-group code. */
+canonical_code: string;
+/** Whether at least one executable probe reaches the compatibility group. */
+disposition: "executable" | "uncovered";
+/** Evidence families contributing executable probes. */
+evidence_kinds: PmRefusalEvidenceKind[];
+/** Stable executable probe identities. */
+probe_ids: string[];
 }
 /** Full emitted-vocabulary refusal closure receipt. */
 export interface PmRefusalClosureCensusReport {
-    /** True only when every catalog code belongs to a probed compatibility group. */
-    ok: boolean;
-    /** Number of emitted codes in the catalog. */
-    catalog_error_code_count: number;
-    /** Number of codes backed by executable evidence. */
-    executable_error_code_count: number;
-    /** Number of codes still lacking executable evidence. */
-    uncovered_error_code_count: number;
-    /** Executable codes divided by all catalog codes. */
-    coverage_fraction: number;
-    /** Number of closed-domain probes joined into the census. */
-    closed_domain_probe_count: number;
-    /** Number of grammar-derived probes joined into the census. */
-    grammar_probe_count: number;
-    /** Stable complete list of codes without executable evidence. */
-    uncovered_error_codes: string[];
-    /** Exactly one row for every catalog code. */
-    rows: PmRefusalClosureCensusRow[];
+/** True only when every catalog code belongs to a probed compatibility group. */
+ok: boolean;
+/** Number of emitted codes in the catalog. */
+catalog_error_code_count: number;
+/** Number of codes backed by executable evidence. */
+executable_error_code_count: number;
+/** Number of codes still lacking executable evidence. */
+uncovered_error_code_count: number;
+/** Executable codes divided by all catalog codes. */
+coverage_fraction: number;
+/** Number of closed-domain probes joined into the census. */
+closed_domain_probe_count: number;
+/** Number of grammar-derived probes joined into the census. */
+grammar_probe_count: number;
+/** Stable complete list of codes without executable evidence. */
+uncovered_error_codes: string[];
+/** Exactly one row for every catalog code. */
+rows: PmRefusalClosureCensusRow[];
 }
 /** @deprecated Historical v1 floor retained for SDK compatibility. */
 export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE = 16;
@@ -54,15 +54,15 @@ export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE_V2 = 18;
 export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2: readonly string[];
 /** Ratchet receipt that prevents catalog growth from erasing proven closure. */
 export declare function verifyPmRefusalClosureRatchet(report: PmRefusalClosureCensusReport, baseline?: number): {
-    ok: boolean;
-    baseline: number;
-    actual: number;
+ok: boolean;
+baseline: number;
+actual: number;
 };
 /** Ratchet canonical compatibility-group identities independently from counts. */
 export declare function verifyPmRefusalClosureIdentityRatchet(report: PmRefusalClosureCensusReport, requiredCanonicalCodes?: readonly string[]): {
-    ok: boolean;
-    required_canonical_codes: string[];
-    missing_required_canonical_codes: string[];
+ok: boolean;
+required_canonical_codes: string[];
+missing_required_canonical_codes: string[];
 };
 /** Build the complete closure join without silently omitting uncovered codes. */
 export declare function buildPmRefusalClosureCensus(catalog: readonly PmErrorCodeContract[], closedDomains: readonly PmClosedDomainContract[], grammar: readonly PmGrammarRefusalContract[]): PmRefusalClosureCensusReport;