@unbrained/pm-cli 2026.6.22 → 2026.6.23

package/dist/sdk/compose.js

@@ -0,0 +1,420 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3a61717e-bae1-57d3-a1d1-436b1a60deca")}catch(e){}}();
+import { normalizeKnownExtensionCapability, resolveLegacyExtensionCapabilityAlias, } from "../core/extensions/extension-capability-aliases.js";
+import { normalizeCommandName } from "../core/extensions/extension-runtime-helpers.js";
+/**
+ * Typed identity helper for extension module exports.
+ *
+ * Use as:
+ * `export default defineExtension({ activate(api) { ... } })`
+ *
+ * Reach for {@link composeExtension} instead when you would rather declare the
+ * registrations as data than wire them imperatively in `activate`.
+ */
+export function defineExtension(module) {
+    return module;
+}
+/**
+ * Assemble an {@link ExtensionModule} from a declarative {@link ExtensionBlueprint}.
+ *
+ * The returned module's `activate` registers every populated surface through the
+ * matching `api.register*` method in a deterministic order (commands → overrides
+ * → flags → parsers → renderers → services → preflights → item types → item
+ * fields → migrations → search providers → vector store adapters → importers →
+ * exporters → hooks), then awaits the blueprint's optional imperative `activate`
+ * so it can layer on anything the declarative form cannot express. `manifest`
+ * and `deactivate` are copied onto the module verbatim.
+ *
+ * This is a pure assembler: it does not validate the definitions. Per-surface
+ * contract enforcement stays in `api.register*` (and the loader), exactly as it
+ * does for hand-written `activate` bodies, so a malformed definition surfaces
+ * the same activation diagnostic either way.
+ */
+export function composeExtension(blueprint) {
+    const activate = async (api) => {
+        for (const command of blueprint.commands ?? []) {
+            api.registerCommand(command);
+        }
+        for (const [command, override] of Object.entries(blueprint.commandOverrides ?? {})) {
+            api.registerCommand(command, override);
+        }
+        for (const [targetCommand, flags] of Object.entries(blueprint.flags ?? {})) {
+            api.registerFlags(targetCommand, flags);
+        }
+        for (const [command, override] of Object.entries(blueprint.parsers ?? {})) {
+            api.registerParser(command, override);
+        }
+        for (const [format, renderer] of Object.entries(blueprint.renderers ?? {})) {
+            api.registerRenderer(format, renderer);
+        }
+        for (const [service, override] of Object.entries(blueprint.services ?? {})) {
+            api.registerService(service, override);
+        }
+        for (const override of blueprint.preflights ?? []) {
+            api.registerPreflight(override);
+        }
+        const itemTypes = blueprint.itemTypes ?? [];
+        if (itemTypes.length > 0) {
+            api.registerItemTypes(itemTypes);
+        }
+        const itemFields = blueprint.itemFields ?? [];
+        if (itemFields.length > 0) {
+            api.registerItemFields(itemFields);
+        }
+        for (const migration of blueprint.migrations ?? []) {
+            api.registerMigration(migration);
+        }
+        for (const provider of blueprint.searchProviders ?? []) {
+            api.registerSearchProvider(provider);
+        }
+        for (const adapter of blueprint.vectorStoreAdapters ?? []) {
+            api.registerVectorStoreAdapter(adapter);
+        }
+        for (const entry of blueprint.importers ?? []) {
+            api.registerImporter(entry.name, entry.importer, entry.options);
+        }
+        for (const entry of blueprint.exporters ?? []) {
+            api.registerExporter(entry.name, entry.exporter, entry.options);
+        }
+        // `?? {}` (rather than a `!== undefined` guard) so an untyped JavaScript
+        // author who passes `hooks: null` is treated the same as omitting it,
+        // instead of throwing on the first `hooks.beforeCommand` access.
+        const hooks = blueprint.hooks ?? {};
+        for (const hook of hooks.beforeCommand ?? []) {
+            api.hooks.beforeCommand(hook);
+        }
+        for (const hook of hooks.afterCommand ?? []) {
+            api.hooks.afterCommand(hook);
+        }
+        for (const hook of hooks.onWrite ?? []) {
+            api.hooks.onWrite(hook);
+        }
+        for (const hook of hooks.onRead ?? []) {
+            api.hooks.onRead(hook);
+        }
+        for (const hook of hooks.onIndex ?? []) {
+            api.hooks.onIndex(hook);
+        }
+        await blueprint.activate?.(api);
+    };
+    // Truthy checks (rather than `!== undefined`) so an explicit `null` mirror or
+    // teardown is treated as absent instead of copied onto the module.
+    const module = { activate };
+    if (blueprint.manifest) {
+        module.manifest = blueprint.manifest;
+    }
+    if (blueprint.deactivate) {
+        module.deactivate = blueprint.deactivate;
+    }
+    return module;
+}
+/**
+ * Blueprint registration fields whose presence implies a capability, paired with
+ * the capability each grants. Mirrors `EXTENSION_CAPABILITY_REGISTRATION_SURFACES`
+ * so a blueprint's derived capabilities exactly match what the loader enforces
+ * when {@link composeExtension}'s generated `activate` calls `api.register*`.
+ *
+ * `hooks` is handled separately (it is a nested object, not an array/record of
+ * registrations) and so is intentionally absent from this table.
+ */
+const BLUEPRINT_FIELD_CAPABILITIES = [
+    ["commands", "commands"],
+    ["commandOverrides", "commands"],
+    ["flags", "schema"],
+    ["itemTypes", "schema"],
+    ["itemFields", "schema"],
+    ["migrations", "schema"],
+    ["parsers", "parser"],
+    ["renderers", "renderers"],
+    ["services", "services"],
+    ["preflights", "preflight"],
+    ["searchProviders", "search"],
+    ["vectorStoreAdapters", "search"],
+    ["importers", "importers"],
+    ["exporters", "importers"],
+];
+function hasEntries(value) {
+    // `!value` treats both `null` and `undefined` as "no entries", so an untyped
+    // JavaScript author cannot crash capability derivation with an explicit null
+    // field — `Object.keys(null)` would otherwise throw.
+    if (!value) {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    return Object.keys(value).length > 0;
+}
+/**
+ * Compute the minimal least-privilege capability set a {@link ExtensionBlueprint}
+ * exercises, sorted and de-duplicated.
+ *
+ * Use it to author `manifest.json` `capabilities` exactly — declaring nothing the
+ * extension does not use and nothing it does. It is the author-time inverse of
+ * the runtime `reconcileExtensionCapabilityUsage` reconciliation: derive the set
+ * here before activation rather than detecting drift after it. A blueprint with
+ * no registration surfaces returns an empty array.
+ */
+export function deriveExtensionCapabilities(blueprint) {
+    const capabilities = new Set();
+    for (const [field, capability] of BLUEPRINT_FIELD_CAPABILITIES) {
+        if (hasEntries(blueprint[field])) {
+            capabilities.add(capability);
+        }
+    }
+    // A command definition carrying its own inline `flags` registers them through
+    // `registerCommand`, which asserts the `schema` capability independently of the
+    // top-level `flags` record. Mirror that here so the derived set still matches
+    // what activation enforces when a command declares flags inline and the
+    // blueprint has no separate `flags` field. `!== undefined` (not a truthiness or
+    // length check) matches the loader's exact guard, including an empty inline array.
+    if ((blueprint.commands ?? []).some((command) => command.flags !== undefined)) {
+        capabilities.add("schema");
+    }
+    // `?? {}` keeps an explicit `hooks: null` from throwing, mirroring composeExtension.
+    const hooks = blueprint.hooks ?? {};
+    if ([hooks.beforeCommand, hooks.afterCommand, hooks.onWrite, hooks.onRead, hooks.onIndex].some(hasEntries)) {
+        capabilities.add("hooks");
+    }
+    return [...capabilities].sort((left, right) => left.localeCompare(right));
+}
+/**
+ * Blueprint hook fields paired with the lifecycle kind each registers, ordered to
+ * match `ExtensionActivationResult.hook_counts` (and the runtime
+ * {@link ../core/extensions/activation-summary.js#describeExtensionActivation}'s
+ * `hooks` ordering) so a blueprint summary's `hooks` list reads in the same
+ * canonical order, not alphabetically.
+ */
+const BLUEPRINT_HOOK_FIELD_TO_KIND = [
+    ["beforeCommand", "before_command"],
+    ["afterCommand", "after_command"],
+    ["onWrite", "on_write"],
+    ["onRead", "on_read"],
+    ["onIndex", "on_index"],
+];
+/** De-duplicate and locale-sort a list of identifiers, mirroring the runtime summary. */
+function sortUnique(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+/**
+ * Compute, without activating, the exact {@link ExtensionActivationSummary} that
+ * {@link composeExtension}'s generated `activate` would produce for a blueprint.
+ *
+ * This is the author-time inverse of the runtime
+ * {@link ../core/extensions/activation-summary.js#describeExtensionActivation}:
+ * the runtime verb walks an *activated* registry, while this one reads the
+ * declarative {@link ExtensionBlueprint} data directly, so an author or agent can
+ * preview the full named surface map (commands, overrides, handlers, hooks, item
+ * types/fields, importers/exporters, search/vector adapters, parser/service/
+ * renderer overrides, flag-target commands, and the preflight count) with no
+ * loading, activation, or side effects. It is to the named surfaces what
+ * {@link deriveExtensionCapabilities} is to the capability set.
+ *
+ * Fidelity is by construction: command paths are normalized with the same
+ * `normalizeCommandName` the loader applies, and importer/exporter handler paths
+ * are synthesized as `normalizeCommandName("<name> import|export")`, exactly as
+ * `registerImporter`/`registerExporter` do. A parity test pins this output equal
+ * to `describeExtensionActivation` over the same composed-and-activated blueprint.
+ *
+ * The one surface it cannot reflect is the blueprint's optional imperative
+ * `activate` escape hatch — arbitrary code a static reader cannot inspect. A
+ * blueprint that registers everything through that hatch summarizes as empty.
+ */
+export function describeExtensionBlueprint(blueprint) {
+    const commandPaths = (blueprint.commands ?? []).map((command) => normalizeCommandName(command.name));
+    const importerPaths = (blueprint.importers ?? []).map((entry) => normalizeCommandName(`${entry.name} import`));
+    const exporterPaths = (blueprint.exporters ?? []).map((entry) => normalizeCommandName(`${entry.name} export`));
+    // A command definition with inline `flags` registers a flag target under its own
+    // path in addition to any top-level `flags` record, so union both sources.
+    const flagCommands = [
+        ...Object.keys(blueprint.flags ?? {}).map((command) => normalizeCommandName(command)),
+        ...(blueprint.commands ?? [])
+            .filter((command) => command.flags !== undefined)
+            .map((command) => normalizeCommandName(command.name)),
+    ];
+    const hooks = blueprint.hooks ?? {};
+    return {
+        capabilities: deriveExtensionCapabilities(blueprint),
+        commands: sortUnique(commandPaths),
+        command_overrides: sortUnique(Object.keys(blueprint.commandOverrides ?? {}).map((command) => normalizeCommandName(command))),
+        // command_handlers is a superset of commands that also carries the synthesized
+        // importer/exporter command paths, but never the override-only paths.
+        command_handlers: sortUnique([...commandPaths, ...importerPaths, ...exporterPaths]),
+        hooks: BLUEPRINT_HOOK_FIELD_TO_KIND.filter(([field]) => (hooks[field]?.length ?? 0) > 0).map(([, kind]) => kind),
+        flag_commands: sortUnique(flagCommands),
+        item_types: sortUnique((blueprint.itemTypes ?? []).map((type) => type.name)),
+        item_fields: sortUnique((blueprint.itemFields ?? []).map((field) => field.name)),
+        // id-less migrations register but carry no identifier, so they are omitted —
+        // exactly as describeExtensionActivation drops them from its `migrations` list.
+        migrations: sortUnique((blueprint.migrations ?? []).flatMap((migration) => (typeof migration.id === "string" ? [migration.id] : []))),
+        importers: sortUnique((blueprint.importers ?? []).map((entry) => normalizeCommandName(entry.name))),
+        exporters: sortUnique((blueprint.exporters ?? []).map((entry) => normalizeCommandName(entry.name))),
+        search_providers: sortUnique((blueprint.searchProviders ?? []).map((provider) => provider.name)),
+        vector_store_adapters: sortUnique((blueprint.vectorStoreAdapters ?? []).map((adapter) => adapter.name)),
+        parser_overrides: sortUnique(Object.keys(blueprint.parsers ?? {}).map((command) => normalizeCommandName(command))),
+        service_overrides: sortUnique(Object.keys(blueprint.services ?? {}).map((service) => String(service).trim().toLowerCase())),
+        renderer_overrides: sortUnique(Object.keys(blueprint.renderers ?? {}).map((format) => String(format).trim().toLowerCase())),
+        preflight_overrides: (blueprint.preflights ?? []).length,
+    };
+}
+/**
+ * The blueprint registration fields a lint flags as a dead "empty surface" when
+ * present but empty. Mirrors {@link BlueprintRegistrationField} so adding a new
+ * registration surface forces a decision here too; `hooks` is handled separately
+ * because it is a nested object rather than an array/record of registrations.
+ */
+const BLUEPRINT_LINTABLE_SURFACE_FIELDS = [
+    "commands",
+    "commandOverrides",
+    "flags",
+    "parsers",
+    "renderers",
+    "services",
+    "preflights",
+    "itemTypes",
+    "itemFields",
+    "migrations",
+    "searchProviders",
+    "vectorStoreAdapters",
+    "importers",
+    "exporters",
+];
+/** Normalize a raw declared-capability list to known capabilities only (legacy-alias aware, sorted, de-duplicated). */
+function normalizeDeclaredCapabilities(capabilities) {
+    const known = new Set();
+    for (const capability of capabilities) {
+        // Resolve a legacy alias (e.g. migration/validation → schema) exactly as the
+        // loader does before reconciliation — the author's raw manifest input has not
+        // been loader-normalized yet, so failing to resolve it here would misreport an
+        // alias-satisfied capability as undeclared. Fall back to a canonical known
+        // name; unknown capabilities are a separate diagnostic and are dropped so a
+        // typo is not misreported as "unused".
+        const normalized = resolveLegacyExtensionCapabilityAlias(capability) ?? normalizeKnownExtensionCapability(capability);
+        if (normalized !== null) {
+            known.add(normalized);
+        }
+    }
+    return [...known].sort((left, right) => left.localeCompare(right));
+}
+/**
+ * Preflight a declarative {@link ExtensionBlueprint} at author time, returning the
+ * structured issues that would otherwise only surface at activation.
+ *
+ * It is the author-time inverse of the runtime extension guardrails — pure data
+ * analysis with no loading, activation, or side effects:
+ *
+ * - capability drift in both directions: a capability a surface exercises but the
+ *   declared set omits is an `error` (the loader throws `extension_capability_missing`
+ *   at activation); a declared capability no surface exercises is a `warning` (the
+ *   author-time form of the `pm package doctor` `extension_capability_unused` note,
+ *   making this the static inverse of `reconcileExtensionCapabilityUsage`).
+ * - structural footguns: a command path declared twice (`duplicate_command`), a
+ *   path declared as both a command and an override (`command_override_conflict`),
+ *   and a registration field present but empty (`empty_surface`).
+ *
+ * The declared set is taken from `options.declaredCapabilities` or, failing that,
+ * `blueprint.manifest.capabilities`; with neither, capability reconciliation is
+ * skipped and a single `manifest_capabilities_absent` warning suggests adopting
+ * {@link deriveExtensionCapabilities}. Like {@link describeExtensionBlueprint},
+ * the imperative `activate` escape hatch is invisible to this static check.
+ */
+export function lintExtensionBlueprint(blueprint, options = {}) {
+    const findings = [];
+    const used = deriveExtensionCapabilities(blueprint);
+    // A non-array declared source (an untyped `.js` author's malformed manifest, or
+    // a missing field) is treated as "no declared set" rather than "declares nothing".
+    const declaredSource = options.declaredCapabilities ?? blueprint.manifest?.capabilities;
+    const declared = Array.isArray(declaredSource) ? normalizeDeclaredCapabilities(declaredSource) : null;
+    if (declared === null) {
+        if (used.length > 0) {
+            findings.push({
+                code: "manifest_capabilities_absent",
+                severity: "warning",
+                message: `Blueprint exercises ${used.length === 1 ? "capability" : "capabilities"} [${used.join(", ")}] but declares none; set capabilities to deriveExtensionCapabilities(blueprint) so the manifest grant matches.`,
+            });
+        }
+    }
+    else {
+        const declaredSet = new Set(declared);
+        const usedSet = new Set(used);
+        for (const capability of used) {
+            if (!declaredSet.has(capability)) {
+                findings.push({
+                    code: "capability_undeclared",
+                    severity: "error",
+                    message: `Blueprint exercises capability "${capability}" but it is absent from the declared capabilities; activation throws extension_capability_missing — add "${capability}" to the manifest capabilities.`,
+                    capability,
+                });
+            }
+        }
+        for (const capability of declared) {
+            if (!usedSet.has(capability)) {
+                findings.push({
+                    code: "capability_unused",
+                    severity: "warning",
+                    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).`,
+                    capability,
+                });
+            }
+        }
+    }
+    // Duplicate command paths within the declared command definitions.
+    const commandPathCounts = new Map();
+    for (const command of blueprint.commands ?? []) {
+        const path = normalizeCommandName(command.name);
+        commandPathCounts.set(path, (commandPathCounts.get(path) ?? 0) + 1);
+    }
+    for (const [path, count] of commandPathCounts) {
+        if (count > 1) {
+            findings.push({
+                code: "duplicate_command",
+                severity: "warning",
+                message: `Command "${path}" is declared ${count} times in commands; the later registration shadows the earlier one at dispatch.`,
+                command: path,
+            });
+        }
+    }
+    // A command path declared as both a fresh definition and an override.
+    const overridePaths = new Set(Object.keys(blueprint.commandOverrides ?? {}).map((command) => normalizeCommandName(command)));
+    for (const path of commandPathCounts.keys()) {
+        if (overridePaths.has(path)) {
+            findings.push({
+                code: "command_override_conflict",
+                severity: "warning",
+                message: `Command "${path}" is declared both as a new command definition and as a command override; register one or the other.`,
+                command: path,
+            });
+        }
+    }
+    // Registration fields present on the blueprint but contributing nothing.
+    for (const field of BLUEPRINT_LINTABLE_SURFACE_FIELDS) {
+        if (field in blueprint && !hasEntries(blueprint[field])) {
+            findings.push({
+                code: "empty_surface",
+                severity: "warning",
+                message: `Blueprint field "${field}" is present but empty; remove it or populate it.`,
+                field,
+            });
+        }
+    }
+    if ("hooks" in blueprint) {
+        const hooks = blueprint.hooks ?? {};
+        const registersHook = [hooks.beforeCommand, hooks.afterCommand, hooks.onWrite, hooks.onRead, hooks.onIndex].some(hasEntries);
+        if (!registersHook) {
+            findings.push({
+                code: "empty_surface",
+                severity: "warning",
+                message: `Blueprint field "hooks" is present but registers no lifecycle hooks; remove it or populate it.`,
+                field: "hooks",
+            });
+        }
+    }
+    return {
+        ok: findings.every((finding) => finding.severity !== "error"),
+        findings,
+        used,
+        declared,
+    };
+}
+//# sourceMappingURL=compose.js.map
+//# debugId=3a61717e-bae1-57d3-a1d1-436b1a60deca

package/dist/sdk/compose.js.map

@@ -0,0 +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 {\n  normalizeKnownExtensionCapability,\n  resolveLegacyExtensionCapabilityAlias,\n} from \"../core/extensions/extension-capability-aliases.js\";\nimport { normalizeCommandName } from \"../core/extensions/extension-runtime-helpers.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 in plain\n   * JavaScript packages.\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  /** 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 * 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 → search providers → vector store adapters → importers →\n * 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    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    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 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    // `?? {}` (rather than a `!== undefined` guard) so an untyped JavaScript\n    // author who passes `hooks: null` is treated the same as omitting it,\n    // instead of throwing on the first `hooks.beforeCommand` access.\n    const hooks: ExtensionBlueprintHooks = blueprint.hooks ?? {};\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    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 * 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  [\"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  | \"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 ?? []).some((command) => command.flags !== undefined)) {\n    capabilities.add(\"schema\");\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\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 commandPaths = (blueprint.commands ?? []).map((command) => normalizeCommandName(command.name));\n  const importerPaths = (blueprint.importers ?? []).map((entry) => normalizeCommandName(`${entry.name} import`));\n  const exporterPaths = (blueprint.exporters ?? []).map((entry) => normalizeCommandName(`${entry.name} export`));\n  // A command definition with inline `flags` registers a flag target under its own\n  // path in addition to any top-level `flags` record, so union both sources.\n  const flagCommands = [\n    ...Object.keys(blueprint.flags ?? {}).map((command) => normalizeCommandName(command)),\n    ...(blueprint.commands ?? [])\n      .filter((command) => command.flags !== undefined)\n      .map((command) => normalizeCommandName(command.name)),\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    importers: sortUnique((blueprint.importers ?? []).map((entry) => normalizeCommandName(entry.name))),\n    exporters: sortUnique((blueprint.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  \"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 * 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.\n */\nexport function lintExtensionBlueprint(\n  blueprint: ExtensionBlueprint,\n  options: LintExtensionBlueprintOptions = {},\n): ExtensionBlueprintLintResult {\n  const findings: ExtensionBlueprintLintFinding[] = [];\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  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  } else {\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  }\n\n  // Duplicate command paths within the declared command definitions.\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\n  // A command path declared as both a fresh definition and an override.\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\n  // Registration fields present on the blueprint but contributing nothing.\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\n  return {\n    ok: findings.every((finding) => finding.severity !== \"error\"),\n    findings,\n    used,\n    declared,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"3a61717e-bae1-57d3-a1d1-436b1a60deca"}