@unbrained/pm-cli 2026.6.23 → 2026.6.30

package/dist/sdk/index.d.ts

@@ -9,7 +9,11 @@ export * from "./cli-contracts.js";
 export * from "./compose.js";
 export * from "./define.js";
 export * from "./runtime.js";
-export { assertExtensionBlueprint, assertExtensionCapabilityUsage, assertExtensionDeactivated, assertPackageManifest, assertRegisteredCommandContract, assertRegisteredCommandOverride, assertRegisteredExporter, assertRegisteredFlags, assertRegisteredHook, assertRegisteredImporter, assertRegisteredItemField, assertRegisteredItemType, assertRegisteredMigration, assertRegisteredParserOverride, assertRegisteredPreflightOverride, assertRegisteredRendererOverride, assertRegisteredSearchProvider, assertRegisteredServiceOverride, assertRegisteredVectorStoreAdapter, activateExtensionForTest, createExtensionTestHarness, deactivateExtensionForTest, describeExtensionActivation, runRegisteredCommandForTest, runRegisteredCommandOverrideForTest, runRegisteredExporterForTest, runRegisteredHookForTest, runRegisteredImporterForTest, runRegisteredMigrationForTest, runRegisteredParserOverrideForTest, runRegisteredPreflightOverrideForTest, runRegisteredRendererOverrideForTest, runRegisteredSearchProviderForTest, runRegisteredServiceOverrideForTest, runRegisteredVectorStoreAdapterForTest, type ActivateExtensionForTestOptions, type DeactivateExtensionForTestOptions, type DescribeExtensionActivationOptions, type ExtensionActivationSummary, type RunRegisteredCommandForTestOptions, type RunRegisteredExporterForTestOptions, type RunRegisteredHookForTestOptions, type RunRegisteredImporterForTestOptions, type RunRegisteredMigrationForTestOptions, type RunRegisteredSearchProviderForTestOptions, type RunRegisteredVectorStoreAdapterForTestOptions, type SearchProviderOperationContexts, type SearchProviderOperationResults, type VectorStoreAdapterOperationContexts, type VectorStoreAdapterOperationResults, type ExtensionCapabilityUsageAssertion, type ExtensionCapabilityUsageExpectation, type ExtensionDeactivationExpectation, type ExtensionTestHarness, type PackageManifestExpectation, type PackageManifestResourceExpectation, type RegisteredCommandContractAssertion, type RegisteredCommandContractExpectation, type RegisteredCommandOverrideExpectation, type RegisteredExporterExpectation, type RegisteredFlagsExpectation, type RegisteredHookExpectation, type RegisteredHookKind, type RegisteredImporterExpectation, type RegisteredItemFieldAssertion, type RegisteredItemFieldExpectation, type RegisteredItemTypeAssertion, type RegisteredItemTypeExpectation, type RegisteredMigrationExpectation, type RegisteredParserOverrideExpectation, type RegisteredPreflightOverrideExpectation, type RegisteredRendererOverrideExpectation, type RegisteredSearchProviderExpectation, type RegisteredServiceOverrideExpectation, type RegisteredVectorStoreAdapterExpectation, } from "./testing.js";
+export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, type ProfileConfigEntry, type ProfileName, type ProfilePackageRecommendation, type ProfileTemplateEntry, type ProfileTemplateOptions, type ProjectProfileDefinition, type ProjectProfileRegistrationInput, } from "../core/profile/profile-presets.js";
+export { planProfileApplication, type ProfileApplicationPlan, type ProfileChangeStatus, type ProfileComponentChange, type ProfileConfigChange, type ProfileConfigPlan, type ProfileCurrentState, type ProfilePackagePlan, type ProfileSchemaPlan, type ProfileTemplateChange, type ProfileTemplatePlan, type ProfileWorkflowChange, type ProfileWorkflowPlan, } from "../core/profile/profile-plan.js";
+export { describeProfileComposition, describeProjectProfile, type ProjectProfileComposition, type ProjectProfileDescription, type ProjectProfilePackageSummary, } from "../core/profile/profile-describe.js";
+export { lintProjectProfile, PROFILE_LINT_CODES, PROFILE_LINT_DIMENSIONS, type ProfileLintCode, type ProfileLintDimension, type ProfileLintSeverity, type ProjectProfileLintFinding, type ProjectProfileLintReport, } from "../core/profile/profile-lint.js";
+export { assertExtensionBlueprint, assertExtensionCapabilityUsage, assertExtensionDeactivated, assertExtensionManifestCompatible, assertExtensionManifestMatchesBlueprint, assertExtensionPreflight, assertPackageManifest, assertProjectProfile, assertRegisteredCommandContract, assertRegisteredCommandOverride, assertRegisteredExporter, assertRegisteredFlags, assertRegisteredHook, assertRegisteredImporter, assertRegisteredItemField, assertRegisteredItemType, assertRegisteredMigration, assertRegisteredParserOverride, assertRegisteredPreflightOverride, assertRegisteredProfile, assertRegisteredRendererOverride, assertRegisteredSearchProvider, assertRegisteredServiceOverride, assertRegisteredVectorStoreAdapter, activateExtensionForTest, createExtensionTestHarness, deactivateExtensionForTest, describeExtensionActivation, runRegisteredCommandForTest, runRegisteredCommandOverrideForTest, runRegisteredExporterForTest, runRegisteredHookForTest, runRegisteredImporterForTest, runRegisteredMigrationForTest, runRegisteredParserOverrideForTest, runRegisteredPreflightOverrideForTest, runRegisteredRendererOverrideForTest, runRegisteredSearchProviderForTest, runRegisteredServiceOverrideForTest, runRegisteredVectorStoreAdapterForTest, type ActivateExtensionForTestOptions, type AssertProjectProfileOptions, type DeactivateExtensionForTestOptions, type DescribeExtensionActivationOptions, type ExtensionActivationSummary, type RenderExtensionHarnessMarkdownOptions, type RunRegisteredCommandForTestOptions, type RunRegisteredExporterForTestOptions, type RunRegisteredHookForTestOptions, type RunRegisteredImporterForTestOptions, type RunRegisteredMigrationForTestOptions, type RunRegisteredSearchProviderForTestOptions, type RunRegisteredVectorStoreAdapterForTestOptions, type SearchProviderOperationContexts, type SearchProviderOperationResults, type VectorStoreAdapterOperationContexts, type VectorStoreAdapterOperationResults, type ExtensionCapabilityUsageAssertion, type ExtensionCapabilityUsageExpectation, type ExtensionDeactivationExpectation, type ExtensionManifestBlueprintMatch, type ExtensionTestHarness, type PackageManifestExpectation, type PackageManifestResourceExpectation, type RegisteredCommandContractAssertion, type RegisteredCommandContractExpectation, type RegisteredCommandOverrideExpectation, type RegisteredExporterExpectation, type RegisteredFlagsExpectation, type RegisteredHookExpectation, type RegisteredHookKind, type RegisteredImporterExpectation, type RegisteredItemFieldAssertion, type RegisteredItemFieldExpectation, type RegisteredItemTypeAssertion, type RegisteredItemTypeExpectation, type RegisteredMigrationExpectation, type RegisteredParserOverrideExpectation, type RegisteredPreflightOverrideExpectation, type RegisteredProfileAssertion, type RegisteredProfileExpectation, type RegisteredRendererOverrideExpectation, type RegisteredSearchProviderExpectation, type RegisteredServiceOverrideExpectation, type RegisteredVectorStoreAdapterExpectation, } from "./testing.js";
 /**
  * Canonical extension capability names accepted by pm.
  *
@@ -25,7 +29,7 @@ export type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];
  * Canonical extension governance policy modes and registration surfaces.
  */
 export declare const EXTENSION_POLICY_MODES: readonly ["off", "warn", "enforce"];
-export declare const EXTENSION_POLICY_SURFACES: readonly ["commands.override", "commands.handler", "hooks.beforecommand", "hooks.aftercommand", "hooks.onwrite", "hooks.onread", "hooks.onindex", "schema.flags", "schema.itemfields", "schema.itemtypes", "schema.migrations", "parser.override", "preflight.override", "services.override", "renderers.override", "importers.importer", "importers.exporter", "search.provider", "search.vectorstore"];
+export declare const EXTENSION_POLICY_SURFACES: readonly ["commands.override", "commands.handler", "hooks.beforecommand", "hooks.aftercommand", "hooks.onwrite", "hooks.onread", "hooks.onindex", "schema.flags", "schema.itemfields", "schema.itemtypes", "schema.migrations", "schema.profiles", "parser.override", "preflight.override", "services.override", "renderers.override", "importers.importer", "importers.exporter", "search.provider", "search.vectorstore"];
 export declare const EXTENSION_TRUST_MODES: readonly ["off", "warn", "enforce"];
 export declare const EXTENSION_SANDBOX_PROFILES: readonly ["none", "restricted", "strict"];
 /**
@@ -53,6 +57,13 @@ export { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, E
  * against the registration surfaces a package actually exercises at activation.
  */
 export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, type CollectUsedExtensionCapabilitiesOptions, type ExtensionCapabilityUsageReconciliation, } from "../core/extensions/capability-usage.js";
-export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, CommandDefinition, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandHandlerResult, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExtensionFlagDefinitions, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";
+/**
+ * Render an extension/package activation summary
+ * ({@link describeExtensionActivation} / {@link describeExtensionBlueprint}) to a
+ * deterministic Markdown reference document — the author-facing *render* leg of
+ * the describe verb, for drift-free package READMEs.
+ */
+export { renderExtensionSurfaceMarkdown, type ExtensionSurfaceMarkdownOptions, } from "../core/extensions/activation-summary-markdown.js";
+export type { AfterCommandAffectedItem, AfterCommandHook, AfterCommandHookContext, BeforeCommandHook, BeforeCommandHookContext, CommandDefinition, ExtensionCommandArgumentDefinition, CommandHandler, CommandHandlerContext, CommandHandlerResult, CommandOverride, CommandOverrideContext, ExtensionServiceName, Exporter, ExtensionActivationResult, ExtensionApi, ExtensionCommandRegistry, ExtensionDeactivationFailure, ExtensionDeactivationOptions, ExtensionDeactivationResult, ExtensionDiagnostic, ExtensionDiscoveryResult, ExtensionHookRegistry, ExtensionSelfIdentity, ExtensionLoadResult, ExtensionManifest, ExtensionManifestEngines, ExtensionGovernancePolicy, ExtensionPolicyOverride, ExtensionProvenanceMetadata, ExtensionRuntimePermissionDeclaration, ExtensionSearchMode, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry, FlagValueType, FlagDefinition, ImportExportContext, ImportExportRegistrationOptions, Importer, OnIndexHook, OnIndexHookContext, OnReadHook, OnReadHookContext, OnWriteHook, OnWriteHookContext, OutputRendererFormat, ParserOverride, ParserOverrideContext, ParserOverrideDelta, PreflightOverride, PreflightOverrideContext, PreflightOverrideDelta, PreflightRuntimeDecision, RegisteredExtensionExporter, RegisteredExtensionFlagDefinitions, RegisteredExtensionHook, RegisteredExtensionImporter, RegisteredExtensionProjectProfile, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverride, RendererOverrideContext, SchemaFieldDefinition, SchemaItemTypeCommandOptionPolicyDefinition, SchemaItemTypeOptionDefinition, SchemaItemTypeDefinition, SchemaMigrationDefinition, SchemaMigrationRunContext, SchemaMigrationRunner, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderDefinition, SearchProviderHit, SearchProviderQueryContext, SearchProviderQueryResult, ServiceOverride, ServiceOverrideContext, VectorStoreAdapterDefinition, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext, VectorStoreUpsertPoint, } from "../core/extensions/loader.js";
 export type { GlobalOptions } from "../core/shared/command-types.js";
 export type { ItemDocument, ItemFrontMatter, ItemStatus, ItemType, PmSettings } from "../types/index.js";

package/dist/sdk/index.js

@@ -4,14 +4,18 @@
  * Defines public SDK APIs and package-author helpers for Index.
  */
 
-!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]="bb3af4f6-1563-5e20-88fb-55056d59a077")}catch(e){}}();
+!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]="6e3eda5f-05b5-5c8a-931f-491b534f4613")}catch(e){}}();
 import { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES, KNOWN_EXTENSION_CAPABILITIES, KNOWN_EXTENSION_POLICY_MODES, KNOWN_EXTENSION_POLICY_SURFACES, KNOWN_EXTENSION_SANDBOX_PROFILES, KNOWN_EXTENSION_TRUST_MODES, } from "../core/extensions/loader.js";
 export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS, PM_PACKAGE_RESOURCE_KINDS, collectPackageExtensionDirectories, readPmPackageManifest, } from "../core/packages/manifest.js";
 export * from "./cli-contracts.js";
 export * from "./compose.js";
 export * from "./define.js";
 export * from "./runtime.js";
-export { assertExtensionBlueprint, assertExtensionCapabilityUsage, assertExtensionDeactivated, assertPackageManifest, assertRegisteredCommandContract, assertRegisteredCommandOverride, assertRegisteredExporter, assertRegisteredFlags, assertRegisteredHook, assertRegisteredImporter, assertRegisteredItemField, assertRegisteredItemType, assertRegisteredMigration, assertRegisteredParserOverride, assertRegisteredPreflightOverride, assertRegisteredRendererOverride, assertRegisteredSearchProvider, assertRegisteredServiceOverride, assertRegisteredVectorStoreAdapter, activateExtensionForTest, createExtensionTestHarness, deactivateExtensionForTest, describeExtensionActivation, runRegisteredCommandForTest, runRegisteredCommandOverrideForTest, runRegisteredExporterForTest, runRegisteredHookForTest, runRegisteredImporterForTest, runRegisteredMigrationForTest, runRegisteredParserOverrideForTest, runRegisteredPreflightOverrideForTest, runRegisteredRendererOverrideForTest, runRegisteredSearchProviderForTest, runRegisteredServiceOverrideForTest, runRegisteredVectorStoreAdapterForTest, } from "./testing.js";
+export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, } from "../core/profile/profile-presets.js";
+export { planProfileApplication, } from "../core/profile/profile-plan.js";
+export { describeProfileComposition, describeProjectProfile, } from "../core/profile/profile-describe.js";
+export { lintProjectProfile, PROFILE_LINT_CODES, PROFILE_LINT_DIMENSIONS, } from "../core/profile/profile-lint.js";
+export { assertExtensionBlueprint, assertExtensionCapabilityUsage, assertExtensionDeactivated, assertExtensionManifestCompatible, assertExtensionManifestMatchesBlueprint, assertExtensionPreflight, assertPackageManifest, assertProjectProfile, assertRegisteredCommandContract, assertRegisteredCommandOverride, assertRegisteredExporter, assertRegisteredFlags, assertRegisteredHook, assertRegisteredImporter, assertRegisteredItemField, assertRegisteredItemType, assertRegisteredMigration, assertRegisteredParserOverride, assertRegisteredPreflightOverride, assertRegisteredProfile, assertRegisteredRendererOverride, assertRegisteredSearchProvider, assertRegisteredServiceOverride, assertRegisteredVectorStoreAdapter, activateExtensionForTest, createExtensionTestHarness, deactivateExtensionForTest, describeExtensionActivation, runRegisteredCommandForTest, runRegisteredCommandOverrideForTest, runRegisteredExporterForTest, runRegisteredHookForTest, runRegisteredImporterForTest, runRegisteredMigrationForTest, runRegisteredParserOverrideForTest, runRegisteredPreflightOverrideForTest, runRegisteredRendererOverrideForTest, runRegisteredSearchProviderForTest, runRegisteredServiceOverrideForTest, runRegisteredVectorStoreAdapterForTest, } from "./testing.js";
 /**
  * Canonical extension capability names accepted by pm.
  *
@@ -35,5 +39,12 @@ export { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, E
  * against the registration surfaces a package actually exercises at activation.
  */
 export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, } from "../core/extensions/capability-usage.js";
+/**
+ * Render an extension/package activation summary
+ * ({@link describeExtensionActivation} / {@link describeExtensionBlueprint}) to a
+ * deterministic Markdown reference document — the author-facing *render* leg of
+ * the describe verb, for drift-free package READMEs.
+ */
+export { renderExtensionSurfaceMarkdown, } from "../core/extensions/activation-summary-markdown.js";
 //# sourceMappingURL=index.js.map
-//# debugId=bb3af4f6-1563-5e20-88fb-55056d59a077
+//# debugId=6e3eda5f-05b5-5c8a-931f-491b534f4613

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/index\n *\n * Defines public SDK APIs and package-author helpers for Index.\n */\nimport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_TRUST_MODES,\n} from \"../core/extensions/loader.js\";\nexport {\n  PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,\n  PM_PACKAGE_RESOURCE_KINDS,\n  collectPackageExtensionDirectories,\n  readPmPackageManifest,\n  type PmPackageCatalogLinkMap,\n  type PmPackageCatalogMediaMap,\n  type PmPackageCatalogMetadata,\n  type PmPackageManifest,\n  type PmPackageResourceKind,\n  type PmPackageResourceMap,\n} from \"../core/packages/manifest.js\";\nexport * from \"./cli-contracts.js\";\nexport * from \"./compose.js\";\nexport * from \"./define.js\";\nexport * from \"./runtime.js\";\nexport {\n  assertExtensionBlueprint,\n  assertExtensionCapabilityUsage,\n  assertExtensionDeactivated,\n  assertPackageManifest,\n  assertRegisteredCommandContract,\n  assertRegisteredCommandOverride,\n  assertRegisteredExporter,\n  assertRegisteredFlags,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredMigration,\n  assertRegisteredParserOverride,\n  assertRegisteredPreflightOverride,\n  assertRegisteredRendererOverride,\n  assertRegisteredSearchProvider,\n  assertRegisteredServiceOverride,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  createExtensionTestHarness,\n  deactivateExtensionForTest,\n  describeExtensionActivation,\n  runRegisteredCommandForTest,\n  runRegisteredCommandOverrideForTest,\n  runRegisteredExporterForTest,\n  runRegisteredHookForTest,\n  runRegisteredImporterForTest,\n  runRegisteredMigrationForTest,\n  runRegisteredParserOverrideForTest,\n  runRegisteredPreflightOverrideForTest,\n  runRegisteredRendererOverrideForTest,\n  runRegisteredSearchProviderForTest,\n  runRegisteredServiceOverrideForTest,\n  runRegisteredVectorStoreAdapterForTest,\n  type ActivateExtensionForTestOptions,\n  type DeactivateExtensionForTestOptions,\n  type DescribeExtensionActivationOptions,\n  type ExtensionActivationSummary,\n  type RunRegisteredCommandForTestOptions,\n  type RunRegisteredExporterForTestOptions,\n  type RunRegisteredHookForTestOptions,\n  type RunRegisteredImporterForTestOptions,\n  type RunRegisteredMigrationForTestOptions,\n  type RunRegisteredSearchProviderForTestOptions,\n  type RunRegisteredVectorStoreAdapterForTestOptions,\n  type SearchProviderOperationContexts,\n  type SearchProviderOperationResults,\n  type VectorStoreAdapterOperationContexts,\n  type VectorStoreAdapterOperationResults,\n  type ExtensionCapabilityUsageAssertion,\n  type ExtensionCapabilityUsageExpectation,\n  type ExtensionDeactivationExpectation,\n  type ExtensionTestHarness,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredCommandOverrideExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredFlagsExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredMigrationExpectation,\n  type RegisteredParserOverrideExpectation,\n  type RegisteredPreflightOverrideExpectation,\n  type RegisteredRendererOverrideExpectation,\n  type RegisteredSearchProviderExpectation,\n  type RegisteredServiceOverrideExpectation,\n  type RegisteredVectorStoreAdapterExpectation,\n} from \"./testing.js\";\n\n/**\n * Canonical extension capability names accepted by pm.\n *\n * Extension manifests should declare one or more of these values in\n * `capabilities`.\n */\nexport const EXTENSION_CAPABILITIES = KNOWN_EXTENSION_CAPABILITIES;\n/**\n * Restricts extension capability values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/**\n * Canonical extension governance policy modes and registration surfaces.\n */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\n/**\n * Restricts extension policy mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\n/**\n * Restricts extension policy surface values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\n/**\n * Restricts extension trust mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\n/**\n * Restricts extension sandbox profile values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionSandboxProfile = (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/**\n * Versioned capability contract metadata emitted by runtime diagnostics.\n */\nexport { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES };\n\n/**\n * Least-privilege capability reconciliation helpers: map declared capabilities\n * against the registration surfaces a package actually exercises at activation.\n */\nexport {\n  EXTENSION_CAPABILITY_REGISTRATION_SURFACES,\n  collectUsedExtensionCapabilities,\n  reconcileExtensionCapabilityUsage,\n  type CollectUsedExtensionCapabilitiesOptions,\n  type ExtensionCapabilityUsageReconciliation,\n} from \"../core/extensions/capability-usage.js\";\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandHandlerResult,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationFailure,\n  ExtensionDeactivationOptions,\n  ExtensionDeactivationResult,\n  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionHookRegistry,\n  ExtensionSelfIdentity,\n  ExtensionLoadResult,\n  ExtensionManifest,\n  ExtensionManifestEngines,\n  ExtensionGovernancePolicy,\n  ExtensionPolicyOverride,\n  ExtensionProvenanceMetadata,\n  ExtensionRuntimePermissionDeclaration,\n  ExtensionSearchMode,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  ExtensionServiceRegistry,\n  FlagValueType,\n  FlagDefinition,\n  ImportExportContext,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnIndexHookContext,\n  OnReadHook,\n  OnReadHookContext,\n  OnWriteHook,\n  OnWriteHookContext,\n  OutputRendererFormat,\n  ParserOverride,\n  ParserOverrideContext,\n  ParserOverrideDelta,\n  PreflightOverride,\n  PreflightOverrideContext,\n  PreflightOverrideDelta,\n  PreflightRuntimeDecision,\n  RegisteredExtensionExporter,\n  RegisteredExtensionFlagDefinitions,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionSchemaMigrationDefinition,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionServiceOverride,\n  RegisteredExtensionVectorStoreAdapter,\n  RendererOverride,\n  RendererOverrideContext,\n  SchemaFieldDefinition,\n  SchemaItemTypeCommandOptionPolicyDefinition,\n  SchemaItemTypeOptionDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SchemaMigrationRunContext,\n  SchemaMigrationRunner,\n  SearchProviderEmbedBatchContext,\n  SearchProviderEmbedContext,\n  SearchProviderDefinition,\n  SearchProviderHit,\n  SearchProviderQueryContext,\n  SearchProviderQueryResult,\n  ServiceOverride,\n  ServiceOverrideContext,\n  VectorStoreAdapterDefinition,\n  VectorStoreDeleteContext,\n  VectorStoreQueryContext,\n  VectorStoreQueryHit,\n  VectorStoreUpsertContext,\n  VectorStoreUpsertPoint,\n} from \"../core/extensions/loader.js\";\n\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type { ItemDocument, ItemFrontMatter, ItemStatus, ItemType, PmSettings } from \"../types/index.js\";\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EACL,6BAA6B,EAC7B,qCAAqC,EACrC,mCAAmC,EACnC,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,sCAAsC,EACtC,yBAAyB,EACzB,kCAAkC,EAClC,qBAAqB,GAOtB,MAAM,8BAA8B,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,0BAA0B,EAC1B,qBAAqB,EACrB,+BAA+B,EAC/B,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,mCAAmC,EACnC,4BAA4B,EAC5B,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,EAC7B,kCAAkC,EAClC,qCAAqC,EACrC,oCAAoC,EACpC,kCAAkC,EAClC,mCAAmC,EACnC,sCAAsC,GAyCvC,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAMnE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AACjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAkB3E;;GAEG;AACH,OAAO,EAAE,6BAA6B,EAAE,qCAAqC,EAAE,mCAAmC,EAAE,CAAC;AAErH;;;GAGG;AACH,OAAO,EACL,0CAA0C,EAC1C,gCAAgC,EAChC,iCAAiC,GAGlC,MAAM,wCAAwC,CAAC","debugId":"bb3af4f6-1563-5e20-88fb-55056d59a077"}
+{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/index\n *\n * Defines public SDK APIs and package-author helpers for Index.\n */\nimport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_TRUST_MODES,\n} from \"../core/extensions/loader.js\";\nexport {\n  PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,\n  PM_PACKAGE_RESOURCE_KINDS,\n  collectPackageExtensionDirectories,\n  readPmPackageManifest,\n  type PmPackageCatalogLinkMap,\n  type PmPackageCatalogMediaMap,\n  type PmPackageCatalogMetadata,\n  type PmPackageManifest,\n  type PmPackageResourceKind,\n  type PmPackageResourceMap,\n} from \"../core/packages/manifest.js\";\nexport * from \"./cli-contracts.js\";\nexport * from \"./compose.js\";\nexport * from \"./define.js\";\nexport * from \"./runtime.js\";\nexport {\n  BUILTIN_PROFILES,\n  listProfiles,\n  normalizeProfileName,\n  PROFILE_NAMES,\n  resolveProfile,\n  type ProfileConfigEntry,\n  type ProfileName,\n  type ProfilePackageRecommendation,\n  type ProfileTemplateEntry,\n  type ProfileTemplateOptions,\n  type ProjectProfileDefinition,\n  type ProjectProfileRegistrationInput,\n} from \"../core/profile/profile-presets.js\";\nexport {\n  planProfileApplication,\n  type ProfileApplicationPlan,\n  type ProfileChangeStatus,\n  type ProfileComponentChange,\n  type ProfileConfigChange,\n  type ProfileConfigPlan,\n  type ProfileCurrentState,\n  type ProfilePackagePlan,\n  type ProfileSchemaPlan,\n  type ProfileTemplateChange,\n  type ProfileTemplatePlan,\n  type ProfileWorkflowChange,\n  type ProfileWorkflowPlan,\n} from \"../core/profile/profile-plan.js\";\nexport {\n  describeProfileComposition,\n  describeProjectProfile,\n  type ProjectProfileComposition,\n  type ProjectProfileDescription,\n  type ProjectProfilePackageSummary,\n} from \"../core/profile/profile-describe.js\";\nexport {\n  lintProjectProfile,\n  PROFILE_LINT_CODES,\n  PROFILE_LINT_DIMENSIONS,\n  type ProfileLintCode,\n  type ProfileLintDimension,\n  type ProfileLintSeverity,\n  type ProjectProfileLintFinding,\n  type ProjectProfileLintReport,\n} from \"../core/profile/profile-lint.js\";\nexport {\n  assertExtensionBlueprint,\n  assertExtensionCapabilityUsage,\n  assertExtensionDeactivated,\n  assertExtensionManifestCompatible,\n  assertExtensionManifestMatchesBlueprint,\n  assertExtensionPreflight,\n  assertPackageManifest,\n  assertProjectProfile,\n  assertRegisteredCommandContract,\n  assertRegisteredCommandOverride,\n  assertRegisteredExporter,\n  assertRegisteredFlags,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredMigration,\n  assertRegisteredParserOverride,\n  assertRegisteredPreflightOverride,\n  assertRegisteredProfile,\n  assertRegisteredRendererOverride,\n  assertRegisteredSearchProvider,\n  assertRegisteredServiceOverride,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  createExtensionTestHarness,\n  deactivateExtensionForTest,\n  describeExtensionActivation,\n  runRegisteredCommandForTest,\n  runRegisteredCommandOverrideForTest,\n  runRegisteredExporterForTest,\n  runRegisteredHookForTest,\n  runRegisteredImporterForTest,\n  runRegisteredMigrationForTest,\n  runRegisteredParserOverrideForTest,\n  runRegisteredPreflightOverrideForTest,\n  runRegisteredRendererOverrideForTest,\n  runRegisteredSearchProviderForTest,\n  runRegisteredServiceOverrideForTest,\n  runRegisteredVectorStoreAdapterForTest,\n  type ActivateExtensionForTestOptions,\n  type AssertProjectProfileOptions,\n  type DeactivateExtensionForTestOptions,\n  type DescribeExtensionActivationOptions,\n  type ExtensionActivationSummary,\n  type RenderExtensionHarnessMarkdownOptions,\n  type RunRegisteredCommandForTestOptions,\n  type RunRegisteredExporterForTestOptions,\n  type RunRegisteredHookForTestOptions,\n  type RunRegisteredImporterForTestOptions,\n  type RunRegisteredMigrationForTestOptions,\n  type RunRegisteredSearchProviderForTestOptions,\n  type RunRegisteredVectorStoreAdapterForTestOptions,\n  type SearchProviderOperationContexts,\n  type SearchProviderOperationResults,\n  type VectorStoreAdapterOperationContexts,\n  type VectorStoreAdapterOperationResults,\n  type ExtensionCapabilityUsageAssertion,\n  type ExtensionCapabilityUsageExpectation,\n  type ExtensionDeactivationExpectation,\n  type ExtensionManifestBlueprintMatch,\n  type ExtensionTestHarness,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredCommandOverrideExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredFlagsExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredMigrationExpectation,\n  type RegisteredParserOverrideExpectation,\n  type RegisteredPreflightOverrideExpectation,\n  type RegisteredProfileAssertion,\n  type RegisteredProfileExpectation,\n  type RegisteredRendererOverrideExpectation,\n  type RegisteredSearchProviderExpectation,\n  type RegisteredServiceOverrideExpectation,\n  type RegisteredVectorStoreAdapterExpectation,\n} from \"./testing.js\";\n\n/**\n * Canonical extension capability names accepted by pm.\n *\n * Extension manifests should declare one or more of these values in\n * `capabilities`.\n */\nexport const EXTENSION_CAPABILITIES = KNOWN_EXTENSION_CAPABILITIES;\n/**\n * Restricts extension capability values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/**\n * Canonical extension governance policy modes and registration surfaces.\n */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\n/**\n * Restricts extension policy mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\n/**\n * Restricts extension policy surface values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\n/**\n * Restricts extension trust mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\n/**\n * Restricts extension sandbox profile values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionSandboxProfile = (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/**\n * Versioned capability contract metadata emitted by runtime diagnostics.\n */\nexport { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES };\n\n/**\n * Least-privilege capability reconciliation helpers: map declared capabilities\n * against the registration surfaces a package actually exercises at activation.\n */\nexport {\n  EXTENSION_CAPABILITY_REGISTRATION_SURFACES,\n  collectUsedExtensionCapabilities,\n  reconcileExtensionCapabilityUsage,\n  type CollectUsedExtensionCapabilitiesOptions,\n  type ExtensionCapabilityUsageReconciliation,\n} from \"../core/extensions/capability-usage.js\";\n\n/**\n * Render an extension/package activation summary\n * ({@link describeExtensionActivation} / {@link describeExtensionBlueprint}) to a\n * deterministic Markdown reference document — the author-facing *render* leg of\n * the describe verb, for drift-free package READMEs.\n */\nexport {\n  renderExtensionSurfaceMarkdown,\n  type ExtensionSurfaceMarkdownOptions,\n} from \"../core/extensions/activation-summary-markdown.js\";\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandHandlerResult,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationFailure,\n  ExtensionDeactivationOptions,\n  ExtensionDeactivationResult,\n  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionHookRegistry,\n  ExtensionSelfIdentity,\n  ExtensionLoadResult,\n  ExtensionManifest,\n  ExtensionManifestEngines,\n  ExtensionGovernancePolicy,\n  ExtensionPolicyOverride,\n  ExtensionProvenanceMetadata,\n  ExtensionRuntimePermissionDeclaration,\n  ExtensionSearchMode,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  ExtensionServiceRegistry,\n  FlagValueType,\n  FlagDefinition,\n  ImportExportContext,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnIndexHookContext,\n  OnReadHook,\n  OnReadHookContext,\n  OnWriteHook,\n  OnWriteHookContext,\n  OutputRendererFormat,\n  ParserOverride,\n  ParserOverrideContext,\n  ParserOverrideDelta,\n  PreflightOverride,\n  PreflightOverrideContext,\n  PreflightOverrideDelta,\n  PreflightRuntimeDecision,\n  RegisteredExtensionExporter,\n  RegisteredExtensionFlagDefinitions,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionProjectProfile,\n  RegisteredExtensionSchemaMigrationDefinition,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionServiceOverride,\n  RegisteredExtensionVectorStoreAdapter,\n  RendererOverride,\n  RendererOverrideContext,\n  SchemaFieldDefinition,\n  SchemaItemTypeCommandOptionPolicyDefinition,\n  SchemaItemTypeOptionDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SchemaMigrationRunContext,\n  SchemaMigrationRunner,\n  SearchProviderEmbedBatchContext,\n  SearchProviderEmbedContext,\n  SearchProviderDefinition,\n  SearchProviderHit,\n  SearchProviderQueryContext,\n  SearchProviderQueryResult,\n  ServiceOverride,\n  ServiceOverrideContext,\n  VectorStoreAdapterDefinition,\n  VectorStoreDeleteContext,\n  VectorStoreQueryContext,\n  VectorStoreQueryHit,\n  VectorStoreUpsertContext,\n  VectorStoreUpsertPoint,\n} from \"../core/extensions/loader.js\";\n\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type { ItemDocument, ItemFrontMatter, ItemStatus, ItemType, PmSettings } from \"../types/index.js\";\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EACL,6BAA6B,EAC7B,qCAAqC,EACrC,mCAAmC,EACnC,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,sCAAsC,EACtC,yBAAyB,EACzB,kCAAkC,EAClC,qBAAqB,GAOtB,MAAM,8BAA8B,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,cAAc,GAQf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,sBAAsB,GAavB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GAIvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GAMxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,0BAA0B,EAC1B,iCAAiC,EACjC,uCAAuC,EACvC,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,+BAA+B,EAC/B,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC9B,iCAAiC,EACjC,uBAAuB,EACvB,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,mCAAmC,EACnC,4BAA4B,EAC5B,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,EAC7B,kCAAkC,EAClC,qCAAqC,EACrC,oCAAoC,EACpC,kCAAkC,EAClC,mCAAmC,EACnC,sCAAsC,GA8CvC,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAMnE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AACnE,MAAM,CAAC,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AACzE,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AACjE,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAkB3E;;GAEG;AACH,OAAO,EAAE,6BAA6B,EAAE,qCAAqC,EAAE,mCAAmC,EAAE,CAAC;AAErH;;;GAGG;AACH,OAAO,EACL,0CAA0C,EAC1C,gCAAgC,EAChC,iCAAiC,GAGlC,MAAM,wCAAwC,CAAC;AAEhD;;;;;GAKG;AACH,OAAO,EACL,8BAA8B,GAE/B,MAAM,mDAAmD,CAAC","debugId":"6e3eda5f-05b5-5c8a-931f-491b534f4613"}

package/dist/sdk/testing.d.ts

@@ -3,12 +3,20 @@
  *
  * Defines public SDK APIs and package-author helpers for Testing.
  */
-import type { AfterCommandHookContext, BeforeCommandHookContext, CommandHandlerResult, CommandOverrideContext, CommandOverrideResult, ExtensionActivationResult, ExtensionCapability, ExtensionCommandRegistry, ExtensionDeactivationResult, ExtensionGovernancePolicy, ExtensionHookRegistry, ExtensionLayer, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceName, ExtensionServiceRegistry, FlagDefinition, OnIndexHookContext, OnReadHookContext, OnWriteHookContext, OutputRendererFormat, ParserOverrideContext, ParserOverrideResult, PreflightOverrideContext, PreflightOverrideResult, RegisteredExtensionCommandDefinition, RegisteredExtensionCommandOverride, RegisteredExtensionExporter, RegisteredExtensionFlagDefinitions, RegisteredExtensionImporter, RegisteredExtensionParserOverride, RegisteredExtensionPreflightOverride, RegisteredExtensionRendererOverride, RegisteredExtensionSchemaFieldDefinitions, RegisteredExtensionSchemaItemTypeDefinitions, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverrideContext, RendererOverrideResult, SchemaFieldDefinition, SchemaItemTypeDefinition, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderQueryContext, SearchProviderQueryExpansionContext, SearchProviderQueryExpansionResult, SearchProviderQueryResult, SearchProviderRerankContext, SearchProviderRerankResult, ServiceOverrideContext, ServiceOverrideResult, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext } from "../core/extensions/loader.js";
+import type { AfterCommandHookContext, BeforeCommandHookContext, CommandHandlerResult, CommandOverrideContext, CommandOverrideResult, ExtensionActivationResult, ExtensionCapability, ExtensionCommandRegistry, ExtensionDeactivationResult, ExtensionGovernancePolicy, ExtensionHookRegistry, ExtensionLayer, ExtensionManifest, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceName, ExtensionServiceRegistry, FlagDefinition, OnIndexHookContext, OnReadHookContext, OnWriteHookContext, OutputRendererFormat, ParserOverrideContext, ParserOverrideResult, PreflightOverrideContext, PreflightOverrideResult, RegisteredExtensionCommandDefinition, RegisteredExtensionCommandOverride, RegisteredExtensionExporter, RegisteredExtensionFlagDefinitions, RegisteredExtensionImporter, RegisteredExtensionParserOverride, RegisteredExtensionPreflightOverride, RegisteredExtensionProjectProfile, RegisteredExtensionRendererOverride, RegisteredExtensionSchemaFieldDefinitions, RegisteredExtensionSchemaItemTypeDefinitions, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverrideContext, RendererOverrideResult, SchemaFieldDefinition, SchemaItemTypeDefinition, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderQueryContext, SearchProviderQueryExpansionContext, SearchProviderQueryExpansionResult, SearchProviderQueryResult, SearchProviderRerankContext, SearchProviderRerankResult, ServiceOverrideContext, ServiceOverrideResult, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext } from "../core/extensions/loader.js";
 import { describeExtensionBlueprint, lintExtensionBlueprint } from "./compose.js";
-import type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, LintExtensionBlueprintOptions } from "./compose.js";
+import { describeExtensionActivation } from "../core/extensions/activation-summary.js";
+import type { DescribeExtensionActivationOptions, ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
+import type { ProjectProfileDefinition } from "../core/profile/profile-presets.js";
+import { type ProjectProfileLintReport } from "../core/profile/profile-lint.js";
+import { renderExtensionSurfaceMarkdown } from "../core/extensions/activation-summary-markdown.js";
+import type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activation-summary-markdown.js";
+import type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, ExtensionManifestCompatibilityManifest, ExtensionManifestCompatibilityResult, ExtensionManifestCompatibilityTarget, ExtensionPreflightReport, LintExtensionBlueprintOptions, PreflightExtensionOptions } from "./compose.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
 import type { PmPackageManifest, PmPackageResourceKind } from "../core/packages/manifest.js";
-export { describeExtensionActivation, type DescribeExtensionActivationOptions, type ExtensionActivationSummary, } from "../core/extensions/activation-summary.js";
+export { describeExtensionActivation, renderExtensionSurfaceMarkdown, };
+export type { DescribeExtensionActivationOptions, ExtensionActivationSummary, } from "../core/extensions/activation-summary.js";
+export type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activation-summary-markdown.js";
 export { describeExtensionBlueprint, lintExtensionBlueprint };
 export type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, LintExtensionBlueprintOptions, };
 /**
@@ -386,6 +394,24 @@ export interface RegisteredMigrationExpectation {
     extensionName?: string;
     mandatory?: boolean;
 }
+/**
+ * Documents the registered project-profile expectation payload exchanged by command, SDK, and package integrations.
+ */
+export interface RegisteredProfileExpectation {
+    /** Profile name to assert is registered (case-insensitive). */
+    profile: string;
+    /** Restrict the match to a single extension when several are active. */
+    extensionName?: string;
+}
+/**
+ * Documents the registered project-profile assertion payload exchanged by command, SDK, and package integrations.
+ */
+export interface RegisteredProfileAssertion {
+    /** The matching registration entry. */
+    registration: RegisteredExtensionProjectProfile;
+    /** The registered profile definition. */
+    profile: ProjectProfileDefinition;
+}
 /**
  * Documents the extension capability usage expectation payload exchanged by command, SDK, and package integrations.
  */
@@ -427,6 +453,16 @@ export interface PackageManifestExpectation {
     aliases?: readonly string[];
     resources?: PackageManifestResourceExpectation;
 }
+/**
+ * Options for {@link ExtensionTestHarness.renderMarkdown}.
+ */
+export interface RenderExtensionHarnessMarkdownOptions extends ExtensionSurfaceMarkdownOptions {
+    /**
+     * Restrict the rendered summary to one activated extension by name. Defaults
+     * to the full activation union, matching {@link ExtensionTestHarness.activationSummary}.
+     */
+    extensionName?: string;
+}
 /**
  * Activate one in-memory extension module for package tests.
  *
@@ -738,6 +774,19 @@ export declare function assertRegisteredItemField(registrations: ExtensionRegist
  * item type definition (optionally scoped to a specific extension).
  */
 export declare function assertRegisteredItemType(registrations: ExtensionRegistrationRegistry, expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
+/**
+ * Assert that an activated extension registration registry contains a project
+ * profile registered via `api.registerProfile(profile)` (optionally scoped to a
+ * specific extension).
+ *
+ * This is the test-time counterpart to the declarative `defineProjectProfile`
+ * authoring helper and the `pm profile list/show/apply` runtime surface: it
+ * proves a package's archetype reached the registry so a downstream consumer can
+ * resolve and apply it by name. Like the other declarative-surface assertions
+ * (item types, item fields), a profile is verified by presence — it is staged,
+ * not executed — so there is no `runRegisteredProfileForTest` counterpart.
+ */
+export declare function assertRegisteredProfile(registrations: ExtensionRegistrationRegistry, expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
 /**
  * Assert that an activated extension command registry contains a command
  * override registered via `api.registerCommand(command, override)` (optionally
@@ -821,6 +870,100 @@ export declare function assertExtensionCapabilityUsage(activation: ExtensionActi
  * duplicate command, empty surface) without failing on them.
  */
 export declare function assertExtensionBlueprint(blueprint: ExtensionBlueprint, options?: LintExtensionBlueprintOptions): ExtensionBlueprintLintResult;
+/** Options for {@link assertProjectProfile}. */
+export interface AssertProjectProfileOptions {
+    /**
+     * Also throw when the profile produces `warning`-severity findings (e.g. a
+     * workflow transition referencing a status no profile or built-in defines).
+     * Off by default so warnings stay advisory; turn on for strict CI gates.
+     */
+    strict?: boolean;
+}
+/**
+ * Assert a {@link ProjectProfileDefinition} is internally consistent in a test,
+ * throwing on any `error`-severity finding (and on `warning`-severity findings
+ * too when `strict` is set). The author-time counterpart to `defineProjectProfile`
+ * and the project-profile analogue of {@link assertExtensionBlueprint}: drop
+ * `assertProjectProfile(myProfile)` into a package's `node:test`/Vitest suite to
+ * fail CI before the profile is ever registered via `api.registerProfile` or
+ * applied via `pm profile apply`. The full {@link ProjectProfileLintReport} is
+ * returned on success so a test can still inspect advisory warnings without
+ * failing on them.
+ */
+export declare function assertProjectProfile(profile: ProjectProfileDefinition, options?: AssertProjectProfileOptions): ProjectProfileLintReport;
+/**
+ * The structured result of {@link assertExtensionManifestMatchesBlueprint}: the
+ * reconciliation between a manifest's declared capabilities and the set the
+ * blueprint actually exercises. Returned only when they match exactly (the
+ * assertion throws otherwise).
+ */
+export interface ExtensionManifestBlueprintMatch {
+    /** The least-privilege capability set the blueprint exercises (from `deriveExtensionCapabilities`). */
+    used: ExtensionCapability[];
+    /** The manifest's declared capabilities, legacy-alias resolved and normalized. */
+    declared: ExtensionCapability[];
+    /** Capabilities the blueprint uses but the manifest omits — would crash activation. Empty on success. */
+    missing: ExtensionCapability[];
+    /** Capabilities the manifest declares but no surface exercises — violates least privilege. Empty on success. */
+    unused: ExtensionCapability[];
+    /** Every lint finding for the blueprint, so callers can inspect advisory warnings. */
+    findings: ExtensionBlueprintLintFinding[];
+}
+/**
+ * Strictly assert a manifest's `capabilities` equal the least-privilege set a
+ * declarative {@link ExtensionBlueprint} exercises, throwing on any drift in
+ * either direction.
+ *
+ * This is the strict bookend to the lenient {@link assertExtensionBlueprint}:
+ * where that helper fails only on an *undeclared* capability (the `error`-severity
+ * `extension_capability_missing` activation crash) and merely *warns* on an unused
+ * one, this assertion fails on **both** — an undeclared capability (`missing`) and
+ * a declared-but-unused one (`unused`) — so a hand-maintained `manifest.json` stays
+ * exactly the set the blueprint requires. Drop it into a package's
+ * `node:test`/Vitest suite to guard against capability drift in CI, the natural
+ * companion to {@link ../sdk/compose.js#synthesizeExtensionManifest} (assert what
+ * you would otherwise generate). Only `capabilities` are reconciled because that is
+ * the one manifest field a blueprint determines.
+ *
+ * The reconciliation is returned on success so a test can still inspect advisory
+ * warnings (duplicate command, empty surface) without failing on them.
+ */
+export declare function assertExtensionManifestMatchesBlueprint(manifest: Pick<ExtensionManifest, "capabilities">, blueprint: ExtensionBlueprint): ExtensionManifestBlueprintMatch;
+/**
+ * Assert an extension manifest's declared version bounds permit it to load on a
+ * target pm CLI version, throwing when a bound blocks the load.
+ *
+ * This is the throwing CI/test counterpart to
+ * {@link ../sdk/compose.js#checkExtensionManifestCompatibility}: it runs the same
+ * author-time version-bound analysis and fails on any blocking incompatibility — a
+ * malformed bound (`*_invalid`), a `pm_min_version` the target is below
+ * (`pm_min_version_unmet`), or a `block`-mode `pm_max_version` the target exceeds
+ * (`pm_max_version_exceeded`). Advisory `warning` findings (`*_unchecked`, or a
+ * `warn`-mode `pm_max_version_exceeded_warn`) never throw, because the loader
+ * would still load the extension. Pin it to the pm version a package commits to
+ * supporting so a too-tight or malformed bound fails the package's own suite, not
+ * a user's install. The full compatibility result is returned on success so a test
+ * can still inspect advisory warnings.
+ */
+export declare function assertExtensionManifestCompatible(manifest: ExtensionManifestCompatibilityManifest, target: ExtensionManifestCompatibilityTarget): ExtensionManifestCompatibilityResult;
+/**
+ * Preflight a declarative {@link ExtensionBlueprint} through every author-time
+ * check in one test, throwing if any stage produced an `error`-severity finding.
+ *
+ * This is the throwing CI/test bookend over
+ * {@link ../sdk/compose.js#preflightExtension} — the single guard that replaces
+ * chaining {@link assertExtensionBlueprint}, {@link assertExtensionManifestMatchesBlueprint},
+ * and {@link assertExtensionManifestCompatible} in a package's
+ * `node:test`/Vitest suite. It runs the same consolidated analysis (always lints
+ * the blueprint; synthesizes the manifest when `options.identity` is given; checks
+ * version bounds when `options.target` is given) and throws one error listing every
+ * blocking finding tagged by its `source:code`. Advisory `warning` findings (an
+ * unused capability, a duplicate command, an `*_unchecked` bound) never throw,
+ * matching the underlying stages. The full {@link ExtensionPreflightReport} is
+ * returned on success so a test can still inspect those warnings, the synthesized
+ * manifest, and the derived capability set without failing on them.
+ */
+export declare function assertExtensionPreflight(blueprint: ExtensionBlueprint, options?: PreflightExtensionOptions): ExtensionPreflightReport;
 /**
  * A fluent, single-extension test fixture returned by
  * {@link createExtensionTestHarness}.
@@ -848,6 +991,14 @@ export interface ExtensionTestHarness {
     readonly layer: ExtensionLayer;
     /** The underlying activation result; use it to reach standalone helpers directly. */
     readonly activation: ExtensionActivationResult;
+    /** Bound {@link describeExtensionActivation} over the whole `activation`. */
+    activationSummary(options?: DescribeExtensionActivationOptions): ExtensionActivationSummary;
+    /**
+     * Bound {@link renderExtensionSurfaceMarkdown} over {@link activationSummary},
+     * so tests and README generators can produce deterministic surface docs from
+     * the same harness they use for assert/run coverage.
+     */
+    renderMarkdown(options?: RenderExtensionHarnessMarkdownOptions): string;
     /** Bound {@link assertRegisteredCommandContract} over `activation.registrations`. */
     assertCommandContract(expectation: RegisteredCommandContractExpectation): RegisteredCommandContractAssertion;
     /** Bound {@link assertRegisteredFlags} over `activation.registrations`. */
@@ -856,6 +1007,8 @@ export interface ExtensionTestHarness {
     assertItemField(expectation: RegisteredItemFieldExpectation): RegisteredItemFieldAssertion;
     /** Bound {@link assertRegisteredItemType} over `activation.registrations`. */
     assertItemType(expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
+    /** Bound {@link assertRegisteredProfile} over `activation.registrations`. */
+    assertProfile(expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
     /** Bound {@link assertRegisteredHook} over `activation.hooks`. */
     assertHook<TKind extends RegisteredHookKind>(expectation: RegisteredHookExpectation & {
         kind: TKind;

package/dist/sdk/testing.js

@@ -1,17 +1,20 @@
 
-!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]="9ca86b28-8f2c-5dd3-bdf0-85d3f60e6197")}catch(e){}}();
+!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]="ed6d712c-3892-5ee3-893c-fcbb88508ede")}catch(e){}}();
 import { activateExtensions, deactivateExtensions, runAfterCommandHooks, runBeforeCommandHooks, runCommandHandler, runCommandOverride, runOnIndexHooks, runOnReadHooks, runOnWriteHooks, runParserOverride, runPreflightOverride, runRendererOverride, runServiceOverride, } from "../core/extensions/loader.js";
 import { createDefaultExtensionGovernancePolicy } from "../core/extensions/extension-types.js";
 import { getMigrationRuntimeDefinition, resolveRegisteredSearchProvider, resolveRegisteredVectorStoreAdapter, } from "../core/extensions/runtime-registrations.js";
 import { collectUsedExtensionCapabilities } from "../core/extensions/capability-usage.js";
 import { normalizeKnownExtensionCapability } from "../core/extensions/extension-capability-aliases.js";
-import { describeExtensionBlueprint, lintExtensionBlueprint } from "./compose.js";
+import { checkExtensionManifestCompatibility, describeExtensionBlueprint, lintExtensionBlueprint, preflightExtension, } from "./compose.js";
+import { describeExtensionActivation } from "../core/extensions/activation-summary.js";
+import { lintProjectProfile } from "../core/profile/profile-lint.js";
+import { renderExtensionSurfaceMarkdown } from "../core/extensions/activation-summary-markdown.js";
 // `describeExtensionActivation` is the `describe` (enumerate-all) verb that
 // pairs with the `assert*` (verify-one) and `run*` (invoke-one) helpers below.
 // It lives in core (it walks the same registries the loader populates) and is
 // surfaced here so package authors get the whole testing surface from the
 // `@unbrained/pm-cli/sdk/testing` subpath.
-export { describeExtensionActivation, } from "../core/extensions/activation-summary.js";
+export { describeExtensionActivation, renderExtensionSurfaceMarkdown, };
 // `composeExtension`'s author-time companions: describe a blueprint's surface map
 // and preflight it for capability drift / duplicate / empty-surface footguns
 // without activating. Surfaced through the `@unbrained/pm-cli/sdk/testing` subpath
@@ -29,6 +32,18 @@ const HOOK_KIND_TO_REGISTRY_FIELD = {
 function normalizeSdkIdentifier(value) {
     return value.trim().toLowerCase();
 }
+/**
+ * Match key for profile-name assertions. Extends {@link normalizeSdkIdentifier}
+ * with hyphen→underscore folding so the assertion mirrors the runtime profile
+ * resolution (`pm profile`), which treats `my-flow` and `my_flow` as the same
+ * archetype. Profiles are the one registration surface that resolves
+ * hyphen-insensitively (item types resolve by alias, migrations by exact id), so
+ * — unlike the other `assertRegistered*` helpers — this one folds the separator
+ * to stay in lockstep with how a profile is actually looked up by name.
+ */
+function normalizeSdkProfileMatchKey(value) {
+    return normalizeSdkIdentifier(value).replaceAll("-", "_");
+}
 function extensionNameSuffix(extensionName) {
     return extensionName ? ` from extension "${extensionName}"` : "";
 }
@@ -797,6 +812,32 @@ export function assertRegisteredItemType(registrations, expectation) {
     }
     return match;
 }
+/**
+ * Assert that an activated extension registration registry contains a project
+ * profile registered via `api.registerProfile(profile)` (optionally scoped to a
+ * specific extension).
+ *
+ * This is the test-time counterpart to the declarative `defineProjectProfile`
+ * authoring helper and the `pm profile list/show/apply` runtime surface: it
+ * proves a package's archetype reached the registry so a downstream consumer can
+ * resolve and apply it by name. Like the other declarative-surface assertions
+ * (item types, item fields), a profile is verified by presence — it is staged,
+ * not executed — so there is no `runRegisteredProfileForTest` counterpart.
+ */
+export function assertRegisteredProfile(registrations, expectation) {
+    const expectedProfile = normalizeSdkProfileMatchKey(expectation.profile);
+    if (expectedProfile.length === 0) {
+        throw new Error("Expected profile name must be a non-empty string");
+    }
+    const match = registrations.profiles
+        .filter((entry) => expectation.extensionName === undefined || entry.name === expectation.extensionName)
+        .find((entry) => normalizeSdkProfileMatchKey(entry.profile.name) === expectedProfile);
+    if (!match) {
+        const available = sortedUnique(registrations.profiles.map((entry) => entry.profile.name));
+        throw new Error(`Expected profile "${expectedProfile}"${extensionNameSuffix(expectation.extensionName)} to be registered. Available profiles: ${formatAvailable(available)}`);
+    }
+    return { registration: match, profile: match.profile };
+}
 /**
  * Assert that an activated extension command registry contains a command
  * override registered via `api.registerCommand(command, override)` (optionally
@@ -1006,6 +1047,123 @@ export function assertExtensionBlueprint(blueprint, options = {}) {
     }
     return result;
 }
+/**
+ * Assert a {@link ProjectProfileDefinition} is internally consistent in a test,
+ * throwing on any `error`-severity finding (and on `warning`-severity findings
+ * too when `strict` is set). The author-time counterpart to `defineProjectProfile`
+ * and the project-profile analogue of {@link assertExtensionBlueprint}: drop
+ * `assertProjectProfile(myProfile)` into a package's `node:test`/Vitest suite to
+ * fail CI before the profile is ever registered via `api.registerProfile` or
+ * applied via `pm profile apply`. The full {@link ProjectProfileLintReport} is
+ * returned on success so a test can still inspect advisory warnings without
+ * failing on them.
+ */
+export function assertProjectProfile(profile, options = {}) {
+    const report = lintProjectProfile(profile);
+    const blocking = report.findings.filter((finding) => finding.severity === "error" || (options.strict === true && finding.severity === "warning"));
+    if (blocking.length > 0) {
+        throw new Error(`Project profile "${report.profile}" failed lint with ${blocking.length} ${blocking.length === 1 ? "issue" : "issues"}:\n` +
+            blocking.map((finding) => `  - ${finding.severity} [${finding.code}] ${finding.message}`).join("\n"));
+    }
+    return report;
+}
+/**
+ * Strictly assert a manifest's `capabilities` equal the least-privilege set a
+ * declarative {@link ExtensionBlueprint} exercises, throwing on any drift in
+ * either direction.
+ *
+ * This is the strict bookend to the lenient {@link assertExtensionBlueprint}:
+ * where that helper fails only on an *undeclared* capability (the `error`-severity
+ * `extension_capability_missing` activation crash) and merely *warns* on an unused
+ * one, this assertion fails on **both** — an undeclared capability (`missing`) and
+ * a declared-but-unused one (`unused`) — so a hand-maintained `manifest.json` stays
+ * exactly the set the blueprint requires. Drop it into a package's
+ * `node:test`/Vitest suite to guard against capability drift in CI, the natural
+ * companion to {@link ../sdk/compose.js#synthesizeExtensionManifest} (assert what
+ * you would otherwise generate). Only `capabilities` are reconciled because that is
+ * the one manifest field a blueprint determines.
+ *
+ * The reconciliation is returned on success so a test can still inspect advisory
+ * warnings (duplicate command, empty surface) without failing on them.
+ */
+export function assertExtensionManifestMatchesBlueprint(manifest, blueprint) {
+    // Coerce a malformed/absent capabilities field to an explicit empty declared set
+    // so an untyped `.js` caller gets a deterministic `missing` list rather than the
+    // lint silently falling back to the blueprint's in-module manifest mirror.
+    const declaredCapabilities = Array.isArray(manifest.capabilities) ? manifest.capabilities : [];
+    const result = lintExtensionBlueprint(blueprint, { declaredCapabilities });
+    // `declared` is guaranteed non-null here: we always hand lint an array, so it
+    // never takes its "no declared set" branch. The cast drops the unreachable null.
+    const declared = result.declared;
+    const declaredSet = new Set(declared);
+    const usedSet = new Set(result.used);
+    const missing = result.used.filter((capability) => !declaredSet.has(capability));
+    const unused = declared.filter((capability) => !usedSet.has(capability));
+    if (missing.length > 0 || unused.length > 0) {
+        const parts = [];
+        if (missing.length > 0) {
+            parts.push(`missing [${missing.join(", ")}] (the blueprint registers ${missing.length === 1 ? "a surface" : "surfaces"} requiring ${missing.length === 1 ? "it" : "them"}; activation throws extension_capability_missing)`);
+        }
+        if (unused.length > 0) {
+            parts.push(`unused [${unused.join(", ")}] (declared but no surface exercises ${unused.length === 1 ? "it" : "them"}; drop for least privilege)`);
+        }
+        throw new Error(`Manifest capabilities do not match the blueprint: ${parts.join("; ")}. ` +
+            "Set capabilities to synthesizeExtensionManifest(blueprint, identity).capabilities to stay in sync.");
+    }
+    return { used: result.used, declared, missing, unused, findings: result.findings };
+}
+/**
+ * Assert an extension manifest's declared version bounds permit it to load on a
+ * target pm CLI version, throwing when a bound blocks the load.
+ *
+ * This is the throwing CI/test counterpart to
+ * {@link ../sdk/compose.js#checkExtensionManifestCompatibility}: it runs the same
+ * author-time version-bound analysis and fails on any blocking incompatibility — a
+ * malformed bound (`*_invalid`), a `pm_min_version` the target is below
+ * (`pm_min_version_unmet`), or a `block`-mode `pm_max_version` the target exceeds
+ * (`pm_max_version_exceeded`). Advisory `warning` findings (`*_unchecked`, or a
+ * `warn`-mode `pm_max_version_exceeded_warn`) never throw, because the loader
+ * would still load the extension. Pin it to the pm version a package commits to
+ * supporting so a too-tight or malformed bound fails the package's own suite, not
+ * a user's install. The full compatibility result is returned on success so a test
+ * can still inspect advisory warnings.
+ */
+export function assertExtensionManifestCompatible(manifest, target) {
+    const result = checkExtensionManifestCompatibility(manifest, target);
+    const blocking = result.findings.filter((finding) => finding.severity === "error");
+    if (blocking.length > 0) {
+        throw new Error(`Extension manifest is not compatible with pm ${result.pmVersion}: ${blocking
+            .map((finding) => finding.message)
+            .join("; ")}`);
+    }
+    return result;
+}
+/**
+ * Preflight a declarative {@link ExtensionBlueprint} through every author-time
+ * check in one test, throwing if any stage produced an `error`-severity finding.
+ *
+ * This is the throwing CI/test bookend over
+ * {@link ../sdk/compose.js#preflightExtension} — the single guard that replaces
+ * chaining {@link assertExtensionBlueprint}, {@link assertExtensionManifestMatchesBlueprint},
+ * and {@link assertExtensionManifestCompatible} in a package's
+ * `node:test`/Vitest suite. It runs the same consolidated analysis (always lints
+ * the blueprint; synthesizes the manifest when `options.identity` is given; checks
+ * version bounds when `options.target` is given) and throws one error listing every
+ * blocking finding tagged by its `source:code`. Advisory `warning` findings (an
+ * unused capability, a duplicate command, an `*_unchecked` bound) never throw,
+ * matching the underlying stages. The full {@link ExtensionPreflightReport} is
+ * returned on success so a test can still inspect those warnings, the synthesized
+ * manifest, and the derived capability set without failing on them.
+ */
+export function assertExtensionPreflight(blueprint, options = {}) {
+    const report = preflightExtension(blueprint, options);
+    if (!report.ok) {
+        const errors = report.findings.filter((finding) => finding.severity === "error");
+        throw new Error(`Extension failed preflight with ${errors.length} ${errors.length === 1 ? "error" : "errors"}:\n` +
+            errors.map((finding) => `  - [${finding.source}:${finding.code}] ${finding.message}`).join("\n"));
+    }
+    return report;
+}
 /**
  * Activate one in-memory extension module and return a fluent
  * {@link ExtensionTestHarness} that binds every SDK testing helper to the right
@@ -1054,6 +1212,13 @@ export async function createExtensionTestHarness(module, options = {}) {
         name,
         layer,
         activation,
+        activationSummary(describeOptions) {
+            return describeExtensionActivation(activation, describeOptions);
+        },
+        renderMarkdown(markdownOptions = {}) {
+            const { extensionName, ...renderOptions } = markdownOptions ?? {};
+            return renderExtensionSurfaceMarkdown(describeExtensionActivation(activation, { extensionName }), renderOptions);
+        },
         assertCommandContract(expectation) {
             return assertRegisteredCommandContract(activation.registrations, expectation);
         },
@@ -1066,6 +1231,9 @@ export async function createExtensionTestHarness(module, options = {}) {
         assertItemType(expectation) {
             return assertRegisteredItemType(activation.registrations, expectation);
         },
+        assertProfile(expectation) {
+            return assertRegisteredProfile(activation.registrations, expectation);
+        },
         assertHook(expectation) {
             return assertRegisteredHook(activation.hooks, expectation);
         },
@@ -1149,4 +1317,4 @@ export async function createExtensionTestHarness(module, options = {}) {
     };
 }
 //# sourceMappingURL=testing.js.map
-//# debugId=9ca86b28-8f2c-5dd3-bdf0-85d3f60e6197
+//# debugId=ed6d712c-3892-5ee3-893c-fcbb88508ede