@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/sdk/cli-bootstrap.d.ts

@@ -8,38 +8,38 @@ import { type CliFlagContract } from "./cli-contracts/flag-contracts.js";
 export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, type PmCommandAliasContract, type PmCommandAliasLifecycle, type PmCommandAliasRegistration, };
 /** Documents the bootstrap global options payload exchanged by command, SDK, and package integrations. */
 export interface BootstrapGlobalOptions {
-    /** Filesystem path used for path resolution. */
-    path?: string;
-    /** Value that configures or reports no extensions for this contract. */
-    noExtensions: boolean;
-    /** Value that configures or reports no pager for this contract. */
-    noPager: boolean;
-    /** Value that configures or reports json for this contract. */
-    json: boolean;
-    /** Value that configures or reports quiet for this contract. */
-    quiet: boolean;
-    /** Whether compact JSON projection is requested. */
-    lean: boolean;
-    /** Whether output token accounting is requested. */
-    tokenAccounting: boolean;
-    /** Canonical comma-separated fields or sections retained in read output. */
-    outputInclude?: string;
-    /** Canonical maximum row count retained in read output. */
-    outputLimit?: string;
-    /** Canonical estimated-token ceiling for read output. */
-    outputBudget?: string;
-    /** Canonical renderer encoding for read output. */
-    outputFormat?: "toon" | "json";
-    /** Caller-carried cross-call budget and served-item state. */
-    outputSession?: string;
-    /** Opaque budget-compaction continuation cursor. */
-    outputCursor?: string;
-    /** Whether machine-readable row discovery metadata is requested. */
-    outputRowContract?: boolean;
-    /** Invocation-wide mutation author override. */
-    author?: string;
-    /** Whether `--author` was present without its required value. */
-    authorMissingValue?: true;
+/** Filesystem path used for path resolution. */
+path?: string;
+/** Value that configures or reports no extensions for this contract. */
+noExtensions: boolean;
+/** Value that configures or reports no pager for this contract. */
+noPager: boolean;
+/** Value that configures or reports json for this contract. */
+json: boolean;
+/** Value that configures or reports quiet for this contract. */
+quiet: boolean;
+/** Whether compact JSON projection is requested. */
+lean: boolean;
+/** Whether output token accounting is requested. */
+tokenAccounting: boolean;
+/** Canonical comma-separated fields or sections retained in read output. */
+outputInclude?: string;
+/** Canonical maximum row count retained in read output. */
+outputLimit?: string;
+/** Canonical estimated-token ceiling for read output. */
+outputBudget?: string;
+/** Canonical renderer encoding for read output. */
+outputFormat?: "toon" | "json";
+/** Caller-carried cross-call budget and served-item state. */
+outputSession?: string;
+/** Opaque budget-compaction continuation cursor. */
+outputCursor?: string;
+/** Whether machine-readable row discovery metadata is requested. */
+outputRowContract?: boolean;
+/** Invocation-wide mutation author override. */
+author?: string;
+/** Whether `--author` was present without its required value. */
+authorMissingValue?: true;
 }
 /** Implements parse bootstrap global options for the public runtime surface of this module. */
 export declare function parseBootstrapGlobalOptions(argv: string[]): BootstrapGlobalOptions;
@@ -47,10 +47,10 @@ export declare function parseBootstrapGlobalOptions(argv: string[]): BootstrapGl
 export declare function stripGlobalBootstrapTokens(argv: string[]): string[];
 /** Documents the bootstrap help request payload exchanged by command, SDK, and package integrations. */
 export interface BootstrapHelpRequest {
-    /** Value that configures or reports requested for this contract. */
-    requested: boolean;
-    /** Value that configures or reports command path tokens for this contract. */
-    commandPathTokens: string[];
+/** Value that configures or reports requested for this contract. */
+requested: boolean;
+/** Value that configures or reports command path tokens for this contract. */
+commandPathTokens: string[];
 }
 /** Implements parse bootstrap help request for the public runtime surface of this module. */
 export declare function parseBootstrapHelpRequest(argv: string[]): BootstrapHelpRequest;
@@ -66,46 +66,46 @@ type BootstrapNormalizationReason = "executable_alias" | "legacy_extension_actio
 type BootstrapNormalizationConfidence = "high" | "medium";
 /** Documents the bootstrap normalization event payload exchanged by command, SDK, and package integrations. */
 export interface BootstrapNormalizationEvent {
-    /** Value that configures or reports from for this contract. */
-    from: string;
-    /** Value that configures or reports to for this contract. */
-    to: string[];
-    /** Value that configures or reports reason for this contract. */
-    reason: BootstrapNormalizationReason;
-    /** Value that configures or reports confidence for this contract. */
-    confidence: BootstrapNormalizationConfidence;
+/** Value that configures or reports from for this contract. */
+from: string;
+/** Value that configures or reports to for this contract. */
+to: string[];
+/** Value that configures or reports reason for this contract. */
+reason: BootstrapNormalizationReason;
+/** Value that configures or reports confidence for this contract. */
+confidence: BootstrapNormalizationConfidence;
 }
 /** Documents the bootstrap invocation normalization result payload exchanged by command, SDK, and package integrations. */
 export interface BootstrapInvocationNormalizationResult {
-    /** Value that configures or reports argv for this contract. */
-    argv: string[];
-    /** Value that configures or reports command name for this contract. */
-    commandName: string | undefined;
-    /** Value that configures or reports trace for this contract. */
-    trace: BootstrapNormalizationEvent[];
+/** Value that configures or reports argv for this contract. */
+argv: string[];
+/** Value that configures or reports command name for this contract. */
+commandName: string | undefined;
+/** Value that configures or reports trace for this contract. */
+trace: BootstrapNormalizationEvent[];
 }
 interface FlagLookup {
-    canonicalByNormalized: Map<string, string | null>;
-    canonicalByCompact: Map<string, string | null>;
-    canonicalComparables: Array<{
-        canonicalFlag: string;
-        comparable: string;
-    }>;
-    listCanonicalFlags: Set<string>;
+canonicalByNormalized: Map<string, string | null>;
+canonicalByCompact: Map<string, string | null>;
+canonicalComparables: Array<{
+canonicalFlag: string;
+comparable: string;
+}>;
+listCanonicalFlags: Set<string>;
 }
 declare function markUnambiguousFlag(map: Map<string, string | null>, key: string, canonicalFlag: string): void;
 declare function collectLongFlagCandidates(contract: CliFlagContract): string[];
 declare function buildFlagLookup(commandName: string | undefined, contractsOverride?: CliFlagContract[]): FlagLookup;
 declare function resolveCanonicalFlag(rawKey: string, lookup: FlagLookup): {
-    flag: string;
-    reason: "flag_alias" | "flag_typo";
-    confidence: BootstrapNormalizationConfidence;
+flag: string;
+reason: "flag_alias" | "flag_typo";
+confidence: BootstrapNormalizationConfidence;
 } | null;
 /** Implements list alias plural keys for the public runtime surface of this module. */
 export declare function listAliasPluralKeys(normalizedKey: string): string[];
 declare function normalizeLongOptionToken(token: string, lookup: FlagLookup, preserve?: boolean): {
-    tokens: string[];
-    event?: BootstrapNormalizationEvent;
+tokens: string[];
+event?: BootstrapNormalizationEvent;
 };
 /** Locate global path-value tokens that normalization must preserve literally. */
 declare function collectBootstrapPathValueIndices(argv: string[]): Set<number>;
@@ -123,8 +123,8 @@ declare function collectBootstrapPathValueIndices(argv: string[]): Set<number>;
  * nor allowed to swallow the following command/positional token.
  */
 export declare function coalesceRepeatedListFlags(argv: string[], listFlags: Set<string>, valueConsumingFlags?: Set<string>, multiValueListFlags?: Set<string>): {
-    argv: string[];
-    events: BootstrapNormalizationEvent[];
+argv: string[];
+events: BootstrapNormalizationEvent[];
 };
 /** Accept the two-token linked-test form `pm test <id> --add command "npm test -- parser"` by merging the bare key token and its single quoted value into the documented `--add command=...` shape. Without this merge Commander binds the bare key as the option value and treats the quoted command as an excess positional, failing with "too many arguments" (GH-191). The merge only fires when EXACTLY ONE non-flag token follows the bare key, i.e. the value was quoted into one shell token — an unquoted multi-token value stays ambiguous (it may swallow the item id), still fails fast, and is routed to targeted quoting guidance by the commander error classifier instead. */
 export declare function mergeLinkedTestTwoTokenEntries(argv: string[], commandName: string | undefined, trace: BootstrapNormalizationEvent[]): string[];
@@ -138,10 +138,10 @@ export declare function normalizeBootstrapInvocation(argv: string[]): BootstrapI
 export declare function parseBootstrapTypeValue(argv: string[]): string | undefined;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    buildFlagLookup: typeof buildFlagLookup;
-    collectBootstrapPathValueIndices: typeof collectBootstrapPathValueIndices;
-    collectLongFlagCandidates: typeof collectLongFlagCandidates;
-    markUnambiguousFlag: typeof markUnambiguousFlag;
-    normalizeLongOptionToken: typeof normalizeLongOptionToken;
-    resolveCanonicalFlag: typeof resolveCanonicalFlag;
+buildFlagLookup: typeof buildFlagLookup;
+collectBootstrapPathValueIndices: typeof collectBootstrapPathValueIndices;
+collectLongFlagCandidates: typeof collectLongFlagCandidates;
+markUnambiguousFlag: typeof markUnambiguousFlag;
+normalizeLongOptionToken: typeof normalizeLongOptionToken;
+resolveCanonicalFlag: typeof resolveCanonicalFlag;
 };

package/dist/sdk/cli-contracts/agent-output-contracts.d.ts

@@ -16,68 +16,68 @@ export declare const PM_DIAGNOSTIC_DEGRADATION_STEPS: readonly ["full", "omit_ex
 export type PmDiagnosticDegradationStep = (typeof PM_DIAGNOSTIC_DEGRADATION_STEPS)[number];
 /** Declares one diagnostic family's text and JSON token ceilings. */
 export interface PmDiagnosticOutputBudgetContract {
-    /** Diagnostic family governed by this contract. */
-    diagnostic_class: PmDiagnosticOutputClass;
-    /** Default ceiling by rendered transport. */
-    default_max_estimated_tokens_by_format: Readonly<{
-        text: number;
-        json: number;
-    }>;
-    /** Smallest explicit ceiling accepted by the projector. */
-    minimum_max_estimated_tokens: number;
-    /** Ordered degradation policy applied when the ceiling binds. */
-    degradation_ladder: readonly PmDiagnosticDegradationStep[];
-    /** Paths whose first actionable value must survive degradation. */
-    corrective_action_paths: readonly string[];
-    /** Stable estimate used by gates and SDK consumers. */
-    token_estimate: "ceil(utf8_bytes / 4)";
+/** Diagnostic family governed by this contract. */
+diagnostic_class: PmDiagnosticOutputClass;
+/** Default ceiling by rendered transport. */
+default_max_estimated_tokens_by_format: Readonly<{
+text: number;
+json: number;
+}>;
+/** Smallest explicit ceiling accepted by the projector. */
+minimum_max_estimated_tokens: number;
+/** Ordered degradation policy applied when the ceiling binds. */
+degradation_ladder: readonly PmDiagnosticDegradationStep[];
+/** Paths whose first actionable value must survive degradation. */
+corrective_action_paths: readonly string[];
+/** Stable estimate used by gates and SDK consumers. */
+token_estimate: "ceil(utf8_bytes / 4)";
 }
 /** Machine-readable disclosure attached to a projected diagnostic. */
 export interface PmDiagnosticOutputReceipt {
-    /** Diagnostic family whose contract bound the output. */
-    diagnostic_class: PmDiagnosticOutputClass;
-    /** Rendered transport measured by the projector. */
-    format: "json" | "text";
-    /** Effective estimated-token ceiling. */
-    budget: number;
-    /** Whether the caller supplied the ceiling or used the declaration. */
-    budget_source: "default" | "explicit";
-    /** Estimate before diagnostic degradation. */
-    original_estimated_tokens: number;
-    /** Exact estimate of the returned projection. */
-    estimated_tokens: number;
-    /** Whether one or more fields were removed or compacted. */
-    truncated: boolean;
-    /** Applied stages in contract order. */
-    degradation_steps: PmDiagnosticDegradationStep[];
-    /** Top-level fields removed from the original diagnostic. */
-    omitted_fields: string[];
-    /** Additional omitted fields not named individually in a bounded receipt. */
-    omitted_fields_overflow_count?: number;
+/** Diagnostic family whose contract bound the output. */
+diagnostic_class: PmDiagnosticOutputClass;
+/** Rendered transport measured by the projector. */
+format: "json" | "text";
+/** Effective estimated-token ceiling. */
+budget: number;
+/** Whether the caller supplied the ceiling or used the declaration. */
+budget_source: "default" | "explicit";
+/** Estimate before diagnostic degradation. */
+original_estimated_tokens: number;
+/** Exact estimate of the returned projection. */
+estimated_tokens: number;
+/** Whether one or more fields were removed or compacted. */
+truncated: boolean;
+/** Applied stages in contract order. */
+degradation_steps: PmDiagnosticDegradationStep[];
+/** Top-level fields removed from the original diagnostic. */
+omitted_fields: string[];
+/** Additional omitted fields not named individually in a bounded receipt. */
+omitted_fields_overflow_count?: number;
 }
 /** JSON diagnostic after binding it to a declared output contract. */
 export type PmProjectedDiagnostic<TDiagnostic extends object> = Partial<TDiagnostic> & Pick<TDiagnostic, Extract<keyof TDiagnostic, "code" | "required">> & {
-    diagnostic_output?: PmDiagnosticOutputReceipt;
+diagnostic_output?: PmDiagnosticOutputReceipt;
 };
 /** Describes one command's default agent-output budget and degradation policy. */
 export interface PmCommandOutputBudgetContract {
-    /** Canonical or compatibility command name. */
-    command: string;
-    /** Workload class that selected the default ceiling. */
-    budget_class: PmOutputBudgetClass;
-    /** Default estimated-token ceiling for representative output. */
-    default_max_estimated_tokens: number;
-    /** Encoding-specific ceilings generated from the workload-class default. */
-    default_max_estimated_tokens_by_format: Readonly<{
-        toon: number;
-        json: number;
-    }>;
-    /** Ordered fallback projections, from richest to smallest. */
-    degradation_ladder: readonly PmOutputDegradationStep[];
-    /** Whether callers may explicitly request an unbounded result. */
-    allows_unbounded_opt_out: boolean;
-    /** Stable estimate used by gates and SDK consumers. */
-    token_estimate: "ceil(utf8_bytes / 4)";
+/** Canonical or compatibility command name. */
+command: string;
+/** Workload class that selected the default ceiling. */
+budget_class: PmOutputBudgetClass;
+/** Default estimated-token ceiling for representative output. */
+default_max_estimated_tokens: number;
+/** Encoding-specific ceilings generated from the workload-class default. */
+default_max_estimated_tokens_by_format: Readonly<{
+toon: number;
+json: number;
+}>;
+/** Ordered fallback projections, from richest to smallest. */
+degradation_ladder: readonly PmOutputDegradationStep[];
+/** Whether callers may explicitly request an unbounded result. */
+allows_unbounded_opt_out: boolean;
+/** Stable estimate used by gates and SDK consumers. */
+token_estimate: "ceil(utf8_bytes / 4)";
 }
 /** Public default contract for every diagnostic family. */
 export declare const PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS: PmDiagnosticOutputBudgetContract[];
@@ -95,11 +95,11 @@ export declare function definePmCommandOutputBudget<TContract extends PmCommandO
 export declare const PM_COMMAND_OUTPUT_BUDGET_CONTRACTS: PmCommandOutputBudgetContract[];
 /** Resolve the declared output budget for one built-in command. */
 export declare function resolvePmCommandOutputBudget(command: string, options: {
-    generateFallback: true;
+generateFallback: true;
 }): PmCommandOutputBudgetContract;
 /** Resolve a declared output budget without generating a package fallback. */
 export declare function resolvePmCommandOutputBudget(command: string, options?: {
-    generateFallback?: false;
+generateFallback?: false;
 }): PmCommandOutputBudgetContract | null;
 /** Estimate conservative token usage from UTF-8 output bytes. */
 export declare function estimatePmOutputTokens(utf8Bytes: number): number;
@@ -110,18 +110,18 @@ export declare function resolvePmDiagnosticOutputBudget(diagnosticClass: PmDiagn
  * corrective action and reporting every top-level omission.
  */
 export declare function projectPmDiagnosticOutput<TDiagnostic extends object>(diagnostic: TDiagnostic, options?: {
-    diagnosticClass?: PmDiagnosticOutputClass;
-    maxEstimatedTokens?: number;
+diagnosticClass?: PmDiagnosticOutputClass;
+maxEstimatedTokens?: number;
 }): PmProjectedDiagnostic<TDiagnostic>;
 /** Text diagnostic together with the same measured receipt used by JSON. */
 export interface PmProjectedTextDiagnostic {
-    /** Rendered action-first diagnostic. */
-    output: string;
-    /** Binding diagnostic budget receipt. */
-    diagnostic_output: PmDiagnosticOutputReceipt;
+/** Rendered action-first diagnostic. */
+output: string;
+/** Binding diagnostic budget receipt. */
+diagnostic_output: PmDiagnosticOutputReceipt;
 }
 /** Bind human-readable diagnostics while retaining their first identifying line and corrective action. */
 export declare function projectPmDiagnosticText(output: string, correctiveAction: string, options?: {
-    diagnosticClass?: PmDiagnosticOutputClass;
-    maxEstimatedTokens?: number;
+diagnosticClass?: PmDiagnosticOutputClass;
+maxEstimatedTokens?: number;
 }): PmProjectedTextDiagnostic;

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

@@ -11,20 +11,20 @@ export type PmCommandAliasLifecycle = "permanent" | "deprecated";
 export type PmCommandAliasRegistration = "bootstrap" | "commander";
 /** Machine-readable compatibility contract for one executable command alias. */
 export interface PmCommandAliasContract {
-    /** Legacy or ergonomic spelling accepted at the command root. */
-    alias: string;
-    /** Canonical command path agents should discover and generate. */
-    canonical: string;
-    /** Canonical tokens inserted before user-provided options and arguments. */
-    canonical_argv: readonly string[];
-    /** Whether the alias is permanent ergonomics or migration-only compatibility. */
-    lifecycle: PmCommandAliasLifecycle;
-    /** Whether default help and completion discovery omit the alias. */
-    hidden: boolean;
-    /** Runtime layer that keeps the alias executable. */
-    registration: PmCommandAliasRegistration;
-    /** PM item that owns the compatibility disposition. */
-    owner: string;
+/** Legacy or ergonomic spelling accepted at the command root. */
+alias: string;
+/** Canonical command path agents should discover and generate. */
+canonical: string;
+/** Canonical tokens inserted before user-provided options and arguments. */
+canonical_argv: readonly string[];
+/** Whether the alias is permanent ergonomics or migration-only compatibility. */
+lifecycle: PmCommandAliasLifecycle;
+/** Whether default help and completion discovery omit the alias. */
+hidden: boolean;
+/** Runtime layer that keeps the alias executable. */
+registration: PmCommandAliasRegistration;
+/** PM item that owns the compatibility disposition. */
+owner: string;
 }
 /** History namespace aliases preserve the existing SDK and MCP operation identities. */
 export declare const PM_HISTORY_COMMAND_ALIASES: readonly PmCommandAliasContract[];

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[];