@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/author-attribution.d.ts

@@ -2,33 +2,33 @@
 export declare const HISTORY_AUTHOR_ATTRIBUTION_BASELINE = "2026-07-15T06:22:12.276Z";
 /** Identifies one history event whose mutation author is absent or explicitly unknown. */
 export interface UnknownAuthorHistoryEvent {
-    /** Item whose history stream contains the event. */
-    item_id: string;
-    /** One-based JSONL line number. */
-    line: number;
+/** Item whose history stream contains the event. */
+item_id: string;
+/** One-based JSONL line number. */
+line: number;
 }
 /** Summarizes mutation-author provenance across all readable tracker history streams. */
 export interface HistoryAuthorAttributionScan {
-    /** Number of readable history streams inspected. */
-    checked_streams: number;
-    /** Number of non-empty history events inspected. */
-    checked_events: number;
-    /** Number of events without attributable authorship. */
-    unknown_event_count: number;
-    /** Immutable pre-baseline events retained as historical information. */
-    legacy_unknown_event_count: number;
-    /** Timestamped post-baseline events that require author-attribution fixes. */
-    actionable_unknown_event_count: number;
-    /** Post-baseline unknown events dispositioned by an append-only review event. */
-    acknowledged_actionable_event_count: number;
-    /** Stable, sorted item ids containing unknown-author events. */
-    affected_item_ids: string[];
-    /** Bounded examples suitable for diagnostic output. */
-    samples: UnknownAuthorHistoryEvent[];
-    /** Whether additional undispositioned unknown-author examples were omitted. */
-    samples_truncated: boolean;
-    /** Complete actionable coordinates when explicitly requested by a trusted caller. */
-    actionable_events?: UnknownAuthorHistoryEvent[];
+/** Number of readable history streams inspected. */
+checked_streams: number;
+/** Number of non-empty history events inspected. */
+checked_events: number;
+/** Number of events without attributable authorship. */
+unknown_event_count: number;
+/** Immutable pre-baseline events retained as historical information. */
+legacy_unknown_event_count: number;
+/** Timestamped post-baseline events that require author-attribution fixes. */
+actionable_unknown_event_count: number;
+/** Post-baseline unknown events dispositioned by an append-only review event. */
+acknowledged_actionable_event_count: number;
+/** Stable, sorted item ids containing unknown-author events. */
+affected_item_ids: string[];
+/** Bounded examples suitable for diagnostic output. */
+samples: UnknownAuthorHistoryEvent[];
+/** Whether additional undispositioned unknown-author examples were omitted. */
+samples_truncated: boolean;
+/** Complete actionable coordinates when explicitly requested by a trusted caller. */
+actionable_events?: UnknownAuthorHistoryEvent[];
 }
 /** Classifies one parsed history event by author provenance and baseline age. */
 export declare const classifyHistoryAuthorEvent: (parsed: unknown) => "attributed" | "legacy_unknown" | "actionable_unknown";
@@ -41,72 +41,72 @@ export declare const inspectHistoryAuthorStream: (itemId: string, raw: string, s
 export declare const scanHistoryAuthorAttribution: (pmRoot: string, sampleLimit?: number, includeActionableEvents?: boolean) => Promise<HistoryAuthorAttributionScan>;
 /** Parameters for append-only disposition of immutable unknown-author events. */
 export interface AcknowledgeUnknownAuthorEventsOptions {
-    /** Events identified by item id and one-based history line. */
-    events?: UnknownAuthorHistoryEvent[];
-    /** Select every currently actionable, undispositioned event in the tracker. */
-    all_actionable?: boolean;
-    /** Principal attributed by maintainer review. */
-    attributed_author?: string;
-    /** Reviewer appending the disposition event. */
-    reviewer?: string;
-    /** Evidence-backed rationale for the attribution. */
-    reason?: string;
-    /** Resolve and return the selected plan without appending history. */
-    dry_run?: boolean;
-    /** Fingerprint from the exact preview plan being applied. */
-    plan_fingerprint?: string;
-    /** Maximum coordinate rows included in the returned plan. */
-    coordinate_limit?: number;
+/** Events identified by item id and one-based history line. */
+events?: UnknownAuthorHistoryEvent[];
+/** Select every currently actionable, undispositioned event in the tracker. */
+all_actionable?: boolean;
+/** Principal attributed by maintainer review. */
+attributed_author?: string;
+/** Reviewer appending the disposition event. */
+reviewer?: string;
+/** Evidence-backed rationale for the attribution. */
+reason?: string;
+/** Resolve and return the selected plan without appending history. */
+dry_run?: boolean;
+/** Fingerprint from the exact preview plan being applied. */
+plan_fingerprint?: string;
+/** Maximum coordinate rows included in the returned plan. */
+coordinate_limit?: number;
 }
 /** One source-bound coordinate in an author-acknowledgement plan. */
 export interface UnknownAuthorAcknowledgmentPlanCoordinate extends UnknownAuthorHistoryEvent {
-    /** SHA-256 of the exact immutable JSONL source line. */
-    source_event_hash: string;
-    /** Whether the row is undispositioned or an explicit apply would supersede it. */
-    disposition: "actionable" | "already_acknowledged";
+/** SHA-256 of the exact immutable JSONL source line. */
+source_event_hash: string;
+/** Whether the row is undispositioned or an explicit apply would supersede it. */
+disposition: "actionable" | "already_acknowledged";
 }
 /** Deterministic preview shared by CLI, SDK, and MCP apply paths. */
 export interface UnknownAuthorAcknowledgmentPlan {
-    /** Selector family resolved by the plan. */
-    selection: {
-        kind: "events" | "all_actionable";
-    };
-    /** Complete number of unique selected coordinates. */
-    selected_count: number;
-    /** Selected coordinates not covered by an earlier disposition. */
-    actionable_count: number;
-    /** Coordinates an explicit-events apply would supersede. */
-    already_acknowledged_count: number;
-    /** Coordinate rows omitted only from this bounded preview. */
-    omitted_count: number;
-    /** Stable ordered prefix of the complete selected set. */
-    coordinates: UnknownAuthorAcknowledgmentPlanCoordinate[];
-    /** SHA-256 over selection kind and every complete source-bound coordinate. */
-    plan_fingerprint: string;
+/** Selector family resolved by the plan. */
+selection: {
+kind: "events" | "all_actionable";
+};
+/** Complete number of unique selected coordinates. */
+selected_count: number;
+/** Selected coordinates not covered by an earlier disposition. */
+actionable_count: number;
+/** Coordinates an explicit-events apply would supersede. */
+already_acknowledged_count: number;
+/** Coordinate rows omitted only from this bounded preview. */
+omitted_count: number;
+/** Stable ordered prefix of the complete selected set. */
+coordinates: UnknownAuthorAcknowledgmentPlanCoordinate[];
+/** SHA-256 over selection kind and every complete source-bound coordinate. */
+plan_fingerprint: string;
 }
 /** Structured preview or apply result for immutable author acknowledgement. */
 export interface UnknownAuthorAcknowledgmentResult {
-    /** Whether this invocation was a read-only preview. */
-    dry_run: boolean;
-    /** Whether an append-only workspace event was written. */
-    mutated: boolean;
-    /** Number of coordinates written to the appended disposition. */
-    acknowledged: number;
-    /** Effect-aware command outcome. */
-    outcome: "preview" | "effect" | "no_effect" | "partial_effect";
-    /** Stable shell and transport exit paired with the outcome. */
-    exit_code: 0 | 6 | 7;
-    /** Exact plan used for preview or apply. */
-    plan: UnknownAuthorAcknowledgmentPlan;
-    /** Appended workspace history path when mutation occurred. */
-    history_path?: string;
+/** Whether this invocation was a read-only preview. */
+dry_run: boolean;
+/** Whether an append-only workspace event was written. */
+mutated: boolean;
+/** Number of coordinates written to the appended disposition. */
+acknowledged: number;
+/** Effect-aware command outcome. */
+outcome: "preview" | "effect" | "no_effect" | "partial_effect";
+/** Stable shell and transport exit paired with the outcome. */
+exit_code: 0 | 6 | 7;
+/** Exact plan used for preview or apply. */
+plan: UnknownAuthorAcknowledgmentPlan;
+/** Appended workspace history path when mutation occurred. */
+history_path?: string;
 }
 /** Resolve a deterministic, source-bound author-acknowledgement preview. */
 export declare function planUnknownAuthorHistoryAcknowledgment(pmRoot: string, selector: Pick<AcknowledgeUnknownAuthorEventsOptions, "events" | "all_actionable">, coordinateLimit?: number): Promise<UnknownAuthorAcknowledgmentPlan>;
 /** Resolve the mutually exclusive CLI and SDK acknowledgment selectors. */
 export declare function resolveUnknownAuthorAcknowledgmentSelector(rawEvents: readonly string[], allActionable: boolean): {
-    events: UnknownAuthorHistoryEvent[];
-    all_actionable: boolean;
+events: UnknownAuthorHistoryEvent[];
+all_actionable: boolean;
 };
 /** Parse user-facing item or workspace history coordinates into SDK events. */
 export declare function parseUnknownAuthorHistoryEventCoordinates(values: readonly string[]): UnknownAuthorHistoryEvent[];

package/dist/sdk/authoring.d.ts

@@ -15,4 +15,4 @@ export { planProfileApplication, type ProfileApplicationPlan, type ProfileChange
 export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, type CollectUsedExtensionCapabilitiesOptions, type ExtensionCapabilityUsageReconciliation, } from "../core/extensions/capability-usage.js";
 export { renderExtensionSurfaceMarkdown, type ExtensionSurfaceMarkdownOptions, } from "../core/extensions/activation-summary-markdown.js";
 export { createExtensionContributionInventory, normalizeExtensionContributionInventory, } from "../core/extensions/contribution-inventory.js";
-export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, BeforeMutationHook, BeforeMutationHookContext, BeforeMutationHookDecision, CommandDefinition, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandHandlerResult, ExtensionCommandSdk, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExporterArtifactOutputContract, ExporterRegistrationOptions, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionContributionInventory, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionMutationGuardSdk, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExporterArtifactOutputContract, RegisteredExtensionFlagDefinitions, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionProjectProfile, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, ServiceOverrideDecision, ServiceOverrideOwnership, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";
+export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, BeforeMutationHook, BeforeMutationHookContext, BeforeMutationHookDecision, CommandDefinition, ExtensionCommandReadOutput, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandHandlerResult, ExtensionCommandSdk, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExporterArtifactOutputContract, ExporterRegistrationOptions, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionContributionInventory, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionMutationGuardSdk, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExporterArtifactOutputContract, RegisteredExtensionFlagDefinitions, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionProjectProfile, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, ServiceOverrideDecision, ServiceOverrideOwnership, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";

package/dist/sdk/authoring.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="af4da99c-f557-5bf7-a439-c14878e4970d")}catch{}})();export*from"./compose.js";export*from"./define.js";export*from"./extension-contracts.js";import{RESERVED_ITEM_FIELD_NAMES}from"../core/extensions/item-fields.js";import{PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,PM_PACKAGE_RESOURCE_KINDS,collectPackageExtensionDirectories,readPmPackageManifest}from"../core/packages/manifest.js";import{BUILTIN_PROFILES,listProfiles,normalizeProfileName,PROFILE_NAMES,resolveProfile}from"../core/profile/profile-presets.js";import{describeProfileComposition,describeProjectProfile}from"../core/profile/profile-describe.js";import{lintProjectProfile,PROFILE_LINT_CODES,PROFILE_LINT_DIMENSIONS}from"../core/profile/profile-lint.js";import{planProfileApplication}from"../core/profile/profile-plan.js";import{EXTENSION_CAPABILITY_REGISTRATION_SURFACES,collectUsedExtensionCapabilities,reconcileExtensionCapabilityUsage}from"../core/extensions/capability-usage.js";import{renderExtensionSurfaceMarkdown}from"../core/extensions/activation-summary-markdown.js";import{createExtensionContributionInventory,normalizeExtensionContributionInventory}from"../core/extensions/contribution-inventory.js";export{BUILTIN_PROFILES,EXTENSION_CAPABILITY_REGISTRATION_SURFACES,PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,PM_PACKAGE_RESOURCE_KINDS,PROFILE_LINT_CODES,PROFILE_LINT_DIMENSIONS,PROFILE_NAMES,RESERVED_ITEM_FIELD_NAMES,collectPackageExtensionDirectories,collectUsedExtensionCapabilities,createExtensionContributionInventory,describeProfileComposition,describeProjectProfile,lintProjectProfile,listProfiles,normalizeExtensionContributionInventory,normalizeProfileName,planProfileApplication,readPmPackageManifest,reconcileExtensionCapabilityUsage,renderExtensionSurfaceMarkdown,resolveProfile};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d0b86c6a-67f0-52f2-90b8-d1058e8f2284")}catch{}})();export*from"./compose.js";export*from"./define.js";export*from"./extension-contracts.js";import{RESERVED_ITEM_FIELD_NAMES}from"../core/extensions/item-fields.js";import{PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,PM_PACKAGE_RESOURCE_KINDS,collectPackageExtensionDirectories,readPmPackageManifest}from"../core/packages/manifest.js";import{BUILTIN_PROFILES,listProfiles,normalizeProfileName,PROFILE_NAMES,resolveProfile}from"../core/profile/profile-presets.js";import{describeProfileComposition,describeProjectProfile}from"../core/profile/profile-describe.js";import{lintProjectProfile,PROFILE_LINT_CODES,PROFILE_LINT_DIMENSIONS}from"../core/profile/profile-lint.js";import{planProfileApplication}from"../core/profile/profile-plan.js";import{EXTENSION_CAPABILITY_REGISTRATION_SURFACES,collectUsedExtensionCapabilities,reconcileExtensionCapabilityUsage}from"../core/extensions/capability-usage.js";import{renderExtensionSurfaceMarkdown}from"../core/extensions/activation-summary-markdown.js";import{createExtensionContributionInventory,normalizeExtensionContributionInventory}from"../core/extensions/contribution-inventory.js";export{BUILTIN_PROFILES,EXTENSION_CAPABILITY_REGISTRATION_SURFACES,PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,PM_PACKAGE_RESOURCE_KINDS,PROFILE_LINT_CODES,PROFILE_LINT_DIMENSIONS,PROFILE_NAMES,RESERVED_ITEM_FIELD_NAMES,collectPackageExtensionDirectories,collectUsedExtensionCapabilities,createExtensionContributionInventory,describeProfileComposition,describeProjectProfile,lintProjectProfile,listProfiles,normalizeExtensionContributionInventory,normalizeProfileName,planProfileApplication,readPmPackageManifest,reconcileExtensionCapabilityUsage,renderExtensionSurfaceMarkdown,resolveProfile};
 //# sourceMappingURL=authoring.js.map

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