@unbrained/pm-cli 2026.6.8 → 2026.6.9

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["import {\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  type ExtensionApi,\n  type ExtensionManifest,\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 \"./runtime.js\";\nexport {\n  assertPackageManifest,\n  assertRegisteredCommandContract,\n  assertRegisteredExporter,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredSearchProvider,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  type ActivateExtensionForTestOptions,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredSearchProviderExpectation,\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;\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;\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\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\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.\n   */\n  manifest?: ExtensionManifest;\n  activate(api: ExtensionApi): 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 */\nexport function defineExtension<TModule extends ExtensionModule>(module: TModule): TModule {\n  return module;\n}\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionHookRegistry,\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  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionSearchProvider,\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,OAAO,EACL,6BAA6B,EAC7B,qCAAqC,EACrC,mCAAmC,EACnC,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,gCAAgC,EAChC,2BAA2B,GAG5B,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,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,kCAAkC,EAClC,wBAAwB,GAgBzB,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAGnE;;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;AAM3E;;GAEG;AACH,OAAO,EAAE,6BAA6B,EAAE,qCAAqC,EAAE,mCAAmC,EAAE,CAAC;AAarH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAkC,MAAe;IAC9E,OAAO,MAAM,CAAC;AAChB,CAAC","debugId":"d21b0078-6726-5b3d-ad1b-61299e524445"}
+{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["import {\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  type ExtensionApi,\n  type ExtensionManifest,\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 \"./runtime.js\";\nexport {\n  assertPackageManifest,\n  assertRegisteredCommandContract,\n  assertRegisteredCommandOverride,\n  assertRegisteredExporter,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredParserOverride,\n  assertRegisteredPreflightOverride,\n  assertRegisteredRendererOverride,\n  assertRegisteredSearchProvider,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  type ActivateExtensionForTestOptions,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredCommandOverrideExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredParserOverrideExpectation,\n  type RegisteredPreflightOverrideExpectation,\n  type RegisteredRendererOverrideExpectation,\n  type RegisteredSearchProviderExpectation,\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;\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;\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\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\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.\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 */\nexport function defineExtension<TModule extends ExtensionModule>(module: TModule): TModule {\n  return module;\n}\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationFailure,\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  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionSearchProvider,\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,OAAO,EACL,6BAA6B,EAC7B,qCAAqC,EACrC,mCAAmC,EACnC,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,gCAAgC,EAChC,2BAA2B,GAG5B,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,OAAO,EACL,qBAAqB,EACrB,+BAA+B,EAC/B,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,iCAAiC,EACjC,gCAAgC,EAChC,8BAA8B,EAC9B,kCAAkC,EAClC,wBAAwB,GAoBzB,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAGnE;;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;AAM3E;;GAEG;AACH,OAAO,EAAE,6BAA6B,EAAE,qCAAqC,EAAE,mCAAmC,EAAE,CAAC;AAkBrH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAkC,MAAe;IAC9E,OAAO,MAAM,CAAC;AAChB,CAAC","debugId":"d13f5b40-8e83-5eab-998b-779d9130e847"}

package/dist/sdk/testing.d.ts

@@ -1,4 +1,4 @@
-import type { ExtensionActivationResult, ExtensionCapability, ExtensionGovernancePolicy, ExtensionHookRegistry, ExtensionLayer, ExtensionRegistrationRegistry, FlagDefinition, RegisteredExtensionCommandDefinition, RegisteredExtensionExporter, RegisteredExtensionImporter, RegisteredExtensionSchemaFieldDefinitions, RegisteredExtensionSchemaItemTypeDefinitions, RegisteredExtensionSearchProvider, RegisteredExtensionVectorStoreAdapter, SchemaFieldDefinition, SchemaItemTypeDefinition } from "../core/extensions/loader.js";
+import type { ExtensionActivationResult, ExtensionCapability, ExtensionCommandRegistry, ExtensionGovernancePolicy, ExtensionHookRegistry, ExtensionLayer, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, FlagDefinition, OutputRendererFormat, RegisteredExtensionCommandDefinition, RegisteredExtensionCommandOverride, RegisteredExtensionExporter, RegisteredExtensionImporter, RegisteredExtensionParserOverride, RegisteredExtensionPreflightOverride, RegisteredExtensionRendererOverride, RegisteredExtensionSchemaFieldDefinitions, RegisteredExtensionSchemaItemTypeDefinitions, RegisteredExtensionSearchProvider, RegisteredExtensionVectorStoreAdapter, SchemaFieldDefinition, SchemaItemTypeDefinition } from "../core/extensions/loader.js";
 import type { PmPackageManifest, PmPackageResourceKind } from "../core/packages/manifest.js";
 export interface ActivateExtensionForTestOptions {
     name?: string;
@@ -60,6 +60,21 @@ export interface RegisteredItemTypeAssertion {
     registration: RegisteredExtensionSchemaItemTypeDefinitions;
     itemType: SchemaItemTypeDefinition;
 }
+export interface RegisteredCommandOverrideExpectation {
+    command: string;
+    extensionName?: string;
+}
+export interface RegisteredParserOverrideExpectation {
+    command: string;
+    extensionName?: string;
+}
+export interface RegisteredPreflightOverrideExpectation {
+    extensionName?: string;
+}
+export interface RegisteredRendererOverrideExpectation {
+    format: OutputRendererFormat;
+    extensionName?: string;
+}
 export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;
 export interface PackageManifestExpectation {
     packageName?: string;
@@ -124,4 +139,43 @@ 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 command registry contains a command
+ * override registered via `api.registerCommand(command, override)` (optionally
+ * scoped to a specific extension).
+ *
+ * Command overrides are surfaced via `ExtensionActivationResult.commands`, not
+ * the command registration registry, so this helper accepts an
+ * `ExtensionCommandRegistry`.
+ */
+export declare function assertRegisteredCommandOverride(commands: ExtensionCommandRegistry, expectation: RegisteredCommandOverrideExpectation): RegisteredExtensionCommandOverride;
+/**
+ * Assert that an activated extension parser registry contains a parser override
+ * registered via `api.registerParser(command, override)` (optionally scoped to
+ * a specific extension).
+ *
+ * Parser overrides are surfaced via `ExtensionActivationResult.parsers`, not the
+ * command registration registry, so this helper accepts an
+ * `ExtensionParserRegistry`.
+ */
+export declare function assertRegisteredParserOverride(parsers: ExtensionParserRegistry, expectation: RegisteredParserOverrideExpectation): RegisteredExtensionParserOverride;
+/**
+ * Assert that an activated extension preflight registry contains a preflight
+ * override registered via `api.registerPreflight(override)` (optionally scoped
+ * to a specific extension).
+ *
+ * Preflight overrides are global (they run for every command and carry no
+ * `command` field), so the expectation only accepts an optional
+ * `extensionName`. Preflight overrides are surfaced via
+ * `ExtensionActivationResult.preflight`.
+ */
+export declare function assertRegisteredPreflightOverride(preflight: ExtensionPreflightRegistry, expectation?: RegisteredPreflightOverrideExpectation): RegisteredExtensionPreflightOverride;
+/**
+ * Assert that an activated extension renderer registry contains a renderer
+ * override registered via `api.registerRenderer(format, renderer)` for the
+ * expected output format (optionally scoped to a specific extension).
+ *
+ * Renderer overrides are surfaced via `ExtensionActivationResult.renderers`.
+ */
+export declare function assertRegisteredRendererOverride(renderers: ExtensionRendererRegistry, expectation: RegisteredRendererOverrideExpectation): RegisteredExtensionRendererOverride;
 export {};

package/dist/sdk/testing.js

@@ -1,5 +1,5 @@
 
-!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]="ad18423f-8581-56aa-a065-70561c5bcd5d")}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]="43b78d54-eeb1-571e-8e88-e67b2432cfd6")}catch(e){}}();
 import { activateExtensions } from "../core/extensions/loader.js";
 import { createDefaultExtensionGovernancePolicy } from "../core/extensions/extension-types.js";
 const HOOK_KIND_TO_REGISTRY_FIELD = {
@@ -326,5 +326,95 @@ export function assertRegisteredItemType(registrations, expectation) {
     }
     return match;
 }
+/**
+ * Assert that an activated extension command registry contains a command
+ * override registered via `api.registerCommand(command, override)` (optionally
+ * scoped to a specific extension).
+ *
+ * Command overrides are surfaced via `ExtensionActivationResult.commands`, not
+ * the command registration registry, so this helper accepts an
+ * `ExtensionCommandRegistry`.
+ */
+export function assertRegisteredCommandOverride(commands, expectation) {
+    const expectedCommand = normalizeSdkCommandName(expectation.command);
+    if (expectedCommand.length === 0) {
+        throw new Error("Expected command name must be a non-empty string");
+    }
+    const candidates = commands.overrides.filter((entry) => entry.command === expectedCommand);
+    const override = expectation.extensionName
+        ? candidates.find((entry) => entry.name === expectation.extensionName)
+        : candidates[0];
+    if (!override) {
+        const available = sortedUnique(commands.overrides.map((entry) => entry.command));
+        throw new Error(`Expected command override "${expectedCommand}"${extensionNameSuffix(expectation.extensionName)} to be registered. Available command overrides: ${formatAvailable(available)}`);
+    }
+    return override;
+}
+/**
+ * Assert that an activated extension parser registry contains a parser override
+ * registered via `api.registerParser(command, override)` (optionally scoped to
+ * a specific extension).
+ *
+ * Parser overrides are surfaced via `ExtensionActivationResult.parsers`, not the
+ * command registration registry, so this helper accepts an
+ * `ExtensionParserRegistry`.
+ */
+export function assertRegisteredParserOverride(parsers, expectation) {
+    const expectedCommand = normalizeSdkCommandName(expectation.command);
+    if (expectedCommand.length === 0) {
+        throw new Error("Expected command name must be a non-empty string");
+    }
+    const candidates = parsers.overrides.filter((entry) => entry.command === expectedCommand);
+    const override = expectation.extensionName
+        ? candidates.find((entry) => entry.name === expectation.extensionName)
+        : candidates[0];
+    if (!override) {
+        const available = sortedUnique(parsers.overrides.map((entry) => entry.command));
+        throw new Error(`Expected parser override "${expectedCommand}"${extensionNameSuffix(expectation.extensionName)} to be registered. Available parser overrides: ${formatAvailable(available)}`);
+    }
+    return override;
+}
+/**
+ * Assert that an activated extension preflight registry contains a preflight
+ * override registered via `api.registerPreflight(override)` (optionally scoped
+ * to a specific extension).
+ *
+ * Preflight overrides are global (they run for every command and carry no
+ * `command` field), so the expectation only accepts an optional
+ * `extensionName`. Preflight overrides are surfaced via
+ * `ExtensionActivationResult.preflight`.
+ */
+export function assertRegisteredPreflightOverride(preflight, expectation = {}) {
+    const override = expectation.extensionName
+        ? preflight.overrides.find((entry) => entry.name === expectation.extensionName)
+        : preflight.overrides[0];
+    if (!override) {
+        const available = sortedUnique(preflight.overrides.map((entry) => entry.name));
+        throw new Error(`Expected a preflight override${extensionNameSuffix(expectation.extensionName)} to be registered. Available preflight overrides: ${formatAvailable(available)}`);
+    }
+    return override;
+}
+/**
+ * Assert that an activated extension renderer registry contains a renderer
+ * override registered via `api.registerRenderer(format, renderer)` for the
+ * expected output format (optionally scoped to a specific extension).
+ *
+ * Renderer overrides are surfaced via `ExtensionActivationResult.renderers`.
+ */
+export function assertRegisteredRendererOverride(renderers, expectation) {
+    const expectedFormat = normalizeSdkIdentifier(expectation.format);
+    if (expectedFormat.length === 0) {
+        throw new Error("Expected renderer format must be a non-empty string");
+    }
+    const candidates = renderers.overrides.filter((entry) => entry.format === expectedFormat);
+    const override = expectation.extensionName
+        ? candidates.find((entry) => entry.name === expectation.extensionName)
+        : candidates[0];
+    if (!override) {
+        const available = sortedUnique(renderers.overrides.map((entry) => entry.format));
+        throw new Error(`Expected renderer override "${expectedFormat}"${extensionNameSuffix(expectation.extensionName)} to be registered. Available renderer overrides: ${formatAvailable(available)}`);
+    }
+    return override;
+}
 //# sourceMappingURL=testing.js.map
-//# debugId=ad18423f-8581-56aa-a065-70561c5bcd5d
+//# debugId=43b78d54-eeb1-571e-8e88-e67b2432cfd6

package/dist/sdk/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sources":["sdk/testing.ts"],"sourceRoot":"/","sourcesContent":["import type {\n  ExtensionActivationResult,\n  ExtensionCapability,\n  ExtensionGovernancePolicy,\n  ExtensionHookRegistry,\n  ExtensionLayer,\n  ExtensionManifest,\n  ExtensionRegistrationRegistry,\n  FlagDefinition,\n  RegisteredExtensionCommandDefinition,\n  RegisteredExtensionExporter,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionSchemaFieldDefinitions,\n  RegisteredExtensionSchemaItemTypeDefinitions,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionVectorStoreAdapter,\n  SchemaFieldDefinition,\n  SchemaItemTypeDefinition,\n} from \"../core/extensions/loader.js\";\nimport { activateExtensions } from \"../core/extensions/loader.js\";\nimport { createDefaultExtensionGovernancePolicy } from \"../core/extensions/extension-types.js\";\nimport type { PmPackageManifest, PmPackageResourceKind } from \"../core/packages/manifest.js\";\n\ninterface TestExtensionModule {\n  manifest?: Partial<ExtensionManifest>;\n  activate?: unknown;\n  default?: TestExtensionModule;\n}\n\nexport interface ActivateExtensionForTestOptions {\n  name?: string;\n  layer?: ExtensionLayer;\n  capabilities?: readonly ExtensionCapability[];\n  policy?: ExtensionGovernancePolicy;\n}\n\nexport interface RegisteredCommandContractExpectation {\n  command: string;\n  action?: string;\n  extensionName?: string;\n  arguments?: string[];\n  flags?: string[];\n}\n\nexport interface RegisteredCommandContractAssertion {\n  command: RegisteredExtensionCommandDefinition;\n  flags: FlagDefinition[];\n}\n\n/**\n * Public hook lifecycle kinds an extension can register through `api.hooks.*`.\n */\nexport type RegisteredHookKind = \"before_command\" | \"after_command\" | \"on_read\" | \"on_write\" | \"on_index\";\n\nconst HOOK_KIND_TO_REGISTRY_FIELD: Record<RegisteredHookKind, keyof ExtensionHookRegistry> = {\n  before_command: \"beforeCommand\",\n  after_command: \"afterCommand\",\n  on_read: \"onRead\",\n  on_write: \"onWrite\",\n  on_index: \"onIndex\",\n};\n\nexport interface RegisteredHookExpectation {\n  kind: RegisteredHookKind;\n  extensionName?: string;\n}\n\nexport interface RegisteredSearchProviderExpectation {\n  provider: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredVectorStoreAdapterExpectation {\n  adapter: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredImporterExpectation {\n  importer: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredExporterExpectation {\n  exporter: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredItemFieldExpectation {\n  field: string;\n  extensionName?: string;\n  type?: SchemaFieldDefinition[\"type\"];\n}\n\nexport interface RegisteredItemFieldAssertion {\n  registration: RegisteredExtensionSchemaFieldDefinitions;\n  field: SchemaFieldDefinition;\n}\n\nexport interface RegisteredItemTypeExpectation {\n  itemType: string;\n  extensionName?: string;\n  folder?: string;\n}\n\nexport interface RegisteredItemTypeAssertion {\n  registration: RegisteredExtensionSchemaItemTypeDefinitions;\n  itemType: SchemaItemTypeDefinition;\n}\n\nexport type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;\n\nexport interface PackageManifestExpectation {\n  packageName?: string;\n  aliases?: readonly string[];\n  resources?: PackageManifestResourceExpectation;\n}\n\nfunction normalizeSdkIdentifier(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nfunction extensionNameSuffix(extensionName: string | undefined): string {\n  return extensionName ? ` from extension \"${extensionName}\"` : \"\";\n}\n\nfunction sortedUnique(values: readonly string[]): string[] {\n  return [...new Set(values)].sort((left, right) => left.localeCompare(right));\n}\n\nfunction normalizeSdkCommandName(command: string): string {\n  return command\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/)\n    .filter((part) => part.length > 0)\n    .join(\" \");\n}\n\nfunction formatAvailable(values: readonly string[]): string {\n  return values.length > 0 ? values.join(\", \") : \"(none)\";\n}\n\nfunction assertStringSetIncludes(\n  actual: readonly string[] | undefined,\n  expected: readonly string[],\n  label: string,\n): void {\n  const actualValues = new Set(actual ?? []);\n  const missing = sortedUnique(expected.filter((value) => !actualValues.has(value)));\n  if (missing.length > 0) {\n    throw new Error(\n      `Expected package manifest ${label} to include ${missing.join(\", \")}; available: ${formatAvailable(\n        sortedUnique(actual ?? []),\n      )}`,\n    );\n  }\n}\n\nfunction collectFlagLabels(flags: readonly FlagDefinition[]): Set<string> {\n  const labels = new Set<string>();\n  for (const flag of flags) {\n    if (typeof flag.long === \"string\" && flag.long.trim().length > 0) {\n      labels.add(flag.long.trim());\n    }\n    if (typeof flag.short === \"string\" && flag.short.trim().length > 0) {\n      labels.add(flag.short.trim());\n    }\n  }\n  return labels;\n}\n\nfunction readTestExtensionManifest(module: unknown): Partial<ExtensionManifest> {\n  if (module && typeof module === \"object\") {\n    const testModule = module as TestExtensionModule;\n    const manifest = testModule.manifest;\n    if (manifest && typeof manifest === \"object\") {\n      return manifest;\n    }\n    const defaultExport = testModule.default;\n    const defaultManifest = defaultExport?.manifest;\n    if (defaultManifest && typeof defaultManifest === \"object\") {\n      return defaultManifest;\n    }\n    if (defaultExport && typeof defaultExport === \"object\" && (\"name\" in defaultExport || \"capabilities\" in defaultExport)) {\n      return defaultExport as Partial<ExtensionManifest>;\n    }\n    if (\"name\" in testModule || \"capabilities\" in testModule) {\n      return testModule as Partial<ExtensionManifest>;\n    }\n  }\n  return {};\n}\n\nfunction readTestExtensionCapabilities(\n  manifest: Partial<ExtensionManifest>,\n  options: ActivateExtensionForTestOptions,\n): ExtensionCapability[] {\n  if (Array.isArray(options.capabilities)) {\n    return [...options.capabilities];\n  }\n  if (Array.isArray(manifest.capabilities)) {\n    return manifest.capabilities.filter((capability): capability is ExtensionCapability => typeof capability === \"string\");\n  }\n  return [];\n}\n\n/**\n * Activate one in-memory extension module for package tests.\n *\n * This uses pm's real registration validation and activation engine while\n * avoiding private loader imports, filesystem manifests, or workspace setup.\n */\nexport async function activateExtensionForTest(\n  module: unknown,\n  options: ActivateExtensionForTestOptions = {},\n): Promise<ExtensionActivationResult> {\n  const manifest = readTestExtensionManifest(module);\n  const name =\n    options.name ??\n    (typeof manifest.name === \"string\" && manifest.name.trim().length > 0 ? manifest.name.trim() : \"test-extension\");\n  const layer = options.layer ?? \"project\";\n  const capabilities = readTestExtensionCapabilities(manifest, options);\n\n  return activateExtensions({\n    disabled_by_flag: false,\n    roots: { global: \"\", project: \"\" },\n    configured_enabled: [],\n    configured_disabled: [],\n    discovered: [],\n    effective: [],\n    warnings: [],\n    policy: options.policy ?? createDefaultExtensionGovernancePolicy(),\n    failed: [],\n    loaded: [\n      {\n        layer,\n        directory: \"\",\n        manifest_path: \"\",\n        name,\n        version: typeof manifest.version === \"string\" ? manifest.version : \"0.0.0\",\n        entry: typeof manifest.entry === \"string\" ? manifest.entry : \"./index.js\",\n        priority: typeof manifest.priority === \"number\" ? manifest.priority : 0,\n        entry_path: \"\",\n        capabilities,\n        manifest_version: typeof manifest.manifest_version === \"number\" ? manifest.manifest_version : undefined,\n        pm_min_version: typeof manifest.pm_min_version === \"string\" ? manifest.pm_min_version : undefined,\n        pm_max_version: typeof manifest.pm_max_version === \"string\" ? manifest.pm_max_version : undefined,\n        engines: manifest.engines,\n        trusted: manifest.trusted,\n        provenance: manifest.provenance,\n        sandbox_profile: manifest.sandbox_profile,\n        permissions: manifest.permissions,\n        activation: manifest.activation,\n        module,\n      },\n    ],\n  });\n}\n\n/**\n * Assert that a normalized package manifest advertises expected package\n * resources. Pair with `readPmPackageManifest(packageRoot)` in package tests.\n */\nexport function assertPackageManifest(\n  manifest: PmPackageManifest,\n  expectation: PackageManifestExpectation,\n): PmPackageManifest {\n  if (expectation.packageName !== undefined && manifest.package_name !== expectation.packageName) {\n    throw new Error(\n      `Expected package manifest package_name to be \"${expectation.packageName}\"; received \"${\n        manifest.package_name ?? \"(none)\"\n      }\"`,\n    );\n  }\n  if (expectation.aliases !== undefined) {\n    assertStringSetIncludes(manifest.aliases, expectation.aliases, \"aliases\");\n  }\n  if (expectation.resources !== undefined) {\n    for (const [kind, expectedPaths] of Object.entries(expectation.resources) as Array<\n      [PmPackageResourceKind, readonly string[]]\n    >) {\n      assertStringSetIncludes(manifest.resources[kind], expectedPaths, `pm.${kind}`);\n    }\n  }\n  return manifest;\n}\n\n/**\n * Assert that an activated extension registration registry contains a command\n * contract with the expected public metadata.\n */\nexport function assertRegisteredCommandContract(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredCommandContractExpectation,\n): RegisteredCommandContractAssertion {\n  const expectedCommand = normalizeSdkCommandName(expectation.command);\n  if (expectedCommand.length === 0) {\n    throw new Error(\"Expected command name must be a non-empty string\");\n  }\n\n  const commandCandidates = registrations.commands.filter((entry) => entry.command === expectedCommand);\n  const command = expectation.extensionName\n    ? commandCandidates.find((entry) => entry.name === expectation.extensionName)\n    : commandCandidates[0];\n  if (!command) {\n    const available = registrations.commands.map((entry) => entry.command).sort((left, right) => left.localeCompare(right));\n    const extensionSuffix = expectation.extensionName ? ` from extension \"${expectation.extensionName}\"` : \"\";\n    throw new Error(\n      `Expected extension command \"${expectedCommand}\"${extensionSuffix} to be registered. Available commands: ${formatAvailable(\n        available,\n      )}`,\n    );\n  }\n\n  if (expectation.action !== undefined && command.action !== expectation.action) {\n    throw new Error(\n      `Expected extension command \"${expectedCommand}\" action \"${expectation.action}\", received \"${command.action}\"`,\n    );\n  }\n\n  if (expectation.arguments !== undefined) {\n    const actualArguments = (command.arguments ?? []).map((argument) => argument.name);\n    const missingArguments = expectation.arguments.filter((argument) => !actualArguments.includes(argument));\n    if (missingArguments.length > 0) {\n      throw new Error(\n        `Expected extension command \"${expectedCommand}\" arguments ${formatAvailable(\n          expectation.arguments,\n        )}; missing ${formatAvailable(missingArguments)}; available ${formatAvailable(actualArguments)}`,\n      );\n    }\n  }\n\n  const flags = registrations.flags\n    .filter(\n      (entry) =>\n        entry.target_command === expectedCommand &&\n        (expectation.extensionName === undefined || entry.name === expectation.extensionName),\n    )\n    .flatMap((entry) => entry.flags);\n\n  if (expectation.flags !== undefined) {\n    const actualFlagLabels = collectFlagLabels(flags);\n    const missingFlags = expectation.flags.filter((flag) => !actualFlagLabels.has(flag));\n    if (missingFlags.length > 0) {\n      throw new Error(\n        `Expected extension command \"${expectedCommand}\" flags ${formatAvailable(expectation.flags)}; missing ${formatAvailable(\n          missingFlags,\n        )}; available ${formatAvailable([...actualFlagLabels].sort((left, right) => left.localeCompare(right)))}`,\n      );\n    }\n  }\n\n  return { command, flags };\n}\n\n/**\n * Assert that an activated extension hook registry contains a hook of the\n * expected lifecycle kind (optionally scoped to a specific extension).\n *\n * Hooks are surfaced via `ExtensionActivationResult.hooks`, not the command\n * registration registry, so this helper accepts an `ExtensionHookRegistry`.\n */\nexport function assertRegisteredHook<TKind extends RegisteredHookKind>(\n  hooks: ExtensionHookRegistry,\n  expectation: RegisteredHookExpectation & { kind: TKind },\n): ExtensionHookRegistry[(typeof HOOK_KIND_TO_REGISTRY_FIELD)[TKind]][number] {\n  const field = HOOK_KIND_TO_REGISTRY_FIELD[expectation.kind];\n  const candidates = hooks[field] as ReadonlyArray<RegisteredExtensionHook<unknown>>;\n  const hook = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!hook) {\n    const available = sortedUnique(candidates.map((entry) => entry.name));\n    throw new Error(\n      `Expected a \"${expectation.kind}\" hook${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available \"${expectation.kind}\" hooks: ${formatAvailable(available)}`,\n    );\n  }\n\n  return hook as ExtensionHookRegistry[(typeof HOOK_KIND_TO_REGISTRY_FIELD)[TKind]][number];\n}\n\n/**\n * Assert that an activated extension registration registry contains a search\n * provider with the expected name (optionally scoped to a specific extension).\n */\nexport function assertRegisteredSearchProvider(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredSearchProviderExpectation,\n): RegisteredExtensionSearchProvider {\n  const expectedProvider = normalizeSdkIdentifier(expectation.provider);\n  if (expectedProvider.length === 0) {\n    throw new Error(\"Expected search provider name must be a non-empty string\");\n  }\n\n  const candidates = registrations.search_providers.filter(\n    (entry) => normalizeSdkIdentifier(entry.definition.name) === expectedProvider,\n  );\n  const provider = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!provider) {\n    const available = sortedUnique(registrations.search_providers.map((entry) => entry.definition.name));\n    throw new Error(\n      `Expected search provider \"${expectedProvider}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available search providers: ${formatAvailable(available)}`,\n    );\n  }\n\n  return provider;\n}\n\n/**\n * Assert that an activated extension registration registry contains a vector\n * store adapter with the expected name (optionally scoped to a specific\n * extension).\n */\nexport function assertRegisteredVectorStoreAdapter(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredVectorStoreAdapterExpectation,\n): RegisteredExtensionVectorStoreAdapter {\n  const expectedAdapter = normalizeSdkIdentifier(expectation.adapter);\n  if (expectedAdapter.length === 0) {\n    throw new Error(\"Expected vector store adapter name must be a non-empty string\");\n  }\n\n  const candidates = registrations.vector_store_adapters.filter(\n    (entry) => normalizeSdkIdentifier(entry.definition.name) === expectedAdapter,\n  );\n  const adapter = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!adapter) {\n    const available = sortedUnique(registrations.vector_store_adapters.map((entry) => entry.definition.name));\n    throw new Error(\n      `Expected vector store adapter \"${expectedAdapter}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available vector store adapters: ${formatAvailable(available)}`,\n    );\n  }\n\n  return adapter;\n}\n\n/**\n * Assert that an activated extension registration registry contains an importer\n * for the expected format/name (optionally scoped to a specific extension).\n */\nexport function assertRegisteredImporter(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredImporterExpectation,\n): RegisteredExtensionImporter {\n  const expectedImporter = normalizeSdkIdentifier(expectation.importer);\n  if (expectedImporter.length === 0) {\n    throw new Error(\"Expected importer name must be a non-empty string\");\n  }\n\n  const candidates = registrations.importers.filter(\n    (entry) => normalizeSdkIdentifier(entry.importer) === expectedImporter,\n  );\n  const importer = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!importer) {\n    const available = sortedUnique(registrations.importers.map((entry) => entry.importer));\n    throw new Error(\n      `Expected importer \"${expectedImporter}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available importers: ${formatAvailable(available)}`,\n    );\n  }\n\n  return importer;\n}\n\n/**\n * Assert that an activated extension registration registry contains an exporter\n * for the expected format/name (optionally scoped to a specific extension).\n */\nexport function assertRegisteredExporter(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredExporterExpectation,\n): RegisteredExtensionExporter {\n  const expectedExporter = normalizeSdkIdentifier(expectation.exporter);\n  if (expectedExporter.length === 0) {\n    throw new Error(\"Expected exporter name must be a non-empty string\");\n  }\n\n  const candidates = registrations.exporters.filter(\n    (entry) => normalizeSdkIdentifier(entry.exporter) === expectedExporter,\n  );\n  const exporter = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!exporter) {\n    const available = sortedUnique(registrations.exporters.map((entry) => entry.exporter));\n    throw new Error(\n      `Expected exporter \"${expectedExporter}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available exporters: ${formatAvailable(available)}`,\n    );\n  }\n\n  return exporter;\n}\n\n/**\n * Assert that an activated extension registration registry contains a custom\n * item field definition (optionally scoped to a specific extension).\n */\nexport function assertRegisteredItemField(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredItemFieldExpectation,\n): RegisteredItemFieldAssertion {\n  const expectedField = normalizeSdkIdentifier(expectation.field);\n  if (expectedField.length === 0) {\n    throw new Error(\"Expected item field name must be a non-empty string\");\n  }\n\n  const candidates = registrations.item_fields\n    .filter((entry) => expectation.extensionName === undefined || entry.name === expectation.extensionName)\n    .map((registration) => ({\n      registration,\n      field: registration.fields.find((field) => normalizeSdkIdentifier(field.name) === expectedField),\n    }))\n    .filter((entry): entry is RegisteredItemFieldAssertion => entry.field !== undefined);\n\n  const match = candidates.find((entry) => expectation.type === undefined || entry.field.type === expectation.type);\n  if (!match) {\n    const available = sortedUnique(\n      registrations.item_fields.flatMap((entry) => entry.fields.map((field) => `${field.name}:${field.type}`)),\n    );\n    throw new Error(\n      `Expected item field \"${expectedField}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available item fields: ${formatAvailable(available)}`,\n    );\n  }\n\n  return match;\n}\n\n/**\n * Assert that an activated extension registration registry contains a custom\n * item type definition (optionally scoped to a specific extension).\n */\nexport function assertRegisteredItemType(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredItemTypeExpectation,\n): RegisteredItemTypeAssertion {\n  const expectedType = normalizeSdkIdentifier(expectation.itemType);\n  if (expectedType.length === 0) {\n    throw new Error(\"Expected item type name must be a non-empty string\");\n  }\n\n  const candidates = registrations.item_types\n    .filter((entry) => expectation.extensionName === undefined || entry.name === expectation.extensionName)\n    .map((registration) => ({\n      registration,\n      itemType: registration.types.find((itemType) => normalizeSdkIdentifier(itemType.name) === expectedType),\n    }))\n    .filter((entry): entry is RegisteredItemTypeAssertion => entry.itemType !== undefined);\n\n  const match = candidates.find((entry) => expectation.folder === undefined || entry.itemType.folder === expectation.folder);\n  if (!match) {\n    const available = sortedUnique(\n      registrations.item_types.flatMap((entry) => entry.types.map((itemType) => `${itemType.name}:${itemType.folder}`)),\n    );\n    throw new Error(\n      `Expected item type \"${expectedType}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available item types: ${formatAvailable(available)}`,\n    );\n  }\n\n  return match;\n}\n"],"names":[],"mappings":"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","debugId":"ad18423f-8581-56aa-a065-70561c5bcd5d"}
+{"version":3,"file":"testing.js","sources":["sdk/testing.ts"],"sourceRoot":"/","sourcesContent":["import type {\n  ExtensionActivationResult,\n  ExtensionCapability,\n  ExtensionCommandRegistry,\n  ExtensionGovernancePolicy,\n  ExtensionHookRegistry,\n  ExtensionLayer,\n  ExtensionManifest,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  FlagDefinition,\n  OutputRendererFormat,\n  RegisteredExtensionCommandDefinition,\n  RegisteredExtensionCommandOverride,\n  RegisteredExtensionExporter,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionParserOverride,\n  RegisteredExtensionPreflightOverride,\n  RegisteredExtensionRendererOverride,\n  RegisteredExtensionSchemaFieldDefinitions,\n  RegisteredExtensionSchemaItemTypeDefinitions,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionVectorStoreAdapter,\n  SchemaFieldDefinition,\n  SchemaItemTypeDefinition,\n} from \"../core/extensions/loader.js\";\nimport { activateExtensions } from \"../core/extensions/loader.js\";\nimport { createDefaultExtensionGovernancePolicy } from \"../core/extensions/extension-types.js\";\nimport type { PmPackageManifest, PmPackageResourceKind } from \"../core/packages/manifest.js\";\n\ninterface TestExtensionModule {\n  manifest?: Partial<ExtensionManifest>;\n  activate?: unknown;\n  default?: TestExtensionModule;\n}\n\nexport interface ActivateExtensionForTestOptions {\n  name?: string;\n  layer?: ExtensionLayer;\n  capabilities?: readonly ExtensionCapability[];\n  policy?: ExtensionGovernancePolicy;\n}\n\nexport interface RegisteredCommandContractExpectation {\n  command: string;\n  action?: string;\n  extensionName?: string;\n  arguments?: string[];\n  flags?: string[];\n}\n\nexport interface RegisteredCommandContractAssertion {\n  command: RegisteredExtensionCommandDefinition;\n  flags: FlagDefinition[];\n}\n\n/**\n * Public hook lifecycle kinds an extension can register through `api.hooks.*`.\n */\nexport type RegisteredHookKind = \"before_command\" | \"after_command\" | \"on_read\" | \"on_write\" | \"on_index\";\n\nconst HOOK_KIND_TO_REGISTRY_FIELD: Record<RegisteredHookKind, keyof ExtensionHookRegistry> = {\n  before_command: \"beforeCommand\",\n  after_command: \"afterCommand\",\n  on_read: \"onRead\",\n  on_write: \"onWrite\",\n  on_index: \"onIndex\",\n};\n\nexport interface RegisteredHookExpectation {\n  kind: RegisteredHookKind;\n  extensionName?: string;\n}\n\nexport interface RegisteredSearchProviderExpectation {\n  provider: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredVectorStoreAdapterExpectation {\n  adapter: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredImporterExpectation {\n  importer: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredExporterExpectation {\n  exporter: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredItemFieldExpectation {\n  field: string;\n  extensionName?: string;\n  type?: SchemaFieldDefinition[\"type\"];\n}\n\nexport interface RegisteredItemFieldAssertion {\n  registration: RegisteredExtensionSchemaFieldDefinitions;\n  field: SchemaFieldDefinition;\n}\n\nexport interface RegisteredItemTypeExpectation {\n  itemType: string;\n  extensionName?: string;\n  folder?: string;\n}\n\nexport interface RegisteredItemTypeAssertion {\n  registration: RegisteredExtensionSchemaItemTypeDefinitions;\n  itemType: SchemaItemTypeDefinition;\n}\n\nexport interface RegisteredCommandOverrideExpectation {\n  command: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredParserOverrideExpectation {\n  command: string;\n  extensionName?: string;\n}\n\nexport interface RegisteredPreflightOverrideExpectation {\n  extensionName?: string;\n}\n\nexport interface RegisteredRendererOverrideExpectation {\n  format: OutputRendererFormat;\n  extensionName?: string;\n}\n\nexport type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;\n\nexport interface PackageManifestExpectation {\n  packageName?: string;\n  aliases?: readonly string[];\n  resources?: PackageManifestResourceExpectation;\n}\n\nfunction normalizeSdkIdentifier(value: string): string {\n  return value.trim().toLowerCase();\n}\n\nfunction extensionNameSuffix(extensionName: string | undefined): string {\n  return extensionName ? ` from extension \"${extensionName}\"` : \"\";\n}\n\nfunction sortedUnique(values: readonly string[]): string[] {\n  return [...new Set(values)].sort((left, right) => left.localeCompare(right));\n}\n\nfunction normalizeSdkCommandName(command: string): string {\n  return command\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/)\n    .filter((part) => part.length > 0)\n    .join(\" \");\n}\n\nfunction formatAvailable(values: readonly string[]): string {\n  return values.length > 0 ? values.join(\", \") : \"(none)\";\n}\n\nfunction assertStringSetIncludes(\n  actual: readonly string[] | undefined,\n  expected: readonly string[],\n  label: string,\n): void {\n  const actualValues = new Set(actual ?? []);\n  const missing = sortedUnique(expected.filter((value) => !actualValues.has(value)));\n  if (missing.length > 0) {\n    throw new Error(\n      `Expected package manifest ${label} to include ${missing.join(\", \")}; available: ${formatAvailable(\n        sortedUnique(actual ?? []),\n      )}`,\n    );\n  }\n}\n\nfunction collectFlagLabels(flags: readonly FlagDefinition[]): Set<string> {\n  const labels = new Set<string>();\n  for (const flag of flags) {\n    if (typeof flag.long === \"string\" && flag.long.trim().length > 0) {\n      labels.add(flag.long.trim());\n    }\n    if (typeof flag.short === \"string\" && flag.short.trim().length > 0) {\n      labels.add(flag.short.trim());\n    }\n  }\n  return labels;\n}\n\nfunction readTestExtensionManifest(module: unknown): Partial<ExtensionManifest> {\n  if (module && typeof module === \"object\") {\n    const testModule = module as TestExtensionModule;\n    const manifest = testModule.manifest;\n    if (manifest && typeof manifest === \"object\") {\n      return manifest;\n    }\n    const defaultExport = testModule.default;\n    const defaultManifest = defaultExport?.manifest;\n    if (defaultManifest && typeof defaultManifest === \"object\") {\n      return defaultManifest;\n    }\n    if (defaultExport && typeof defaultExport === \"object\" && (\"name\" in defaultExport || \"capabilities\" in defaultExport)) {\n      return defaultExport as Partial<ExtensionManifest>;\n    }\n    if (\"name\" in testModule || \"capabilities\" in testModule) {\n      return testModule as Partial<ExtensionManifest>;\n    }\n  }\n  return {};\n}\n\nfunction readTestExtensionCapabilities(\n  manifest: Partial<ExtensionManifest>,\n  options: ActivateExtensionForTestOptions,\n): ExtensionCapability[] {\n  if (Array.isArray(options.capabilities)) {\n    return [...options.capabilities];\n  }\n  if (Array.isArray(manifest.capabilities)) {\n    return manifest.capabilities.filter((capability): capability is ExtensionCapability => typeof capability === \"string\");\n  }\n  return [];\n}\n\n/**\n * Activate one in-memory extension module for package tests.\n *\n * This uses pm's real registration validation and activation engine while\n * avoiding private loader imports, filesystem manifests, or workspace setup.\n */\nexport async function activateExtensionForTest(\n  module: unknown,\n  options: ActivateExtensionForTestOptions = {},\n): Promise<ExtensionActivationResult> {\n  const manifest = readTestExtensionManifest(module);\n  const name =\n    options.name ??\n    (typeof manifest.name === \"string\" && manifest.name.trim().length > 0 ? manifest.name.trim() : \"test-extension\");\n  const layer = options.layer ?? \"project\";\n  const capabilities = readTestExtensionCapabilities(manifest, options);\n\n  return activateExtensions({\n    disabled_by_flag: false,\n    roots: { global: \"\", project: \"\" },\n    configured_enabled: [],\n    configured_disabled: [],\n    discovered: [],\n    effective: [],\n    warnings: [],\n    policy: options.policy ?? createDefaultExtensionGovernancePolicy(),\n    failed: [],\n    loaded: [\n      {\n        layer,\n        directory: \"\",\n        manifest_path: \"\",\n        name,\n        version: typeof manifest.version === \"string\" ? manifest.version : \"0.0.0\",\n        entry: typeof manifest.entry === \"string\" ? manifest.entry : \"./index.js\",\n        priority: typeof manifest.priority === \"number\" ? manifest.priority : 0,\n        entry_path: \"\",\n        capabilities,\n        manifest_version: typeof manifest.manifest_version === \"number\" ? manifest.manifest_version : undefined,\n        pm_min_version: typeof manifest.pm_min_version === \"string\" ? manifest.pm_min_version : undefined,\n        pm_max_version: typeof manifest.pm_max_version === \"string\" ? manifest.pm_max_version : undefined,\n        engines: manifest.engines,\n        trusted: manifest.trusted,\n        provenance: manifest.provenance,\n        sandbox_profile: manifest.sandbox_profile,\n        permissions: manifest.permissions,\n        activation: manifest.activation,\n        module,\n      },\n    ],\n  });\n}\n\n/**\n * Assert that a normalized package manifest advertises expected package\n * resources. Pair with `readPmPackageManifest(packageRoot)` in package tests.\n */\nexport function assertPackageManifest(\n  manifest: PmPackageManifest,\n  expectation: PackageManifestExpectation,\n): PmPackageManifest {\n  if (expectation.packageName !== undefined && manifest.package_name !== expectation.packageName) {\n    throw new Error(\n      `Expected package manifest package_name to be \"${expectation.packageName}\"; received \"${\n        manifest.package_name ?? \"(none)\"\n      }\"`,\n    );\n  }\n  if (expectation.aliases !== undefined) {\n    assertStringSetIncludes(manifest.aliases, expectation.aliases, \"aliases\");\n  }\n  if (expectation.resources !== undefined) {\n    for (const [kind, expectedPaths] of Object.entries(expectation.resources) as Array<\n      [PmPackageResourceKind, readonly string[]]\n    >) {\n      assertStringSetIncludes(manifest.resources[kind], expectedPaths, `pm.${kind}`);\n    }\n  }\n  return manifest;\n}\n\n/**\n * Assert that an activated extension registration registry contains a command\n * contract with the expected public metadata.\n */\nexport function assertRegisteredCommandContract(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredCommandContractExpectation,\n): RegisteredCommandContractAssertion {\n  const expectedCommand = normalizeSdkCommandName(expectation.command);\n  if (expectedCommand.length === 0) {\n    throw new Error(\"Expected command name must be a non-empty string\");\n  }\n\n  const commandCandidates = registrations.commands.filter((entry) => entry.command === expectedCommand);\n  const command = expectation.extensionName\n    ? commandCandidates.find((entry) => entry.name === expectation.extensionName)\n    : commandCandidates[0];\n  if (!command) {\n    const available = registrations.commands.map((entry) => entry.command).sort((left, right) => left.localeCompare(right));\n    const extensionSuffix = expectation.extensionName ? ` from extension \"${expectation.extensionName}\"` : \"\";\n    throw new Error(\n      `Expected extension command \"${expectedCommand}\"${extensionSuffix} to be registered. Available commands: ${formatAvailable(\n        available,\n      )}`,\n    );\n  }\n\n  if (expectation.action !== undefined && command.action !== expectation.action) {\n    throw new Error(\n      `Expected extension command \"${expectedCommand}\" action \"${expectation.action}\", received \"${command.action}\"`,\n    );\n  }\n\n  if (expectation.arguments !== undefined) {\n    const actualArguments = (command.arguments ?? []).map((argument) => argument.name);\n    const missingArguments = expectation.arguments.filter((argument) => !actualArguments.includes(argument));\n    if (missingArguments.length > 0) {\n      throw new Error(\n        `Expected extension command \"${expectedCommand}\" arguments ${formatAvailable(\n          expectation.arguments,\n        )}; missing ${formatAvailable(missingArguments)}; available ${formatAvailable(actualArguments)}`,\n      );\n    }\n  }\n\n  const flags = registrations.flags\n    .filter(\n      (entry) =>\n        entry.target_command === expectedCommand &&\n        (expectation.extensionName === undefined || entry.name === expectation.extensionName),\n    )\n    .flatMap((entry) => entry.flags);\n\n  if (expectation.flags !== undefined) {\n    const actualFlagLabels = collectFlagLabels(flags);\n    const missingFlags = expectation.flags.filter((flag) => !actualFlagLabels.has(flag));\n    if (missingFlags.length > 0) {\n      throw new Error(\n        `Expected extension command \"${expectedCommand}\" flags ${formatAvailable(expectation.flags)}; missing ${formatAvailable(\n          missingFlags,\n        )}; available ${formatAvailable([...actualFlagLabels].sort((left, right) => left.localeCompare(right)))}`,\n      );\n    }\n  }\n\n  return { command, flags };\n}\n\n/**\n * Assert that an activated extension hook registry contains a hook of the\n * expected lifecycle kind (optionally scoped to a specific extension).\n *\n * Hooks are surfaced via `ExtensionActivationResult.hooks`, not the command\n * registration registry, so this helper accepts an `ExtensionHookRegistry`.\n */\nexport function assertRegisteredHook<TKind extends RegisteredHookKind>(\n  hooks: ExtensionHookRegistry,\n  expectation: RegisteredHookExpectation & { kind: TKind },\n): ExtensionHookRegistry[(typeof HOOK_KIND_TO_REGISTRY_FIELD)[TKind]][number] {\n  const field = HOOK_KIND_TO_REGISTRY_FIELD[expectation.kind];\n  const candidates = hooks[field] as ReadonlyArray<RegisteredExtensionHook<unknown>>;\n  const hook = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!hook) {\n    const available = sortedUnique(candidates.map((entry) => entry.name));\n    throw new Error(\n      `Expected a \"${expectation.kind}\" hook${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available \"${expectation.kind}\" hooks: ${formatAvailable(available)}`,\n    );\n  }\n\n  return hook as ExtensionHookRegistry[(typeof HOOK_KIND_TO_REGISTRY_FIELD)[TKind]][number];\n}\n\n/**\n * Assert that an activated extension registration registry contains a search\n * provider with the expected name (optionally scoped to a specific extension).\n */\nexport function assertRegisteredSearchProvider(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredSearchProviderExpectation,\n): RegisteredExtensionSearchProvider {\n  const expectedProvider = normalizeSdkIdentifier(expectation.provider);\n  if (expectedProvider.length === 0) {\n    throw new Error(\"Expected search provider name must be a non-empty string\");\n  }\n\n  const candidates = registrations.search_providers.filter(\n    (entry) => normalizeSdkIdentifier(entry.definition.name) === expectedProvider,\n  );\n  const provider = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!provider) {\n    const available = sortedUnique(registrations.search_providers.map((entry) => entry.definition.name));\n    throw new Error(\n      `Expected search provider \"${expectedProvider}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available search providers: ${formatAvailable(available)}`,\n    );\n  }\n\n  return provider;\n}\n\n/**\n * Assert that an activated extension registration registry contains a vector\n * store adapter with the expected name (optionally scoped to a specific\n * extension).\n */\nexport function assertRegisteredVectorStoreAdapter(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredVectorStoreAdapterExpectation,\n): RegisteredExtensionVectorStoreAdapter {\n  const expectedAdapter = normalizeSdkIdentifier(expectation.adapter);\n  if (expectedAdapter.length === 0) {\n    throw new Error(\"Expected vector store adapter name must be a non-empty string\");\n  }\n\n  const candidates = registrations.vector_store_adapters.filter(\n    (entry) => normalizeSdkIdentifier(entry.definition.name) === expectedAdapter,\n  );\n  const adapter = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!adapter) {\n    const available = sortedUnique(registrations.vector_store_adapters.map((entry) => entry.definition.name));\n    throw new Error(\n      `Expected vector store adapter \"${expectedAdapter}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available vector store adapters: ${formatAvailable(available)}`,\n    );\n  }\n\n  return adapter;\n}\n\n/**\n * Assert that an activated extension registration registry contains an importer\n * for the expected format/name (optionally scoped to a specific extension).\n */\nexport function assertRegisteredImporter(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredImporterExpectation,\n): RegisteredExtensionImporter {\n  const expectedImporter = normalizeSdkIdentifier(expectation.importer);\n  if (expectedImporter.length === 0) {\n    throw new Error(\"Expected importer name must be a non-empty string\");\n  }\n\n  const candidates = registrations.importers.filter(\n    (entry) => normalizeSdkIdentifier(entry.importer) === expectedImporter,\n  );\n  const importer = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!importer) {\n    const available = sortedUnique(registrations.importers.map((entry) => entry.importer));\n    throw new Error(\n      `Expected importer \"${expectedImporter}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available importers: ${formatAvailable(available)}`,\n    );\n  }\n\n  return importer;\n}\n\n/**\n * Assert that an activated extension registration registry contains an exporter\n * for the expected format/name (optionally scoped to a specific extension).\n */\nexport function assertRegisteredExporter(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredExporterExpectation,\n): RegisteredExtensionExporter {\n  const expectedExporter = normalizeSdkIdentifier(expectation.exporter);\n  if (expectedExporter.length === 0) {\n    throw new Error(\"Expected exporter name must be a non-empty string\");\n  }\n\n  const candidates = registrations.exporters.filter(\n    (entry) => normalizeSdkIdentifier(entry.exporter) === expectedExporter,\n  );\n  const exporter = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!exporter) {\n    const available = sortedUnique(registrations.exporters.map((entry) => entry.exporter));\n    throw new Error(\n      `Expected exporter \"${expectedExporter}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available exporters: ${formatAvailable(available)}`,\n    );\n  }\n\n  return exporter;\n}\n\n/**\n * Assert that an activated extension registration registry contains a custom\n * item field definition (optionally scoped to a specific extension).\n */\nexport function assertRegisteredItemField(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredItemFieldExpectation,\n): RegisteredItemFieldAssertion {\n  const expectedField = normalizeSdkIdentifier(expectation.field);\n  if (expectedField.length === 0) {\n    throw new Error(\"Expected item field name must be a non-empty string\");\n  }\n\n  const candidates = registrations.item_fields\n    .filter((entry) => expectation.extensionName === undefined || entry.name === expectation.extensionName)\n    .map((registration) => ({\n      registration,\n      field: registration.fields.find((field) => normalizeSdkIdentifier(field.name) === expectedField),\n    }))\n    .filter((entry): entry is RegisteredItemFieldAssertion => entry.field !== undefined);\n\n  const match = candidates.find((entry) => expectation.type === undefined || entry.field.type === expectation.type);\n  if (!match) {\n    const available = sortedUnique(\n      registrations.item_fields.flatMap((entry) => entry.fields.map((field) => `${field.name}:${field.type}`)),\n    );\n    throw new Error(\n      `Expected item field \"${expectedField}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available item fields: ${formatAvailable(available)}`,\n    );\n  }\n\n  return match;\n}\n\n/**\n * Assert that an activated extension registration registry contains a custom\n * item type definition (optionally scoped to a specific extension).\n */\nexport function assertRegisteredItemType(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredItemTypeExpectation,\n): RegisteredItemTypeAssertion {\n  const expectedType = normalizeSdkIdentifier(expectation.itemType);\n  if (expectedType.length === 0) {\n    throw new Error(\"Expected item type name must be a non-empty string\");\n  }\n\n  const candidates = registrations.item_types\n    .filter((entry) => expectation.extensionName === undefined || entry.name === expectation.extensionName)\n    .map((registration) => ({\n      registration,\n      itemType: registration.types.find((itemType) => normalizeSdkIdentifier(itemType.name) === expectedType),\n    }))\n    .filter((entry): entry is RegisteredItemTypeAssertion => entry.itemType !== undefined);\n\n  const match = candidates.find((entry) => expectation.folder === undefined || entry.itemType.folder === expectation.folder);\n  if (!match) {\n    const available = sortedUnique(\n      registrations.item_types.flatMap((entry) => entry.types.map((itemType) => `${itemType.name}:${itemType.folder}`)),\n    );\n    throw new Error(\n      `Expected item type \"${expectedType}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available item types: ${formatAvailable(available)}`,\n    );\n  }\n\n  return match;\n}\n\n/**\n * Assert that an activated extension command registry contains a command\n * override registered via `api.registerCommand(command, override)` (optionally\n * scoped to a specific extension).\n *\n * Command overrides are surfaced via `ExtensionActivationResult.commands`, not\n * the command registration registry, so this helper accepts an\n * `ExtensionCommandRegistry`.\n */\nexport function assertRegisteredCommandOverride(\n  commands: ExtensionCommandRegistry,\n  expectation: RegisteredCommandOverrideExpectation,\n): RegisteredExtensionCommandOverride {\n  const expectedCommand = normalizeSdkCommandName(expectation.command);\n  if (expectedCommand.length === 0) {\n    throw new Error(\"Expected command name must be a non-empty string\");\n  }\n\n  const candidates = commands.overrides.filter((entry) => entry.command === expectedCommand);\n  const override = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!override) {\n    const available = sortedUnique(commands.overrides.map((entry) => entry.command));\n    throw new Error(\n      `Expected command override \"${expectedCommand}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available command overrides: ${formatAvailable(available)}`,\n    );\n  }\n\n  return override;\n}\n\n/**\n * Assert that an activated extension parser registry contains a parser override\n * registered via `api.registerParser(command, override)` (optionally scoped to\n * a specific extension).\n *\n * Parser overrides are surfaced via `ExtensionActivationResult.parsers`, not the\n * command registration registry, so this helper accepts an\n * `ExtensionParserRegistry`.\n */\nexport function assertRegisteredParserOverride(\n  parsers: ExtensionParserRegistry,\n  expectation: RegisteredParserOverrideExpectation,\n): RegisteredExtensionParserOverride {\n  const expectedCommand = normalizeSdkCommandName(expectation.command);\n  if (expectedCommand.length === 0) {\n    throw new Error(\"Expected command name must be a non-empty string\");\n  }\n\n  const candidates = parsers.overrides.filter((entry) => entry.command === expectedCommand);\n  const override = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!override) {\n    const available = sortedUnique(parsers.overrides.map((entry) => entry.command));\n    throw new Error(\n      `Expected parser override \"${expectedCommand}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available parser overrides: ${formatAvailable(available)}`,\n    );\n  }\n\n  return override;\n}\n\n/**\n * Assert that an activated extension preflight registry contains a preflight\n * override registered via `api.registerPreflight(override)` (optionally scoped\n * to a specific extension).\n *\n * Preflight overrides are global (they run for every command and carry no\n * `command` field), so the expectation only accepts an optional\n * `extensionName`. Preflight overrides are surfaced via\n * `ExtensionActivationResult.preflight`.\n */\nexport function assertRegisteredPreflightOverride(\n  preflight: ExtensionPreflightRegistry,\n  expectation: RegisteredPreflightOverrideExpectation = {},\n): RegisteredExtensionPreflightOverride {\n  const override = expectation.extensionName\n    ? preflight.overrides.find((entry) => entry.name === expectation.extensionName)\n    : preflight.overrides[0];\n  if (!override) {\n    const available = sortedUnique(preflight.overrides.map((entry) => entry.name));\n    throw new Error(\n      `Expected a preflight override${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available preflight overrides: ${formatAvailable(available)}`,\n    );\n  }\n\n  return override;\n}\n\n/**\n * Assert that an activated extension renderer registry contains a renderer\n * override registered via `api.registerRenderer(format, renderer)` for the\n * expected output format (optionally scoped to a specific extension).\n *\n * Renderer overrides are surfaced via `ExtensionActivationResult.renderers`.\n */\nexport function assertRegisteredRendererOverride(\n  renderers: ExtensionRendererRegistry,\n  expectation: RegisteredRendererOverrideExpectation,\n): RegisteredExtensionRendererOverride {\n  const expectedFormat = normalizeSdkIdentifier(expectation.format);\n  if (expectedFormat.length === 0) {\n    throw new Error(\"Expected renderer format must be a non-empty string\");\n  }\n\n  const candidates = renderers.overrides.filter((entry) => entry.format === expectedFormat);\n  const override = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!override) {\n    const available = sortedUnique(renderers.overrides.map((entry) => entry.format));\n    throw new Error(\n      `Expected renderer override \"${expectedFormat}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available renderer overrides: ${formatAvailable(available)}`,\n    );\n  }\n\n  return override;\n}\n"],"names":[],"mappings":"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","debugId":"43b78d54-eeb1-571e-8e88-e67b2432cfd6"}

package/docs/EXTENSIONS.md

@@ -102,8 +102,10 @@ Current resource kinds are:
 - `extensions`
 - `docs`
 - `examples`
+- `assets`
+- `prompts`
 
-Installation activates `pm.extensions`. `pm.docs` and `pm.examples` are catalog metadata. Agent-specific assets such as prompts, skills, or MCP servers should live in agent adapter packages, not in the core `pm` package contract.
+Installation activates `pm.extensions`. `pm.docs`, `pm.examples`, `pm.assets`, and `pm.prompts` are catalog metadata (metadata-only — they are discovered and surfaced in the catalog but not executed). Declare agent-facing prompt/slash-command markdown under `pm.prompts` and non-code assets (images, skills, fixtures) under `pm.assets`; their conventional roots are `prompts/` (also `.agents/pm/prompts/`) and `assets/` (also `.agents/pm/assets/`).
 
 `pm package init` emits a root extension (`"extensions": ["."]`) so local package installs can activate without dependency bootstrapping. Larger packages may point at nested extension directories after declaring runtime dependencies and validating with `pm package doctor`.
 
@@ -288,9 +290,10 @@ import { defineExtension } from "@unbrained/pm-cli/sdk";
 
 Common APIs:
 
+- `api.extension` is a read-only identity (`name`, `layer`, `version`, `capabilities`, `pm_min_version?`, `pm_max_version?`, `source_package?`) for self-identifying logs and version gating without re-reading the manifest.
 - `api.registerCommand(definition)` adds package-owned commands.
-- `api.registerFlags(command, flags)` adds runtime command flags.
-- `api.registerItemFields(fields)` adds custom metadata fields. Agents can set declared fields with repeatable `pm create --field name=value` and `pm update <id> --field name=value`; undeclared names are rejected.
+- `api.registerFlags(command, flags)` adds runtime command flags. A flag may declare `value_type` (canonical; the legacy `type` alias is honored only when `value_type` is absent), `list: true` to accumulate repeated/comma-joined values like core `--tags`, and a `default` applied when the flag is omitted.
+- `api.registerItemFields(fields)` adds custom metadata fields. Agents can set declared fields with repeatable `pm create --field name=value` and `pm update <id> --field name=value`; undeclared names are rejected. Each field `type` is validated against `string | number | boolean | array | object` at activation, with a did-you-mean hint on typos.
 - `api.registerItemTypes(types)` adds custom item types.
 - `api.registerMigration(definition)` adds schema migrations.
 - `api.registerService("output_format", handler)` customizes output formatting through the service override API. Return `context.payload`, `null`, or `undefined` for commands the extension does not own.
@@ -300,6 +303,7 @@ Common APIs:
   item entries for mutations, including `previous_status`, `status`,
   `changed_fields`, and partial `previous`/`current` front matter snapshots.
   `onWrite` always includes `path`, `scope`, and `op`; item mutations also add optional `item_id`, `item_type`, `before`, `after`, and `changed_fields`.
+- An optional module-level `deactivate()` export (VS Code-style) is invoked by the host on shutdown/reload — including by the long-running MCP server between native-action requests — to close connections, clear timers, and release resources opened during `activate`. Teardown is best-effort and never blocks other extensions.
 
 The bundled `pm-lifecycle-hooks` package is the hook exemplar: it declares only
 `hooks` and registers a default-inert `afterCommand` hook so authors can copy a

package/docs/SDK.md

@@ -68,6 +68,10 @@ Testing helper exports (also under `@unbrained/pm-cli/sdk/testing`):
 - `activateExtensionForTest`
 - `assertPackageManifest`
 - `assertRegisteredCommandContract`
+- `assertRegisteredCommandOverride`
+- `assertRegisteredParserOverride`
+- `assertRegisteredPreflightOverride`
+- `assertRegisteredRendererOverride`
 - `assertRegisteredHook`
 - `assertRegisteredSearchProvider`
 - `assertRegisteredImporter`
@@ -259,6 +263,80 @@ Manifest typing also accepts optional `engines` metadata:
 
 Use `pm_min_version` for the loader gate. Keep `engines` as package-manager and tooling metadata.
 
+## Self-Identity and Lifecycle
+
+`activate(api)` receives a read-only `api.extension` describing the extension it
+was created for, so authors can emit self-identifying logs, gate on their own
+version, and build better error messages without re-reading the manifest:
+
+```ts
+export default defineExtension({
+  activate(api) {
+    // api.extension: { name, layer, version, capabilities, pm_min_version?, pm_max_version?, source_package? }
+    if (api.extension.version.startsWith("0.")) {
+      api.hooks.afterCommand(() => {
+        // ...pre-1.0 behaviour, labelled with api.extension.name
+      });
+    }
+  },
+});
+```
+
+`api.extension.capabilities` is filtered to the canonical capability set, and both
+the object and its `capabilities` array are frozen.
+
+Modules may also export an optional VS Code-style `deactivate` teardown hook. The
+host runs it on shutdown/reload — the long-running MCP server invokes it between
+native-action requests — so an extension can close connections, clear timers, and
+release buffers opened during `activate`. `deactivate` runs only for extensions
+that activated successfully (a failed `activate` never fully initialized), and
+teardowns run concurrently. Teardown is best-effort: a throwing `deactivate` is
+recorded as a warning, never propagated, so one extension cannot block another's
+cleanup.
+
+```ts
+export default defineExtension({
+  activate(api) {
+    /* open resources */
+  },
+  async deactivate() {
+    /* close connections, flush sinks, clear timers */
+  },
+});
+```
+
+## Flag Contracts
+
+`FlagDefinition` (used by `registerFlags` and inline command `flags`) supports the
+same list/default semantics as core flags:
+
+- `value_type` is the canonical coercion kind (`string` | `number` | `boolean`;
+  the aliases `int`/`integer`/`float` and `bool` are also accepted). The
+  deprecated `type` alias is still read, but `value_type` wins when both are set
+  (`value_type ?? type`). An unrecognized value type is rejected at registration.
+- `list: true` makes a repeated, comma-joined flag accumulate into an array —
+  parity with core list flags such as `--tags`. `--scope a,b --scope c` resolves
+  to `["a", "b", "c"]`, with each element coerced by `value_type`.
+- `default` (a scalar, or an array of scalars for a `list` flag) is applied when
+  the flag is omitted; for a `list` flag the default is flattened into the
+  accumulated array exactly like a provided value — comma-joined strings (e.g.
+  `default: "a,b"` or `default: ["a,b", "c"]`) are split into elements. A default
+  that would not cleanly coerce under the declared `value_type` (e.g.
+  `value_type: "number", default: "abc"`) is rejected at registration.
+
+```ts
+api.registerFlags("report", [
+  { long: "--scope", value_type: "string", list: true, default: "all" },
+  { long: "--limit", value_type: "number", default: 20 },
+]);
+```
+
+`registerItemFields` validates each declared field `type` against the canonical
+coercion kinds (`string`, `number`, `boolean`, `array`, `object`) at activation.
+A typo fails activation with a did-you-mean hint (e.g. `type: "strnig"` →
+`Did you mean "string"?`) instead of silently passing and failing opaquely at use
+time.
+
 ## Expected CLI Errors
 
 Package commands should throw expected user/action errors with the public SDK shape so the CLI can preserve exit codes and Sentry can filter expected retry failures:
@@ -408,6 +486,26 @@ const hook = assertRegisteredHook(activation.hooks, {
 // hook.run is the registered OnWriteHook handler
 ```
 
+Override registrations from `registerCommand(command, override)`, `registerParser`,
+`registerPreflight`, and `registerRenderer` live on `activation.commands`,
+`activation.parsers`, `activation.preflight`, and `activation.renderers` (not the
+registration registry). Each override helper takes the matching registry and
+returns the registered entry (so you can invoke `entry.run` directly):
+
+```ts
+import {
+  assertRegisteredCommandOverride,
+  assertRegisteredParserOverride,
+  assertRegisteredPreflightOverride,
+  assertRegisteredRendererOverride,
+} from "@unbrained/pm-cli/sdk/testing";
+
+assertRegisteredCommandOverride(activation.commands, { command: "list" });
+assertRegisteredParserOverride(activation.parsers, { command: "list", extensionName: "my-ext" });
+assertRegisteredPreflightOverride(activation.preflight); // preflight overrides are global (no command)
+assertRegisteredRendererOverride(activation.renderers, { format: "toon" });
+```
+
 The bundled `pm-lifecycle-hooks` package is the first-party hooks exemplar. It
 declares only the `hooks` capability and registers a default-inert `afterCommand`
 hook, so package authors can copy a lifecycle pattern that does not write files,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.6.8",
+  "version": "2026.6.9",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "author": "unbrained",

package/dist/cli-bundle/chunks/activity-A3QKFSSF.js

@@ -1,16 +0,0 @@
-import {
-  runActivity
-} from "./chunk-UEXNNF3K.js";
-import "./chunk-2YPVCD7T.js";
-import "./chunk-MSH23UWO.js";
-import "./chunk-FGRJZVXD.js";
-import "./chunk-2HMD3JM2.js";
-import "./chunk-K62SNVVE.js";
-import "./chunk-M7UBTVFT.js";
-import "./chunk-2BYKYPWY.js";
-import "./chunk-QFVASU44.js";
-import "./chunk-3TXWDGPU.js";
-export {
-  runActivity
-};
-//# sourceMappingURL=activity-A3QKFSSF.js.map