@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/cli/help-json-payload.d.ts

@@ -5,79 +5,79 @@
  */
 import { Command } from "commander";
 import { resolveItemTypeRegistry } from "../sdk/runtime-primitives.js";
-import { type HelpOptionSummary, type ExtensionCommandHelpDescriptor } from "./extension-command-help.js";
+import { type HelpOptionSummary,type ExtensionCommandHelpDescriptor } from "./extension-command-help.js";
 import { type PmPositionalActionContract } from "../sdk/cli-contracts/grammar-contracts.js";
-import { type PmCommandCapabilityFamily, type PmCommandVisibilityTier } from "../sdk/agent-capability-contracts.js";
+import { type PmCommandCapabilityFamily,type PmCommandVisibilityTier } from "../sdk/agent-capability-contracts.js";
 /** Documents the help argument summary payload exchanged by command, SDK, and package integrations. */
 export interface HelpArgumentSummary {
 /** 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 | null;
+description:string | null;
 }
 /** Documents the help subcommand summary payload exchanged by command, SDK, and package integrations. */
 export interface HelpSubcommandSummary {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports aliases for this contract. */
-aliases: string[];
+aliases:string[];
 /** Value that configures or reports description for this contract. */
-description: string;
+description:string;
 /** Shared command visibility tier. */
-tier: PmCommandVisibilityTier;
+tier:PmCommandVisibilityTier;
 /** Shared command capability family. */
-family: PmCommandCapabilityFamily;
+family:PmCommandCapabilityFamily;
 /** Canonical command path when this row is an executable alias. */
-alias_for?: string;
+alias_for?:string;
 /** Compatibility lifecycle declared by the canonical alias contract. */
-alias_lifecycle?: "permanent" | "deprecated";
+alias_lifecycle?:"permanent" | "deprecated";
 /** True when callers should migrate from this executable spelling. */
-deprecated?: true;
+deprecated?:true;
 }
-type ExtensionCommandSurface = Pick<ExtensionCommandHelpDescriptor, "tier" | "family">;
+type ExtensionCommandSurface = Pick<ExtensionCommandHelpDescriptor,"tier" | "family">;
 /** Resolve semantic package metadata, or fold descendant tiers and families for a namespace. */
-declare function resolveExtensionCommandSurface(commandPath: string, descriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>, allowDescendants?: boolean): ExtensionCommandSurface | undefined;
+declare function resolveExtensionCommandSurface(commandPath:string,descriptors:ReadonlyMap<string,ExtensionCommandHelpDescriptor>,allowDescendants?:boolean):ExtensionCommandSurface | undefined;
 /** Find a registered command or known positional parent; reject missing namespace leaves instead of returning root help. */
-declare function resolveCommandFromPathTokens(root: Command, pathTokens: string[]): Command | null;
-declare function readOptionAttributeName(option: unknown): string | null;
-declare function buildOptionAliasMap(options: unknown[]): Map<string, string[]>;
-declare function buildHelpOptionSummaries(command: Command): HelpOptionSummary[];
-declare function compactHelpOptionAliases(options: HelpOptionSummary[]): HelpOptionSummary[];
-declare function buildHelpArgumentSummaries(command: Command): HelpArgumentSummary[];
+declare function resolveCommandFromPathTokens(root:Command,pathTokens:string[]):Command | null;
+declare function readOptionAttributeName(option:unknown):string | null;
+declare function buildOptionAliasMap(options:unknown[]):Map<string,string[]>;
+declare function buildHelpOptionSummaries(command:Command):HelpOptionSummary[];
+declare function compactHelpOptionAliases(options:HelpOptionSummary[]):HelpOptionSummary[];
+declare function buildHelpArgumentSummaries(command:Command):HelpArgumentSummary[];
 /** Describe discoverable children with semantic tiers and package metadata, retaining hidden public commands for full discovery. */
-declare function buildHelpSubcommandSummaries(command: Command, extensionDescriptors?: ReadonlyMap<string, ExtensionCommandHelpDescriptor>, includeAll?: boolean): HelpSubcommandSummary[];
+declare function buildHelpSubcommandSummaries(command:Command,extensionDescriptors?:ReadonlyMap<string,ExtensionCommandHelpDescriptor>,includeAll?:boolean):HelpSubcommandSummary[];
 interface PositionalActionHelpProjection {
-arguments: HelpArgumentSummary[];
-options: HelpOptionSummary[];
-subcommands: HelpSubcommandSummary[];
-usage: string;
+arguments:HelpArgumentSummary[];
+options:HelpOptionSummary[];
+subcommands:HelpSubcommandSummary[];
+usage:string;
 }
 /** Build the command/action structural view shared by every JSON help field. */
-declare function buildPositionalActionHelpProjection(action: PmPositionalActionContract | undefined, targetCommand: Command, resolvedPath: string, allOptions: HelpOptionSummary[], extensionDescriptors?: ReadonlyMap<string, ExtensionCommandHelpDescriptor>, includeAll?: boolean): PositionalActionHelpProjection;
+declare function buildPositionalActionHelpProjection(action:PmPositionalActionContract | undefined,targetCommand:Command,resolvedPath:string,allOptions:HelpOptionSummary[],extensionDescriptors?:ReadonlyMap<string,ExtensionCommandHelpDescriptor>,includeAll?:boolean):PositionalActionHelpProjection;
 /** Build structured help for the requested command path, including canonical metadata, flags, aliases, and examples. */
-declare function buildJsonHelpPayload(rootProgram: Command, targetCommand: Command, argv: string[], requestedPath: string[], extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>): Record<string, unknown>;
+declare function buildJsonHelpPayload(rootProgram:Command,targetCommand:Command,argv:string[],requestedPath:string[],extensionDescriptors:ReadonlyMap<string,ExtensionCommandHelpDescriptor>):Record<string,unknown>;
 /** Implements maybe render bootstrap json help for the public runtime surface of this module. */
-export declare function maybeRenderBootstrapJsonHelp(rootProgram: Command, argv: string[], extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>, requestedArgv?: string[]): Promise<boolean>;
-declare function buildCreateUpdatePolicyHelpText(commandName: "create" | "update", typeRegistry: ReturnType<typeof resolveItemTypeRegistry>, argv: string[]): string;
+export declare function maybeRenderBootstrapJsonHelp(rootProgram:Command,argv:string[],extensionDescriptors:ReadonlyMap<string,ExtensionCommandHelpDescriptor>,requestedArgv?:string[]):Promise<boolean>;
+declare function buildCreateUpdatePolicyHelpText(commandName:"create" | "update",typeRegistry:ReturnType<typeof resolveItemTypeRegistry>,argv:string[]):string;
 /** Implements attach create update policy help text for the public runtime surface of this module. */
-export declare function attachCreateUpdatePolicyHelpText(rootProgram: Command, typeRegistry: ReturnType<typeof resolveItemTypeRegistry>, argv: string[]): void;
+export declare function attachCreateUpdatePolicyHelpText(rootProgram:Command,typeRegistry:ReturnType<typeof resolveItemTypeRegistry>,argv:string[]):void;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-attachCreateUpdatePolicyHelpText: typeof attachCreateUpdatePolicyHelpText;
-buildCreateUpdatePolicyHelpText: typeof buildCreateUpdatePolicyHelpText;
-buildJsonHelpPayload: typeof buildJsonHelpPayload;
-buildPositionalActionHelpProjection: typeof buildPositionalActionHelpProjection;
-buildHelpArgumentSummaries: typeof buildHelpArgumentSummaries;
-buildHelpOptionSummaries: typeof buildHelpOptionSummaries;
-buildHelpSubcommandSummaries: typeof buildHelpSubcommandSummaries;
-buildOptionAliasMap: typeof buildOptionAliasMap;
-compactHelpOptionAliases: typeof compactHelpOptionAliases;
-readOptionAttributeName: typeof readOptionAttributeName;
-resolveCommandFromPathTokens: typeof resolveCommandFromPathTokens;
-resolveExtensionCommandSurface: typeof resolveExtensionCommandSurface;
+export declare const _testOnly:{
+attachCreateUpdatePolicyHelpText:typeof attachCreateUpdatePolicyHelpText;
+buildCreateUpdatePolicyHelpText:typeof buildCreateUpdatePolicyHelpText;
+buildJsonHelpPayload:typeof buildJsonHelpPayload;
+buildPositionalActionHelpProjection:typeof buildPositionalActionHelpProjection;
+buildHelpArgumentSummaries:typeof buildHelpArgumentSummaries;
+buildHelpOptionSummaries:typeof buildHelpOptionSummaries;
+buildHelpSubcommandSummaries:typeof buildHelpSubcommandSummaries;
+buildOptionAliasMap:typeof buildOptionAliasMap;
+compactHelpOptionAliases:typeof compactHelpOptionAliases;
+readOptionAttributeName:typeof readOptionAttributeName;
+resolveCommandFromPathTokens:typeof resolveCommandFromPathTokens;
+resolveExtensionCommandSurface:typeof resolveExtensionCommandSurface;
 };
 export {};

package/dist/cli/invocation-profile.d.ts

@@ -8,13 +8,13 @@ import type { Writable } from "node:stream";
 /** Minimal process boundary, also usable by embedded executable hosts. */
 interface InvocationProfileHost {
 /** Register a callback after pending event-loop work and output drain. */
-once(event: "beforeExit", listener: () => void): unknown;
+once(event:"beforeExit",listener:() => void):unknown;
 /** Remove an unconsumed callback when an embedding host disposes it. */
-off(event: "beforeExit", listener: () => void): unknown;
+off(event:"beforeExit",listener:() => void):unknown;
 /** Monotonic seconds since runtime startup, including module initialization. */
-uptime(): number;
+uptime():number;
 /** Diagnostic destination; command output remains on stdout. */
-stderr: Pick<Writable, "write">;
+stderr:Pick<Writable,"write">;
 }
 /**
  * Emit exactly one total when the process drains, even for help or refusals.
@@ -22,5 +22,5 @@ stderr: Pick<Writable, "write">;
  * command records retain their shape; the receipt explicitly names their scope.
  * Return a disposer for hosts that reuse the process instead of exiting.
  */
-export declare function registerInvocationProfile(argv: readonly string[], host?: InvocationProfileHost): () => void;
+export declare function registerInvocationProfile(argv:readonly string[],host?:InvocationProfileHost):() => void;
 export {};