@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/sdk/testing.d.ts

@@ -3,43 +3,47 @@
  *
  * Defines public SDK APIs and package-author helpers for Testing.
  */
-import type { AfterCommandHookContext, BeforeCommandHookContext, BeforeMutationHookContext, CommandHandlerResult, CommandOverrideContext, CommandOverrideResult, ExtensionActivationResult, ExtensionCapability, ExtensionCommandRegistry, ExtensionDeactivationResult, ExtensionGovernancePolicy, ExtensionHookRegistry, ExtensionCommandSdk, ExtensionLayer, ExtensionManifest, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceName, ExtensionServiceRegistry, FlagDefinition, OnIndexHookContext, OnReadHookContext, OnWriteHookContext, OutputRendererFormat, ParserOverrideContext, ParserOverrideResult, PreflightOverrideContext, PreflightOverrideResult, RegisteredExtensionCommandDefinition, RegisteredExtensionCommandOverride, RegisteredExtensionExporter, RegisteredExtensionFlagDefinitions, RegisteredExtensionImporter, RegisteredExtensionParserOverride, RegisteredExtensionPreflightOverride, RegisteredExtensionProjectProfile, RegisteredExtensionRendererOverride, RegisteredExtensionSchemaFieldDefinitions, RegisteredExtensionSchemaItemTypeDefinitions, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverrideContext, RendererOverrideResult, SchemaFieldDefinition, SchemaItemTypeDefinition, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderQueryContext, SearchProviderQueryExpansionContext, SearchProviderQueryExpansionResult, SearchProviderQueryResult, SearchProviderRerankContext, SearchProviderRerankResult, ServiceOverrideContext, ServiceOverrideResult, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext } from "../core/extensions/loader.js";
-import { describeExtensionBlueprint, lintExtensionBlueprint } from "./compose.js";
+import type { AfterCommandHookContext,BeforeCommandHookContext,BeforeMutationHookContext,CommandHandlerResult,CommandOverrideContext,CommandOverrideResult,ExtensionActivationResult,ExtensionCapability,ExtensionCommandRegistry,ExtensionDeactivationResult,ExtensionGovernancePolicy,ExtensionHookRegistry,ExtensionCommandSdk,ExtensionLayer,ExtensionManifest,ExtensionParserRegistry,ExtensionPreflightRegistry,ExtensionRegistrationRegistry,ExtensionRendererRegistry,ExtensionServiceName,ExtensionServiceRegistry,FlagDefinition,OnIndexHookContext,OnReadHookContext,OnWriteHookContext,OutputRendererFormat,ParserOverrideContext,ParserOverrideResult,PreflightOverrideContext,PreflightOverrideResult,RegisteredExtensionCommandDefinition,RegisteredExtensionCommandOverride,RegisteredExtensionExporter,RegisteredExtensionFlagDefinitions,RegisteredExtensionImporter,RegisteredExtensionParserOverride,RegisteredExtensionPreflightOverride,RegisteredExtensionProjectProfile,RegisteredExtensionRendererOverride,RegisteredExtensionSchemaFieldDefinitions,RegisteredExtensionSchemaItemTypeDefinitions,RegisteredExtensionSchemaMigrationDefinition,RegisteredExtensionSearchProvider,RegisteredExtensionServiceOverride,RegisteredExtensionVectorStoreAdapter,RendererOverrideContext,RendererOverrideResult,SchemaFieldDefinition,SchemaItemTypeDefinition,SearchProviderEmbedBatchContext,SearchProviderEmbedContext,SearchProviderQueryContext,SearchProviderQueryExpansionContext,SearchProviderQueryExpansionResult,SearchProviderQueryResult,SearchProviderRerankContext,SearchProviderRerankResult,ServiceOverrideContext,ServiceOverrideResult,VectorStoreDeleteContext,VectorStoreQueryContext,VectorStoreQueryHit,VectorStoreUpsertContext } from "../core/extensions/loader.js";
+import { describeExtensionBlueprint,lintExtensionBlueprint } from "./compose.js";
 import { describeExtensionActivation } from "../core/extensions/activation-summary.js";
-import type { DescribeExtensionActivationOptions, ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
+import type { DescribeExtensionActivationOptions,ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
 import type { ProjectProfileDefinition } from "../core/profile/profile-presets.js";
 import { type ProjectProfileLintReport } from "../core/profile/profile-lint.js";
 import { renderExtensionSurfaceMarkdown } from "../core/extensions/activation-summary-markdown.js";
 import type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activation-summary-markdown.js";
-import type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, ExtensionManifestCompatibilityManifest, ExtensionManifestCompatibilityResult, ExtensionManifestCompatibilityTarget, ExtensionPreflightReport, LintExtensionBlueprintOptions, PreflightExtensionOptions } from "./compose.js";
+import type { ExtensionBlueprint,ExtensionBlueprintLintCode,ExtensionBlueprintLintFinding,ExtensionBlueprintLintResult,ExtensionBlueprintLintSeverity,ExtensionManifestCompatibilityManifest,ExtensionManifestCompatibilityResult,ExtensionManifestCompatibilityTarget,ExtensionPreflightReport,LintExtensionBlueprintOptions,PreflightExtensionOptions } from "./compose.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
-import type { PmPackageManifest, PmPackageResourceKind } from "../core/packages/manifest.js";
-export { describeExtensionActivation, renderExtensionSurfaceMarkdown };
-export type { DescribeExtensionActivationOptions, ExtensionActivationSummary, } from "../core/extensions/activation-summary.js";
+import type { PmPackageManifest,PmPackageResourceKind } from "../core/packages/manifest.js";
+/** Host-pinned TOON codecs for semantic package-output assertions without deep imports. */
+export { decode as decodeToon,encode as encodeToon } from "@toon-format/toon";
+/** Codec options and JSON values owned by the exact implementation used by the host. */
+export type { DecodeOptions as ToonDecodeOptions,EncodeOptions as ToonEncodeOptions,JsonValue as ToonJsonValue } from "@toon-format/toon";
+export { describeExtensionActivation,renderExtensionSurfaceMarkdown };
+export type { DescribeExtensionActivationOptions,ExtensionActivationSummary,} from "../core/extensions/activation-summary.js";
 export type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activation-summary-markdown.js";
-export { describeExtensionBlueprint, lintExtensionBlueprint };
-export type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, LintExtensionBlueprintOptions, };
+export { describeExtensionBlueprint,lintExtensionBlueprint };
+export type { ExtensionBlueprint,ExtensionBlueprintLintCode,ExtensionBlueprintLintFinding,ExtensionBlueprintLintResult,ExtensionBlueprintLintSeverity,LintExtensionBlueprintOptions,};
 /** Documents the activate extension for test options payload exchanged by command, SDK, and package integrations. */
 export interface ActivateExtensionForTestOptions {
 /** Value that configures or reports name for this contract. */
-name?: string;
+name?:string;
 /** Value that configures or reports layer for this contract. */
-layer?: ExtensionLayer;
+layer?:ExtensionLayer;
 /** Value that configures or reports capabilities for this contract. */
-capabilities?: readonly ExtensionCapability[];
+capabilities?:readonly ExtensionCapability[];
 /** Value that configures or reports policy for this contract. */
-policy?: ExtensionGovernancePolicy;
+policy?:ExtensionGovernancePolicy;
 }
 /** Documents the deactivate extension for test options payload exchanged by command, SDK, and package integrations. */
 export interface DeactivateExtensionForTestOptions {
 /** Overrides the in-memory extension name (defaults to `manifest.name` or `"test-extension"`). */
-name?: string;
+name?:string;
 /** Overrides the layer recorded for the in-memory extension (defaults to `"project"`). */
-layer?: ExtensionLayer;
+layer?:ExtensionLayer;
 /** Activation result returned by `activateExtensionForTest`. When provided, an extension whose `activate` failed is skipped — mirroring the host teardown contract that never deactivates a never-initialized extension. Pass the same `name`/`layer` to both helpers so the skip key matches. */
-activation?: Pick<ExtensionActivationResult, "failed">;
+activation?:Pick<ExtensionActivationResult,"failed">;
 /** Per-hook teardown bound, forwarded as `deactivate_timeout_ms`. Use `0` (or `Infinity`) to wait indefinitely; omit to keep the host default. */
-deactivateTimeoutMs?: number;
+deactivateTimeoutMs?:number;
 }
 /**
  * Options for {@link runRegisteredCommandForTest} — the inputs forwarded to a
@@ -47,28 +51,28 @@ deactivateTimeoutMs?: number;
  */
 export interface RunRegisteredCommandForTestOptions {
 /** Full registered command path to invoke, e.g. `"hello"` or `"todos import"`. Matched against `commands.handlers[].command` after normalization (trimmed, lower-cased, internal whitespace collapsed), mirroring runtime dispatch. */
-command: string;
+command:string;
 /** Positional arguments forwarded as `context.args` (default: none). */
-args?: readonly string[];
+args?:readonly string[];
 /** Parsed flags/options forwarded as `context.options` (default: none). */
-options?: Record<string, unknown>;
+options?:Record<string,unknown>;
 /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
-global?: Partial<GlobalOptions>;
+global?:Partial<GlobalOptions>;
 /** Resolved tracker storage root forwarded as `context.pm_root` (default: `""`), normally `<workspace>/.agents/pm`; this is not the workspace root. */
-pmRoot?: string;
+pmRoot?:string;
 /** Explicit host SDK override for specialized tests. Mutually exclusive with sdkFactory. */
-sdk?: ExtensionCommandSdk;
+sdk?:ExtensionCommandSdk;
 /** Lazily build a typed host SDK override from the resolved test context. `pmRoot` is the tracker storage root (normally `<workspace>/.agents/pm`), not the workspace root. */
-sdkFactory?: (context: {
+sdkFactory?:(context:{
 /** Tracker storage root for tracker data under `.agents/pm`, not the workspace root. */
-pmRoot: string;
-global: GlobalOptions;
+pmRoot:string;
+global:GlobalOptions;
 }) => ExtensionCommandSdk;
 }
 /** Options for invoking a registered transactional mutation guard in package tests. */
 export interface RunRegisteredMutationGuardForTestOptions {
 /** Synthetic proposed mutation context, including a host-bound read-only SDK. */
-context: BeforeMutationHookContext;
+context:BeforeMutationHookContext;
 }
 /**
  * Options for {@link runRegisteredHookForTest} — the lifecycle `kind` to fire and
@@ -80,20 +84,20 @@ context: BeforeMutationHookContext;
  * pass an index context to a read hook.
  */
 export type RunRegisteredHookForTestOptions = {
-kind: "before_command";
-context: BeforeCommandHookContext;
+kind:"before_command";
+context:BeforeCommandHookContext;
 } | {
-kind: "after_command";
-context: AfterCommandHookContext;
+kind:"after_command";
+context:AfterCommandHookContext;
 } | {
-kind: "on_read";
-context: OnReadHookContext;
+kind:"on_read";
+context:OnReadHookContext;
 } | {
-kind: "on_write";
-context: OnWriteHookContext;
+kind:"on_write";
+context:OnWriteHookContext;
 } | {
-kind: "on_index";
-context: OnIndexHookContext;
+kind:"on_index";
+context:OnIndexHookContext;
 };
 /**
  * Maps each invokable search-provider operation to the context type its function
@@ -104,15 +108,15 @@ context: OnIndexHookContext;
  */
 export interface SearchProviderOperationContexts {
 /** Value that configures or reports query for this contract. */
-query: SearchProviderQueryContext;
+query:SearchProviderQueryContext;
 /** Value that configures or reports embed for this contract. */
-embed: SearchProviderEmbedContext;
+embed:SearchProviderEmbedContext;
 /** Value that configures or reports embed batch for this contract. */
-embedBatch: SearchProviderEmbedBatchContext;
+embedBatch:SearchProviderEmbedBatchContext;
 /** Value that configures or reports query expansion for this contract. */
-queryExpansion: SearchProviderQueryExpansionContext;
+queryExpansion:SearchProviderQueryExpansionContext;
 /** Value that configures or reports rerank for this contract. */
-rerank: SearchProviderRerankContext;
+rerank:SearchProviderRerankContext;
 }
 /**
  * Maps each invokable search-provider operation to the result type its function
@@ -121,15 +125,15 @@ rerank: SearchProviderRerankContext;
  */
 export interface SearchProviderOperationResults {
 /** Value that configures or reports query for this contract. */
-query: SearchProviderQueryResult;
+query:SearchProviderQueryResult;
 /** Value that configures or reports embed for this contract. */
-embed: number[];
+embed:number[];
 /** Value that configures or reports embed batch for this contract. */
-embedBatch: number[][];
+embedBatch:number[][];
 /** Value that configures or reports query expansion for this contract. */
-queryExpansion: SearchProviderQueryExpansionResult;
+queryExpansion:SearchProviderQueryExpansionResult;
 /** Value that configures or reports rerank for this contract. */
-rerank: SearchProviderRerankResult;
+rerank:SearchProviderRerankResult;
 }
 /**
  * Options for {@link runRegisteredSearchProviderForTest}: the registered
@@ -140,13 +144,13 @@ rerank: SearchProviderRerankResult;
  * {@link SearchProviderRerankContext}, and so on.
  */
 export type RunRegisteredSearchProviderForTestOptions = {
-[Operation in keyof SearchProviderOperationContexts]: {
+[Operation in keyof SearchProviderOperationContexts]:{
 /** Registered provider name to resolve, matched case-insensitively as the host does. */
-provider: string;
+provider:string;
 /** Provider operation to invoke. */
-operation: Operation;
+operation:Operation;
 /** Synthetic context handed to the resolved operation function. */
-context: SearchProviderOperationContexts[Operation];
+context:SearchProviderOperationContexts[Operation];
 };
 }[keyof SearchProviderOperationContexts];
 /**
@@ -157,11 +161,11 @@ context: SearchProviderOperationContexts[Operation];
  */
 export interface VectorStoreAdapterOperationContexts {
 /** Value that configures or reports query for this contract. */
-query: VectorStoreQueryContext;
+query:VectorStoreQueryContext;
 /** Value that configures or reports upsert for this contract. */
-upsert: VectorStoreUpsertContext;
+upsert:VectorStoreUpsertContext;
 /** Value that configures or reports delete for this contract. */
-delete: VectorStoreDeleteContext;
+delete:VectorStoreDeleteContext;
 }
 /**
  * Maps each invokable vector-store-adapter operation to the result type its
@@ -171,11 +175,11 @@ delete: VectorStoreDeleteContext;
  */
 export interface VectorStoreAdapterOperationResults {
 /** Value that configures or reports query for this contract. */
-query: VectorStoreQueryHit[];
+query:VectorStoreQueryHit[];
 /** Value that configures or reports upsert for this contract. */
-upsert: unknown;
+upsert:unknown;
 /** Value that configures or reports delete for this contract. */
-delete: unknown;
+delete:unknown;
 }
 /**
  * Options for {@link runRegisteredVectorStoreAdapterForTest}: the registered
@@ -186,13 +190,13 @@ delete: unknown;
  * {@link VectorStoreDeleteContext}, and so on.
  */
 export type RunRegisteredVectorStoreAdapterForTestOptions = {
-[Operation in keyof VectorStoreAdapterOperationContexts]: {
+[Operation in keyof VectorStoreAdapterOperationContexts]:{
 /** Registered adapter name to resolve, matched case-insensitively as the host does. */
-adapter: string;
+adapter:string;
 /** Adapter operation to invoke. */
-operation: Operation;
+operation:Operation;
 /** Synthetic context handed to the resolved operation function. */
-context: VectorStoreAdapterOperationContexts[Operation];
+context:VectorStoreAdapterOperationContexts[Operation];
 };
 }[keyof VectorStoreAdapterOperationContexts];
 /**
@@ -201,11 +205,11 @@ context: VectorStoreAdapterOperationContexts[Operation];
  */
 export interface RunRegisteredMigrationForTestOptions {
 /** Registered migration id to resolve, matched case-insensitively against `definition.id`. */
-migration: string;
+migration:string;
 /** Optional extension name to disambiguate when several extensions register the same id. */
-extensionName?: string;
+extensionName?:string;
 /** Resolved pm workspace root forwarded as `context.pm_root` (default `""`). */
-pmRoot?: string;
+pmRoot?:string;
 }
 /**
  * Options for {@link runRegisteredImporterForTest} — the registered importer name
@@ -218,17 +222,17 @@ pmRoot?: string;
  */
 export interface RunRegisteredImporterForTestOptions {
 /** Registered importer name to resolve, e.g. `"csv"` for a `"csv import"` handler. */
-importer: string;
+importer:string;
 /** Optional extension name to disambiguate when several extensions register the same importer. */
-extensionName?: string;
+extensionName?:string;
 /** Positional arguments forwarded as `context.args` (default: none). */
-args?: readonly string[];
+args?:readonly string[];
 /** Parsed flags/options forwarded as `context.options` (default: none). */
-options?: Record<string, unknown>;
+options?:Record<string,unknown>;
 /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
-global?: Partial<GlobalOptions>;
+global?:Partial<GlobalOptions>;
 /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
-pmRoot?: string;
+pmRoot?:string;
 }
 /**
  * Options for {@link runRegisteredExporterForTest} — the registered exporter name
@@ -241,186 +245,186 @@ pmRoot?: string;
  */
 export interface RunRegisteredExporterForTestOptions {
 /** Registered exporter name to resolve, e.g. `"csv"` for a `"csv export"` handler. */
-exporter: string;
+exporter:string;
 /** Optional extension name to disambiguate when several extensions register the same exporter. */
-extensionName?: string;
+extensionName?:string;
 /** Positional arguments forwarded as `context.args` (default: none). */
-args?: readonly string[];
+args?:readonly string[];
 /** Parsed flags/options forwarded as `context.options` (default: none). */
-options?: Record<string, unknown>;
+options?:Record<string,unknown>;
 /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
-global?: Partial<GlobalOptions>;
+global?:Partial<GlobalOptions>;
 /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
-pmRoot?: string;
+pmRoot?:string;
 }
 /** Documents the extension deactivation expectation payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionDeactivationExpectation {
 /** Expected count of extensions whose `deactivate` ran without throwing (default `1`). */
-deactivated?: number;
+deactivated?:number;
 /** Expected count of teardown failures (default `0`). */
-failed?: number;
+failed?:number;
 }
-type NamedRegistrationExpectation<TLegacyKey extends string, TValue, TDetails extends object = Record<never, never>> = TDetails & (({
-name: TValue;
-} & Partial<Record<TLegacyKey, TValue>>) | ({
-name?: TValue;
-} & Record<TLegacyKey, TValue>));
+type NamedRegistrationExpectation<TLegacyKey extends string,TValue,TDetails extends object = Record<never,never>> = TDetails & (({
+name:TValue;
+} & Partial<Record<TLegacyKey,TValue>>) | ({
+name?:TValue;
+} & Record<TLegacyKey,TValue>));
 /** Documents the registered command contract expectation payload exchanged by command, SDK, and package integrations. `name` is canonical; `command` remains a backward-compatible alias. */
-export type RegisteredCommandContractExpectation = NamedRegistrationExpectation<"command", string, {
+export type RegisteredCommandContractExpectation = NamedRegistrationExpectation<"command",string,{
 /** Value that configures or reports action for this contract. */
-action?: string;
+action?:string;
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 /** Value that configures or reports arguments for this contract. */
-arguments?: string[];
+arguments?:string[];
 /** Value that configures or reports flags for this contract. */
-flags?: string[];
+flags?:string[];
 }>;
 /** Documents the registered command contract assertion payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredCommandContractAssertion {
 /** Value that configures or reports command for this contract. */
-command: RegisteredExtensionCommandDefinition;
+command:RegisteredExtensionCommandDefinition;
 /** Value that configures or reports flags for this contract. */
-flags: FlagDefinition[];
+flags:FlagDefinition[];
 }
 /** Documents the registered flags expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredFlagsExpectation = NamedRegistrationExpectation<"targetCommand", string, {
+export type RegisteredFlagsExpectation = NamedRegistrationExpectation<"targetCommand",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 /** Value that configures or reports flags for this contract. */
-flags?: string[];
+flags?:string[];
 }>;
 /** Public hook lifecycle kinds an extension can register through `api.hooks.*`. */
 export type RegisteredHookKind = "before_command" | "before_mutation" | "after_command" | "on_read" | "on_write" | "on_index";
-declare const HOOK_KIND_TO_REGISTRY_FIELD: Record<RegisteredHookKind, keyof ExtensionHookRegistry>;
+declare const HOOK_KIND_TO_REGISTRY_FIELD:Record<RegisteredHookKind,keyof ExtensionHookRegistry>;
 type RegisteredHookEntry<TKind extends RegisteredHookKind> = NonNullable<ExtensionHookRegistry[(typeof HOOK_KIND_TO_REGISTRY_FIELD)[TKind]]>[number];
 /** Documents the registered hook expectation payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredHookExpectation {
 /** Value that configures or reports kind for this contract. */
-kind: RegisteredHookKind;
+kind:RegisteredHookKind;
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }
 /** Documents the registered search provider expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredSearchProviderExpectation = NamedRegistrationExpectation<"provider", string, {
+export type RegisteredSearchProviderExpectation = NamedRegistrationExpectation<"provider",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }>;
 /** Documents the registered vector store adapter expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredVectorStoreAdapterExpectation = NamedRegistrationExpectation<"adapter", string, {
+export type RegisteredVectorStoreAdapterExpectation = NamedRegistrationExpectation<"adapter",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }>;
 /** Documents the registered importer expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredImporterExpectation = NamedRegistrationExpectation<"importer", string, {
+export type RegisteredImporterExpectation = NamedRegistrationExpectation<"importer",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }>;
 /** Documents the registered exporter expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredExporterExpectation = NamedRegistrationExpectation<"exporter", string, {
+export type RegisteredExporterExpectation = NamedRegistrationExpectation<"exporter",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }>;
 /** Documents the registered item field expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredItemFieldExpectation = NamedRegistrationExpectation<"field", string, {
+export type RegisteredItemFieldExpectation = NamedRegistrationExpectation<"field",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 /** Schema type that determines the shape and validation rules for this value. */
-type?: SchemaFieldDefinition["type"];
+type?:SchemaFieldDefinition["type"];
 }>;
 /** Documents the registered item field assertion payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredItemFieldAssertion {
 /** Value that configures or reports registration for this contract. */
-registration: RegisteredExtensionSchemaFieldDefinitions;
+registration:RegisteredExtensionSchemaFieldDefinitions;
 /** Value that configures or reports field for this contract. */
-field: SchemaFieldDefinition;
+field:SchemaFieldDefinition;
 }
 /** Documents the registered item type expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredItemTypeExpectation = NamedRegistrationExpectation<"itemType", string, {
+export type RegisteredItemTypeExpectation = NamedRegistrationExpectation<"itemType",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 /** Value that configures or reports folder for this contract. */
-folder?: string;
+folder?:string;
 }>;
 /** Documents the registered item type assertion payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredItemTypeAssertion {
 /** Value that configures or reports registration for this contract. */
-registration: RegisteredExtensionSchemaItemTypeDefinitions;
+registration:RegisteredExtensionSchemaItemTypeDefinitions;
 /** Schema type that determines the shape and validation rules for this value. */
-itemType: SchemaItemTypeDefinition;
+itemType:SchemaItemTypeDefinition;
 }
 /** Documents the registered command override expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredCommandOverrideExpectation = NamedRegistrationExpectation<"command", string, {
+export type RegisteredCommandOverrideExpectation = NamedRegistrationExpectation<"command",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }>;
 /** Documents the registered parser override expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredParserOverrideExpectation = NamedRegistrationExpectation<"command", string, {
+export type RegisteredParserOverrideExpectation = NamedRegistrationExpectation<"command",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }>;
 /** Documents the registered preflight override expectation payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredPreflightOverrideExpectation {
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }
 /** Documents the registered renderer override expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredRendererOverrideExpectation = NamedRegistrationExpectation<"format", OutputRendererFormat, {
+export type RegisteredRendererOverrideExpectation = NamedRegistrationExpectation<"format",OutputRendererFormat,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }>;
 /** Documents the registered service override expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredServiceOverrideExpectation = NamedRegistrationExpectation<"service", ExtensionServiceName, {
+export type RegisteredServiceOverrideExpectation = NamedRegistrationExpectation<"service",ExtensionServiceName,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 }>;
 /** Documents the registered migration expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredMigrationExpectation = NamedRegistrationExpectation<"migration", string, {
+export type RegisteredMigrationExpectation = NamedRegistrationExpectation<"migration",string,{
 /** Value that configures or reports extension name for this contract. */
-extensionName?: string;
+extensionName?:string;
 /** Value that configures or reports mandatory for this contract. */
-mandatory?: boolean;
+mandatory?:boolean;
 }>;
 /** Documents the registered project-profile expectation payload exchanged by command, SDK, and package integrations. */
-export type RegisteredProfileExpectation = NamedRegistrationExpectation<"profile", string, {
+export type RegisteredProfileExpectation = NamedRegistrationExpectation<"profile",string,{
 /** Restrict the match to a single extension when several are active. */
-extensionName?: string;
+extensionName?:string;
 }>;
 /** Documents the registered project-profile assertion payload exchanged by command, SDK, and package integrations. */
 export interface RegisteredProfileAssertion {
 /** The matching registration entry. */
-registration: RegisteredExtensionProjectProfile;
+registration:RegisteredExtensionProjectProfile;
 /** The registered profile definition. */
-profile: ProjectProfileDefinition;
+profile:ProjectProfileDefinition;
 }
 /** Documents the extension capability usage expectation payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCapabilityUsageExpectation {
 /** Capabilities the manifest declares. Mirror `manifest.capabilities` here so the assertion fails when the manifest grants more than the code uses. */
-declared: readonly ExtensionCapability[];
+declared:readonly ExtensionCapability[];
 /** Restrict reconciliation to a single extension when the activation has several. */
-extensionName?: string;
+extensionName?:string;
 /** Capabilities allowed to be declared without being exercised (e.g. ones a runtime registers only behind a config flag). These are excluded from the least-privilege failure. */
-allowUnused?: readonly ExtensionCapability[];
+allowUnused?:readonly ExtensionCapability[];
 }
 /** Documents the extension capability usage assertion payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCapabilityUsageAssertion {
 /** Declared capabilities considered, sorted and de-duplicated. */
-declared: ExtensionCapability[];
+declared:ExtensionCapability[];
 /** Capabilities the extension actually registered against, sorted. */
-used: ExtensionCapability[];
+used:ExtensionCapability[];
 /** Declared capabilities with no matching registration after the allowlist. */
-unused: ExtensionCapability[];
+unused:ExtensionCapability[];
 }
 /** Restricts package manifest resource expectation values accepted by command, SDK, and storage contracts. */
-export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;
+export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind,readonly string[]>>;
 /** Documents the package manifest expectation payload exchanged by command, SDK, and package integrations. */
 export interface PackageManifestExpectation {
 /** Value that configures or reports package name for this contract. */
-packageName?: string;
+packageName?:string;
 /** Value that configures or reports aliases for this contract. */
-aliases?: readonly string[];
+aliases?:readonly string[];
 /** Value that configures or reports resources for this contract. */
-resources?: PackageManifestResourceExpectation;
+resources?:PackageManifestResourceExpectation;
 }
 /**
  * Options for {@link ExtensionTestHarness.renderMarkdown}.
@@ -430,7 +434,7 @@ export interface RenderExtensionHarnessMarkdownOptions extends ExtensionSurfaceM
      * Restrict the rendered summary to one activated extension by name. Defaults
      * to the full activation union, matching {@link ExtensionTestHarness.activationSummary}.
      */
-extensionName?: string;
+extensionName?:string;
 }
 /**
  * Activate one in-memory extension module for package tests.
@@ -438,7 +442,7 @@ extensionName?: string;
  * This uses pm's real registration validation and activation engine while
  * avoiding private loader imports, filesystem manifests, or workspace setup.
  */
-export declare function activateExtensionForTest(module: unknown, options?: ActivateExtensionForTestOptions): Promise<ExtensionActivationResult>;
+export declare function activateExtensionForTest(module:unknown,options?:ActivateExtensionForTestOptions):Promise<ExtensionActivationResult>;
 /**
  * Deactivate one in-memory extension module for package tests — the teardown
  * counterpart to {@link activateExtensionForTest}.
@@ -450,7 +454,7 @@ export declare function activateExtensionForTest(module: unknown, options?: Acti
  * workspace. Resolve `name`/`layer` the same way {@link activateExtensionForTest}
  * does so a forwarded `activation` result skips a failed extension correctly.
  */
-export declare function deactivateExtensionForTest(module: unknown, options?: DeactivateExtensionForTestOptions): Promise<ExtensionDeactivationResult>;
+export declare function deactivateExtensionForTest(module:unknown,options?:DeactivateExtensionForTestOptions):Promise<ExtensionDeactivationResult>;
 /**
  * Invoke a registered extension command handler and return its real
  * {@link CommandHandlerResult} so package tests can assert on behavior — not
@@ -476,9 +480,9 @@ export declare function deactivateExtensionForTest(module: unknown, options?: De
  * asserted. A handler that throws an error carrying a numeric `exitCode`
  * propagates the throw, matching runtime semantics.
  */
-export declare function runRegisteredCommandForTest(commands: ExtensionCommandRegistry, options: RunRegisteredCommandForTestOptions): Promise<CommandHandlerResult>;
+export declare function runRegisteredCommandForTest(commands:ExtensionCommandRegistry,options:RunRegisteredCommandForTestOptions):Promise<CommandHandlerResult>;
 /** Invoke registered transactional mutation guards through the same fail-closed runtime used by real writes. */
-export declare function runRegisteredMutationGuardForTest(hooks: ExtensionHookRegistry, options: RunRegisteredMutationGuardForTestOptions): Promise<void>;
+export declare function runRegisteredMutationGuardForTest(hooks:ExtensionHookRegistry,options:RunRegisteredMutationGuardForTestOptions):Promise<void>;
 /**
  * Fire every registered lifecycle hook of a given `kind` through pm's real hook
  * runner and return the warnings array so package tests can assert on behavior —
@@ -498,7 +502,7 @@ export declare function runRegisteredMutationGuardForTest(hooks: ExtensionHookRe
  * when no hook of `kind` is registered, since firing a hook the extension never
  * registered is a wiring/typo bug in the test rather than a behavior under test.
  */
-export declare function runRegisteredHookForTest(hooks: ExtensionHookRegistry, options: RunRegisteredHookForTestOptions): Promise<string[]>;
+export declare function runRegisteredHookForTest(hooks:ExtensionHookRegistry,options:RunRegisteredHookForTestOptions):Promise<string[]>;
 /**
  * Invoke a registered parser override through pm's real runner and return the
  * resolved {@link ParserOverrideResult}, so package tests can assert the rewritten
@@ -511,7 +515,7 @@ export declare function runRegisteredHookForTest(hooks: ExtensionHookRegistry, o
  * context on success, or `overridden: false` with an
  * `extension_parser_override_failed:*` warning when the override throws.
  */
-export declare function runRegisteredParserOverrideForTest(parsers: ExtensionParserRegistry, context: ParserOverrideContext): Promise<ParserOverrideResult>;
+export declare function runRegisteredParserOverrideForTest(parsers:ExtensionParserRegistry,context:ParserOverrideContext):Promise<ParserOverrideResult>;
 /**
  * Invoke the active preflight override through pm's real runner and return the
  * resolved {@link PreflightOverrideResult}, so package tests can assert the
@@ -524,7 +528,7 @@ export declare function runRegisteredParserOverrideForTest(parsers: ExtensionPar
  * or `overridden: false` with an `extension_preflight_override_failed:*` warning
  * when the override throws.
  */
-export declare function runRegisteredPreflightOverrideForTest(preflight: ExtensionPreflightRegistry, context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
+export declare function runRegisteredPreflightOverrideForTest(preflight:ExtensionPreflightRegistry,context:PreflightOverrideContext):Promise<PreflightOverrideResult>;
 /**
  * Invoke a registered command-result override through pm's real runner and return
  * the resolved {@link CommandOverrideResult}, so package tests can assert how an
@@ -539,7 +543,7 @@ export declare function runRegisteredPreflightOverrideForTest(preflight: Extensi
  * runtime emits when an override returns a Promise (command overrides are
  * synchronous), or an `extension_command_override_failed:*` warning on throw.
  */
-export declare function runRegisteredCommandOverrideForTest(commands: ExtensionCommandRegistry, context: CommandOverrideContext): Promise<CommandOverrideResult>;
+export declare function runRegisteredCommandOverrideForTest(commands:ExtensionCommandRegistry,context:CommandOverrideContext):Promise<CommandOverrideResult>;
 /**
  * Invoke a registered renderer override through pm's real runner and return the
  * resolved {@link RendererOverrideResult}, so package tests can assert the custom
@@ -552,7 +556,7 @@ export declare function runRegisteredCommandOverrideForTest(commands: ExtensionC
  * `extension_renderer_invalid_result:*` / `extension_renderer_failed:*` warning
  * where applicable) when the override returns a non-string or throws.
  */
-export declare function runRegisteredRendererOverrideForTest(renderers: ExtensionRendererRegistry, context: RendererOverrideContext): Promise<RendererOverrideResult>;
+export declare function runRegisteredRendererOverrideForTest(renderers:ExtensionRendererRegistry,context:RendererOverrideContext):Promise<RendererOverrideResult>;
 /**
  * Invoke a registered service override through pm's real runner and return the
  * resolved {@link ServiceOverrideResult}, so package tests can assert how an
@@ -564,7 +568,7 @@ export declare function runRegisteredRendererOverrideForTest(renderers: Extensio
  * the override's result when it claims the payload, or `handled: false` with the
  * original payload (and any `extension_service_override_*` warnings) otherwise.
  */
-export declare function runRegisteredServiceOverrideForTest(services: ExtensionServiceRegistry, context: ServiceOverrideContext): Promise<ServiceOverrideResult>;
+export declare function runRegisteredServiceOverrideForTest(services:ExtensionServiceRegistry,context:ServiceOverrideContext):Promise<ServiceOverrideResult>;
 /**
  * Invoke an operation of a registered search provider through the same name
  * resolution the host uses and return the operation's result, so package tests
@@ -585,11 +589,11 @@ export declare function runRegisteredServiceOverrideForTest(services: ExtensionS
  * the requested operation, since invoking an absent provider/operation is a
  * wiring bug in the test rather than a behavior under test.
  */
-export declare function runRegisteredSearchProviderForTest<Operation extends keyof SearchProviderOperationContexts>(registrations: ExtensionRegistrationRegistry, options: {
-provider: string;
-operation: Operation;
-context: SearchProviderOperationContexts[Operation];
-}): Promise<SearchProviderOperationResults[Operation]>;
+export declare function runRegisteredSearchProviderForTest<Operation extends keyof SearchProviderOperationContexts>(registrations:ExtensionRegistrationRegistry,options:{
+provider:string;
+operation:Operation;
+context:SearchProviderOperationContexts[Operation];
+}):Promise<SearchProviderOperationResults[Operation]>;
 /**
  * Invoke an operation of a registered vector store adapter through the same name
  * resolution the host uses and return the operation's result, so package tests
@@ -608,11 +612,11 @@ context: SearchProviderOperationContexts[Operation];
  * registered, and a separate error when the resolved adapter does not implement
  * the requested operation.
  */
-export declare function runRegisteredVectorStoreAdapterForTest<Operation extends keyof VectorStoreAdapterOperationContexts>(registrations: ExtensionRegistrationRegistry, options: {
-adapter: string;
-operation: Operation;
-context: VectorStoreAdapterOperationContexts[Operation];
-}): Promise<VectorStoreAdapterOperationResults[Operation]>;
+export declare function runRegisteredVectorStoreAdapterForTest<Operation extends keyof VectorStoreAdapterOperationContexts>(registrations:ExtensionRegistrationRegistry,options:{
+adapter:string;
+operation:Operation;
+context:VectorStoreAdapterOperationContexts[Operation];
+}):Promise<VectorStoreAdapterOperationResults[Operation]>;
 /**
  * Invoke a registered schema migration's `run` function through the same runtime
  * definition the host executes and return its result, so package tests can assert
@@ -633,7 +637,7 @@ context: VectorStoreAdapterOperationContexts[Operation];
  * Throws when the resolved migration declares no `run` function, since invoking a
  * runless migration is a wiring bug in the test rather than a behavior under test.
  */
-export declare function runRegisteredMigrationForTest(registrations: ExtensionRegistrationRegistry, options: RunRegisteredMigrationForTestOptions): Promise<unknown>;
+export declare function runRegisteredMigrationForTest(registrations:ExtensionRegistrationRegistry,options:RunRegisteredMigrationForTestOptions):Promise<unknown>;
 /**
  * Invoke a registered extension importer through pm's real handler-dispatch
  * engine and return its {@link CommandHandlerResult}, so package tests can assert
@@ -662,7 +666,7 @@ export declare function runRegisteredMigrationForTest(registrations: ExtensionRe
  * when no importer matches, since that is a wiring/typo bug in the test rather
  * than a behavior under test.
  */
-export declare function runRegisteredImporterForTest(activation: ExtensionActivationResult, options: RunRegisteredImporterForTestOptions): Promise<CommandHandlerResult>;
+export declare function runRegisteredImporterForTest(activation:ExtensionActivationResult,options:RunRegisteredImporterForTestOptions):Promise<CommandHandlerResult>;
 /**
  * Invoke a registered extension exporter through pm's real handler-dispatch
  * engine and return its {@link CommandHandlerResult}, so package tests can assert
@@ -681,20 +685,20 @@ export declare function runRegisteredImporterForTest(activation: ExtensionActiva
  * when no exporter matches, since that is a wiring/typo bug in the test rather
  * than a behavior under test.
  */
-export declare function runRegisteredExporterForTest(activation: ExtensionActivationResult, options: RunRegisteredExporterForTestOptions): Promise<CommandHandlerResult>;
+export declare function runRegisteredExporterForTest(activation:ExtensionActivationResult,options:RunRegisteredExporterForTestOptions):Promise<CommandHandlerResult>;
 /**
  * Assert that an {@link ExtensionDeactivationResult} reports the expected clean
  * teardown counts, throwing a descriptive error otherwise. Defaults assert the
  * single-extension happy path — exactly one extension deactivated and none
  * failed. Returns the result so assertions can chain.
  */
-export declare function assertExtensionDeactivated(result: ExtensionDeactivationResult, expectation?: ExtensionDeactivationExpectation): ExtensionDeactivationResult;
+export declare function assertExtensionDeactivated(result:ExtensionDeactivationResult,expectation?:ExtensionDeactivationExpectation):ExtensionDeactivationResult;
 /** Assert that a normalized package manifest advertises expected package resources. Pair with `readPmPackageManifest(packageRoot)` in package tests. */
-export declare function assertPackageManifest(manifest: PmPackageManifest, expectation: PackageManifestExpectation): PmPackageManifest;
+export declare function assertPackageManifest(manifest:PmPackageManifest,expectation:PackageManifestExpectation):PmPackageManifest;
 /** Assert that an activated extension registration registry contains a command contract with the expected public metadata. */
-export declare function assertRegisteredCommandContract(registrations: ExtensionRegistrationRegistry, expectation: RegisteredCommandContractExpectation): RegisteredCommandContractAssertion;
+export declare function assertRegisteredCommandContract(registrations:ExtensionRegistrationRegistry,expectation:RegisteredCommandContractExpectation):RegisteredCommandContractAssertion;
 /** Assert that an activated extension registration registry contains flags injected into an existing command through `api.registerFlags(...)`. */
-export declare function assertRegisteredFlags(registrations: ExtensionRegistrationRegistry, expectation: RegisteredFlagsExpectation): RegisteredExtensionFlagDefinitions;
+export declare function assertRegisteredFlags(registrations:ExtensionRegistrationRegistry,expectation:RegisteredFlagsExpectation):RegisteredExtensionFlagDefinitions;
 /**
  * Assert that an activated extension hook registry contains a hook of the
  * expected lifecycle kind (optionally scoped to a specific extension).
@@ -702,21 +706,21 @@ export declare function assertRegisteredFlags(registrations: ExtensionRegistrati
  * Hooks are surfaced via `ExtensionActivationResult.hooks`, not the command
  * registration registry, so this helper accepts an `ExtensionHookRegistry`.
  */
-export declare function assertRegisteredHook<TKind extends RegisteredHookKind>(hooks: ExtensionHookRegistry, expectation: RegisteredHookExpectation & {
-kind: TKind;
-}): RegisteredHookEntry<TKind>;
+export declare function assertRegisteredHook<TKind extends RegisteredHookKind>(hooks:ExtensionHookRegistry,expectation:RegisteredHookExpectation & {
+kind:TKind;
+}):RegisteredHookEntry<TKind>;
 /** Assert that an activated extension registration registry contains a search provider with the expected name (optionally scoped to a specific extension). */
-export declare function assertRegisteredSearchProvider(registrations: ExtensionRegistrationRegistry, expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
+export declare function assertRegisteredSearchProvider(registrations:ExtensionRegistrationRegistry,expectation:RegisteredSearchProviderExpectation):RegisteredExtensionSearchProvider;
 /** Assert that an activated extension registration registry contains a vector store adapter with the expected name (optionally scoped to a specific extension). */
-export declare function assertRegisteredVectorStoreAdapter(registrations: ExtensionRegistrationRegistry, expectation: RegisteredVectorStoreAdapterExpectation): RegisteredExtensionVectorStoreAdapter;
+export declare function assertRegisteredVectorStoreAdapter(registrations:ExtensionRegistrationRegistry,expectation:RegisteredVectorStoreAdapterExpectation):RegisteredExtensionVectorStoreAdapter;
 /** Assert that an activated extension registration registry contains an importer for the expected format/name (optionally scoped to a specific extension). */
-export declare function assertRegisteredImporter(registrations: ExtensionRegistrationRegistry, expectation: RegisteredImporterExpectation): RegisteredExtensionImporter;
+export declare function assertRegisteredImporter(registrations:ExtensionRegistrationRegistry,expectation:RegisteredImporterExpectation):RegisteredExtensionImporter;
 /** Assert that an activated extension registration registry contains an exporter for the expected format/name (optionally scoped to a specific extension). */
-export declare function assertRegisteredExporter(registrations: ExtensionRegistrationRegistry, expectation: RegisteredExporterExpectation): RegisteredExtensionExporter;
+export declare function assertRegisteredExporter(registrations:ExtensionRegistrationRegistry,expectation:RegisteredExporterExpectation):RegisteredExtensionExporter;
 /** Assert that an activated extension registration registry contains a custom item field definition (optionally scoped to a specific extension). */
-export declare function assertRegisteredItemField(registrations: ExtensionRegistrationRegistry, expectation: RegisteredItemFieldExpectation): RegisteredItemFieldAssertion;
+export declare function assertRegisteredItemField(registrations:ExtensionRegistrationRegistry,expectation:RegisteredItemFieldExpectation):RegisteredItemFieldAssertion;
 /** Assert that an activated extension registration registry contains a custom item type definition (optionally scoped to a specific extension). */
-export declare function assertRegisteredItemType(registrations: ExtensionRegistrationRegistry, expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
+export declare function assertRegisteredItemType(registrations:ExtensionRegistrationRegistry,expectation:RegisteredItemTypeExpectation):RegisteredItemTypeAssertion;
 /**
  * Assert that an activated extension registration registry contains a project
  * profile registered via `api.registerProfile(profile)` (optionally scoped to a
@@ -729,7 +733,7 @@ export declare function assertRegisteredItemType(registrations: ExtensionRegistr
  * (item types, item fields), a profile is verified by presence — it is staged,
  * not executed — so there is no `runRegisteredProfileForTest` counterpart.
  */
-export declare function assertRegisteredProfile(registrations: ExtensionRegistrationRegistry, expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
+export declare function assertRegisteredProfile(registrations:ExtensionRegistrationRegistry,expectation:RegisteredProfileExpectation):RegisteredProfileAssertion;
 /**
  * Assert that an activated extension command registry contains a command
  * override registered via `api.registerCommand(command, override)` (optionally
@@ -739,7 +743,7 @@ export declare function assertRegisteredProfile(registrations: ExtensionRegistra
  * the command registration registry, so this helper accepts an
  * `ExtensionCommandRegistry`.
  */
-export declare function assertRegisteredCommandOverride(commands: ExtensionCommandRegistry, expectation: RegisteredCommandOverrideExpectation): RegisteredExtensionCommandOverride;
+export declare function assertRegisteredCommandOverride(commands:ExtensionCommandRegistry,expectation:RegisteredCommandOverrideExpectation):RegisteredExtensionCommandOverride;
 /**
  * Assert that an activated extension parser registry contains a parser override
  * registered via `api.registerParser(command, override)` (optionally scoped to
@@ -749,7 +753,7 @@ export declare function assertRegisteredCommandOverride(commands: ExtensionComma
  * command registration registry, so this helper accepts an
  * `ExtensionParserRegistry`.
  */
-export declare function assertRegisteredParserOverride(parsers: ExtensionParserRegistry, expectation: RegisteredParserOverrideExpectation): RegisteredExtensionParserOverride;
+export declare function assertRegisteredParserOverride(parsers:ExtensionParserRegistry,expectation:RegisteredParserOverrideExpectation):RegisteredExtensionParserOverride;
 /**
  * Assert that an activated extension preflight registry contains a preflight
  * override registered via `api.registerPreflight(override)` (optionally scoped
@@ -760,7 +764,7 @@ export declare function assertRegisteredParserOverride(parsers: ExtensionParserR
  * `extensionName`. Preflight overrides are surfaced via
  * `ExtensionActivationResult.preflight`.
  */
-export declare function assertRegisteredPreflightOverride(preflight: ExtensionPreflightRegistry, expectation?: RegisteredPreflightOverrideExpectation): RegisteredExtensionPreflightOverride;
+export declare function assertRegisteredPreflightOverride(preflight:ExtensionPreflightRegistry,expectation?:RegisteredPreflightOverrideExpectation):RegisteredExtensionPreflightOverride;
 /**
  * Assert that an activated extension renderer registry contains a renderer
  * override registered via `api.registerRenderer(format, renderer)` for the
@@ -768,7 +772,7 @@ export declare function assertRegisteredPreflightOverride(preflight: ExtensionPr
  *
  * Renderer overrides are surfaced via `ExtensionActivationResult.renderers`.
  */
-export declare function assertRegisteredRendererOverride(renderers: ExtensionRendererRegistry, expectation: RegisteredRendererOverrideExpectation): RegisteredExtensionRendererOverride;
+export declare function assertRegisteredRendererOverride(renderers:ExtensionRendererRegistry,expectation:RegisteredRendererOverrideExpectation):RegisteredExtensionRendererOverride;
 /**
  * Assert that an activated extension service registry contains a service override
  * registered via `api.registerService(service, override)` for the expected
@@ -778,7 +782,7 @@ export declare function assertRegisteredRendererOverride(renderers: ExtensionRen
  * command registration registry, so this helper accepts an
  * `ExtensionServiceRegistry`.
  */
-export declare function assertRegisteredServiceOverride(services: ExtensionServiceRegistry, expectation: RegisteredServiceOverrideExpectation): RegisteredExtensionServiceOverride;
+export declare function assertRegisteredServiceOverride(services:ExtensionServiceRegistry,expectation:RegisteredServiceOverrideExpectation):RegisteredExtensionServiceOverride;
 /**
  * Assert that an activated extension registration registry contains a schema
  * migration registered via `api.registerMigration(definition)` with the expected
@@ -787,7 +791,7 @@ export declare function assertRegisteredServiceOverride(services: ExtensionServi
  *
  * Migrations are surfaced via `ExtensionActivationResult.registrations.migrations`.
  */
-export declare function assertRegisteredMigration(registrations: ExtensionRegistrationRegistry, expectation: RegisteredMigrationExpectation): RegisteredExtensionSchemaMigrationDefinition;
+export declare function assertRegisteredMigration(registrations:ExtensionRegistrationRegistry,expectation:RegisteredMigrationExpectation):RegisteredExtensionSchemaMigrationDefinition;
 /**
  * Assert that an activated extension declares no capability it never uses
  * (least privilege). Pass the same capabilities as `manifest.capabilities` via
@@ -799,7 +803,7 @@ export declare function assertRegisteredMigration(registrations: ExtensionRegist
  * author catch an over-broad manifest at `npm test` time. Returns the
  * declared/used/unused breakdown for further assertions.
  */
-export declare function assertExtensionCapabilityUsage(activation: ExtensionActivationResult, expectation: ExtensionCapabilityUsageExpectation): ExtensionCapabilityUsageAssertion;
+export declare function assertExtensionCapabilityUsage(activation:ExtensionActivationResult,expectation:ExtensionCapabilityUsageExpectation):ExtensionCapabilityUsageAssertion;
 /**
  * Preflight a declarative {@link ExtensionBlueprint} in a test, throwing if it has
  * any `error`-severity issue (today: capability the blueprint exercises but the
@@ -812,11 +816,11 @@ export declare function assertExtensionCapabilityUsage(activation: ExtensionActi
  * success so a test can still inspect advisory warnings (unused capability,
  * duplicate command, empty surface) without failing on them.
  */
-export declare function assertExtensionBlueprint(blueprint: ExtensionBlueprint, options?: LintExtensionBlueprintOptions): ExtensionBlueprintLintResult;
+export declare function assertExtensionBlueprint(blueprint:ExtensionBlueprint,options?:LintExtensionBlueprintOptions):ExtensionBlueprintLintResult;
 /** Options for {@link assertProjectProfile}. */
 export interface AssertProjectProfileOptions {
 /** Also throw when the profile produces `warning`-severity findings (e.g. a workflow transition referencing a status no profile or built-in defines). Off by default so warnings stay advisory; turn on for strict CI gates. */
-strict?: boolean;
+strict?:boolean;
 }
 /**
  * Assert a {@link ProjectProfileDefinition} is internally consistent in a test,
@@ -829,7 +833,7 @@ strict?: boolean;
  * returned on success so a test can still inspect advisory warnings without
  * failing on them.
  */
-export declare function assertProjectProfile(profile: ProjectProfileDefinition, options?: AssertProjectProfileOptions): ProjectProfileLintReport;
+export declare function assertProjectProfile(profile:ProjectProfileDefinition,options?:AssertProjectProfileOptions):ProjectProfileLintReport;
 /**
  * The structured result of {@link assertExtensionManifestMatchesBlueprint}: the
  * reconciliation between a manifest's declared capabilities and the set the
@@ -838,15 +842,15 @@ export declare function assertProjectProfile(profile: ProjectProfileDefinition,
  */
 export interface ExtensionManifestBlueprintMatch {
 /** The least-privilege capability set the blueprint exercises (from `deriveExtensionCapabilities`). */
-used: ExtensionCapability[];
+used:ExtensionCapability[];
 /** The manifest's declared capabilities, legacy-alias resolved and normalized. */
-declared: ExtensionCapability[];
+declared:ExtensionCapability[];
 /** Capabilities the blueprint uses but the manifest omits — would crash activation. Empty on success. */
-missing: ExtensionCapability[];
+missing:ExtensionCapability[];
 /** Capabilities the manifest declares but no surface exercises — violates least privilege. Empty on success. */
-unused: ExtensionCapability[];
+unused:ExtensionCapability[];
 /** Every lint finding for the blueprint, so callers can inspect advisory warnings. */
-findings: ExtensionBlueprintLintFinding[];
+findings:ExtensionBlueprintLintFinding[];
 }
 /**
  * Strictly assert a manifest's `capabilities` equal the least-privilege set a
@@ -867,7 +871,7 @@ findings: ExtensionBlueprintLintFinding[];
  * The reconciliation is returned on success so a test can still inspect advisory
  * warnings (duplicate command, empty surface) without failing on them.
  */
-export declare function assertExtensionManifestMatchesBlueprint(manifest: Pick<ExtensionManifest, "capabilities">, blueprint: ExtensionBlueprint): ExtensionManifestBlueprintMatch;
+export declare function assertExtensionManifestMatchesBlueprint(manifest:Pick<ExtensionManifest,"capabilities">,blueprint:ExtensionBlueprint):ExtensionManifestBlueprintMatch;
 /**
  * Assert an extension manifest's declared version bounds permit it to load on a
  * target pm CLI version, throwing when a bound blocks the load.
@@ -884,7 +888,7 @@ export declare function assertExtensionManifestMatchesBlueprint(manifest: Pick<E
  * a user's install. The full compatibility result is returned on success so a test
  * can still inspect advisory warnings.
  */
-export declare function assertExtensionManifestCompatible(manifest: ExtensionManifestCompatibilityManifest, target: ExtensionManifestCompatibilityTarget): ExtensionManifestCompatibilityResult;
+export declare function assertExtensionManifestCompatible(manifest:ExtensionManifestCompatibilityManifest,target:ExtensionManifestCompatibilityTarget):ExtensionManifestCompatibilityResult;
 /**
  * Preflight a declarative {@link ExtensionBlueprint} through every author-time
  * check in one test, throwing if any stage produced an `error`-severity finding.
@@ -902,7 +906,7 @@ export declare function assertExtensionManifestCompatible(manifest: ExtensionMan
  * returned on success so a test can still inspect those warnings, the synthesized
  * manifest, and the derived capability set without failing on them.
  */
-export declare function assertExtensionPreflight(blueprint: ExtensionBlueprint, options?: PreflightExtensionOptions): ExtensionPreflightReport;
+export declare function assertExtensionPreflight(blueprint:ExtensionBlueprint,options?:PreflightExtensionOptions):ExtensionPreflightReport;
 /**
  * A fluent, single-extension test fixture returned by
  * {@link createExtensionTestHarness}.
@@ -923,99 +927,99 @@ export declare function assertExtensionPreflight(blueprint: ExtensionBlueprint,
  */
 export interface ExtensionTestHarness {
 /** The in-memory extension module supplied to {@link createExtensionTestHarness}. */
-readonly module: unknown;
+readonly module:unknown;
 /** Resolved extension name (manifest name, explicit override, or `"test-extension"`). */
-readonly name: string;
+readonly name:string;
 /** Layer recorded for the in-memory extension (defaults to `"project"`). */
-readonly layer: ExtensionLayer;
+readonly layer:ExtensionLayer;
 /** The underlying activation result; use it to reach standalone helpers directly. */
-readonly activation: ExtensionActivationResult;
+readonly activation:ExtensionActivationResult;
 /** Bound {@link describeExtensionActivation} over the whole `activation`. */
-activationSummary(options?: DescribeExtensionActivationOptions): ExtensionActivationSummary;
+activationSummary(options?:DescribeExtensionActivationOptions):ExtensionActivationSummary;
 /**
      * Bound {@link renderExtensionSurfaceMarkdown} over {@link activationSummary},
      * so tests and README generators can produce deterministic surface docs from
      * the same harness they use for assert/run coverage.
      */
-renderMarkdown(options?: RenderExtensionHarnessMarkdownOptions): string;
+renderMarkdown(options?:RenderExtensionHarnessMarkdownOptions):string;
 /** Bound {@link assertRegisteredCommandContract} over `activation.registrations`. */
-assertCommandContract(expectation: RegisteredCommandContractExpectation): RegisteredCommandContractAssertion;
+assertCommandContract(expectation:RegisteredCommandContractExpectation):RegisteredCommandContractAssertion;
 /** Bound {@link assertRegisteredFlags} over `activation.registrations`. */
-assertFlags(expectation: RegisteredFlagsExpectation): RegisteredExtensionFlagDefinitions;
+assertFlags(expectation:RegisteredFlagsExpectation):RegisteredExtensionFlagDefinitions;
 /** Bound {@link assertRegisteredItemField} over `activation.registrations`. */
-assertItemField(expectation: RegisteredItemFieldExpectation): RegisteredItemFieldAssertion;
+assertItemField(expectation:RegisteredItemFieldExpectation):RegisteredItemFieldAssertion;
 /** Bound {@link assertRegisteredItemType} over `activation.registrations`. */
-assertItemType(expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
+assertItemType(expectation:RegisteredItemTypeExpectation):RegisteredItemTypeAssertion;
 /** Bound {@link assertRegisteredProfile} over `activation.registrations`. */
-assertProfile(expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
+assertProfile(expectation:RegisteredProfileExpectation):RegisteredProfileAssertion;
 /** Bound {@link assertRegisteredHook} over `activation.hooks`. */
-assertHook<TKind extends RegisteredHookKind>(expectation: RegisteredHookExpectation & {
-kind: TKind;
-}): RegisteredHookEntry<TKind>;
+assertHook<TKind extends RegisteredHookKind>(expectation:RegisteredHookExpectation & {
+kind:TKind;
+}):RegisteredHookEntry<TKind>;
 /** Bound {@link assertRegisteredCommandOverride} over `activation.commands`. */
-assertCommandOverride(expectation: RegisteredCommandOverrideExpectation): RegisteredExtensionCommandOverride;
+assertCommandOverride(expectation:RegisteredCommandOverrideExpectation):RegisteredExtensionCommandOverride;
 /** Bound {@link assertRegisteredParserOverride} over `activation.parsers`. */
-assertParserOverride(expectation: RegisteredParserOverrideExpectation): RegisteredExtensionParserOverride;
+assertParserOverride(expectation:RegisteredParserOverrideExpectation):RegisteredExtensionParserOverride;
 /** Bound {@link assertRegisteredPreflightOverride} over `activation.preflight`. */
-assertPreflightOverride(expectation?: RegisteredPreflightOverrideExpectation): RegisteredExtensionPreflightOverride;
+assertPreflightOverride(expectation?:RegisteredPreflightOverrideExpectation):RegisteredExtensionPreflightOverride;
 /** Bound {@link assertRegisteredRendererOverride} over `activation.renderers`. */
-assertRendererOverride(expectation: RegisteredRendererOverrideExpectation): RegisteredExtensionRendererOverride;
+assertRendererOverride(expectation:RegisteredRendererOverrideExpectation):RegisteredExtensionRendererOverride;
 /** Bound {@link assertRegisteredServiceOverride} over `activation.services`. */
-assertServiceOverride(expectation: RegisteredServiceOverrideExpectation): RegisteredExtensionServiceOverride;
+assertServiceOverride(expectation:RegisteredServiceOverrideExpectation):RegisteredExtensionServiceOverride;
 /** Bound {@link assertRegisteredSearchProvider} over `activation.registrations`. */
-assertSearchProvider(expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
+assertSearchProvider(expectation:RegisteredSearchProviderExpectation):RegisteredExtensionSearchProvider;
 /** Bound {@link assertRegisteredVectorStoreAdapter} over `activation.registrations`. */
-assertVectorStoreAdapter(expectation: RegisteredVectorStoreAdapterExpectation): RegisteredExtensionVectorStoreAdapter;
+assertVectorStoreAdapter(expectation:RegisteredVectorStoreAdapterExpectation):RegisteredExtensionVectorStoreAdapter;
 /** Bound {@link assertRegisteredImporter} over `activation.registrations`. */
-assertImporter(expectation: RegisteredImporterExpectation): RegisteredExtensionImporter;
+assertImporter(expectation:RegisteredImporterExpectation):RegisteredExtensionImporter;
 /** Bound {@link assertRegisteredExporter} over `activation.registrations`. */
-assertExporter(expectation: RegisteredExporterExpectation): RegisteredExtensionExporter;
+assertExporter(expectation:RegisteredExporterExpectation):RegisteredExtensionExporter;
 /** Bound {@link assertRegisteredMigration} over `activation.registrations`. */
-assertMigration(expectation: RegisteredMigrationExpectation): RegisteredExtensionSchemaMigrationDefinition;
+assertMigration(expectation:RegisteredMigrationExpectation):RegisteredExtensionSchemaMigrationDefinition;
 /** Bound {@link assertExtensionCapabilityUsage} over the whole `activation`. */
-assertCapabilityUsage(expectation: ExtensionCapabilityUsageExpectation): ExtensionCapabilityUsageAssertion;
+assertCapabilityUsage(expectation:ExtensionCapabilityUsageExpectation):ExtensionCapabilityUsageAssertion;
 /** Bound {@link runRegisteredCommandForTest} over `activation.commands`. */
-runCommand(options: RunRegisteredCommandForTestOptions): Promise<CommandHandlerResult>;
+runCommand(options:RunRegisteredCommandForTestOptions):Promise<CommandHandlerResult>;
 /** Bound {@link runRegisteredHookForTest} over `activation.hooks`. */
-runHook(options: RunRegisteredHookForTestOptions): Promise<string[]>;
+runHook(options:RunRegisteredHookForTestOptions):Promise<string[]>;
 /** Bound transactional mutation-guard runner over `activation.hooks`. */
-runMutationGuard(options: RunRegisteredMutationGuardForTestOptions): Promise<void>;
+runMutationGuard(options:RunRegisteredMutationGuardForTestOptions):Promise<void>;
 /** Bound {@link runRegisteredCommandOverrideForTest} over `activation.commands`. */
-runCommandOverride(context: CommandOverrideContext): Promise<CommandOverrideResult>;
+runCommandOverride(context:CommandOverrideContext):Promise<CommandOverrideResult>;
 /** Bound {@link runRegisteredParserOverrideForTest} over `activation.parsers`. */
-runParserOverride(context: ParserOverrideContext): Promise<ParserOverrideResult>;
+runParserOverride(context:ParserOverrideContext):Promise<ParserOverrideResult>;
 /** Bound {@link runRegisteredPreflightOverrideForTest} over `activation.preflight`. */
-runPreflightOverride(context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
+runPreflightOverride(context:PreflightOverrideContext):Promise<PreflightOverrideResult>;
 /** Bound {@link runRegisteredRendererOverrideForTest} over `activation.renderers`. */
-runRendererOverride(context: RendererOverrideContext): Promise<RendererOverrideResult>;
+runRendererOverride(context:RendererOverrideContext):Promise<RendererOverrideResult>;
 /** Bound {@link runRegisteredServiceOverrideForTest} over `activation.services`. */
-runServiceOverride(context: ServiceOverrideContext): Promise<ServiceOverrideResult>;
+runServiceOverride(context:ServiceOverrideContext):Promise<ServiceOverrideResult>;
 /** Bound {@link runRegisteredSearchProviderForTest} over `activation.registrations`. */
-runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options: {
-provider: string;
-operation: Operation;
-context: SearchProviderOperationContexts[Operation];
-}): Promise<SearchProviderOperationResults[Operation]>;
+runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options:{
+provider:string;
+operation:Operation;
+context:SearchProviderOperationContexts[Operation];
+}):Promise<SearchProviderOperationResults[Operation]>;
 /** Bound {@link runRegisteredVectorStoreAdapterForTest} over `activation.registrations`. */
-runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options: {
-adapter: string;
-operation: Operation;
-context: VectorStoreAdapterOperationContexts[Operation];
-}): Promise<VectorStoreAdapterOperationResults[Operation]>;
+runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options:{
+adapter:string;
+operation:Operation;
+context:VectorStoreAdapterOperationContexts[Operation];
+}):Promise<VectorStoreAdapterOperationResults[Operation]>;
 /** Bound {@link runRegisteredMigrationForTest} over `activation.registrations`. */
-runMigration(options: RunRegisteredMigrationForTestOptions): Promise<unknown>;
+runMigration(options:RunRegisteredMigrationForTestOptions):Promise<unknown>;
 /** Bound {@link runRegisteredImporterForTest} over the whole `activation`. */
-runImporter(options: RunRegisteredImporterForTestOptions): Promise<CommandHandlerResult>;
+runImporter(options:RunRegisteredImporterForTestOptions):Promise<CommandHandlerResult>;
 /** Bound {@link runRegisteredExporterForTest} over the whole `activation`. */
-runExporter(options: RunRegisteredExporterForTestOptions): Promise<CommandHandlerResult>;
+runExporter(options:RunRegisteredExporterForTestOptions):Promise<CommandHandlerResult>;
 /**
      * Bound {@link deactivateExtensionForTest} — runs the real teardown engine for
      * this harness's module, forwarding its resolved `name`/`layer`/`activation` so
      * the skip-key matches and a never-initialized extension is not deactivated.
      */
-deactivate(options?: {
-deactivateTimeoutMs?: number;
-}): Promise<ExtensionDeactivationResult>;
+deactivate(options?:{
+deactivateTimeoutMs?:number;
+}):Promise<ExtensionDeactivationResult>;
 }
 /**
  * Activate one in-memory extension module and return a fluent
@@ -1043,4 +1047,4 @@ deactivateTimeoutMs?: number;
  * deliberately exercise a *failed* activation should call
  * {@link activateExtensionForTest} directly and inspect `activation.failed`.
  */
-export declare function createExtensionTestHarness(module: unknown, options?: ActivateExtensionForTestOptions): Promise<ExtensionTestHarness>;
+export declare function createExtensionTestHarness(module:unknown,options?:ActivateExtensionForTestOptions):Promise<ExtensionTestHarness>;