@unbrained/pm-cli 2026.10.14 → 2026.10.17

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

@@ -3,117 +3,117 @@ export declare const HISTORY_AUTHOR_ATTRIBUTION_BASELINE = "2026-07-15T06:22:12.
 /** 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;
+item_id:string;
 /** One-based JSONL line number. */
-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;
+checked_streams:number;
 /** Number of non-empty history events inspected. */
-checked_events: number;
+checked_events:number;
 /** Number of events without attributable authorship. */
-unknown_event_count: number;
+unknown_event_count:number;
 /** Immutable pre-baseline events retained as historical information. */
-legacy_unknown_event_count: number;
+legacy_unknown_event_count:number;
 /** Timestamped post-baseline events that require author-attribution fixes. */
-actionable_unknown_event_count: number;
+actionable_unknown_event_count:number;
 /** Post-baseline unknown events dispositioned by an append-only review event. */
-acknowledged_actionable_event_count: number;
+acknowledged_actionable_event_count:number;
 /** Stable, sorted item ids containing unknown-author events. */
-affected_item_ids: string[];
+affected_item_ids:string[];
 /** Bounded examples suitable for diagnostic output. */
-samples: UnknownAuthorHistoryEvent[];
+samples:UnknownAuthorHistoryEvent[];
 /** Whether additional undispositioned unknown-author examples were omitted. */
-samples_truncated: boolean;
+samples_truncated:boolean;
 /** Complete actionable coordinates when explicitly requested by a trusted caller. */
-actionable_events?: UnknownAuthorHistoryEvent[];
+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";
+export declare const classifyHistoryAuthorEvent:(parsed:unknown) => "attributed" | "legacy_unknown" | "actionable_unknown";
 /** Inspect one readable JSONL stream without performing filesystem I/O. */
-export declare const inspectHistoryAuthorStream: (itemId: string, raw: string, sampleLimit?: number, acknowledgedEvents?: ReadonlySet<string>) => Pick<HistoryAuthorAttributionScan, "checked_events" | "unknown_event_count" | "legacy_unknown_event_count" | "actionable_unknown_event_count" | "acknowledged_actionable_event_count" | "samples" | "samples_truncated" | "actionable_events">;
+export declare const inspectHistoryAuthorStream:(itemId:string,raw:string,sampleLimit?:number,acknowledgedEvents?:ReadonlySet<string>) => Pick<HistoryAuthorAttributionScan,"checked_events" | "unknown_event_count" | "legacy_unknown_event_count" | "actionable_unknown_event_count" | "acknowledged_actionable_event_count" | "samples" | "samples_truncated" | "actionable_events">;
 /**
  * Scan append-only tracker history for missing or `unknown` author values.
  * Malformed and unreadable streams are deliberately left to integrity diagnostics.
  */
-export declare const scanHistoryAuthorAttribution: (pmRoot: string, sampleLimit?: number, includeActionableEvents?: boolean) => Promise<HistoryAuthorAttributionScan>;
+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[];
+events?:UnknownAuthorHistoryEvent[];
 /** Select every currently actionable, undispositioned event in the tracker. */
-all_actionable?: boolean;
+all_actionable?:boolean;
 /** Principal attributed by maintainer review. */
-attributed_author?: string;
+attributed_author?:string;
 /** Reviewer appending the disposition event. */
-reviewer?: string;
+reviewer?:string;
 /** Evidence-backed rationale for the attribution. */
-reason?: string;
+reason?:string;
 /** Resolve and return the selected plan without appending history. */
-dry_run?: boolean;
+dry_run?:boolean;
 /** Fingerprint from the exact preview plan being applied. */
-plan_fingerprint?: string;
+plan_fingerprint?:string;
 /** Maximum coordinate rows included in the returned plan. */
-coordinate_limit?: number;
+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;
+source_event_hash:string;
 /** Whether the row is undispositioned or an explicit apply would supersede it. */
-disposition: "actionable" | "already_acknowledged";
+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";
+selection:{
+kind:"events" | "all_actionable";
 };
 /** Complete number of unique selected coordinates. */
-selected_count: number;
+selected_count:number;
 /** Selected coordinates not covered by an earlier disposition. */
-actionable_count: number;
+actionable_count:number;
 /** Coordinates an explicit-events apply would supersede. */
-already_acknowledged_count: number;
+already_acknowledged_count:number;
 /** Coordinate rows omitted only from this bounded preview. */
-omitted_count: number;
+omitted_count:number;
 /** Stable ordered prefix of the complete selected set. */
-coordinates: UnknownAuthorAcknowledgmentPlanCoordinate[];
+coordinates:UnknownAuthorAcknowledgmentPlanCoordinate[];
 /** SHA-256 over selection kind and every complete source-bound coordinate. */
-plan_fingerprint: string;
+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;
+dry_run:boolean;
 /** Whether an append-only workspace event was written. */
-mutated: boolean;
+mutated:boolean;
 /** Number of coordinates written to the appended disposition. */
-acknowledged: number;
+acknowledged:number;
 /** Effect-aware command outcome. */
-outcome: "preview" | "effect" | "no_effect" | "partial_effect";
+outcome:"preview" | "effect" | "no_effect" | "partial_effect";
 /** Stable shell and transport exit paired with the outcome. */
-exit_code: 0 | 6 | 7;
+exit_code:0 | 6 | 7;
 /** Exact plan used for preview or apply. */
-plan: UnknownAuthorAcknowledgmentPlan;
+plan:UnknownAuthorAcknowledgmentPlan;
 /** Appended workspace history path when mutation occurred. */
-history_path?: string;
+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>;
+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;
+export declare function resolveUnknownAuthorAcknowledgmentSelector(rawEvents:readonly string[],allActionable: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[];
+export declare function parseUnknownAuthorHistoryEventCoordinates(values:readonly string[]):UnknownAuthorHistoryEvent[];
 /** Normalize an untyped transport payload and execute author acknowledgment. */
-export declare function acknowledgeUnknownAuthorHistoryEventsFromTransport(pmRoot: string, input: Record<string, unknown>): Promise<UnknownAuthorAcknowledgmentResult>;
+export declare function acknowledgeUnknownAuthorHistoryEventsFromTransport(pmRoot:string,input:Record<string,unknown>):Promise<UnknownAuthorAcknowledgmentResult>;
 /**
  * Append an audited disposition for immutable unknown-author events without
  * rewriting their original streams.
  */
-export declare function acknowledgeUnknownAuthorHistoryEvents(pmRoot: string, options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>;
+export declare function acknowledgeUnknownAuthorHistoryEvents(pmRoot:string,options:AcknowledgeUnknownAuthorEventsOptions):Promise<UnknownAuthorAcknowledgmentResult>;

package/dist/sdk/authoring.d.ts

@@ -7,12 +7,12 @@ export * from "./compose.js";
 export * from "./define.js";
 export * from "./extension-contracts.js";
 export { RESERVED_ITEM_FIELD_NAMES } from "../core/extensions/item-fields.js";
-export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS, PM_PACKAGE_RESOURCE_KINDS, collectPackageExtensionDirectories, readPmPackageManifest, type PmPackageCatalogLinkMap, type PmPackageCatalogMediaMap, type PmPackageCatalogMetadata, type PmPackageManifest, type PmPackageResourceKind, type PmPackageResourceMap, } from "../core/packages/manifest.js";
-export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, type ProfileConfigEntry, type ProfileName, type ProfilePackageRecommendation, type ProfileTemplateEntry, type ProfileTemplateOptions, type ProjectProfileDefinition, type ProjectProfileRegistrationInput, } from "../core/profile/profile-presets.js";
-export { describeProfileComposition, describeProjectProfile, type ProjectProfileComposition, type ProjectProfileDescription, type ProjectProfilePackageSummary, } from "../core/profile/profile-describe.js";
-export { lintProjectProfile, PROFILE_LINT_CODES, PROFILE_LINT_DIMENSIONS, type ProfileLintCode, type ProfileLintDimension, type ProfileLintSeverity, type ProjectProfileLintFinding, type ProjectProfileLintReport, } from "../core/profile/profile-lint.js";
-export { planProfileApplication, type ProfileApplicationPlan, type ProfileChangeStatus, type ProfileComponentChange, type ProfileConfigChange, type ProfileConfigPlan, type ProfileCurrentState, type ProfilePackagePlan, type ProfileSchemaPlan, type ProfileTemplateChange, type ProfileTemplatePlan, type ProfileWorkflowChange, type ProfileWorkflowPlan, } from "../core/profile/profile-plan.js";
-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, 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";
+export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,PM_PACKAGE_RESOURCE_KINDS,collectPackageExtensionDirectories,readPmPackageManifest,type PmPackageCatalogLinkMap,type PmPackageCatalogMediaMap,type PmPackageCatalogMetadata,type PmPackageManifest,type PmPackageResourceKind,type PmPackageResourceMap,} from "../core/packages/manifest.js";
+export { BUILTIN_PROFILES,listProfiles,normalizeProfileName,PROFILE_NAMES,resolveProfile,type ProfileConfigEntry,type ProfileName,type ProfilePackageRecommendation,type ProfileTemplateEntry,type ProfileTemplateOptions,type ProjectProfileDefinition,type ProjectProfileRegistrationInput,} from "../core/profile/profile-presets.js";
+export { describeProfileComposition,describeProjectProfile,type ProjectProfileComposition,type ProjectProfileDescription,type ProjectProfilePackageSummary,} from "../core/profile/profile-describe.js";
+export { lintProjectProfile,PROFILE_LINT_CODES,PROFILE_LINT_DIMENSIONS,type ProfileLintCode,type ProfileLintDimension,type ProfileLintSeverity,type ProjectProfileLintFinding,type ProjectProfileLintReport,} from "../core/profile/profile-lint.js";
+export { planProfileApplication,type ProfileApplicationPlan,type ProfileChangeStatus,type ProfileComponentChange,type ProfileConfigChange,type ProfileConfigPlan,type ProfileCurrentState,type ProfilePackagePlan,type ProfileSchemaPlan,type ProfileTemplateChange,type ProfileTemplatePlan,type ProfileWorkflowChange,type ProfileWorkflowPlan,} from "../core/profile/profile-plan.js";
+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,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/cli-bootstrap.d.ts

@@ -3,112 +3,112 @@
  *
  * Provides public bootstrap argument normalization for embedded CLI hosts.
  */
-import { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, type PmCommandAliasContract, type PmCommandAliasLifecycle, type PmCommandAliasRegistration } from "./cli-contracts/command-aliases.js";
+import { EXECUTABLE_COMMAND_ALIASES,PM_COMMAND_ALIAS_CONTRACTS,renderPmCommandAliasMigrationHint,resolvePmCommandAlias,type PmCommandAliasContract,type PmCommandAliasLifecycle,type PmCommandAliasRegistration } from "./cli-contracts/command-aliases.js";
 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, };
+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;
+path?:string;
 /** Value that configures or reports no extensions for this contract. */
-noExtensions: boolean;
+noExtensions:boolean;
 /** Value that configures or reports no pager for this contract. */
-noPager: boolean;
+noPager:boolean;
 /** Value that configures or reports json for this contract. */
-json: boolean;
+json:boolean;
 /** Value that configures or reports quiet for this contract. */
-quiet: boolean;
+quiet:boolean;
 /** Whether compact JSON projection is requested. */
-lean: boolean;
+lean:boolean;
 /** Whether output token accounting is requested. */
-tokenAccounting: boolean;
+tokenAccounting:boolean;
 /** Canonical comma-separated fields or sections retained in read output. */
-outputInclude?: string;
+outputInclude?:string;
 /** Canonical maximum row count retained in read output. */
-outputLimit?: string;
+outputLimit?:string;
 /** Canonical estimated-token ceiling for read output. */
-outputBudget?: string;
+outputBudget?:string;
 /** Canonical renderer encoding for read output. */
-outputFormat?: "toon" | "json";
+outputFormat?:"toon" | "json";
 /** Caller-carried cross-call budget and served-item state. */
-outputSession?: string;
+outputSession?:string;
 /** Opaque budget-compaction continuation cursor. */
-outputCursor?: string;
+outputCursor?:string;
 /** Whether machine-readable row discovery metadata is requested. */
-outputRowContract?: boolean;
+outputRowContract?:boolean;
 /** Invocation-wide mutation author override. */
-author?: string;
+author?:string;
 /** Whether `--author` was present without its required value. */
-authorMissingValue?: true;
+authorMissingValue?:true;
 }
 /** Implements parse bootstrap global options for the public runtime surface of this module. */
-export declare function parseBootstrapGlobalOptions(argv: string[]): BootstrapGlobalOptions;
+export declare function parseBootstrapGlobalOptions(argv:string[]):BootstrapGlobalOptions;
 /** Implements strip global bootstrap tokens for the public runtime surface of this module. */
-export declare function stripGlobalBootstrapTokens(argv: string[]): string[];
+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;
+requested:boolean;
 /** Value that configures or reports command path tokens for this contract. */
-commandPathTokens: string[];
+commandPathTokens:string[];
 }
 /** Implements parse bootstrap help request for the public runtime surface of this module. */
-export declare function parseBootstrapHelpRequest(argv: string[]): BootstrapHelpRequest;
+export declare function parseBootstrapHelpRequest(argv:string[]):BootstrapHelpRequest;
 /** Locate the command token after global bootstrap flags and their values. */
-export declare function findBootstrapCommandTokenIndex(argv: string[]): number | undefined;
+export declare function findBootstrapCommandTokenIndex(argv:string[]):number | undefined;
 /** Resolve the normalized command name from bootstrap invocation arguments. */
-export declare function parseBootstrapCommandName(argv: string[]): string | undefined;
+export declare function parseBootstrapCommandName(argv:string[]):string | undefined;
 /** Implements apply bootstrap pager policy for the public runtime surface of this module. */
-export declare function applyBootstrapPagerPolicy(argv: string[]): () => void;
+export declare function applyBootstrapPagerPolicy(argv:string[]):() => void;
 /** Implements normalize legacy extension action syntax for the public runtime surface of this module. */
-export declare function normalizeLegacyExtensionActionSyntax(argv: string[]): string[];
+export declare function normalizeLegacyExtensionActionSyntax(argv:string[]):string[];
 type BootstrapNormalizationReason = "executable_alias" | "legacy_extension_action" | "command_alias" | "item_id_alias" | "flag_alias" | "flag_typo" | "bare_key_value" | "list_merge";
 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;
+from:string;
 /** Value that configures or reports to for this contract. */
-to: string[];
+to:string[];
 /** Value that configures or reports reason for this contract. */
-reason: BootstrapNormalizationReason;
+reason:BootstrapNormalizationReason;
 /** Value that configures or reports confidence for this contract. */
-confidence: BootstrapNormalizationConfidence;
+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[];
+argv:string[];
 /** Value that configures or reports command name for this contract. */
-commandName: string | undefined;
+commandName:string | undefined;
 /** Value that configures or reports trace for this contract. */
-trace: BootstrapNormalizationEvent[];
+trace:BootstrapNormalizationEvent[];
 }
 interface FlagLookup {
-canonicalByNormalized: Map<string, string | null>;
-canonicalByCompact: Map<string, string | null>;
-canonicalComparables: Array<{
-canonicalFlag: string;
-comparable: string;
+canonicalByNormalized:Map<string,string | null>;
+canonicalByCompact:Map<string,string | null>;
+canonicalComparables:Array<{
+canonicalFlag:string;
+comparable:string;
 }>;
-listCanonicalFlags: Set<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;
+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;
 } | 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;
+export declare function listAliasPluralKeys(normalizedKey:string):string[];
+declare function normalizeLongOptionToken(token:string,lookup:FlagLookup,preserve?:boolean):{
+tokens:string[];
+event?:BootstrapNormalizationEvent;
 };
 /** Locate global path-value tokens that normalization must preserve literally. */
-declare function collectBootstrapPathValueIndices(argv: string[]): Set<number>;
+declare function collectBootstrapPathValueIndices(argv:string[]):Set<number>;
 /**
  * Coalesce repeated occurrences of comma-separated list flags into a single
  * `--flag=v1,v2,v3` token anchored at the FIRST occurrence. Without this,
@@ -122,26 +122,26 @@ declare function collectBootstrapPathValueIndices(argv: string[]): Set<number>;
  * list-flag-looking value (`--path --tags`) is never reinterpreted as a flag
  * 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[];
+export declare function coalesceRepeatedListFlags(argv:string[],listFlags:Set<string>,valueConsumingFlags?:Set<string>,multiValueListFlags?:Set<string>):{
+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[];
+export declare function mergeLinkedTestTwoTokenEntries(argv:string[],commandName:string | undefined,trace:BootstrapNormalizationEvent[]):string[];
 /**
  * Canonicalize executable, command, item-address and option aliases before registration.
  * Coalesce declared list values while preserving explicit literals and help discovery;
  * return the selected command and normalization events for host diagnostics.
  */
-export declare function normalizeBootstrapInvocation(argv: string[]): BootstrapInvocationNormalizationResult;
+export declare function normalizeBootstrapInvocation(argv:string[]):BootstrapInvocationNormalizationResult;
 /** Implements parse bootstrap type value for the public runtime surface of this module. */
-export declare function parseBootstrapTypeValue(argv: string[]): string | undefined;
+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;
+export declare const _testOnly:{
+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

@@ -1,127 +1,127 @@
 /** Stable degradation stages applied when an output exceeds its token budget. */
-export declare const PM_OUTPUT_DEGRADATION_STEPS: readonly ["full", "compact", "brief", "summary", "counts"];
+export declare const PM_OUTPUT_DEGRADATION_STEPS:readonly ["full","compact","brief","summary","counts"];
 /** Restricts deterministic output degradation stages. */
 export type PmOutputDegradationStep = (typeof PM_OUTPUT_DEGRADATION_STEPS)[number];
 /** Stable command-output classes used to assign conservative default budgets. */
-export declare const PM_OUTPUT_BUDGET_CLASSES: readonly ["mutation", "read", "discovery", "governance"];
+export declare const PM_OUTPUT_BUDGET_CLASSES:readonly ["mutation","read","discovery","governance"];
 /** Restricts command-output budget classes. */
 export type PmOutputBudgetClass = (typeof PM_OUTPUT_BUDGET_CLASSES)[number];
 /** Stable diagnostic families that require independent output ceilings. */
-export declare const PM_DIAGNOSTIC_OUTPUT_CLASSES: readonly ["error", "warning", "validation_summary", "recovery_bundle"];
+export declare const PM_DIAGNOSTIC_OUTPUT_CLASSES:readonly ["error","warning","validation_summary","recovery_bundle"];
 /** Restricts diagnostic budget selection to declared families. */
 export type PmDiagnosticOutputClass = (typeof PM_DIAGNOSTIC_OUTPUT_CLASSES)[number];
 /** Deterministic diagnostic degradation stages, from richest to smallest. */
-export declare const PM_DIAGNOSTIC_DEGRADATION_STEPS: readonly ["full", "omit_explanation", "limit_collections", "compact_recovery", "action_only"];
+export declare const PM_DIAGNOSTIC_DEGRADATION_STEPS:readonly ["full","omit_explanation","limit_collections","compact_recovery","action_only"];
 /** Restricts diagnostic degradation receipts to declared stages. */
 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;
+diagnostic_class:PmDiagnosticOutputClass;
 /** Default ceiling by rendered transport. */
-default_max_estimated_tokens_by_format: Readonly<{
-text: number;
-json: number;
+default_max_estimated_tokens_by_format:Readonly<{
+text:number;
+json:number;
 }>;
 /** Smallest explicit ceiling accepted by the projector. */
-minimum_max_estimated_tokens: number;
+minimum_max_estimated_tokens:number;
 /** Ordered degradation policy applied when the ceiling binds. */
-degradation_ladder: readonly PmDiagnosticDegradationStep[];
+degradation_ladder:readonly PmDiagnosticDegradationStep[];
 /** Paths whose first actionable value must survive degradation. */
-corrective_action_paths: readonly string[];
+corrective_action_paths:readonly string[];
 /** Stable estimate used by gates and SDK consumers. */
-token_estimate: "ceil(utf8_bytes / 4)";
+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;
+diagnostic_class:PmDiagnosticOutputClass;
 /** Rendered transport measured by the projector. */
-format: "json" | "text";
+format:"json" | "text";
 /** Effective estimated-token ceiling. */
-budget: number;
+budget:number;
 /** Whether the caller supplied the ceiling or used the declaration. */
-budget_source: "default" | "explicit";
+budget_source:"default" | "explicit";
 /** Estimate before diagnostic degradation. */
-original_estimated_tokens: number;
+original_estimated_tokens:number;
 /** Exact estimate of the returned projection. */
-estimated_tokens: number;
+estimated_tokens:number;
 /** Whether one or more fields were removed or compacted. */
-truncated: boolean;
+truncated:boolean;
 /** Applied stages in contract order. */
-degradation_steps: PmDiagnosticDegradationStep[];
+degradation_steps:PmDiagnosticDegradationStep[];
 /** Top-level fields removed from the original diagnostic. */
-omitted_fields: string[];
+omitted_fields:string[];
 /** Additional omitted fields not named individually in a bounded receipt. */
-omitted_fields_overflow_count?: number;
+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;
+export type PmProjectedDiagnostic<TDiagnostic extends object> = Partial<TDiagnostic> & Pick<TDiagnostic,Extract<keyof TDiagnostic,"code" | "required">> & {
+diagnostic_output?:PmDiagnosticOutputReceipt;
 };
 /** Describes one command's default agent-output budget and degradation policy. */
 export interface PmCommandOutputBudgetContract {
 /** Canonical or compatibility command name. */
-command: string;
+command:string;
 /** Workload class that selected the default ceiling. */
-budget_class: PmOutputBudgetClass;
+budget_class:PmOutputBudgetClass;
 /** Default estimated-token ceiling for representative output. */
-default_max_estimated_tokens: number;
+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;
+default_max_estimated_tokens_by_format:Readonly<{
+toon:number;
+json:number;
 }>;
 /** Ordered fallback projections, from richest to smallest. */
-degradation_ladder: readonly PmOutputDegradationStep[];
+degradation_ladder:readonly PmOutputDegradationStep[];
 /** Whether callers may explicitly request an unbounded result. */
-allows_unbounded_opt_out: boolean;
+allows_unbounded_opt_out:boolean;
 /** Stable estimate used by gates and SDK consumers. */
-token_estimate: "ceil(utf8_bytes / 4)";
+token_estimate:"ceil(utf8_bytes / 4)";
 }
 /** Public default contract for every diagnostic family. */
-export declare const PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS: PmDiagnosticOutputBudgetContract[];
+export declare const PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS:PmDiagnosticOutputBudgetContract[];
 /** Infer the conservative workload class for a core or package command. */
-export declare function inferPmOutputBudgetClass(command: string): PmOutputBudgetClass;
+export declare function inferPmOutputBudgetClass(command:string):PmOutputBudgetClass;
 /** Build the generated default budget for a core or package command. */
-export declare function createPmCommandOutputBudget(command: string, budgetClass?: PmOutputBudgetClass): PmCommandOutputBudgetContract;
+export declare function createPmCommandOutputBudget(command:string,budgetClass?:PmOutputBudgetClass):PmCommandOutputBudgetContract;
 /**
  * Declares one budget contract while preserving literal command metadata for
  * package-authored registries and test fixtures. Rejects ceilings that cannot
  * represent a positive, deterministic token allowance.
  */
-export declare function definePmCommandOutputBudget<TContract extends PmCommandOutputBudgetContract>(contract: TContract): TContract;
+export declare function definePmCommandOutputBudget<TContract extends PmCommandOutputBudgetContract>(contract:TContract):TContract;
 /** Public default budget contract for every built-in pm command. */
-export declare const PM_COMMAND_OUTPUT_BUDGET_CONTRACTS: PmCommandOutputBudgetContract[];
+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;
-}): PmCommandOutputBudgetContract;
+export declare function resolvePmCommandOutputBudget(command:string,options:{
+generateFallback:true;
+}):PmCommandOutputBudgetContract;
 /** Resolve a declared output budget without generating a package fallback. */
-export declare function resolvePmCommandOutputBudget(command: string, options?: {
-generateFallback?: false;
-}): PmCommandOutputBudgetContract | null;
+export declare function resolvePmCommandOutputBudget(command:string,options?:{
+generateFallback?:false;
+}):PmCommandOutputBudgetContract | null;
 /** Estimate conservative token usage from UTF-8 output bytes. */
-export declare function estimatePmOutputTokens(utf8Bytes: number): number;
+export declare function estimatePmOutputTokens(utf8Bytes:number):number;
 /** Resolve the binding output contract for one diagnostic family. */
-export declare function resolvePmDiagnosticOutputBudget(diagnosticClass: PmDiagnosticOutputClass): PmDiagnosticOutputBudgetContract;
+export declare function resolvePmDiagnosticOutputBudget(diagnosticClass:PmDiagnosticOutputClass):PmDiagnosticOutputBudgetContract;
 /**
  * Bind a JSON diagnostic to its declared ceiling while preserving the first
  * corrective action and reporting every top-level omission.
  */
-export declare function projectPmDiagnosticOutput<TDiagnostic extends object>(diagnostic: TDiagnostic, options?: {
-diagnosticClass?: PmDiagnosticOutputClass;
-maxEstimatedTokens?: number;
-}): PmProjectedDiagnostic<TDiagnostic>;
+export declare function projectPmDiagnosticOutput<TDiagnostic extends object>(diagnostic:TDiagnostic,options?:{
+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;
+output:string;
 /** Binding diagnostic budget receipt. */
-diagnostic_output: PmDiagnosticOutputReceipt;
+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;
-}): PmProjectedTextDiagnostic;
+export declare function projectPmDiagnosticText(output:string,correctiveAction:string,options?:{
+diagnosticClass?:PmDiagnosticOutputClass;
+maxEstimatedTokens?:number;
+}):PmProjectedTextDiagnostic;