@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/cli-contracts/command-exit-contracts.d.ts

@@ -4,83 +4,83 @@ export type PmCommandExitCode = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
 export type PmCommandExitOutcome = "effect" | "internal_failure" | "refused_input" | "refused_tracker_state" | "conflict" | "dependency_failed" | "no_effect" | "partial_effect";
 /** Meaning and success semantics for one stable process exit. */
 export interface PmCommandExitOutcomeContract {
-    /** Stable process exit visible without parsing stdout. */
-    exit_code: PmCommandExitCode;
-    /** Effect-oriented result independent of implementation details. */
-    outcome: PmCommandExitOutcome;
-    /** Whether the command completed its requested control flow successfully. */
-    success: boolean;
-    /** Concise operator-facing meaning. */
-    meaning: string;
+/** Stable process exit visible without parsing stdout. */
+exit_code: PmCommandExitCode;
+/** Effect-oriented result independent of implementation details. */
+outcome: PmCommandExitOutcome;
+/** Whether the command completed its requested control flow successfully. */
+success: boolean;
+/** Concise operator-facing meaning. */
+meaning: string;
 }
 /** Declared numeric exits for one core command path. */
 export interface PmCommandExitContract {
-    /** Normalized command path. */
-    command: string;
-    /** Exhaustive exits the command may emit. */
-    exit_codes: readonly PmCommandExitCode[];
+/** Normalized command path. */
+command: string;
+/** Exhaustive exits the command may emit. */
+exit_codes: readonly PmCommandExitCode[];
 }
 /** One replay observation used to verify command exit declarations. */
 export interface PmCommandExitObservation {
-    /** Command path executed by the replay. */
-    command: string;
-    /** Process exit observed from the real command boundary. */
-    exit_code: number;
-    /** Stable replay case identifier for diagnostics. */
-    replay_id: string;
+/** Command path executed by the replay. */
+command: string;
+/** Process exit observed from the real command boundary. */
+exit_code: number;
+/** Stable replay case identifier for diagnostics. */
+replay_id: string;
 }
 /** Drift report produced by exit-contract replay conformance. */
 export interface PmCommandExitConformanceReport {
-    /** Whether all declaration and observation checks passed. */
-    ok: boolean;
-    /** Expected commands without a declaration. */
-    missing_commands: string[];
-    /** Observations whose command or numeric exit is undeclared. */
-    undeclared_observations: PmCommandExitObservation[];
-    /** Declared numeric outcomes not reached anywhere in the replay corpus. */
-    unreachable_exit_codes: PmCommandExitCode[];
+/** Whether all declaration and observation checks passed. */
+ok: boolean;
+/** Expected commands without a declaration. */
+missing_commands: string[];
+/** Observations whose command or numeric exit is undeclared. */
+undeclared_observations: PmCommandExitObservation[];
+/** Declared numeric outcomes not reached anywhere in the replay corpus. */
+unreachable_exit_codes: PmCommandExitCode[];
 }
 /** Canonical effect vocabulary for all stable CLI process exits. */
 export declare const PM_COMMAND_EXIT_OUTCOME_CONTRACTS: readonly [{
-    readonly exit_code: 0;
-    readonly outcome: "effect";
-    readonly success: true;
-    readonly meaning: "The requested operation completed with its intended effect.";
+readonly exit_code: 0;
+readonly outcome: "effect";
+readonly success: true;
+readonly meaning: "The requested operation completed with its intended effect.";
 }, {
-    readonly exit_code: 1;
-    readonly outcome: "internal_failure";
-    readonly success: false;
-    readonly meaning: "An unexpected runtime or internal failure prevented completion.";
+readonly exit_code: 1;
+readonly outcome: "internal_failure";
+readonly success: false;
+readonly meaning: "An unexpected runtime or internal failure prevented completion.";
 }, {
-    readonly exit_code: 2;
-    readonly outcome: "refused_input";
-    readonly success: false;
-    readonly meaning: "The invocation was refused because its input or composition was invalid.";
+readonly exit_code: 2;
+readonly outcome: "refused_input";
+readonly success: false;
+readonly meaning: "The invocation was refused because its input or composition was invalid.";
 }, {
-    readonly exit_code: 3;
-    readonly outcome: "refused_tracker_state";
-    readonly success: false;
-    readonly meaning: "The requested tracker, item, or resource was not present.";
+readonly exit_code: 3;
+readonly outcome: "refused_tracker_state";
+readonly success: false;
+readonly meaning: "The requested tracker, item, or resource was not present.";
 }, {
-    readonly exit_code: 4;
-    readonly outcome: "conflict";
-    readonly success: false;
-    readonly meaning: "Current state or concurrency prevented the requested effect.";
+readonly exit_code: 4;
+readonly outcome: "conflict";
+readonly success: false;
+readonly meaning: "Current state or concurrency prevented the requested effect.";
 }, {
-    readonly exit_code: 5;
-    readonly outcome: "dependency_failed";
-    readonly success: false;
-    readonly meaning: "A required dependency operation failed.";
+readonly exit_code: 5;
+readonly outcome: "dependency_failed";
+readonly success: false;
+readonly meaning: "A required dependency operation failed.";
 }, {
-    readonly exit_code: 6;
-    readonly outcome: "no_effect";
-    readonly success: true;
-    readonly meaning: "The request was valid and completed, but matched nothing to change.";
+readonly exit_code: 6;
+readonly outcome: "no_effect";
+readonly success: true;
+readonly meaning: "The request was valid and completed, but matched nothing to change.";
 }, {
-    readonly exit_code: 7;
-    readonly outcome: "partial_effect";
-    readonly success: true;
-    readonly meaning: "The request completed and changed some, but not all, selected targets.";
+readonly exit_code: 7;
+readonly outcome: "partial_effect";
+readonly success: true;
+readonly meaning: "The request completed and changed some, but not all, selected targets.";
 }];
 /** Exhaustive core command exit declarations generated from the command registry. */
 export declare const PM_COMMAND_EXIT_CONTRACTS: readonly PmCommandExitContract[];
@@ -90,21 +90,21 @@ export declare const PM_SUCCESS_EXIT_CODES: readonly [0, 6, 7];
 export type PmCommandEffect = "effect" | "no_effect" | "partial_effect" | "dependency_failed";
 /** Shell and envelope representation of one command effect or collected failure. */
 export interface PmCommandEffectReceipt {
-    /** Semantic effect observed after command execution. */
-    outcome: PmCommandEffect;
-    /** Stable shell exit paired with the effect. */
-    exit_code: 0 | 5 | 6 | 7;
+/** Semantic effect observed after command execution. */
+outcome: PmCommandEffect;
+/** Stable shell exit paired with the effect. */
+exit_code: 0 | 5 | 6 | 7;
 }
 /** Counts used to derive one bulk mutation's effect without parsing prose. */
 export interface PmBulkMutationEffectCounts {
-    /** Rows that completed the requested mutation. */
-    applied: number;
-    /** Rows deliberately left unchanged. */
-    skipped: number;
-    /** Rows whose attempted mutation failed. */
-    failed: number;
-    /** Explicit requested identifiers that did not exist. */
-    unmatched: number;
+/** Rows that completed the requested mutation. */
+applied: number;
+/** Rows deliberately left unchanged. */
+skipped: number;
+/** Rows whose attempted mutation failed. */
+failed: number;
+/** Explicit requested identifiers that did not exist. */
+unmatched: number;
 }
 /** Return whether an exit represents a successful command outcome. */
 export declare function isPmSuccessfulExitCode(exitCode: number): boolean;

package/dist/sdk/cli-contracts/commander-types.d.ts

@@ -5,26 +5,26 @@
  */
 /** Describes aliases accepted by Commander option registration contracts. */
 export interface CommanderOptionAliasContract {
-    /** Canonical SDK option key receiving the selected alias value. */
-    target: string;
-    /** Commander option keys in precedence order; the first matching value wins. */
-    keys: readonly string[];
+/** Canonical SDK option key receiving the selected alias value. */
+target: string;
+/** Commander option keys in precedence order; the first matching value wins. */
+keys: readonly string[];
 }
 /** Declares Commander registration syntax and how its parsed values map to SDK options. */
 export interface CommanderOptionRegistrationContract extends CommanderOptionAliasContract {
-    /** Commander flag syntax, including short aliases and argument placeholders. */
-    option: string;
-    /** Human-readable flag help displayed by Commander. */
-    description: string;
-    /** Whether Commander requires this option to be supplied. */
-    required?: boolean;
-    /** Whether repeated occurrences accumulate values instead of replacing the previous value. */
-    repeatable?: boolean;
-    /** Inputs that customize the alias operation. */
-    aliasOptions?: Array<{
-        option: string;
-        description: string;
-    }>;
+/** Commander flag syntax, including short aliases and argument placeholders. */
+option: string;
+/** Human-readable flag help displayed by Commander. */
+description: string;
+/** Whether Commander requires this option to be supplied. */
+required?: boolean;
+/** Whether repeated occurrences accumulate values instead of replacing the previous value. */
+repeatable?: boolean;
+/** Inputs that customize the alias operation. */
+aliasOptions?: Array<{
+option: string;
+description: string;
+}>;
 }
 /** Public contract for list commander string option contracts, shared by SDK and presentation-layer consumers. */
 export declare const LIST_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];

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

@@ -12,38 +12,38 @@ import { type CliFlagContract } from "./flag-contracts.js";
 export type SdkCliParameterDisposition = "shared" | "compatibility_alias" | "cli_transport" | "cli_presentation" | "cli_adapter" | "cli_scope_selector" | "sdk_transport" | "cli_positional" | "sdk_native" | "unclassified";
 /** One directional input in the SDK/CLI parameter-coverage matrix. */
 export interface SdkCliParameterCoverageEntry {
-    /** Surface where the input is declared. */
-    surface: "cli" | "sdk";
-    /** CLI flag or SDK parameter name. */
-    input: string;
-    /** Equivalent input on the other surface when one exists. */
-    counterpart?: string;
-    /** Machine-readable coverage or waiver classification. */
-    disposition: SdkCliParameterDisposition;
-    /** Stable explanation suitable for a contract report or CI failure. */
-    reason: string;
+/** Surface where the input is declared. */
+surface: "cli" | "sdk";
+/** CLI flag or SDK parameter name. */
+input: string;
+/** Equivalent input on the other surface when one exists. */
+counterpart?: string;
+/** Machine-readable coverage or waiver classification. */
+disposition: SdkCliParameterDisposition;
+/** Stable explanation suitable for a contract report or CI failure. */
+reason: string;
 }
 /** Complete bidirectional parameter coverage for one public action. */
 export interface SdkCliActionParameterCoverage {
-    /** Public SDK action. */
-    action: PmToolAction;
-    /** CLI command path associated with the action. */
-    command: string;
-    /** Every canonical CLI long flag and its disposition. */
-    cli: SdkCliParameterCoverageEntry[];
-    /** Every strict SDK action parameter and its disposition. */
-    sdk: SdkCliParameterCoverageEntry[];
-    /** Inputs lacking an approved bidirectional disposition. */
-    unclassified: SdkCliParameterCoverageEntry[];
+/** Public SDK action. */
+action: PmToolAction;
+/** CLI command path associated with the action. */
+command: string;
+/** Every canonical CLI long flag and its disposition. */
+cli: SdkCliParameterCoverageEntry[];
+/** Every strict SDK action parameter and its disposition. */
+sdk: SdkCliParameterCoverageEntry[];
+/** Inputs lacking an approved bidirectional disposition. */
+unclassified: SdkCliParameterCoverageEntry[];
 }
 /** Injectable contract readers used by negative controls and downstream gates. */
 export interface SdkCliCompletenessContractSource {
-    /** Actions to analyze. */
-    actions?: readonly PmToolAction[];
-    /** Resolve long-flag contracts for a CLI command path. */
-    resolveFlags?: (command: string) => CliFlagContract[];
-    /** Resolve strict SDK parameters for an action. */
-    resolveParameters?: (action: PmToolAction) => string[] | undefined;
+/** Actions to analyze. */
+actions?: readonly PmToolAction[];
+/** Resolve long-flag contracts for a CLI command path. */
+resolveFlags?: (command: string) => CliFlagContract[];
+/** Resolve strict SDK parameters for an action. */
+resolveParameters?: (action: PmToolAction) => string[] | undefined;
 }
 /**
  * Analyze every public action from live CLI and strict schema contracts.

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

@@ -41,8 +41,8 @@ export declare const PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS: readonly ["upgrade"];
 export declare const PM_ITEM_ACTION_SUBCOMMANDS: readonly ["reopen"];
 /** CLI-only presentation commands intentionally omitted from programmatic actions. */
 export declare const PM_CLI_ONLY_TOOL_ACTION_WAIVERS: {
-    readonly help: "Commander help rendering has no SDK operation result.";
-    readonly packages: "The plural package alias only renders package-oriented help.";
+readonly help: "Commander help rendering has no SDK operation result.";
+readonly packages: "The plural package alias only renders package-oriented help.";
 };
 type PmCoreCommandName = (typeof PM_CORE_COMMAND_NAMES)[number];
 type PmCliOnlyToolAction = keyof typeof PM_CLI_ONLY_TOOL_ACTION_WAIVERS;
@@ -62,9 +62,9 @@ export declare const PM_DEPRECATED_TOOL_ACTIONS: readonly PmToolAction[];
 export declare const PM_DISCOVERABLE_TOOL_ACTIONS: readonly PmToolAction[];
 /** Static CLI-to-tool action parity evidence used by quality gates and tests. */
 export declare function analyzePmToolActionParity(cliCommands?: readonly string[], toolActions?: readonly string[], waivers?: Readonly<Record<string, string>>): {
-    missing_cli_actions: string[];
-    waived_cli_actions: string[];
-    stale_waivers: string[];
+missing_cli_actions: string[];
+waived_cli_actions: string[];
+stale_waivers: string[];
 };
 /** Implements check whether pm tool action for the public runtime surface of this module. */
 export declare function isPmToolAction(value: string): value is PmToolAction;

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

@@ -1,41 +1,41 @@
 import { type PmPositionalActionContract } from "./grammar-contracts.js";
 /** A single CLI flag's contract: its canonical `--flag`, optional short form, aliases, value metadata, and repeat/list semantics. One source of truth shared by Commander registration, argv normalization, shell completion, and the `pm contracts` command so every surface agrees on the flag vocabulary. */
 export interface CliFlagContract {
-    /** Value that configures or reports flag for this contract. */
-    flag: string;
-    /** Value that configures or reports short for this contract. */
-    short?: string;
-    /** Value that configures or reports aliases for this contract. */
-    aliases?: string[];
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports required for this contract. */
-    required?: boolean;
-    /** Value that configures or reports repeatable for this contract. */
-    repeatable?: boolean;
-    /** Comma-separated multi-value flag whose repeated occurrences should accumulate (e.g. `--tag a --tag b` ≡ `--tags a,b`). Argv normalization coalesces repeats of these into one comma-joined token to avoid scalar keep-last data loss in Commander. */
-    list?: boolean;
-    /** Value that configures or reports value name for this contract. */
-    value_name?: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    value_type?: "string" | "number" | "boolean";
-    /** Marks a presentation-only flag that may change paging or rendering without invalidating continuation. Omission means the flag is query-semantic. */
-    cursor_semantics?: "presentation";
-    /** Host reservation boundary: inherited flags are forbidden on extensions; root-only flags may have command-local meanings. */
-    reservation_scope?: "inherited" | "root_only";
+/** Value that configures or reports flag for this contract. */
+flag: string;
+/** Value that configures or reports short for this contract. */
+short?: string;
+/** Value that configures or reports aliases for this contract. */
+aliases?: string[];
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports required for this contract. */
+required?: boolean;
+/** Value that configures or reports repeatable for this contract. */
+repeatable?: boolean;
+/** Comma-separated multi-value flag whose repeated occurrences should accumulate (e.g. `--tag a --tag b` ≡ `--tags a,b`). Argv normalization coalesces repeats of these into one comma-joined token to avoid scalar keep-last data loss in Commander. */
+list?: boolean;
+/** Value that configures or reports value name for this contract. */
+value_name?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+value_type?: "string" | "number" | "boolean";
+/** Marks a presentation-only flag that may change paging or rendering without invalidating continuation. Omission means the flag is query-semantic. */
+cursor_semantics?: "presentation";
+/** Host reservation boundary: inherited flags are forbidden on extensions; root-only flags may have command-local meanings. */
+reservation_scope?: "inherited" | "root_only";
 }
 /** Maps an MCP tool option `param` to the CLI `flag` it forwards to, plus the value semantics (`allowEmpty`, `repeatable`, `booleanish`) the bridge needs to translate a structured tool call into argv. */
 export interface ToolOptionFlagContract {
-    /** Value that configures or reports param for this contract. */
-    param: string;
-    /** Value that configures or reports flag for this contract. */
-    flag: string;
-    /** Value that configures or reports allow empty for this contract. */
-    allowEmpty?: boolean;
-    /** Value that configures or reports repeatable for this contract. */
-    repeatable?: boolean;
-    /** Value that configures or reports booleanish for this contract. */
-    booleanish?: boolean;
+/** Value that configures or reports param for this contract. */
+param: string;
+/** Value that configures or reports flag for this contract. */
+flag: string;
+/** Value that configures or reports allow empty for this contract. */
+allowEmpty?: boolean;
+/** Value that configures or reports repeatable for this contract. */
+repeatable?: boolean;
+/** Value that configures or reports booleanish for this contract. */
+booleanish?: boolean;
 }
 /** Returns the flag contracts with their `aliases` populated by folding every dash/underscore spelling of a flag into its canonical `--kebab-case` entry, so a single contract row advertises all accepted spellings. */
 export declare function withFlagAliasMetadata(flagContracts: CliFlagContract[]): CliFlagContract[];