@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/core/extensions/flag-definition-validation.d.ts

@@ -2,19 +2,32 @@
  * Long extension declaration accepted by Commander: canonical kebab names,
  * legacy underscore aliases, and an optional value placeholder.
  */
-export declare const EXTENSION_LONG_FLAG_PATTERN: RegExp;
+export declare const EXTENSION_LONG_FLAG_PATTERN:RegExp;
+/** Canonical identity and value syntax of a supported long flag declaration. */
+export interface ExtensionLongFlagSpelling {
+/** Bare long option identity used for dispatch and discovery. */
+name:string;
+/** Inline value label, or null for a bare declaration. */
+valueName:string | null;
+/** Whether the inline value uses optional brackets. */
+optional:boolean;
+}
+/** Parse supported legacy placeholder syntax without duplicating its option identity. */
+export declare function parseExtensionLongFlagToken(value:unknown):ExtensionLongFlagSpelling | null;
+/** Resolve supported canonical names while preserving trimmed legacy spellings for permissive consumers. Validation remains separate. */
+export declare function resolveExtensionLongFlagName(value:unknown):string | null;
 /** Machine-readable failure returned for one invalid extension flag token. */
 export type ExtensionFlagTokenFailure = "host_owned_flag_collision" | "malformed_long_flag";
 /** Invalid token and failure classification returned for one flag definition. */
 export interface ExtensionFlagTokenFinding {
 /** Trimmed long or short token that failed validation. */
-token: string;
+token:string;
 /** Stable failure classification shared by lint and activation. */
-failure: ExtensionFlagTokenFailure;
+failure:ExtensionFlagTokenFailure;
 }
 /** Describe why a declared long flag cannot be registered, or `null` when valid. */
-export declare function validateExtensionLongFlagToken(value: unknown): ExtensionFlagTokenFailure | null;
+export declare function validateExtensionLongFlagToken(value:unknown):ExtensionFlagTokenFailure | null;
 /** Find the first host-owned or malformed token in one extension flag definition. */
-export declare function findExtensionFlagTokenFailure(long: unknown, short: unknown): ExtensionFlagTokenFinding | null;
+export declare function findExtensionFlagTokenFailure(long:unknown,short:unknown):ExtensionFlagTokenFinding | null;
 /** Render the shared actionable diagnostic used by preflight and activation. */
-export declare function describeExtensionLongFlagFailure(token: string, failure: ExtensionFlagTokenFailure): string;
+export declare function describeExtensionLongFlagFailure(token:string,failure:ExtensionFlagTokenFailure):string;

package/dist/core/extensions/flag-definition-validation.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]="0403fec1-f10a-5361-982b-c127c2617e95")}catch{}})();import{RESERVED_EXTENSION_HOST_FLAG_NAMES}from"./reserved-host-flags.js";const EXTENSION_LONG_FLAG_PATTERN=/^--[a-z0-9][a-z0-9_-]*(?:[ =](?:<[^<>]+>|\[[^[\]]+\]))?$/;function validateExtensionLongFlagToken(value){if(typeof value!="string")return null;const token=value.trim(),hostToken=token.split(/[ =]/,1)[0];return RESERVED_EXTENSION_HOST_FLAG_NAMES.has(hostToken)?"host_owned_flag_collision":EXTENSION_LONG_FLAG_PATTERN.test(token)?null:"malformed_long_flag"}function findExtensionFlagTokenFailure(long,short){const reserved=[long,short].find(token2=>typeof token2=="string"&&RESERVED_EXTENSION_HOST_FLAG_NAMES.has(token2.trim().split(/[ =]/,1)[0]));if(typeof reserved=="string")return{token:reserved.trim().split(/[ =]/,1)[0],failure:"host_owned_flag_collision"};if(typeof long!="string")return null;const token=long.trim(),failure=validateExtensionLongFlagToken(token);return failure===null?null:{token,failure}}function describeExtensionLongFlagFailure(token,failure){return failure==="host_owned_flag_collision"?`cannot shadow host-owned global flag "${token}"; read it from context.global instead`:`long flag "${token}" must start with a double-dash name such as "--my-flag" or "--my-flag <value>"`}export{EXTENSION_LONG_FLAG_PATTERN,describeExtensionLongFlagFailure,findExtensionFlagTokenFailure,validateExtensionLongFlagToken};
+(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]="896ebde0-4ca1-50ed-bb8e-2a8c2d978d94")}catch{}})();import{RESERVED_EXTENSION_HOST_FLAG_NAMES}from"./reserved-host-flags.js";const EXTENSION_LONG_FLAG_PATTERN=/^(--[a-z0-9][a-z0-9_-]*)(?:[ =](<[^<>]+>|\[[^[\]]+\]))?$/;function parseExtensionLongFlagToken(value){if(typeof value!="string")return null;const matched=EXTENSION_LONG_FLAG_PATTERN.exec(value.trim());if(!matched)return null;const placeholder=matched[2];return{name:matched[1],valueName:placeholder?placeholder.slice(1,-1):null,optional:placeholder?.startsWith("[")??!1}}function resolveExtensionLongFlagName(value){const parsed=parseExtensionLongFlagToken(value);return parsed?parsed.name:typeof value=="string"&&value.trim()||null}function validateExtensionLongFlagToken(value){if(typeof value!="string")return null;const token=value.trim(),hostToken=token.split(/[ =]/,1)[0];return RESERVED_EXTENSION_HOST_FLAG_NAMES.has(hostToken)?"host_owned_flag_collision":EXTENSION_LONG_FLAG_PATTERN.test(token)?null:"malformed_long_flag"}function findExtensionFlagTokenFailure(long,short){const reserved=[long,short].find(token2=>typeof token2=="string"&&RESERVED_EXTENSION_HOST_FLAG_NAMES.has(token2.trim().split(/[ =]/,1)[0]));if(typeof reserved=="string")return{token:reserved.trim().split(/[ =]/,1)[0],failure:"host_owned_flag_collision"};if(typeof long!="string")return null;const token=long.trim(),failure=validateExtensionLongFlagToken(token);return failure===null?null:{token,failure}}function describeExtensionLongFlagFailure(token,failure){return failure==="host_owned_flag_collision"?`cannot shadow host-owned global flag "${token}"; read it from context.global instead`:`long flag "${token}" must start with a double-dash name such as "--my-flag" or "--my-flag <value>"`}export{EXTENSION_LONG_FLAG_PATTERN,describeExtensionLongFlagFailure,findExtensionFlagTokenFailure,parseExtensionLongFlagToken,resolveExtensionLongFlagName,validateExtensionLongFlagToken};
 //# sourceMappingURL=flag-definition-validation.js.map

package/dist/core/extensions/flag-value-types.d.ts

@@ -1,9 +1,21 @@
-/** Canonical coercion kinds an extension flag can declare via `value_type` (or the deprecated `type` alias). The runtime also accepts a few common aliases (`int`/`integer`/`float` -> number, `bool` -> boolean) so author intent is honored without surprises. */
+/** Shared scalar coercion and value-token grammar for contributed flags. */
+import type { FlagDefinition } from "./extension-types.js";
 /** Canonical scalar value kinds accepted by extension command flag definitions. */
 export type FlagValueKind = "string" | "number" | "boolean";
 /** Resolve a declared flag value type (string) to its canonical kind, or `null` when it is not a recognized type/alias. Matching is trim- and case-insensitive. */
-export declare function resolveFlagValueKind(raw: unknown): FlagValueKind | null;
+export declare function resolveFlagValueKind(raw:unknown):FlagValueKind | null;
+/** Value-token grammar retained separately from scalar coercion and required flag presence. */
+export interface ExtensionFlagValueContract {
+/** Canonical kind after coercion; null means the declaration has no explicit scalar type. */
+value_type:FlagValueKind | null;
+/** Whether argv consumes no value, a mandatory value, or an optional value. */
+value_arity:"none" | "required" | "optional";
+/** Display label for a consumed value; null for switches. */
+value_name:string | null;
+}
+/** Preserve legacy bool value tokens and inline optionality before canonicalizing the scalar kind. */
+export declare function resolveExtensionFlagValueContract(definition:Readonly<FlagDefinition>):ExtensionFlagValueContract;
 /** Flatten a `list` flag value (or default) into its individual entries the same way the runtime does: nested arrays are flattened and comma-joined strings are split, with surrounding whitespace trimmed and empty segments dropped. No type coercion is applied. Shared by the CLI coercion path and the registration-time default validator so the two never disagree. */
-export declare function flattenFlagListValue(value: unknown): unknown[];
+export declare function flattenFlagListValue(value:unknown):unknown[];
 /** Whether a scalar flag default would cleanly coerce under the declared kind, mirroring the runtime coercion rules in `coerceLooseCommandOptionsWithFlagDefinitions`. Used to reject contradictory definitions (e.g. `value_type: "number"` with `default: "abc"`) at registration instead of letting an untyped value pass through to activation. */
-export declare function isFlagDefaultValueCoercible(value: string | number | boolean, kind: FlagValueKind): boolean;
+export declare function isFlagDefaultValueCoercible(value:string | number | boolean,kind:FlagValueKind):boolean;

package/dist/core/extensions/flag-value-types.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]="a2ab8801-f75b-5ba0-88a5-354d24c37c6f")}catch{}})();const FLAG_VALUE_KIND_BY_ALIAS=Object.freeze({string:"string",number:"number",int:"number",integer:"number",float:"number",boolean:"boolean",bool:"boolean"});function resolveFlagValueKind(raw){return typeof raw!="string"?null:FLAG_VALUE_KIND_BY_ALIAS[raw.trim().toLowerCase()]??null}function flattenFlagListValue(value){const entries=[],collect=input=>{if(Array.isArray(input)){for(const item of input)collect(item);return}if(typeof input=="string"){for(const part of input.split(",")){const trimmed=part.trim();trimmed.length>0&&entries.push(trimmed)}return}input!=null&&entries.push(input)};return collect(value),entries}function isFlagDefaultValueCoercible(value,kind){return kind==="string"?!0:kind==="number"?typeof value=="number"?Number.isFinite(value):typeof value=="string"&&value.trim().length>0&&Number.isFinite(Number(value)):typeof value=="boolean"?!0:typeof value=="string"&&["true","false","1","0"].includes(value.trim().toLowerCase())}export{flattenFlagListValue,isFlagDefaultValueCoercible,resolveFlagValueKind};
+(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]="a6358127-2683-56bd-a1b7-8cdfbaad5f51")}catch{}})();import{parseExtensionLongFlagToken}from"./flag-definition-validation.js";const FLAG_VALUE_KIND_BY_ALIAS=Object.freeze({string:"string",number:"number",int:"number",integer:"number",float:"number",boolean:"boolean",bool:"boolean"});function resolveFlagValueKind(raw){if(typeof raw!="string")return null;const alias=raw.trim().toLowerCase();return Object.hasOwn(FLAG_VALUE_KIND_BY_ALIAS,alias)?FLAG_VALUE_KIND_BY_ALIAS[alias]:null}function hasExtensionFlagValueMetadata(definition,inlineName,declaredType){return!!(definition.value_name?.trim()||inlineName||declaredType||definition.required===!0||definition.list===!0||definition.repeatable===!0)}function declaredExtensionFlagType(definition){return(definition.value_type?.trim()||definition.type?.trim())?.toLowerCase()}function resolveExtensionFlagValueContract(definition){const declaredType=declaredExtensionFlagType(definition),valueType=resolveFlagValueKind(declaredType),inline=parseExtensionLongFlagToken(definition.long),declaredName=definition.value_name?.trim()||null,takesValue=!(valueType==="boolean"&&declaredType!=="bool")&&hasExtensionFlagValueMetadata(definition,inline?.valueName,declaredType),optionalValue=inline?.valueName?inline.optional:declaredType==="bool";return{value_type:valueType,value_arity:takesValue?optionalValue?"optional":"required":"none",value_name:takesValue?declaredName??inline?.valueName??"value":null}}function flattenFlagListValue(value){const entries=[],collect=input=>{if(Array.isArray(input)){for(const item of input)collect(item);return}if(typeof input=="string"){for(const part of input.split(",")){const trimmed=part.trim();trimmed.length>0&&entries.push(trimmed)}return}input!=null&&entries.push(input)};return collect(value),entries}function isFlagDefaultValueCoercible(value,kind){return kind==="string"?!0:kind==="number"?typeof value=="number"?Number.isFinite(value):typeof value=="string"&&value.trim().length>0&&Number.isFinite(Number(value)):typeof value=="boolean"?!0:typeof value=="string"&&["true","false","1","0"].includes(value.trim().toLowerCase())}export{flattenFlagListValue,isFlagDefaultValueCoercible,resolveExtensionFlagValueContract,resolveFlagValueKind};
 //# sourceMappingURL=flag-value-types.js.map

package/dist/core/extensions/index.d.ts

@@ -1,30 +1,30 @@
-import { type CommandHandlerContext, type CommandHandlerResult, type CommandOverrideContext, type CommandOverrideResult, type ExtensionCommandRegistry, type ExtensionHookRegistry, type ExtensionParserRegistry, type ExtensionPreflightRegistry, type ExtensionRegistrationRegistry, type ExtensionRendererRegistry, type ExtensionServiceName, type ExtensionServiceRegistry, type AfterCommandAffectedItem, type OnIndexHookContext, type OnReadHookContext, type OnWriteHookContext, type BeforeMutationHookContext, type OutputRendererFormat, type ParserOverrideContext, type ParserOverrideResult, type PortableWorkspaceContext, type PreflightOverrideContext, type PreflightOverrideResult, type RendererOverrideResult, type ServiceOverrideResult } from "./loader.js";
+import { type CommandHandlerContext,type CommandHandlerResult,type CommandOverrideContext,type CommandOverrideResult,type ExtensionCommandRegistry,type ExtensionHookRegistry,type ExtensionParserRegistry,type ExtensionPreflightRegistry,type ExtensionRegistrationRegistry,type ExtensionRendererRegistry,type ExtensionServiceName,type ExtensionServiceRegistry,type AfterCommandAffectedItem,type OnIndexHookContext,type OnReadHookContext,type OnWriteHookContext,type BeforeMutationHookContext,type OutputRendererFormat,type ParserOverrideContext,type ParserOverrideResult,type PortableWorkspaceContext,type PreflightOverrideContext,type PreflightOverrideResult,type RendererOverrideResult,type ServiceOverrideResult } from "./loader.js";
 import type { ItemMetadata } from "../../types/index.js";
 /** Run one embedded request with extension registries isolated from concurrent workspaces. */
-export declare function runWithIsolatedExtensionRuntime<T>(run: () => Promise<T>): Promise<T>;
+export declare function runWithIsolatedExtensionRuntime<T>(run:() => Promise<T>):Promise<T>;
 /**
  * Resolve portable workspace coordinates without reading tracker state.
  *
  * Linked-test runners set `PM_SOURCE_WORKSPACE_ROOT` before swapping `PM_PATH`,
  * preserving source VCS identity while every mutation remains sandboxed.
  */
-export declare function resolvePortableWorkspaceContext(pmRoot: string | undefined): PortableWorkspaceContext;
+export declare function resolvePortableWorkspaceContext(pmRoot:string | undefined):PortableWorkspaceContext;
 /** Implements set active extension hooks for the public runtime surface of this module. */
-export declare function setActiveExtensionHooks(hooks: ExtensionHookRegistry | null): void;
+export declare function setActiveExtensionHooks(hooks:ExtensionHookRegistry | null):void;
 /** Implements set active extension commands for the public runtime surface of this module. */
-export declare function setActiveExtensionCommands(commands: ExtensionCommandRegistry | null): void;
+export declare function setActiveExtensionCommands(commands:ExtensionCommandRegistry | null):void;
 /** Implements set active extension parsers for the public runtime surface of this module. */
-export declare function setActiveExtensionParsers(parsers: ExtensionParserRegistry | null): void;
+export declare function setActiveExtensionParsers(parsers:ExtensionParserRegistry | null):void;
 /** Implements set active extension preflight for the public runtime surface of this module. */
-export declare function setActiveExtensionPreflight(preflight: ExtensionPreflightRegistry | null): void;
+export declare function setActiveExtensionPreflight(preflight:ExtensionPreflightRegistry | null):void;
 /** Implements set active extension services for the public runtime surface of this module. */
-export declare function setActiveExtensionServices(services: ExtensionServiceRegistry | null): void;
+export declare function setActiveExtensionServices(services:ExtensionServiceRegistry | null):void;
 /** Implements set active extension renderers for the public runtime surface of this module. */
-export declare function setActiveExtensionRenderers(renderers: ExtensionRendererRegistry | null): void;
+export declare function setActiveExtensionRenderers(renderers:ExtensionRendererRegistry | null):void;
 /** Implements set active extension registrations for the public runtime surface of this module. */
-export declare function setActiveExtensionRegistrations(registrations: ExtensionRegistrationRegistry | null): void;
+export declare function setActiveExtensionRegistrations(registrations:ExtensionRegistrationRegistry | null):void;
 /** Implements get active extension registrations for the public runtime surface of this module. */
-export declare function getActiveExtensionRegistrations(): ExtensionRegistrationRegistry | null;
+export declare function getActiveExtensionRegistrations():ExtensionRegistrationRegistry | null;
 /**
  * Clear every request-local or module-level active-extension registry in one step.
  *
@@ -33,55 +33,55 @@ export declare function getActiveExtensionRegistrations(): ExtensionRegistration
  * state and reset it at invocation entry so concurrent workspaces cannot see
  * each other's registrations.
  */
-export declare function resetActiveExtensionRuntimeState(): void;
+export declare function resetActiveExtensionRuntimeState():void;
 /** Implements set active command context for the public runtime surface of this module. */
-export declare function setActiveCommandContext(context: Omit<CommandOverrideContext, "result"> | null): void;
+export declare function setActiveCommandContext(context:Omit<CommandOverrideContext,"result"> | null):void;
 /** Return a defensive snapshot of the current invocation's command context. */
-export declare function getActiveCommandContext(): Omit<CommandOverrideContext, "result"> | null;
+export declare function getActiveCommandContext():Omit<CommandOverrideContext,"result"> | null;
 /**
  * Prove that the active command has no extension execution surface. Unrelated
  * command registrations are harmless; hooks, services, renderers, migrations,
  * and matching handlers/parsers make ownership uncertain and fail closed.
  * Snapshot this predicate before entering an isolated infrastructure context.
  */
-export declare function isActiveCommandUnextended(command: string): boolean;
+export declare function isActiveCommandUnextended(command:string):boolean;
 /** Implements set active command result for the public runtime surface of this module. */
-export declare function setActiveCommandResult(result: unknown): void;
+export declare function setActiveCommandResult(result:unknown):void;
 /** Implements get active command result for the public runtime surface of this module. */
-export declare function getActiveCommandResult(): unknown;
+export declare function getActiveCommandResult():unknown;
 /** Implements record after command affected item for the public runtime surface of this module. */
-export declare function recordAfterCommandAffectedItem(item: AfterCommandAffectedItem): void;
+export declare function recordAfterCommandAffectedItem(item:AfterCommandAffectedItem):void;
 /** Implements project after command item snapshot for the public runtime surface of this module. */
-export declare function projectAfterCommandItemSnapshot(metadata: ItemMetadata, changedFields: readonly string[]): Partial<ItemMetadata>;
+export declare function projectAfterCommandItemSnapshot(metadata:ItemMetadata,changedFields:readonly string[]):Partial<ItemMetadata>;
 /** Implements consume after command affected items for the public runtime surface of this module. */
-export declare function consumeAfterCommandAffectedItems(): AfterCommandAffectedItem[] | undefined;
+export declare function consumeAfterCommandAffectedItems():AfterCommandAffectedItem[] | undefined;
 /** Implements clear active extension hooks for the public runtime surface of this module. */
-export declare function clearActiveExtensionHooks(): void;
+export declare function clearActiveExtensionHooks():void;
 /** Implements run active on write hooks for the public runtime surface of this module. */
-export declare function runActiveOnWriteHooks(context: OnWriteHookContext): Promise<string[]>;
+export declare function runActiveOnWriteHooks(context:OnWriteHookContext):Promise<string[]>;
 /** Run active transactional mutation guards before any item or history write. */
-export declare function runActiveBeforeMutationHooks(context: BeforeMutationHookContext): Promise<void>;
+export declare function runActiveBeforeMutationHooks(context:BeforeMutationHookContext):Promise<void>;
 /** Implements run active on read hooks for the public runtime surface of this module. */
-export declare function runActiveOnReadHooks(context: OnReadHookContext): Promise<string[]>;
+export declare function runActiveOnReadHooks(context:OnReadHookContext):Promise<string[]>;
 /** Synchronous fast-path predicate: true only when at least one onRead hook is registered. Bulk readers (e.g. the metadata cache scanning hundreds of files) use this to skip per-file `await runActiveOnReadHooks(...)` calls entirely when no extension observes reads, avoiding hundreds of needless microtasks. */
-export declare function hasActiveOnReadHooks(): boolean;
+export declare function hasActiveOnReadHooks():boolean;
 /** Implements run active on index hooks for the public runtime surface of this module. */
-export declare function runActiveOnIndexHooks(context: OnIndexHookContext): Promise<string[]>;
+export declare function runActiveOnIndexHooks(context:OnIndexHookContext):Promise<string[]>;
 /** Implements run active command override for the public runtime surface of this module. */
-export declare function runActiveCommandOverride(result: unknown): CommandOverrideResult;
+export declare function runActiveCommandOverride(result:unknown):CommandOverrideResult;
 /** Implements run active command handler for the public runtime surface of this module. */
-export declare function runActiveCommandHandler(context: CommandHandlerContext): Promise<CommandHandlerResult>;
+export declare function runActiveCommandHandler(context:CommandHandlerContext):Promise<CommandHandlerResult>;
 /** Implements run active parser override for the public runtime surface of this module. */
-export declare function runActiveParserOverride(context: ParserOverrideContext): Promise<ParserOverrideResult>;
+export declare function runActiveParserOverride(context:ParserOverrideContext):Promise<ParserOverrideResult>;
 /** Implements run active preflight override for the public runtime surface of this module. */
-export declare function runActivePreflightOverride(context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
+export declare function runActivePreflightOverride(context:PreflightOverrideContext):Promise<PreflightOverrideResult>;
 /** Implements run active renderer override for the public runtime surface of this module. */
-export declare function runActiveRendererOverride(format: OutputRendererFormat, result: unknown): RendererOverrideResult;
+export declare function runActiveRendererOverride(format:OutputRendererFormat,result:unknown):RendererOverrideResult;
 /** Implements run active service override for the public runtime surface of this module. */
-export declare function runActiveServiceOverride(service: ExtensionServiceName, payload: unknown): Promise<ServiceOverrideResult>;
+export declare function runActiveServiceOverride(service:ExtensionServiceName,payload:unknown):Promise<ServiceOverrideResult>;
 /** Implements run active service override sync for the public runtime surface of this module. */
-export declare function runActiveServiceOverrideSync(service: ExtensionServiceName, payload: unknown): ServiceOverrideResult;
+export declare function runActiveServiceOverrideSync(service:ExtensionServiceName,payload:unknown):ServiceOverrideResult;
 export * from "./loader.js";
 export * from "./command-hook-context.js";
 export { createSerialQueue } from "../shared/serial-queue.js";
-export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, type CollectUsedExtensionCapabilitiesOptions, type ExtensionCapabilityUsageReconciliation, } from "./capability-usage.js";
+export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES,collectUsedExtensionCapabilities,reconcileExtensionCapabilityUsage,type CollectUsedExtensionCapabilitiesOptions,type ExtensionCapabilityUsageReconciliation,} from "./capability-usage.js";

package/dist/core/extensions/item-field-types.d.ts

@@ -6,10 +6,10 @@ import { type RuntimeFieldType } from "../../types/index.js";
  * value is later coerced by that kind (see `coerceRegisteredFieldValue`). Keep
  * this list in lock-step with the coercion switch in `item-fields.ts`.
  */
-export declare const KNOWN_ITEM_FIELD_TYPES: readonly ["string", "number", "boolean", "string_array", "array", "object"];
+export declare const KNOWN_ITEM_FIELD_TYPES:readonly ["string","number","boolean","string_array","array","object"];
 /** Restricts known item field type values accepted by command, SDK, and storage contracts. */
 export type KnownItemFieldType = RuntimeFieldType;
 /** Normalize a declared field type to its canonical kind, or `null` when the value is not a known type. Matching is trim- and case-insensitive. */
-export declare function normalizeItemFieldType(value: string): KnownItemFieldType | null;
+export declare function normalizeItemFieldType(value:string):KnownItemFieldType | null;
 /** Suggest a known field type for a typo'd declaration (e.g. `"strnig"` -> `"string"`), using the shared OSA Damerau–Levenshtein helper so adjacent transpositions count as a single edit. Returns the first canonical type within the proportional edit budget (in declaration order — the kinds are distinct enough that at most one matches), or `null` when nothing is close enough. */
-export declare function suggestKnownItemFieldType(value: string): KnownItemFieldType | null;
+export declare function suggestKnownItemFieldType(value:string):KnownItemFieldType | null;

package/dist/core/extensions/item-fields.d.ts

@@ -6,17 +6,17 @@
 import type { ExtensionRegistrationRegistry } from "./loader.js";
 import { type PmCliErrorContext } from "../shared/errors.js";
 /** Item metadata keys extension-provided fields may never shadow, exposed without mutation methods. */
-export declare const RESERVED_ITEM_FIELD_NAMES: ReadonlySet<string>;
+export declare const RESERVED_ITEM_FIELD_NAMES:ReadonlySet<string>;
 /** Implements collect registered item field names for the public runtime surface of this module. */
-export declare function collectRegisteredItemFieldNames(registrations: ExtensionRegistrationRegistry | null): string[];
+export declare function collectRegisteredItemFieldNames(registrations:ExtensionRegistrationRegistry | null):string[];
 /**
  * Parse typed assignments using active extension declarations into a new object.
  * Reserved keys name their dedicated core flags; unknown keys identify the
  * rejected input separately from legal registered keys. Parsing never writes
  * tracker state, so a failed assignment cannot persist partial metadata.
  */
-export declare function parseRegisteredItemFieldAssignments(rawFields: string[] | undefined, registrations: ExtensionRegistrationRegistry | null, resolveCoreFieldRecovery?: (field: string) => Pick<PmCliErrorContext, "recovery" | "nextSteps">): Record<string, unknown>;
+export declare function parseRegisteredItemFieldAssignments(rawFields:string[] | undefined,registrations:ExtensionRegistrationRegistry | null,resolveCoreFieldRecovery?:(field:string) => Pick<PmCliErrorContext,"recovery" | "nextSteps">):Record<string,unknown>;
 /** Implements apply registered item field defaults and validation for the public runtime surface of this module. */
-export declare function applyRegisteredItemFieldDefaultsAndValidation(itemMetadata: Record<string, unknown>, registrations: ExtensionRegistrationRegistry | null, options?: {
-skipDefaultFields?: ReadonlySet<string>;
-}): void;
+export declare function applyRegisteredItemFieldDefaultsAndValidation(itemMetadata:Record<string,unknown>,registrations:ExtensionRegistrationRegistry | null,options?:{
+skipDefaultFields?:ReadonlySet<string>;
+}):void;

package/dist/core/extensions/loader.d.ts

@@ -1,40 +1,40 @@
 import { type NormalizedExtensionPolicy } from "./extension-policy.js";
-import { type DiscoverExtensionsOptions, type EffectiveExtension, type ExtensionActivationResult, type ExtensionApi, type ExtensionCommandRegistry, type ExtensionDeactivationOptions, type ExtensionDeactivationResult, type ExtensionDiscoveryResult, type ExtensionHookRegistry, type ExtensionLayer, type ExtensionLoadResult, type ExtensionManifest, type ExtensionParserRegistry, type ExtensionPreflightRegistry, type ExtensionRegistrationCounts, type ExtensionRegistrationRegistry, type ExtensionRendererRegistry, type ExtensionServiceRegistry, type FailedExtensionActivation, type LoadedExtension, type PmMaxVersionExceededMode } from "./extension-types.js";
+import { type DiscoverExtensionsOptions,type EffectiveExtension,type ExtensionActivationResult,type ExtensionApi,type ExtensionCommandRegistry,type ExtensionDeactivationOptions,type ExtensionDeactivationResult,type ExtensionDiscoveryResult,type ExtensionHookRegistry,type ExtensionLayer,type ExtensionLoadResult,type ExtensionManifest,type ExtensionParserRegistry,type ExtensionPreflightRegistry,type ExtensionRegistrationCounts,type ExtensionRegistrationRegistry,type ExtensionRendererRegistry,type ExtensionServiceRegistry,type FailedExtensionActivation,type LoadedExtension,type PmMaxVersionExceededMode } from "./extension-types.js";
 import { parseExtensionManifestDocument } from "./manifest-parser.js";
-import { assertFlagValueTypeAndDefault, normalizeCommandDefinitionArguments, resolveCommandDefinitionAction, validateItemFieldDefinitions } from "./registration-contracts.js";
-import { assertOptionalStringField, normalizeOptionalStringArrayField } from "./registration-validation.js";
-import { createRegistrationValidationError, extractRegistrationValidationTrace, normalizeRegistrationRecord, normalizeRegistrationRecordList, normalizeRuntimeRegistrationRecord, sanitizeRegistrationValue } from "./registration-values.js";
-import { compareComparableVersions, parseComparableVersion } from "./version-compat.js";
-export { parseLegacyExtensionCapabilityAliasWarning, parseUnknownExtensionCapabilityWarning } from "./extension-capability-aliases.js";
-export { createEmptyExtensionCommandRegistry, createEmptyExtensionHookRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionRegistrationRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionServiceRegistry } from "./extension-registries.js";
-export { runAfterCommandHooks, runBeforeCommandHooks, runBeforeMutationHooks, runCommandHandler, runCommandOverride, runOnIndexHooks, runOnReadHooks, runOnWriteHooks, runParserOverride, runPreflightOverride, runRendererOverride, runServiceOverride, runServiceOverrideSync } from "./extension-hook-runtime.js";
+import { assertFlagValueTypeAndDefault,normalizeCommandDefinitionArguments,resolveCommandDefinitionAction,validateItemFieldDefinitions } from "./registration-contracts.js";
+import { assertOptionalStringField,normalizeOptionalStringArrayField } from "./registration-validation.js";
+import { createRegistrationValidationError,extractRegistrationValidationTrace,normalizeRegistrationRecord,normalizeRegistrationRecordList,normalizeRuntimeRegistrationRecord,sanitizeRegistrationValue } from "./registration-values.js";
+import { compareComparableVersions,parseComparableVersion } from "./version-compat.js";
+export { parseLegacyExtensionCapabilityAliasWarning,parseUnknownExtensionCapabilityWarning } from "./extension-capability-aliases.js";
+export { createEmptyExtensionCommandRegistry,createEmptyExtensionHookRegistry,createEmptyExtensionParserRegistry,createEmptyExtensionPreflightRegistry,createEmptyExtensionRegistrationRegistry,createEmptyExtensionRendererRegistry,createEmptyExtensionServiceRegistry } from "./extension-registries.js";
+export { runAfterCommandHooks,runBeforeCommandHooks,runBeforeMutationHooks,runCommandHandler,runCommandOverride,runOnIndexHooks,runOnReadHooks,runOnWriteHooks,runParserOverride,runPreflightOverride,runRendererOverride,runServiceOverride,runServiceOverrideSync } from "./extension-hook-runtime.js";
 export * from "./extension-types.js";
-export { DEFAULT_EXTENSION_PRIORITY, parseExtensionManifestDocument } from "./manifest-parser.js";
+export { DEFAULT_EXTENSION_PRIORITY,parseExtensionManifestDocument } from "./manifest-parser.js";
 /** Implements next extension reload token for the public runtime surface of this module. */
-export declare function nextExtensionReloadToken(seed?: number): string;
+export declare function nextExtensionReloadToken(seed?:number):string;
 /** Resolve symlinks on both paths before the containment check so a link inside the directory cannot escape it. */
-export declare function isCanonicalPathWithinDirectory(directory: string, targetPath: string): Promise<boolean>;
+export declare function isCanonicalPathWithinDirectory(directory:string,targetPath:string):Promise<boolean>;
 /** Implements resolve extension roots for the public runtime surface of this module. */
-export declare function resolveExtensionRoots(pmRoot: string, cwd?: string): {
-global: string;
-project: string;
+export declare function resolveExtensionRoots(pmRoot:string,cwd?:string):{
+global:string;
+project:string;
 };
 /** Implements discover extensions for the public runtime surface of this module. */
-export declare function discoverExtensions(options: DiscoverExtensionsOptions): Promise<ExtensionDiscoveryResult>;
-declare function readCurrentPmCliVersion(): Promise<string | null>;
-declare function resolveCurrentPmCliVersion(): Promise<string | null>;
-declare function evaluatePmMinVersionCompatibility(layer: ExtensionLayer, manifest: ExtensionManifest): Promise<{
-allowed: boolean;
-warning?: string;
+export declare function discoverExtensions(options:DiscoverExtensionsOptions):Promise<ExtensionDiscoveryResult>;
+declare function readCurrentPmCliVersion():Promise<string | null>;
+declare function resolveCurrentPmCliVersion():Promise<string | null>;
+declare function evaluatePmMinVersionCompatibility(layer:ExtensionLayer,manifest:ExtensionManifest):Promise<{
+allowed:boolean;
+warning?:string;
 }>;
-declare function evaluatePmMaxVersionCompatibility(layer: ExtensionLayer, manifest: ExtensionManifest, exceededMode: PmMaxVersionExceededMode): Promise<{
-allowed: boolean;
-warning?: string;
+declare function evaluatePmMaxVersionCompatibility(layer:ExtensionLayer,manifest:ExtensionManifest,exceededMode:PmMaxVersionExceededMode):Promise<{
+allowed:boolean;
+warning?:string;
 }>;
-declare function fingerprintPath(pathToInspect: string): Promise<string>;
-declare function resolveExtensionImportHref(extension: EffectiveExtension, options: DiscoverExtensionsOptions): Promise<string>;
+declare function fingerprintPath(pathToInspect:string):Promise<string>;
+declare function resolveExtensionImportHref(extension:EffectiveExtension,options:DiscoverExtensionsOptions):Promise<string>;
 /** Implements load extensions for the public runtime surface of this module. */
-export declare function loadExtensions(options: DiscoverExtensionsOptions): Promise<ExtensionLoadResult>;
+export declare function loadExtensions(options:DiscoverExtensionsOptions):Promise<ExtensionLoadResult>;
 /**
  * Run the optional `deactivate` teardown hook for every loaded extension that
  * exports one. Best-effort: a throwing teardown is captured as a warning and a
@@ -49,46 +49,46 @@ export declare function loadExtensions(options: DiscoverExtensionsOptions): Prom
  * indefinitely unless the host explicitly disables the timeout; the returned
  * warnings/failures preserve loaded order.
  */
-export declare function deactivateExtensions(loadResult: ExtensionLoadResult, activationResult?: Pick<ExtensionActivationResult, "failed">, options?: ExtensionDeactivationOptions): Promise<ExtensionDeactivationResult>;
-declare function normalizeExtensionDeactivateTimeout(rawTimeout: unknown): number;
-declare function createExtensionApi(extension: LoadedExtension, hooks: ExtensionHookRegistry, commands: ExtensionCommandRegistry, parsers: ExtensionParserRegistry, preflight: ExtensionPreflightRegistry, services: ExtensionServiceRegistry, renderers: ExtensionRendererRegistry, registrations: ExtensionRegistrationRegistry, activationWarnings: string[], activationFailures: FailedExtensionActivation[], policy: NormalizedExtensionPolicy): ExtensionApi;
-declare function getRegistrationCounts(registrations: ExtensionRegistrationRegistry): ExtensionRegistrationCounts;
-declare function collectCommandCollisionWarnings(commands: ExtensionCommandRegistry): string[];
-declare function collectRendererCollisionWarnings(renderers: ExtensionRendererRegistry): string[];
-declare function collectParserCollisionWarnings(parsers: ExtensionParserRegistry): string[];
-declare function collectServiceCollisionWarnings(services: ExtensionServiceRegistry): string[];
+export declare function deactivateExtensions(loadResult:ExtensionLoadResult,activationResult?:Pick<ExtensionActivationResult,"failed">,options?:ExtensionDeactivationOptions):Promise<ExtensionDeactivationResult>;
+declare function normalizeExtensionDeactivateTimeout(rawTimeout:unknown):number;
+declare function createExtensionApi(extension:LoadedExtension,hooks:ExtensionHookRegistry,commands:ExtensionCommandRegistry,parsers:ExtensionParserRegistry,preflight:ExtensionPreflightRegistry,services:ExtensionServiceRegistry,renderers:ExtensionRendererRegistry,registrations:ExtensionRegistrationRegistry,activationWarnings:string[],activationFailures:FailedExtensionActivation[],policy:NormalizedExtensionPolicy):ExtensionApi;
+declare function getRegistrationCounts(registrations:ExtensionRegistrationRegistry):ExtensionRegistrationCounts;
+declare function collectCommandCollisionWarnings(commands:ExtensionCommandRegistry):string[];
+declare function collectRendererCollisionWarnings(renderers:ExtensionRendererRegistry):string[];
+declare function collectParserCollisionWarnings(parsers:ExtensionParserRegistry):string[];
+declare function collectServiceCollisionWarnings(services:ExtensionServiceRegistry):string[];
 /** Implements activate extensions for the public runtime surface of this module. */
-export declare function activateExtensions(loadResult: ExtensionLoadResult): Promise<ExtensionActivationResult>;
+export declare function activateExtensions(loadResult:ExtensionLoadResult):Promise<ExtensionActivationResult>;
 /** Public contract for test only loader, shared by SDK and presentation-layer consumers. */
-export declare const _testOnlyLoader: {
-assertFlagValueTypeAndDefault: typeof assertFlagValueTypeAndDefault;
-assertOptionalStringField: typeof assertOptionalStringField;
-compareComparableVersions: typeof compareComparableVersions;
-collectCommandCollisionWarnings: typeof collectCommandCollisionWarnings;
-collectParserCollisionWarnings: typeof collectParserCollisionWarnings;
-collectRendererCollisionWarnings: typeof collectRendererCollisionWarnings;
-collectServiceCollisionWarnings: typeof collectServiceCollisionWarnings;
-createExtensionApi: typeof createExtensionApi;
-createRegistrationValidationError: typeof createRegistrationValidationError;
-evaluatePmMaxVersionCompatibility: typeof evaluatePmMaxVersionCompatibility;
-evaluatePmMinVersionCompatibility: typeof evaluatePmMinVersionCompatibility;
-extractRegistrationValidationTrace: typeof extractRegistrationValidationTrace;
-fingerprintPath: typeof fingerprintPath;
-getRegistrationCounts: typeof getRegistrationCounts;
-normalizeCommandDefinitionArguments: typeof normalizeCommandDefinitionArguments;
-normalizeExtensionDeactivateTimeout: typeof normalizeExtensionDeactivateTimeout;
-normalizeOptionalStringArrayField: typeof normalizeOptionalStringArrayField;
-normalizeRegistrationRecord: typeof normalizeRegistrationRecord;
-normalizeRegistrationRecordList: typeof normalizeRegistrationRecordList;
-normalizeRuntimeRegistrationRecord: typeof normalizeRuntimeRegistrationRecord;
-parseComparableVersion: typeof parseComparableVersion;
-parseManifest: typeof parseExtensionManifestDocument;
-readCurrentPmCliVersion: typeof readCurrentPmCliVersion;
-readManagedExtensionSourcePackages: (extensionsRoot: string) => Promise<Map<string, string>>;
-resolveExtensionImportHref: typeof resolveExtensionImportHref;
-resolveCurrentPmCliVersion: typeof resolveCurrentPmCliVersion;
-resolveCommandDefinitionAction: typeof resolveCommandDefinitionAction;
-sanitizeRegistrationValue: typeof sanitizeRegistrationValue;
-validateItemFieldDefinitions: typeof validateItemFieldDefinitions;
-resetCurrentPmCliVersionCacheForTest: () => void;
+export declare const _testOnlyLoader:{
+assertFlagValueTypeAndDefault:typeof assertFlagValueTypeAndDefault;
+assertOptionalStringField:typeof assertOptionalStringField;
+compareComparableVersions:typeof compareComparableVersions;
+collectCommandCollisionWarnings:typeof collectCommandCollisionWarnings;
+collectParserCollisionWarnings:typeof collectParserCollisionWarnings;
+collectRendererCollisionWarnings:typeof collectRendererCollisionWarnings;
+collectServiceCollisionWarnings:typeof collectServiceCollisionWarnings;
+createExtensionApi:typeof createExtensionApi;
+createRegistrationValidationError:typeof createRegistrationValidationError;
+evaluatePmMaxVersionCompatibility:typeof evaluatePmMaxVersionCompatibility;
+evaluatePmMinVersionCompatibility:typeof evaluatePmMinVersionCompatibility;
+extractRegistrationValidationTrace:typeof extractRegistrationValidationTrace;
+fingerprintPath:typeof fingerprintPath;
+getRegistrationCounts:typeof getRegistrationCounts;
+normalizeCommandDefinitionArguments:typeof normalizeCommandDefinitionArguments;
+normalizeExtensionDeactivateTimeout:typeof normalizeExtensionDeactivateTimeout;
+normalizeOptionalStringArrayField:typeof normalizeOptionalStringArrayField;
+normalizeRegistrationRecord:typeof normalizeRegistrationRecord;
+normalizeRegistrationRecordList:typeof normalizeRegistrationRecordList;
+normalizeRuntimeRegistrationRecord:typeof normalizeRuntimeRegistrationRecord;
+parseComparableVersion:typeof parseComparableVersion;
+parseManifest:typeof parseExtensionManifestDocument;
+readCurrentPmCliVersion:typeof readCurrentPmCliVersion;
+readManagedExtensionSourcePackages:(extensionsRoot:string) => Promise<Map<string,string>>;
+resolveExtensionImportHref:typeof resolveExtensionImportHref;
+resolveCurrentPmCliVersion:typeof resolveCurrentPmCliVersion;
+resolveCommandDefinitionAction:typeof resolveCommandDefinitionAction;
+sanitizeRegistrationValue:typeof sanitizeRegistrationValue;
+validateItemFieldDefinitions:typeof validateItemFieldDefinitions;
+resetCurrentPmCliVersionCacheForTest:() => void;
 };

package/dist/core/extensions/manifest-parser.d.ts

@@ -2,4 +2,4 @@ import { type ExtensionManifest } from "./extension-types.js";
 /** Fallback extension priority used when callers do not provide an override. */
 export declare const DEFAULT_EXTENSION_PRIORITY = 100;
 /** Parse and normalize one complete on-disk extension manifest contract. */
-export declare function parseExtensionManifestDocument(raw: unknown): ExtensionManifest | null;
+export declare function parseExtensionManifestDocument(raw:unknown):ExtensionManifest | null;

package/dist/core/extensions/manifest-schema.d.ts

@@ -4,37 +4,37 @@
  * Defines the closed extension-manifest key vocabulary and returns pure schema
  * diagnostics shared by SDK authoring checks and runtime discovery.
  */
-import type { ExtensionLayer, ExtensionManifest } from "./extension-types.js";
+import type { ExtensionLayer,ExtensionManifest } from "./extension-types.js";
 /** Canonical top-level keys accepted by an extension `manifest.json`. */
-export declare const KNOWN_EXTENSION_MANIFEST_KEYS: Set<string>;
+export declare const KNOWN_EXTENSION_MANIFEST_KEYS:Set<string>;
 /** Pure closed-schema inspection result for one raw extension manifest. */
 export interface ExtensionManifestSchemaInspection {
 /** Unknown top-level keys in deterministic lexical order. */
-unknownKeys: string[];
+unknownKeys:string[];
 /** Whether neither canonical pm compatibility bound is present. */
-missingVersionBounds: boolean;
+missingVersionBounds:boolean;
 }
 /** Stable machine-readable schema finding emitted by author-time lint. */
 export interface ExtensionManifestSchemaFinding {
 /** Schema condition an author must review. */
-code: "manifest_unknown_key" | "no_version_bounds_declared";
+code:"manifest_unknown_key" | "no_version_bounds_declared";
 /** JSON-style manifest location responsible for the finding. */
-path: string;
+path:string;
 /** Canonical key to use when the mistaken or missing field has one. */
-suggested_key?: "pm_min_version" | "pm_max_version";
+suggested_key?:"pm_min_version" | "pm_max_version";
 /** Actionable explanation of the ignored or missing declaration. */
-message: string;
+message:string;
 }
 /** Pure schema-lint result for one raw extension manifest. */
 export interface ExtensionManifestSchemaLintResult {
 /** False when at least one author-facing schema finding is present. */
-ok: boolean;
+ok:boolean;
 /** Deterministically ordered schema findings. */
-findings: ExtensionManifestSchemaFinding[];
+findings:ExtensionManifestSchemaFinding[];
 }
 /** Inspect raw manifest keys without parsing, loading, or mutating an extension. */
-export declare function inspectExtensionManifestSchema(manifest: Readonly<Record<string, unknown>>): ExtensionManifestSchemaInspection;
+export declare function inspectExtensionManifestSchema(manifest:Readonly<Record<string,unknown>>):ExtensionManifestSchemaInspection;
 /** Lint raw extension-manifest keys without loading code or evaluating versions. */
-export declare function lintExtensionManifestSchema(manifest: Readonly<Record<string, unknown>>): ExtensionManifestSchemaLintResult;
+export declare function lintExtensionManifestSchema(manifest:Readonly<Record<string,unknown>>):ExtensionManifestSchemaLintResult;
 /** Format runtime discovery warnings for unknown keys and absent canonical compatibility bounds. */
-export declare function formatExtensionManifestSchemaWarnings(layer: ExtensionLayer, manifest: ExtensionManifest, rawManifest: Readonly<Record<string, unknown>>): string[];
+export declare function formatExtensionManifestSchemaWarnings(layer:ExtensionLayer,manifest:ExtensionManifest,rawManifest:Readonly<Record<string,unknown>>):string[];

package/dist/core/extensions/module-graph-snapshot.d.ts

@@ -1,13 +1,13 @@
 /** Extension paths and identity required to create a complete graph snapshot. */
 export interface ExtensionModuleGraphSnapshotSource {
 /** Extension precedence layer used to keep snapshot directories distinct. */
-layer: string;
+layer:string;
 /** Extension directory identifier used to keep snapshot directories distinct. */
-directory: string;
+directory:string;
 /** Absolute path to the extension manifest inside its source directory. */
-manifest_path: string;
+manifest_path:string;
 /** Absolute path to the extension entry module. */
-entry_path: string;
+entry_path:string;
 }
 /**
  * Copy an extension directory into a fresh graph root and return its entry path.
@@ -16,4 +16,4 @@ entry_path: string;
  * absolute URL, preventing a same-process install verification from reusing
  * stale ESM cache entries.
  */
-export declare function snapshotExtensionModuleGraph(snapshotRoot: string, extension: ExtensionModuleGraphSnapshotSource): Promise<string>;
+export declare function snapshotExtensionModuleGraph(snapshotRoot:string,extension:ExtensionModuleGraphSnapshotSource):Promise<string>;

package/dist/core/extensions/preflight-ownership.d.ts

@@ -1,5 +1,5 @@
-import type { ExtensionPreflightRegistry, PreflightOverride, RegisteredExtensionPreflightOverride, ScopedPreflightOverrideDefinition } from "./extension-types.js";
+import type { ExtensionPreflightRegistry,PreflightOverride,RegisteredExtensionPreflightOverride,ScopedPreflightOverrideDefinition } from "./extension-types.js";
 /** Normalize one callback or scoped definition into a registered handler payload. */
-export declare function normalizePreflightOverride(override: PreflightOverride | ScopedPreflightOverrideDefinition): Pick<RegisteredExtensionPreflightOverride, "run" | "commands">;
+export declare function normalizePreflightOverride(override:PreflightOverride | ScopedPreflightOverrideDefinition):Pick<RegisteredExtensionPreflightOverride,"run" | "commands">;
 /** Report pairwise overlap while permitting disjoint scoped ownership. */
-export declare function collectPreflightCollisionWarnings(preflight: ExtensionPreflightRegistry): string[];
+export declare function collectPreflightCollisionWarnings(preflight:ExtensionPreflightRegistry):string[];

package/dist/core/extensions/read-output-contract.d.ts

@@ -1,5 +1,5 @@
 import type { ExtensionCommandReadOutput } from "./extension-types.js";
 /** Reject malformed, ambiguous or unsafe row declarations and retain an immutable snapshot. */
-export declare function normalizeExtensionReadOutput(value: unknown, command?: string, action?: string): ExtensionCommandReadOutput | undefined;
+export declare function normalizeExtensionReadOutput(value:unknown,command?:string,action?:string):ExtensionCommandReadOutput | undefined;
 /** Preserve native dispatch authority when packages declare custom read commands. */
-export declare function isNativeExtensionOutputCommand(command: string): boolean;
+export declare function isNativeExtensionOutputCommand(command:string):boolean;

package/dist/core/extensions/registration-contracts.d.ts

@@ -3,25 +3,25 @@
  * Validates contributed command, flag, schema and profile definitions before registration.
  */
 import type { ProjectProfileDefinition } from "../profile/profile-presets.js";
-import { type ExtensionCommandArgumentDefinition, type FlagDefinition } from "./extension-types.js";
+import { type ExtensionCommandArgumentDefinition,type FlagDefinition } from "./extension-types.js";
 /** Normalize registration records and expand the repeatable alias into the canonical list flag property. */
-declare function normalizeFlagDefinitions(name: string, value: unknown): FlagDefinition[];
+declare function normalizeFlagDefinitions(name:string,value:unknown):FlagDefinition[];
 /** Derive an action from the command path or reject an invalid explicit action before registration. */
-declare function resolveCommandDefinitionAction(commandPath: string, action: unknown): string;
+declare function resolveCommandDefinitionAction(commandPath:string,action:unknown):string;
 /** Validate positional argument records and enforce that at most one variadic argument appears last. */
-declare function normalizeCommandDefinitionArguments(value: unknown): ExtensionCommandArgumentDefinition[];
+declare function normalizeCommandDefinitionArguments(value:unknown):ExtensionCommandArgumentDefinition[];
 /** Reject unknown flag properties, invalid tokens, inconsistent repeatability and defaults incompatible with the declared value type. */
-declare function validateFlagDefinitions(flags: unknown): void;
+declare function validateFlagDefinitions(flags:unknown):void;
 /** Reject a declared `value_type`/`type` that is not a known flag value kind, and a `default` whose value(s) would not cleanly coerce under that kind — so the typed-flag contract is enforced at registration instead of silently leaving an untyped value to surface at use time. */
-declare function assertFlagValueTypeAndDefault(label: string, record: Record<string, unknown>): void;
+declare function assertFlagValueTypeAndDefault(label:string,record:Record<string,unknown>):void;
 /** Validate custom field names and types, including typo guidance, before fields enter the runtime schema. */
-declare function validateItemFieldDefinitions(fields: unknown): void;
+declare function validateItemFieldDefinitions(fields:unknown):void;
 /** Check custom item type metadata, creation requirements and command option policies before registration. */
-declare function validateItemTypeDefinitions(types: unknown): void;
+declare function validateItemTypeDefinitions(types:unknown):void;
 /** Validate optional migration metadata and ensure a supplied migration runner is callable. */
-declare function validateMigrationDefinition(definition: unknown): void;
+declare function validateMigrationDefinition(definition:unknown):void;
 /** Reject malformed profile dimensions and entries before downstream planners dereference their schema properties. */
-declare function validateProjectProfileDefinition(profile: unknown): void;
+declare function validateProjectProfileDefinition(profile:unknown):void;
 /**
  * Fills an already-validated profile snapshot's optional surfaces — an absent
  * `summary` becomes an empty string and every omitted dimension an empty array —
@@ -30,5 +30,5 @@ declare function validateProjectProfileDefinition(profile: unknown): void;
  * validation on the cloned snapshot, so it only ever supplies missing defaults
  * and never has to coerce an invalid type (those are already rejected).
  */
-declare function applyProjectProfileDefaults(profile: Record<string, unknown>): ProjectProfileDefinition;
-export { applyProjectProfileDefaults, assertFlagValueTypeAndDefault, normalizeCommandDefinitionArguments, normalizeFlagDefinitions, resolveCommandDefinitionAction, validateFlagDefinitions, validateItemFieldDefinitions, validateItemTypeDefinitions, validateMigrationDefinition, validateProjectProfileDefinition };
+declare function applyProjectProfileDefaults(profile:Record<string,unknown>):ProjectProfileDefinition;
+export { applyProjectProfileDefaults,assertFlagValueTypeAndDefault,normalizeCommandDefinitionArguments,normalizeFlagDefinitions,resolveCommandDefinitionAction,validateFlagDefinitions,validateItemFieldDefinitions,validateItemTypeDefinitions,validateMigrationDefinition,validateProjectProfileDefinition };