@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/sdk/compose.d.ts

@@ -25,15 +25,15 @@
  * declarative (`composeExtension`) authoring styles live together. Both are
  * re-exported from the SDK barrel, so the public API is unchanged.
  */
-import type { AfterCommandHook, BeforeCommandHook, BeforeMutationHook, CommandDefinition, CommandOverride, ExtensionApi, ExtensionCapability, ExtensionManifest, ExtensionServiceName, Exporter, ExporterRegistrationOptions, FlagDefinition, ImportExportRegistrationOptions, Importer, OnIndexHook, OnReadHook, OnWriteHook, OutputRendererFormat, ParserOverride, PreflightOverride, ScopedPreflightOverrideDefinition, RendererOverride, ScopedRendererOverrideDefinition, SchemaFieldDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SearchProviderDefinition, ServiceOverride, VectorStoreAdapterDefinition, AssuranceMeasurementProviderDefinition } from "../core/extensions/loader.js";
+import type { AfterCommandHook,BeforeCommandHook,BeforeMutationHook,CommandDefinition,CommandOverride,ExtensionApi,ExtensionCapability,ExtensionManifest,ExtensionServiceName,Exporter,ExporterRegistrationOptions,FlagDefinition,ImportExportRegistrationOptions,Importer,OnIndexHook,OnReadHook,OnWriteHook,OutputRendererFormat,ParserOverride,PreflightOverride,ScopedPreflightOverrideDefinition,RendererOverride,ScopedRendererOverrideDefinition,SchemaFieldDefinition,SchemaItemTypeDefinition,SchemaMigrationDefinition,SearchProviderDefinition,ServiceOverride,VectorStoreAdapterDefinition,AssuranceMeasurementProviderDefinition } from "../core/extensions/loader.js";
 import type { ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
 import type { ProjectProfileRegistrationInput } from "../core/profile/profile-presets.js";
 import type { PmMaxVersionExceededMode } from "../core/extensions/extension-types.js";
 import type { RelationshipKindDefinition } from "./relationships.js";
 import { type PmVersionBoundKind } from "../core/extensions/version-compat.js";
-import { inspectExtensionManifestSchema, lintExtensionManifestSchema, type ExtensionManifestSchemaFinding, type ExtensionManifestSchemaInspection, type ExtensionManifestSchemaLintResult } from "../core/extensions/manifest-schema.js";
-export { inspectExtensionManifestSchema, lintExtensionManifestSchema };
-export type { ExtensionManifestSchemaFinding, ExtensionManifestSchemaInspection, ExtensionManifestSchemaLintResult, };
+import { inspectExtensionManifestSchema,lintExtensionManifestSchema,type ExtensionManifestSchemaFinding,type ExtensionManifestSchemaInspection,type ExtensionManifestSchemaLintResult } from "../core/extensions/manifest-schema.js";
+export { inspectExtensionManifestSchema,lintExtensionManifestSchema };
+export type { ExtensionManifestSchemaFinding,ExtensionManifestSchemaInspection,ExtensionManifestSchemaLintResult,};
 /**
  * Documents the extension module payload exchanged by command, SDK, and package integrations.
  *
@@ -51,11 +51,11 @@ export interface ExtensionModule {
      * {@link defineExtensionManifest} for full contract checking at the definition
      * site.
      */
-manifest?: ExtensionManifest;
+manifest?:ExtensionManifest;
 /** 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 (VS Code-style `deactivate`). Invoked by the host on shutdown/reload to release resources opened during `activate`. */
-deactivate?(): void | Promise<void>;
+deactivate?():void | Promise<void>;
 }
 /**
  * Typed identity helper for extension module exports.
@@ -66,18 +66,18 @@ deactivate?(): void | Promise<void>;
  * Reach for {@link composeExtension} instead when you would rather declare the
  * registrations as data than wire them imperatively in `activate`.
  */
-export declare function defineExtension<TModule extends ExtensionModule>(module: TModule): TModule;
+export declare function defineExtension<TModule extends ExtensionModule>(module:TModule):TModule;
 /**
  * A single importer registration entry for an {@link ExtensionBlueprint}, mirroring
  * the positional arguments of `api.registerImporter(name, importer, options?)`.
  */
 export interface ExtensionBlueprintImporter {
 /** Registered importer name; the `<name> import` command path is derived from it. */
-name: string;
+name:string;
 /** The importer handler that bridges an external system into the pm context graph. */
-importer: Importer;
+importer:Importer;
 /** Optional command metadata (description/flags/intent/examples) for the derived command. */
-options?: ImportExportRegistrationOptions;
+options?:ImportExportRegistrationOptions;
 }
 /**
  * A single exporter registration entry for an {@link ExtensionBlueprint}, mirroring
@@ -85,11 +85,11 @@ options?: ImportExportRegistrationOptions;
  */
 export interface ExtensionBlueprintExporter {
 /** Registered exporter name; the `<name> export` command path is derived from it. */
-name: string;
+name:string;
 /** The exporter handler that bridges the pm context graph out to an external system. */
-exporter: Exporter;
+exporter:Exporter;
 /** Optional command metadata and artifact-output delivery policy for the derived command. */
-options?: ExporterRegistrationOptions;
+options?:ExporterRegistrationOptions;
 }
 /**
  * The lifecycle hooks an {@link ExtensionBlueprint} can register, one array per
@@ -99,17 +99,17 @@ options?: ExporterRegistrationOptions;
  */
 export interface ExtensionBlueprintHooks {
 /** Hooks fired before a command runs (`api.hooks.beforeCommand`). */
-beforeCommand?: BeforeCommandHook[];
+beforeCommand?:BeforeCommandHook[];
 /** Transactional guards fired before item and history persistence (`api.hooks.beforeMutation`). */
-beforeMutation?: BeforeMutationHook[];
+beforeMutation?:BeforeMutationHook[];
 /** Hooks fired after a command runs (`api.hooks.afterCommand`). */
-afterCommand?: AfterCommandHook[];
+afterCommand?:AfterCommandHook[];
 /** Hooks fired when an item is persisted (`api.hooks.onWrite`). */
-onWrite?: OnWriteHook[];
+onWrite?:OnWriteHook[];
 /** Hooks fired when an item is read (`api.hooks.onRead`). */
-onRead?: OnReadHook[];
+onRead?:OnReadHook[];
 /** Hooks fired during index/search refresh (`api.hooks.onIndex`). */
-onIndex?: OnIndexHook[];
+onIndex?:OnIndexHook[];
 }
 /**
  * A declarative description of everything an extension registers at activation.
@@ -126,47 +126,47 @@ onIndex?: OnIndexHook[];
  */
 export interface ExtensionBlueprint {
 /** Optional in-module manifest mirror, copied onto the produced module verbatim. */
-manifest?: ExtensionManifest;
+manifest?:ExtensionManifest;
 /** Full command definitions registered via `api.registerCommand(definition)`. */
-commands?: CommandDefinition[];
+commands?:CommandDefinition[];
 /** Command overrides keyed by command name, registered via `api.registerCommand(command, override)`. */
-commandOverrides?: Record<string, CommandOverride>;
+commandOverrides?:Record<string,CommandOverride>;
 /** Additional flags keyed by target command name, registered via `api.registerFlags(command, flags)`. */
-flags?: Record<string, FlagDefinition[]>;
+flags?:Record<string,FlagDefinition[]>;
 /** Parser overrides keyed by command name, registered via `api.registerParser(command, override)`. */
-parsers?: Record<string, ParserOverride>;
+parsers?:Record<string,ParserOverride>;
 /** Output renderer overrides keyed by format, registered via `api.registerRenderer(format, renderer)`. */
-renderers?: Partial<Record<OutputRendererFormat, RendererOverride | ScopedRendererOverrideDefinition>>;
+renderers?:Partial<Record<OutputRendererFormat,RendererOverride | ScopedRendererOverrideDefinition>>;
 /** Service overrides keyed by service name, registered via `api.registerService(service, override)`. */
-services?: Partial<Record<ExtensionServiceName, ServiceOverride>>;
+services?:Partial<Record<ExtensionServiceName,ServiceOverride>>;
 /** Preflight overrides registered via `api.registerPreflight(override)`. */
-preflights?: Array<PreflightOverride | ScopedPreflightOverrideDefinition>;
+preflights?:Array<PreflightOverride | ScopedPreflightOverrideDefinition>;
 /** Custom item types registered in a single `api.registerItemTypes(types)` call. */
-itemTypes?: SchemaItemTypeDefinition[];
+itemTypes?:SchemaItemTypeDefinition[];
 /** Custom item-metadata fields registered in a single `api.registerItemFields(fields)` call. */
-itemFields?: SchemaFieldDefinition[];
+itemFields?:SchemaFieldDefinition[];
 /** Versioned relationship semantics registered in one atomic batch. */
-relationshipKinds?: RelationshipKindDefinition[];
+relationshipKinds?:RelationshipKindDefinition[];
 /** Schema migrations registered one at a time via `api.registerMigration(definition)`. */
-migrations?: SchemaMigrationDefinition[];
+migrations?:SchemaMigrationDefinition[];
 /** Project profiles registered one at a time via `api.registerProfile(profile)`. */
-profiles?: ProjectProfileRegistrationInput[];
+profiles?:ProjectProfileRegistrationInput[];
 /** Search providers registered via `api.registerSearchProvider(provider)`. */
-searchProviders?: SearchProviderDefinition[];
+searchProviders?:SearchProviderDefinition[];
 /** Vector store adapters registered via `api.registerVectorStoreAdapter(adapter)`. */
-vectorStoreAdapters?: VectorStoreAdapterDefinition[];
+vectorStoreAdapters?:VectorStoreAdapterDefinition[];
 /** Assurance measurement providers registered via `api.registerAssuranceMeasurementProvider(provider)`. */
-assuranceProviders?: AssuranceMeasurementProviderDefinition[];
+assuranceProviders?:AssuranceMeasurementProviderDefinition[];
 /** Importers registered via `api.registerImporter(name, importer, options?)`. */
-importers?: ExtensionBlueprintImporter[];
+importers?:ExtensionBlueprintImporter[];
 /** Exporters registered via `api.registerExporter(name, exporter, options?)`. */
-exporters?: ExtensionBlueprintExporter[];
+exporters?:ExtensionBlueprintExporter[];
 /** Lifecycle hooks registered through `api.hooks.*`. */
-hooks?: ExtensionBlueprintHooks;
+hooks?:ExtensionBlueprintHooks;
 /** Optional imperative escape hatch run *after* every declarative registration, for the rare wiring the blueprint cannot express. Receives the same `api`. */
-activate?: (api: ExtensionApi) => void | Promise<void>;
+activate?:(api:ExtensionApi) => void | Promise<void>;
 /** Optional teardown hook copied onto the produced module verbatim. */
-deactivate?: () => void | Promise<void>;
+deactivate?:() => void | Promise<void>;
 }
 /**
  * Typed identity helper for a (partial) {@link ExtensionBlueprint} authored as its
@@ -185,7 +185,7 @@ deactivate?: () => void | Promise<void>;
  * Use as:
  * `export const commandsModule = defineExtensionBlueprint({ commands: [...] })`
  */
-export declare function defineExtensionBlueprint<TBlueprint extends ExtensionBlueprint>(blueprint: TBlueprint): TBlueprint;
+export declare function defineExtensionBlueprint<TBlueprint extends ExtensionBlueprint>(blueprint:TBlueprint):TBlueprint;
 /**
  * Assemble an {@link ExtensionModule} from a declarative {@link ExtensionBlueprint}.
  *
@@ -202,7 +202,7 @@ export declare function defineExtensionBlueprint<TBlueprint extends ExtensionBlu
  * does for hand-written `activate` bodies, so a malformed definition surfaces
  * the same activation diagnostic either way.
  */
-export declare function composeExtension(blueprint: ExtensionBlueprint): ExtensionModule;
+export declare function composeExtension(blueprint:ExtensionBlueprint):ExtensionModule;
 /**
  * Merge several partial {@link ExtensionBlueprint}s into one, so an extension's
  * surface can be authored *modularly* — a commands module, a search module, a
@@ -240,7 +240,7 @@ export declare function composeExtension(blueprint: ExtensionBlueprint): Extensi
  * empty field is omitted rather than emitted empty, so merging zero blueprints
  * returns an empty blueprint (`{}`).
  */
-export declare function mergeExtensionBlueprints(...blueprints: ExtensionBlueprint[]): ExtensionBlueprint;
+export declare function mergeExtensionBlueprints(...blueprints:ExtensionBlueprint[]):ExtensionBlueprint;
 /**
  * Compute the minimal least-privilege capability set a {@link ExtensionBlueprint}
  * exercises, sorted and de-duplicated.
@@ -251,7 +251,7 @@ export declare function mergeExtensionBlueprints(...blueprints: ExtensionBluepri
  * here before activation rather than detecting drift after it. A blueprint with
  * no registration surfaces returns an empty array.
  */
-export declare function deriveExtensionCapabilities(blueprint: ExtensionBlueprint): ExtensionCapability[];
+export declare function deriveExtensionCapabilities(blueprint:ExtensionBlueprint):ExtensionCapability[];
 /**
  * Compute, without activating, the exact {@link ExtensionActivationSummary} that
  * {@link composeExtension}'s generated `activate` would produce for a blueprint.
@@ -276,7 +276,7 @@ export declare function deriveExtensionCapabilities(blueprint: ExtensionBlueprin
  * `activate` escape hatch — arbitrary code a static reader cannot inspect. A
  * blueprint that registers everything through that hatch summarizes as empty.
  */
-export declare function describeExtensionBlueprint(blueprint: ExtensionBlueprint): ExtensionActivationSummary;
+export declare function describeExtensionBlueprint(blueprint:ExtensionBlueprint):ExtensionActivationSummary;
 /** Severity of an {@link ExtensionBlueprintLintFinding}: a hard `error` (activation will fail) or an advisory `warning`. */
 export type ExtensionBlueprintLintSeverity = "error" | "warning";
 /**
@@ -301,37 +301,37 @@ export type ExtensionBlueprintLintCode = "capability_undeclared" | "capability_u
  */
 export interface ExtensionBlueprintLintFinding {
 /** The machine-readable {@link ExtensionBlueprintLintCode} for programmatic handling. */
-code: ExtensionBlueprintLintCode;
+code:ExtensionBlueprintLintCode;
 /** Whether the finding blocks activation (`error`) or is advisory (`warning`). */
-severity: ExtensionBlueprintLintSeverity;
+severity:ExtensionBlueprintLintSeverity;
 /** Human-readable explanation, including the suggested fix. */
-message: string;
+message:string;
 /** The capability involved, for capability-drift findings. */
-capability?: ExtensionCapability;
+capability?:ExtensionCapability;
 /** The normalized command path involved, for command findings. */
-command?: string;
+command?:string;
 /** The blueprint field involved, for `empty_surface` findings. */
-field?: string;
+field?:string;
 }
 /**
  * Options for {@link lintExtensionBlueprint} and {@link ../sdk/testing.js#assertExtensionBlueprint}.
  */
 export interface LintExtensionBlueprintOptions {
 /** The capabilities the package's `manifest.json` declares (or will), used to reconcile against the surfaces the blueprint exercises. Overrides `blueprint.manifest.capabilities` when both are present. Omit both to lint without a capability reconciliation (only the structural checks run). */
-declaredCapabilities?: readonly string[];
+declaredCapabilities?:readonly string[];
 }
 /**
  * The structured result of {@link lintExtensionBlueprint}.
  */
 export interface ExtensionBlueprintLintResult {
 /** `true` when no `error`-severity finding is present (warnings still allow activation). */
-ok: boolean;
+ok:boolean;
 /** Every finding, in detection order (capability drift, duplicates, conflicts, empty surfaces). */
-findings: ExtensionBlueprintLintFinding[];
+findings:ExtensionBlueprintLintFinding[];
 /** The least-privilege capability set the blueprint exercises (from {@link deriveExtensionCapabilities}). */
-used: ExtensionCapability[];
+used:ExtensionCapability[];
 /** The normalized declared capability set reconciled against, or `null` when none was provided. */
-declared: ExtensionCapability[] | null;
+declared:ExtensionCapability[] | null;
 }
 /**
  * Preflight a declarative {@link ExtensionBlueprint} at author time, returning the
@@ -358,7 +358,7 @@ declared: ExtensionCapability[] | null;
  * ({@link collectBlueprintCapabilityFindings}, {@link collectBlueprintCommandFindings},
  * {@link collectBlueprintEmptySurfaceFindings}) in that detection order.
  */
-export declare function lintExtensionBlueprint(blueprint: ExtensionBlueprint, options?: LintExtensionBlueprintOptions): ExtensionBlueprintLintResult;
+export declare function lintExtensionBlueprint(blueprint:ExtensionBlueprint,options?:LintExtensionBlueprintOptions):ExtensionBlueprintLintResult;
 /**
  * The author-supplied identity fields {@link synthesizeExtensionManifest} cannot
  * derive from a blueprint: every {@link ExtensionManifest} field except the
@@ -369,9 +369,9 @@ export declare function lintExtensionBlueprint(blueprint: ExtensionBlueprint, op
  * (engines, permissions, provenance, version floors/ceilings, sandbox profile,
  * manifest version, activation, legacy aliases) are the author's to supply here.
  */
-export interface SynthesizeExtensionManifestIdentity extends Omit<ExtensionManifest, "capabilities"> {
+export interface SynthesizeExtensionManifestIdentity extends Omit<ExtensionManifest,"capabilities"> {
 /** Extra capabilities to grant beyond the blueprint's derived set, for surfaces registered through the blueprint's imperative `activate` escape hatch that static derivation cannot see (e.g. a renderer wired in `activate`). Each is legacy-alias resolved and normalized like a declared manifest capability; unknown names are dropped (the synthesized manifest is validated at load). */
-additionalCapabilities?: readonly string[];
+additionalCapabilities?:readonly string[];
 }
 /**
  * Generate a complete, least-privilege {@link ExtensionManifest} from a
@@ -394,7 +394,7 @@ additionalCapabilities?: readonly string[];
  * {@link ../sdk/testing.js#assertExtensionManifestMatchesBlueprint} to guard a
  * hand-maintained `manifest.json` against drift in CI.
  */
-export declare function synthesizeExtensionManifest(blueprint: ExtensionBlueprint, identity: SynthesizeExtensionManifestIdentity): ExtensionManifest;
+export declare function synthesizeExtensionManifest(blueprint:ExtensionBlueprint,identity:SynthesizeExtensionManifestIdentity):ExtensionManifest;
 /**
  * The two generated halves of a shippable extension package, returned by
  * {@link composeExtensionPackage}.
@@ -405,12 +405,12 @@ export interface ExtensionPackage {
      * export. Its `manifest` mirror is set to the same {@link ExtensionPackage.manifest}
      * object, so the in-module metadata and the on-disk manifest never diverge.
      */
-module: ExtensionModule;
+module:ExtensionModule;
 /**
      * The complete least-privilege {@link ExtensionManifest} to write as the
      * package's `manifest.json`, with `capabilities` derived from the blueprint.
      */
-manifest: ExtensionManifest;
+manifest:ExtensionManifest;
 }
 /**
  * Assemble both halves of a shippable extension package from one declarative
@@ -432,16 +432,16 @@ manifest: ExtensionManifest;
  * for the author-time verify step. Use {@link mergeExtensionBlueprints} first to
  * assemble the blueprint modularly, then this to ship it.
  */
-export declare function composeExtensionPackage(blueprint: ExtensionBlueprint, identity: SynthesizeExtensionManifestIdentity): ExtensionPackage;
+export declare function composeExtensionPackage(blueprint:ExtensionBlueprint,identity:SynthesizeExtensionManifestIdentity):ExtensionPackage;
 /**
  * The target a {@link checkExtensionManifestCompatibility} call evaluates a
  * manifest's version bounds against.
  */
 export interface ExtensionManifestCompatibilityTarget {
 /** The pm CLI version to check the manifest against, e.g. the running CLI's `version` or a version floor a package commits to supporting. Plain dotted-numeric (`2026.6.23`) or `v`-prefixed values are compared; anything uninterpretable yields an `unchecked` finding rather than a false verdict. */
-pmVersion: string;
+pmVersion:string;
 /** How a `pm_max_version` overrun is treated, mirroring the runtime `extensions.policy.pm_max_version_exceeded_mode`. `"block"` (the default) reports an exceeded upper bound as a blocking incompatibility; `"warn"` reports it as a non-blocking advisory, matching an operator who relaxed the gate during a CLI upgrade window. */
-pmMaxVersionExceededMode?: PmMaxVersionExceededMode;
+pmMaxVersionExceededMode?:PmMaxVersionExceededMode;
 }
 /**
  * The manifest fields {@link checkExtensionManifestCompatibility} evaluates.
@@ -452,9 +452,9 @@ pmMaxVersionExceededMode?: PmMaxVersionExceededMode;
  */
 export interface ExtensionManifestCompatibilityManifest {
 /** Inclusive lower pm CLI version bound from `manifest.json`. */
-pm_min_version?: unknown;
+pm_min_version?:unknown;
 /** Inclusive upper pm CLI version bound from `manifest.json`. */
-pm_max_version?: unknown;
+pm_max_version?:unknown;
 }
 /**
  * The machine-readable kind of an {@link ExtensionManifestCompatibilityFinding},
@@ -470,32 +470,32 @@ export type ExtensionManifestCompatibilityCode = "pm_min_version_invalid" | "pm_
  */
 export interface ExtensionManifestCompatibilityFinding {
 /** The machine-readable {@link ExtensionManifestCompatibilityCode} for programmatic handling. */
-code: ExtensionManifestCompatibilityCode;
+code:ExtensionManifestCompatibilityCode;
 /** `error` when the bound blocks the load against the target version, `warning` when it is advisory. */
-severity: "error" | "warning";
+severity:"error" | "warning";
 /** Which manifest bound produced the finding. */
-constraint: PmVersionBoundKind | "manifest";
+constraint:PmVersionBoundKind | "manifest";
 /** The declared bound value, verbatim. */
-required: string;
+required:string;
 /** The target pm version the bound was evaluated against. */
-current: string;
+current:string;
 /** Human-readable explanation of the outcome and its effect on loading. */
-message: string;
+message:string;
 /** JSON-style manifest location responsible for a schema-level finding. */
-path?: string;
+path?:string;
 /** Canonical manifest key that replaces a recognized legacy or mistaken spelling. */
-suggested_key?: "pm_min_version" | "pm_max_version";
+suggested_key?:"pm_min_version" | "pm_max_version";
 }
 /**
  * The structured result of {@link checkExtensionManifestCompatibility}.
  */
 export interface ExtensionManifestCompatibilityResult {
 /** `true` when no `error`-severity finding blocks the load against the target version. */
-compatible: boolean;
+compatible:boolean;
 /** Every schema and bound finding in stable evaluation order. */
-findings: ExtensionManifestCompatibilityFinding[];
+findings:ExtensionManifestCompatibilityFinding[];
 /** The target pm version the manifest was checked against, echoed back for messaging. */
-pmVersion: string;
+pmVersion:string;
 }
 /**
  * Check, without loading anything, whether an extension manifest's declared
@@ -519,7 +519,7 @@ pmVersion: string;
  * {@link ../sdk/testing.js#assertExtensionManifestCompatible} to fail CI on a
  * blocking incompatibility.
  */
-export declare function checkExtensionManifestCompatibility(manifest: ExtensionManifestCompatibilityManifest, target: ExtensionManifestCompatibilityTarget): ExtensionManifestCompatibilityResult;
+export declare function checkExtensionManifestCompatibility(manifest:ExtensionManifestCompatibilityManifest,target:ExtensionManifestCompatibilityTarget):ExtensionManifestCompatibilityResult;
 /**
  * Options for {@link preflightExtension} and
  * {@link ../sdk/testing.js#assertExtensionPreflight}. Every field is optional:
@@ -535,7 +535,7 @@ export interface PreflightExtensionOptions {
      * version bounds then feed the {@link PreflightExtensionOptions.target | target}
      * compatibility check. Omit to skip manifest synthesis.
      */
-identity?: SynthesizeExtensionManifestIdentity;
+identity?:SynthesizeExtensionManifestIdentity;
 /**
      * The pm CLI version (and optional max-version overrun mode) to evaluate the
      * manifest's `pm_min_version`/`pm_max_version` bounds against. Provide it to run
@@ -543,7 +543,7 @@ identity?: SynthesizeExtensionManifestIdentity;
      * (or, absent an `identity`, the blueprint's in-module `manifest` mirror). Omit
      * to skip the version-compatibility check.
      */
-target?: ExtensionManifestCompatibilityTarget;
+target?:ExtensionManifestCompatibilityTarget;
 /**
      * The capabilities the package's `manifest.json` declares, reconciled against
      * the surfaces the blueprint exercises. Passed straight to
@@ -551,7 +551,7 @@ target?: ExtensionManifestCompatibilityTarget;
      * `blueprint.manifest.capabilities`, so the blueprint's in-module mirror is
      * linted by default.
      */
-declaredCapabilities?: readonly string[];
+declaredCapabilities?:readonly string[];
 }
 /** Which preflight stage produced an {@link ExtensionPreflightFinding}. */
 export type ExtensionPreflightFindingSource = "blueprint" | "compatibility";
@@ -562,13 +562,13 @@ export type ExtensionPreflightFindingSource = "blueprint" | "compatibility";
  */
 export interface ExtensionPreflightFinding {
 /** The stage that produced the finding: blueprint lint or version compatibility. */
-source: ExtensionPreflightFindingSource;
+source:ExtensionPreflightFindingSource;
 /** Whether the finding blocks publish/activation (`error`) or is advisory (`warning`). */
-severity: ExtensionBlueprintLintSeverity;
+severity:ExtensionBlueprintLintSeverity;
 /** The underlying stage's machine-readable code, for programmatic handling. */
-code: ExtensionBlueprintLintCode | ExtensionManifestCompatibilityCode;
+code:ExtensionBlueprintLintCode | ExtensionManifestCompatibilityCode;
 /** The underlying stage's human-readable explanation, verbatim. */
-message: string;
+message:string;
 }
 /**
  * The consolidated result of {@link preflightExtension}: every author-time stage's
@@ -576,17 +576,17 @@ message: string;
  */
 export interface ExtensionPreflightReport {
 /** `true` when no `error`-severity finding appears across any stage (warnings still pass). */
-ok: boolean;
+ok:boolean;
 /** The least-privilege capability set the blueprint exercises (from {@link deriveExtensionCapabilities}). */
-capabilities: ExtensionCapability[];
+capabilities:ExtensionCapability[];
 /** The full {@link lintExtensionBlueprint} result (structural + capability-drift findings). */
-blueprint: ExtensionBlueprintLintResult;
+blueprint:ExtensionBlueprintLintResult;
 /** The manifest synthesized from `options.identity`, or `null` when no identity was supplied. */
-manifest: ExtensionManifest | null;
+manifest:ExtensionManifest | null;
 /** The {@link checkExtensionManifestCompatibility} result, or `null` when no `options.target` was supplied. */
-compatibility: ExtensionManifestCompatibilityResult | null;
+compatibility:ExtensionManifestCompatibilityResult | null;
 /** Every finding from all stages, blueprint-lint findings before compatibility findings, each tagged by `source`. This is the consolidated, curated view: when `options.identity` synthesizes the manifest without an explicit `declaredCapabilities` set, capability-drift findings the lint raised against the blueprint's now-superseded in-module `manifest` mirror are omitted here (the raw `blueprint` result still carries them). */
-findings: ExtensionPreflightFinding[];
+findings:ExtensionPreflightFinding[];
 }
 /**
  * Preflight a declarative {@link ExtensionBlueprint} through every author-time
@@ -619,4 +619,4 @@ findings: ExtensionPreflightFinding[];
  * `report.findings` (the raw `report.blueprint` result still reports them). Pair it
  * with {@link ../sdk/testing.js#assertExtensionPreflight} to fail CI in one line.
  */
-export declare function preflightExtension(blueprint: ExtensionBlueprint, options?: PreflightExtensionOptions): ExtensionPreflightReport;
+export declare function preflightExtension(blueprint:ExtensionBlueprint,options?:PreflightExtensionOptions):ExtensionPreflightReport;