@unbrained/pm-cli 2026.10.11 → 2026.10.13

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

@@ -1,9 +1,3 @@
-/**
- * @module sdk/cli-contracts/runtime-contracts
- *
- * Assembles executable core and package contracts into bounded discovery
- * projections shared by CLI, SDK, and MCP consumers.
- */
 import { type GlobalOptions, type ExtensionRegistrationRegistry, type RegisteredExtensionCommandDefinition, type RegisteredExtensionFlagDefinitions, type RuntimeFieldRegistry, readSettings } from "../runtime-primitives.js";
 import { PM_HISTORY_OPERATION_CONTRACT } from "../../core/history/operation-contract.js";
 import { type McpToolContract } from "../../mcp/tool-definitions.js";
@@ -19,273 +13,275 @@ import { type PmCommandExitContract, type PmCommandExitOutcomeContract } from ".
 import { type PmCommandPositionalContract, type PmCommandDestinationContract } from "./grammar-contracts.js";
 /** Documents the contracts command options payload exchanged by command, SDK, and package integrations. */
 export interface ContractsCommandOptions {
-    /** Value that configures or reports action for this contract. */
-    action?: string;
-    /** Value that configures or reports command for this contract. */
-    command?: string;
-    /** Value that configures or reports summary for this contract. */
-    summary?: boolean;
-    /** Value that configures or reports schema only for this contract. */
-    schemaOnly?: boolean;
-    /** Value that configures or reports flags only for this contract. */
-    flagsOnly?: boolean;
-    /** Value that configures or reports availability only for this contract. */
-    availabilityOnly?: boolean;
-    /** Value that configures or reports runtime only for this contract. */
-    runtimeOnly?: boolean;
-    /** Value that configures or reports full for this contract. */
-    full?: boolean;
+/** Value that configures or reports action for this contract. */
+action?: string;
+/** Value that configures or reports command for this contract. */
+command?: string;
+/** Value that configures or reports summary for this contract. */
+summary?: boolean;
+/** Value that configures or reports schema only for this contract. */
+schemaOnly?: boolean;
+/** Value that configures or reports flags only for this contract. */
+flagsOnly?: boolean;
+/** Value that configures or reports availability only for this contract. */
+availabilityOnly?: boolean;
+/** Value that configures or reports runtime only for this contract. */
+runtimeOnly?: boolean;
+/** Value that configures or reports full for this contract. */
+full?: boolean;
 }
 interface CommandFlagSurface {
-    command: string;
-    canonical_command?: string;
-    visibility?: PmCommandVisibilityTier;
-    flags: CliFlagContract[];
-    positionals?: PmCommandPositionalContract["slots"];
-    flag_invocations?: CliFlagInvocationContract[];
-    provider?: "core" | "extension" | "mixed";
-    extension_sources?: Array<{
-        layer: "global" | "project";
-        name: string;
-    }>;
+command: string;
+canonical_command?: string;
+visibility?: PmCommandVisibilityTier;
+flags: CliFlagContract[];
+positionals?: PmCommandPositionalContract["slots"];
+flag_invocations?: CliFlagInvocationContract[];
+provider?: "core" | "extension" | "mixed";
+extension_sources?: Array<{
+layer: "global" | "project";
+name: string;
+}>;
 }
 /** Grouped command-alias projection retained for backward-compatible consumers. */
 export interface CommandAliasSurface {
-    /** Canonical command path shared by the grouped aliases. */
-    canonical: string;
-    /** Accepted alternate spellings for the canonical path. */
-    aliases: string[];
-    /** Per-spelling lifecycle, visibility, replacement, and ownership metadata. */
-    contracts?: PmCommandAliasContract[];
+/** Canonical command path shared by the grouped aliases. */
+canonical: string;
+/** Accepted alternate spellings for the canonical path. */
+aliases: string[];
+/** Per-spelling lifecycle, visibility, replacement, and ownership metadata. */
+contracts?: PmCommandAliasContract[];
 }
 /** Machine-readable projection behavior for one list command. */
 interface ListCommandProjectionSurface {
-    command: ListCommandName;
-    default: Exclude<ListProjectionMode, "fields">;
-    brief_fields: string[];
-    compact_fields: string[];
+command: ListCommandName;
+default: Exclude<ListProjectionMode, "fields">;
+brief_fields: string[];
+compact_fields: string[];
 }
 /** Documents the contracts result payload exchanged by command, SDK, and package integrations. */
 export interface ContractsResult {
-    /** Immutable event names, historical aliases, and package operation grammar. */
-    history_operations?: typeof PM_HISTORY_OPERATION_CONTRACT;
-    /** Value that configures or reports schema version for this contract. */
-    schema_version: string | null;
-    /** Value that configures or reports schema id for this contract. */
-    schema_id: string | null;
-    /** Value that configures or reports selected for this contract. */
-    selected: {
-        action: string | null;
-        command: string | null;
-        summary: boolean;
-        schema_only: boolean;
-        flags_only: boolean;
-        availability_only: boolean;
-        runtime_only: boolean;
-        command_scoped: boolean;
-    };
-    /** Value that configures or reports actions for this contract. */
-    actions?: string[];
-    /** Value that configures or reports action availability for this contract. */
-    action_availability?: ContractsActionAvailability[];
-    /** Value that configures or reports commands for this contract. */
-    commands: string[];
-    /** Value that configures or reports schema for this contract. */
-    schema?: Record<string, unknown>;
-    /** Value that configures or reports schema omitted reason for this contract. */
-    schema_omitted_reason?: string;
-    /** Value that configures or reports command flags omitted reason for this contract. */
-    command_flags_omitted_reason?: string;
-    /** Value that configures or reports commander aliases omitted reason for this contract. */
-    commander_aliases_omitted_reason?: string;
-    /** Value that configures or reports command flags for this contract. */
-    command_flags?: CommandFlagSurface[];
-    /** Default and named field projections for list-family commands in scope. */
-    list_projections?: ListCommandProjectionSurface[];
-    /** Value that configures or reports command aliases for this contract. */
-    command_aliases?: CommandAliasSurface[];
-    /** Compact projections omit alias lifecycle metadata; restore it with --full. */
-    command_alias_contracts_omitted_reason?: string;
-    /** Noun–verb routing policy and exhaustive current-command destinations. */
-    grammar_contracts?: {
-        nouns: readonly string[];
-        shared_verbs: readonly string[];
-        scope_before_verb: boolean;
-        visible_top_level_ceiling: number;
-        ceiling_raise_requires_pm_item: boolean;
-        positional_shape_budget: number;
-        positional_shape_count: number;
-        positional_action_count: number;
-        positional_action_parents: readonly string[];
-        positional_signatures?: readonly PmCommandPositionalContract[];
-        destinations?: readonly PmCommandDestinationContract[];
-    };
-    /** Value that configures or reports commander aliases for this contract. */
-    commander_aliases?: Record<string, CommanderOptionAliasContract[]>;
-    /** Value that configures or reports extension commands for this contract. */
-    extension_commands?: ExtensionCommandContract[];
-    /** Value that configures or reports command summaries for this contract. */
-    command_summaries?: CommandSummarySurface[];
-    /** Shared deterministic degradation policy for command output budgets. */
-    output_policy?: {
-        token_estimate: "ceil(utf8_bytes / 4)";
-        degradation_ladder: string[];
-        allows_unbounded_opt_out: boolean;
-    };
-    /** Exact per-command projection vocabularies and the scope of the compatibility union. */
-    output_projection_contracts?: {
-        global_ladder_field: "output_policy.degradation_ladder";
-        global_ladder_scope: "union_not_per_command";
-        discovery: "pm contracts --command <command> --summary";
-        commands?: Array<{
-            command: string;
-            modes: string[];
-        }>;
-    };
-    /** Value that configures or reports runtime schema for this contract. */
-    runtime_schema?: {
-        statuses: string[];
-        open_status: string;
-        close_status: string;
-        canceled_status: string;
-        types: string[];
-        fields_by_command: Record<string, string[]>;
-    };
-    /** Canonical relationship ontology and accepted compatibility aliases. */
-    relationship_kind_contracts?: Array<{
-        canonical: string;
-        aliases: string[];
-        inverse?: string;
-        ordering: boolean;
-        hierarchy: boolean;
-    }>;
-    /** Value that configures or reports extension contracts for this contract. */
-    extension_contracts?: {
-        capabilities: string[];
-        services: string[];
-        policy_modes: string[];
-        /** Settings path governed by policy_modes; prevents conflation with workflow governance. */
-        policy_mode_scope: "extensions.policy.mode";
-        policy_surfaces: string[];
-        trust_modes: string[];
-        /** Settings path governed by trust_modes. */
-        trust_mode_scope: "extensions.policy.trust_mode";
-        sandbox_profiles: string[];
-        manifest_versions: number[];
-        compatibility: {
-            current: string;
-            previous: string[];
-            breaking_strategy: string;
-        };
-    };
-    /** Canonical value domains accepted by project governance config setters. */
-    governance_contracts?: {
-        ownership_enforcement_modes: string[];
-        create_modes: string[];
-        close_validation_modes: string[];
-        workflow_enforcement_modes: string[];
-    };
-    /** Authoritative assurance declaration vocabularies for SDK and host validation. */
-    assurance_contracts?: {
-        measurement_source_kinds: readonly string[];
-        gate_triggers: readonly string[];
-    };
-    /** Value that configures or reports mcp tools for this contract. */
-    mcp_tools?: McpToolContract[];
-    /** Built-in intent-scoped read projections available to CLI, SDK, MCP, and package consumers. */
-    context_intents?: readonly PmContextIntentContract[];
-    /** Canonical include, amount, cost, and encoding contracts for every built-in read surface. */
-    read_output_dimensions?: readonly PmReadOutputSurfaceContract[];
-    /** Exhaustive stable and provisional machine-readable failure vocabulary. */
-    error_codes?: readonly PmErrorCodeContract[];
-    /** Format-aware budgets and envelope families for every active command. */
-    command_output_contracts?: Array<{
-        budget: PmCommandOutputBudgetContract;
-        envelope: PmCommandOutputEnvelopeContract;
-    }>;
-    /** Binding ceilings and action-preserving degradation for diagnostic families. */
-    diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[];
-    /** Stable outcome vocabulary and exhaustive per-command process exit sets. */
-    command_exit_contracts?: {
-        vocabulary: readonly PmCommandExitOutcomeContract[];
-        command_sets: Array<{
-            commands: string[];
-            exit_codes: PmCommandExitContract["exit_codes"];
-        }>;
-    };
+/** Immutable event names, historical aliases, and package operation grammar. */
+history_operations?: typeof PM_HISTORY_OPERATION_CONTRACT;
+/** Value that configures or reports schema version for this contract. */
+schema_version: string | null;
+/** Value that configures or reports schema id for this contract. */
+schema_id: string | null;
+/** Value that configures or reports selected for this contract. */
+selected: {
+action: string | null;
+command: string | null;
+summary: boolean;
+schema_only: boolean;
+flags_only: boolean;
+availability_only: boolean;
+runtime_only: boolean;
+command_scoped: boolean;
+};
+/** Value that configures or reports actions for this contract. */
+actions?: string[];
+/** Value that configures or reports action availability for this contract. */
+action_availability?: ContractsActionAvailability[];
+/** Value that configures or reports commands for this contract. */
+commands: string[];
+/** Value that configures or reports schema for this contract. */
+schema?: Record<string, unknown>;
+/** Value that configures or reports schema omitted reason for this contract. */
+schema_omitted_reason?: string;
+/** Value that configures or reports command flags omitted reason for this contract. */
+command_flags_omitted_reason?: string;
+/** Value that configures or reports commander aliases omitted reason for this contract. */
+commander_aliases_omitted_reason?: string;
+/** Value that configures or reports command flags for this contract. */
+command_flags?: CommandFlagSurface[];
+/** Default and named field projections for list-family commands in scope. */
+list_projections?: ListCommandProjectionSurface[];
+/** Value that configures or reports command aliases for this contract. */
+command_aliases?: CommandAliasSurface[];
+/** Compact projections omit alias lifecycle metadata; restore it with --full. */
+command_alias_contracts_omitted_reason?: string;
+/** Noun–verb routing policy and exhaustive current-command destinations. */
+grammar_contracts?: {
+nouns: readonly string[];
+shared_verbs: readonly string[];
+scope_before_verb: boolean;
+visible_top_level_ceiling: number;
+ceiling_raise_requires_pm_item: boolean;
+positional_shape_budget: number;
+positional_shape_count: number;
+positional_action_count: number;
+positional_action_parents: readonly string[];
+positional_signatures?: readonly PmCommandPositionalContract[];
+destinations?: readonly PmCommandDestinationContract[];
+};
+/** Value that configures or reports commander aliases for this contract. */
+commander_aliases?: Record<string, CommanderOptionAliasContract[]>;
+/** Value that configures or reports extension commands for this contract. */
+extension_commands?: ExtensionCommandContract[];
+/** Value that configures or reports command summaries for this contract. */
+command_summaries?: CommandSummarySurface[];
+/** Shared deterministic degradation policy for command output budgets. */
+output_policy?: {
+token_estimate: "ceil(utf8_bytes / 4)";
+degradation_ladder: string[];
+allows_unbounded_opt_out: boolean;
+};
+/** Exact per-command projection vocabularies and the scope of the compatibility union. */
+output_projection_contracts?: {
+global_ladder_field: "output_policy.degradation_ladder";
+global_ladder_scope: "union_not_per_command";
+discovery: "pm contracts --command <command> --summary";
+commands?: Array<{
+command: string;
+modes: string[];
+}>;
+};
+/** Value that configures or reports runtime schema for this contract. */
+runtime_schema?: {
+statuses: string[];
+open_status: string;
+close_status: string;
+canceled_status: string;
+types: string[];
+fields_by_command: Record<string, string[]>;
+};
+/** Canonical relationship ontology and accepted compatibility aliases. */
+relationship_kind_contracts?: Array<{
+canonical: string;
+aliases: string[];
+inverse?: string;
+ordering: boolean;
+hierarchy: boolean;
+}>;
+/** Value that configures or reports extension contracts for this contract. */
+extension_contracts?: {
+capabilities: string[];
+services: string[];
+policy_modes: string[];
+/** Settings path governed by policy_modes; prevents conflation with workflow governance. */
+policy_mode_scope: "extensions.policy.mode";
+policy_surfaces: string[];
+trust_modes: string[];
+/** Settings path governed by trust_modes. */
+trust_mode_scope: "extensions.policy.trust_mode";
+sandbox_profiles: string[];
+manifest_versions: number[];
+compatibility: {
+current: string;
+previous: string[];
+breaking_strategy: string;
+};
+};
+/** Canonical value domains accepted by project governance config setters. */
+governance_contracts?: {
+ownership_enforcement_modes: string[];
+create_modes: string[];
+close_validation_modes: string[];
+workflow_enforcement_modes: string[];
+};
+/** Authoritative assurance declaration vocabularies for SDK and host validation. */
+assurance_contracts?: {
+measurement_source_kinds: readonly string[];
+gate_triggers: readonly string[];
+};
+/** Value that configures or reports mcp tools for this contract. */
+mcp_tools?: McpToolContract[];
+/** Built-in intent-scoped read projections available to CLI, SDK, MCP, and package consumers. */
+context_intents?: readonly PmContextIntentContract[];
+/** Canonical include, amount, cost, and encoding contracts for every built-in read surface. */
+read_output_dimensions?: readonly PmReadOutputSurfaceContract[];
+/** Exhaustive stable and provisional machine-readable failure vocabulary. */
+error_codes?: readonly PmErrorCodeContract[];
+/** Format-aware budgets and envelope families for every active command. */
+command_output_contracts?: Array<{
+budget: PmCommandOutputBudgetContract;
+envelope: PmCommandOutputEnvelopeContract;
+}>;
+/** Binding ceilings and action-preserving degradation for diagnostic families. */
+diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[];
+/** Stable outcome vocabulary and exhaustive per-command process exit sets. */
+command_exit_contracts?: {
+vocabulary: readonly PmCommandExitOutcomeContract[];
+command_sets: Array<{
+commands: string[];
+exit_codes: PmCommandExitContract["exit_codes"];
+}>;
+};
 }
 type PmToolAction = (typeof PM_TOOL_ACTIONS)[number];
 /** Documents the contracts action availability payload exchanged by command, SDK, and package integrations. */
 export interface ContractsActionAvailability {
-    /** Value that configures or reports action for this contract. */
-    action: string;
-    /** Value that configures or reports invocable for this contract. */
-    invocable: boolean;
-    /** Value that configures or reports available for this contract. */
-    available: boolean;
-    /** Value that configures or reports requires extension for this contract. */
-    requires_extension: boolean;
-    /** Value that configures or reports provider for this contract. */
-    provider: "core" | "extension";
-    /** Value that configures or reports disabled reason for this contract. */
-    disabled_reason: string | null;
-    /** Filesystem path used for command resolution. */
-    command_path: string | null;
-    /** Value that configures or reports cli exposed for this contract. */
-    cli_exposed: boolean;
-    /** Value that configures or reports policy state for this contract. */
-    policy_state?: {
-        mode: string;
-        trust_mode: string;
-        default_sandbox_profile: string;
-    };
+/** Value that configures or reports action for this contract. */
+action: string;
+/** Value that configures or reports invocable for this contract. */
+invocable: boolean;
+/** Value that configures or reports available for this contract. */
+available: boolean;
+/** Value that configures or reports requires extension for this contract. */
+requires_extension: boolean;
+/** Value that configures or reports provider for this contract. */
+provider: "core" | "extension";
+/** Value that configures or reports disabled reason for this contract. */
+disabled_reason: string | null;
+/** Filesystem path used for command resolution. */
+command_path: string | null;
+/** Value that configures or reports cli exposed for this contract. */
+cli_exposed: boolean;
+/** Value that configures or reports policy state for this contract. */
+policy_state?: {
+mode: string;
+trust_mode: string;
+default_sandbox_profile: string;
+};
 }
 interface RuntimeExtensionActionProbe {
-    handlers: Set<string>;
-    disabledReason: string | null;
-    commandDefinitions: RegisteredExtensionCommandDefinition[];
-    flagRegistrations: RegisteredExtensionFlagDefinitions[];
-    registrations: ExtensionRegistrationRegistry | null;
-    policyState: {
-        mode: string;
-        trust_mode: string;
-        default_sandbox_profile: string;
-    };
+handlers: Set<string>;
+disabledReason: string | null;
+commandDefinitions: RegisteredExtensionCommandDefinition[];
+flagRegistrations: RegisteredExtensionFlagDefinitions[];
+registrations: ExtensionRegistrationRegistry | null;
+policyState: {
+mode: string;
+trust_mode: string;
+default_sandbox_profile: string;
+};
 }
 interface ExtensionCommandContract {
-    /** Package-declared discovery tier, retained for full and scoped inspection. */
-    tier?: PmCommandVisibilityTier;
-    command: string;
-    action: string;
-    source: {
-        layer: "global" | "project";
-        name: string;
-    } | null;
-    description: string | null;
-    intent: string | null;
-    arguments: Array<{
-        name: string;
-        required: boolean;
-        variadic: boolean;
-        description: string | null;
-    }>;
-    flags: CliFlagContract[];
-    examples: string[];
-    failure_hints: string[];
+/** Read-only structured output declaration contributed by the package. */
+read_output?: RegisteredExtensionCommandDefinition["read_output"];
+/** Package-declared discovery tier, retained for full and scoped inspection. */
+tier?: PmCommandVisibilityTier;
+command: string;
+action: string;
+source: {
+layer: "global" | "project";
+name: string;
+} | null;
+description: string | null;
+intent: string | null;
+arguments: Array<{
+name: string;
+required: boolean;
+variadic: boolean;
+description: string | null;
+}>;
+flags: CliFlagContract[];
+examples: string[];
+failure_hints: string[];
 }
 interface CommandSummarySurface {
-    command: string;
-    aliases?: string[];
-    intent: string;
-    /** Non-default provenance in compact output; exhaustive provenance in full output. */
-    intent_source?: "command" | "description" | "generated";
-    flags?: string[];
-    default_max_estimated_tokens: number;
-    /** Full-projection format detail; compact summaries retain the canonical default only. */
-    default_max_estimated_tokens_by_format?: {
-        toon: number;
-        json: number;
-    };
+command: string;
+aliases?: string[];
+intent: string;
+/** Non-default provenance in compact output; exhaustive provenance in full output. */
+intent_source?: "command" | "description" | "generated";
+flags?: string[];
+default_max_estimated_tokens: number;
+/** Full-projection format detail; compact summaries retain the canonical default only. */
+default_max_estimated_tokens_by_format?: {
+toon: number;
+json: number;
+};
 }
 declare function packageOwnedActionForCommand(command: string): string;
 /** Project stable SDK/MCP actions into discoverable CLI paths, retaining native and legacy spellings. */
@@ -301,11 +297,11 @@ declare function normalizeCommandPath(value: string): string;
 declare function normalizeActionNameFromCommand(commandPath: string): string;
 declare function normalizeExtensionFlagName(value: unknown, kind: "long" | "short"): string | null;
 declare function collectExtensionFlagContractsByCommand(registrations: RegisteredExtensionFlagDefinitions[]): Map<string, {
-    flags: CliFlagContract[];
-    sources: Array<{
-        layer: "global" | "project";
-        name: string;
-    }>;
+flags: CliFlagContract[];
+sources: Array<{
+layer: "global" | "project";
+name: string;
+}>;
 }>;
 /** Preserve registered package metadata and combine handler, argument, and flag contributions by command path. */
 declare function collectExtensionCommandContracts(runtimeProbe: RuntimeExtensionActionProbe): ExtensionCommandContract[];
@@ -314,14 +310,14 @@ declare function buildExtensionActionSchemaBranch(contract: ExtensionCommandCont
 declare function mergeExtensionContractsByAction(contracts: ExtensionCommandContract[]): ExtensionCommandContract[];
 declare function resolveRuntimeExtensionActionProbe(global: GlobalOptions, readSettingsFn?: typeof readSettings): Promise<RuntimeExtensionActionProbe>;
 interface ActionContractDescriptor {
-    action: string;
-    provider: "core" | "extension";
-    requires_extension: boolean;
-    command_path: string | null;
+action: string;
+provider: "core" | "extension";
+requires_extension: boolean;
+command_path: string | null;
 }
 /** Merge stable core and package action identities with canonical command paths for contract discovery. */
 declare function collectActionContractDescriptors(extensionContracts: ExtensionCommandContract[], options?: {
-    includePackageOwnedActions?: boolean;
+includePackageOwnedActions?: boolean;
 }): ActionContractDescriptor[];
 /** Derive invocability from active handlers and policy, preserving installation hints for unavailable optional operations. */
 declare function resolveActionAvailability(descriptor: ActionContractDescriptor, runtimeProbe: RuntimeExtensionActionProbe): ContractsActionAvailability;
@@ -338,8 +334,8 @@ declare function attachCreateRequiredOptionContracts(schema: Record<string, unkn
 declare function readContractsSettings(pmRoot: string, readSettingsFn?: typeof readSettings): Promise<Awaited<ReturnType<typeof readSettings>>>;
 /** Build stable agent summaries with available bootstrap flags and independently selectable budget and intent metadata. */
 declare function buildCommandSummarySurface(commands: readonly string[], extensionContracts?: readonly ExtensionCommandContract[], options?: {
-    includeFormatBudgets?: boolean;
-    includeIntentProvenance?: boolean;
+includeFormatBudgets?: boolean;
+includeIntentProvenance?: boolean;
 }): CommandSummarySurface[];
 declare function buildCommandOutputContracts(commands: readonly string[]): NonNullable<ContractsResult["command_output_contracts"]>;
 declare function buildCommandExitContractGroups(commands: readonly string[]): NonNullable<ContractsResult["command_exit_contracts"]>["command_sets"];
@@ -347,35 +343,35 @@ declare function buildCommandExitContractGroups(commands: readonly string[]): No
 export declare function runContracts(options: ContractsCommandOptions, global: GlobalOptions): Promise<ContractsResult>;
 /** Public contract for test only contracts command, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyContractsCommand: {
-    actionDescriptorMatchesSelectedCommand: typeof actionDescriptorMatchesSelectedCommand;
-    attachCreateRequiredOptionContracts: typeof attachCreateRequiredOptionContracts;
-    buildExtensionActionSchemaBranch: typeof buildExtensionActionSchemaBranch;
-    buildCommandSummarySurface: typeof buildCommandSummarySurface;
-    buildCommandOutputContracts: typeof buildCommandOutputContracts;
-    buildCommandExitContractGroups: typeof buildCommandExitContractGroups;
-    buildRuntimeFieldFlagContracts: typeof buildRuntimeFieldFlagContracts;
-    collectActionContractDescriptors: typeof collectActionContractDescriptors;
-    collectExtensionCommandContracts: typeof collectExtensionCommandContracts;
-    collectExtensionFlagContractsByCommand: typeof collectExtensionFlagContractsByCommand;
-    extractActionBranches: typeof extractActionBranches;
-    extensionSchemaPropertyNameFromFlag: typeof extensionSchemaPropertyNameFromFlag;
-    filterSchemaByAction: typeof filterSchemaByAction;
-    filterSchemaByActions: typeof filterSchemaByActions;
-    isCoreCommandPath: typeof isCoreCommandPath;
-    mergeExtensionContractsByAction: typeof mergeExtensionContractsByAction;
-    normalizeExtensionFlagName: typeof normalizeExtensionFlagName;
-    normalizeActionNameFromCommand: typeof normalizeActionNameFromCommand;
-    normalizeCommandForRuntimeFieldFlags: typeof normalizeCommandForRuntimeFieldFlags;
-    normalizeCommandPath: typeof normalizeCommandPath;
-    packageOwnedActionForCommand: typeof packageOwnedActionForCommand;
-    readContractsSettings: typeof readContractsSettings;
-    resolveActionCommandPath: typeof resolveActionCommandPath;
-    resolveActionAvailability: typeof resolveActionAvailability;
-    resolveCoreCommandFlags: typeof resolveCoreCommandFlags;
-    resolveRuntimeExtensionActionProbe: typeof resolveRuntimeExtensionActionProbe;
-    resolveScopedCommandsFromActionDescriptors: typeof resolveScopedCommandsFromActionDescriptors;
-    splitCommandPathAliases: typeof splitCommandPathAliases;
-    toRuntimeLongFlagToken: typeof toRuntimeLongFlagToken;
-    toRuntimeShortFlagToken: typeof toRuntimeShortFlagToken;
+actionDescriptorMatchesSelectedCommand: typeof actionDescriptorMatchesSelectedCommand;
+attachCreateRequiredOptionContracts: typeof attachCreateRequiredOptionContracts;
+buildExtensionActionSchemaBranch: typeof buildExtensionActionSchemaBranch;
+buildCommandSummarySurface: typeof buildCommandSummarySurface;
+buildCommandOutputContracts: typeof buildCommandOutputContracts;
+buildCommandExitContractGroups: typeof buildCommandExitContractGroups;
+buildRuntimeFieldFlagContracts: typeof buildRuntimeFieldFlagContracts;
+collectActionContractDescriptors: typeof collectActionContractDescriptors;
+collectExtensionCommandContracts: typeof collectExtensionCommandContracts;
+collectExtensionFlagContractsByCommand: typeof collectExtensionFlagContractsByCommand;
+extractActionBranches: typeof extractActionBranches;
+extensionSchemaPropertyNameFromFlag: typeof extensionSchemaPropertyNameFromFlag;
+filterSchemaByAction: typeof filterSchemaByAction;
+filterSchemaByActions: typeof filterSchemaByActions;
+isCoreCommandPath: typeof isCoreCommandPath;
+mergeExtensionContractsByAction: typeof mergeExtensionContractsByAction;
+normalizeExtensionFlagName: typeof normalizeExtensionFlagName;
+normalizeActionNameFromCommand: typeof normalizeActionNameFromCommand;
+normalizeCommandForRuntimeFieldFlags: typeof normalizeCommandForRuntimeFieldFlags;
+normalizeCommandPath: typeof normalizeCommandPath;
+packageOwnedActionForCommand: typeof packageOwnedActionForCommand;
+readContractsSettings: typeof readContractsSettings;
+resolveActionCommandPath: typeof resolveActionCommandPath;
+resolveActionAvailability: typeof resolveActionAvailability;
+resolveCoreCommandFlags: typeof resolveCoreCommandFlags;
+resolveRuntimeExtensionActionProbe: typeof resolveRuntimeExtensionActionProbe;
+resolveScopedCommandsFromActionDescriptors: typeof resolveScopedCommandsFromActionDescriptors;
+splitCommandPathAliases: typeof splitCommandPathAliases;
+toRuntimeLongFlagToken: typeof toRuntimeLongFlagToken;
+toRuntimeShortFlagToken: typeof toRuntimeShortFlagToken;
 };
 export {};