@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/cli/description-stdin.d.ts

@@ -1,2 +1,2 @@
 /** Replace a description stdin sentinel with the complete standard-input payload. */
-export declare function resolveDescriptionStdin(options: Record<string, unknown>): Promise<void>;
+export declare function resolveDescriptionStdin(options:Record<string,unknown>):Promise<void>;

package/dist/cli/error-guidance.d.ts

@@ -1,216 +1,216 @@
-import { type PmCliErrorContext, type PmCliErrorRecoveryPayload } from "../sdk/runtime-primitives.js";
-import { type PmDiagnosticOutputReceipt, type PmProjectedDiagnostic } from "../sdk/cli-contracts/agent-output-contracts.js";
+import { type PmCliErrorContext,type PmCliErrorRecoveryPayload } from "../sdk/runtime-primitives.js";
+import { type PmDiagnosticOutputReceipt,type PmProjectedDiagnostic } from "../sdk/cli-contracts/agent-output-contracts.js";
 interface GuidanceMessage {
-policyViolations?: PmCliErrorContext["policy_violations"];
-policyViolationCount?: number;
-itemId?: string;
-transactionOperation?: PmCliErrorContext["transaction_operation"];
-tombstone?: PmCliErrorContext["tombstone"];
-code: string;
-type: string;
-title: string;
-happened: string;
-required: string;
-why?: string;
-examples?: string[];
-nextSteps?: string[];
-verificationErrors?: string[];
-flag?: string;
-value?: string;
-unmatchedSelectors?: NonNullable<PmCliErrorContext["unmatched_selectors"]>;
-availableDependencies?: NonNullable<PmCliErrorContext["available_dependencies"]>;
-recovery?: PmCliErrorRecoveryPayload;
+policyViolations?:PmCliErrorContext["policy_violations"];
+policyViolationCount?:number;
+itemId?:string;
+transactionOperation?:PmCliErrorContext["transaction_operation"];
+tombstone?:PmCliErrorContext["tombstone"];
+code:string;
+type:string;
+title:string;
+happened:string;
+required:string;
+why?:string;
+examples?:string[];
+nextSteps?:string[];
+verificationErrors?:string[];
+flag?:string;
+value?:string;
+unmatchedSelectors?:NonNullable<PmCliErrorContext["unmatched_selectors"]>;
+availableDependencies?:NonNullable<PmCliErrorContext["available_dependencies"]>;
+recovery?:PmCliErrorRecoveryPayload;
 }
 /** Compact refusal identity embedded in every structured error envelope. */
 export interface PmRefusalEnvelope {
 /** Command, flag, or missing operand that rejected the invocation. */
-surface: string;
+surface:string;
 /** Supplied scalar rejected by a closed domain, when available. */
-rejected_value?: string;
+rejected_value?:string;
 /** Complete legal domain advertised by the refusal, when applicable. */
-legal_domain?: string[];
+legal_domain?:string[];
 /** Required metadata paths from the displayed policy violations. */
-missing_fields?: string[];
+missing_fields?:string[];
 /** Policy identity, rule, rationale and missing fields, capped at three policies. */
-policies?: PmCliErrorContext["policy_violations"];
+policies?:PmCliErrorContext["policy_violations"];
 /** Total violated policies, including any omitted from policies. */
-policy_violation_count?: number;
+policy_violation_count?:number;
 /** Process exit code paired with the refusal. */
-exit_code: number;
+exit_code:number;
 }
 /** Documents the json error envelope payload exchanged by command, SDK, and package integrations. */
 export interface JsonErrorEnvelope {
 /** Ordered mutation that failed semantic preview validation. */
-transaction_operation?: PmCliErrorContext["transaction_operation"];
+transaction_operation?:PmCliErrorContext["transaction_operation"];
 /** Exact item identity attached to a storage diagnostic. */
-item_id?: string;
+item_id?:string;
 /** Verified retained deletion and its recoverable version. */
-tombstone?: PmCliErrorContext["tombstone"];
+tombstone?:PmCliErrorContext["tombstone"];
 /** Schema type that determines the shape and validation rules for this value. */
-type: string;
+type:string;
 /** Value that configures or reports code for this contract. */
-code: string;
+code:string;
 /** Value that configures or reports title for this contract. */
-title: string;
+title:string;
 /** Value that configures or reports detail for this contract. */
-detail: string;
+detail:string;
 /** Value that configures or reports required for this contract. */
-required: string;
+required:string;
 /** Value that configures or reports exit code for this contract. */
-exit_code: number;
+exit_code:number;
 /** Value that configures or reports why for this contract. */
-why?: string;
+why?:string;
 /** Value that configures or reports examples for this contract. */
-examples?: string[];
+examples?:string[];
 /** Value that configures or reports next steps for this contract. */
-next_steps?: string[];
+next_steps?:string[];
 /** Exact integrity verifier findings that caused the operation to refuse. */
-verification_errors?: string[];
+verification_errors?:string[];
 /** CLI flag whose supplied value violated a shared mutation grammar. */
-flag?: string;
+flag?:string;
 /** Supplied scalar value that violated a shared mutation grammar. */
-value?: string;
+value?:string;
 /** Dependency selectors that matched no stored edge. */
-unmatched_selectors?: NonNullable<PmCliErrorContext["unmatched_selectors"]>;
+unmatched_selectors?:NonNullable<PmCliErrorContext["unmatched_selectors"]>;
 /** Compact stored dependency identities available when a removal failed. */
-available_dependencies?: NonNullable<PmCliErrorContext["available_dependencies"]>;
+available_dependencies?:NonNullable<PmCliErrorContext["available_dependencies"]>;
 /** Value that configures or reports recovery for this contract. */
-recovery?: PmCliErrorRecoveryPayload;
+recovery?:PmCliErrorRecoveryPayload;
 /** Stable compact identity of the failing surface and legal recovery domain. */
-refusal: PmRefusalEnvelope;
+refusal:PmRefusalEnvelope;
 /** Binding output-budget receipt for this diagnostic. */
-diagnostic_output?: PmDiagnosticOutputReceipt;
+diagnostic_output?:PmDiagnosticOutputReceipt;
 }
 /** Error envelope after deterministic budget projection. */
 export type ProjectedJsonErrorEnvelope = PmProjectedDiagnostic<JsonErrorEnvelope>;
 /** Compact an error envelope to fields that change the caller's next action. */
-export declare function projectLeanErrorEnvelope(envelope: ProjectedJsonErrorEnvelope): ProjectedJsonErrorEnvelope;
+export declare function projectLeanErrorEnvelope(envelope:ProjectedJsonErrorEnvelope):ProjectedJsonErrorEnvelope;
 /** Documents the error classification payload exchanged by command, SDK, and package integrations. */
 export interface ErrorClassification {
 /** Ordered mutation that failed semantic preview validation. */
-transaction_operation?: PmCliErrorContext["transaction_operation"];
+transaction_operation?:PmCliErrorContext["transaction_operation"];
 /** Exact item identity attached to a storage diagnostic. */
-item_id?: string;
+item_id?:string;
 /** Verified retained deletion and its recoverable version. */
-tombstone?: PmCliErrorContext["tombstone"];
+tombstone?:PmCliErrorContext["tombstone"];
 /** Schema type that determines the shape and validation rules for this value. */
-type: string;
+type:string;
 /** Value that configures or reports code for this contract. */
-code: string;
+code:string;
 /** Value that configures or reports title for this contract. */
-title: string;
+title:string;
 /** Value that configures or reports detail for this contract. */
-detail: string;
+detail:string;
 /** Value that configures or reports required for this contract. */
-required: string;
+required:string;
 /** Value that configures or reports why for this contract. */
-why?: string;
+why?:string;
 /** Value that configures or reports examples for this contract. */
-examples?: string[];
+examples?:string[];
 /** Value that configures or reports next steps for this contract. */
-next_steps?: string[];
+next_steps?:string[];
 /** Exact integrity verifier findings that caused the operation to refuse. */
-verification_errors?: string[];
+verification_errors?:string[];
 /** CLI flag whose supplied value violated a shared mutation grammar. */
-flag?: string;
+flag?:string;
 /** Supplied scalar value that violated a shared mutation grammar. */
-value?: string;
+value?:string;
 /** Dependency selectors that matched no stored edge. */
-unmatched_selectors?: NonNullable<PmCliErrorContext["unmatched_selectors"]>;
+unmatched_selectors?:NonNullable<PmCliErrorContext["unmatched_selectors"]>;
 /** Compact stored dependency identities available when a removal failed. */
-available_dependencies?: NonNullable<PmCliErrorContext["available_dependencies"]>;
+available_dependencies?:NonNullable<PmCliErrorContext["available_dependencies"]>;
 /** Value that configures or reports recovery for this contract. */
-recovery?: PmCliErrorRecoveryPayload;
+recovery?:PmCliErrorRecoveryPayload;
 }
 /** Documents the commander guidance context payload exchanged by command, SDK, and package integrations. */
 export interface CommanderGuidanceContext {
 /** Value that configures or reports unknown command examples for this contract. */
-unknownCommandExamples?: string[];
+unknownCommandExamples?:string[];
 /** Value that configures or reports unknown command next steps for this contract. */
-unknownCommandNextSteps?: string[];
+unknownCommandNextSteps?:string[];
 /** Value that configures or reports attempted command for this contract. */
-attemptedCommand?: string;
+attemptedCommand?:string;
 /** Value that configures or reports normalized invocation args for this contract. */
-normalizedInvocationArgs?: string[];
+normalizedInvocationArgs?:string[];
 /** Value that configures or reports provided option flags for this contract. */
-providedOptionFlags?: string[];
+providedOptionFlags?:string[];
 /** Value that configures or reports unknown option suggestions for this contract. */
-unknownOptionSuggestions?: string[];
+unknownOptionSuggestions?:string[];
 /** Value that configures or reports unknown option other commands for this contract. */
-unknownOptionOtherCommands?: string[];
+unknownOptionOtherCommands?:string[];
 /** Complete number of commands accepting the unknown option. */
-unknownOptionOtherCommandsTotal?: number;
+unknownOptionOtherCommandsTotal?:number;
 /** Whether the structured command candidates reached their own ceiling. */
-unknownOptionOtherCommandsTruncated?: boolean;
+unknownOptionOtherCommandsTruncated?:boolean;
 /** Declared lexicon membership of the rejected option spelling. */
-unknownOptionScope?: PmCliErrorRecoveryPayload["option_scope"];
+unknownOptionScope?:PmCliErrorRecoveryPayload["option_scope"];
 /** Command family whose positional subcommand was split into invalid tokens. */
-unknownSubcommandPath?: string;
+unknownSubcommandPath?:string;
 /** Rejected positional subcommand token or token sequence. */
-unknownSubcommandToken?: string;
+unknownSubcommandToken?:string;
 /** Complete declared subcommand vocabulary for the command family. */
-unknownSubcommandAllowedValues?: string[];
+unknownSubcommandAllowedValues?:string[];
 /** Value that configures or reports suggested retry command for this contract. */
-suggestedRetryCommand?: string;
+suggestedRetryCommand?:string;
 /** Tokenized inspection retry that preserves a refusal without executing the guessed operation. */
-suggestedRetryArgs?: string[];
+suggestedRetryArgs?:string[];
 /** Existing item id verified against the selected tracker for collection recovery. */
-verifiedCollectionItemId?: string;
+verifiedCollectionItemId?:string;
 /** Installed extensions whose activation failed for this invocation. */
-failedExtensions?: Array<{
-name: string;
+failedExtensions?:Array<{
+name:string;
 }>;
 }
 interface PackageCommandHint {
 /** Published package name shown to the user (e.g. @unbrained/pm-guide-shell). */
-packageName: string;
+packageName:string;
 /** Exact CLI command that installs the bundled package by its install alias. */
-installCommand: string;
+installCommand:string;
 }
-declare function resolveKnownPackageCommandHint(commandToken: string): PackageCommandHint | undefined;
-declare function renderList(title: string, entries: string[]): string[];
-declare function normalizeRecoveryPayload(payload: PmCliErrorRecoveryPayload | undefined): PmCliErrorRecoveryPayload | undefined;
+declare function resolveKnownPackageCommandHint(commandToken:string):PackageCommandHint | undefined;
+declare function renderList(title:string,entries:string[]):string[];
+declare function normalizeRecoveryPayload(payload:PmCliErrorRecoveryPayload | undefined):PmCliErrorRecoveryPayload | undefined;
 /** Implements render guidance message for the public runtime surface of this module. */
-export declare function renderGuidanceMessage(message: GuidanceMessage): string;
-declare function guidanceToJsonEnvelope(message: GuidanceMessage, exitCode: number): JsonErrorEnvelope;
-declare function guidanceToClassification(message: GuidanceMessage): ErrorClassification;
-declare function dedupeStrings(values: string[]): string[];
-declare function buildFallbackTitleFromMessage(message: string): string | undefined;
+export declare function renderGuidanceMessage(message:GuidanceMessage):string;
+declare function guidanceToJsonEnvelope(message:GuidanceMessage,exitCode:number):JsonErrorEnvelope;
+declare function guidanceToClassification(message:GuidanceMessage):ErrorClassification;
+declare function dedupeStrings(values:string[]):string[];
+declare function buildFallbackTitleFromMessage(message:string):string | undefined;
 /** Merge SDK error evidence with CLI fallback guidance without discarding typed recovery or policy diagnostics. */
-declare function applyPmCliErrorContext(guidance: GuidanceMessage, rawMessage: string, context: PmCliErrorContext | undefined): GuidanceMessage;
-declare function commandExampleForRequiredOption(commandName: string | undefined, optionFlag: string, allowedTypes: string): string[];
-declare function buildCommanderRecoveryPayload(context: CommanderGuidanceContext | undefined, overrides?: Partial<PmCliErrorRecoveryPayload>): PmCliErrorRecoveryPayload | undefined;
-declare function appendIfMissing(entries: string[], value: string | undefined): string[];
+declare function applyPmCliErrorContext(guidance:GuidanceMessage,rawMessage:string,context:PmCliErrorContext | undefined):GuidanceMessage;
+declare function commandExampleForRequiredOption(commandName:string | undefined,optionFlag:string,allowedTypes:string):string[];
+declare function buildCommanderRecoveryPayload(context:CommanderGuidanceContext | undefined,overrides?:Partial<PmCliErrorRecoveryPayload>):PmCliErrorRecoveryPayload | undefined;
+declare function appendIfMissing(entries:string[],value:string | undefined):string[];
 /** Synthesize a copy-pasteable retry for the unquoted linked-test value shape `pm test <id> --add command npm test -- parser` by re-joining the shell-split value tokens into the documented quoted `key=value` form. Only fires when the item id already precedes the flag (so trailing tokens unambiguously belong to the value) and the token after `--add`/`--remove` is an entry-identity key. */
-export declare function buildLinkedTestQuotedRetryCommand(argv: string[] | undefined): string | undefined;
+export declare function buildLinkedTestQuotedRetryCommand(argv:string[] | undefined):string | undefined;
 /** Render concise initialization recovery or the bounded diagnostic for other failures. */
-export declare function formatPmCliErrorForDisplay(rawMessage: string, context?: PmCliErrorContext): string;
+export declare function formatPmCliErrorForDisplay(rawMessage:string,context?:PmCliErrorContext):string;
 /** Implements classify pm cli error for the public runtime surface of this module. */
-export declare function classifyPmCliError(rawMessage: string, context?: PmCliErrorContext): ErrorClassification;
+export declare function classifyPmCliError(rawMessage:string,context?:PmCliErrorContext):ErrorClassification;
 /** Implements format pm cli error for json for the public runtime surface of this module. */
-export declare function formatPmCliErrorForJson(rawMessage: string, exitCode: number, context?: PmCliErrorContext): ProjectedJsonErrorEnvelope;
+export declare function formatPmCliErrorForJson(rawMessage:string,exitCode:number,context?:PmCliErrorContext):ProjectedJsonErrorEnvelope;
 /** Implements format commander error for display for the public runtime surface of this module. */
-export declare function formatCommanderErrorForDisplay(rawMessage: string, commandName: string | undefined, allowedTypes: string, context?: CommanderGuidanceContext): string;
+export declare function formatCommanderErrorForDisplay(rawMessage:string,commandName:string | undefined,allowedTypes:string,context?:CommanderGuidanceContext):string;
 /** Implements classify commander error for the public runtime surface of this module. */
-export declare function classifyCommanderError(rawMessage: string, commandName: string | undefined, allowedTypes: string, context?: CommanderGuidanceContext): ErrorClassification;
+export declare function classifyCommanderError(rawMessage:string,commandName:string | undefined,allowedTypes:string,context?:CommanderGuidanceContext):ErrorClassification;
 /** Implements format commander error for json for the public runtime surface of this module. */
-export declare function formatCommanderErrorForJson(rawMessage: string, commandName: string | undefined, allowedTypes: string, exitCode: number, context?: CommanderGuidanceContext): ProjectedJsonErrorEnvelope;
+export declare function formatCommanderErrorForJson(rawMessage:string,commandName:string | undefined,allowedTypes:string,exitCode:number,context?:CommanderGuidanceContext):ProjectedJsonErrorEnvelope;
 /** Implements format unknown error for json for the public runtime surface of this module. */
-export declare function formatUnknownErrorForJson(rawMessage: string, exitCode: number): ProjectedJsonErrorEnvelope;
+export declare function formatUnknownErrorForJson(rawMessage:string,exitCode:number):ProjectedJsonErrorEnvelope;
 /** Implements classify unknown error for the public runtime surface of this module. */
-export declare function classifyUnknownError(rawMessage: string): ErrorClassification;
+export declare function classifyUnknownError(rawMessage:string):ErrorClassification;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-applyPmCliErrorContext: typeof applyPmCliErrorContext;
-appendIfMissing: typeof appendIfMissing;
-buildCommanderRecoveryPayload: typeof buildCommanderRecoveryPayload;
-buildFallbackTitleFromMessage: typeof buildFallbackTitleFromMessage;
-commandExampleForRequiredOption: typeof commandExampleForRequiredOption;
-dedupeStrings: typeof dedupeStrings;
-guidanceToClassification: typeof guidanceToClassification;
-guidanceToJsonEnvelope: typeof guidanceToJsonEnvelope;
-normalizeRecoveryPayload: typeof normalizeRecoveryPayload;
-renderList: typeof renderList;
-resolveKnownPackageCommandHint: typeof resolveKnownPackageCommandHint;
+export declare const _testOnly:{
+applyPmCliErrorContext:typeof applyPmCliErrorContext;
+appendIfMissing:typeof appendIfMissing;
+buildCommanderRecoveryPayload:typeof buildCommanderRecoveryPayload;
+buildFallbackTitleFromMessage:typeof buildFallbackTitleFromMessage;
+commandExampleForRequiredOption:typeof commandExampleForRequiredOption;
+dedupeStrings:typeof dedupeStrings;
+guidanceToClassification:typeof guidanceToClassification;
+guidanceToJsonEnvelope:typeof guidanceToJsonEnvelope;
+normalizeRecoveryPayload:typeof normalizeRecoveryPayload;
+renderList:typeof renderList;
+resolveKnownPackageCommandHint:typeof resolveKnownPackageCommandHint;
 };
 export {};

package/dist/cli/extension-command-help.d.ts

@@ -4,102 +4,102 @@
  * Provides CLI runtime support for Extension Command Help.
  */
 import { Command } from "commander";
-import { type FlagDefinition, type RegisteredExtensionCommandDefinition, type RegisteredExtensionFlagDefinitions } from "../sdk/runtime-primitives.js";
-import type { PmCommandCapabilityFamily, PmCommandVisibilityTier } from "../sdk/agent-capability-contracts.js";
+import { type FlagDefinition,type RegisteredExtensionCommandDefinition,type RegisteredExtensionFlagDefinitions } from "../sdk/runtime-primitives.js";
+import type { PmCommandCapabilityFamily,PmCommandVisibilityTier } from "../sdk/agent-capability-contracts.js";
 /** Documents the extension command argument help descriptor payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCommandArgumentHelpDescriptor {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports required for this contract. */
-required: boolean;
+required:boolean;
 /** Value that configures or reports variadic for this contract. */
-variadic: boolean;
+variadic:boolean;
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 }
 /** Documents the extension command help descriptor payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCommandHelpDescriptor {
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports action for this contract. */
-action: string;
+action:string;
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Value that configures or reports intent for this contract. */
-intent?: string;
+intent?:string;
 /** Value that configures or reports examples for this contract. */
-examples: string[];
+examples:string[];
 /** Value that configures or reports failure hints for this contract. */
-failure_hints: string[];
+failure_hints:string[];
 /** Value that configures or reports arguments for this contract. */
-arguments: ExtensionCommandArgumentHelpDescriptor[];
+arguments:ExtensionCommandArgumentHelpDescriptor[];
 /** Value that configures or reports flags for this contract. */
-flags: FlagDefinition[];
+flags:FlagDefinition[];
 /** Minimum agent surface tier declared by the package. */
-tier: PmCommandVisibilityTier;
+tier:PmCommandVisibilityTier;
 /** Capability family declared by the package. */
-family: PmCommandCapabilityFamily;
+family:PmCommandCapabilityFamily;
 /** Value that configures or reports source for this contract. */
-source?: {
-layer: "global" | "project";
-name: string;
-package?: string;
+source?:{
+layer:"global" | "project";
+name:string;
+package?:string;
 };
 }
 /** Documents the help option summary payload exchanged by command, SDK, and package integrations. */
 export interface HelpOptionSummary {
 /** Value that configures or reports flags for this contract. */
-flags: string;
+flags:string;
 /** Value that configures or reports long for this contract. */
-long: string | null;
+long:string | null;
 /** Value that configures or reports short for this contract. */
-short: string | null;
+short:string | null;
 /** Value that configures or reports description for this contract. */
-description: string;
+description:string;
 /** Value that configures or reports takes value for this contract. */
-takes_value: boolean;
+takes_value:boolean;
 /** Value that configures or reports value required for this contract. */
-value_required: boolean;
+value_required:boolean;
 /** Value that configures or reports value name for this contract. */
-value_name: string | null;
+value_name:string | null;
 /** Value that configures or reports variadic for this contract. */
-variadic: boolean;
+variadic:boolean;
 /** Value that configures or reports required for this contract. */
-required: boolean;
+required:boolean;
 /** Value that configures or reports aliases for this contract. */
-aliases: string[];
+aliases:string[];
 /** Value that configures or reports alias for for this contract. */
-alias_for: string | null;
+alias_for:string | null;
 /** Fallback value used when callers do not provide an override. */
-default_value?: unknown;
+default_value?:unknown;
 }
 /** Implements normalize extension command path for the public runtime surface of this module. */
-export declare function normalizeExtensionCommandPath(commandPath: string): string;
+export declare function normalizeExtensionCommandPath(commandPath:string):string;
 /** Build verified flattened-alias mappings within one extension and layer. */
-export declare function buildCanonicalExtensionAliases(handlers: ReadonlyArray<{
-command: string;
-layer: "project" | "global";
-name: string;
-}>, definitions: ReadonlyArray<{
-command: string;
-layer: "project" | "global";
-name: string;
-}>): Map<string, string>;
+export declare function buildCanonicalExtensionAliases(handlers:ReadonlyArray<{
+command:string;
+layer:"project" | "global";
+name:string;
+}>,definitions:ReadonlyArray<{
+command:string;
+layer:"project" | "global";
+name:string;
+}>):Map<string,string>;
 /** Resolve whether a registered extension flag consumes a value. */
-export declare function extensionFlagTakesValueForInvocation(invocationArgv: string[], commandName: string | undefined, normalizedMissing: string | undefined, descriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>): boolean | undefined;
+export declare function extensionFlagTakesValueForInvocation(invocationArgv:string[],commandName:string | undefined,normalizedMissing:string | undefined,descriptors:ReadonlyMap<string,ExtensionCommandHelpDescriptor>):boolean | undefined;
 /** Canonical value-arity contract shared by extension invocation recovery, Commander parsing, and structured help. */
-export declare function resolveExtensionFlagArity(definition: Readonly<FlagDefinition>): {
-takesValue: boolean;
-valueName: string | null;
+export declare function resolveExtensionFlagArity(definition:Readonly<FlagDefinition>):{
+takesValue:boolean;
+valueName:string | null;
 };
 /** Implements collect dynamic extension flag help by command for the public runtime surface of this module. */
-export declare function collectDynamicExtensionFlagHelpByCommand(registrations: RegisteredExtensionFlagDefinitions[]): Map<string, string>;
+export declare function collectDynamicExtensionFlagHelpByCommand(registrations:RegisteredExtensionFlagDefinitions[]):Map<string,string>;
 /** Implements collect extension command help descriptors for the public runtime surface of this module. */
-export declare function collectExtensionCommandHelpDescriptors(commandHandlers: string[], commandDefinitions: RegisteredExtensionCommandDefinition[], flagRegistrations: RegisteredExtensionFlagDefinitions[], canonicalAliases?: ReadonlyMap<string, string>): Map<string, ExtensionCommandHelpDescriptor>;
+export declare function collectExtensionCommandHelpDescriptors(commandHandlers:string[],commandDefinitions:RegisteredExtensionCommandDefinition[],flagRegistrations:RegisteredExtensionFlagDefinitions[],canonicalAliases?:ReadonlyMap<string,string>):Map<string,ExtensionCommandHelpDescriptor>;
 /** Implements apply dynamic extension arguments for the public runtime surface of this module. */
-export declare function applyDynamicExtensionArguments(command: Command, descriptor: ExtensionCommandHelpDescriptor): void;
+export declare function applyDynamicExtensionArguments(command:Command,descriptor:ExtensionCommandHelpDescriptor):void;
 /** Implements apply dynamic extension flag options for the public runtime surface of this module. */
-export declare function applyDynamicExtensionFlagOptions(command: Command, definitions: FlagDefinition[]): void;
+export declare function applyDynamicExtensionFlagOptions(command:Command,definitions:FlagDefinition[]):void;
 /**
  * Builds the "Extension-provided flags" help block for only the definitions that
  * are NOT already rendered as real commander options on {@link command}. After
@@ -108,29 +108,29 @@ export declare function applyDynamicExtensionFlagOptions(command: Command, defin
  * flag in `--help` output; this filters those already-listed flags out so the
  * block is emitted only when it carries flags the Options section does not.
  */
-export declare function buildResidualDynamicExtensionFlagHelp(command: Command, definitions: FlagDefinition[]): string | null;
+export declare function buildResidualDynamicExtensionFlagHelp(command:Command,definitions:FlagDefinition[]):string | null;
 /** Implements build dynamic extension help option summaries for the public runtime surface of this module. */
-export declare function buildDynamicExtensionHelpOptionSummaries(descriptor: ExtensionCommandHelpDescriptor | undefined): HelpOptionSummary[];
+export declare function buildDynamicExtensionHelpOptionSummaries(descriptor:ExtensionCommandHelpDescriptor | undefined):HelpOptionSummary[];
 /** Implements merge help option summaries for the public runtime surface of this module. */
-export declare function mergeHelpOptionSummaries(base: HelpOptionSummary[], extension: HelpOptionSummary[]): HelpOptionSummary[];
+export declare function mergeHelpOptionSummaries(base:HelpOptionSummary[],extension:HelpOptionSummary[]):HelpOptionSummary[];
 /** Implements build dynamic extension command metadata help for the public runtime surface of this module. */
-export declare function buildDynamicExtensionCommandMetadataHelp(descriptor: ExtensionCommandHelpDescriptor): string | null;
+export declare function buildDynamicExtensionCommandMetadataHelp(descriptor:ExtensionCommandHelpDescriptor):string | null;
 /** Implements command aliases for the public runtime surface of this module. */
-export declare function commandAliases(command: Command): string[];
+export declare function commandAliases(command:Command):string[];
 /** Implements find direct child command for the public runtime surface of this module. */
-export declare function findDirectChildCommand(parent: Command, name: string): Command | null;
+export declare function findDirectChildCommand(parent:Command,name:string):Command | null;
 /** Implements find command by path for the public runtime surface of this module. */
-export declare function findCommandByPath(root: Command, pathParts: string[]): Command | null;
+export declare function findCommandByPath(root:Command,pathParts:string[]):Command | null;
 /** Implements ensure command path for the public runtime surface of this module. */
-export declare function ensureCommandPath(root: Command, pathParts: string[]): Command | null;
+export declare function ensureCommandPath(root:Command,pathParts:string[]):Command | null;
 /** Locate core leaves that a path would replace or extend; existing groups can host unique extension leaves. */
-export declare function findExtensionCommandPathCollision(root: Command, pathParts: string[]): {
-core_path: string;
-extension_path: string;
+export declare function findExtensionCommandPathCollision(root:Command,pathParts:string[]):{
+core_path:string;
+extension_path:string;
 } | null;
 /** Build an ownership-rich warning when an extension alias would shadow or graft beneath a core command. */
-export declare function buildExtensionCommandCollisionWarning(root: Command, commandPath: string, aliases: ReadonlyMap<string, string>, descriptor: ExtensionCommandHelpDescriptor | undefined, hasHandler?: boolean): string | null;
+export declare function buildExtensionCommandCollisionWarning(root:Command,commandPath:string,aliases:ReadonlyMap<string,string>,descriptor:ExtensionCommandHelpDescriptor | undefined,hasHandler?:boolean):string | null;
 /** Collect deterministic extension command paths while reporting and excluding aliases that collide with core ownership. */
-export declare function collectSafeExtensionCommandPaths(root: Command, commandHandlers: readonly string[], descriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>, aliases: ReadonlyMap<string, string>, onCollision: (warning: string) => void): string[];
+export declare function collectSafeExtensionCommandPaths(root:Command,commandHandlers:readonly string[],descriptors:ReadonlyMap<string,ExtensionCommandHelpDescriptor>,aliases:ReadonlyMap<string,string>,onCollision:(warning:string) => void):string[];
 /** Record and surface one extension collision with stable recovery guidance. */
-export declare function reportExtensionCommandCollision(activationWarnings: string[], report: (message: string) => void, warning: string): void;
+export declare function reportExtensionCommandCollision(activationWarnings:string[],report:(message:string) => void,warning:string):void;