@unbrained/pm-cli 2026.7.2 → 2026.7.3

package/dist/sdk/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","sources":["sdk/compose.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/compose\n *\n * Declarative extension authoring — the capstone of the SDK authoring tripod\n * (`author → register → test`).\n *\n * The {@link ./define.js | `define*`} builders type each registration where it\n * is written, and the `assert*`/`run*` testing helpers verify and invoke it. But\n * the author still has to hand-wire every definition into an imperative\n * `activate(api)` body — calling the right `api.register*` method, in the right\n * order, without forgetting one — and then hand-sync `manifest.capabilities` to\n * match. Those are the two most common package-authoring footguns.\n *\n * {@link composeExtension} closes the loop: an author (or an agent) describes\n * *what* to register as a plain {@link ExtensionBlueprint} object, and the SDK\n * generates the `activate` that wires every surface for them.\n * {@link deriveExtensionCapabilities} computes the exact least-privilege\n * capability set that blueprint exercises, so `manifest.json` can be authored\n * with zero declared-but-unused / used-but-undeclared drift (the author-time\n * inverse of the runtime `reconcileExtensionCapabilityUsage` reconciliation).\n *\n * This module also owns {@link ExtensionModule} and {@link defineExtension} —\n * the in-module export shape every extension entry file produces and its\n * zero-cost identity helper — so both the imperative (`defineExtension`) and\n * declarative (`composeExtension`) authoring styles live together. Both are\n * re-exported from the SDK barrel, so the public API is unchanged.\n */\nimport type {\n  AfterCommandHook,\n  BeforeCommandHook,\n  CommandDefinition,\n  CommandOverride,\n  ExtensionApi,\n  ExtensionCapability,\n  ExtensionManifest,\n  ExtensionServiceName,\n  Exporter,\n  FlagDefinition,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnReadHook,\n  OnWriteHook,\n  OutputRendererFormat,\n  ParserOverride,\n  PreflightOverride,\n  RendererOverride,\n  SchemaFieldDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SearchProviderDefinition,\n  ServiceOverride,\n  VectorStoreAdapterDefinition,\n} from \"../core/extensions/loader.js\";\nimport type { ExtensionActivationSummary } from \"../core/extensions/activation-summary.js\";\nimport type { ProjectProfileRegistrationInput } from \"../core/profile/profile-presets.js\";\nimport type { PmMaxVersionExceededMode } from \"../core/extensions/extension-types.js\";\nimport {\n  normalizeKnownExtensionCapability,\n  resolveLegacyExtensionCapabilityAlias,\n} from \"../core/extensions/extension-capability-aliases.js\";\nimport { normalizeCommandName } from \"../core/extensions/extension-runtime-helpers.js\";\nimport {\n  evaluatePmMaxVersionBound,\n  evaluatePmMinVersionBound,\n  type PmVersionBoundEvaluation,\n  type PmVersionBoundKind,\n} from \"../core/extensions/version-compat.js\";\n\n/**\n * Documents the extension module payload exchanged by command, SDK, and package integrations.\n *\n * This is the shape an extension entry file exports (as its default export and,\n * conventionally, as named `manifest`/`activate` exports). Produce it directly,\n * via {@link defineExtension} for the imperative style, or via\n * {@link composeExtension} for the declarative style.\n */\nexport interface ExtensionModule {\n  /**\n   * Optional in-module metadata mirror.\n   *\n   * The authoritative manifest remains on-disk `manifest.json`; this field is\n   * useful when authors want colocated metadata for tooling/tests. Type it with\n   * {@link defineExtensionManifest} for full contract checking at the definition\n   * site.\n   */\n  manifest?: ExtensionManifest;\n  activate(api: ExtensionApi): void | Promise<void>;\n  /**\n   * Optional teardown lifecycle hook (VS Code-style `deactivate`). Invoked by\n   * the host on shutdown/reload to release resources opened during `activate`.\n   */\n  deactivate?(): void | Promise<void>;\n}\n\n/**\n * Typed identity helper for extension module exports.\n *\n * Use as:\n * `export default defineExtension({ activate(api) { ... } })`\n *\n * Reach for {@link composeExtension} instead when you would rather declare the\n * registrations as data than wire them imperatively in `activate`.\n */\nexport function defineExtension<TModule extends ExtensionModule>(module: TModule): TModule {\n  return module;\n}\n\n/**\n * A single importer registration entry for an {@link ExtensionBlueprint}, mirroring\n * the positional arguments of `api.registerImporter(name, importer, options?)`.\n */\nexport interface ExtensionBlueprintImporter {\n  /** Registered importer name; the `<name> import` command path is derived from it. */\n  name: string;\n  /** The importer handler that bridges an external system into the pm context graph. */\n  importer: Importer;\n  /** Optional command metadata (description/flags/intent/examples) for the derived command. */\n  options?: ImportExportRegistrationOptions;\n}\n\n/**\n * A single exporter registration entry for an {@link ExtensionBlueprint}, mirroring\n * the positional arguments of `api.registerExporter(name, exporter, options?)`.\n */\nexport interface ExtensionBlueprintExporter {\n  /** Registered exporter name; the `<name> export` command path is derived from it. */\n  name: string;\n  /** The exporter handler that bridges the pm context graph out to an external system. */\n  exporter: Exporter;\n  /** Optional command metadata (description/flags/intent/examples) for the derived command. */\n  options?: ImportExportRegistrationOptions;\n}\n\n/**\n * The lifecycle hooks an {@link ExtensionBlueprint} can register, one array per\n * kind. Each entry is registered through the matching `api.hooks.*` method in\n * the canonical order `before_command → after_command → on_write → on_read →\n * on_index`.\n */\nexport interface ExtensionBlueprintHooks {\n  /** Hooks fired before a command runs (`api.hooks.beforeCommand`). */\n  beforeCommand?: BeforeCommandHook[];\n  /** Hooks fired after a command runs (`api.hooks.afterCommand`). */\n  afterCommand?: AfterCommandHook[];\n  /** Hooks fired when an item is persisted (`api.hooks.onWrite`). */\n  onWrite?: OnWriteHook[];\n  /** Hooks fired when an item is read (`api.hooks.onRead`). */\n  onRead?: OnReadHook[];\n  /** Hooks fired during index/search refresh (`api.hooks.onIndex`). */\n  onIndex?: OnIndexHook[];\n}\n\n/**\n * A declarative description of everything an extension registers at activation.\n *\n * Every field is optional: populate the surfaces your extension uses (ideally\n * with {@link ./define.js | `define*`}-authored definitions) and leave the rest\n * out. {@link composeExtension} turns the blueprint into an\n * {@link ExtensionModule} whose generated `activate` calls the matching\n * `api.register*` method for each surface, and {@link deriveExtensionCapabilities}\n * computes the capability set the blueprint requires.\n *\n * Record-keyed fields map a routing key (command name, output format, or service\n * name) to its handler, mirroring the two-argument `api.register*` overloads.\n */\nexport interface ExtensionBlueprint {\n  /** Optional in-module manifest mirror, copied onto the produced module verbatim. */\n  manifest?: ExtensionManifest;\n  /** Full command definitions registered via `api.registerCommand(definition)`. */\n  commands?: CommandDefinition[];\n  /** Command overrides keyed by command name, registered via `api.registerCommand(command, override)`. */\n  commandOverrides?: Record<string, CommandOverride>;\n  /** Additional flags keyed by target command name, registered via `api.registerFlags(command, flags)`. */\n  flags?: Record<string, FlagDefinition[]>;\n  /** Parser overrides keyed by command name, registered via `api.registerParser(command, override)`. */\n  parsers?: Record<string, ParserOverride>;\n  /** Output renderer overrides keyed by format, registered via `api.registerRenderer(format, renderer)`. */\n  renderers?: Partial<Record<OutputRendererFormat, RendererOverride>>;\n  /** Service overrides keyed by service name, registered via `api.registerService(service, override)`. */\n  services?: Partial<Record<ExtensionServiceName, ServiceOverride>>;\n  /** Preflight overrides registered via `api.registerPreflight(override)`. */\n  preflights?: PreflightOverride[];\n  /** Custom item types registered in a single `api.registerItemTypes(types)` call. */\n  itemTypes?: SchemaItemTypeDefinition[];\n  /** Custom front-matter fields registered in a single `api.registerItemFields(fields)` call. */\n  itemFields?: SchemaFieldDefinition[];\n  /** Schema migrations registered one at a time via `api.registerMigration(definition)`. */\n  migrations?: SchemaMigrationDefinition[];\n  /** Project profiles registered one at a time via `api.registerProfile(profile)`. */\n  profiles?: ProjectProfileRegistrationInput[];\n  /** Search providers registered via `api.registerSearchProvider(provider)`. */\n  searchProviders?: SearchProviderDefinition[];\n  /** Vector store adapters registered via `api.registerVectorStoreAdapter(adapter)`. */\n  vectorStoreAdapters?: VectorStoreAdapterDefinition[];\n  /** Importers registered via `api.registerImporter(name, importer, options?)`. */\n  importers?: ExtensionBlueprintImporter[];\n  /** Exporters registered via `api.registerExporter(name, exporter, options?)`. */\n  exporters?: ExtensionBlueprintExporter[];\n  /** Lifecycle hooks registered through `api.hooks.*`. */\n  hooks?: ExtensionBlueprintHooks;\n  /**\n   * Optional imperative escape hatch run *after* every declarative registration,\n   * for the rare wiring the blueprint cannot express. Receives the same `api`.\n   */\n  activate?: (api: ExtensionApi) => void | Promise<void>;\n  /** Optional teardown hook copied onto the produced module verbatim. */\n  deactivate?: () => void | Promise<void>;\n}\n\n/**\n * Typed identity helper for a (partial) {@link ExtensionBlueprint} authored as its\n * own module — the typed entry point of the modular declarative-authoring loop.\n *\n * It is the natural companion to {@link mergeExtensionBlueprints}: when an\n * extension's surface is split across files — a commands module, a search module,\n * a hooks module — wrap each fragment so it is contract-checked *at its definition\n * site* (with editor completion), exactly as {@link defineExtension} types a whole\n * module and {@link defineExtensionManifest} types a manifest. It returns its\n * argument unchanged, preserving the literal type\n * so the fragment composes into {@link mergeExtensionBlueprints},\n * {@link composeExtension}, or {@link composeExtensionPackage} with no loss of\n * inference.\n *\n * Use as:\n * `export const commandsModule = defineExtensionBlueprint({ commands: [...] })`\n */\nexport function defineExtensionBlueprint<TBlueprint extends ExtensionBlueprint>(blueprint: TBlueprint): TBlueprint {\n  return blueprint;\n}\n\n/**\n * Register a blueprint's command-layer surfaces — fresh command definitions,\n * command overrides, flag tables, and parser/renderer/service overrides — in the\n * deterministic order {@link composeExtension} documents.\n */\nfunction registerBlueprintCommandSurfaces(api: ExtensionApi, blueprint: ExtensionBlueprint): void {\n  for (const command of blueprint.commands ?? []) {\n    api.registerCommand(command);\n  }\n  for (const [command, override] of Object.entries(blueprint.commandOverrides ?? {})) {\n    api.registerCommand(command, override);\n  }\n  for (const [targetCommand, flags] of Object.entries(blueprint.flags ?? {})) {\n    api.registerFlags(targetCommand, flags);\n  }\n  for (const [command, override] of Object.entries(blueprint.parsers ?? {})) {\n    api.registerParser(command, override);\n  }\n  for (const [format, renderer] of Object.entries(blueprint.renderers ?? {}) as Array<\n    [OutputRendererFormat, RendererOverride]\n  >) {\n    api.registerRenderer(format, renderer);\n  }\n  for (const [service, override] of Object.entries(blueprint.services ?? {}) as Array<\n    [ExtensionServiceName, ServiceOverride]\n  >) {\n    api.registerService(service, override);\n  }\n}\n\n/**\n * Register a blueprint's schema-layer surfaces — preflight overrides, item types,\n * item fields, schema migrations, and project profiles — preserving the\n * batch-registration semantics of `registerItemTypes`/`registerItemFields`\n * (only invoked when at least one entry is present).\n */\nfunction registerBlueprintSchemaSurfaces(api: ExtensionApi, blueprint: ExtensionBlueprint): void {\n  for (const override of blueprint.preflights ?? []) {\n    api.registerPreflight(override);\n  }\n  const itemTypes = blueprint.itemTypes ?? [];\n  if (itemTypes.length > 0) {\n    api.registerItemTypes(itemTypes);\n  }\n  const itemFields = blueprint.itemFields ?? [];\n  if (itemFields.length > 0) {\n    api.registerItemFields(itemFields);\n  }\n  for (const migration of blueprint.migrations ?? []) {\n    api.registerMigration(migration);\n  }\n  for (const profile of blueprint.profiles ?? []) {\n    api.registerProfile(profile);\n  }\n}\n\n/**\n * Register a blueprint's retrieval and interchange surfaces — search providers,\n * vector store adapters, importers, and exporters — passing each importer's and\n * exporter's optional registration options through verbatim.\n */\nfunction registerBlueprintRetrievalSurfaces(api: ExtensionApi, blueprint: ExtensionBlueprint): void {\n  for (const provider of blueprint.searchProviders ?? []) {\n    api.registerSearchProvider(provider);\n  }\n  for (const adapter of blueprint.vectorStoreAdapters ?? []) {\n    api.registerVectorStoreAdapter(adapter);\n  }\n  for (const entry of blueprint.importers ?? []) {\n    api.registerImporter(entry.name, entry.importer, entry.options);\n  }\n  for (const entry of blueprint.exporters ?? []) {\n    api.registerExporter(entry.name, entry.exporter, entry.options);\n  }\n}\n\n/**\n * Register a blueprint's lifecycle hooks in canonical order\n * (beforeCommand → afterCommand → onWrite → onRead → onIndex).\n */\nfunction registerBlueprintHooks(api: ExtensionApi, hooks: ExtensionBlueprintHooks): void {\n  for (const hook of hooks.beforeCommand ?? []) {\n    api.hooks.beforeCommand(hook);\n  }\n  for (const hook of hooks.afterCommand ?? []) {\n    api.hooks.afterCommand(hook);\n  }\n  for (const hook of hooks.onWrite ?? []) {\n    api.hooks.onWrite(hook);\n  }\n  for (const hook of hooks.onRead ?? []) {\n    api.hooks.onRead(hook);\n  }\n  for (const hook of hooks.onIndex ?? []) {\n    api.hooks.onIndex(hook);\n  }\n}\n\n/**\n * Assemble an {@link ExtensionModule} from a declarative {@link ExtensionBlueprint}.\n *\n * The returned module's `activate` registers every populated surface through the\n * matching `api.register*` method in a deterministic order (commands → overrides\n * → flags → parsers → renderers → services → preflights → item types → item\n * fields → migrations → profiles → search providers → vector store adapters →\n * importers → exporters → hooks), then awaits the blueprint's optional imperative `activate`\n * so it can layer on anything the declarative form cannot express. `manifest`\n * and `deactivate` are copied onto the module verbatim.\n *\n * This is a pure assembler: it does not validate the definitions. Per-surface\n * contract enforcement stays in `api.register*` (and the loader), exactly as it\n * does for hand-written `activate` bodies, so a malformed definition surfaces\n * the same activation diagnostic either way.\n */\nexport function composeExtension(blueprint: ExtensionBlueprint): ExtensionModule {\n  const activate = async (api: ExtensionApi): Promise<void> => {\n    registerBlueprintCommandSurfaces(api, blueprint);\n    registerBlueprintSchemaSurfaces(api, blueprint);\n    registerBlueprintRetrievalSurfaces(api, blueprint);\n    // `?? {}` (rather than a `!== undefined` guard) so an explicit `hooks: null`\n    // crossing an untyped boundary (e.g. a blueprint hydrated from JSON) is\n    // treated the same as omitting it, instead of throwing on the first\n    // `hooks.beforeCommand` access.\n    registerBlueprintHooks(api, blueprint.hooks ?? {});\n    await blueprint.activate?.(api);\n  };\n\n  // Truthy checks (rather than `!== undefined`) so an explicit `null` mirror or\n  // teardown is treated as absent instead of copied onto the module.\n  const module: ExtensionModule = { activate };\n  if (blueprint.manifest) {\n    module.manifest = blueprint.manifest;\n  }\n  if (blueprint.deactivate) {\n    module.deactivate = blueprint.deactivate;\n  }\n  return module;\n}\n\n/**\n * Concatenate the populated entries of an array surface across blueprints,\n * preserving argument order. Returns `undefined` when no blueprint contributes\n * any entry, so {@link mergeExtensionBlueprints} omits the field instead of\n * emitting an empty array. `?? []` tolerates an explicit `null` field (e.g. from a\n * blueprint hydrated across an untyped boundary) exactly as {@link composeExtension} does.\n */\nfunction mergeArraySurface<TValue>(\n  surfaces: ReadonlyArray<readonly TValue[] | null | undefined>,\n): TValue[] | undefined {\n  const merged = surfaces.flatMap((surface) => surface ?? []);\n  return merged.length > 0 ? merged : undefined;\n}\n\n/**\n * Shallow-merge single-handler record surfaces (`commandOverrides`, `parsers`,\n * `renderers`, `services`) with last-defined-wins precedence on a key collision,\n * exactly like spreading the records in argument order. Returns `undefined` when\n * no blueprint contributes any key.\n */\nfunction mergeHandlerRecord<TRecord extends object>(\n  surfaces: ReadonlyArray<TRecord | null | undefined>,\n): TRecord | undefined {\n  const merged = Object.assign({}, ...surfaces.map((surface) => surface ?? {})) as TRecord;\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\n/**\n * Merge `flags` records by concatenating every blueprint's flag array for a shared\n * target command, mirroring the additive `api.registerFlags` semantics so each\n * module's flags reach the command. Returns `undefined` when no blueprint declares\n * any flags.\n */\nfunction mergeFlagRecord(\n  surfaces: ReadonlyArray<Record<string, FlagDefinition[]> | null | undefined>,\n): Record<string, FlagDefinition[]> | undefined {\n  const merged: Record<string, FlagDefinition[]> = {};\n  for (const surface of surfaces) {\n    for (const [command, flags] of Object.entries(surface ?? {})) {\n      // `flags` is the record's array value, never nullish in-type — `composeExtension`\n      // likewise passes it to `registerFlags` unguarded — so it is spread directly.\n      merged[command] = [...(merged[command] ?? []), ...flags];\n    }\n  }\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\nconst EXTENSION_BLUEPRINT_HOOK_KEYS = [\n  \"beforeCommand\",\n  \"afterCommand\",\n  \"onWrite\",\n  \"onRead\",\n  \"onIndex\",\n] as const satisfies ReadonlyArray<keyof ExtensionBlueprintHooks>;\n\ntype ExtensionBlueprintHookKey = (typeof EXTENSION_BLUEPRINT_HOOK_KEYS)[number];\ntype MissingExtensionBlueprintHookKeys = Exclude<keyof ExtensionBlueprintHooks, ExtensionBlueprintHookKey>;\ntype ExtraExtensionBlueprintHookKeys = Exclude<ExtensionBlueprintHookKey, keyof ExtensionBlueprintHooks>;\n\n// Compile-time exhaustiveness guard: adding a hook field must update the canonical\n// merge order above, and stale keys cannot remain in that list.\nconst EXTENSION_BLUEPRINT_HOOK_KEY_COVERAGE: Record<\n  MissingExtensionBlueprintHookKeys | ExtraExtensionBlueprintHookKeys,\n  never\n> = {};\nvoid EXTENSION_BLUEPRINT_HOOK_KEY_COVERAGE;\n\ntype ExtensionBlueprintHookArray<TKey extends keyof ExtensionBlueprintHooks> = NonNullable<ExtensionBlueprintHooks[TKey]>;\ntype ExtensionBlueprintHookValue<TKey extends keyof ExtensionBlueprintHooks> = ExtensionBlueprintHookArray<TKey>[number];\n\nfunction assignMergedHookSurface<TKey extends keyof ExtensionBlueprintHooks>(\n  merged: ExtensionBlueprintHooks,\n  surfaces: ReadonlyArray<ExtensionBlueprintHooks | null | undefined>,\n  key: TKey,\n): void {\n  const hookArrays = surfaces.map((hooks) => hooks?.[key]) as ReadonlyArray<\n    ExtensionBlueprintHookArray<TKey> | null | undefined\n  >;\n  const value = mergeArraySurface<ExtensionBlueprintHookValue<TKey>>(hookArrays);\n  if (value !== undefined) {\n    const typedMerged = merged as { [K in TKey]?: ExtensionBlueprintHookArray<K> };\n    typedMerged[key] = value as ExtensionBlueprintHookArray<TKey>;\n  }\n}\n\n/**\n * Merge the nested `hooks` surface by concatenating each lifecycle kind's array in\n * canonical order. Returns `undefined` when no blueprint registers any hook.\n */\nfunction mergeHookSurfaces(\n  surfaces: ReadonlyArray<ExtensionBlueprintHooks | null | undefined>,\n): ExtensionBlueprintHooks | undefined {\n  const merged: ExtensionBlueprintHooks = {};\n  for (const key of EXTENSION_BLUEPRINT_HOOK_KEYS) {\n    assignMergedHookSurface(merged, surfaces, key);\n  }\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\n/**\n * Merge several partial {@link ExtensionBlueprint}s into one, so an extension's\n * surface can be authored *modularly* — a commands module, a search module, a\n * hooks module — and combined into a single blueprint to feed\n * {@link composeExtension}, {@link composeExtensionPackage},\n * {@link synthesizeExtensionManifest}, {@link describeExtensionBlueprint}, or\n * {@link preflightExtension}.\n *\n * The merge is pure and deterministic and never mutates an input. Each surface\n * combines the way its underlying `api.register*` call composes:\n *\n * - **Array surfaces** — `commands`, `preflights`, `itemTypes`, `itemFields`,\n *   `migrations`, `profiles`, `searchProviders`, `vectorStoreAdapters`,\n *   `importers`, `exporters` — concatenate in argument order.\n * - **`flags`** concatenates the flag arrays of any shared target command,\n *   mirroring additive `api.registerFlags`: every module's flags reach the command.\n * - **Single-handler records** — `commandOverrides`, `parsers`, `renderers`,\n *   `services` — follow last-defined-wins precedence on a key collision, exactly\n *   like spreading the records in argument order; a later module deliberately\n *   overrides an earlier one's handler for that key.\n * - **`hooks`** concatenates each lifecycle kind's array in canonical order.\n * - The imperative **`activate`** escape hatches chain in argument order (each\n *   awaited), so every module's escape-hatch wiring still runs.\n * - The **`deactivate`** teardown hooks chain in *reverse* argument order (LIFO),\n *   releasing resources in the inverse of acquisition. Teardown is best-effort:\n *   a throwing hook does not strand later modules' cleanup — every hook runs and\n *   teardown failures are re-thrown afterwards (as the original error for one\n *   failure, or an `AggregateError` for several).\n * - The **`manifest`** mirror is last-defined-wins.\n *\n * Because `composeExtension` and the derive/lint/describe helpers are pure readers\n * of this data, a merged blueprint behaves exactly as a hand-written one: a command\n * two modules both define survives as a duplicate in the merged `commands` array\n * and {@link lintExtensionBlueprint} flags it, just as it would in one file. An\n * empty field is omitted rather than emitted empty, so merging zero blueprints\n * returns an empty blueprint (`{}`).\n */\nexport function mergeExtensionBlueprints(...blueprints: ExtensionBlueprint[]): ExtensionBlueprint {\n  const merged: ExtensionBlueprint = {};\n  const assign = <TKey extends keyof ExtensionBlueprint>(key: TKey, value: ExtensionBlueprint[TKey]): void => {\n    if (value !== undefined) {\n      merged[key] = value;\n    }\n  };\n  assign(\"commands\", mergeArraySurface(blueprints.map((blueprint) => blueprint.commands)));\n  assign(\"commandOverrides\", mergeHandlerRecord(blueprints.map((blueprint) => blueprint.commandOverrides)));\n  assign(\"flags\", mergeFlagRecord(blueprints.map((blueprint) => blueprint.flags)));\n  assign(\"parsers\", mergeHandlerRecord(blueprints.map((blueprint) => blueprint.parsers)));\n  assign(\"renderers\", mergeHandlerRecord(blueprints.map((blueprint) => blueprint.renderers)));\n  assign(\"services\", mergeHandlerRecord(blueprints.map((blueprint) => blueprint.services)));\n  assign(\"preflights\", mergeArraySurface(blueprints.map((blueprint) => blueprint.preflights)));\n  assign(\"itemTypes\", mergeArraySurface(blueprints.map((blueprint) => blueprint.itemTypes)));\n  assign(\"itemFields\", mergeArraySurface(blueprints.map((blueprint) => blueprint.itemFields)));\n  assign(\"migrations\", mergeArraySurface(blueprints.map((blueprint) => blueprint.migrations)));\n  assign(\"profiles\", mergeArraySurface(blueprints.map((blueprint) => blueprint.profiles)));\n  assign(\"searchProviders\", mergeArraySurface(blueprints.map((blueprint) => blueprint.searchProviders)));\n  assign(\"vectorStoreAdapters\", mergeArraySurface(blueprints.map((blueprint) => blueprint.vectorStoreAdapters)));\n  assign(\"importers\", mergeArraySurface(blueprints.map((blueprint) => blueprint.importers)));\n  assign(\"exporters\", mergeArraySurface(blueprints.map((blueprint) => blueprint.exporters)));\n  assign(\"hooks\", mergeHookSurfaces(blueprints.map((blueprint) => blueprint.hooks)));\n  // Last-defined-wins for the in-module manifest mirror: a later module's identity\n  // supersedes an earlier one's, matching the single-handler record precedence.\n  let manifest: ExtensionManifest | undefined;\n  for (const blueprint of blueprints) {\n    if (blueprint.manifest) {\n      manifest = blueprint.manifest;\n    }\n  }\n  assign(\"manifest\", manifest);\n  // Imperative escape hatches chain forward (acquisition order); teardown chains\n  // in reverse (LIFO), so resources release in the inverse of acquisition.\n  const hasActivates = blueprints.some((blueprint) => blueprint.activate);\n  assign(\n    \"activate\",\n    hasActivates\n      ? async (api: ExtensionApi): Promise<void> => {\n          for (const blueprint of blueprints) {\n            if (blueprint.activate) {\n              await blueprint.activate(api);\n            }\n          }\n        }\n      : undefined,\n  );\n  const hasDeactivates = blueprints.some((blueprint) => blueprint.deactivate);\n  assign(\n    \"deactivate\",\n    hasDeactivates\n      ? async (): Promise<void> => {\n          // Teardown is best-effort across modules: a throwing `deactivate` must\n          // not strand a later module's cleanup, so every hook runs (in reverse,\n          // LIFO) and failures are surfaced after cleanup completes.\n          const errors: unknown[] = [];\n          for (const blueprint of [...blueprints].reverse()) {\n            if (!blueprint.deactivate) {\n              continue;\n            }\n            try {\n              await blueprint.deactivate();\n            } catch (error) {\n              errors.push(error);\n            }\n          }\n          if (errors.length > 0) {\n            if (errors.length > 1) {\n              throw new AggregateError(errors, \"Multiple extension blueprint deactivate hooks failed.\");\n            }\n            throw errors[0];\n          }\n        }\n      : undefined,\n  );\n  return merged;\n}\n\n/**\n * Blueprint registration fields whose presence implies a capability, paired with\n * the capability each grants. Mirrors `EXTENSION_CAPABILITY_REGISTRATION_SURFACES`\n * so a blueprint's derived capabilities exactly match what the loader enforces\n * when {@link composeExtension}'s generated `activate` calls `api.register*`.\n *\n * `hooks` is handled separately (it is a nested object, not an array/record of\n * registrations) and so is intentionally absent from this table.\n */\nconst BLUEPRINT_FIELD_CAPABILITIES: ReadonlyArray<readonly [BlueprintRegistrationField, ExtensionCapability]> = [\n  [\"commands\", \"commands\"],\n  [\"commandOverrides\", \"commands\"],\n  [\"flags\", \"schema\"],\n  [\"itemTypes\", \"schema\"],\n  [\"itemFields\", \"schema\"],\n  [\"migrations\", \"schema\"],\n  [\"profiles\", \"schema\"],\n  [\"parsers\", \"parser\"],\n  [\"renderers\", \"renderers\"],\n  [\"services\", \"services\"],\n  [\"preflights\", \"preflight\"],\n  [\"searchProviders\", \"search\"],\n  [\"vectorStoreAdapters\", \"search\"],\n  [\"importers\", \"importers\"],\n  [\"exporters\", \"importers\"],\n];\n\ntype BlueprintRegistrationField =\n  | \"commands\"\n  | \"commandOverrides\"\n  | \"flags\"\n  | \"parsers\"\n  | \"renderers\"\n  | \"services\"\n  | \"preflights\"\n  | \"itemTypes\"\n  | \"itemFields\"\n  | \"migrations\"\n  | \"profiles\"\n  | \"searchProviders\"\n  | \"vectorStoreAdapters\"\n  | \"importers\"\n  | \"exporters\";\n\nfunction hasEntries(value: readonly unknown[] | Record<string, unknown> | null | undefined): boolean {\n  // `!value` treats both `null` and `undefined` as \"no entries\", so an untyped\n  // JavaScript author cannot crash capability derivation with an explicit null\n  // field — `Object.keys(null)` would otherwise throw.\n  if (!value) {\n    return false;\n  }\n  if (Array.isArray(value)) {\n    return value.length > 0;\n  }\n  return Object.keys(value).length > 0;\n}\n\n/**\n * Compute the minimal least-privilege capability set a {@link ExtensionBlueprint}\n * exercises, sorted and de-duplicated.\n *\n * Use it to author `manifest.json` `capabilities` exactly — declaring nothing the\n * extension does not use and nothing it does. It is the author-time inverse of\n * the runtime `reconcileExtensionCapabilityUsage` reconciliation: derive the set\n * here before activation rather than detecting drift after it. A blueprint with\n * no registration surfaces returns an empty array.\n */\nexport function deriveExtensionCapabilities(blueprint: ExtensionBlueprint): ExtensionCapability[] {\n  const capabilities = new Set<ExtensionCapability>();\n  for (const [field, capability] of BLUEPRINT_FIELD_CAPABILITIES) {\n    if (hasEntries(blueprint[field])) {\n      capabilities.add(capability);\n    }\n  }\n  // A command definition carrying its own inline `flags` registers them through\n  // `registerCommand`, which asserts the `schema` capability independently of the\n  // top-level `flags` record. Mirror that here so the derived set still matches\n  // what activation enforces when a command declares flags inline and the\n  // blueprint has no separate `flags` field. `!== undefined` (not a truthiness or\n  // length check) matches the loader's exact guard, including an empty inline array.\n  if ((blueprint.commands ?? []).filter(isPresent).some((command) => command.flags !== undefined)) {\n    capabilities.add(\"schema\");\n  }\n  // `registerImporter`/`registerExporter` with `options.flags` register flag\n  // metadata through the same surface as `registerFlags`, asserting the `schema`\n  // capability on top of `importers` (loader `applyImportExportCommandMetadata`).\n  // Mirror that guard so a flag-bearing importer/exporter derives `schema` too —\n  // otherwise a least-privilege manifest synthesized from the blueprint would\n  // under-grant `schema` and fail activation. `!== undefined` matches the loader's\n  // exact `options.flags` guard, including an empty flag array. `entry?.` keeps a\n  // malformed null array entry (from an untyped `.js`/JSON boundary) from crashing\n  // derivation, consistent with the null-field robustness above.\n  const importExportEntries = [...(blueprint.importers ?? []), ...(blueprint.exporters ?? [])].filter(isPresent);\n  if (importExportEntries.some((entry) => entry?.options?.flags !== undefined)) {\n    capabilities.add(\"schema\");\n  }\n  // Importers/exporters always synthesize command handlers (`<name> import` /\n  // `<name> export`), so runtime capability summaries attribute them to the\n  // commands surface as well as the importers surface. Keep the author-time\n  // capability preview aligned with describeExtensionActivation.\n  if (importExportEntries.some((entry) => typeof entry === \"object\")) {\n    capabilities.add(\"commands\");\n  }\n  // `?? {}` keeps an explicit `hooks: null` from throwing, mirroring composeExtension.\n  const hooks: ExtensionBlueprintHooks = blueprint.hooks ?? {};\n  if ([hooks.beforeCommand, hooks.afterCommand, hooks.onWrite, hooks.onRead, hooks.onIndex].some(hasEntries)) {\n    capabilities.add(\"hooks\");\n  }\n  return [...capabilities].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Blueprint hook fields paired with the lifecycle kind each registers, ordered to\n * match `ExtensionActivationResult.hook_counts` (and the runtime\n * {@link ../core/extensions/activation-summary.js#describeExtensionActivation}'s\n * `hooks` ordering) so a blueprint summary's `hooks` list reads in the same\n * canonical order, not alphabetically.\n */\nconst BLUEPRINT_HOOK_FIELD_TO_KIND = [\n  [\"beforeCommand\", \"before_command\"],\n  [\"afterCommand\", \"after_command\"],\n  [\"onWrite\", \"on_write\"],\n  [\"onRead\", \"on_read\"],\n  [\"onIndex\", \"on_index\"],\n] as const satisfies ReadonlyArray<readonly [keyof ExtensionBlueprintHooks, string]>;\n\n/** De-duplicate and locale-sort a list of identifiers, mirroring the runtime summary. */\nfunction sortUnique<TValue extends string>(values: readonly TValue[]): TValue[] {\n  return [...new Set(values)].sort((left, right) => left.localeCompare(right));\n}\n\nfunction isPresent<TValue>(value: TValue | null | undefined): value is TValue {\n  return value !== null && value !== undefined;\n}\n\n/**\n * Compute, without activating, the exact {@link ExtensionActivationSummary} that\n * {@link composeExtension}'s generated `activate` would produce for a blueprint.\n *\n * This is the author-time inverse of the runtime\n * {@link ../core/extensions/activation-summary.js#describeExtensionActivation}:\n * the runtime verb walks an *activated* registry, while this one reads the\n * declarative {@link ExtensionBlueprint} data directly, so an author or agent can\n * preview the full named surface map (commands, overrides, handlers, hooks, item\n * types/fields, importers/exporters, search/vector adapters, parser/service/\n * renderer overrides, flag-target commands, and the preflight count) with no\n * loading, activation, or side effects. It is to the named surfaces what\n * {@link deriveExtensionCapabilities} is to the capability set.\n *\n * Fidelity is by construction: command paths are normalized with the same\n * `normalizeCommandName` the loader applies, and importer/exporter handler paths\n * are synthesized as `normalizeCommandName(\"<name> import|export\")`, exactly as\n * `registerImporter`/`registerExporter` do. A parity test pins this output equal\n * to `describeExtensionActivation` over the same composed-and-activated blueprint.\n *\n * The one surface it cannot reflect is the blueprint's optional imperative\n * `activate` escape hatch — arbitrary code a static reader cannot inspect. A\n * blueprint that registers everything through that hatch summarizes as empty.\n */\nexport function describeExtensionBlueprint(blueprint: ExtensionBlueprint): ExtensionActivationSummary {\n  const commands = (blueprint.commands ?? []).filter(isPresent);\n  const importers = (blueprint.importers ?? []).filter(isPresent);\n  const exporters = (blueprint.exporters ?? []).filter(isPresent);\n  const importerPaths = importers.map((entry) => normalizeCommandName(`${entry.name} import`));\n  const exporterPaths = exporters.map((entry) => normalizeCommandName(`${entry.name} export`));\n  const importerCommandDefinitionPaths = importers\n    .filter((entry) => entry.options !== undefined)\n    .map((entry) => normalizeCommandName(`${entry.name} import`));\n  const exporterCommandDefinitionPaths = exporters\n    .filter((entry) => entry.options !== undefined)\n    .map((entry) => normalizeCommandName(`${entry.name} export`));\n  const commandPaths = [\n    ...commands.map((command) => normalizeCommandName(command.name)),\n    ...importerCommandDefinitionPaths,\n    ...exporterCommandDefinitionPaths,\n  ];\n  // A command definition with inline `flags` registers a flag target under its own\n  // path in addition to any top-level `flags` record. Import/export options with\n  // `flags` register through the same runtime metadata path, so union all sources.\n  const flagCommands = [\n    ...Object.keys(blueprint.flags ?? {}).map((command) => normalizeCommandName(command)),\n    ...commands\n      .filter((command) => command.flags !== undefined)\n      .map((command) => normalizeCommandName(command.name)),\n    ...importers\n      .filter((entry) => entry.options?.flags !== undefined)\n      .map((entry) => normalizeCommandName(`${entry.name} import`)),\n    ...exporters\n      .filter((entry) => entry.options?.flags !== undefined)\n      .map((entry) => normalizeCommandName(`${entry.name} export`)),\n  ];\n  const hooks: ExtensionBlueprintHooks = blueprint.hooks ?? {};\n\n  return {\n    capabilities: deriveExtensionCapabilities(blueprint),\n    commands: sortUnique(commandPaths),\n    command_overrides: sortUnique(Object.keys(blueprint.commandOverrides ?? {}).map((command) => normalizeCommandName(command))),\n    // command_handlers is a superset of commands that also carries the synthesized\n    // importer/exporter command paths, but never the override-only paths.\n    command_handlers: sortUnique([...commandPaths, ...importerPaths, ...exporterPaths]),\n    hooks: BLUEPRINT_HOOK_FIELD_TO_KIND.filter(([field]) => (hooks[field]?.length ?? 0) > 0).map(([, kind]) => kind),\n    flag_commands: sortUnique(flagCommands),\n    item_types: sortUnique((blueprint.itemTypes ?? []).map((type) => type.name)),\n    item_fields: sortUnique((blueprint.itemFields ?? []).map((field) => field.name)),\n    // id-less migrations register but carry no identifier, so they are omitted —\n    // exactly as describeExtensionActivation drops them from its `migrations` list.\n    migrations: sortUnique(\n      (blueprint.migrations ?? []).flatMap((migration) => (typeof migration.id === \"string\" ? [migration.id] : [])),\n    ),\n    profiles: sortUnique((blueprint.profiles ?? []).map((profile) => profile.name)),\n    importers: sortUnique(importers.map((entry) => normalizeCommandName(entry.name))),\n    exporters: sortUnique(exporters.map((entry) => normalizeCommandName(entry.name))),\n    search_providers: sortUnique((blueprint.searchProviders ?? []).map((provider) => provider.name)),\n    vector_store_adapters: sortUnique((blueprint.vectorStoreAdapters ?? []).map((adapter) => adapter.name)),\n    parser_overrides: sortUnique(Object.keys(blueprint.parsers ?? {}).map((command) => normalizeCommandName(command))),\n    service_overrides: sortUnique(\n      Object.keys(blueprint.services ?? {}).map((service) => String(service).trim().toLowerCase() as ExtensionServiceName),\n    ),\n    renderer_overrides: sortUnique(\n      Object.keys(blueprint.renderers ?? {}).map((format) => String(format).trim().toLowerCase() as OutputRendererFormat),\n    ),\n    preflight_overrides: (blueprint.preflights ?? []).length,\n  };\n}\n\n/**\n * The blueprint registration fields a lint flags as a dead \"empty surface\" when\n * present but empty. Mirrors {@link BlueprintRegistrationField} so adding a new\n * registration surface forces a decision here too; `hooks` is handled separately\n * because it is a nested object rather than an array/record of registrations.\n */\nconst BLUEPRINT_LINTABLE_SURFACE_FIELDS = [\n  \"commands\",\n  \"commandOverrides\",\n  \"flags\",\n  \"parsers\",\n  \"renderers\",\n  \"services\",\n  \"preflights\",\n  \"itemTypes\",\n  \"itemFields\",\n  \"migrations\",\n  \"profiles\",\n  \"searchProviders\",\n  \"vectorStoreAdapters\",\n  \"importers\",\n  \"exporters\",\n] as const satisfies ReadonlyArray<BlueprintRegistrationField>;\n\n/** Severity of an {@link ExtensionBlueprintLintFinding}: a hard `error` (activation will fail) or an advisory `warning`. */\nexport type ExtensionBlueprintLintSeverity = \"error\" | \"warning\";\n\n/**\n * Machine-readable kind of an {@link ExtensionBlueprintLintFinding}.\n *\n * - `capability_undeclared` (error): a surface exercises a capability the declared\n *   set omits; the loader throws `extension_capability_missing` at activation.\n * - `capability_unused` (warning): a declared capability no surface exercises; the\n *   runtime equivalent is the `pm package doctor` `extension_capability_unused` note.\n * - `duplicate_command` (warning): the same normalized command path is declared\n *   more than once in `commands`; the later registration shadows the earlier.\n * - `command_override_conflict` (warning): a path is declared as both a fresh\n *   command definition and a command override.\n * - `empty_surface` (warning): a registration field is present but contributes\n *   nothing — a dead declaration.\n * - `manifest_capabilities_absent` (warning): the blueprint exercises capabilities\n *   but offers no declared set to reconcile against.\n */\nexport type ExtensionBlueprintLintCode =\n  | \"capability_undeclared\"\n  | \"capability_unused\"\n  | \"duplicate_command\"\n  | \"command_override_conflict\"\n  | \"empty_surface\"\n  | \"manifest_capabilities_absent\";\n\n/**\n * A single author-time issue {@link lintExtensionBlueprint} found in a blueprint.\n */\nexport interface ExtensionBlueprintLintFinding {\n  /** The machine-readable {@link ExtensionBlueprintLintCode} for programmatic handling. */\n  code: ExtensionBlueprintLintCode;\n  /** Whether the finding blocks activation (`error`) or is advisory (`warning`). */\n  severity: ExtensionBlueprintLintSeverity;\n  /** Human-readable explanation, including the suggested fix. */\n  message: string;\n  /** The capability involved, for capability-drift findings. */\n  capability?: ExtensionCapability;\n  /** The normalized command path involved, for command findings. */\n  command?: string;\n  /** The blueprint field involved, for `empty_surface` findings. */\n  field?: string;\n}\n\n/**\n * Options for {@link lintExtensionBlueprint} and {@link ../sdk/testing.js#assertExtensionBlueprint}.\n */\nexport interface LintExtensionBlueprintOptions {\n  /**\n   * The capabilities the package's `manifest.json` declares (or will), used to\n   * reconcile against the surfaces the blueprint exercises. Overrides\n   * `blueprint.manifest.capabilities` when both are present. Omit both to lint\n   * without a capability reconciliation (only the structural checks run).\n   */\n  declaredCapabilities?: readonly string[];\n}\n\n/**\n * The structured result of {@link lintExtensionBlueprint}.\n */\nexport interface ExtensionBlueprintLintResult {\n  /** `true` when no `error`-severity finding is present (warnings still allow activation). */\n  ok: boolean;\n  /** Every finding, in detection order (capability drift, duplicates, conflicts, empty surfaces). */\n  findings: ExtensionBlueprintLintFinding[];\n  /** The least-privilege capability set the blueprint exercises (from {@link deriveExtensionCapabilities}). */\n  used: ExtensionCapability[];\n  /** The normalized declared capability set reconciled against, or `null` when none was provided. */\n  declared: ExtensionCapability[] | null;\n}\n\n/** Normalize a raw declared-capability list to known capabilities only (legacy-alias aware, sorted, de-duplicated). */\nfunction normalizeDeclaredCapabilities(capabilities: readonly string[]): ExtensionCapability[] {\n  const known = new Set<ExtensionCapability>();\n  for (const capability of capabilities) {\n    // Resolve a legacy alias (e.g. migration/validation → schema) exactly as the\n    // loader does before reconciliation — the author's raw manifest input has not\n    // been loader-normalized yet, so failing to resolve it here would misreport an\n    // alias-satisfied capability as undeclared. Fall back to a canonical known\n    // name; unknown capabilities are a separate diagnostic and are dropped so a\n    // typo is not misreported as \"unused\".\n    const normalized = resolveLegacyExtensionCapabilityAlias(capability) ?? normalizeKnownExtensionCapability(capability);\n    if (normalized !== null) {\n      known.add(normalized);\n    }\n  }\n  return [...known].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Reconcile a blueprint's exercised capabilities against its declared set: a\n * used-but-undeclared capability is an `error` (activation throws\n * `extension_capability_missing`), a declared-but-unused one a `warning`, and a\n * wholly absent declared set (`declared === null`) yields the single\n * `manifest_capabilities_absent` adoption hint.\n */\nfunction collectBlueprintCapabilityFindings(\n  used: ExtensionCapability[],\n  declared: ExtensionCapability[] | null,\n): ExtensionBlueprintLintFinding[] {\n  const findings: ExtensionBlueprintLintFinding[] = [];\n  if (declared === null) {\n    if (used.length > 0) {\n      findings.push({\n        code: \"manifest_capabilities_absent\",\n        severity: \"warning\",\n        message: `Blueprint exercises ${used.length === 1 ? \"capability\" : \"capabilities\"} [${used.join(\", \")}] but declares none; set capabilities to deriveExtensionCapabilities(blueprint) so the manifest grant matches.`,\n      });\n    }\n    return findings;\n  }\n  const declaredSet = new Set(declared);\n  const usedSet = new Set(used);\n  for (const capability of used) {\n    if (!declaredSet.has(capability)) {\n      findings.push({\n        code: \"capability_undeclared\",\n        severity: \"error\",\n        message: `Blueprint exercises capability \"${capability}\" but it is absent from the declared capabilities; activation throws extension_capability_missing — add \"${capability}\" to the manifest capabilities.`,\n        capability,\n      });\n    }\n  }\n  for (const capability of declared) {\n    if (!usedSet.has(capability)) {\n      findings.push({\n        code: \"capability_unused\",\n        severity: \"warning\",\n        message: `Capability \"${capability}\" is declared but no blueprint surface exercises it; drop it to keep the manifest least-privilege (pm package doctor reports this as extension_capability_unused).`,\n        capability,\n      });\n    }\n  }\n  return findings;\n}\n\n/**\n * Detect structural command footguns in a blueprint: a command path declared\n * more than once (`duplicate_command`, the later registration shadowing the\n * earlier at dispatch) and a path declared both as a fresh command definition\n * and as an override (`command_override_conflict`).\n */\nfunction collectBlueprintCommandFindings(blueprint: ExtensionBlueprint): ExtensionBlueprintLintFinding[] {\n  const findings: ExtensionBlueprintLintFinding[] = [];\n  const commandPathCounts = new Map<string, number>();\n  for (const command of blueprint.commands ?? []) {\n    const path = normalizeCommandName(command.name);\n    commandPathCounts.set(path, (commandPathCounts.get(path) ?? 0) + 1);\n  }\n  for (const [path, count] of commandPathCounts) {\n    if (count > 1) {\n      findings.push({\n        code: \"duplicate_command\",\n        severity: \"warning\",\n        message: `Command \"${path}\" is declared ${count} times in commands; the later registration shadows the earlier one at dispatch.`,\n        command: path,\n      });\n    }\n  }\n  const overridePaths = new Set(\n    Object.keys(blueprint.commandOverrides ?? {}).map((command) => normalizeCommandName(command)),\n  );\n  for (const path of commandPathCounts.keys()) {\n    if (overridePaths.has(path)) {\n      findings.push({\n        code: \"command_override_conflict\",\n        severity: \"warning\",\n        message: `Command \"${path}\" is declared both as a new command definition and as a command override; register one or the other.`,\n        command: path,\n      });\n    }\n  }\n  return findings;\n}\n\n/**\n * Flag blueprint registration fields that are present but contribute nothing —\n * an empty array/record surface, or a `hooks` object registering no lifecycle\n * hook — each reported as an `empty_surface` warning (fields first, then hooks).\n */\nfunction collectBlueprintEmptySurfaceFindings(blueprint: ExtensionBlueprint): ExtensionBlueprintLintFinding[] {\n  const findings: ExtensionBlueprintLintFinding[] = [];\n  for (const field of BLUEPRINT_LINTABLE_SURFACE_FIELDS) {\n    if (field in blueprint && !hasEntries(blueprint[field])) {\n      findings.push({\n        code: \"empty_surface\",\n        severity: \"warning\",\n        message: `Blueprint field \"${field}\" is present but empty; remove it or populate it.`,\n        field,\n      });\n    }\n  }\n  if (\"hooks\" in blueprint) {\n    const hooks: ExtensionBlueprintHooks = blueprint.hooks ?? {};\n    const registersHook = [hooks.beforeCommand, hooks.afterCommand, hooks.onWrite, hooks.onRead, hooks.onIndex].some(\n      hasEntries,\n    );\n    if (!registersHook) {\n      findings.push({\n        code: \"empty_surface\",\n        severity: \"warning\",\n        message: `Blueprint field \"hooks\" is present but registers no lifecycle hooks; remove it or populate it.`,\n        field: \"hooks\",\n      });\n    }\n  }\n  return findings;\n}\n\n/**\n * Preflight a declarative {@link ExtensionBlueprint} at author time, returning the\n * structured issues that would otherwise only surface at activation.\n *\n * It is the author-time inverse of the runtime extension guardrails — pure data\n * analysis with no loading, activation, or side effects:\n *\n * - capability drift in both directions: a capability a surface exercises but the\n *   declared set omits is an `error` (the loader throws `extension_capability_missing`\n *   at activation); a declared capability no surface exercises is a `warning` (the\n *   author-time form of the `pm package doctor` `extension_capability_unused` note,\n *   making this the static inverse of `reconcileExtensionCapabilityUsage`).\n * - structural footguns: a command path declared twice (`duplicate_command`), a\n *   path declared as both a command and an override (`command_override_conflict`),\n *   and a registration field present but empty (`empty_surface`).\n *\n * The declared set is taken from `options.declaredCapabilities` or, failing that,\n * `blueprint.manifest.capabilities`; with neither, capability reconciliation is\n * skipped and a single `manifest_capabilities_absent` warning suggests adopting\n * {@link deriveExtensionCapabilities}. Like {@link describeExtensionBlueprint},\n * the imperative `activate` escape hatch is invisible to this static check. The\n * findings are assembled from the per-dimension collectors\n * ({@link collectBlueprintCapabilityFindings}, {@link collectBlueprintCommandFindings},\n * {@link collectBlueprintEmptySurfaceFindings}) in that detection order.\n */\nexport function lintExtensionBlueprint(\n  blueprint: ExtensionBlueprint,\n  options: LintExtensionBlueprintOptions = {},\n): ExtensionBlueprintLintResult {\n  const used = deriveExtensionCapabilities(blueprint);\n\n  // A non-array declared source (an untyped `.js` author's malformed manifest, or\n  // a missing field) is treated as \"no declared set\" rather than \"declares nothing\".\n  const declaredSource = options.declaredCapabilities ?? blueprint.manifest?.capabilities;\n  const declared = Array.isArray(declaredSource) ? normalizeDeclaredCapabilities(declaredSource) : null;\n\n  // Findings accumulate in detection order: capability drift, then command\n  // duplicates/conflicts, then empty surfaces.\n  const findings: ExtensionBlueprintLintFinding[] = [\n    ...collectBlueprintCapabilityFindings(used, declared),\n    ...collectBlueprintCommandFindings(blueprint),\n    ...collectBlueprintEmptySurfaceFindings(blueprint),\n  ];\n\n  return {\n    ok: findings.every((finding) => finding.severity !== \"error\"),\n    findings,\n    used,\n    declared,\n  };\n}\n\n/**\n * The author-supplied identity fields {@link synthesizeExtensionManifest} cannot\n * derive from a blueprint: every {@link ExtensionManifest} field except the\n * generated `capabilities`.\n *\n * The blueprint determines `capabilities` (the surfaces it registers) and nothing\n * else, so `name`/`version`/`entry`/`priority` and any optional metadata\n * (engines, permissions, provenance, version floors/ceilings, sandbox profile,\n * manifest version, activation, legacy aliases) are the author's to supply here.\n */\nexport interface SynthesizeExtensionManifestIdentity extends Omit<ExtensionManifest, \"capabilities\"> {\n  /**\n   * Extra capabilities to grant beyond the blueprint's derived set, for surfaces\n   * registered through the blueprint's imperative `activate` escape hatch that\n   * static derivation cannot see (e.g. a renderer wired in `activate`). Each is\n   * legacy-alias resolved and normalized like a declared manifest capability;\n   * unknown names are dropped (the synthesized manifest is validated at load).\n   */\n  additionalCapabilities?: readonly string[];\n}\n\n/**\n * Generate a complete, least-privilege {@link ExtensionManifest} from a\n * declarative {@link ExtensionBlueprint} and the author's identity fields.\n *\n * This is the *generate* verb that completes the declarative authoring loop\n * (`compose → derive → describe/lint → synthesize`). Where\n * {@link defineExtensionManifest} only *types* a hand-written manifest and\n * {@link deriveExtensionCapabilities} computes only the capability set, this\n * function assembles the whole manifest: it copies every author-supplied identity\n * field verbatim and fills `capabilities` with `deriveExtensionCapabilities`\n * unioned with any {@link SynthesizeExtensionManifestIdentity.additionalCapabilities | additionalCapabilities},\n * sorted and de-duplicated. The author writes the blueprint once and never\n * hand-syncs `manifest.capabilities` — declaring nothing the extension does not\n * use and nothing it does.\n *\n * It is a pure assembler: it neither validates the blueprint definitions (that\n * stays in `api.register*` at activation) nor the identity fields (the loader\n * validates the on-disk manifest). Pair it with\n * {@link ../sdk/testing.js#assertExtensionManifestMatchesBlueprint} to guard a\n * hand-maintained `manifest.json` against drift in CI.\n */\nexport function synthesizeExtensionManifest(\n  blueprint: ExtensionBlueprint,\n  identity: SynthesizeExtensionManifestIdentity,\n): ExtensionManifest {\n  const { additionalCapabilities, ...manifestIdentity } = identity;\n  // `Array.isArray` keeps a non-array value (or an omitted field) crossing an\n  // untyped boundary from crashing the spread, mirroring the rest of the SDK.\n  const extra = Array.isArray(additionalCapabilities) ? normalizeDeclaredCapabilities(additionalCapabilities) : [];\n  const capabilities = [...new Set<ExtensionCapability>([...deriveExtensionCapabilities(blueprint), ...extra])].sort(\n    (left, right) => left.localeCompare(right),\n  );\n  return { ...manifestIdentity, capabilities };\n}\n\n/**\n * The two generated halves of a shippable extension package, returned by\n * {@link composeExtensionPackage}.\n */\nexport interface ExtensionPackage {\n  /**\n   * The runtime {@link ExtensionModule} to export as the package entry's default\n   * export. Its `manifest` mirror is set to the same {@link ExtensionPackage.manifest}\n   * object, so the in-module metadata and the on-disk manifest never diverge.\n   */\n  module: ExtensionModule;\n  /**\n   * The complete least-privilege {@link ExtensionManifest} to write as the\n   * package's `manifest.json`, with `capabilities` derived from the blueprint.\n   */\n  manifest: ExtensionManifest;\n}\n\n/**\n * Assemble both halves of a shippable extension package from one declarative\n * {@link ExtensionBlueprint} and the author's identity fields — the author-once\n * capstone of the declarative loop.\n *\n * Where {@link composeExtension} produces only the runtime module and\n * {@link synthesizeExtensionManifest} produces only the manifest, this unifies\n * them: it synthesizes the complete least-privilege manifest from the blueprint\n * and identity, then composes the module with that synthesized manifest set as its\n * authoritative in-module `manifest` mirror. Both halves are therefore generated\n * from a single source and cannot drift — the module's `manifest` is the very\n * object returned as `manifest`. Export `module` as the package entry's default\n * export and write `manifest` as `manifest.json`.\n *\n * It is a pure assembler with no validation, loading, or filesystem access,\n * exactly like the two functions it composes; pair it with\n * {@link preflightExtension} (or {@link ../sdk/testing.js#assertExtensionPreflight})\n * for the author-time verify step. Use {@link mergeExtensionBlueprints} first to\n * assemble the blueprint modularly, then this to ship it.\n */\nexport function composeExtensionPackage(\n  blueprint: ExtensionBlueprint,\n  identity: SynthesizeExtensionManifestIdentity,\n): ExtensionPackage {\n  const manifest = synthesizeExtensionManifest(blueprint, identity);\n  const module = composeExtension({ ...blueprint, manifest });\n  return { module, manifest };\n}\n\n/**\n * The target a {@link checkExtensionManifestCompatibility} call evaluates a\n * manifest's version bounds against.\n */\nexport interface ExtensionManifestCompatibilityTarget {\n  /**\n   * The pm CLI version to check the manifest against, e.g. the running CLI's\n   * `version` or a version floor a package commits to supporting. Plain\n   * dotted-numeric (`2026.6.23`) or `v`-prefixed values are compared; anything\n   * uninterpretable yields an `unchecked` finding rather than a false verdict.\n   */\n  pmVersion: string;\n  /**\n   * How a `pm_max_version` overrun is treated, mirroring the runtime\n   * `extensions.policy.pm_max_version_exceeded_mode`. `\"block\"` (the default)\n   * reports an exceeded upper bound as a blocking incompatibility; `\"warn\"`\n   * reports it as a non-blocking advisory, matching an operator who relaxed the\n   * gate during a CLI upgrade window.\n   */\n  pmMaxVersionExceededMode?: PmMaxVersionExceededMode;\n}\n\n/**\n * The manifest fields {@link checkExtensionManifestCompatibility} evaluates.\n *\n * Values are intentionally `unknown` rather than `string` so an author can\n * preflight the same malformed blank/non-string bounds (e.g. read from a JSON\n * manifest) the loader's manifest parser rejects as `extension_manifest_invalid`.\n */\nexport interface ExtensionManifestCompatibilityManifest {\n  /** Inclusive lower pm CLI version bound from `manifest.json`. */\n  pm_min_version?: unknown;\n  /** Inclusive upper pm CLI version bound from `manifest.json`. */\n  pm_max_version?: unknown;\n}\n\n/**\n * The machine-readable kind of an {@link ExtensionManifestCompatibilityFinding},\n * one per `<bound>_<outcome>` the loader can reach. Each mirrors a loader\n * `extension_pm_*_version_*` warning: `*_invalid`/`*_unmet`/`*_exceeded` block the\n * load, while `*_unchecked`/`*_exceeded_warn` are advisory (the extension still\n * loads).\n */\nexport type ExtensionManifestCompatibilityCode =\n  | \"pm_min_version_invalid\"\n  | \"pm_min_version_unchecked\"\n  | \"pm_min_version_unmet\"\n  | \"pm_max_version_invalid\"\n  | \"pm_max_version_unchecked\"\n  | \"pm_max_version_exceeded\"\n  | \"pm_max_version_exceeded_warn\";\n\n/**\n * A single version-bound issue {@link checkExtensionManifestCompatibility} found\n * when evaluating a manifest against a target pm version.\n */\nexport interface ExtensionManifestCompatibilityFinding {\n  /** The machine-readable {@link ExtensionManifestCompatibilityCode} for programmatic handling. */\n  code: ExtensionManifestCompatibilityCode;\n  /** `error` when the bound blocks the load against the target version, `warning` when it is advisory. */\n  severity: \"error\" | \"warning\";\n  /** Which manifest bound produced the finding. */\n  constraint: PmVersionBoundKind;\n  /** The declared bound value, verbatim. */\n  required: string;\n  /** The target pm version the bound was evaluated against. */\n  current: string;\n  /** Human-readable explanation of the outcome and its effect on loading. */\n  message: string;\n}\n\n/**\n * The structured result of {@link checkExtensionManifestCompatibility}.\n */\nexport interface ExtensionManifestCompatibilityResult {\n  /** `true` when no `error`-severity finding blocks the load against the target version. */\n  compatible: boolean;\n  /** Every bound finding, lower bound before upper bound; empty when both bounds are absent or satisfied. */\n  findings: ExtensionManifestCompatibilityFinding[];\n  /** The target pm version the manifest was checked against, echoed back for messaging. */\n  pmVersion: string;\n}\n\n/** Map a non-trivial bound evaluation to a compatibility finding, or `null` when the bound is absent or satisfied. */\nfunction toCompatibilityFinding(\n  evaluation: PmVersionBoundEvaluation,\n  pmVersion: string,\n): ExtensionManifestCompatibilityFinding | null {\n  if (evaluation.status === \"absent\" || evaluation.status === \"ok\") {\n    return null;\n  }\n  const code = `${evaluation.kind}_${evaluation.status}` as ExtensionManifestCompatibilityCode;\n  let message: string;\n  switch (code) {\n    case \"pm_min_version_invalid\":\n      message = `pm_min_version \"${evaluation.required}\" is not a valid version; the extension is treated as incompatible and the loader skips it.`;\n      break;\n    case \"pm_min_version_unchecked\":\n      message = `pm_min_version \"${evaluation.required}\" could not be compared against pm ${pmVersion}; compatibility is unverified.`;\n      break;\n    case \"pm_min_version_unmet\":\n      message = `Requires pm >= ${evaluation.required} but the target is pm ${pmVersion}; the loader skips the extension.`;\n      break;\n    case \"pm_max_version_invalid\":\n      message = `pm_max_version \"${evaluation.required}\" is not a valid inclusive upper bound (version ranges are not allowed); the extension is treated as incompatible and the loader skips it.`;\n      break;\n    case \"pm_max_version_unchecked\":\n      message = `pm_max_version \"${evaluation.required}\" could not be compared against pm ${pmVersion}; compatibility is unverified.`;\n      break;\n    case \"pm_max_version_exceeded\":\n      message = `Allows pm <= ${evaluation.required} but the target is pm ${pmVersion}; the loader skips the extension.`;\n      break;\n    case \"pm_max_version_exceeded_warn\":\n      message = `Target pm ${pmVersion} is newer than pm_max_version ${evaluation.required}, but the \"warn\" exceeded mode lets it load with a warning.`;\n      break;\n  }\n  return {\n    code,\n    severity: evaluation.allowed ? \"warning\" : \"error\",\n    constraint: evaluation.kind,\n    required: evaluation.required,\n    current: pmVersion,\n    message,\n  };\n}\n\n/**\n * Check, without loading anything, whether an extension manifest's declared\n * version bounds permit it to load on a given pm CLI version.\n *\n * This is the author-time inverse of the loader's runtime version gate: where the\n * loader resolves the *installed* CLI version (asynchronously, from `package.json`)\n * and emits `extension_pm_*_version_*` warnings, this pure synchronous function\n * takes the {@link ExtensionManifestCompatibilityTarget.pmVersion | target version}\n * the author supplies and returns structured findings. Both share the\n * {@link ../core/extensions/version-compat.js | version-compat core}, so the\n * author-time verdict and the runtime decision agree by construction — a package\n * author can pin a CI test to the pm version they support and catch a too-tight\n * `pm_min_version`, a malformed `pm_max_version`, or an upper bound a newer CLI\n * would exceed, long before publishing.\n *\n * `compatible` is `true` only when no bound blocks the load (`*_invalid`,\n * `*_unmet`, and a `block`-mode `*_exceeded`); `*_unchecked` (an uninterpretable\n * bound or target) and a `warn`-mode `*_exceeded_warn` are advisory `warning`\n * findings that still load. Pair it with\n * {@link ../sdk/testing.js#assertExtensionManifestCompatible} to fail CI on a\n * blocking incompatibility.\n */\nexport function checkExtensionManifestCompatibility(\n  manifest: ExtensionManifestCompatibilityManifest,\n  target: ExtensionManifestCompatibilityTarget,\n): ExtensionManifestCompatibilityResult {\n  const minEvaluation = evaluatePmMinVersionBound(manifest.pm_min_version, target.pmVersion);\n  const maxEvaluation = evaluatePmMaxVersionBound(\n    manifest.pm_max_version,\n    target.pmVersion,\n    target.pmMaxVersionExceededMode ?? \"block\",\n  );\n  const findings: ExtensionManifestCompatibilityFinding[] = [];\n  const minFinding = toCompatibilityFinding(minEvaluation, target.pmVersion);\n  if (minFinding !== null) {\n    findings.push(minFinding);\n  }\n  const maxFinding = toCompatibilityFinding(maxEvaluation, target.pmVersion);\n  if (maxFinding !== null) {\n    findings.push(maxFinding);\n  }\n  return {\n    compatible: minEvaluation.allowed && maxEvaluation.allowed,\n    findings,\n    pmVersion: target.pmVersion,\n  };\n}\n\n/**\n * The lint codes whose verdict depends on the *declared* capability set rather\n * than the blueprint's structure. {@link preflightExtension} drops these from its\n * consolidated view when it synthesizes the manifest from an `identity` without an\n * explicit declared set, because the synthesized manifest — not the blueprint's\n * stale in-module `manifest` mirror — is what the package ships, so a drift against\n * the mirror is a false positive. Structural codes (`duplicate_command`,\n * `command_override_conflict`, `empty_surface`) are never suppressed.\n */\nconst CAPABILITY_DRIFT_LINT_CODES = new Set<ExtensionBlueprintLintCode>([\n  \"capability_undeclared\",\n  \"capability_unused\",\n  \"manifest_capabilities_absent\",\n]);\n\n/**\n * Options for {@link preflightExtension} and\n * {@link ../sdk/testing.js#assertExtensionPreflight}. Every field is optional:\n * each one a check enables, so an author opts into exactly the stages whose\n * inputs they can supply.\n */\nexport interface PreflightExtensionOptions {\n  /**\n   * The author-supplied identity fields the blueprint cannot determine\n   * (`name`/`version`/`entry`/`priority`, version bounds, etc.). Provide them to\n   * have preflight {@link synthesizeExtensionManifest | synthesize} the complete\n   * least-privilege manifest and include it in the report; the synthesized\n   * version bounds then feed the {@link PreflightExtensionOptions.target | target}\n   * compatibility check. Omit to skip manifest synthesis.\n   */\n  identity?: SynthesizeExtensionManifestIdentity;\n  /**\n   * The pm CLI version (and optional max-version overrun mode) to evaluate the\n   * manifest's `pm_min_version`/`pm_max_version` bounds against. Provide it to run\n   * {@link checkExtensionManifestCompatibility} against the synthesized manifest\n   * (or, absent an `identity`, the blueprint's in-module `manifest` mirror). Omit\n   * to skip the version-compatibility check.\n   */\n  target?: ExtensionManifestCompatibilityTarget;\n  /**\n   * The capabilities the package's `manifest.json` declares, reconciled against\n   * the surfaces the blueprint exercises. Passed straight to\n   * {@link lintExtensionBlueprint}; when omitted it falls back to\n   * `blueprint.manifest.capabilities`, so the blueprint's in-module mirror is\n   * linted by default.\n   */\n  declaredCapabilities?: readonly string[];\n}\n\n/** Which preflight stage produced an {@link ExtensionPreflightFinding}. */\nexport type ExtensionPreflightFindingSource = \"blueprint\" | \"compatibility\";\n\n/**\n * A single finding in an {@link ExtensionPreflightReport}, flattened from one of\n * the underlying stages and tagged with its {@link ExtensionPreflightFindingSource}\n * so a consolidated report stays traceable to the check that raised it.\n */\nexport interface ExtensionPreflightFinding {\n  /** The stage that produced the finding: blueprint lint or version compatibility. */\n  source: ExtensionPreflightFindingSource;\n  /** Whether the finding blocks publish/activation (`error`) or is advisory (`warning`). */\n  severity: ExtensionBlueprintLintSeverity;\n  /** The underlying stage's machine-readable code, for programmatic handling. */\n  code: ExtensionBlueprintLintCode | ExtensionManifestCompatibilityCode;\n  /** The underlying stage's human-readable explanation, verbatim. */\n  message: string;\n}\n\n/**\n * The consolidated result of {@link preflightExtension}: every author-time stage's\n * structured output plus a flattened, source-tagged finding list.\n */\nexport interface ExtensionPreflightReport {\n  /** `true` when no `error`-severity finding appears across any stage (warnings still pass). */\n  ok: boolean;\n  /** The least-privilege capability set the blueprint exercises (from {@link deriveExtensionCapabilities}). */\n  capabilities: ExtensionCapability[];\n  /** The full {@link lintExtensionBlueprint} result (structural + capability-drift findings). */\n  blueprint: ExtensionBlueprintLintResult;\n  /** The manifest synthesized from `options.identity`, or `null` when no identity was supplied. */\n  manifest: ExtensionManifest | null;\n  /** The {@link checkExtensionManifestCompatibility} result, or `null` when no `options.target` was supplied. */\n  compatibility: ExtensionManifestCompatibilityResult | null;\n  /**\n   * Every finding from all stages, blueprint-lint findings before compatibility\n   * findings, each tagged by `source`. This is the consolidated, curated view: when\n   * `options.identity` synthesizes the manifest without an explicit\n   * `declaredCapabilities` set, capability-drift findings the lint raised against the\n   * blueprint's now-superseded in-module `manifest` mirror are omitted here (the raw\n   * `blueprint` result still carries them).\n   */\n  findings: ExtensionPreflightFinding[];\n}\n\n/**\n * Preflight a declarative {@link ExtensionBlueprint} through every author-time\n * check in one call, returning a single consolidated {@link ExtensionPreflightReport}.\n *\n * This is the author-time capstone — the static analog of\n * {@link ../sdk/testing.js#createExtensionTestHarness}, which unified the\n * runtime-test helpers. Instead of chaining {@link lintExtensionBlueprint},\n * {@link synthesizeExtensionManifest}, and {@link checkExtensionManifestCompatibility}\n * (and reconciling their separate results) before publishing a package, an author\n * runs `preflightExtension(blueprint, { identity, target })` and reads one report:\n *\n * - the blueprint is always linted (structural footguns + capability drift);\n * - when `options.identity` is given, the complete least-privilege manifest is\n *   synthesized and returned, so the author never hand-syncs `capabilities`;\n * - when `options.target` is given, the synthesized manifest's version bounds\n *   (or, absent an identity, the blueprint's in-module `manifest` mirror) are\n *   checked against that pm version.\n *\n * It is pure and side-effect-free — no loading, activation, or filesystem access,\n * exactly like the stages it composes — so it is safe in any author-time or CI\n * context. The per-stage structured results are exposed unmodified\n * (`report.blueprint`/`manifest`/`compatibility`) alongside the flattened,\n * source-tagged `report.findings`; `report.ok` is `false` if any stage produced an\n * `error`-severity finding. The flattened `findings` are curated for the author-once\n * flow: once an `identity` synthesizes the manifest (and no explicit\n * `declaredCapabilities` was pinned), the synthesized manifest — not the blueprint's\n * in-module `manifest` mirror — is what ships, so capability-drift findings the lint\n * raised against that mirror are false positives and are omitted from\n * `report.findings` (the raw `report.blueprint` result still reports them). Pair it\n * with {@link ../sdk/testing.js#assertExtensionPreflight} to fail CI in one line.\n */\nexport function preflightExtension(\n  blueprint: ExtensionBlueprint,\n  options: PreflightExtensionOptions = {},\n): ExtensionPreflightReport {\n  const blueprintResult = lintExtensionBlueprint(blueprint, { declaredCapabilities: options.declaredCapabilities });\n  const manifest = options.identity ? synthesizeExtensionManifest(blueprint, options.identity) : null;\n  // Compatibility evaluates the bounds the package will ship: the synthesized\n  // manifest when an identity drives generation, else the blueprint's in-module\n  // manifest mirror, else an empty manifest (no bounds → trivially compatible).\n  const compatibility = options.target\n    ? checkExtensionManifestCompatibility(manifest ?? blueprint.manifest ?? {}, options.target)\n    : null;\n  // When preflight synthesizes the manifest from an identity (and the caller did not\n  // pin an explicit declaredCapabilities set), the blueprint lint reconciled against\n  // the blueprint's in-module `manifest` mirror — which the synthesized manifest\n  // supersedes. Capability-drift findings against that stale mirror are false\n  // positives in the consolidated view (a missing capability would even flip `ok` to\n  // false though the synthesized manifest declares it), so drop them; structural\n  // findings are unaffected and the raw lint result on `report.blueprint` keeps all of\n  // them. An explicit declaredCapabilities set is a deliberate \"check exactly this\"\n  // request, so it is never suppressed.\n  const suppressCapabilityDrift = manifest !== null && options.declaredCapabilities === undefined;\n  const blueprintFindings = suppressCapabilityDrift\n    ? blueprintResult.findings.filter((finding) => !CAPABILITY_DRIFT_LINT_CODES.has(finding.code))\n    : blueprintResult.findings;\n  const findings: ExtensionPreflightFinding[] = [\n    ...blueprintFindings.map(\n      (finding): ExtensionPreflightFinding => ({\n        source: \"blueprint\",\n        severity: finding.severity,\n        code: finding.code,\n        message: finding.message,\n      }),\n    ),\n    ...(compatibility?.findings ?? []).map(\n      (finding): ExtensionPreflightFinding => ({\n        source: \"compatibility\",\n        severity: finding.severity,\n        code: finding.code,\n        message: finding.message,\n      }),\n    ),\n  ];\n  return {\n    ok: findings.every((finding) => finding.severity !== \"error\"),\n    capabilities: blueprintResult.used,\n    blueprint: blueprintResult,\n    manifest,\n    compatibility,\n    findings,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"ef101a7b-f751-5242-8a7b-099f2a969a46"}
+{"version":3,"file":"compose.js","sources":["sdk/compose.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/compose\n *\n * Declarative extension authoring — the capstone of the SDK authoring tripod\n * (`author → register → test`).\n *\n * The {@link ./define.js | `define*`} builders type each registration where it\n * is written, and the `assert*`/`run*` testing helpers verify and invoke it. But\n * the author still has to hand-wire every definition into an imperative\n * `activate(api)` body — calling the right `api.register*` method, in the right\n * order, without forgetting one — and then hand-sync `manifest.capabilities` to\n * match. Those are the two most common package-authoring footguns.\n *\n * {@link composeExtension} closes the loop: an author (or an agent) describes\n * *what* to register as a plain {@link ExtensionBlueprint} object, and the SDK\n * generates the `activate` that wires every surface for them.\n * {@link deriveExtensionCapabilities} computes the exact least-privilege\n * capability set that blueprint exercises, so `manifest.json` can be authored\n * with zero declared-but-unused / used-but-undeclared drift (the author-time\n * inverse of the runtime `reconcileExtensionCapabilityUsage` reconciliation).\n *\n * This module also owns {@link ExtensionModule} and {@link defineExtension} —\n * the in-module export shape every extension entry file produces and its\n * zero-cost identity helper — so both the imperative (`defineExtension`) and\n * declarative (`composeExtension`) authoring styles live together. Both are\n * re-exported from the SDK barrel, so the public API is unchanged.\n */\nimport type {\n  AfterCommandHook,\n  BeforeCommandHook,\n  CommandDefinition,\n  CommandOverride,\n  ExtensionApi,\n  ExtensionCapability,\n  ExtensionManifest,\n  ExtensionServiceName,\n  Exporter,\n  FlagDefinition,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnReadHook,\n  OnWriteHook,\n  OutputRendererFormat,\n  ParserOverride,\n  PreflightOverride,\n  RendererOverride,\n  SchemaFieldDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SearchProviderDefinition,\n  ServiceOverride,\n  VectorStoreAdapterDefinition,\n} from \"../core/extensions/loader.js\";\nimport type { ExtensionActivationSummary } from \"../core/extensions/activation-summary.js\";\nimport type { ProjectProfileRegistrationInput } from \"../core/profile/profile-presets.js\";\nimport type { PmMaxVersionExceededMode } from \"../core/extensions/extension-types.js\";\nimport {\n  normalizeKnownExtensionCapability,\n  resolveLegacyExtensionCapabilityAlias,\n} from \"../core/extensions/extension-capability-aliases.js\";\nimport { normalizeCommandName } from \"../core/extensions/extension-runtime-helpers.js\";\nimport {\n  evaluatePmMaxVersionBound,\n  evaluatePmMinVersionBound,\n  type PmVersionBoundEvaluation,\n  type PmVersionBoundKind,\n} from \"../core/extensions/version-compat.js\";\n\n/**\n * Documents the extension module payload exchanged by command, SDK, and package integrations.\n *\n * This is the shape an extension entry file exports (as its default export and,\n * conventionally, as named `manifest`/`activate` exports). Produce it directly,\n * via {@link defineExtension} for the imperative style, or via\n * {@link composeExtension} for the declarative style.\n */\nexport interface ExtensionModule {\n  /**\n   * Optional in-module metadata mirror.\n   *\n   * The authoritative manifest remains on-disk `manifest.json`; this field is\n   * useful when authors want colocated metadata for tooling/tests. Type it with\n   * {@link defineExtensionManifest} for full contract checking at the definition\n   * site.\n   */\n  manifest?: ExtensionManifest;\n  activate(api: ExtensionApi): void | Promise<void>;\n  /**\n   * Optional teardown lifecycle hook (VS Code-style `deactivate`). Invoked by\n   * the host on shutdown/reload to release resources opened during `activate`.\n   */\n  deactivate?(): void | Promise<void>;\n}\n\n/**\n * Typed identity helper for extension module exports.\n *\n * Use as:\n * `export default defineExtension({ activate(api) { ... } })`\n *\n * Reach for {@link composeExtension} instead when you would rather declare the\n * registrations as data than wire them imperatively in `activate`.\n */\nexport function defineExtension<TModule extends ExtensionModule>(module: TModule): TModule {\n  return module;\n}\n\n/**\n * A single importer registration entry for an {@link ExtensionBlueprint}, mirroring\n * the positional arguments of `api.registerImporter(name, importer, options?)`.\n */\nexport interface ExtensionBlueprintImporter {\n  /** Registered importer name; the `<name> import` command path is derived from it. */\n  name: string;\n  /** The importer handler that bridges an external system into the pm context graph. */\n  importer: Importer;\n  /** Optional command metadata (description/flags/intent/examples) for the derived command. */\n  options?: ImportExportRegistrationOptions;\n}\n\n/**\n * A single exporter registration entry for an {@link ExtensionBlueprint}, mirroring\n * the positional arguments of `api.registerExporter(name, exporter, options?)`.\n */\nexport interface ExtensionBlueprintExporter {\n  /** Registered exporter name; the `<name> export` command path is derived from it. */\n  name: string;\n  /** The exporter handler that bridges the pm context graph out to an external system. */\n  exporter: Exporter;\n  /** Optional command metadata (description/flags/intent/examples) for the derived command. */\n  options?: ImportExportRegistrationOptions;\n}\n\n/**\n * The lifecycle hooks an {@link ExtensionBlueprint} can register, one array per\n * kind. Each entry is registered through the matching `api.hooks.*` method in\n * the canonical order `before_command → after_command → on_write → on_read →\n * on_index`.\n */\nexport interface ExtensionBlueprintHooks {\n  /** Hooks fired before a command runs (`api.hooks.beforeCommand`). */\n  beforeCommand?: BeforeCommandHook[];\n  /** Hooks fired after a command runs (`api.hooks.afterCommand`). */\n  afterCommand?: AfterCommandHook[];\n  /** Hooks fired when an item is persisted (`api.hooks.onWrite`). */\n  onWrite?: OnWriteHook[];\n  /** Hooks fired when an item is read (`api.hooks.onRead`). */\n  onRead?: OnReadHook[];\n  /** Hooks fired during index/search refresh (`api.hooks.onIndex`). */\n  onIndex?: OnIndexHook[];\n}\n\n/**\n * A declarative description of everything an extension registers at activation.\n *\n * Every field is optional: populate the surfaces your extension uses (ideally\n * with {@link ./define.js | `define*`}-authored definitions) and leave the rest\n * out. {@link composeExtension} turns the blueprint into an\n * {@link ExtensionModule} whose generated `activate` calls the matching\n * `api.register*` method for each surface, and {@link deriveExtensionCapabilities}\n * computes the capability set the blueprint requires.\n *\n * Record-keyed fields map a routing key (command name, output format, or service\n * name) to its handler, mirroring the two-argument `api.register*` overloads.\n */\nexport interface ExtensionBlueprint {\n  /** Optional in-module manifest mirror, copied onto the produced module verbatim. */\n  manifest?: ExtensionManifest;\n  /** Full command definitions registered via `api.registerCommand(definition)`. */\n  commands?: CommandDefinition[];\n  /** Command overrides keyed by command name, registered via `api.registerCommand(command, override)`. */\n  commandOverrides?: Record<string, CommandOverride>;\n  /** Additional flags keyed by target command name, registered via `api.registerFlags(command, flags)`. */\n  flags?: Record<string, FlagDefinition[]>;\n  /** Parser overrides keyed by command name, registered via `api.registerParser(command, override)`. */\n  parsers?: Record<string, ParserOverride>;\n  /** Output renderer overrides keyed by format, registered via `api.registerRenderer(format, renderer)`. */\n  renderers?: Partial<Record<OutputRendererFormat, RendererOverride>>;\n  /** Service overrides keyed by service name, registered via `api.registerService(service, override)`. */\n  services?: Partial<Record<ExtensionServiceName, ServiceOverride>>;\n  /** Preflight overrides registered via `api.registerPreflight(override)`. */\n  preflights?: PreflightOverride[];\n  /** Custom item types registered in a single `api.registerItemTypes(types)` call. */\n  itemTypes?: SchemaItemTypeDefinition[];\n  /** Custom front-matter fields registered in a single `api.registerItemFields(fields)` call. */\n  itemFields?: SchemaFieldDefinition[];\n  /** Schema migrations registered one at a time via `api.registerMigration(definition)`. */\n  migrations?: SchemaMigrationDefinition[];\n  /** Project profiles registered one at a time via `api.registerProfile(profile)`. */\n  profiles?: ProjectProfileRegistrationInput[];\n  /** Search providers registered via `api.registerSearchProvider(provider)`. */\n  searchProviders?: SearchProviderDefinition[];\n  /** Vector store adapters registered via `api.registerVectorStoreAdapter(adapter)`. */\n  vectorStoreAdapters?: VectorStoreAdapterDefinition[];\n  /** Importers registered via `api.registerImporter(name, importer, options?)`. */\n  importers?: ExtensionBlueprintImporter[];\n  /** Exporters registered via `api.registerExporter(name, exporter, options?)`. */\n  exporters?: ExtensionBlueprintExporter[];\n  /** Lifecycle hooks registered through `api.hooks.*`. */\n  hooks?: ExtensionBlueprintHooks;\n  /**\n   * Optional imperative escape hatch run *after* every declarative registration,\n   * for the rare wiring the blueprint cannot express. Receives the same `api`.\n   */\n  activate?: (api: ExtensionApi) => void | Promise<void>;\n  /** Optional teardown hook copied onto the produced module verbatim. */\n  deactivate?: () => void | Promise<void>;\n}\n\n/**\n * Typed identity helper for a (partial) {@link ExtensionBlueprint} authored as its\n * own module — the typed entry point of the modular declarative-authoring loop.\n *\n * It is the natural companion to {@link mergeExtensionBlueprints}: when an\n * extension's surface is split across files — a commands module, a search module,\n * a hooks module — wrap each fragment so it is contract-checked *at its definition\n * site* (with editor completion), exactly as {@link defineExtension} types a whole\n * module and {@link defineExtensionManifest} types a manifest. It returns its\n * argument unchanged, preserving the literal type\n * so the fragment composes into {@link mergeExtensionBlueprints},\n * {@link composeExtension}, or {@link composeExtensionPackage} with no loss of\n * inference.\n *\n * Use as:\n * `export const commandsModule = defineExtensionBlueprint({ commands: [...] })`\n */\nexport function defineExtensionBlueprint<TBlueprint extends ExtensionBlueprint>(blueprint: TBlueprint): TBlueprint {\n  return blueprint;\n}\n\n/**\n * Register a blueprint's command-layer surfaces — fresh command definitions,\n * command overrides, flag tables, and parser/renderer/service overrides — in the\n * deterministic order {@link composeExtension} documents.\n */\nfunction registerBlueprintCommandSurfaces(api: ExtensionApi, blueprint: ExtensionBlueprint): void {\n  for (const command of blueprint.commands ?? []) {\n    api.registerCommand(command);\n  }\n  for (const [command, override] of Object.entries(blueprint.commandOverrides ?? {})) {\n    api.registerCommand(command, override);\n  }\n  for (const [targetCommand, flags] of Object.entries(blueprint.flags ?? {})) {\n    api.registerFlags(targetCommand, flags);\n  }\n  for (const [command, override] of Object.entries(blueprint.parsers ?? {})) {\n    api.registerParser(command, override);\n  }\n  for (const [format, renderer] of Object.entries(blueprint.renderers ?? {}) as Array<\n    [OutputRendererFormat, RendererOverride]\n  >) {\n    api.registerRenderer(format, renderer);\n  }\n  for (const [service, override] of Object.entries(blueprint.services ?? {}) as Array<\n    [ExtensionServiceName, ServiceOverride]\n  >) {\n    api.registerService(service, override);\n  }\n}\n\n/**\n * Register a blueprint's schema-layer surfaces — preflight overrides, item types,\n * item fields, schema migrations, and project profiles — preserving the\n * batch-registration semantics of `registerItemTypes`/`registerItemFields`\n * (only invoked when at least one entry is present).\n */\nfunction registerBlueprintSchemaSurfaces(api: ExtensionApi, blueprint: ExtensionBlueprint): void {\n  for (const override of blueprint.preflights ?? []) {\n    api.registerPreflight(override);\n  }\n  const itemTypes = blueprint.itemTypes ?? [];\n  if (itemTypes.length > 0) {\n    api.registerItemTypes(itemTypes);\n  }\n  const itemFields = blueprint.itemFields ?? [];\n  if (itemFields.length > 0) {\n    api.registerItemFields(itemFields);\n  }\n  for (const migration of blueprint.migrations ?? []) {\n    api.registerMigration(migration);\n  }\n  for (const profile of blueprint.profiles ?? []) {\n    api.registerProfile(profile);\n  }\n}\n\n/**\n * Register a blueprint's retrieval and interchange surfaces — search providers,\n * vector store adapters, importers, and exporters — passing each importer's and\n * exporter's optional registration options through verbatim.\n */\nfunction registerBlueprintRetrievalSurfaces(api: ExtensionApi, blueprint: ExtensionBlueprint): void {\n  for (const provider of blueprint.searchProviders ?? []) {\n    api.registerSearchProvider(provider);\n  }\n  for (const adapter of blueprint.vectorStoreAdapters ?? []) {\n    api.registerVectorStoreAdapter(adapter);\n  }\n  for (const entry of blueprint.importers ?? []) {\n    api.registerImporter(entry.name, entry.importer, entry.options);\n  }\n  for (const entry of blueprint.exporters ?? []) {\n    api.registerExporter(entry.name, entry.exporter, entry.options);\n  }\n}\n\n/**\n * Register a blueprint's lifecycle hooks in canonical order\n * (beforeCommand → afterCommand → onWrite → onRead → onIndex).\n */\nfunction registerBlueprintHooks(api: ExtensionApi, hooks: ExtensionBlueprintHooks): void {\n  for (const hook of hooks.beforeCommand ?? []) {\n    api.hooks.beforeCommand(hook);\n  }\n  for (const hook of hooks.afterCommand ?? []) {\n    api.hooks.afterCommand(hook);\n  }\n  for (const hook of hooks.onWrite ?? []) {\n    api.hooks.onWrite(hook);\n  }\n  for (const hook of hooks.onRead ?? []) {\n    api.hooks.onRead(hook);\n  }\n  for (const hook of hooks.onIndex ?? []) {\n    api.hooks.onIndex(hook);\n  }\n}\n\n/**\n * Assemble an {@link ExtensionModule} from a declarative {@link ExtensionBlueprint}.\n *\n * The returned module's `activate` registers every populated surface through the\n * matching `api.register*` method in a deterministic order (commands → overrides\n * → flags → parsers → renderers → services → preflights → item types → item\n * fields → migrations → profiles → search providers → vector store adapters →\n * importers → exporters → hooks), then awaits the blueprint's optional imperative `activate`\n * so it can layer on anything the declarative form cannot express. `manifest`\n * and `deactivate` are copied onto the module verbatim.\n *\n * This is a pure assembler: it does not validate the definitions. Per-surface\n * contract enforcement stays in `api.register*` (and the loader), exactly as it\n * does for hand-written `activate` bodies, so a malformed definition surfaces\n * the same activation diagnostic either way.\n */\nexport function composeExtension(blueprint: ExtensionBlueprint): ExtensionModule {\n  const activate = async (api: ExtensionApi): Promise<void> => {\n    registerBlueprintCommandSurfaces(api, blueprint);\n    registerBlueprintSchemaSurfaces(api, blueprint);\n    registerBlueprintRetrievalSurfaces(api, blueprint);\n    // `?? {}` (rather than a `!== undefined` guard) so an explicit `hooks: null`\n    // crossing an untyped boundary (e.g. a blueprint hydrated from JSON) is\n    // treated the same as omitting it, instead of throwing on the first\n    // `hooks.beforeCommand` access.\n    registerBlueprintHooks(api, blueprint.hooks ?? {});\n    await blueprint.activate?.(api);\n  };\n\n  // Truthy checks (rather than `!== undefined`) so an explicit `null` mirror or\n  // teardown is treated as absent instead of copied onto the module.\n  const module: ExtensionModule = { activate };\n  if (blueprint.manifest) {\n    module.manifest = blueprint.manifest;\n  }\n  if (blueprint.deactivate) {\n    module.deactivate = blueprint.deactivate;\n  }\n  return module;\n}\n\n/**\n * Concatenate the populated entries of an array surface across blueprints,\n * preserving argument order. Returns `undefined` when no blueprint contributes\n * any entry, so {@link mergeExtensionBlueprints} omits the field instead of\n * emitting an empty array. `?? []` tolerates an explicit `null` field (e.g. from a\n * blueprint hydrated across an untyped boundary) exactly as {@link composeExtension} does.\n */\nfunction mergeArraySurface<TValue>(\n  surfaces: ReadonlyArray<readonly TValue[] | null | undefined>,\n): TValue[] | undefined {\n  const merged = surfaces.flatMap((surface) => surface ?? []);\n  return merged.length > 0 ? merged : undefined;\n}\n\n/**\n * Shallow-merge single-handler record surfaces (`commandOverrides`, `parsers`,\n * `renderers`, `services`) with last-defined-wins precedence on a key collision,\n * exactly like spreading the records in argument order. Returns `undefined` when\n * no blueprint contributes any key.\n */\nfunction mergeHandlerRecord<TRecord extends object>(\n  surfaces: ReadonlyArray<TRecord | null | undefined>,\n): TRecord | undefined {\n  const merged = Object.assign({}, ...surfaces.map((surface) => surface ?? {})) as TRecord;\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\n/**\n * Merge `flags` records by concatenating every blueprint's flag array for a shared\n * target command, mirroring the additive `api.registerFlags` semantics so each\n * module's flags reach the command. Returns `undefined` when no blueprint declares\n * any flags.\n */\nfunction mergeFlagRecord(\n  surfaces: ReadonlyArray<Record<string, FlagDefinition[]> | null | undefined>,\n): Record<string, FlagDefinition[]> | undefined {\n  const merged: Record<string, FlagDefinition[]> = {};\n  for (const surface of surfaces) {\n    for (const [command, flags] of Object.entries(surface ?? {})) {\n      // `flags` is the record's array value, never nullish in-type — `composeExtension`\n      // likewise passes it to `registerFlags` unguarded — so it is spread directly.\n      merged[command] = [...(merged[command] ?? []), ...flags];\n    }\n  }\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\nconst EXTENSION_BLUEPRINT_HOOK_KEYS = [\n  \"beforeCommand\",\n  \"afterCommand\",\n  \"onWrite\",\n  \"onRead\",\n  \"onIndex\",\n] as const satisfies ReadonlyArray<keyof ExtensionBlueprintHooks>;\n\ntype ExtensionBlueprintHookKey = (typeof EXTENSION_BLUEPRINT_HOOK_KEYS)[number];\ntype MissingExtensionBlueprintHookKeys = Exclude<keyof ExtensionBlueprintHooks, ExtensionBlueprintHookKey>;\ntype ExtraExtensionBlueprintHookKeys = Exclude<ExtensionBlueprintHookKey, keyof ExtensionBlueprintHooks>;\n\n// Compile-time exhaustiveness guard: adding a hook field must update the canonical\n// merge order above, and stale keys cannot remain in that list.\nconst EXTENSION_BLUEPRINT_HOOK_KEY_COVERAGE: Record<\n  MissingExtensionBlueprintHookKeys | ExtraExtensionBlueprintHookKeys,\n  never\n> = {};\nvoid EXTENSION_BLUEPRINT_HOOK_KEY_COVERAGE;\n\ntype ExtensionBlueprintHookArray<TKey extends keyof ExtensionBlueprintHooks> = NonNullable<ExtensionBlueprintHooks[TKey]>;\ntype ExtensionBlueprintHookValue<TKey extends keyof ExtensionBlueprintHooks> = ExtensionBlueprintHookArray<TKey>[number];\n\nfunction assignMergedHookSurface<TKey extends keyof ExtensionBlueprintHooks>(\n  merged: ExtensionBlueprintHooks,\n  surfaces: ReadonlyArray<ExtensionBlueprintHooks | null | undefined>,\n  key: TKey,\n): void {\n  const hookArrays = surfaces.map((hooks) => hooks?.[key]) as ReadonlyArray<\n    ExtensionBlueprintHookArray<TKey> | null | undefined\n  >;\n  const value = mergeArraySurface<ExtensionBlueprintHookValue<TKey>>(hookArrays);\n  if (value !== undefined) {\n    const typedMerged = merged as { [K in TKey]?: ExtensionBlueprintHookArray<K> };\n    typedMerged[key] = value as ExtensionBlueprintHookArray<TKey>;\n  }\n}\n\n/**\n * Merge the nested `hooks` surface by concatenating each lifecycle kind's array in\n * canonical order. Returns `undefined` when no blueprint registers any hook.\n */\nfunction mergeHookSurfaces(\n  surfaces: ReadonlyArray<ExtensionBlueprintHooks | null | undefined>,\n): ExtensionBlueprintHooks | undefined {\n  const merged: ExtensionBlueprintHooks = {};\n  for (const key of EXTENSION_BLUEPRINT_HOOK_KEYS) {\n    assignMergedHookSurface(merged, surfaces, key);\n  }\n  return Object.keys(merged).length > 0 ? merged : undefined;\n}\n\n/**\n * Merge several partial {@link ExtensionBlueprint}s into one, so an extension's\n * surface can be authored *modularly* — a commands module, a search module, a\n * hooks module — and combined into a single blueprint to feed\n * {@link composeExtension}, {@link composeExtensionPackage},\n * {@link synthesizeExtensionManifest}, {@link describeExtensionBlueprint}, or\n * {@link preflightExtension}.\n *\n * The merge is pure and deterministic and never mutates an input. Each surface\n * combines the way its underlying `api.register*` call composes:\n *\n * - **Array surfaces** — `commands`, `preflights`, `itemTypes`, `itemFields`,\n *   `migrations`, `profiles`, `searchProviders`, `vectorStoreAdapters`,\n *   `importers`, `exporters` — concatenate in argument order.\n * - **`flags`** concatenates the flag arrays of any shared target command,\n *   mirroring additive `api.registerFlags`: every module's flags reach the command.\n * - **Single-handler records** — `commandOverrides`, `parsers`, `renderers`,\n *   `services` — follow last-defined-wins precedence on a key collision, exactly\n *   like spreading the records in argument order; a later module deliberately\n *   overrides an earlier one's handler for that key.\n * - **`hooks`** concatenates each lifecycle kind's array in canonical order.\n * - The imperative **`activate`** escape hatches chain in argument order (each\n *   awaited), so every module's escape-hatch wiring still runs.\n * - The **`deactivate`** teardown hooks chain in *reverse* argument order (LIFO),\n *   releasing resources in the inverse of acquisition. Teardown is best-effort:\n *   a throwing hook does not strand later modules' cleanup — every hook runs and\n *   teardown failures are re-thrown afterwards (as the original error for one\n *   failure, or an `AggregateError` for several).\n * - The **`manifest`** mirror is last-defined-wins.\n *\n * Because `composeExtension` and the derive/lint/describe helpers are pure readers\n * of this data, a merged blueprint behaves exactly as a hand-written one: a command\n * two modules both define survives as a duplicate in the merged `commands` array\n * and {@link lintExtensionBlueprint} flags it, just as it would in one file. An\n * empty field is omitted rather than emitted empty, so merging zero blueprints\n * returns an empty blueprint (`{}`).\n */\nexport function mergeExtensionBlueprints(...blueprints: ExtensionBlueprint[]): ExtensionBlueprint {\n  const merged: ExtensionBlueprint = {};\n  const assign = <TKey extends keyof ExtensionBlueprint>(key: TKey, value: ExtensionBlueprint[TKey]): void => {\n    if (value !== undefined) {\n      merged[key] = value;\n    }\n  };\n  assign(\"commands\", mergeArraySurface(blueprints.map((blueprint) => blueprint.commands)));\n  assign(\"commandOverrides\", mergeHandlerRecord(blueprints.map((blueprint) => blueprint.commandOverrides)));\n  assign(\"flags\", mergeFlagRecord(blueprints.map((blueprint) => blueprint.flags)));\n  assign(\"parsers\", mergeHandlerRecord(blueprints.map((blueprint) => blueprint.parsers)));\n  assign(\"renderers\", mergeHandlerRecord(blueprints.map((blueprint) => blueprint.renderers)));\n  assign(\"services\", mergeHandlerRecord(blueprints.map((blueprint) => blueprint.services)));\n  assign(\"preflights\", mergeArraySurface(blueprints.map((blueprint) => blueprint.preflights)));\n  assign(\"itemTypes\", mergeArraySurface(blueprints.map((blueprint) => blueprint.itemTypes)));\n  assign(\"itemFields\", mergeArraySurface(blueprints.map((blueprint) => blueprint.itemFields)));\n  assign(\"migrations\", mergeArraySurface(blueprints.map((blueprint) => blueprint.migrations)));\n  assign(\"profiles\", mergeArraySurface(blueprints.map((blueprint) => blueprint.profiles)));\n  assign(\"searchProviders\", mergeArraySurface(blueprints.map((blueprint) => blueprint.searchProviders)));\n  assign(\"vectorStoreAdapters\", mergeArraySurface(blueprints.map((blueprint) => blueprint.vectorStoreAdapters)));\n  assign(\"importers\", mergeArraySurface(blueprints.map((blueprint) => blueprint.importers)));\n  assign(\"exporters\", mergeArraySurface(blueprints.map((blueprint) => blueprint.exporters)));\n  assign(\"hooks\", mergeHookSurfaces(blueprints.map((blueprint) => blueprint.hooks)));\n  // Last-defined-wins for the in-module manifest mirror: a later module's identity\n  // supersedes an earlier one's, matching the single-handler record precedence.\n  let manifest: ExtensionManifest | undefined;\n  for (const blueprint of blueprints) {\n    if (blueprint.manifest) {\n      manifest = blueprint.manifest;\n    }\n  }\n  assign(\"manifest\", manifest);\n  // Imperative escape hatches chain forward (acquisition order); teardown chains\n  // in reverse (LIFO), so resources release in the inverse of acquisition.\n  const hasActivates = blueprints.some((blueprint) => blueprint.activate);\n  assign(\n    \"activate\",\n    hasActivates\n      ? async (api: ExtensionApi): Promise<void> => {\n          for (const blueprint of blueprints) {\n            if (blueprint.activate) {\n              await blueprint.activate(api);\n            }\n          }\n        }\n      : undefined,\n  );\n  const hasDeactivates = blueprints.some((blueprint) => blueprint.deactivate);\n  assign(\n    \"deactivate\",\n    hasDeactivates\n      ? async (): Promise<void> => {\n          // Teardown is best-effort across modules: a throwing `deactivate` must\n          // not strand a later module's cleanup, so every hook runs (in reverse,\n          // LIFO) and failures are surfaced after cleanup completes.\n          const errors: unknown[] = [];\n          for (const blueprint of [...blueprints].reverse()) {\n            if (!blueprint.deactivate) {\n              continue;\n            }\n            try {\n              await blueprint.deactivate();\n            } catch (error) {\n              errors.push(error);\n            }\n          }\n          if (errors.length > 0) {\n            if (errors.length > 1) {\n              throw new AggregateError(errors, \"Multiple extension blueprint deactivate hooks failed.\");\n            }\n            throw errors[0];\n          }\n        }\n      : undefined,\n  );\n  return merged;\n}\n\n/**\n * Blueprint registration fields whose presence implies a capability, paired with\n * the capability each grants. Mirrors `EXTENSION_CAPABILITY_REGISTRATION_SURFACES`\n * so a blueprint's derived capabilities exactly match what the loader enforces\n * when {@link composeExtension}'s generated `activate` calls `api.register*`.\n *\n * `hooks` is handled separately (it is a nested object, not an array/record of\n * registrations) and so is intentionally absent from this table.\n */\nconst BLUEPRINT_FIELD_CAPABILITIES: ReadonlyArray<readonly [BlueprintRegistrationField, ExtensionCapability]> = [\n  [\"commands\", \"commands\"],\n  [\"commandOverrides\", \"commands\"],\n  [\"flags\", \"schema\"],\n  [\"itemTypes\", \"schema\"],\n  [\"itemFields\", \"schema\"],\n  [\"migrations\", \"schema\"],\n  [\"profiles\", \"schema\"],\n  [\"parsers\", \"parser\"],\n  [\"renderers\", \"renderers\"],\n  [\"services\", \"services\"],\n  [\"preflights\", \"preflight\"],\n  [\"searchProviders\", \"search\"],\n  [\"vectorStoreAdapters\", \"search\"],\n  [\"importers\", \"importers\"],\n  [\"exporters\", \"importers\"],\n];\n\ntype BlueprintRegistrationField =\n  | \"commands\"\n  | \"commandOverrides\"\n  | \"flags\"\n  | \"parsers\"\n  | \"renderers\"\n  | \"services\"\n  | \"preflights\"\n  | \"itemTypes\"\n  | \"itemFields\"\n  | \"migrations\"\n  | \"profiles\"\n  | \"searchProviders\"\n  | \"vectorStoreAdapters\"\n  | \"importers\"\n  | \"exporters\";\n\nfunction hasEntries(value: readonly unknown[] | Record<string, unknown> | null | undefined): boolean {\n  // `!value` treats both `null` and `undefined` as \"no entries\", so an untyped\n  // JavaScript author cannot crash capability derivation with an explicit null\n  // field — `Object.keys(null)` would otherwise throw.\n  if (!value) {\n    return false;\n  }\n  if (Array.isArray(value)) {\n    return value.length > 0;\n  }\n  return Object.keys(value).length > 0;\n}\n\n/**\n * Compute the minimal least-privilege capability set a {@link ExtensionBlueprint}\n * exercises, sorted and de-duplicated.\n *\n * Use it to author `manifest.json` `capabilities` exactly — declaring nothing the\n * extension does not use and nothing it does. It is the author-time inverse of\n * the runtime `reconcileExtensionCapabilityUsage` reconciliation: derive the set\n * here before activation rather than detecting drift after it. A blueprint with\n * no registration surfaces returns an empty array.\n */\nexport function deriveExtensionCapabilities(blueprint: ExtensionBlueprint): ExtensionCapability[] {\n  const capabilities = new Set<ExtensionCapability>();\n  for (const [field, capability] of BLUEPRINT_FIELD_CAPABILITIES) {\n    if (hasEntries(blueprint[field])) {\n      capabilities.add(capability);\n    }\n  }\n  // A command definition carrying its own inline `flags` registers them through\n  // `registerCommand`, which asserts the `schema` capability independently of the\n  // top-level `flags` record. Mirror that here so the derived set still matches\n  // what activation enforces when a command declares flags inline and the\n  // blueprint has no separate `flags` field. `!== undefined` (not a truthiness or\n  // length check) matches the loader's exact guard, including an empty inline array.\n  if ((blueprint.commands ?? []).filter(isPresent).some((command) => command.flags !== undefined)) {\n    capabilities.add(\"schema\");\n  }\n  // `registerImporter`/`registerExporter` with `options.flags` register flag\n  // metadata through the same surface as `registerFlags`, asserting the `schema`\n  // capability on top of `importers` (loader `applyImportExportCommandMetadata`).\n  // Mirror that guard so a flag-bearing importer/exporter derives `schema` too —\n  // otherwise a least-privilege manifest synthesized from the blueprint would\n  // under-grant `schema` and fail activation. `!== undefined` matches the loader's\n  // exact `options.flags` guard, including an empty flag array. `entry?.` keeps a\n  // malformed null array entry (from an untyped `.js`/JSON boundary) from crashing\n  // derivation, consistent with the null-field robustness above.\n  const importExportEntries = [...(blueprint.importers ?? []), ...(blueprint.exporters ?? [])].filter(isPresent);\n  if (importExportEntries.some((entry) => entry?.options?.flags !== undefined)) {\n    capabilities.add(\"schema\");\n  }\n  // Importers/exporters always synthesize command handlers (`<name> import` /\n  // `<name> export`), so runtime capability summaries attribute them to the\n  // commands surface as well as the importers surface. Keep the author-time\n  // capability preview aligned with describeExtensionActivation.\n  if (importExportEntries.some((entry) => typeof entry === \"object\")) {\n    capabilities.add(\"commands\");\n  }\n  // `?? {}` keeps an explicit `hooks: null` from throwing, mirroring composeExtension.\n  const hooks: ExtensionBlueprintHooks = blueprint.hooks ?? {};\n  if ([hooks.beforeCommand, hooks.afterCommand, hooks.onWrite, hooks.onRead, hooks.onIndex].some(hasEntries)) {\n    capabilities.add(\"hooks\");\n  }\n  return [...capabilities].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Blueprint hook fields paired with the lifecycle kind each registers, ordered to\n * match `ExtensionActivationResult.hook_counts` (and the runtime\n * {@link ../core/extensions/activation-summary.js#describeExtensionActivation}'s\n * `hooks` ordering) so a blueprint summary's `hooks` list reads in the same\n * canonical order, not alphabetically.\n */\nconst BLUEPRINT_HOOK_FIELD_TO_KIND = [\n  [\"beforeCommand\", \"before_command\"],\n  [\"afterCommand\", \"after_command\"],\n  [\"onWrite\", \"on_write\"],\n  [\"onRead\", \"on_read\"],\n  [\"onIndex\", \"on_index\"],\n] as const satisfies ReadonlyArray<readonly [keyof ExtensionBlueprintHooks, string]>;\n\n/** De-duplicate and locale-sort a list of identifiers, mirroring the runtime summary. */\nfunction sortUnique<TValue extends string>(values: readonly TValue[]): TValue[] {\n  return [...new Set(values)].sort((left, right) => left.localeCompare(right));\n}\n\nfunction isPresent<TValue>(value: TValue | null | undefined): value is TValue {\n  return value !== null && value !== undefined;\n}\n\nfunction importerCommandPath(entry: ExtensionBlueprintImporter): string {\n  return normalizeCommandName(`${entry.name} import`);\n}\n\nfunction exporterCommandPath(entry: ExtensionBlueprintExporter): string {\n  return normalizeCommandName(`${entry.name} export`);\n}\n\nfunction collectBlueprintCommandPaths(\n  commands: CommandDefinition[],\n  importers: ExtensionBlueprintImporter[],\n  exporters: ExtensionBlueprintExporter[],\n): string[] {\n  return [\n    ...commands.map((command) => normalizeCommandName(command.name)),\n    ...importers.filter((entry) => entry.options !== undefined).map(importerCommandPath),\n    ...exporters.filter((entry) => entry.options !== undefined).map(exporterCommandPath),\n  ];\n}\n\nfunction collectBlueprintFlagCommands(\n  blueprint: ExtensionBlueprint,\n  commands: CommandDefinition[],\n  importers: ExtensionBlueprintImporter[],\n  exporters: ExtensionBlueprintExporter[],\n): string[] {\n  return [\n    ...Object.keys(blueprint.flags ?? {}).map((command) => normalizeCommandName(command)),\n    ...commands.filter((command) => command.flags !== undefined).map((command) => normalizeCommandName(command.name)),\n    ...importers.filter((entry) => entry.options?.flags !== undefined).map(importerCommandPath),\n    ...exporters.filter((entry) => entry.options?.flags !== undefined).map(exporterCommandPath),\n  ];\n}\n\nfunction collectBlueprintHookKinds(hooks: ExtensionBlueprintHooks): string[] {\n  return BLUEPRINT_HOOK_FIELD_TO_KIND.filter(([field]) => (hooks[field]?.length ?? 0) > 0).map(([, kind]) => kind);\n}\n\nfunction collectBlueprintSurfaceSummary(\n  blueprint: ExtensionBlueprint,\n  importers: ExtensionBlueprintImporter[],\n  exporters: ExtensionBlueprintExporter[],\n): Pick<\n  ExtensionActivationSummary,\n  | \"item_types\"\n  | \"item_fields\"\n  | \"migrations\"\n  | \"profiles\"\n  | \"importers\"\n  | \"exporters\"\n  | \"search_providers\"\n  | \"vector_store_adapters\"\n  | \"parser_overrides\"\n  | \"service_overrides\"\n  | \"renderer_overrides\"\n  | \"preflight_overrides\"\n> {\n  return {\n    item_types: sortUnique((blueprint.itemTypes ?? []).map((type) => type.name)),\n    item_fields: sortUnique((blueprint.itemFields ?? []).map((field) => field.name)),\n    // id-less migrations register but carry no identifier, so they are omitted —\n    // exactly as describeExtensionActivation drops them from its `migrations` list.\n    migrations: sortUnique(\n      (blueprint.migrations ?? []).flatMap((migration) => (typeof migration.id === \"string\" ? [migration.id] : [])),\n    ),\n    profiles: sortUnique((blueprint.profiles ?? []).map((profile) => profile.name)),\n    importers: sortUnique(importers.map((entry) => normalizeCommandName(entry.name))),\n    exporters: sortUnique(exporters.map((entry) => normalizeCommandName(entry.name))),\n    search_providers: sortUnique((blueprint.searchProviders ?? []).map((provider) => provider.name)),\n    vector_store_adapters: sortUnique((blueprint.vectorStoreAdapters ?? []).map((adapter) => adapter.name)),\n    parser_overrides: sortUnique(Object.keys(blueprint.parsers ?? {}).map((command) => normalizeCommandName(command))),\n    service_overrides: sortUnique(\n      Object.keys(blueprint.services ?? {}).map((service) => String(service).trim().toLowerCase() as ExtensionServiceName),\n    ),\n    renderer_overrides: sortUnique(\n      Object.keys(blueprint.renderers ?? {}).map((format) => String(format).trim().toLowerCase() as OutputRendererFormat),\n    ),\n    preflight_overrides: (blueprint.preflights ?? []).length,\n  };\n}\n\n/**\n * Compute, without activating, the exact {@link ExtensionActivationSummary} that\n * {@link composeExtension}'s generated `activate` would produce for a blueprint.\n *\n * This is the author-time inverse of the runtime\n * {@link ../core/extensions/activation-summary.js#describeExtensionActivation}:\n * the runtime verb walks an *activated* registry, while this one reads the\n * declarative {@link ExtensionBlueprint} data directly, so an author or agent can\n * preview the full named surface map (commands, overrides, handlers, hooks, item\n * types/fields, importers/exporters, search/vector adapters, parser/service/\n * renderer overrides, flag-target commands, and the preflight count) with no\n * loading, activation, or side effects. It is to the named surfaces what\n * {@link deriveExtensionCapabilities} is to the capability set.\n *\n * Fidelity is by construction: command paths are normalized with the same\n * `normalizeCommandName` the loader applies, and importer/exporter handler paths\n * are synthesized as `normalizeCommandName(\"<name> import|export\")`, exactly as\n * `registerImporter`/`registerExporter` do. A parity test pins this output equal\n * to `describeExtensionActivation` over the same composed-and-activated blueprint.\n *\n * The one surface it cannot reflect is the blueprint's optional imperative\n * `activate` escape hatch — arbitrary code a static reader cannot inspect. A\n * blueprint that registers everything through that hatch summarizes as empty.\n */\nexport function describeExtensionBlueprint(blueprint: ExtensionBlueprint): ExtensionActivationSummary {\n  const commands = (blueprint.commands ?? []).filter(isPresent);\n  const importers = (blueprint.importers ?? []).filter(isPresent);\n  const exporters = (blueprint.exporters ?? []).filter(isPresent);\n  const importerPaths = importers.map(importerCommandPath);\n  const exporterPaths = exporters.map(exporterCommandPath);\n  const commandPaths = collectBlueprintCommandPaths(commands, importers, exporters);\n  // A command definition with inline `flags` registers a flag target under its own\n  // path in addition to any top-level `flags` record. Import/export options with\n  // `flags` register through the same runtime metadata path, so union all sources.\n  const flagCommands = collectBlueprintFlagCommands(blueprint, commands, importers, exporters);\n  const hooks: ExtensionBlueprintHooks = blueprint.hooks ?? {};\n  const surfaces = collectBlueprintSurfaceSummary(blueprint, importers, exporters);\n\n  return {\n    capabilities: deriveExtensionCapabilities(blueprint),\n    commands: sortUnique(commandPaths),\n    command_overrides: sortUnique(Object.keys(blueprint.commandOverrides ?? {}).map((command) => normalizeCommandName(command))),\n    // command_handlers is a superset of commands that also carries the synthesized\n    // importer/exporter command paths, but never the override-only paths.\n    command_handlers: sortUnique([...commandPaths, ...importerPaths, ...exporterPaths]),\n    hooks: collectBlueprintHookKinds(hooks),\n    flag_commands: sortUnique(flagCommands),\n    ...surfaces,\n  };\n}\n\n/**\n * The blueprint registration fields a lint flags as a dead \"empty surface\" when\n * present but empty. Mirrors {@link BlueprintRegistrationField} so adding a new\n * registration surface forces a decision here too; `hooks` is handled separately\n * because it is a nested object rather than an array/record of registrations.\n */\nconst BLUEPRINT_LINTABLE_SURFACE_FIELDS = [\n  \"commands\",\n  \"commandOverrides\",\n  \"flags\",\n  \"parsers\",\n  \"renderers\",\n  \"services\",\n  \"preflights\",\n  \"itemTypes\",\n  \"itemFields\",\n  \"migrations\",\n  \"profiles\",\n  \"searchProviders\",\n  \"vectorStoreAdapters\",\n  \"importers\",\n  \"exporters\",\n] as const satisfies ReadonlyArray<BlueprintRegistrationField>;\n\n/** Severity of an {@link ExtensionBlueprintLintFinding}: a hard `error` (activation will fail) or an advisory `warning`. */\nexport type ExtensionBlueprintLintSeverity = \"error\" | \"warning\";\n\n/**\n * Machine-readable kind of an {@link ExtensionBlueprintLintFinding}.\n *\n * - `capability_undeclared` (error): a surface exercises a capability the declared\n *   set omits; the loader throws `extension_capability_missing` at activation.\n * - `capability_unused` (warning): a declared capability no surface exercises; the\n *   runtime equivalent is the `pm package doctor` `extension_capability_unused` note.\n * - `duplicate_command` (warning): the same normalized command path is declared\n *   more than once in `commands`; the later registration shadows the earlier.\n * - `command_override_conflict` (warning): a path is declared as both a fresh\n *   command definition and a command override.\n * - `empty_surface` (warning): a registration field is present but contributes\n *   nothing — a dead declaration.\n * - `manifest_capabilities_absent` (warning): the blueprint exercises capabilities\n *   but offers no declared set to reconcile against.\n */\nexport type ExtensionBlueprintLintCode =\n  | \"capability_undeclared\"\n  | \"capability_unused\"\n  | \"duplicate_command\"\n  | \"command_override_conflict\"\n  | \"empty_surface\"\n  | \"manifest_capabilities_absent\";\n\n/**\n * A single author-time issue {@link lintExtensionBlueprint} found in a blueprint.\n */\nexport interface ExtensionBlueprintLintFinding {\n  /** The machine-readable {@link ExtensionBlueprintLintCode} for programmatic handling. */\n  code: ExtensionBlueprintLintCode;\n  /** Whether the finding blocks activation (`error`) or is advisory (`warning`). */\n  severity: ExtensionBlueprintLintSeverity;\n  /** Human-readable explanation, including the suggested fix. */\n  message: string;\n  /** The capability involved, for capability-drift findings. */\n  capability?: ExtensionCapability;\n  /** The normalized command path involved, for command findings. */\n  command?: string;\n  /** The blueprint field involved, for `empty_surface` findings. */\n  field?: string;\n}\n\n/**\n * Options for {@link lintExtensionBlueprint} and {@link ../sdk/testing.js#assertExtensionBlueprint}.\n */\nexport interface LintExtensionBlueprintOptions {\n  /**\n   * The capabilities the package's `manifest.json` declares (or will), used to\n   * reconcile against the surfaces the blueprint exercises. Overrides\n   * `blueprint.manifest.capabilities` when both are present. Omit both to lint\n   * without a capability reconciliation (only the structural checks run).\n   */\n  declaredCapabilities?: readonly string[];\n}\n\n/**\n * The structured result of {@link lintExtensionBlueprint}.\n */\nexport interface ExtensionBlueprintLintResult {\n  /** `true` when no `error`-severity finding is present (warnings still allow activation). */\n  ok: boolean;\n  /** Every finding, in detection order (capability drift, duplicates, conflicts, empty surfaces). */\n  findings: ExtensionBlueprintLintFinding[];\n  /** The least-privilege capability set the blueprint exercises (from {@link deriveExtensionCapabilities}). */\n  used: ExtensionCapability[];\n  /** The normalized declared capability set reconciled against, or `null` when none was provided. */\n  declared: ExtensionCapability[] | null;\n}\n\n/** Normalize a raw declared-capability list to known capabilities only (legacy-alias aware, sorted, de-duplicated). */\nfunction normalizeDeclaredCapabilities(capabilities: readonly string[]): ExtensionCapability[] {\n  const known = new Set<ExtensionCapability>();\n  for (const capability of capabilities) {\n    // Resolve a legacy alias (e.g. migration/validation → schema) exactly as the\n    // loader does before reconciliation — the author's raw manifest input has not\n    // been loader-normalized yet, so failing to resolve it here would misreport an\n    // alias-satisfied capability as undeclared. Fall back to a canonical known\n    // name; unknown capabilities are a separate diagnostic and are dropped so a\n    // typo is not misreported as \"unused\".\n    const normalized = resolveLegacyExtensionCapabilityAlias(capability) ?? normalizeKnownExtensionCapability(capability);\n    if (normalized !== null) {\n      known.add(normalized);\n    }\n  }\n  return [...known].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Reconcile a blueprint's exercised capabilities against its declared set: a\n * used-but-undeclared capability is an `error` (activation throws\n * `extension_capability_missing`), a declared-but-unused one a `warning`, and a\n * wholly absent declared set (`declared === null`) yields the single\n * `manifest_capabilities_absent` adoption hint.\n */\nfunction collectBlueprintCapabilityFindings(\n  used: ExtensionCapability[],\n  declared: ExtensionCapability[] | null,\n): ExtensionBlueprintLintFinding[] {\n  const findings: ExtensionBlueprintLintFinding[] = [];\n  if (declared === null) {\n    if (used.length > 0) {\n      findings.push({\n        code: \"manifest_capabilities_absent\",\n        severity: \"warning\",\n        message: `Blueprint exercises ${used.length === 1 ? \"capability\" : \"capabilities\"} [${used.join(\", \")}] but declares none; set capabilities to deriveExtensionCapabilities(blueprint) so the manifest grant matches.`,\n      });\n    }\n    return findings;\n  }\n  const declaredSet = new Set(declared);\n  const usedSet = new Set(used);\n  for (const capability of used) {\n    if (!declaredSet.has(capability)) {\n      findings.push({\n        code: \"capability_undeclared\",\n        severity: \"error\",\n        message: `Blueprint exercises capability \"${capability}\" but it is absent from the declared capabilities; activation throws extension_capability_missing — add \"${capability}\" to the manifest capabilities.`,\n        capability,\n      });\n    }\n  }\n  for (const capability of declared) {\n    if (!usedSet.has(capability)) {\n      findings.push({\n        code: \"capability_unused\",\n        severity: \"warning\",\n        message: `Capability \"${capability}\" is declared but no blueprint surface exercises it; drop it to keep the manifest least-privilege (pm package doctor reports this as extension_capability_unused).`,\n        capability,\n      });\n    }\n  }\n  return findings;\n}\n\n/**\n * Detect structural command footguns in a blueprint: a command path declared\n * more than once (`duplicate_command`, the later registration shadowing the\n * earlier at dispatch) and a path declared both as a fresh command definition\n * and as an override (`command_override_conflict`).\n */\nfunction collectBlueprintCommandFindings(blueprint: ExtensionBlueprint): ExtensionBlueprintLintFinding[] {\n  const findings: ExtensionBlueprintLintFinding[] = [];\n  const commandPathCounts = new Map<string, number>();\n  for (const command of blueprint.commands ?? []) {\n    const path = normalizeCommandName(command.name);\n    commandPathCounts.set(path, (commandPathCounts.get(path) ?? 0) + 1);\n  }\n  for (const [path, count] of commandPathCounts) {\n    if (count > 1) {\n      findings.push({\n        code: \"duplicate_command\",\n        severity: \"warning\",\n        message: `Command \"${path}\" is declared ${count} times in commands; the later registration shadows the earlier one at dispatch.`,\n        command: path,\n      });\n    }\n  }\n  const overridePaths = new Set(\n    Object.keys(blueprint.commandOverrides ?? {}).map((command) => normalizeCommandName(command)),\n  );\n  for (const path of commandPathCounts.keys()) {\n    if (overridePaths.has(path)) {\n      findings.push({\n        code: \"command_override_conflict\",\n        severity: \"warning\",\n        message: `Command \"${path}\" is declared both as a new command definition and as a command override; register one or the other.`,\n        command: path,\n      });\n    }\n  }\n  return findings;\n}\n\n/**\n * Flag blueprint registration fields that are present but contribute nothing —\n * an empty array/record surface, or a `hooks` object registering no lifecycle\n * hook — each reported as an `empty_surface` warning (fields first, then hooks).\n */\nfunction collectBlueprintEmptySurfaceFindings(blueprint: ExtensionBlueprint): ExtensionBlueprintLintFinding[] {\n  const findings: ExtensionBlueprintLintFinding[] = [];\n  for (const field of BLUEPRINT_LINTABLE_SURFACE_FIELDS) {\n    if (field in blueprint && !hasEntries(blueprint[field])) {\n      findings.push({\n        code: \"empty_surface\",\n        severity: \"warning\",\n        message: `Blueprint field \"${field}\" is present but empty; remove it or populate it.`,\n        field,\n      });\n    }\n  }\n  if (\"hooks\" in blueprint) {\n    const hooks: ExtensionBlueprintHooks = blueprint.hooks ?? {};\n    const registersHook = [hooks.beforeCommand, hooks.afterCommand, hooks.onWrite, hooks.onRead, hooks.onIndex].some(\n      hasEntries,\n    );\n    if (!registersHook) {\n      findings.push({\n        code: \"empty_surface\",\n        severity: \"warning\",\n        message: `Blueprint field \"hooks\" is present but registers no lifecycle hooks; remove it or populate it.`,\n        field: \"hooks\",\n      });\n    }\n  }\n  return findings;\n}\n\n/**\n * Preflight a declarative {@link ExtensionBlueprint} at author time, returning the\n * structured issues that would otherwise only surface at activation.\n *\n * It is the author-time inverse of the runtime extension guardrails — pure data\n * analysis with no loading, activation, or side effects:\n *\n * - capability drift in both directions: a capability a surface exercises but the\n *   declared set omits is an `error` (the loader throws `extension_capability_missing`\n *   at activation); a declared capability no surface exercises is a `warning` (the\n *   author-time form of the `pm package doctor` `extension_capability_unused` note,\n *   making this the static inverse of `reconcileExtensionCapabilityUsage`).\n * - structural footguns: a command path declared twice (`duplicate_command`), a\n *   path declared as both a command and an override (`command_override_conflict`),\n *   and a registration field present but empty (`empty_surface`).\n *\n * The declared set is taken from `options.declaredCapabilities` or, failing that,\n * `blueprint.manifest.capabilities`; with neither, capability reconciliation is\n * skipped and a single `manifest_capabilities_absent` warning suggests adopting\n * {@link deriveExtensionCapabilities}. Like {@link describeExtensionBlueprint},\n * the imperative `activate` escape hatch is invisible to this static check. The\n * findings are assembled from the per-dimension collectors\n * ({@link collectBlueprintCapabilityFindings}, {@link collectBlueprintCommandFindings},\n * {@link collectBlueprintEmptySurfaceFindings}) in that detection order.\n */\nexport function lintExtensionBlueprint(\n  blueprint: ExtensionBlueprint,\n  options: LintExtensionBlueprintOptions = {},\n): ExtensionBlueprintLintResult {\n  const used = deriveExtensionCapabilities(blueprint);\n\n  // A non-array declared source (an untyped `.js` author's malformed manifest, or\n  // a missing field) is treated as \"no declared set\" rather than \"declares nothing\".\n  const declaredSource = options.declaredCapabilities ?? blueprint.manifest?.capabilities;\n  const declared = Array.isArray(declaredSource) ? normalizeDeclaredCapabilities(declaredSource) : null;\n\n  // Findings accumulate in detection order: capability drift, then command\n  // duplicates/conflicts, then empty surfaces.\n  const findings: ExtensionBlueprintLintFinding[] = [\n    ...collectBlueprintCapabilityFindings(used, declared),\n    ...collectBlueprintCommandFindings(blueprint),\n    ...collectBlueprintEmptySurfaceFindings(blueprint),\n  ];\n\n  return {\n    ok: findings.every((finding) => finding.severity !== \"error\"),\n    findings,\n    used,\n    declared,\n  };\n}\n\n/**\n * The author-supplied identity fields {@link synthesizeExtensionManifest} cannot\n * derive from a blueprint: every {@link ExtensionManifest} field except the\n * generated `capabilities`.\n *\n * The blueprint determines `capabilities` (the surfaces it registers) and nothing\n * else, so `name`/`version`/`entry`/`priority` and any optional metadata\n * (engines, permissions, provenance, version floors/ceilings, sandbox profile,\n * manifest version, activation, legacy aliases) are the author's to supply here.\n */\nexport interface SynthesizeExtensionManifestIdentity extends Omit<ExtensionManifest, \"capabilities\"> {\n  /**\n   * Extra capabilities to grant beyond the blueprint's derived set, for surfaces\n   * registered through the blueprint's imperative `activate` escape hatch that\n   * static derivation cannot see (e.g. a renderer wired in `activate`). Each is\n   * legacy-alias resolved and normalized like a declared manifest capability;\n   * unknown names are dropped (the synthesized manifest is validated at load).\n   */\n  additionalCapabilities?: readonly string[];\n}\n\n/**\n * Generate a complete, least-privilege {@link ExtensionManifest} from a\n * declarative {@link ExtensionBlueprint} and the author's identity fields.\n *\n * This is the *generate* verb that completes the declarative authoring loop\n * (`compose → derive → describe/lint → synthesize`). Where\n * {@link defineExtensionManifest} only *types* a hand-written manifest and\n * {@link deriveExtensionCapabilities} computes only the capability set, this\n * function assembles the whole manifest: it copies every author-supplied identity\n * field verbatim and fills `capabilities` with `deriveExtensionCapabilities`\n * unioned with any {@link SynthesizeExtensionManifestIdentity.additionalCapabilities | additionalCapabilities},\n * sorted and de-duplicated. The author writes the blueprint once and never\n * hand-syncs `manifest.capabilities` — declaring nothing the extension does not\n * use and nothing it does.\n *\n * It is a pure assembler: it neither validates the blueprint definitions (that\n * stays in `api.register*` at activation) nor the identity fields (the loader\n * validates the on-disk manifest). Pair it with\n * {@link ../sdk/testing.js#assertExtensionManifestMatchesBlueprint} to guard a\n * hand-maintained `manifest.json` against drift in CI.\n */\nexport function synthesizeExtensionManifest(\n  blueprint: ExtensionBlueprint,\n  identity: SynthesizeExtensionManifestIdentity,\n): ExtensionManifest {\n  const { additionalCapabilities, ...manifestIdentity } = identity;\n  // `Array.isArray` keeps a non-array value (or an omitted field) crossing an\n  // untyped boundary from crashing the spread, mirroring the rest of the SDK.\n  const extra = Array.isArray(additionalCapabilities) ? normalizeDeclaredCapabilities(additionalCapabilities) : [];\n  const capabilities = [...new Set<ExtensionCapability>([...deriveExtensionCapabilities(blueprint), ...extra])].sort(\n    (left, right) => left.localeCompare(right),\n  );\n  return { ...manifestIdentity, capabilities };\n}\n\n/**\n * The two generated halves of a shippable extension package, returned by\n * {@link composeExtensionPackage}.\n */\nexport interface ExtensionPackage {\n  /**\n   * The runtime {@link ExtensionModule} to export as the package entry's default\n   * export. Its `manifest` mirror is set to the same {@link ExtensionPackage.manifest}\n   * object, so the in-module metadata and the on-disk manifest never diverge.\n   */\n  module: ExtensionModule;\n  /**\n   * The complete least-privilege {@link ExtensionManifest} to write as the\n   * package's `manifest.json`, with `capabilities` derived from the blueprint.\n   */\n  manifest: ExtensionManifest;\n}\n\n/**\n * Assemble both halves of a shippable extension package from one declarative\n * {@link ExtensionBlueprint} and the author's identity fields — the author-once\n * capstone of the declarative loop.\n *\n * Where {@link composeExtension} produces only the runtime module and\n * {@link synthesizeExtensionManifest} produces only the manifest, this unifies\n * them: it synthesizes the complete least-privilege manifest from the blueprint\n * and identity, then composes the module with that synthesized manifest set as its\n * authoritative in-module `manifest` mirror. Both halves are therefore generated\n * from a single source and cannot drift — the module's `manifest` is the very\n * object returned as `manifest`. Export `module` as the package entry's default\n * export and write `manifest` as `manifest.json`.\n *\n * It is a pure assembler with no validation, loading, or filesystem access,\n * exactly like the two functions it composes; pair it with\n * {@link preflightExtension} (or {@link ../sdk/testing.js#assertExtensionPreflight})\n * for the author-time verify step. Use {@link mergeExtensionBlueprints} first to\n * assemble the blueprint modularly, then this to ship it.\n */\nexport function composeExtensionPackage(\n  blueprint: ExtensionBlueprint,\n  identity: SynthesizeExtensionManifestIdentity,\n): ExtensionPackage {\n  const manifest = synthesizeExtensionManifest(blueprint, identity);\n  const module = composeExtension({ ...blueprint, manifest });\n  return { module, manifest };\n}\n\n/**\n * The target a {@link checkExtensionManifestCompatibility} call evaluates a\n * manifest's version bounds against.\n */\nexport interface ExtensionManifestCompatibilityTarget {\n  /**\n   * The pm CLI version to check the manifest against, e.g. the running CLI's\n   * `version` or a version floor a package commits to supporting. Plain\n   * dotted-numeric (`2026.6.23`) or `v`-prefixed values are compared; anything\n   * uninterpretable yields an `unchecked` finding rather than a false verdict.\n   */\n  pmVersion: string;\n  /**\n   * How a `pm_max_version` overrun is treated, mirroring the runtime\n   * `extensions.policy.pm_max_version_exceeded_mode`. `\"block\"` (the default)\n   * reports an exceeded upper bound as a blocking incompatibility; `\"warn\"`\n   * reports it as a non-blocking advisory, matching an operator who relaxed the\n   * gate during a CLI upgrade window.\n   */\n  pmMaxVersionExceededMode?: PmMaxVersionExceededMode;\n}\n\n/**\n * The manifest fields {@link checkExtensionManifestCompatibility} evaluates.\n *\n * Values are intentionally `unknown` rather than `string` so an author can\n * preflight the same malformed blank/non-string bounds (e.g. read from a JSON\n * manifest) the loader's manifest parser rejects as `extension_manifest_invalid`.\n */\nexport interface ExtensionManifestCompatibilityManifest {\n  /** Inclusive lower pm CLI version bound from `manifest.json`. */\n  pm_min_version?: unknown;\n  /** Inclusive upper pm CLI version bound from `manifest.json`. */\n  pm_max_version?: unknown;\n}\n\n/**\n * The machine-readable kind of an {@link ExtensionManifestCompatibilityFinding},\n * one per `<bound>_<outcome>` the loader can reach. Each mirrors a loader\n * `extension_pm_*_version_*` warning: `*_invalid`/`*_unmet`/`*_exceeded` block the\n * load, while `*_unchecked`/`*_exceeded_warn` are advisory (the extension still\n * loads).\n */\nexport type ExtensionManifestCompatibilityCode =\n  | \"pm_min_version_invalid\"\n  | \"pm_min_version_unchecked\"\n  | \"pm_min_version_unmet\"\n  | \"pm_max_version_invalid\"\n  | \"pm_max_version_unchecked\"\n  | \"pm_max_version_exceeded\"\n  | \"pm_max_version_exceeded_warn\";\n\n/**\n * A single version-bound issue {@link checkExtensionManifestCompatibility} found\n * when evaluating a manifest against a target pm version.\n */\nexport interface ExtensionManifestCompatibilityFinding {\n  /** The machine-readable {@link ExtensionManifestCompatibilityCode} for programmatic handling. */\n  code: ExtensionManifestCompatibilityCode;\n  /** `error` when the bound blocks the load against the target version, `warning` when it is advisory. */\n  severity: \"error\" | \"warning\";\n  /** Which manifest bound produced the finding. */\n  constraint: PmVersionBoundKind;\n  /** The declared bound value, verbatim. */\n  required: string;\n  /** The target pm version the bound was evaluated against. */\n  current: string;\n  /** Human-readable explanation of the outcome and its effect on loading. */\n  message: string;\n}\n\n/**\n * The structured result of {@link checkExtensionManifestCompatibility}.\n */\nexport interface ExtensionManifestCompatibilityResult {\n  /** `true` when no `error`-severity finding blocks the load against the target version. */\n  compatible: boolean;\n  /** Every bound finding, lower bound before upper bound; empty when both bounds are absent or satisfied. */\n  findings: ExtensionManifestCompatibilityFinding[];\n  /** The target pm version the manifest was checked against, echoed back for messaging. */\n  pmVersion: string;\n}\n\n/** Map a non-trivial bound evaluation to a compatibility finding, or `null` when the bound is absent or satisfied. */\nfunction toCompatibilityFinding(\n  evaluation: PmVersionBoundEvaluation,\n  pmVersion: string,\n): ExtensionManifestCompatibilityFinding | null {\n  if (evaluation.status === \"absent\" || evaluation.status === \"ok\") {\n    return null;\n  }\n  const code = `${evaluation.kind}_${evaluation.status}` as ExtensionManifestCompatibilityCode;\n  let message: string;\n  switch (code) {\n    case \"pm_min_version_invalid\":\n      message = `pm_min_version \"${evaluation.required}\" is not a valid version; the extension is treated as incompatible and the loader skips it.`;\n      break;\n    case \"pm_min_version_unchecked\":\n      message = `pm_min_version \"${evaluation.required}\" could not be compared against pm ${pmVersion}; compatibility is unverified.`;\n      break;\n    case \"pm_min_version_unmet\":\n      message = `Requires pm >= ${evaluation.required} but the target is pm ${pmVersion}; the loader skips the extension.`;\n      break;\n    case \"pm_max_version_invalid\":\n      message = `pm_max_version \"${evaluation.required}\" is not a valid inclusive upper bound (version ranges are not allowed); the extension is treated as incompatible and the loader skips it.`;\n      break;\n    case \"pm_max_version_unchecked\":\n      message = `pm_max_version \"${evaluation.required}\" could not be compared against pm ${pmVersion}; compatibility is unverified.`;\n      break;\n    case \"pm_max_version_exceeded\":\n      message = `Allows pm <= ${evaluation.required} but the target is pm ${pmVersion}; the loader skips the extension.`;\n      break;\n    case \"pm_max_version_exceeded_warn\":\n      message = `Target pm ${pmVersion} is newer than pm_max_version ${evaluation.required}, but the \"warn\" exceeded mode lets it load with a warning.`;\n      break;\n  }\n  return {\n    code,\n    severity: evaluation.allowed ? \"warning\" : \"error\",\n    constraint: evaluation.kind,\n    required: evaluation.required,\n    current: pmVersion,\n    message,\n  };\n}\n\n/**\n * Check, without loading anything, whether an extension manifest's declared\n * version bounds permit it to load on a given pm CLI version.\n *\n * This is the author-time inverse of the loader's runtime version gate: where the\n * loader resolves the *installed* CLI version (asynchronously, from `package.json`)\n * and emits `extension_pm_*_version_*` warnings, this pure synchronous function\n * takes the {@link ExtensionManifestCompatibilityTarget.pmVersion | target version}\n * the author supplies and returns structured findings. Both share the\n * {@link ../core/extensions/version-compat.js | version-compat core}, so the\n * author-time verdict and the runtime decision agree by construction — a package\n * author can pin a CI test to the pm version they support and catch a too-tight\n * `pm_min_version`, a malformed `pm_max_version`, or an upper bound a newer CLI\n * would exceed, long before publishing.\n *\n * `compatible` is `true` only when no bound blocks the load (`*_invalid`,\n * `*_unmet`, and a `block`-mode `*_exceeded`); `*_unchecked` (an uninterpretable\n * bound or target) and a `warn`-mode `*_exceeded_warn` are advisory `warning`\n * findings that still load. Pair it with\n * {@link ../sdk/testing.js#assertExtensionManifestCompatible} to fail CI on a\n * blocking incompatibility.\n */\nexport function checkExtensionManifestCompatibility(\n  manifest: ExtensionManifestCompatibilityManifest,\n  target: ExtensionManifestCompatibilityTarget,\n): ExtensionManifestCompatibilityResult {\n  const minEvaluation = evaluatePmMinVersionBound(manifest.pm_min_version, target.pmVersion);\n  const maxEvaluation = evaluatePmMaxVersionBound(\n    manifest.pm_max_version,\n    target.pmVersion,\n    target.pmMaxVersionExceededMode ?? \"block\",\n  );\n  const findings: ExtensionManifestCompatibilityFinding[] = [];\n  const minFinding = toCompatibilityFinding(minEvaluation, target.pmVersion);\n  if (minFinding !== null) {\n    findings.push(minFinding);\n  }\n  const maxFinding = toCompatibilityFinding(maxEvaluation, target.pmVersion);\n  if (maxFinding !== null) {\n    findings.push(maxFinding);\n  }\n  return {\n    compatible: minEvaluation.allowed && maxEvaluation.allowed,\n    findings,\n    pmVersion: target.pmVersion,\n  };\n}\n\n/**\n * The lint codes whose verdict depends on the *declared* capability set rather\n * than the blueprint's structure. {@link preflightExtension} drops these from its\n * consolidated view when it synthesizes the manifest from an `identity` without an\n * explicit declared set, because the synthesized manifest — not the blueprint's\n * stale in-module `manifest` mirror — is what the package ships, so a drift against\n * the mirror is a false positive. Structural codes (`duplicate_command`,\n * `command_override_conflict`, `empty_surface`) are never suppressed.\n */\nconst CAPABILITY_DRIFT_LINT_CODES = new Set<ExtensionBlueprintLintCode>([\n  \"capability_undeclared\",\n  \"capability_unused\",\n  \"manifest_capabilities_absent\",\n]);\n\n/**\n * Options for {@link preflightExtension} and\n * {@link ../sdk/testing.js#assertExtensionPreflight}. Every field is optional:\n * each one a check enables, so an author opts into exactly the stages whose\n * inputs they can supply.\n */\nexport interface PreflightExtensionOptions {\n  /**\n   * The author-supplied identity fields the blueprint cannot determine\n   * (`name`/`version`/`entry`/`priority`, version bounds, etc.). Provide them to\n   * have preflight {@link synthesizeExtensionManifest | synthesize} the complete\n   * least-privilege manifest and include it in the report; the synthesized\n   * version bounds then feed the {@link PreflightExtensionOptions.target | target}\n   * compatibility check. Omit to skip manifest synthesis.\n   */\n  identity?: SynthesizeExtensionManifestIdentity;\n  /**\n   * The pm CLI version (and optional max-version overrun mode) to evaluate the\n   * manifest's `pm_min_version`/`pm_max_version` bounds against. Provide it to run\n   * {@link checkExtensionManifestCompatibility} against the synthesized manifest\n   * (or, absent an `identity`, the blueprint's in-module `manifest` mirror). Omit\n   * to skip the version-compatibility check.\n   */\n  target?: ExtensionManifestCompatibilityTarget;\n  /**\n   * The capabilities the package's `manifest.json` declares, reconciled against\n   * the surfaces the blueprint exercises. Passed straight to\n   * {@link lintExtensionBlueprint}; when omitted it falls back to\n   * `blueprint.manifest.capabilities`, so the blueprint's in-module mirror is\n   * linted by default.\n   */\n  declaredCapabilities?: readonly string[];\n}\n\n/** Which preflight stage produced an {@link ExtensionPreflightFinding}. */\nexport type ExtensionPreflightFindingSource = \"blueprint\" | \"compatibility\";\n\n/**\n * A single finding in an {@link ExtensionPreflightReport}, flattened from one of\n * the underlying stages and tagged with its {@link ExtensionPreflightFindingSource}\n * so a consolidated report stays traceable to the check that raised it.\n */\nexport interface ExtensionPreflightFinding {\n  /** The stage that produced the finding: blueprint lint or version compatibility. */\n  source: ExtensionPreflightFindingSource;\n  /** Whether the finding blocks publish/activation (`error`) or is advisory (`warning`). */\n  severity: ExtensionBlueprintLintSeverity;\n  /** The underlying stage's machine-readable code, for programmatic handling. */\n  code: ExtensionBlueprintLintCode | ExtensionManifestCompatibilityCode;\n  /** The underlying stage's human-readable explanation, verbatim. */\n  message: string;\n}\n\n/**\n * The consolidated result of {@link preflightExtension}: every author-time stage's\n * structured output plus a flattened, source-tagged finding list.\n */\nexport interface ExtensionPreflightReport {\n  /** `true` when no `error`-severity finding appears across any stage (warnings still pass). */\n  ok: boolean;\n  /** The least-privilege capability set the blueprint exercises (from {@link deriveExtensionCapabilities}). */\n  capabilities: ExtensionCapability[];\n  /** The full {@link lintExtensionBlueprint} result (structural + capability-drift findings). */\n  blueprint: ExtensionBlueprintLintResult;\n  /** The manifest synthesized from `options.identity`, or `null` when no identity was supplied. */\n  manifest: ExtensionManifest | null;\n  /** The {@link checkExtensionManifestCompatibility} result, or `null` when no `options.target` was supplied. */\n  compatibility: ExtensionManifestCompatibilityResult | null;\n  /**\n   * Every finding from all stages, blueprint-lint findings before compatibility\n   * findings, each tagged by `source`. This is the consolidated, curated view: when\n   * `options.identity` synthesizes the manifest without an explicit\n   * `declaredCapabilities` set, capability-drift findings the lint raised against the\n   * blueprint's now-superseded in-module `manifest` mirror are omitted here (the raw\n   * `blueprint` result still carries them).\n   */\n  findings: ExtensionPreflightFinding[];\n}\n\n/**\n * Preflight a declarative {@link ExtensionBlueprint} through every author-time\n * check in one call, returning a single consolidated {@link ExtensionPreflightReport}.\n *\n * This is the author-time capstone — the static analog of\n * {@link ../sdk/testing.js#createExtensionTestHarness}, which unified the\n * runtime-test helpers. Instead of chaining {@link lintExtensionBlueprint},\n * {@link synthesizeExtensionManifest}, and {@link checkExtensionManifestCompatibility}\n * (and reconciling their separate results) before publishing a package, an author\n * runs `preflightExtension(blueprint, { identity, target })` and reads one report:\n *\n * - the blueprint is always linted (structural footguns + capability drift);\n * - when `options.identity` is given, the complete least-privilege manifest is\n *   synthesized and returned, so the author never hand-syncs `capabilities`;\n * - when `options.target` is given, the synthesized manifest's version bounds\n *   (or, absent an identity, the blueprint's in-module `manifest` mirror) are\n *   checked against that pm version.\n *\n * It is pure and side-effect-free — no loading, activation, or filesystem access,\n * exactly like the stages it composes — so it is safe in any author-time or CI\n * context. The per-stage structured results are exposed unmodified\n * (`report.blueprint`/`manifest`/`compatibility`) alongside the flattened,\n * source-tagged `report.findings`; `report.ok` is `false` if any stage produced an\n * `error`-severity finding. The flattened `findings` are curated for the author-once\n * flow: once an `identity` synthesizes the manifest (and no explicit\n * `declaredCapabilities` was pinned), the synthesized manifest — not the blueprint's\n * in-module `manifest` mirror — is what ships, so capability-drift findings the lint\n * raised against that mirror are false positives and are omitted from\n * `report.findings` (the raw `report.blueprint` result still reports them). Pair it\n * with {@link ../sdk/testing.js#assertExtensionPreflight} to fail CI in one line.\n */\nexport function preflightExtension(\n  blueprint: ExtensionBlueprint,\n  options: PreflightExtensionOptions = {},\n): ExtensionPreflightReport {\n  const blueprintResult = lintExtensionBlueprint(blueprint, { declaredCapabilities: options.declaredCapabilities });\n  const manifest = options.identity ? synthesizeExtensionManifest(blueprint, options.identity) : null;\n  // Compatibility evaluates the bounds the package will ship: the synthesized\n  // manifest when an identity drives generation, else the blueprint's in-module\n  // manifest mirror, else an empty manifest (no bounds → trivially compatible).\n  const compatibility = options.target\n    ? checkExtensionManifestCompatibility(manifest ?? blueprint.manifest ?? {}, options.target)\n    : null;\n  // When preflight synthesizes the manifest from an identity (and the caller did not\n  // pin an explicit declaredCapabilities set), the blueprint lint reconciled against\n  // the blueprint's in-module `manifest` mirror — which the synthesized manifest\n  // supersedes. Capability-drift findings against that stale mirror are false\n  // positives in the consolidated view (a missing capability would even flip `ok` to\n  // false though the synthesized manifest declares it), so drop them; structural\n  // findings are unaffected and the raw lint result on `report.blueprint` keeps all of\n  // them. An explicit declaredCapabilities set is a deliberate \"check exactly this\"\n  // request, so it is never suppressed.\n  const suppressCapabilityDrift = manifest !== null && options.declaredCapabilities === undefined;\n  const blueprintFindings = suppressCapabilityDrift\n    ? blueprintResult.findings.filter((finding) => !CAPABILITY_DRIFT_LINT_CODES.has(finding.code))\n    : blueprintResult.findings;\n  const findings: ExtensionPreflightFinding[] = [\n    ...blueprintFindings.map(\n      (finding): ExtensionPreflightFinding => ({\n        source: \"blueprint\",\n        severity: finding.severity,\n        code: finding.code,\n        message: finding.message,\n      }),\n    ),\n    ...(compatibility?.findings ?? []).map(\n      (finding): ExtensionPreflightFinding => ({\n        source: \"compatibility\",\n        severity: finding.severity,\n        code: finding.code,\n        message: finding.message,\n      }),\n    ),\n  ];\n  return {\n    ok: findings.every((finding) => finding.severity !== \"error\"),\n    capabilities: blueprintResult.used,\n    blueprint: blueprintResult,\n    manifest,\n    compatibility,\n    findings,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"329d1e0e-99f4-5153-addd-3e8ae912dae1"}

package/docs/AGENT_GUIDE.md

@@ -120,7 +120,7 @@ pm release <item-id>
 | Full machine payload | `pm get <id> --full --json` |
 | Command flags | `pm <command> --help --json` |
 | Low-noise machine contracts | `pm contracts --command <command> --flags-only --json` |
-| Semantic index refresh | `pm reindex --mode semantic --progress` (stale-first by default; add `--full` to force full rebuild) |
+| Semantic index refresh | `pm reindex --mode semantic --progress` (stale-first by default; add `--full` to force full rebuild; requires the `search-advanced` package) |
 | Timeline | `pm activity --id <id> --limit 20` |
 | Audited history redaction | `pm history-redact <id> --literal "<secret>" --replacement "[redacted]" --dry-run` |
 | Audited history re-anchor | `pm history-repair <id> --dry-run` (clears drift flagged by `pm health`/`pm validate`) |
@@ -189,7 +189,7 @@ Use these defaults unless the task requires otherwise:
 - `pm schema add-status <id> --role <role>` / `pm schema remove-status <id>` manage custom lifecycle statuses in `.agents/pm/schema/statuses.json`; roles come from the runtime status-role vocabulary, the upsert is idempotent, and built-in default statuses cannot be removed. `pm schema list` now reports statuses (builtin vs custom) alongside types.
 - `pm init --type-preset agile|ops|research` for new projects that should start with domain item types instead of generic tasks only.
 - After switching embedding provider/model, run `pm reindex --mode semantic --full` or `pm reindex --mode hybrid --full` to rebuild vectors completely; `pm reindex --mode keyword` ignores `--full` and now warns when ledger identity drift is detected.
-- `pm normalize --dry-run --json` before lifecycle metadata cleanups.
+- `pm normalize --dry-run --json` before lifecycle metadata cleanups (requires the `governance-audit` package).
 - `pm health --check-only` when inspecting repository health without refresh side effects.
 - Mistyped command names get a `Did you mean: <command>?` hint, including typos of the executable shortcut aliases — `pm shwo <id>` suggests `get` (the canonical of `show`/`view`), and `pm comemnt` suggests `comments`.
 

package/docs/ARCHITECTURE.md

@@ -14,7 +14,7 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 
 ## System Overview
 
-`pm-cli` is a TypeScript ESM CLI for Node.js 20+. It is file-backed, git-native, deterministic, and designed for concurrent human plus agent workflows.
+`pm-cli` is a TypeScript ESM CLI for Node.js 22.18+. It is file-backed, git-native, deterministic, and designed for concurrent human plus agent workflows.
 
 High-level flow:
 
@@ -304,7 +304,7 @@ Useful commands:
 
 ```bash
 pm search "restore history" --mode keyword --limit 10
-pm reindex --mode hybrid --progress
+pm reindex --mode hybrid --progress   # requires the search-advanced package
 pm health --check-only
 ```
 

package/docs/COMMANDS.md

@@ -30,9 +30,9 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 | Bulk | `update-many`, `close-many` | apply one change across a matched, dry-run-previewed set with a rollback checkpoint |
 | Scheduling | `meet`, `event`, `remind` | low-friction Meeting/Event/Reminder creation |
 | Planning | `plan create`, `plan add-step`, `plan update-step`, `plan complete-step`, `plan link`, `plan approve`, `plan materialize` | agent-optimized living plans with ordered steps, evidence, decisions, validation, and materialization |
-| Logs | `comments`, `notes`, `learnings`, `comments-audit` | record progress and durable context |
+| Logs | `comments`, `notes`, `learnings`, `comments-audit`* | record progress and durable context |
 | Links | `files`, `docs`, `test`, `deps` | connect items to artifacts, tests, and relationships |
-| Verification | `test`, `test-all`, `test-runs`, `validate`, `gc` | run linked tests and repository checks |
+| Verification | `test`, `test-all`, `test-runs`†, `validate`, `gc` | run linked tests and repository checks |
 | History | `history`, `history-compact`, `history-redact`, `history-repair`, `activity`, `restore`, `stats` | inspect, compact, redact, re-anchor, and recover item state |
 | Schema | `schema add-type` / `remove-type` / `add-status` / `remove-status` / `add-field` / `remove-field` / `apply-preset` | manage config-driven custom item types (`.agents/pm/schema/types.json`), statuses (`.agents/pm/schema/statuses.json`), and custom metadata fields (`.agents/pm/schema/fields.json`); `apply-preset` adopts a domain type preset; `add-type --infer` derives types from title-prefix conventions |
 | Profiles | `profile list` / `show` / `apply` / `lint` | compose item types, statuses, fields, workflows, config, templates, and recommended packages into archetype bundles (agile/ops/research); `apply` stages every dimension idempotently; `lint` reports author-time consistency findings without writing |
@@ -40,7 +40,9 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 | Packages | `install`, `upgrade`, `package`, `packages`, `extension`, package/extension command groups | install, upgrade, manage, and run package-backed extension commands |
 | Machines | `contracts`, `help`, optional `guide`/`completion` | command contracts plus optional guide-shell docs routing and shell helpers |
 
-`*` `dedupe-audit` and `dedupe-merge` are provided by the optional `governance-audit` package (`pm install governance-audit --project`).
+`*` `dedupe-audit`, `dedupe-merge`, `comments-audit`, and `normalize` are provided by the optional `governance-audit` package (`pm install governance-audit --project`).
+
+`†` `test-runs` subcommands are provided by the optional `linked-test-adapters` package (`pm install linked-test-adapters --project`).
 
 ## Bootstrap
 
@@ -746,7 +748,7 @@ pm create Spike "Investigate retry backoff"
 - `add-type` is an idempotent UPSERT keyed on the type name (case-insensitive); re-running it merges aliases and overrides supplied fields while preserving everything else.
 - `remove-type <Name>` removes a custom type definition (case-insensitive). Built-in types are refused. It WARNS (non-blocking) with `items_using_type:<N>` when items of that type still exist, then removes the definition.
 - `add-status <id>` writes a custom lifecycle status (idempotent UPSERT keyed on the normalized id; re-adding sets `replaced: true`). Roles are validated against the runtime status roles: `draft`, `active`, `blocked`, `terminal`, `terminal_done`, `terminal_canceled`, `default_open`, `default_close`, `default_cancel`.
-- `remove-status <id>` removes a custom status. The five built-in default statuses (`open`, `in_progress`, `blocked`, `closed`, `canceled`, plus `draft`) are refused. It WARNS (non-blocking) with `items_using_status:<N>` when items currently use that status.
+- `remove-status <id>` removes a custom status. The six built-in statuses (`open`, `in_progress`, `blocked`, `closed`, `canceled`, `draft`) are refused. It WARNS (non-blocking) with `items_using_status:<N>` when items currently use that status.
 - Built-in types (Chore, Decision, Epic, Event, Feature, Issue, Meeting, Milestone, Plan, Reminder, Task) are reserved and cannot be redefined or removed.
 - `add-field <key>` registers a custom metadata field in `.agents/pm/schema/fields.json` (shape: `{ "fields": [RuntimeFieldDefinition...] }`). Each custom field dynamically registers a CLI flag on create/update (and any other commands you list) so projects can capture typed project-specific metadata without hand-editing JSON. It is an idempotent UPSERT keyed on the normalized key, and refuses keys that shadow a built-in field. `list-fields` / `show-field <key>` inspect registered fields; `remove-field <key>` drops one and WARNS (non-blocking) with `items_using_field:<N>` when items still carry a value. See [CONFIGURATION.md](CONFIGURATION.md) for the full `schema/fields.json` format.
 - `apply-preset <agile|ops|research>` batch-registers a domain type preset into an already-initialized project (the same vocabulary `pm init --type-preset` seeds); it is idempotent (re-running reports `replaced` entries) and shares its definitions with init.
@@ -856,6 +858,8 @@ Agents should use runtime contracts instead of hard-coding flag lists. Contract
 
 ## Completion
 
+`pm completion` is provided by the optional `guide-shell` package (`pm install guide-shell --project`).
+
 ```bash
 pm completion bash
 pm completion zsh

package/docs/CONFIGURATION.md

@@ -168,7 +168,7 @@ pm get <id> --full --json
 pm contracts --json
 ```
 
-`pm calendar` defaults to markdown because date-centric summaries are easier to scan in that format.
+`pm calendar` (provided by the optional `calendar` package — `pm install calendar --project`) defaults to markdown because date-centric summaries are easier to scan in that format.
 
 ## Validation Policies