@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/core/extensions/extension-types.d.ts

@@ -3,114 +3,114 @@
  *
  * Implements extension runtime contracts and governance for Extension Types.
  */
-import type { ExtensionPolicyOverrideSettings, ExtensionPolicySettings, ItemDocument, ItemMetadata, ItemStatus, PmSettings } from "../../types/index.js";
+import type { ExtensionPolicyOverrideSettings,ExtensionPolicySettings,ItemDocument,ItemMetadata,ItemStatus,PmSettings } from "../../types/index.js";
 import type { GlobalOptions } from "../shared/command-types.js";
-import type { ProjectProfileDefinition, ProjectProfileRegistrationInput } from "../profile/profile-presets.js";
-import type { RelationshipEdge, RelationshipGraph, RelationshipKindDefinition, RelationshipQueryOptions } from "../../sdk/relationships.js";
+import type { ProjectProfileDefinition,ProjectProfileRegistrationInput } from "../profile/profile-presets.js";
+import type { RelationshipEdge,RelationshipGraph,RelationshipKindDefinition,RelationshipQueryOptions } from "../../sdk/relationships.js";
 import type { RelationshipImpactAnalysis } from "../../sdk/relationship-analytics.js";
 import type { PmClient } from "../../sdk/runtime.js";
 import type { GetItemAtResult } from "../../sdk/history-read.js";
-import type { RelationshipEvent, RelationshipEventInput, RelationshipEventStore } from "../../sdk/relationship-history.js";
-import type { CommitWorkspaceTransactionOptions, WorkspaceTransactionCommitResult } from "../../sdk/workspace-transaction.js";
+import type { RelationshipEvent,RelationshipEventInput,RelationshipEventStore } from "../../sdk/relationship-history.js";
+import type { CommitWorkspaceTransactionOptions,WorkspaceTransactionCommitResult } from "../../sdk/workspace-transaction.js";
 import type { KnownItemFieldType } from "./item-field-types.js";
 import type { ExtensionCommandCapabilityFamily } from "./command-metadata-contract.js";
 export type { ExtensionCommandCapabilityFamily } from "./command-metadata-contract.js";
 /** Public contract for known extension capabilities, shared by SDK and presentation-layer consumers. */
-export declare const KNOWN_EXTENSION_CAPABILITIES: readonly ["commands", "renderers", "hooks", "schema", "importers", "search", "parser", "preflight", "services"];
+export declare const KNOWN_EXTENSION_CAPABILITIES:readonly ["commands","renderers","hooks","schema","importers","search","parser","preflight","services"];
 /** Restricts extension capability values accepted by command, SDK, and storage contracts. */
 export type ExtensionCapability = (typeof KNOWN_EXTENSION_CAPABILITIES)[number];
 /** Public contract for extension capability contract version, shared by SDK and presentation-layer consumers. */
 export declare const EXTENSION_CAPABILITY_CONTRACT_VERSION = 2;
 /** Public contract for extension capability legacy aliases, shared by SDK and presentation-layer consumers. */
-export declare const EXTENSION_CAPABILITY_LEGACY_ALIASES: Readonly<Record<string, ExtensionCapability>>;
+export declare const EXTENSION_CAPABILITY_LEGACY_ALIASES:Readonly<Record<string,ExtensionCapability>>;
 /** Public contract for extension capability contract, shared by SDK and presentation-layer consumers. */
-export declare const EXTENSION_CAPABILITY_CONTRACT: Readonly<{
-version: 2;
-capabilities: ("search" | "schema" | "commands" | "importers" | "renderers" | "hooks" | "parser" | "preflight" | "services")[];
-legacy_aliases: {
-[x: string]: "search" | "schema" | "commands" | "importers" | "renderers" | "hooks" | "parser" | "preflight" | "services";
+export declare const EXTENSION_CAPABILITY_CONTRACT:Readonly<{
+version:2;
+capabilities:("search" | "schema" | "commands" | "importers" | "renderers" | "hooks" | "parser" | "preflight" | "services")[];
+legacy_aliases:{
+[x:string]:"search" | "schema" | "commands" | "importers" | "renderers" | "hooks" | "parser" | "preflight" | "services";
 };
 }>;
 /** Public contract for known extension policy modes, shared by SDK and presentation-layer consumers. */
-export declare const KNOWN_EXTENSION_POLICY_MODES: readonly ["off", "warn", "enforce"];
+export declare const KNOWN_EXTENSION_POLICY_MODES:readonly ["off","warn","enforce"];
 /** Restricts extension policy mode values accepted by command, SDK, and storage contracts. */
 export type ExtensionPolicyMode = (typeof KNOWN_EXTENSION_POLICY_MODES)[number];
 /** Public contract for known extension trust modes, shared by SDK and presentation-layer consumers. */
-export declare const KNOWN_EXTENSION_TRUST_MODES: readonly ["off", "warn", "enforce"];
+export declare const KNOWN_EXTENSION_TRUST_MODES:readonly ["off","warn","enforce"];
 /** Restricts extension trust mode values accepted by command, SDK, and storage contracts. */
 export type ExtensionTrustMode = (typeof KNOWN_EXTENSION_TRUST_MODES)[number];
 /** Public contract for known extension sandbox profiles, shared by SDK and presentation-layer consumers. */
-export declare const KNOWN_EXTENSION_SANDBOX_PROFILES: readonly ["none", "restricted", "strict"];
+export declare const KNOWN_EXTENSION_SANDBOX_PROFILES:readonly ["none","restricted","strict"];
 /** Restricts extension sandbox profile values accepted by command, SDK, and storage contracts. */
 export type ExtensionSandboxProfile = (typeof KNOWN_EXTENSION_SANDBOX_PROFILES)[number];
 /** Public contract for known pm max version exceeded modes, shared by SDK and presentation-layer consumers. */
-export declare const KNOWN_PM_MAX_VERSION_EXCEEDED_MODES: readonly ["block", "warn"];
+export declare const KNOWN_PM_MAX_VERSION_EXCEEDED_MODES:readonly ["block","warn"];
 /** How a `pm_max_version` violation is handled for an extension layer. */
 export type PmMaxVersionExceededMode = (typeof KNOWN_PM_MAX_VERSION_EXCEEDED_MODES)[number];
 /** Optional per-layer override map for `extensions.policy.pm_max_version_exceeded_mode`. */
 export interface PmMaxVersionExceededModeByLayer {
 /** Value that configures or reports global for this contract. */
-global?: PmMaxVersionExceededMode;
+global?:PmMaxVersionExceededMode;
 /** Value that configures or reports project for this contract. */
-project?: PmMaxVersionExceededMode;
+project?:PmMaxVersionExceededMode;
 }
 /** Settings value for `extensions.policy.pm_max_version_exceeded_mode`: either a single mode applied to both layers, or a per-layer override map. Unset (and any unset layer key) defaults to `"block"`. */
 export type PmMaxVersionExceededModeSetting = PmMaxVersionExceededMode | PmMaxVersionExceededModeByLayer;
 /** Public contract for known extension policy surfaces, shared by SDK and presentation-layer consumers. */
-export declare const KNOWN_EXTENSION_POLICY_SURFACES: readonly ["commands.override", "commands.handler", "hooks.beforecommand", "hooks.beforemutation", "hooks.aftercommand", "hooks.onwrite", "hooks.onread", "hooks.onindex", "schema.flags", "schema.itemfields", "schema.itemtypes", "schema.relationshipkinds", "schema.migrations", "schema.profiles", "parser.override", "preflight.override", "services.override", "renderers.override", "importers.importer", "importers.exporter", "search.provider", "search.vectorstore", "services.assuranceprovider"];
+export declare const KNOWN_EXTENSION_POLICY_SURFACES:readonly ["commands.override","commands.handler","hooks.beforecommand","hooks.beforemutation","hooks.aftercommand","hooks.onwrite","hooks.onread","hooks.onindex","schema.flags","schema.itemfields","schema.itemtypes","schema.relationshipkinds","schema.migrations","schema.profiles","parser.override","preflight.override","services.override","renderers.override","importers.importer","importers.exporter","search.provider","search.vectorstore","services.assuranceprovider"];
 /** Restricts extension policy surface values accepted by command, SDK, and storage contracts. */
 export type ExtensionPolicySurface = (typeof KNOWN_EXTENSION_POLICY_SURFACES)[number];
 /** Public contract for known extension service names, shared by SDK and presentation-layer consumers. */
-export declare const KNOWN_EXTENSION_SERVICE_NAMES: readonly ["output_format", "error_format", "help_format", "lock_acquire", "lock_release", "history_append", "item_store_write", "item_store_delete", "context_relevance", "command_result"];
+export declare const KNOWN_EXTENSION_SERVICE_NAMES:readonly ["output_format","error_format","help_format","lock_acquire","lock_release","history_append","item_store_write","item_store_delete","context_relevance","command_result"];
 /** Restricts extension service name values accepted by command, SDK, and storage contracts. */
 export type ExtensionServiceName = (typeof KNOWN_EXTENSION_SERVICE_NAMES)[number];
 /** Documents the extension provenance metadata payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionProvenanceMetadata {
 /** Value that configures or reports source for this contract. */
-source?: string;
+source?:string;
 /** Value that configures or reports signature for this contract. */
-signature?: string;
+signature?:string;
 /** Value that configures or reports attestation for this contract. */
-attestation?: string;
+attestation?:string;
 /** Value that configures or reports verified for this contract. */
-verified?: boolean;
+verified?:boolean;
 }
 /** Documents the extension runtime permission declaration payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionRuntimePermissionDeclaration {
 /** Value that configures or reports fs read for this contract. */
-fs_read?: boolean;
+fs_read?:boolean;
 /** Value that configures or reports fs write for this contract. */
-fs_write?: boolean;
+fs_write?:boolean;
 /** Value that configures or reports network for this contract. */
-network?: boolean;
+network?:boolean;
 /** Value that configures or reports env read for this contract. */
-env_read?: boolean;
+env_read?:boolean;
 /** Value that configures or reports env write for this contract. */
-env_write?: boolean;
+env_write?:boolean;
 /** Value that configures or reports process spawn for this contract. */
-process_spawn?: boolean;
+process_spawn?:boolean;
 }
 /** Documents the extension activation metadata payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionActivationMetadata {
 /** Value that configures or reports commands for this contract. */
-commands?: string[];
+commands?:string[];
 }
 /** Restricts extension policy override values accepted by command, SDK, and storage contracts. */
 export type ExtensionPolicyOverride = ExtensionPolicyOverrideSettings;
 /** Extension governance policy as read from / serialized to settings. Extends the stored settings shape with `pm_max_version_exceeded_mode` (pm-k5e8), which relaxes the default-BLOCK on `pm_max_version` violations to warn-only — globally or per extension layer. */
 export type ExtensionGovernancePolicy = ExtensionPolicySettings & {
-pm_max_version_exceeded_mode?: PmMaxVersionExceededModeSetting;
+pm_max_version_exceeded_mode?:PmMaxVersionExceededModeSetting;
 };
 /** Documents the extension manifest engines payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionManifestEngines {
 /** Value that configures or reports pm for this contract. */
-pm?: string;
+pm?:string;
 /** Value that configures or reports node for this contract. */
-node?: string;
-[engine: string]: string | undefined;
+node?:string;
+[engine:string]:string | undefined;
 }
 /** Implements create default extension governance policy for the public runtime surface of this module. */
-export declare function createDefaultExtensionGovernancePolicy(): ExtensionGovernancePolicy;
+export declare function createDefaultExtensionGovernancePolicy():ExtensionGovernancePolicy;
 /** Restricts extension layer values accepted by command, SDK, and storage contracts. */
 export type ExtensionLayer = "global" | "project";
 /** Restricts extension status values accepted by command, SDK, and storage contracts. */
@@ -118,509 +118,509 @@ export type ExtensionStatus = "ok" | "warn";
 /** Static, serializable inventory of extension registrations available without importing its module. */
 export interface ExtensionContributionInventory {
 /** Inventory schema version for forward-compatible persisted snapshots. */
-schema_version: 1;
+schema_version:1;
 /** Declared command paths. */
-commands?: string[];
+commands?:string[];
 /** Built-in command override targets. */
-command_overrides?: string[];
+command_overrides?:string[];
 /** Command paths backed by extension handlers. */
-command_handlers?: string[];
+command_handlers?:string[];
 /** Lifecycle hook phases contributed by the extension. */
-hooks?: string[];
+hooks?:string[];
 /** Command paths receiving extension flags. */
-flag_commands?: string[];
+flag_commands?:string[];
 /** Declared custom item types. */
-item_types?: string[];
+item_types?:string[];
 /** Declared custom item fields. */
-item_fields?: string[];
+item_fields?:string[];
 /** Declared relationship kinds. */
-relationship_kinds?: string[];
+relationship_kinds?:string[];
 /** Declared schema migration identifiers. */
-migrations?: string[];
+migrations?:string[];
 /** Declared project profile names. */
-profiles?: string[];
+profiles?:string[];
 /** Declared importer names. */
-importers?: string[];
+importers?:string[];
 /** Declared exporter names. */
-exporters?: string[];
+exporters?:string[];
 /** Declared search-provider names. */
-search_providers?: string[];
+search_providers?:string[];
 /** Declared vector-store adapter names. */
-vector_store_adapters?: string[];
+vector_store_adapters?:string[];
 /** Declared assurance measurement-provider ids. */
-assurance_providers?: string[];
+assurance_providers?:string[];
 /** Parser override command targets. */
-parser_overrides?: string[];
+parser_overrides?:string[];
 /** Service override targets. */
-service_overrides?: string[];
+service_overrides?:string[];
 /** Renderer formats contributed by the extension. */
-renderer_overrides?: string[];
+renderer_overrides?:string[];
 /** Optional command ownership for renderer contributions. */
-renderer_ownership?: Array<{
+renderer_ownership?:Array<{
 /** Output format owned by this renderer. */
-format: OutputRendererFormat;
+format:OutputRendererFormat;
 /** Command paths on which the renderer may run. */
-commands: string[];
+commands:string[];
 /** Whether runtime result discrimination can select the renderer. */
-result_discriminator: boolean;
+result_discriminator:boolean;
 }>;
 /** Number of preflight overrides in the package. */
-preflight_overrides?: number;
+preflight_overrides?:number;
 /** Optional command ownership for each preflight override. Empty commands mean global ownership. */
-preflight_ownership?: Array<{
+preflight_ownership?:Array<{
 /** Command paths on which the override may run. */
-commands: string[];
+commands:string[];
 }>;
 }
 /** Documents the extension manifest payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionManifest {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports version for this contract. */
-version: string;
+version:string;
 /** Value that configures or reports entry for this contract. */
-entry: string;
+entry:string;
 /** Value that configures or reports priority for this contract. */
-priority: number;
+priority:number;
 /** Value that configures or reports capabilities for this contract. */
-capabilities: string[];
+capabilities:string[];
 /** Value that configures or reports manifest version for this contract. */
-manifest_version?: number;
+manifest_version?:number;
 /** Value that configures or reports pm min version for this contract. */
-pm_min_version?: string;
+pm_min_version?:string;
 /** Value that configures or reports pm max version for this contract. */
-pm_max_version?: string;
+pm_max_version?:string;
 /** Value that configures or reports engines for this contract. */
-engines?: ExtensionManifestEngines;
+engines?:ExtensionManifestEngines;
 /** Value that configures or reports trusted for this contract. */
-trusted?: boolean;
+trusted?:boolean;
 /** Value that configures or reports provenance for this contract. */
-provenance?: ExtensionProvenanceMetadata;
+provenance?:ExtensionProvenanceMetadata;
 /** Value that configures or reports sandbox profile for this contract. */
-sandbox_profile?: ExtensionSandboxProfile;
+sandbox_profile?:ExtensionSandboxProfile;
 /** Value that configures or reports permissions for this contract. */
-permissions?: ExtensionRuntimePermissionDeclaration;
+permissions?:ExtensionRuntimePermissionDeclaration;
 /** Value that configures or reports activation for this contract. */
-activation?: ExtensionActivationMetadata;
+activation?:ExtensionActivationMetadata;
 /** Static contribution inventory used by discovery before module import. */
-contributions?: ExtensionContributionInventory;
+contributions?:ExtensionContributionInventory;
 /** Value that configures or reports legacy capability aliases for this contract. */
-legacy_capability_aliases?: LegacyExtensionCapabilityAliasMapping[];
+legacy_capability_aliases?:LegacyExtensionCapabilityAliasMapping[];
 }
 /** Documents the extension diagnostic payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDiagnostic {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports directory for this contract. */
-directory: string;
+directory:string;
 /** Filesystem path used for manifest resolution. */
-manifest_path: string;
+manifest_path:string;
 /** Value that configures or reports name for this contract. */
-name: string | null;
+name:string | null;
 /** Value that configures or reports version for this contract. */
-version: string | null;
+version:string | null;
 /** Value that configures or reports entry for this contract. */
-entry: string | null;
+entry:string | null;
 /** Value that configures or reports priority for this contract. */
-priority: number | null;
+priority:number | null;
 /** Filesystem path used for entry resolution. */
-entry_path: string | null;
+entry_path:string | null;
 /** Whether enabled applies to this operation. */
-enabled: boolean | null;
+enabled:boolean | null;
 /** Lifecycle state reported for status. */
-status: ExtensionStatus;
+status:ExtensionStatus;
 }
 /** Documents the effective extension payload exchanged by command, SDK, and package integrations. */
 export interface EffectiveExtension {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports directory for this contract. */
-directory: string;
+directory:string;
 /** Filesystem path used for manifest resolution. */
-manifest_path: string;
+manifest_path:string;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports source package for this contract. */
-source_package?: string;
+source_package?:string;
 /** Install-source identities that can resolve this extension through package lifecycle commands. */
-source_aliases?: string[];
+source_aliases?:string[];
 /** Value that configures or reports version for this contract. */
-version: string;
+version:string;
 /** Value that configures or reports entry for this contract. */
-entry: string;
+entry:string;
 /** Value that configures or reports priority for this contract. */
-priority: number;
+priority:number;
 /** Filesystem path used for entry resolution. */
-entry_path: string;
+entry_path:string;
 /** Value that configures or reports manifest version for this contract. */
-manifest_version?: number;
+manifest_version?:number;
 /** Value that configures or reports pm min version for this contract. */
-pm_min_version?: string;
+pm_min_version?:string;
 /** Value that configures or reports pm max version for this contract. */
-pm_max_version?: string;
+pm_max_version?:string;
 /** Value that configures or reports engines for this contract. */
-engines?: ExtensionManifestEngines;
+engines?:ExtensionManifestEngines;
 /** Value that configures or reports trusted for this contract. */
-trusted?: boolean;
+trusted?:boolean;
 /** Value that configures or reports provenance for this contract. */
-provenance?: ExtensionProvenanceMetadata;
+provenance?:ExtensionProvenanceMetadata;
 /** Value that configures or reports sandbox profile for this contract. */
-sandbox_profile?: ExtensionSandboxProfile;
+sandbox_profile?:ExtensionSandboxProfile;
 /** Value that configures or reports permissions for this contract. */
-permissions?: ExtensionRuntimePermissionDeclaration;
+permissions?:ExtensionRuntimePermissionDeclaration;
 /** Value that configures or reports capabilities for this contract. */
-capabilities?: string[];
+capabilities?:string[];
 /** Value that configures or reports activation for this contract. */
-activation?: ExtensionActivationMetadata;
+activation?:ExtensionActivationMetadata;
 /** Static contribution inventory resolved from the manifest or install snapshot. */
-contributions?: ExtensionContributionInventory;
+contributions?:ExtensionContributionInventory;
 }
 /** Documents the extension discovery result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDiscoveryResult {
 /** Value that configures or reports disabled by flag for this contract. */
-disabled_by_flag: boolean;
+disabled_by_flag:boolean;
 /** Value that configures or reports roots for this contract. */
-roots: {
-global: string;
-project: string;
+roots:{
+global:string;
+project:string;
 };
 /** Value that configures or reports configured enabled for this contract. */
-configured_enabled: string[];
+configured_enabled:string[];
 /** Value that configures or reports configured disabled for this contract. */
-configured_disabled: string[];
+configured_disabled:string[];
 /** Value that configures or reports discovered for this contract. */
-discovered: ExtensionDiagnostic[];
+discovered:ExtensionDiagnostic[];
 /** Value that configures or reports effective for this contract. */
-effective: EffectiveExtension[];
+effective:EffectiveExtension[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports policy for this contract. */
-policy: ExtensionGovernancePolicy;
+policy:ExtensionGovernancePolicy;
 }
 /** Documents the loaded extension payload exchanged by command, SDK, and package integrations. */
 export interface LoadedExtension extends EffectiveExtension {
 /** Value that configures or reports module for this contract. */
-module: unknown;
+module:unknown;
 }
 /** Documents the failed extension load payload exchanged by command, SDK, and package integrations. */
 export interface FailedExtensionLoad {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Filesystem path used for entry resolution. */
-entry_path: string;
+entry_path:string;
 /** Value that configures or reports error for this contract. */
-error: string;
+error:string;
 }
 /** Documents the extension load result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionLoadResult extends ExtensionDiscoveryResult {
 /** Value that configures or reports loaded for this contract. */
-loaded: LoadedExtension[];
+loaded:LoadedExtension[];
 /** Value that configures or reports failed for this contract. */
-failed: FailedExtensionLoad[];
+failed:FailedExtensionLoad[];
 }
 /** Documents the before command hook context payload exchanged by command, SDK, and package integrations. */
 export interface BeforeCommandHookContext {
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports args for this contract. */
-args: string[];
+args:string[];
 /** Value that configures or reports options for this contract. */
-options?: Record<string, unknown>;
+options?:Record<string,unknown>;
 /** Value that configures or reports global for this contract. */
-global?: GlobalOptions;
+global?:GlobalOptions;
 /** Value that configures or reports pm root for this contract. */
-pm_root: string;
+pm_root:string;
 }
 /** Documents the after command hook context payload exchanged by command, SDK, and package integrations. */
 export interface AfterCommandHookContext extends BeforeCommandHookContext {
 /** Whether the operation completed without a blocking failure. */
-ok: boolean;
+ok:boolean;
 /** Value that configures or reports error for this contract. */
-error?: string;
+error?:string;
 /** Value that configures or reports result for this contract. */
-result?: unknown;
+result?:unknown;
 /** Value that configures or reports affected for this contract. */
-affected?: AfterCommandAffectedItem[];
+affected?:AfterCommandAffectedItem[];
 }
 /** Documents the after command affected item payload exchanged by command, SDK, and package integrations. */
 export interface AfterCommandAffectedItem {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports op for this contract. */
-op?: string;
+op?:string;
 /** Schema type that determines the shape and validation rules for this value. */
-item_type?: string;
+item_type?:string;
 /** Status id the item held before this mutation. */
-previous_status?: ItemStatus;
+previous_status?:ItemStatus;
 /** Lifecycle state reported for status. */
-status?: ItemStatus;
+status?:ItemStatus;
 /** Value that configures or reports previous for this contract. */
-previous?: Partial<ItemMetadata>;
+previous?:Partial<ItemMetadata>;
 /** Value that configures or reports current for this contract. */
-current?: Partial<ItemMetadata>;
+current?:Partial<ItemMetadata>;
 /** Value that configures or reports changed fields for this contract. */
-changed_fields?: string[];
+changed_fields?:string[];
 }
 /** Documents the on write hook context payload exchanged by command, SDK, and package integrations. */
 export interface OnWriteHookContext {
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports scope for this contract. */
-scope: "project" | "global";
+scope:"project" | "global";
 /** Value that configures or reports op for this contract. */
-op: string;
+op:string;
 /** Value that configures or reports item id for this contract. */
-item_id?: string;
+item_id?:string;
 /** Schema type that determines the shape and validation rules for this value. */
-item_type?: string;
+item_type?:string;
 /** Value that configures or reports before for this contract. */
-before?: ItemDocument;
+before?:ItemDocument;
 /** Value that configures or reports after for this contract. */
-after?: ItemDocument;
+after?:ItemDocument;
 /** Value that configures or reports changed fields for this contract. */
-changed_fields?: string[];
+changed_fields?:string[];
 }
 /** Read-only tracker services available while an extension evaluates a proposed mutation. */
 export interface ExtensionMutationGuardSdk {
 /** Read one item from the guard's host-bound tracker, or return null when it is absent. */
-get(id: string): Promise<{
-item: ItemMetadata;
-body: string;
+get(id:string):Promise<{
+item:ItemMetadata;
+body:string;
 } | null>;
 /** List item metadata from the guard's host-bound tracker. */
-list(): Promise<ItemMetadata[]>;
+list():Promise<ItemMetadata[]>;
 }
 /** Proposed item transition supplied before either the item or history artifact is persisted. */
 export interface BeforeMutationHookContext {
 /** Tracker root owning the transaction. */
-pm_root: string;
+pm_root:string;
 /** Stable mutation operation name such as create, update, close, delete, or restore. */
-operation: string;
+operation:string;
 /** Canonical item state before the mutation, or null for create. */
-before: ItemDocument | null;
+before:ItemDocument | null;
 /** Canonical proposed state after the mutation, or null for delete. */
-after: ItemDocument | null;
+after:ItemDocument | null;
 /** Canonical fields the transaction proposes to change. */
-changed_fields: readonly string[];
+changed_fields:readonly string[];
 /** Host-bound read-only SDK services. */
-sdk: ExtensionMutationGuardSdk;
+sdk:ExtensionMutationGuardSdk;
 }
 /** Stable decision returned by a transactional extension mutation guard. */
 export type BeforeMutationHookDecision = {
-allow: true;
+allow:true;
 } | {
-allow: false;
-code: string;
-message?: string;
-remediation: string;
+allow:false;
+code:string;
+message?:string;
+remediation:string;
 };
 /** A fail-closed hook evaluated inside the item lock before persistence. */
-export type BeforeMutationHook = (context: BeforeMutationHookContext) => Promise<BeforeMutationHookDecision | void> | BeforeMutationHookDecision | void;
+export type BeforeMutationHook = (context:BeforeMutationHookContext) => Promise<BeforeMutationHookDecision | void> | BeforeMutationHookDecision | void;
 /** Documents the on read hook context payload exchanged by command, SDK, and package integrations. */
 export interface OnReadHookContext {
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports scope for this contract. */
-scope: "project" | "global";
+scope:"project" | "global";
 }
 /** Documents the on index hook context payload exchanged by command, SDK, and package integrations. */
 export interface OnIndexHookContext {
 /** Value that configures or reports mode for this contract. */
-mode: string;
+mode:string;
 /** Value that configures or reports total items for this contract. */
-total_items?: number;
+total_items?:number;
 }
 /** Restricts before command hook values accepted by command, SDK, and storage contracts. */
-export type BeforeCommandHook = (context: BeforeCommandHookContext) => Promise<void> | void;
+export type BeforeCommandHook = (context:BeforeCommandHookContext) => Promise<void> | void;
 /** Restricts after command hook values accepted by command, SDK, and storage contracts. */
-export type AfterCommandHook = (context: AfterCommandHookContext) => Promise<void> | void;
+export type AfterCommandHook = (context:AfterCommandHookContext) => Promise<void> | void;
 /** Restricts on write hook values accepted by command, SDK, and storage contracts. */
-export type OnWriteHook = (context: OnWriteHookContext) => Promise<void> | void;
+export type OnWriteHook = (context:OnWriteHookContext) => Promise<void> | void;
 /** Restricts on read hook values accepted by command, SDK, and storage contracts. */
-export type OnReadHook = (context: OnReadHookContext) => Promise<void> | void;
+export type OnReadHook = (context:OnReadHookContext) => Promise<void> | void;
 /** Restricts on index hook values accepted by command, SDK, and storage contracts. */
-export type OnIndexHook = (context: OnIndexHookContext) => Promise<void> | void;
+export type OnIndexHook = (context:OnIndexHookContext) => Promise<void> | void;
 /** Restricts output renderer format values accepted by command, SDK, and storage contracts. */
 export type OutputRendererFormat = "toon" | "json";
 /** Restricts command override values accepted by command, SDK, and storage contracts. */
-export type CommandOverride = (context: CommandOverrideContext) => unknown;
+export type CommandOverride = (context:CommandOverrideContext) => unknown;
 /** Restricts renderer override values accepted by command, SDK, and storage contracts. */
-export type RendererOverride = (context: RendererOverrideContext) => string | null | undefined;
+export type RendererOverride = (context:RendererOverrideContext) => string | null | undefined;
 /** Host-enforced ownership metadata that limits where a renderer override may run. */
 export interface RendererOverrideOwnership {
 /** Normalized command paths this renderer owns. An unrelated command never reaches the callback. */
-commands?: string[];
+commands?:string[];
 /** Optional result predicate evaluated before the renderer callback. A false result preserves native rendering. */
-resultDiscriminator?: (result: unknown) => boolean;
+resultDiscriminator?:(result:unknown) => boolean;
 }
 /** Declarative renderer definition combining a callback with host-enforced ownership. */
 export interface ScopedRendererOverrideDefinition extends RendererOverrideOwnership {
 /** Renderer callback invoked only after every declared ownership predicate matches. */
-run: RendererOverride;
+run:RendererOverride;
 }
 /** Restricts command handler values accepted by command, SDK, and storage contracts. */
-export type CommandHandler = (context: CommandHandlerContext) => unknown;
+export type CommandHandler = (context:CommandHandlerContext) => unknown;
 /** Restricts parser override values accepted by command, SDK, and storage contracts. */
-export type ParserOverride = (context: ParserOverrideContext) => ParserOverrideDelta | Promise<ParserOverrideDelta>;
+export type ParserOverride = (context:ParserOverrideContext) => ParserOverrideDelta | Promise<ParserOverrideDelta>;
 /** Restricts preflight override values accepted by command, SDK, and storage contracts. */
-export type PreflightOverride = (context: PreflightOverrideContext) => PreflightOverrideDelta | Promise<PreflightOverrideDelta>;
+export type PreflightOverride = (context:PreflightOverrideContext) => PreflightOverrideDelta | Promise<PreflightOverrideDelta>;
 /** Static ownership declaration used to select and diagnose preflight overrides. */
 export interface PreflightOverrideOwnership {
 /** Normalized command paths on which this preflight override may run. */
-commands?: string[];
+commands?:string[];
 }
 /** Declarative preflight override paired with statically inspectable ownership. */
 export interface ScopedPreflightOverrideDefinition extends PreflightOverrideOwnership {
 /** Preflight handler invoked only for a declared command, or globally when unscoped. */
-run: PreflightOverride;
+run:PreflightOverride;
 }
 /** Explicitly claims or declines one service payload without relying on object identity. */
 export type ServiceOverrideDecision = {
-handled: true;
-result: unknown;
+handled:true;
+result:unknown;
 } | {
-handled: false;
+handled:false;
 };
 /** Restricts service override values accepted by command, SDK, and storage contracts. */
-export type ServiceOverride = (context: ServiceOverrideContext) => unknown | ServiceOverrideDecision;
+export type ServiceOverride = (context:ServiceOverrideContext) => unknown | ServiceOverrideDecision;
 /** Host-enforced ownership metadata for a service override. */
 export interface ServiceOverrideOwnership {
 /** Declare that the callback may only decline. Any handled result is ignored and diagnosed by the host. */
-passThrough?: boolean;
+passThrough?:boolean;
 }
 /** Documents the registered extension hook payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionHook<THook> {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports run for this contract. */
-run: THook;
+run:THook;
 }
 /** Documents the extension hook registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionHookRegistry {
 /** Value that configures or reports before command for this contract. */
-beforeCommand: Array<RegisteredExtensionHook<BeforeCommandHook>>;
+beforeCommand:Array<RegisteredExtensionHook<BeforeCommandHook>>;
 /** Transactional guards fired before item and history persistence. */
-beforeMutation: Array<RegisteredExtensionHook<BeforeMutationHook>>;
+beforeMutation:Array<RegisteredExtensionHook<BeforeMutationHook>>;
 /** Value that configures or reports after command for this contract. */
-afterCommand: Array<RegisteredExtensionHook<AfterCommandHook>>;
+afterCommand:Array<RegisteredExtensionHook<AfterCommandHook>>;
 /** Value that configures or reports on write for this contract. */
-onWrite: Array<RegisteredExtensionHook<OnWriteHook>>;
+onWrite:Array<RegisteredExtensionHook<OnWriteHook>>;
 /** Value that configures or reports on read for this contract. */
-onRead: Array<RegisteredExtensionHook<OnReadHook>>;
+onRead:Array<RegisteredExtensionHook<OnReadHook>>;
 /** Value that configures or reports on index for this contract. */
-onIndex: Array<RegisteredExtensionHook<OnIndexHook>>;
+onIndex:Array<RegisteredExtensionHook<OnIndexHook>>;
 }
 /** Portable workspace coordinates supplied to every extension runtime surface. */
 export interface PortableWorkspaceContext {
 /** Immutable source workspace root, distinct from a sandboxed tracker root. */
-source_workspace_root?: string;
+source_workspace_root?:string;
 /** Source VCS repository root when one can be resolved. */
-repo_root?: string;
+repo_root?:string;
 /** POSIX tracker path relative to the source workspace when contained there. */
-pm_root_rel?: string;
+pm_root_rel?:string;
 }
 /** Documents the command override context payload exchanged by command, SDK, and package integrations. */
 export interface CommandOverrideContext extends PortableWorkspaceContext {
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports args for this contract. */
-args: string[];
+args:string[];
 /** Value that configures or reports options for this contract. */
-options?: Record<string, unknown>;
+options?:Record<string,unknown>;
 /** Value that configures or reports global for this contract. */
-global?: GlobalOptions;
+global?:GlobalOptions;
 /** Value that configures or reports pm root for this contract. */
-pm_root: string;
+pm_root:string;
 /** Value that configures or reports result for this contract. */
-result: unknown;
+result:unknown;
 }
 /** Documents the renderer override context payload exchanged by command, SDK, and package integrations. */
 export interface RendererOverrideContext extends Partial<PortableWorkspaceContext> {
 /** Value that configures or reports format for this contract. */
-format: OutputRendererFormat;
+format:OutputRendererFormat;
 /** Value that configures or reports command for this contract. */
-command?: string;
+command?:string;
 /** Value that configures or reports args for this contract. */
-args?: string[];
+args?:string[];
 /** Value that configures or reports options for this contract. */
-options?: Record<string, unknown>;
+options?:Record<string,unknown>;
 /** Value that configures or reports global for this contract. */
-global?: GlobalOptions;
+global?:GlobalOptions;
 /** Value that configures or reports pm root for this contract. */
-pm_root?: string;
+pm_root?:string;
 /** Value that configures or reports result for this contract. */
-result: unknown;
+result:unknown;
 }
 /** Documents the command handler context payload exchanged by command, SDK, and package integrations. */
 export interface CommandHandlerContext extends PortableWorkspaceContext {
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports args for this contract. */
-args: string[];
+args:string[];
 /** Value that configures or reports options for this contract. */
-options: Record<string, unknown>;
+options:Record<string,unknown>;
 /** Value that configures or reports global for this contract. */
-global: GlobalOptions;
+global:GlobalOptions;
 /** Value that configures or reports pm root for this contract. */
-pm_root: string;
+pm_root:string;
 /** Host-bound SDK runtime that avoids package-resolution and private-import coupling. */
-sdk?: ExtensionCommandSdk;
+sdk?:ExtensionCommandSdk;
 }
 /** Runtime SDK services injected into every extension command invocation. */
 export interface ExtensionCommandSdk {
 /** Tracker-bound client using the invocation author and workspace. */
-client: PmClient;
+client:PmClient;
 /** Classify a host-native or structurally compatible missing-item error. */
-isItemNotFoundError(error: unknown): boolean;
+isItemNotFoundError(error:unknown):boolean;
 /** Reconstruct one item at a history version or timestamp. */
-getItemAt(id: string, target: string): Promise<GetItemAtResult>;
+getItemAt(id:string,target:string):Promise<GetItemAtResult>;
 /** Open a durable event store with package-contributed relationship semantics. */
-openRelationshipEventStore(options: {
-nodes: Iterable<string>;
-definitions: readonly RelationshipKindDefinition[];
-relativePath?: string;
-}): Promise<RelationshipEventStore>;
+openRelationshipEventStore(options:{
+nodes:Iterable<string>;
+definitions:readonly RelationshipKindDefinition[];
+relativePath?:string;
+}):Promise<RelationshipEventStore>;
 /** Materialize a validated in-memory graph without resolving the SDK package at runtime. */
-createRelationshipGraph(options: {
-nodes: Iterable<string>;
-edges: Iterable<RelationshipEdge>;
-definitions: readonly RelationshipKindDefinition[];
-}): RelationshipGraph;
+createRelationshipGraph(options:{
+nodes:Iterable<string>;
+edges:Iterable<RelationshipEdge>;
+definitions:readonly RelationshipKindDefinition[];
+}):RelationshipGraph;
 /** Compute bounded exact impact through the host-owned relationship runtime. */
-analyzeRelationshipImpact(graph: RelationshipGraph, root: string, options?: RelationshipQueryOptions): RelationshipImpactAnalysis;
+analyzeRelationshipImpact(graph:RelationshipGraph,root:string,options?:RelationshipQueryOptions):RelationshipImpactAnalysis;
 /** Validate an immutable relationship event batch without persisting it. */
-validateRelationshipEvents(options: {
-nodes: Iterable<string>;
-definitions: readonly RelationshipKindDefinition[];
-events: readonly RelationshipEventInput[];
-}): RelationshipEvent[];
+validateRelationshipEvents(options:{
+nodes:Iterable<string>;
+definitions:readonly RelationshipKindDefinition[];
+events:readonly RelationshipEventInput[];
+}):RelationshipEvent[];
 /** Commit idempotent item and relationship mutations under one durable journal. */
-commitWorkspaceTransaction(options: Omit<CommitWorkspaceTransactionOptions, "pmRoot">): Promise<WorkspaceTransactionCommitResult>;
+commitWorkspaceTransaction(options:Omit<CommitWorkspaceTransactionOptions,"pmRoot">):Promise<WorkspaceTransactionCommitResult>;
 /** Mutate governed project settings under the host's workspace audit lock. */
-mutateWorkspaceSettings(options: {
+mutateWorkspaceSettings(options:{
 /** Stable identity for replay-safe retries of this invocation. */
-operationId: string;
+operationId:string;
 /** Compute a preview without changing settings or workspace history. */
-dryRun?: boolean;
+dryRun?:boolean;
 /** Include the canonical inline settings tree; omit by default to bound receipts. */
-includePreview?: boolean;
+includePreview?:boolean;
 /** Replace these dot-delimited inline object subtrees, removing omitted raw keys while preserving all other source fields. */
-replaceSubtrees?: readonly string[];
+replaceSubtrees?:readonly string[];
 /** Derive the complete next settings tree from normalized inline settings at lock time. */
-mutate: (current: PmSettings) => PmSettings | Promise<PmSettings>;
-}): Promise<{
+mutate:(current:PmSettings) => PmSettings | Promise<PmSettings>;
+}):Promise<{
 /** Whether the locked settings bytes would change, or did change on apply. */
-changed: boolean;
+changed:boolean;
 /** Whether persistence was suppressed for this invocation. */
-dry_run: boolean;
+dry_run:boolean;
 /** Whether the operation was already committed and the callback was skipped. */
-replayed: boolean;
+replayed:boolean;
 /** Settings resolved from the exact persisted bytes, before optional file-backed schema overlays. Absent on replay. */
-preview?: PmSettings;
+preview?:PmSettings;
 }>;
 }
 /** Documents the parser override context payload exchanged by command, SDK, and package integrations. */
@@ -628,102 +628,102 @@ export type ParserOverrideContext = CommandHandlerContext;
 /** Documents the parser override delta payload exchanged by command, SDK, and package integrations. */
 export interface ParserOverrideDelta {
 /** Value that configures or reports args for this contract. */
-args?: string[];
+args?:string[];
 /** Value that configures or reports options for this contract. */
-options?: Record<string, unknown>;
+options?:Record<string,unknown>;
 /** Value that configures or reports global for this contract. */
-global?: GlobalOptions;
+global?:GlobalOptions;
 }
 /** Documents the preflight override context payload exchanged by command, SDK, and package integrations. */
 export interface PreflightOverrideContext extends CommandHandlerContext {
 /** Value that configures or reports decision for this contract. */
-decision: PreflightRuntimeDecision;
+decision:PreflightRuntimeDecision;
 }
 /** Documents the preflight runtime decision payload exchanged by command, SDK, and package integrations. */
 export interface PreflightRuntimeDecision {
 /** Value that configures or reports enforce item format gate for this contract. */
-enforce_item_format_gate: boolean;
+enforce_item_format_gate:boolean;
 /** Executes the preflight item format sync operation through the package runtime. */
-run_preflight_item_format_sync: boolean;
+run_preflight_item_format_sync:boolean;
 /** Executes the extension migrations operation through the package runtime. */
-run_extension_migrations: boolean;
+run_extension_migrations:boolean;
 /** Value that configures or reports enforce mandatory migration gate for this contract. */
-enforce_mandatory_migration_gate: boolean;
+enforce_mandatory_migration_gate:boolean;
 }
 /** Documents the preflight override delta payload exchanged by command, SDK, and package integrations. */
 export interface PreflightOverrideDelta extends ParserOverrideDelta {
 /** Value that configures or reports enforce item format gate for this contract. */
-enforce_item_format_gate?: boolean;
+enforce_item_format_gate?:boolean;
 /** Executes the preflight item format sync operation through the package runtime. */
-run_preflight_item_format_sync?: boolean;
+run_preflight_item_format_sync?:boolean;
 /** Executes the extension migrations operation through the package runtime. */
-run_extension_migrations?: boolean;
+run_extension_migrations?:boolean;
 /** Value that configures or reports enforce mandatory migration gate for this contract. */
-enforce_mandatory_migration_gate?: boolean;
+enforce_mandatory_migration_gate?:boolean;
 }
 /** Documents the service override context payload exchanged by command, SDK, and package integrations. */
 export interface ServiceOverrideContext extends Partial<PortableWorkspaceContext> {
 /** Value that configures or reports service for this contract. */
-service: ExtensionServiceName;
+service:ExtensionServiceName;
 /** Value that configures or reports command for this contract. */
-command?: string;
+command?:string;
 /** Value that configures or reports args for this contract. */
-args?: string[];
+args?:string[];
 /** Value that configures or reports options for this contract. */
-options?: Record<string, unknown>;
+options?:Record<string,unknown>;
 /** Value that configures or reports global for this contract. */
-global?: GlobalOptions;
+global?:GlobalOptions;
 /** Value that configures or reports pm root for this contract. */
-pm_root?: string;
+pm_root?:string;
 /** Value that configures or reports payload for this contract. */
-payload: unknown;
+payload:unknown;
 }
 /** Documents the extension command argument definition payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCommandArgumentDefinition {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports required for this contract. */
-required?: boolean;
+required?:boolean;
 /** Value that configures or reports variadic for this contract. */
-variadic?: boolean;
+variadic?:boolean;
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 }
 /** Documents the command definition payload exchanged by command, SDK, and package integrations. */
 export interface CommandDefinition {
 /** Opt a read-only handler into host projection, row bounds, budgets and continuation. */
-read_output?: ExtensionCommandReadOutput;
+read_output?:ExtensionCommandReadOutput;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports run for this contract. */
-run?: CommandHandler;
+run?:CommandHandler;
 /**
      * @deprecated Use `run` instead. This alias remains for backward compatibility.
      */
-handler?: CommandHandler;
+handler?:CommandHandler;
 /** Value that configures or reports action for this contract. */
-action?: string;
+action?:string;
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Value that configures or reports intent for this contract. */
-intent?: string;
+intent?:string;
 /** Value that configures or reports examples for this contract. */
-examples?: string[];
+examples?:string[];
 /** Value that configures or reports failure hints for this contract. */
-failure_hints?: string[];
+failure_hints?:string[];
 /** Value that configures or reports arguments for this contract. */
-arguments?: ExtensionCommandArgumentDefinition[];
+arguments?:ExtensionCommandArgumentDefinition[];
 /** Value that configures or reports flags for this contract. */
-flags?: FlagDefinition[];
+flags?:FlagDefinition[];
 /** Minimum agent surface tier that should advertise this command. */
-tier?: "core" | "standard" | "full" | "internal";
+tier?:"core" | "standard" | "full" | "internal";
 /** Capability family used by generated agent routing surfaces. */
-family?: ExtensionCommandCapabilityFamily;
+family?:ExtensionCommandCapabilityFamily;
 }
 /** Structured rows a read-only extension command returns for host output shaping. */
 export interface ExtensionCommandReadOutput {
 /** Dot-delimited array or object-map paths; an empty list declares a singleton result. */
-row_keys: readonly string[];
+row_keys:readonly string[];
 }
 /**
  * Optional command-definition metadata for first-class importer/exporter
@@ -739,19 +739,19 @@ row_keys: readonly string[];
  */
 export interface ImportExportRegistrationOptions {
 /** Value that configures or reports action for this contract. */
-action?: string;
+action?:string;
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Value that configures or reports intent for this contract. */
-intent?: string;
+intent?:string;
 /** Value that configures or reports examples for this contract. */
-examples?: string[];
+examples?:string[];
 /** Value that configures or reports failure hints for this contract. */
-failure_hints?: string[];
+failure_hints?:string[];
 /** Value that configures or reports arguments for this contract. */
-arguments?: ExtensionCommandArgumentDefinition[];
+arguments?:ExtensionCommandArgumentDefinition[];
 /** Value that configures or reports flags for this contract. */
-flags?: FlagDefinition[];
+flags?:FlagDefinition[];
 }
 /**
  * Declares where an exporter writes its artifact and whether the host may
@@ -759,653 +759,668 @@ flags?: FlagDefinition[];
  */
 export type ExporterArtifactOutputContract = {
 /** Stdout exclusively carries artifact bytes. */
-channel: "stdout";
+channel:"stdout";
 /** Stdout artifacts cannot opt back into host rendering. */
-receipt?: "suppress";
+receipt?:"suppress";
 /** Optional IANA media type describing the emitted artifact. */
-media_type?: string;
+media_type?:string;
 } | {
 /** The exporter writes its artifact to a file. */
-channel: "file";
+channel:"file";
 /** File exporters may render or suppress their bounded receipt. */
-receipt?: "suppress" | "render";
+receipt?:"suppress" | "render";
 /** Optional IANA media type describing the emitted artifact. */
-media_type?: string;
+media_type?:string;
 };
 /** Exporter command metadata plus its optional artifact-delivery contract. */
 export interface ExporterRegistrationOptions extends ImportExportRegistrationOptions {
 /** Declaration for artifact bytes and the host receipt. */
-output?: ExporterArtifactOutputContract;
+output?:ExporterArtifactOutputContract;
 }
 /** Fully normalized exporter artifact contract stored in inventories. */
 export interface RegisteredExporterArtifactOutputContract {
 /** Destination carrying the artifact bytes. */
-channel: "stdout" | "file";
+channel:"stdout" | "file";
 /** Explicit host receipt policy after normalization. */
-receipt: "suppress" | "render";
+receipt:"suppress" | "render";
 /** Optional IANA media type describing the emitted artifact. */
-media_type?: string;
+media_type?:string;
 }
 /** Restricts flag value type values accepted by command, SDK, and storage contracts. */
 export type FlagValueType = "string" | "number" | "boolean";
+/**
+ * How a typed scalar flag treats a value token that does not coerce under its
+ * declared `value_type`. `coerce` (default, compatible) forwards the original
+ * token to the handler for its own validation; `strict` refuses the invocation
+ * with a typed usage error before the handler runs.
+ */
+export type FlagValueValidation = "coerce" | "strict";
 /** Documents the flag definition payload exchanged by command, SDK, and package integrations. */
 export interface FlagDefinition {
 /** Value that configures or reports long for this contract. */
-long?: string;
+long?:string;
 /** Value that configures or reports short for this contract. */
-short?: string;
+short?:string;
 /** Value that configures or reports value name for this contract. */
-value_name?: string;
+value_name?:string;
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Value that configures or reports required for this contract. */
-required?: boolean;
+required?:boolean;
 /** Whether enabled applies to this operation. */
-enabled?: boolean;
+enabled?:boolean;
 /** Value that configures or reports visible for this contract. */
-visible?: boolean;
+visible?:boolean;
 /** Canonical flag value type. Prefer this field; it is the one runtime contracts and help output read first. */
-value_type?: FlagValueType;
+value_type?:FlagValueType;
 /**
      * @deprecated Use `value_type`. Retained for backward compatibility: when
      * both are present `value_type` wins, and `type` resolves only when
      * `value_type` is absent (`value_type ?? type`).
      */
-type?: FlagValueType;
+type?:FlagValueType;
 /** When true, a repeated comma-list flag accumulates values across repeats — parity with core list flags such as `--tags` — instead of the last value winning. Mirrors the core `CliFlagContract.list` field so extension-registered list flags coalesce through the same bootstrap path. */
-list?: boolean;
+list?:boolean;
 /** Package-author-friendly alias for ordered list accumulation. Unlike CSV-friendly `list`, commas inside one repeated occurrence remain atomic. Normalized with `list: true` for host registration and contracts. */
-repeatable?: boolean;
+repeatable?:boolean;
 /** Default value applied when the flag is omitted. Surfaced to runtime contracts and help output. A `list` flag may default to an array of scalars (e.g. `["a", "b"]`); the array is flattened/coerced like any list value. */
-default?: string | number | boolean | Array<string | number | boolean>;
+default?:string | number | boolean | Array<string | number | boolean>;
+/**
+     * Scalar validation policy for `number`/`boolean` flags. `strict` refuses a
+     * malformed value token (`--limit abc`, `--enabled maybe`, or a value-less
+     * `--limit`) before dispatch; `coerce` (default) keeps the historical
+     * behaviour of forwarding the raw token. Switch presence (`--verbose`,
+     * `--no-verbose`) and the legacy `bool` optional-value grammar are unaffected.
+     */
+value_validation?:FlagValueValidation;
 }
 /** Documents the schema field definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaFieldDefinition {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Canonical persisted field type shared with `pm schema add-field`. */
-type: KnownItemFieldType;
+type:KnownItemFieldType;
 /** Value that configures or reports optional for this contract. */
-optional?: boolean;
+optional?:boolean;
 /** Default metadata value applied when the field is absent. */
-default?: unknown;
+default?:unknown;
 /** Optional allow-list of accepted metadata values. */
-values?: unknown[];
+values?:unknown[];
 }
 /** Documents the schema item type command option policy definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaItemTypeCommandOptionPolicyDefinition {
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports option for this contract. */
-option: string;
+option:string;
 /** Whether enabled applies to this operation. */
-enabled?: boolean;
+enabled?:boolean;
 /** Value that configures or reports required for this contract. */
-required?: boolean;
+required?:boolean;
 /** Value that configures or reports visible for this contract. */
-visible?: boolean;
+visible?:boolean;
 }
 /** Documents the schema item type option definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaItemTypeOptionDefinition {
 /** Value that configures or reports key for this contract. */
-key: string;
+key:string;
 /** Value that configures or reports values for this contract. */
-values?: string[];
+values?:string[];
 /** Value that configures or reports required for this contract. */
-required?: boolean;
+required?:boolean;
 /** Value that configures or reports aliases for this contract. */
-aliases?: string[];
+aliases?:string[];
 }
 /** Documents the schema item type definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaItemTypeDefinition {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports folder for this contract. */
-folder?: string;
+folder?:string;
 /** Value that configures or reports aliases for this contract. */
-aliases?: string[];
+aliases?:string[];
 /** Human-readable description of the contributed item type. */
-description?: string;
+description?:string;
 /** Initial status assigned when the contributed item type is created. */
-default_status?: string;
+default_status?:string;
 /** Dispatch role inherited by next, context, and automatic claims. Gates track outcomes; human roles require decisions. */
-execution_role?: "agent" | "human" | "gate";
+execution_role?:"agent" | "human" | "gate";
 /** Value that configures or reports required create fields for this contract. */
-required_create_fields?: string[];
+required_create_fields?:string[];
 /** Value that configures or reports required create repeatables for this contract. */
-required_create_repeatables?: string[];
+required_create_repeatables?:string[];
 /** Value that configures or reports command option policies for this contract. */
-command_option_policies?: SchemaItemTypeCommandOptionPolicyDefinition[];
+command_option_policies?:SchemaItemTypeCommandOptionPolicyDefinition[];
 /** Value that configures or reports options for this contract. */
-options?: SchemaItemTypeOptionDefinition[];
-[key: string]: unknown;
+options?:SchemaItemTypeOptionDefinition[];
+[key:string]:unknown;
 }
 /** Documents the schema migration run context payload exchanged by command, SDK, and package integrations. */
 export interface SchemaMigrationRunContext {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports command for this contract. */
-command: "migration";
+command:"migration";
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports extension for this contract. */
-extension: string;
+extension:string;
 /** Value that configures or reports pm root for this contract. */
-pm_root: string;
+pm_root:string;
 /** Lifecycle state reported for status. */
-status: string;
+status:string;
 }
 /** Restricts schema migration runner values accepted by command, SDK, and storage contracts. */
-export type SchemaMigrationRunner = (context: SchemaMigrationRunContext) => unknown | Promise<unknown>;
+export type SchemaMigrationRunner = (context:SchemaMigrationRunContext) => unknown | Promise<unknown>;
 /** Documents the schema migration definition payload exchanged by command, SDK, and package integrations. */
 export interface SchemaMigrationDefinition {
 /** Stable identifier used to reference this record across commands and storage. */
-id?: string;
+id?:string;
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Lifecycle state reported for status. */
-status?: string;
+status?:string;
 /** Value that configures or reports mandatory for this contract. */
-mandatory?: boolean;
+mandatory?:boolean;
 /** Value that configures or reports run for this contract. */
-run?: SchemaMigrationRunner;
-[key: string]: unknown;
+run?:SchemaMigrationRunner;
+[key:string]:unknown;
 }
 /** Documents the import export context payload exchanged by command, SDK, and package integrations. */
 export interface ImportExportContext extends PortableWorkspaceContext {
 /** Value that configures or reports registration for this contract. */
-registration: string;
+registration:string;
 /** Value that configures or reports action for this contract. */
-action: "import" | "export";
+action:"import" | "export";
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports args for this contract. */
-args: string[];
+args:string[];
 /** Value that configures or reports options for this contract. */
-options: Record<string, unknown>;
+options:Record<string,unknown>;
 /** Value that configures or reports global for this contract. */
-global: GlobalOptions;
+global:GlobalOptions;
 /** Value that configures or reports pm root for this contract. */
-pm_root: string;
+pm_root:string;
 /** Host-bound SDK runtime for composing PM actions without spawning the CLI. */
-sdk?: ExtensionCommandSdk;
+sdk?:ExtensionCommandSdk;
 }
 /** Restricts importer values accepted by command, SDK, and storage contracts. */
-export type Importer = (context: ImportExportContext) => unknown | Promise<unknown>;
+export type Importer = (context:ImportExportContext) => unknown | Promise<unknown>;
 /** Restricts exporter values accepted by command, SDK, and storage contracts. */
-export type Exporter = (context: ImportExportContext) => unknown | Promise<unknown>;
+export type Exporter = (context:ImportExportContext) => unknown | Promise<unknown>;
 /** Restricts extension search mode values accepted by command, SDK, and storage contracts. */
 export type ExtensionSearchMode = "keyword" | "semantic" | "hybrid";
 /** Documents the search provider query context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderQueryContext {
 /** Value that configures or reports query for this contract. */
-query: string;
+query:string;
 /** Value that configures or reports mode for this contract. */
-mode: ExtensionSearchMode;
+mode:ExtensionSearchMode;
 /** Value that configures or reports tokens for this contract. */
-tokens: string[];
+tokens:string[];
 /** Value that configures or reports options for this contract. */
-options: Record<string, unknown>;
+options:Record<string,unknown>;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports documents for this contract. */
-documents: ItemDocument[];
-[key: string]: unknown;
+documents:ItemDocument[];
+[key:string]:unknown;
 }
 /** Documents the search provider hit payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderHit {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports score for this contract. */
-score: number;
+score:number;
 /** Value that configures or reports matched fields for this contract. */
-matched_fields?: string[];
-[key: string]: unknown;
+matched_fields?:string[];
+[key:string]:unknown;
 }
 /** Restricts search provider query result values accepted by command, SDK, and storage contracts. */
 export type SearchProviderQueryResult = SearchProviderHit[] | {
-hits?: SearchProviderHit[];
+hits?:SearchProviderHit[];
 };
 /** Documents the search provider query expansion context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderQueryExpansionContext {
 /** Value that configures or reports query for this contract. */
-query: string;
+query:string;
 /** Value that configures or reports mode for this contract. */
-mode: Exclude<ExtensionSearchMode, "keyword">;
+mode:Exclude<ExtensionSearchMode,"keyword">;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
-[key: string]: unknown;
+settings:PmSettings;
+[key:string]:unknown;
 }
 /** Restricts search provider query expansion result values accepted by command, SDK, and storage contracts. */
 export type SearchProviderQueryExpansionResult = string[] | {
-queries?: string[];
+queries?:string[];
 };
 /** Documents the search provider rerank candidate payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderRerankCandidate {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports text for this contract. */
-text: string;
+text:string;
 /** Value that configures or reports score for this contract. */
-score: number;
+score:number;
 }
 /** Documents the search provider rerank hit payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderRerankHit {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports score for this contract. */
-score: number;
+score:number;
 }
 /** Restricts search provider rerank result values accepted by command, SDK, and storage contracts. */
 export type SearchProviderRerankResult = SearchProviderRerankHit[] | {
-hits?: SearchProviderRerankHit[];
+hits?:SearchProviderRerankHit[];
 };
 /** Documents the search provider rerank context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderRerankContext {
 /** Value that configures or reports query for this contract. */
-query: string;
+query:string;
 /** Value that configures or reports mode for this contract. */
-mode: "hybrid";
+mode:"hybrid";
 /** Value that configures or reports model for this contract. */
-model: string;
+model:string;
 /** Value that configures or reports top k for this contract. */
-top_k: number;
+top_k:number;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports candidates for this contract. */
-candidates: SearchProviderRerankCandidate[];
-[key: string]: unknown;
+candidates:SearchProviderRerankCandidate[];
+[key:string]:unknown;
 }
 /** Documents the search provider embed batch context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderEmbedBatchContext {
 /** Value that configures or reports inputs for this contract. */
-inputs: string[];
+inputs:string[];
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports model for this contract. */
-model: string;
-[key: string]: unknown;
+model:string;
+[key:string]:unknown;
 }
 /** Documents the search provider embed context payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderEmbedContext {
 /** Value that configures or reports input for this contract. */
-input: string;
+input:string;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports model for this contract. */
-model: string;
-[key: string]: unknown;
+model:string;
+[key:string]:unknown;
 }
 /** Documents the search provider definition payload exchanged by command, SDK, and package integrations. */
 export interface SearchProviderDefinition {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports query for this contract. */
-query?: (context: SearchProviderQueryContext) => SearchProviderQueryResult | Promise<SearchProviderQueryResult>;
+query?:(context:SearchProviderQueryContext) => SearchProviderQueryResult | Promise<SearchProviderQueryResult>;
 /** Value that configures or reports query expansion for this contract. */
-queryExpansion?: (context: SearchProviderQueryExpansionContext) => SearchProviderQueryExpansionResult | Promise<SearchProviderQueryExpansionResult>;
+queryExpansion?:(context:SearchProviderQueryExpansionContext) => SearchProviderQueryExpansionResult | Promise<SearchProviderQueryExpansionResult>;
 /** Value that configures or reports query expansion for this contract. */
-query_expansion?: (context: SearchProviderQueryExpansionContext) => SearchProviderQueryExpansionResult | Promise<SearchProviderQueryExpansionResult>;
+query_expansion?:(context:SearchProviderQueryExpansionContext) => SearchProviderQueryExpansionResult | Promise<SearchProviderQueryExpansionResult>;
 /** Value that configures or reports rerank for this contract. */
-rerank?: (context: SearchProviderRerankContext) => SearchProviderRerankResult | Promise<SearchProviderRerankResult>;
+rerank?:(context:SearchProviderRerankContext) => SearchProviderRerankResult | Promise<SearchProviderRerankResult>;
 /** Value that configures or reports embed batch for this contract. */
-embedBatch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;
+embedBatch?:(context:SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;
 /** Value that configures or reports embed batch for this contract. */
-embed_batch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;
+embed_batch?:(context:SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;
 /** Value that configures or reports embed for this contract. */
-embed?: (context: SearchProviderEmbedContext) => number[] | Promise<number[]>;
-[key: string]: unknown;
+embed?:(context:SearchProviderEmbedContext) => number[] | Promise<number[]>;
+[key:string]:unknown;
 }
 /** Documents the vector store query hit payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreQueryHit {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports score for this contract. */
-score: number;
+score:number;
 /** Value that configures or reports payload for this contract. */
-payload?: Record<string, unknown>;
-[key: string]: unknown;
+payload?:Record<string,unknown>;
+[key:string]:unknown;
 }
 /** Documents the vector store query context payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreQueryContext {
 /** Value that configures or reports vector for this contract. */
-vector: number[];
+vector:number[];
 /** Value that configures or reports limit for this contract. */
-limit: number;
+limit:number;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
-[key: string]: unknown;
+settings:PmSettings;
+[key:string]:unknown;
 }
 /** Documents the vector store upsert point payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreUpsertPoint {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports vector for this contract. */
-vector: number[];
+vector:number[];
 /** Value that configures or reports payload for this contract. */
-payload?: Record<string, unknown>;
-[key: string]: unknown;
+payload?:Record<string,unknown>;
+[key:string]:unknown;
 }
 /** Documents the vector store upsert context payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreUpsertContext {
 /** Value that configures or reports points for this contract. */
-points: VectorStoreUpsertPoint[];
+points:VectorStoreUpsertPoint[];
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
-[key: string]: unknown;
+settings:PmSettings;
+[key:string]:unknown;
 }
 /** Documents the vector store delete context payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreDeleteContext {
 /** Value that configures or reports ids for this contract. */
-ids: string[];
+ids:string[];
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
-[key: string]: unknown;
+settings:PmSettings;
+[key:string]:unknown;
 }
 /** Documents the vector store adapter definition payload exchanged by command, SDK, and package integrations. */
 export interface VectorStoreAdapterDefinition {
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports query for this contract. */
-query?: (context: VectorStoreQueryContext) => VectorStoreQueryHit[] | Promise<VectorStoreQueryHit[]>;
+query?:(context:VectorStoreQueryContext) => VectorStoreQueryHit[] | Promise<VectorStoreQueryHit[]>;
 /** Value that configures or reports upsert for this contract. */
-upsert?: (context: VectorStoreUpsertContext) => unknown | Promise<unknown>;
+upsert?:(context:VectorStoreUpsertContext) => unknown | Promise<unknown>;
 /** Value that configures or reports delete for this contract. */
-delete?: (context: VectorStoreDeleteContext) => unknown | Promise<unknown>;
-[key: string]: unknown;
+delete?:(context:VectorStoreDeleteContext) => unknown | Promise<unknown>;
+[key:string]:unknown;
 }
 /** Cost classes let lifecycle gates reject expensive provider work before invoking it. */
 export type AssuranceMeasurementProviderCostClass = "low" | "medium" | "high";
 /** JSON-compatible parameter contract for one provider measurement key. */
 export interface AssuranceMeasurementProviderParameterDefinition {
 /** Parameter value kind. */
-type: "string" | "number" | "boolean";
+type:"string" | "number" | "boolean";
 /** Whether callers must supply the parameter. */
-required?: boolean;
+required?:boolean;
 /** Human-readable parameter intent. */
-description?: string;
+description?:string;
 }
 /** Serializable schema for one measurement key owned by a provider. */
 export interface AssuranceMeasurementProviderKeyDefinition {
 /** Value kind returned by the resolver. */
-value_type: "number" | "string_set";
+value_type:"number" | "string_set";
 /** Human-readable metric intent. */
-description?: string;
+description?:string;
 /** Accepted provider parameters. Unknown parameters are rejected. */
-parameters?: Record<string, AssuranceMeasurementProviderParameterDefinition>;
+parameters?:Record<string,AssuranceMeasurementProviderParameterDefinition>;
 }
 /** Runtime request supplied to an extension-owned assurance provider. */
 export interface AssuranceMeasurementProviderContext extends PortableWorkspaceContext {
 /** Provider id selected by the measurement declaration. */
-provider: string;
+provider:string;
 /** Provider-owned metric key. */
-key: string;
+key:string;
 /** Validated provider parameters. */
-parameters: Record<string, string | number | boolean | null>;
+parameters:Record<string,string | number | boolean | null>;
 /** Gate trigger that authorized this invocation. */
-trigger: string;
+trigger:string;
 /** Tracker root bound to the active command or SDK request. */
-pm_root: string;
+pm_root:string;
 }
 /** Result returned by an extension-owned assurance provider. */
 export interface AssuranceMeasurementProviderResult {
 /** Finite numeric value or deterministic labelled set. */
-value: number | string[];
+value:number | string[];
 /** Population denominator represented by the metric. */
-population_size: number;
+population_size:number;
 /** Abstract compute units charged by the provider. */
-cost: number;
+cost:number;
 /** Optional stable contributor ids or labels. */
-contributors?: string[];
+contributors?:string[];
 }
 /** Extension registration for an open assurance measurement vocabulary. */
 export interface AssuranceMeasurementProviderDefinition {
 /** Stable provider id used by measurement declarations and gate allow-lists. */
-id: string;
+id:string;
 /** Serializable metric-key schema. */
-keys: Record<string, AssuranceMeasurementProviderKeyDefinition>;
+keys:Record<string,AssuranceMeasurementProviderKeyDefinition>;
 /** Coarse execution cost used by trigger policy before invocation. */
-cost_class: AssuranceMeasurementProviderCostClass;
+cost_class:AssuranceMeasurementProviderCostClass;
 /** Whether the resolver can access the network. */
-network: boolean;
+network:boolean;
 /** Maximum host wait for one resolver call. */
-timeout_ms?: number;
+timeout_ms?:number;
 /** Resolve one declared key. */
-resolve(context: AssuranceMeasurementProviderContext): AssuranceMeasurementProviderResult | Promise<AssuranceMeasurementProviderResult>;
+resolve(context:AssuranceMeasurementProviderContext):AssuranceMeasurementProviderResult | Promise<AssuranceMeasurementProviderResult>;
 }
 /** Documents the registered extension command override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionCommandOverride {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports run for this contract. */
-run: CommandOverride;
+run:CommandOverride;
 }
 /** Documents the registered extension command handler payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionCommandHandler {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports run for this contract. */
-run: CommandHandler;
+run:CommandHandler;
 }
 /** Documents the registered extension parser override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionParserOverride {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports run for this contract. */
-run: ParserOverride;
+run:ParserOverride;
 }
 /** Documents the registered extension preflight override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionPreflightOverride {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports run for this contract. */
-run: PreflightOverride;
+run:PreflightOverride;
 /** Normalized command paths owned by this preflight override. */
-commands?: string[];
+commands?:string[];
 }
 /** Documents the registered extension service override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionServiceOverride {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports service for this contract. */
-service: ExtensionServiceName;
+service:ExtensionServiceName;
 /** Value that configures or reports run for this contract. */
-run: ServiceOverride;
+run:ServiceOverride;
 /** Whether the host forbids this callback from handling the service payload. */
-passThrough?: boolean;
+passThrough?:boolean;
 }
 /** Documents the registered extension renderer override payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionRendererOverride {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports format for this contract. */
-format: OutputRendererFormat;
+format:OutputRendererFormat;
 /** Value that configures or reports run for this contract. */
-run: RendererOverride;
+run:RendererOverride;
 /** Normalized command paths owned by this renderer. */
-commands?: string[];
+commands?:string[];
 /** Optional result predicate enforced by the host before invoking the renderer. */
-resultDiscriminator?: (result: unknown) => boolean;
+resultDiscriminator?:(result:unknown) => boolean;
 }
 /** Documents the extension command registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCommandRegistry {
 /** Value that configures or reports overrides for this contract. */
-overrides: RegisteredExtensionCommandOverride[];
+overrides:RegisteredExtensionCommandOverride[];
 /** Value that configures or reports handlers for this contract. */
-handlers: RegisteredExtensionCommandHandler[];
+handlers:RegisteredExtensionCommandHandler[];
 }
 /** Documents the extension parser registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionParserRegistry {
 /** Value that configures or reports overrides for this contract. */
-overrides: RegisteredExtensionParserOverride[];
+overrides:RegisteredExtensionParserOverride[];
 }
 /** Documents the extension preflight registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionPreflightRegistry {
 /** Value that configures or reports overrides for this contract. */
-overrides: RegisteredExtensionPreflightOverride[];
+overrides:RegisteredExtensionPreflightOverride[];
 }
 /** Documents the extension service registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionServiceRegistry {
 /** Value that configures or reports overrides for this contract. */
-overrides: RegisteredExtensionServiceOverride[];
+overrides:RegisteredExtensionServiceOverride[];
 }
 /** Documents the extension renderer registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionRendererRegistry {
 /** Value that configures or reports overrides for this contract. */
-overrides: RegisteredExtensionRendererOverride[];
+overrides:RegisteredExtensionRendererOverride[];
 }
 /** Documents the registered extension flag definitions payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionFlagDefinitions {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports target command for this contract. */
-target_command: string;
+target_command:string;
 /** Value that configures or reports flags for this contract. */
-flags: FlagDefinition[];
+flags:FlagDefinition[];
 }
 /** Documents the registered extension command definition payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionCommandDefinition {
 /** Validated read-only output declaration, snapshotted during activation. */
-read_output?: ExtensionCommandReadOutput;
+read_output?:ExtensionCommandReadOutput;
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports source package for this contract. */
-source_package?: string;
+source_package?:string;
 /** Value that configures or reports command for this contract. */
-command: string;
+command:string;
 /** Value that configures or reports action for this contract. */
-action: string;
+action:string;
 /** Value that configures or reports description for this contract. */
-description?: string;
+description?:string;
 /** Value that configures or reports intent for this contract. */
-intent?: string;
+intent?:string;
 /** Value that configures or reports examples for this contract. */
-examples: string[];
+examples:string[];
 /** Value that configures or reports failure hints for this contract. */
-failure_hints: string[];
+failure_hints:string[];
 /** Value that configures or reports arguments for this contract. */
-arguments: ExtensionCommandArgumentDefinition[];
+arguments:ExtensionCommandArgumentDefinition[];
 /** Minimum agent surface tier that should advertise this command. */
-tier?: "core" | "standard" | "full" | "internal";
+tier?:"core" | "standard" | "full" | "internal";
 /** Capability family used by generated agent routing surfaces. */
-family?: ExtensionCommandCapabilityFamily;
+family?:ExtensionCommandCapabilityFamily;
 }
 /** Documents the registered extension schema field definitions payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionSchemaFieldDefinitions {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports fields for this contract. */
-fields: SchemaFieldDefinition[];
+fields:SchemaFieldDefinition[];
 }
 /** Documents the registered extension schema item type definitions payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionSchemaItemTypeDefinitions {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports types for this contract. */
-types: SchemaItemTypeDefinition[];
+types:SchemaItemTypeDefinition[];
 }
 /** Relationship ontology definitions contributed by one active extension. */
 export interface RegisteredExtensionRelationshipKindDefinitions {
 /** Extension layer that owns these definitions. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Extension name that owns these definitions. */
-name: string;
+name:string;
 /** Validated immutable relationship-kind definitions. */
-definitions: RelationshipKindDefinition[];
+definitions:RelationshipKindDefinition[];
 }
 /** Documents the registered extension schema migration definition payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionSchemaMigrationDefinition {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports definition for this contract. */
-definition: SchemaMigrationDefinition;
+definition:SchemaMigrationDefinition;
 /** Value that configures or reports runtime definition for this contract. */
-runtime_definition: SchemaMigrationDefinition;
+runtime_definition:SchemaMigrationDefinition;
 }
 /** Documents the registered extension importer payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionImporter {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports importer for this contract. */
-importer: string;
+importer:string;
 }
 /** Documents the registered extension exporter payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionExporter {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports exporter for this contract. */
-exporter: string;
+exporter:string;
 /** Declared artifact channel and normalized receipt policy. */
-output?: RegisteredExporterArtifactOutputContract;
+output?:RegisteredExporterArtifactOutputContract;
 }
 /** Documents the registered extension search provider payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionSearchProvider {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports definition for this contract. */
-definition: SearchProviderDefinition;
+definition:SearchProviderDefinition;
 /** Value that configures or reports runtime definition for this contract. */
-runtime_definition: SearchProviderDefinition;
+runtime_definition:SearchProviderDefinition;
 }
 /** Documents the registered extension vector store adapter payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredExtensionVectorStoreAdapter {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports definition for this contract. */
-definition: VectorStoreAdapterDefinition;
+definition:VectorStoreAdapterDefinition;
 /** Value that configures or reports runtime definition for this contract. */
-runtime_definition: VectorStoreAdapterDefinition;
+runtime_definition:VectorStoreAdapterDefinition;
 }
 /** One validated assurance measurement provider registered by an active extension. */
 export interface RegisteredExtensionAssuranceMeasurementProvider {
 /** Extension layer owning the provider. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Extension name owning the provider. */
-name: string;
+name:string;
 /** Whether the owning manifest grants network access. */
-network_permission: boolean;
+network_permission:boolean;
 /** Serializable definition used by doctor, inventory, and policy surfaces. */
-definition: Omit<AssuranceMeasurementProviderDefinition, "resolve"> & {
-resolve: "[Function]";
+definition:Omit<AssuranceMeasurementProviderDefinition,"resolve"> & {
+resolve:"[Function]";
 };
 /** Runtime definition containing the executable resolver. */
-runtime_definition: AssuranceMeasurementProviderDefinition;
+runtime_definition:AssuranceMeasurementProviderDefinition;
 }
 /**
  * Documents a project profile contributed by an extension via
@@ -1420,382 +1435,382 @@ runtime_definition: AssuranceMeasurementProviderDefinition;
  */
 export interface RegisteredExtensionProjectProfile {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports profile for this contract. */
-profile: ProjectProfileDefinition;
+profile:ProjectProfileDefinition;
 }
 /** Documents the extension registration registry payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionRegistrationRegistry {
 /** Value that configures or reports commands for this contract. */
-commands: RegisteredExtensionCommandDefinition[];
+commands:RegisteredExtensionCommandDefinition[];
 /** Value that configures or reports flags for this contract. */
-flags: RegisteredExtensionFlagDefinitions[];
+flags:RegisteredExtensionFlagDefinitions[];
 /** Value that configures or reports item fields for this contract. */
-item_fields: RegisteredExtensionSchemaFieldDefinitions[];
+item_fields:RegisteredExtensionSchemaFieldDefinitions[];
 /** Value that configures or reports item types for this contract. */
-item_types: RegisteredExtensionSchemaItemTypeDefinitions[];
+item_types:RegisteredExtensionSchemaItemTypeDefinitions[];
 /** Value that configures application-defined relationship semantics. */
-relationship_kinds: RegisteredExtensionRelationshipKindDefinitions[];
+relationship_kinds:RegisteredExtensionRelationshipKindDefinitions[];
 /** Value that configures or reports migrations for this contract. */
-migrations: RegisteredExtensionSchemaMigrationDefinition[];
+migrations:RegisteredExtensionSchemaMigrationDefinition[];
 /** Value that configures or reports profiles for this contract. */
-profiles: RegisteredExtensionProjectProfile[];
+profiles:RegisteredExtensionProjectProfile[];
 /** Value that configures or reports importers for this contract. */
-importers: RegisteredExtensionImporter[];
+importers:RegisteredExtensionImporter[];
 /** Value that configures or reports exporters for this contract. */
-exporters: RegisteredExtensionExporter[];
+exporters:RegisteredExtensionExporter[];
 /** Value that configures or reports search providers for this contract. */
-search_providers: RegisteredExtensionSearchProvider[];
+search_providers:RegisteredExtensionSearchProvider[];
 /** Value that configures or reports vector store adapters for this contract. */
-vector_store_adapters: RegisteredExtensionVectorStoreAdapter[];
+vector_store_adapters:RegisteredExtensionVectorStoreAdapter[];
 /** Extension-owned assurance measurement providers. */
-assurance_providers: RegisteredExtensionAssuranceMeasurementProvider[];
+assurance_providers:RegisteredExtensionAssuranceMeasurementProvider[];
 }
 /** Documents the extension registration counts payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionRegistrationCounts {
 /** Value that configures or reports commands for this contract. */
-commands: number;
+commands:number;
 /** Value that configures or reports flags for this contract. */
-flags: number;
+flags:number;
 /** Value that configures or reports item fields for this contract. */
-item_fields: number;
+item_fields:number;
 /** Value that configures or reports item types for this contract. */
-item_types: number;
+item_types:number;
 /** Number of application-defined relationship kinds. */
-relationship_kinds?: number;
+relationship_kinds?:number;
 /** Value that configures or reports migrations for this contract. */
-migrations: number;
+migrations:number;
 /** Value that configures or reports profiles for this contract. */
-profiles: number;
+profiles:number;
 /** Value that configures or reports importers for this contract. */
-importers: number;
+importers:number;
 /** Value that configures or reports exporters for this contract. */
-exporters: number;
+exporters:number;
 /** Value that configures or reports search providers for this contract. */
-search_providers: number;
+search_providers:number;
 /** Value that configures or reports vector store adapters for this contract. */
-vector_store_adapters: number;
+vector_store_adapters:number;
 /** Number of registered assurance measurement providers. */
-assurance_providers?: number;
+assurance_providers?:number;
 }
 /** Read-only identity an extension's `activate(api)` receives about itself, so authors can emit self-identifying logs, gate on their own version, and build better error messages without re-reading the on-disk manifest or duplicating metadata in-module. Exposed as `api.extension`. */
 export interface ExtensionSelfIdentity {
 /** Value that configures or reports name for this contract. */
-readonly name: string;
+readonly name:string;
 /** Value that configures or reports layer for this contract. */
-readonly layer: ExtensionLayer;
+readonly layer:ExtensionLayer;
 /** Value that configures or reports version for this contract. */
-readonly version: string;
+readonly version:string;
 /** Value that configures or reports capabilities for this contract. */
-readonly capabilities: readonly ExtensionCapability[];
+readonly capabilities:readonly ExtensionCapability[];
 /** Value that configures or reports pm min version for this contract. */
-readonly pm_min_version?: string;
+readonly pm_min_version?:string;
 /** Value that configures or reports pm max version for this contract. */
-readonly pm_max_version?: string;
+readonly pm_max_version?:string;
 /** Value that configures or reports source package for this contract. */
-readonly source_package?: string;
+readonly source_package?:string;
 }
 /** Documents the extension api payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionApi {
 /** Read-only identity of the extension this `api` was created for. */
-readonly extension: ExtensionSelfIdentity;
+readonly extension:ExtensionSelfIdentity;
 /** Value that configures or reports register command for this contract. */
-registerCommand(command: string, override: CommandOverride): void;
+registerCommand(command:string,override:CommandOverride):void;
 /** Value that configures or reports register command for this contract. */
-registerCommand(definition: CommandDefinition): void;
+registerCommand(definition:CommandDefinition):void;
 /** Value that configures or reports register parser for this contract. */
-registerParser(command: string, override: ParserOverride): void;
+registerParser(command:string,override:ParserOverride):void;
 /** Value that configures or reports register preflight for this contract. */
-registerPreflight(override: PreflightOverride | ScopedPreflightOverrideDefinition): void;
+registerPreflight(override:PreflightOverride | ScopedPreflightOverrideDefinition):void;
 /** Value that configures or reports register service for this contract. */
-registerService(service: ExtensionServiceName, override: ServiceOverride, ownership?: ServiceOverrideOwnership): void;
+registerService(service:ExtensionServiceName,override:ServiceOverride,ownership?:ServiceOverrideOwnership):void;
 /** Value that configures or reports register flags for this contract. */
-registerFlags(targetCommand: string, flags: FlagDefinition[]): void;
+registerFlags(targetCommand:string,flags:FlagDefinition[]):void;
 /** Value that configures or reports register item fields for this contract. */
-registerItemFields(fields: SchemaFieldDefinition[]): void;
+registerItemFields(fields:SchemaFieldDefinition[]):void;
 /** Value that configures or reports register item types for this contract. */
-registerItemTypes(types: SchemaItemTypeDefinition[]): void;
+registerItemTypes(types:SchemaItemTypeDefinition[]):void;
 /** Register versioned relationship semantics consumed by every graph surface. */
-registerRelationshipKinds(definitions: RelationshipKindDefinition[]): void;
+registerRelationshipKinds(definitions:RelationshipKindDefinition[]):void;
 /** Value that configures or reports register migration for this contract. */
-registerMigration(definition: SchemaMigrationDefinition): void;
+registerMigration(definition:SchemaMigrationDefinition):void;
 /** Value that configures or reports register profile for this contract. */
-registerProfile(profile: ProjectProfileRegistrationInput): void;
+registerProfile(profile:ProjectProfileRegistrationInput):void;
 /** Value that configures or reports register renderer for this contract. */
-registerRenderer(format: OutputRendererFormat, renderer: RendererOverride, ownership?: RendererOverrideOwnership): void;
+registerRenderer(format:OutputRendererFormat,renderer:RendererOverride,ownership?:RendererOverrideOwnership):void;
 /** Value that configures or reports register importer for this contract. */
-registerImporter(name: string, importer: Importer, options?: ImportExportRegistrationOptions): void;
+registerImporter(name:string,importer:Importer,options?:ImportExportRegistrationOptions):void;
 /** Value that configures or reports register exporter for this contract. */
-registerExporter(name: string, exporter: Exporter, options?: ExporterRegistrationOptions): void;
+registerExporter(name:string,exporter:Exporter,options?:ExporterRegistrationOptions):void;
 /** Value that configures or reports register search provider for this contract. */
-registerSearchProvider(provider: SearchProviderDefinition): void;
+registerSearchProvider(provider:SearchProviderDefinition):void;
 /** Value that configures or reports register vector store adapter for this contract. */
-registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): void;
+registerVectorStoreAdapter(adapter:VectorStoreAdapterDefinition):void;
 /** Register an assurance measurement provider through the services capability. */
-registerAssuranceMeasurementProvider(provider: AssuranceMeasurementProviderDefinition): void;
+registerAssuranceMeasurementProvider(provider:AssuranceMeasurementProviderDefinition):void;
 /** Value that configures or reports hooks for this contract. */
-hooks: {
-beforeCommand(hook: BeforeCommandHook): void;
-beforeMutation(hook: BeforeMutationHook): void;
-afterCommand(hook: AfterCommandHook): void;
-onWrite(hook: OnWriteHook): void;
-onRead(hook: OnReadHook): void;
-onIndex(hook: OnIndexHook): void;
+hooks:{
+beforeCommand(hook:BeforeCommandHook):void;
+beforeMutation(hook:BeforeMutationHook):void;
+afterCommand(hook:AfterCommandHook):void;
+onWrite(hook:OnWriteHook):void;
+onRead(hook:OnReadHook):void;
+onIndex(hook:OnIndexHook):void;
 };
 }
 /** Documents the failed extension activation payload exchanged by command, SDK, and package integrations. */
 export interface FailedExtensionActivation {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Filesystem path used for entry resolution. */
-entry_path: string;
+entry_path:string;
 /** Value that configures or reports error for this contract. */
-error: string;
+error:string;
 /** Value that configures or reports trace for this contract. */
-trace?: ExtensionActivationFailureTrace;
+trace?:ExtensionActivationFailureTrace;
 }
 /** Documents the extension activation failure trace payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionActivationFailureTrace {
 /** Value that configures or reports method for this contract. */
-method: string;
+method:string;
 /** `-1` means the failure happened before a numbered registration was accepted. */
-registration_index: number;
+registration_index:number;
 /** Value that configures or reports command for this contract. */
-command?: string;
+command?:string;
 /** Value that configures or reports capability for this contract. */
-capability?: ExtensionCapability;
+capability?:ExtensionCapability;
 /** Value that configures or reports missing capability for this contract. */
-missing_capability?: ExtensionCapability;
+missing_capability?:ExtensionCapability;
 /** Value that configures or reports expected schema for this contract. */
-expected_schema: string;
+expected_schema:string;
 /** Value that configures or reports received for this contract. */
-received?: unknown;
+received?:unknown;
 /** Value that configures or reports hint for this contract. */
-hint?: string;
+hint?:string;
 }
 /** Documents the extension activation result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionActivationResult {
 /** Value that configures or reports hooks for this contract. */
-hooks: ExtensionHookRegistry;
+hooks:ExtensionHookRegistry;
 /** Value that configures or reports commands for this contract. */
-commands: ExtensionCommandRegistry;
+commands:ExtensionCommandRegistry;
 /** Value that configures or reports parsers for this contract. */
-parsers: ExtensionParserRegistry;
+parsers:ExtensionParserRegistry;
 /** Value that configures or reports preflight for this contract. */
-preflight: ExtensionPreflightRegistry;
+preflight:ExtensionPreflightRegistry;
 /** Value that configures or reports services for this contract. */
-services: ExtensionServiceRegistry;
+services:ExtensionServiceRegistry;
 /** Value that configures or reports renderers for this contract. */
-renderers: ExtensionRendererRegistry;
+renderers:ExtensionRendererRegistry;
 /** Value that configures or reports registrations for this contract. */
-registrations: ExtensionRegistrationRegistry;
+registrations:ExtensionRegistrationRegistry;
 /** Value that configures or reports failed for this contract. */
-failed: FailedExtensionActivation[];
+failed:FailedExtensionActivation[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports hook counts for this contract. */
-hook_counts: {
-before_command: number;
-before_mutation: number;
-after_command: number;
-on_write: number;
-on_read: number;
-on_index: number;
+hook_counts:{
+before_command:number;
+before_mutation:number;
+after_command:number;
+on_write:number;
+on_read:number;
+on_index:number;
 };
 /** Number of command override entries represented by this result. */
-command_override_count: number;
+command_override_count:number;
 /** Number of command handler entries represented by this result. */
-command_handler_count: number;
+command_handler_count:number;
 /** Number of parser override entries represented by this result. */
-parser_override_count: number;
+parser_override_count:number;
 /** Number of preflight override entries represented by this result. */
-preflight_override_count: number;
+preflight_override_count:number;
 /** Number of service override entries represented by this result. */
-service_override_count: number;
+service_override_count:number;
 /** Number of renderer override entries represented by this result. */
-renderer_override_count: number;
+renderer_override_count:number;
 /** Value that configures or reports registration counts for this contract. */
-registration_counts: ExtensionRegistrationCounts;
+registration_counts:ExtensionRegistrationCounts;
 }
 /** Documents the extension candidate payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCandidate {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports directory for this contract. */
-directory: string;
+directory:string;
 /** Filesystem path used for manifest resolution. */
-manifest_path: string;
+manifest_path:string;
 /** Filesystem path used for entry resolution. */
-entry_path: string;
+entry_path:string;
 /** Declarative package manifest consumed by the extension loader. */
-manifest: ExtensionManifest;
+manifest:ExtensionManifest;
 /** Value that configures or reports source package for this contract. */
-source_package?: string;
+source_package?:string;
 /** Install-source identities that can resolve this extension through package lifecycle commands. */
-source_aliases?: string[];
+source_aliases?:string[];
 /** Persisted contribution inventory resolved without importing the module. */
-contributions?: ExtensionContributionInventory;
+contributions?:ExtensionContributionInventory;
 }
 /** Documents the extension layer scan result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionLayerScanResult {
 /** Value that configures or reports diagnostics for this contract. */
-diagnostics: ExtensionDiagnostic[];
+diagnostics:ExtensionDiagnostic[];
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports candidates for this contract. */
-candidates: ExtensionCandidate[];
+candidates:ExtensionCandidate[];
 }
 /** Documents the scanned extension directory payload exchanged by command, SDK, and package integrations. */
 export interface ScannedExtensionDirectory {
 /** Value that configures or reports diagnostic for this contract. */
-diagnostic: ExtensionDiagnostic;
+diagnostic:ExtensionDiagnostic;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports candidate for this contract. */
-candidate: ExtensionCandidate | null;
+candidate:ExtensionCandidate | null;
 }
 /** Documents the legacy extension capability alias mapping payload exchanged by command, SDK, and package integrations. */
 export interface LegacyExtensionCapabilityAliasMapping {
 /** Value that configures or reports alias for this contract. */
-alias: string;
+alias:string;
 /** Value that configures or reports target for this contract. */
-target: ExtensionCapability;
+target:ExtensionCapability;
 }
 /** Documents the discover extensions options payload exchanged by command, SDK, and package integrations. */
 export interface DiscoverExtensionsOptions {
 /** Value that configures or reports pm root for this contract. */
-pmRoot: string;
+pmRoot:string;
 /** Value that configures or reports settings for this contract. */
-settings: PmSettings;
+settings:PmSettings;
 /** Value that configures or reports cwd for this contract. */
-cwd?: string;
+cwd?:string;
 /** Value that configures or reports no extensions for this contract. */
-noExtensions?: boolean;
+noExtensions?:boolean;
 /** Value that configures or reports ignore global extensions for this contract. */
-ignoreGlobalExtensions?: boolean;
+ignoreGlobalExtensions?:boolean;
 /** Value that configures or reports reload token for this contract. */
-reload_token?: string;
+reload_token?:string;
 /** Value that configures or reports cache bust for this contract. */
-cache_bust?: boolean;
+cache_bust?:boolean;
 /** Optional import-stage filter. Discovery still reports the full effective set, but `loadExtensions` imports only entries accepted by this predicate. */
-extensionFilter?: (extension: EffectiveExtension) => boolean;
+extensionFilter?:(extension:EffectiveExtension) => boolean;
 /** Optional temporary root where each extension is copied before import, giving reinstall verification a fresh absolute module graph rather than cache-busting only the entry module URL. The caller owns cleanup after activation completes. */
-module_graph_snapshot_root?: string;
+module_graph_snapshot_root?:string;
 }
 /** Documents the activatable extension payload exchanged by command, SDK, and package integrations. */
 export interface ActivatableExtension {
 /** Registers this package's commands, actions, and runtime hooks with the host. */
-activate: (api: ExtensionApi) => void | Promise<void>;
+activate:(api:ExtensionApi) => void | Promise<void>;
 /** Optional teardown lifecycle hook, analogous to VS Code's `deactivate` export. Invoked when the host tears the extension down — on long-running MCP-server reload between requests, or via the `deactivateExtensions` primitive — so an extension can close connections, clear timers, and release buffers it opened during `activate`. */
-deactivate?: () => void | Promise<void>;
+deactivate?:() => void | Promise<void>;
 }
 /** Documents the extension deactivation failure payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDeactivationFailure {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports error for this contract. */
-error: string;
+error:string;
 }
 /** Documents the extension deactivation options payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDeactivationOptions {
 /** Maximum time to wait for each extension's `deactivate` hook. Defaults to 5000ms so a hanging teardown cannot block host shutdown or reload. Set to 0 or Infinity only when the host intentionally wants to wait indefinitely. */
-deactivate_timeout_ms?: number;
+deactivate_timeout_ms?:number;
 }
 /** Documents the extension deactivation result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDeactivationResult {
 /** Count of loaded extensions whose `deactivate` hook ran without throwing. */
-deactivated: number;
+deactivated:number;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Value that configures or reports failed for this contract. */
-failed: ExtensionDeactivationFailure[];
+failed:ExtensionDeactivationFailure[];
 }
 /** Documents the service override result payload exchanged by command, SDK, and package integrations. */
 export interface ServiceOverrideResult {
 /** Value that configures or reports handled for this contract. */
-handled: boolean;
+handled:boolean;
 /** Value that configures or reports result for this contract. */
-result: unknown;
+result:unknown;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
 /** Documents the command override result payload exchanged by command, SDK, and package integrations. */
 export interface CommandOverrideResult {
 /** Value that configures or reports overridden for this contract. */
-overridden: boolean;
+overridden:boolean;
 /** Value that configures or reports result for this contract. */
-result: unknown;
+result:unknown;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
 /** Documents the command handler result payload exchanged by command, SDK, and package integrations. */
 export interface CommandHandlerResult {
 /** Value that configures or reports handled for this contract. */
-handled: boolean;
+handled:boolean;
 /** Value that configures or reports result for this contract. */
-result: unknown;
+result:unknown;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** Human-readable, single-line, length-bounded message describing why an extension command handler failed. Surfaced to the user/CI so the real cause (e.g. "Changelog is out of date: CHANGELOG.md") is visible instead of only the opaque `extension_command_handler_failed` warning code. */
-errorMessage?: string;
+errorMessage?:string;
 /** Validated non-zero process status requested by a structured handler result. */
-exitCode?: number;
+exitCode?:number;
 /** Stable extension-provided error code preserved for structured recovery. */
-errorCode?: string;
+errorCode?:string;
 /** Actionable extension-provided recovery text preserved by the host. */
-remediation?: string;
+remediation?:string;
 }
 /** Documents the parser override result payload exchanged by command, SDK, and package integrations. */
 export interface ParserOverrideResult {
 /** Value that configures or reports overridden for this contract. */
-overridden: boolean;
+overridden:boolean;
 /** Value that configures or reports context for this contract. */
-context: CommandHandlerContext;
+context:CommandHandlerContext;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
 /** Documents the preflight override result payload exchanged by command, SDK, and package integrations. */
 export interface PreflightOverrideResult {
 /** Value that configures or reports overridden for this contract. */
-overridden: boolean;
+overridden:boolean;
 /** Value that configures or reports context for this contract. */
-context: CommandHandlerContext;
+context:CommandHandlerContext;
 /** Value that configures or reports decision for this contract. */
-decision: PreflightRuntimeDecision;
+decision:PreflightRuntimeDecision;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
 /** Documents the renderer override result payload exchanged by command, SDK, and package integrations. */
 export interface RendererOverrideResult {
 /** Value that configures or reports overridden for this contract. */
-overridden: boolean;
+overridden:boolean;
 /** Value that configures or reports rendered for this contract. */
-rendered: string | null;
+rendered:string | null;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 }
 /** Documents the unknown extension capability warning details payload exchanged by command, SDK, and package integrations. */
 export interface UnknownExtensionCapabilityWarningDetails {
 /** Value that configures or reports layer for this contract. */
-layer: ExtensionLayer;
+layer:ExtensionLayer;
 /** Value that configures or reports name for this contract. */
-name: string;
+name:string;
 /** Value that configures or reports capability for this contract. */
-capability: string;
+capability:string;
 /** Value that configures or reports allowed capabilities for this contract. */
-allowed_capabilities: string[];
+allowed_capabilities:string[];
 /** Value that configures or reports capability contract version for this contract. */
-capability_contract_version: number;
+capability_contract_version:number;
 /** Value that configures or reports suggested capability for this contract. */
-suggested_capability?: string;
+suggested_capability?:string;
 /** Value that configures or reports suggestion source for this contract. */
-suggestion_source?: "legacy_alias" | "nearest_match";
+suggestion_source?:"legacy_alias" | "nearest_match";
 /** Value that configures or reports legacy alias target for this contract. */
-legacy_alias_target?: string;
+legacy_alias_target?:string;
 }