@unbrained/pm-cli 2026.5.10 → 2026.5.12

package/dist/core/extensions/extension-types.d.ts

@@ -11,6 +11,65 @@ export declare const EXTENSION_CAPABILITY_CONTRACT: Readonly<{
         [x: string]: "search" | "schema" | "commands" | "renderers" | "hooks" | "importers" | "parser" | "preflight" | "services";
     };
 }>;
+export declare const KNOWN_EXTENSION_POLICY_MODES: readonly ["off", "warn", "enforce"];
+export type ExtensionPolicyMode = (typeof KNOWN_EXTENSION_POLICY_MODES)[number];
+export declare const KNOWN_EXTENSION_TRUST_MODES: readonly ["off", "warn", "enforce"];
+export type ExtensionTrustMode = (typeof KNOWN_EXTENSION_TRUST_MODES)[number];
+export declare const KNOWN_EXTENSION_SANDBOX_PROFILES: readonly ["none", "restricted", "strict"];
+export type ExtensionSandboxProfile = (typeof KNOWN_EXTENSION_SANDBOX_PROFILES)[number];
+export declare const KNOWN_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 type ExtensionPolicySurface = (typeof KNOWN_EXTENSION_POLICY_SURFACES)[number];
+export interface ExtensionProvenanceMetadata {
+    source?: string;
+    signature?: string;
+    attestation?: string;
+    verified?: boolean;
+}
+export interface ExtensionRuntimePermissionDeclaration {
+    fs_read?: boolean;
+    fs_write?: boolean;
+    network?: boolean;
+    env_read?: boolean;
+    env_write?: boolean;
+    process_spawn?: boolean;
+}
+export interface ExtensionPolicyOverride {
+    name: string;
+    disabled?: boolean;
+    require_trusted?: boolean;
+    require_provenance?: boolean;
+    sandbox_profile?: ExtensionSandboxProfile;
+    allowed_capabilities?: string[];
+    blocked_capabilities?: string[];
+    allowed_surfaces?: string[];
+    blocked_surfaces?: string[];
+    allowed_commands?: string[];
+    blocked_commands?: string[];
+    allowed_actions?: string[];
+    blocked_actions?: string[];
+    allowed_services?: string[];
+    blocked_services?: string[];
+}
+export interface ExtensionGovernancePolicy {
+    mode: ExtensionPolicyMode;
+    trust_mode: ExtensionTrustMode;
+    require_provenance: boolean;
+    trusted_extensions: string[];
+    default_sandbox_profile: ExtensionSandboxProfile;
+    allowed_extensions: string[];
+    blocked_extensions: string[];
+    allowed_capabilities: string[];
+    blocked_capabilities: string[];
+    allowed_surfaces: string[];
+    blocked_surfaces: string[];
+    allowed_commands: string[];
+    blocked_commands: string[];
+    allowed_actions: string[];
+    blocked_actions: string[];
+    allowed_services: string[];
+    blocked_services: string[];
+    extension_overrides: ExtensionPolicyOverride[];
+}
 export type ExtensionLayer = "global" | "project";
 export type ExtensionStatus = "ok" | "warn";
 export interface ExtensionManifest {
@@ -19,6 +78,11 @@ export interface ExtensionManifest {
     entry: string;
     priority: number;
     capabilities: string[];
+    manifest_version?: number;
+    trusted?: boolean;
+    provenance?: ExtensionProvenanceMetadata;
+    sandbox_profile?: ExtensionSandboxProfile;
+    permissions?: ExtensionRuntimePermissionDeclaration;
     legacy_capability_aliases?: LegacyExtensionCapabilityAliasMapping[];
 }
 export interface ExtensionDiagnostic {
@@ -42,6 +106,11 @@ export interface EffectiveExtension {
     entry: string;
     priority: number;
     entry_path: string;
+    manifest_version?: number;
+    trusted?: boolean;
+    provenance?: ExtensionProvenanceMetadata;
+    sandbox_profile?: ExtensionSandboxProfile;
+    permissions?: ExtensionRuntimePermissionDeclaration;
     capabilities?: string[];
 }
 export interface ExtensionDiscoveryResult {
@@ -55,6 +124,7 @@ export interface ExtensionDiscoveryResult {
     discovered: ExtensionDiagnostic[];
     effective: EffectiveExtension[];
     warnings: string[];
+    policy: ExtensionGovernancePolicy;
 }
 export interface LoadedExtension extends EffectiveExtension {
     module: unknown;
@@ -558,6 +628,8 @@ export interface DiscoverExtensionsOptions {
     settings: PmSettings;
     cwd?: string;
     noExtensions?: boolean;
+    reload_token?: string;
+    cache_bust?: boolean;
 }
 export interface ActivatableExtension {
     activate: (api: ExtensionApi) => void | Promise<void>;

package/dist/core/extensions/extension-types.js

@@ -19,4 +19,28 @@ export const EXTENSION_CAPABILITY_CONTRACT = Object.freeze({
     capabilities: [...KNOWN_EXTENSION_CAPABILITIES],
     legacy_aliases: { ...EXTENSION_CAPABILITY_LEGACY_ALIASES },
 });
+export const KNOWN_EXTENSION_POLICY_MODES = ["off", "warn", "enforce"];
+export const KNOWN_EXTENSION_TRUST_MODES = ["off", "warn", "enforce"];
+export const KNOWN_EXTENSION_SANDBOX_PROFILES = ["none", "restricted", "strict"];
+export const KNOWN_EXTENSION_POLICY_SURFACES = [
+    "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",
+];
 //# sourceMappingURL=extension-types.js.map

package/dist/core/extensions/extension-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension-types.js","sourceRoot":"/","sources":["core/extensions/extension-types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,UAAU;IACV,WAAW;IACX,OAAO;IACP,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,mCAAmC,GAAkD,MAAM,CAAC,MAAM,CAAC;IAC9G,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,QAAQ;CACrB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,qCAAqC;IAC9C,YAAY,EAAE,CAAC,GAAG,4BAA4B,CAAC;IAC/C,cAAc,EAAE,EAAE,GAAG,mCAAmC,EAAE;CAC3D,CAAC,CAAC","sourcesContent":["import type { ItemDocument, PmSettings } from \"../../types/index.js\";\nimport type { GlobalOptions } from \"../shared/command-types.js\";\n\nexport const KNOWN_EXTENSION_CAPABILITIES = [\n  \"commands\",\n  \"renderers\",\n  \"hooks\",\n  \"schema\",\n  \"importers\",\n  \"search\",\n  \"parser\",\n  \"preflight\",\n  \"services\",\n] as const;\nexport type ExtensionCapability = (typeof KNOWN_EXTENSION_CAPABILITIES)[number];\nexport const EXTENSION_CAPABILITY_CONTRACT_VERSION = 2;\nexport const EXTENSION_CAPABILITY_LEGACY_ALIASES: Readonly<Record<string, ExtensionCapability>> = Object.freeze({\n  migration: \"schema\",\n  validation: \"schema\",\n});\nexport const EXTENSION_CAPABILITY_CONTRACT = Object.freeze({\n  version: EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  capabilities: [...KNOWN_EXTENSION_CAPABILITIES],\n  legacy_aliases: { ...EXTENSION_CAPABILITY_LEGACY_ALIASES },\n});\n\nexport type ExtensionLayer = \"global\" | \"project\";\nexport type ExtensionStatus = \"ok\" | \"warn\";\n\nexport interface ExtensionManifest {\n  name: string;\n  version: string;\n  entry: string;\n  priority: number;\n  capabilities: string[];\n  legacy_capability_aliases?: LegacyExtensionCapabilityAliasMapping[];\n}\n\nexport interface ExtensionDiagnostic {\n  layer: ExtensionLayer;\n  directory: string;\n  manifest_path: string;\n  name: string | null;\n  version: string | null;\n  entry: string | null;\n  priority: number | null;\n  entry_path: string | null;\n  enabled: boolean | null;\n  status: ExtensionStatus;\n}\n\nexport interface EffectiveExtension {\n  layer: ExtensionLayer;\n  directory: string;\n  manifest_path: string;\n  name: string;\n  version: string;\n  entry: string;\n  priority: number;\n  entry_path: string;\n  capabilities?: string[];\n}\n\nexport interface ExtensionDiscoveryResult {\n  disabled_by_flag: boolean;\n  roots: {\n    global: string;\n    project: string;\n  };\n  configured_enabled: string[];\n  configured_disabled: string[];\n  discovered: ExtensionDiagnostic[];\n  effective: EffectiveExtension[];\n  warnings: string[];\n}\n\nexport interface LoadedExtension extends EffectiveExtension {\n  module: unknown;\n}\n\nexport interface FailedExtensionLoad {\n  layer: ExtensionLayer;\n  name: string;\n  entry_path: string;\n  error: string;\n}\n\nexport interface ExtensionLoadResult extends ExtensionDiscoveryResult {\n  loaded: LoadedExtension[];\n  failed: FailedExtensionLoad[];\n}\n\nexport interface BeforeCommandHookContext {\n  command: string;\n  args: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n  pm_root: string;\n}\n\nexport interface AfterCommandHookContext extends BeforeCommandHookContext {\n  ok: boolean;\n  error?: string;\n  result?: unknown;\n}\n\nexport interface OnWriteHookContext {\n  path: string;\n  scope: \"project\" | \"global\";\n  op: string;\n}\n\nexport interface OnReadHookContext {\n  path: string;\n  scope: \"project\" | \"global\";\n}\n\nexport interface OnIndexHookContext {\n  mode: string;\n  total_items?: number;\n}\n\nexport type BeforeCommandHook = (context: BeforeCommandHookContext) => Promise<void> | void;\nexport type AfterCommandHook = (context: AfterCommandHookContext) => Promise<void> | void;\nexport type OnWriteHook = (context: OnWriteHookContext) => Promise<void> | void;\nexport type OnReadHook = (context: OnReadHookContext) => Promise<void> | void;\nexport type OnIndexHook = (context: OnIndexHookContext) => Promise<void> | void;\nexport type OutputRendererFormat = \"toon\" | \"json\";\nexport type CommandOverride = (context: CommandOverrideContext) => unknown;\nexport type RendererOverride = (context: RendererOverrideContext) => string;\nexport type CommandHandler = (context: CommandHandlerContext) => unknown;\nexport type ParserOverride = (context: ParserOverrideContext) => ParserOverrideDelta | Promise<ParserOverrideDelta>;\nexport type PreflightOverride = (context: PreflightOverrideContext) => PreflightOverrideDelta | Promise<PreflightOverrideDelta>;\nexport type ServiceOverride = (context: ServiceOverrideContext) => unknown;\n\nexport interface RegisteredExtensionHook<THook> {\n  layer: ExtensionLayer;\n  name: string;\n  run: THook;\n}\n\nexport interface ExtensionHookRegistry {\n  beforeCommand: Array<RegisteredExtensionHook<BeforeCommandHook>>;\n  afterCommand: Array<RegisteredExtensionHook<AfterCommandHook>>;\n  onWrite: Array<RegisteredExtensionHook<OnWriteHook>>;\n  onRead: Array<RegisteredExtensionHook<OnReadHook>>;\n  onIndex: Array<RegisteredExtensionHook<OnIndexHook>>;\n}\n\nexport interface CommandOverrideContext {\n  command: string;\n  args: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n  pm_root: string;\n  result: unknown;\n}\n\nexport interface RendererOverrideContext {\n  format: OutputRendererFormat;\n  command?: string;\n  args?: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n  pm_root?: string;\n  result: unknown;\n}\n\nexport interface CommandHandlerContext {\n  command: string;\n  args: string[];\n  options: Record<string, unknown>;\n  global: GlobalOptions;\n  pm_root: string;\n}\n\nexport interface ParserOverrideContext extends CommandHandlerContext {}\n\nexport interface ParserOverrideDelta {\n  args?: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n}\n\nexport interface PreflightOverrideContext extends CommandHandlerContext {\n  decision: PreflightRuntimeDecision;\n}\n\nexport interface PreflightRuntimeDecision {\n  enforce_item_format_gate: boolean;\n  run_preflight_item_format_sync: boolean;\n  run_extension_migrations: boolean;\n  enforce_mandatory_migration_gate: boolean;\n}\n\nexport interface PreflightOverrideDelta extends ParserOverrideDelta {\n  enforce_item_format_gate?: boolean;\n  run_preflight_item_format_sync?: boolean;\n  run_extension_migrations?: boolean;\n  enforce_mandatory_migration_gate?: boolean;\n}\n\nexport type ExtensionServiceName =\n  | \"output_format\"\n  | \"error_format\"\n  | \"help_format\"\n  | \"lock_acquire\"\n  | \"lock_release\"\n  | \"history_append\"\n  | \"item_store_write\"\n  | \"item_store_delete\";\n\nexport interface ServiceOverrideContext {\n  service: ExtensionServiceName;\n  command?: string;\n  args?: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n  pm_root?: string;\n  payload: unknown;\n}\n\nexport interface ExtensionCommandArgumentDefinition {\n  name: string;\n  required?: boolean;\n  variadic?: boolean;\n  description?: string;\n}\n\nexport interface CommandDefinition {\n  name: string;\n  run?: CommandHandler;\n  /**\n   * @deprecated Use `run` instead. This alias remains for backward compatibility.\n   */\n  handler?: CommandHandler;\n  action?: string;\n  description?: string;\n  intent?: string;\n  examples?: string[];\n  failure_hints?: string[];\n  arguments?: ExtensionCommandArgumentDefinition[];\n  flags?: FlagDefinition[];\n}\n\nexport type FlagValueType = \"string\" | \"number\" | \"boolean\";\n\nexport interface FlagDefinition {\n  long?: string;\n  short?: string;\n  value_name?: string;\n  description?: string;\n  required?: boolean;\n  enabled?: boolean;\n  visible?: boolean;\n  type?: FlagValueType;\n  value_type?: FlagValueType;\n  [key: string]: unknown;\n}\n\nexport interface SchemaFieldDefinition {\n  name: string;\n  type: string;\n  optional?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface SchemaItemTypeCommandOptionPolicyDefinition {\n  command: string;\n  option: string;\n  enabled?: boolean;\n  required?: boolean;\n  visible?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface SchemaItemTypeOptionDefinition {\n  key: string;\n  values?: string[];\n  required?: boolean;\n  aliases?: string[];\n  [key: string]: unknown;\n}\n\nexport interface SchemaItemTypeDefinition {\n  name: string;\n  folder?: string;\n  aliases?: string[];\n  required_create_fields?: string[];\n  required_create_repeatables?: string[];\n  command_option_policies?: SchemaItemTypeCommandOptionPolicyDefinition[];\n  options?: SchemaItemTypeOptionDefinition[];\n  [key: string]: unknown;\n}\n\nexport interface SchemaMigrationRunContext {\n  id: string;\n  command: \"migration\";\n  layer: ExtensionLayer;\n  extension: string;\n  pm_root: string;\n  status: string;\n}\n\nexport type SchemaMigrationRunner = (context: SchemaMigrationRunContext) => unknown | Promise<unknown>;\n\nexport interface SchemaMigrationDefinition {\n  id?: string;\n  description?: string;\n  status?: string;\n  mandatory?: boolean;\n  run?: SchemaMigrationRunner;\n  [key: string]: unknown;\n}\n\nexport interface ImportExportContext {\n  registration: string;\n  action: \"import\" | \"export\";\n  command: string;\n  args: string[];\n  options: Record<string, unknown>;\n  global: GlobalOptions;\n  pm_root: string;\n}\n\nexport type Importer = (context: ImportExportContext) => unknown | Promise<unknown>;\nexport type Exporter = (context: ImportExportContext) => unknown | Promise<unknown>;\n\nexport type ExtensionSearchMode = \"keyword\" | \"semantic\" | \"hybrid\";\n\nexport interface SearchProviderQueryContext {\n  query: string;\n  mode: ExtensionSearchMode;\n  tokens: string[];\n  options: Record<string, unknown>;\n  settings: PmSettings;\n  documents: ItemDocument[];\n  [key: string]: unknown;\n}\n\nexport interface SearchProviderHit {\n  id: string;\n  score: number;\n  matched_fields?: string[];\n  [key: string]: unknown;\n}\n\nexport type SearchProviderQueryResult = SearchProviderHit[] | { hits?: SearchProviderHit[] };\n\nexport interface SearchProviderEmbedBatchContext {\n  inputs: string[];\n  settings: PmSettings;\n  model: string;\n  [key: string]: unknown;\n}\n\nexport interface SearchProviderEmbedContext {\n  input: string;\n  settings: PmSettings;\n  model: string;\n  [key: string]: unknown;\n}\n\nexport interface SearchProviderDefinition {\n  name: string;\n  query?: (context: SearchProviderQueryContext) => SearchProviderQueryResult | Promise<SearchProviderQueryResult>;\n  embedBatch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;\n  embed_batch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;\n  embed?: (context: SearchProviderEmbedContext) => number[] | Promise<number[]>;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreQueryHit {\n  id: string;\n  score: number;\n  payload?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreQueryContext {\n  vector: number[];\n  limit: number;\n  settings: PmSettings;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreUpsertPoint {\n  id: string;\n  vector: number[];\n  payload?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreUpsertContext {\n  points: VectorStoreUpsertPoint[];\n  settings: PmSettings;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreDeleteContext {\n  ids: string[];\n  settings: PmSettings;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreAdapterDefinition {\n  name: string;\n  query?: (context: VectorStoreQueryContext) => VectorStoreQueryHit[] | Promise<VectorStoreQueryHit[]>;\n  upsert?: (context: VectorStoreUpsertContext) => unknown | Promise<unknown>;\n  delete?: (context: VectorStoreDeleteContext) => unknown | Promise<unknown>;\n  [key: string]: unknown;\n}\n\nexport interface RegisteredExtensionCommandOverride {\n  layer: ExtensionLayer;\n  name: string;\n  command: string;\n  run: CommandOverride;\n}\n\nexport interface RegisteredExtensionCommandHandler {\n  layer: ExtensionLayer;\n  name: string;\n  command: string;\n  run: CommandHandler;\n}\n\nexport interface RegisteredExtensionParserOverride {\n  layer: ExtensionLayer;\n  name: string;\n  command: string;\n  run: ParserOverride;\n}\n\nexport interface RegisteredExtensionPreflightOverride {\n  layer: ExtensionLayer;\n  name: string;\n  run: PreflightOverride;\n}\n\nexport interface RegisteredExtensionServiceOverride {\n  layer: ExtensionLayer;\n  name: string;\n  service: ExtensionServiceName;\n  run: ServiceOverride;\n}\n\nexport interface RegisteredExtensionRendererOverride {\n  layer: ExtensionLayer;\n  name: string;\n  format: OutputRendererFormat;\n  run: RendererOverride;\n}\n\nexport interface ExtensionCommandRegistry {\n  overrides: RegisteredExtensionCommandOverride[];\n  handlers: RegisteredExtensionCommandHandler[];\n}\n\nexport interface ExtensionParserRegistry {\n  overrides: RegisteredExtensionParserOverride[];\n}\n\nexport interface ExtensionPreflightRegistry {\n  overrides: RegisteredExtensionPreflightOverride[];\n}\n\nexport interface ExtensionServiceRegistry {\n  overrides: RegisteredExtensionServiceOverride[];\n}\n\nexport interface ExtensionRendererRegistry {\n  overrides: RegisteredExtensionRendererOverride[];\n}\n\nexport interface RegisteredExtensionFlagDefinitions {\n  layer: ExtensionLayer;\n  name: string;\n  target_command: string;\n  flags: FlagDefinition[];\n}\n\nexport interface RegisteredExtensionCommandDefinition {\n  layer: ExtensionLayer;\n  name: string;\n  command: string;\n  action: string;\n  description?: string;\n  intent?: string;\n  examples: string[];\n  failure_hints: string[];\n  arguments: ExtensionCommandArgumentDefinition[];\n}\n\nexport interface RegisteredExtensionSchemaFieldDefinitions {\n  layer: ExtensionLayer;\n  name: string;\n  fields: SchemaFieldDefinition[];\n}\n\nexport interface RegisteredExtensionSchemaItemTypeDefinitions {\n  layer: ExtensionLayer;\n  name: string;\n  types: SchemaItemTypeDefinition[];\n}\n\nexport interface RegisteredExtensionSchemaMigrationDefinition {\n  layer: ExtensionLayer;\n  name: string;\n  definition: SchemaMigrationDefinition;\n  runtime_definition: SchemaMigrationDefinition;\n}\n\nexport interface RegisteredExtensionImporter {\n  layer: ExtensionLayer;\n  name: string;\n  importer: string;\n}\n\nexport interface RegisteredExtensionExporter {\n  layer: ExtensionLayer;\n  name: string;\n  exporter: string;\n}\n\nexport interface RegisteredExtensionSearchProvider {\n  layer: ExtensionLayer;\n  name: string;\n  definition: SearchProviderDefinition;\n  runtime_definition: SearchProviderDefinition;\n}\n\nexport interface RegisteredExtensionVectorStoreAdapter {\n  layer: ExtensionLayer;\n  name: string;\n  definition: VectorStoreAdapterDefinition;\n  runtime_definition: VectorStoreAdapterDefinition;\n}\n\nexport interface ExtensionRegistrationRegistry {\n  commands: RegisteredExtensionCommandDefinition[];\n  flags: RegisteredExtensionFlagDefinitions[];\n  item_fields: RegisteredExtensionSchemaFieldDefinitions[];\n  item_types: RegisteredExtensionSchemaItemTypeDefinitions[];\n  migrations: RegisteredExtensionSchemaMigrationDefinition[];\n  importers: RegisteredExtensionImporter[];\n  exporters: RegisteredExtensionExporter[];\n  search_providers: RegisteredExtensionSearchProvider[];\n  vector_store_adapters: RegisteredExtensionVectorStoreAdapter[];\n}\n\nexport interface ExtensionRegistrationCounts {\n  commands: number;\n  flags: number;\n  item_fields: number;\n  item_types: number;\n  migrations: number;\n  importers: number;\n  exporters: number;\n  search_providers: number;\n  vector_store_adapters: number;\n}\n\nexport interface ExtensionApi {\n  registerCommand(command: string, override: CommandOverride): void;\n  registerCommand(definition: CommandDefinition): void;\n  registerParser(command: string, override: ParserOverride): void;\n  registerPreflight(override: PreflightOverride): void;\n  registerService(service: ExtensionServiceName, override: ServiceOverride): void;\n  registerFlags(targetCommand: string, flags: FlagDefinition[]): void;\n  registerItemFields(fields: SchemaFieldDefinition[]): void;\n  registerItemTypes(types: SchemaItemTypeDefinition[]): void;\n  registerMigration(definition: SchemaMigrationDefinition): void;\n  registerRenderer(format: OutputRendererFormat, renderer: RendererOverride): void;\n  registerImporter(name: string, importer: Importer): void;\n  registerExporter(name: string, exporter: Exporter): void;\n  registerSearchProvider(provider: SearchProviderDefinition): void;\n  registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): void;\n  hooks: {\n    beforeCommand(hook: BeforeCommandHook): void;\n    afterCommand(hook: AfterCommandHook): void;\n    onWrite(hook: OnWriteHook): void;\n    onRead(hook: OnReadHook): void;\n    onIndex(hook: OnIndexHook): void;\n  };\n}\n\nexport interface FailedExtensionActivation {\n  layer: ExtensionLayer;\n  name: string;\n  entry_path: string;\n  error: string;\n  trace?: ExtensionActivationFailureTrace;\n}\n\nexport interface ExtensionActivationFailureTrace {\n  method: string;\n  registration_index: number;\n  command?: string;\n  expected_schema: string;\n  received?: unknown;\n  hint?: string;\n}\n\nexport interface ExtensionActivationResult {\n  hooks: ExtensionHookRegistry;\n  commands: ExtensionCommandRegistry;\n  parsers: ExtensionParserRegistry;\n  preflight: ExtensionPreflightRegistry;\n  services: ExtensionServiceRegistry;\n  renderers: ExtensionRendererRegistry;\n  registrations: ExtensionRegistrationRegistry;\n  failed: FailedExtensionActivation[];\n  warnings: string[];\n  hook_counts: {\n    before_command: number;\n    after_command: number;\n    on_write: number;\n    on_read: number;\n    on_index: number;\n  };\n  command_override_count: number;\n  command_handler_count: number;\n  parser_override_count: number;\n  preflight_override_count: number;\n  service_override_count: number;\n  renderer_override_count: number;\n  registration_counts: ExtensionRegistrationCounts;\n}\n\nexport interface ExtensionCandidate {\n  layer: ExtensionLayer;\n  directory: string;\n  manifest_path: string;\n  entry_path: string;\n  manifest: ExtensionManifest;\n}\n\nexport interface ExtensionLayerScanResult {\n  diagnostics: ExtensionDiagnostic[];\n  warnings: string[];\n  candidates: ExtensionCandidate[];\n}\n\nexport interface ScannedExtensionDirectory {\n  diagnostic: ExtensionDiagnostic;\n  warnings: string[];\n  candidate: ExtensionCandidate | null;\n}\n\nexport interface LegacyExtensionCapabilityAliasMapping {\n  alias: string;\n  target: ExtensionCapability;\n}\n\nexport interface DiscoverExtensionsOptions {\n  pmRoot: string;\n  settings: PmSettings;\n  cwd?: string;\n  noExtensions?: boolean;\n}\n\nexport interface ActivatableExtension {\n  activate: (api: ExtensionApi) => void | Promise<void>;\n}\n\nexport interface ServiceOverrideResult {\n  handled: boolean;\n  result: unknown;\n  warnings: string[];\n}\n\nexport interface CommandOverrideResult {\n  overridden: boolean;\n  result: unknown;\n  warnings: string[];\n}\n\nexport interface CommandHandlerResult {\n  handled: boolean;\n  result: unknown;\n  warnings: string[];\n}\n\nexport interface ParserOverrideResult {\n  overridden: boolean;\n  context: CommandHandlerContext;\n  warnings: string[];\n}\n\nexport interface PreflightOverrideResult {\n  overridden: boolean;\n  context: CommandHandlerContext;\n  decision: PreflightRuntimeDecision;\n  warnings: string[];\n}\n\nexport interface RendererOverrideResult {\n  overridden: boolean;\n  rendered: string | null;\n  warnings: string[];\n}\n\nexport interface UnknownExtensionCapabilityWarningDetails {\n  layer: ExtensionLayer;\n  name: string;\n  capability: string;\n  allowed_capabilities: string[];\n  capability_contract_version: number;\n  suggested_capability?: string;\n  suggestion_source?: \"legacy_alias\" | \"nearest_match\";\n  legacy_alias_target?: string;\n}\n"]}
+{"version":3,"file":"extension-types.js","sourceRoot":"/","sources":["core/extensions/extension-types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,UAAU;IACV,WAAW;IACX,OAAO;IACP,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,mCAAmC,GAAkD,MAAM,CAAC,MAAM,CAAC;IAC9G,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,QAAQ;CACrB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,qCAAqC;IAC9C,YAAY,EAAE,CAAC,GAAG,4BAA4B,CAAC;IAC/C,cAAc,EAAE,EAAE,GAAG,mCAAmC,EAAE;CAC3D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAEhF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAE/E,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC;AAG1F,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,mBAAmB;IACnB,kBAAkB;IAClB,qBAAqB;IACrB,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,eAAe;IACf,cAAc;IACd,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;IACnB,iBAAiB;IACjB,oBAAoB;IACpB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,oBAAoB;IACpB,iBAAiB;IACjB,oBAAoB;CACZ,CAAC","sourcesContent":["import type { ItemDocument, PmSettings } from \"../../types/index.js\";\nimport type { GlobalOptions } from \"../shared/command-types.js\";\n\nexport const KNOWN_EXTENSION_CAPABILITIES = [\n  \"commands\",\n  \"renderers\",\n  \"hooks\",\n  \"schema\",\n  \"importers\",\n  \"search\",\n  \"parser\",\n  \"preflight\",\n  \"services\",\n] as const;\nexport type ExtensionCapability = (typeof KNOWN_EXTENSION_CAPABILITIES)[number];\nexport const EXTENSION_CAPABILITY_CONTRACT_VERSION = 2;\nexport const EXTENSION_CAPABILITY_LEGACY_ALIASES: Readonly<Record<string, ExtensionCapability>> = Object.freeze({\n  migration: \"schema\",\n  validation: \"schema\",\n});\nexport const EXTENSION_CAPABILITY_CONTRACT = Object.freeze({\n  version: EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  capabilities: [...KNOWN_EXTENSION_CAPABILITIES],\n  legacy_aliases: { ...EXTENSION_CAPABILITY_LEGACY_ALIASES },\n});\n\nexport const KNOWN_EXTENSION_POLICY_MODES = [\"off\", \"warn\", \"enforce\"] as const;\nexport type ExtensionPolicyMode = (typeof KNOWN_EXTENSION_POLICY_MODES)[number];\nexport const KNOWN_EXTENSION_TRUST_MODES = [\"off\", \"warn\", \"enforce\"] as const;\nexport type ExtensionTrustMode = (typeof KNOWN_EXTENSION_TRUST_MODES)[number];\nexport const KNOWN_EXTENSION_SANDBOX_PROFILES = [\"none\", \"restricted\", \"strict\"] as const;\nexport type ExtensionSandboxProfile = (typeof KNOWN_EXTENSION_SANDBOX_PROFILES)[number];\n\nexport const KNOWN_EXTENSION_POLICY_SURFACES = [\n  \"commands.override\",\n  \"commands.handler\",\n  \"hooks.beforecommand\",\n  \"hooks.aftercommand\",\n  \"hooks.onwrite\",\n  \"hooks.onread\",\n  \"hooks.onindex\",\n  \"schema.flags\",\n  \"schema.itemfields\",\n  \"schema.itemtypes\",\n  \"schema.migrations\",\n  \"parser.override\",\n  \"preflight.override\",\n  \"services.override\",\n  \"renderers.override\",\n  \"importers.importer\",\n  \"importers.exporter\",\n  \"search.provider\",\n  \"search.vectorstore\",\n] as const;\nexport type ExtensionPolicySurface = (typeof KNOWN_EXTENSION_POLICY_SURFACES)[number];\n\nexport interface ExtensionProvenanceMetadata {\n  source?: string;\n  signature?: string;\n  attestation?: string;\n  verified?: boolean;\n}\n\nexport interface ExtensionRuntimePermissionDeclaration {\n  fs_read?: boolean;\n  fs_write?: boolean;\n  network?: boolean;\n  env_read?: boolean;\n  env_write?: boolean;\n  process_spawn?: boolean;\n}\n\nexport interface ExtensionPolicyOverride {\n  name: string;\n  disabled?: boolean;\n  require_trusted?: boolean;\n  require_provenance?: boolean;\n  sandbox_profile?: ExtensionSandboxProfile;\n  allowed_capabilities?: string[];\n  blocked_capabilities?: string[];\n  allowed_surfaces?: string[];\n  blocked_surfaces?: string[];\n  allowed_commands?: string[];\n  blocked_commands?: string[];\n  allowed_actions?: string[];\n  blocked_actions?: string[];\n  allowed_services?: string[];\n  blocked_services?: string[];\n}\n\nexport interface ExtensionGovernancePolicy {\n  mode: ExtensionPolicyMode;\n  trust_mode: ExtensionTrustMode;\n  require_provenance: boolean;\n  trusted_extensions: string[];\n  default_sandbox_profile: ExtensionSandboxProfile;\n  allowed_extensions: string[];\n  blocked_extensions: string[];\n  allowed_capabilities: string[];\n  blocked_capabilities: string[];\n  allowed_surfaces: string[];\n  blocked_surfaces: string[];\n  allowed_commands: string[];\n  blocked_commands: string[];\n  allowed_actions: string[];\n  blocked_actions: string[];\n  allowed_services: string[];\n  blocked_services: string[];\n  extension_overrides: ExtensionPolicyOverride[];\n}\n\nexport type ExtensionLayer = \"global\" | \"project\";\nexport type ExtensionStatus = \"ok\" | \"warn\";\n\nexport interface ExtensionManifest {\n  name: string;\n  version: string;\n  entry: string;\n  priority: number;\n  capabilities: string[];\n  manifest_version?: number;\n  trusted?: boolean;\n  provenance?: ExtensionProvenanceMetadata;\n  sandbox_profile?: ExtensionSandboxProfile;\n  permissions?: ExtensionRuntimePermissionDeclaration;\n  legacy_capability_aliases?: LegacyExtensionCapabilityAliasMapping[];\n}\n\nexport interface ExtensionDiagnostic {\n  layer: ExtensionLayer;\n  directory: string;\n  manifest_path: string;\n  name: string | null;\n  version: string | null;\n  entry: string | null;\n  priority: number | null;\n  entry_path: string | null;\n  enabled: boolean | null;\n  status: ExtensionStatus;\n}\n\nexport interface EffectiveExtension {\n  layer: ExtensionLayer;\n  directory: string;\n  manifest_path: string;\n  name: string;\n  version: string;\n  entry: string;\n  priority: number;\n  entry_path: string;\n  manifest_version?: number;\n  trusted?: boolean;\n  provenance?: ExtensionProvenanceMetadata;\n  sandbox_profile?: ExtensionSandboxProfile;\n  permissions?: ExtensionRuntimePermissionDeclaration;\n  capabilities?: string[];\n}\n\nexport interface ExtensionDiscoveryResult {\n  disabled_by_flag: boolean;\n  roots: {\n    global: string;\n    project: string;\n  };\n  configured_enabled: string[];\n  configured_disabled: string[];\n  discovered: ExtensionDiagnostic[];\n  effective: EffectiveExtension[];\n  warnings: string[];\n  policy: ExtensionGovernancePolicy;\n}\n\nexport interface LoadedExtension extends EffectiveExtension {\n  module: unknown;\n}\n\nexport interface FailedExtensionLoad {\n  layer: ExtensionLayer;\n  name: string;\n  entry_path: string;\n  error: string;\n}\n\nexport interface ExtensionLoadResult extends ExtensionDiscoveryResult {\n  loaded: LoadedExtension[];\n  failed: FailedExtensionLoad[];\n}\n\nexport interface BeforeCommandHookContext {\n  command: string;\n  args: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n  pm_root: string;\n}\n\nexport interface AfterCommandHookContext extends BeforeCommandHookContext {\n  ok: boolean;\n  error?: string;\n  result?: unknown;\n}\n\nexport interface OnWriteHookContext {\n  path: string;\n  scope: \"project\" | \"global\";\n  op: string;\n}\n\nexport interface OnReadHookContext {\n  path: string;\n  scope: \"project\" | \"global\";\n}\n\nexport interface OnIndexHookContext {\n  mode: string;\n  total_items?: number;\n}\n\nexport type BeforeCommandHook = (context: BeforeCommandHookContext) => Promise<void> | void;\nexport type AfterCommandHook = (context: AfterCommandHookContext) => Promise<void> | void;\nexport type OnWriteHook = (context: OnWriteHookContext) => Promise<void> | void;\nexport type OnReadHook = (context: OnReadHookContext) => Promise<void> | void;\nexport type OnIndexHook = (context: OnIndexHookContext) => Promise<void> | void;\nexport type OutputRendererFormat = \"toon\" | \"json\";\nexport type CommandOverride = (context: CommandOverrideContext) => unknown;\nexport type RendererOverride = (context: RendererOverrideContext) => string;\nexport type CommandHandler = (context: CommandHandlerContext) => unknown;\nexport type ParserOverride = (context: ParserOverrideContext) => ParserOverrideDelta | Promise<ParserOverrideDelta>;\nexport type PreflightOverride = (context: PreflightOverrideContext) => PreflightOverrideDelta | Promise<PreflightOverrideDelta>;\nexport type ServiceOverride = (context: ServiceOverrideContext) => unknown;\n\nexport interface RegisteredExtensionHook<THook> {\n  layer: ExtensionLayer;\n  name: string;\n  run: THook;\n}\n\nexport interface ExtensionHookRegistry {\n  beforeCommand: Array<RegisteredExtensionHook<BeforeCommandHook>>;\n  afterCommand: Array<RegisteredExtensionHook<AfterCommandHook>>;\n  onWrite: Array<RegisteredExtensionHook<OnWriteHook>>;\n  onRead: Array<RegisteredExtensionHook<OnReadHook>>;\n  onIndex: Array<RegisteredExtensionHook<OnIndexHook>>;\n}\n\nexport interface CommandOverrideContext {\n  command: string;\n  args: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n  pm_root: string;\n  result: unknown;\n}\n\nexport interface RendererOverrideContext {\n  format: OutputRendererFormat;\n  command?: string;\n  args?: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n  pm_root?: string;\n  result: unknown;\n}\n\nexport interface CommandHandlerContext {\n  command: string;\n  args: string[];\n  options: Record<string, unknown>;\n  global: GlobalOptions;\n  pm_root: string;\n}\n\nexport interface ParserOverrideContext extends CommandHandlerContext {}\n\nexport interface ParserOverrideDelta {\n  args?: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n}\n\nexport interface PreflightOverrideContext extends CommandHandlerContext {\n  decision: PreflightRuntimeDecision;\n}\n\nexport interface PreflightRuntimeDecision {\n  enforce_item_format_gate: boolean;\n  run_preflight_item_format_sync: boolean;\n  run_extension_migrations: boolean;\n  enforce_mandatory_migration_gate: boolean;\n}\n\nexport interface PreflightOverrideDelta extends ParserOverrideDelta {\n  enforce_item_format_gate?: boolean;\n  run_preflight_item_format_sync?: boolean;\n  run_extension_migrations?: boolean;\n  enforce_mandatory_migration_gate?: boolean;\n}\n\nexport type ExtensionServiceName =\n  | \"output_format\"\n  | \"error_format\"\n  | \"help_format\"\n  | \"lock_acquire\"\n  | \"lock_release\"\n  | \"history_append\"\n  | \"item_store_write\"\n  | \"item_store_delete\";\n\nexport interface ServiceOverrideContext {\n  service: ExtensionServiceName;\n  command?: string;\n  args?: string[];\n  options?: Record<string, unknown>;\n  global?: GlobalOptions;\n  pm_root?: string;\n  payload: unknown;\n}\n\nexport interface ExtensionCommandArgumentDefinition {\n  name: string;\n  required?: boolean;\n  variadic?: boolean;\n  description?: string;\n}\n\nexport interface CommandDefinition {\n  name: string;\n  run?: CommandHandler;\n  /**\n   * @deprecated Use `run` instead. This alias remains for backward compatibility.\n   */\n  handler?: CommandHandler;\n  action?: string;\n  description?: string;\n  intent?: string;\n  examples?: string[];\n  failure_hints?: string[];\n  arguments?: ExtensionCommandArgumentDefinition[];\n  flags?: FlagDefinition[];\n}\n\nexport type FlagValueType = \"string\" | \"number\" | \"boolean\";\n\nexport interface FlagDefinition {\n  long?: string;\n  short?: string;\n  value_name?: string;\n  description?: string;\n  required?: boolean;\n  enabled?: boolean;\n  visible?: boolean;\n  type?: FlagValueType;\n  value_type?: FlagValueType;\n  [key: string]: unknown;\n}\n\nexport interface SchemaFieldDefinition {\n  name: string;\n  type: string;\n  optional?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface SchemaItemTypeCommandOptionPolicyDefinition {\n  command: string;\n  option: string;\n  enabled?: boolean;\n  required?: boolean;\n  visible?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface SchemaItemTypeOptionDefinition {\n  key: string;\n  values?: string[];\n  required?: boolean;\n  aliases?: string[];\n  [key: string]: unknown;\n}\n\nexport interface SchemaItemTypeDefinition {\n  name: string;\n  folder?: string;\n  aliases?: string[];\n  required_create_fields?: string[];\n  required_create_repeatables?: string[];\n  command_option_policies?: SchemaItemTypeCommandOptionPolicyDefinition[];\n  options?: SchemaItemTypeOptionDefinition[];\n  [key: string]: unknown;\n}\n\nexport interface SchemaMigrationRunContext {\n  id: string;\n  command: \"migration\";\n  layer: ExtensionLayer;\n  extension: string;\n  pm_root: string;\n  status: string;\n}\n\nexport type SchemaMigrationRunner = (context: SchemaMigrationRunContext) => unknown | Promise<unknown>;\n\nexport interface SchemaMigrationDefinition {\n  id?: string;\n  description?: string;\n  status?: string;\n  mandatory?: boolean;\n  run?: SchemaMigrationRunner;\n  [key: string]: unknown;\n}\n\nexport interface ImportExportContext {\n  registration: string;\n  action: \"import\" | \"export\";\n  command: string;\n  args: string[];\n  options: Record<string, unknown>;\n  global: GlobalOptions;\n  pm_root: string;\n}\n\nexport type Importer = (context: ImportExportContext) => unknown | Promise<unknown>;\nexport type Exporter = (context: ImportExportContext) => unknown | Promise<unknown>;\n\nexport type ExtensionSearchMode = \"keyword\" | \"semantic\" | \"hybrid\";\n\nexport interface SearchProviderQueryContext {\n  query: string;\n  mode: ExtensionSearchMode;\n  tokens: string[];\n  options: Record<string, unknown>;\n  settings: PmSettings;\n  documents: ItemDocument[];\n  [key: string]: unknown;\n}\n\nexport interface SearchProviderHit {\n  id: string;\n  score: number;\n  matched_fields?: string[];\n  [key: string]: unknown;\n}\n\nexport type SearchProviderQueryResult = SearchProviderHit[] | { hits?: SearchProviderHit[] };\n\nexport interface SearchProviderEmbedBatchContext {\n  inputs: string[];\n  settings: PmSettings;\n  model: string;\n  [key: string]: unknown;\n}\n\nexport interface SearchProviderEmbedContext {\n  input: string;\n  settings: PmSettings;\n  model: string;\n  [key: string]: unknown;\n}\n\nexport interface SearchProviderDefinition {\n  name: string;\n  query?: (context: SearchProviderQueryContext) => SearchProviderQueryResult | Promise<SearchProviderQueryResult>;\n  embedBatch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;\n  embed_batch?: (context: SearchProviderEmbedBatchContext) => number[][] | Promise<number[][]>;\n  embed?: (context: SearchProviderEmbedContext) => number[] | Promise<number[]>;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreQueryHit {\n  id: string;\n  score: number;\n  payload?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreQueryContext {\n  vector: number[];\n  limit: number;\n  settings: PmSettings;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreUpsertPoint {\n  id: string;\n  vector: number[];\n  payload?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreUpsertContext {\n  points: VectorStoreUpsertPoint[];\n  settings: PmSettings;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreDeleteContext {\n  ids: string[];\n  settings: PmSettings;\n  [key: string]: unknown;\n}\n\nexport interface VectorStoreAdapterDefinition {\n  name: string;\n  query?: (context: VectorStoreQueryContext) => VectorStoreQueryHit[] | Promise<VectorStoreQueryHit[]>;\n  upsert?: (context: VectorStoreUpsertContext) => unknown | Promise<unknown>;\n  delete?: (context: VectorStoreDeleteContext) => unknown | Promise<unknown>;\n  [key: string]: unknown;\n}\n\nexport interface RegisteredExtensionCommandOverride {\n  layer: ExtensionLayer;\n  name: string;\n  command: string;\n  run: CommandOverride;\n}\n\nexport interface RegisteredExtensionCommandHandler {\n  layer: ExtensionLayer;\n  name: string;\n  command: string;\n  run: CommandHandler;\n}\n\nexport interface RegisteredExtensionParserOverride {\n  layer: ExtensionLayer;\n  name: string;\n  command: string;\n  run: ParserOverride;\n}\n\nexport interface RegisteredExtensionPreflightOverride {\n  layer: ExtensionLayer;\n  name: string;\n  run: PreflightOverride;\n}\n\nexport interface RegisteredExtensionServiceOverride {\n  layer: ExtensionLayer;\n  name: string;\n  service: ExtensionServiceName;\n  run: ServiceOverride;\n}\n\nexport interface RegisteredExtensionRendererOverride {\n  layer: ExtensionLayer;\n  name: string;\n  format: OutputRendererFormat;\n  run: RendererOverride;\n}\n\nexport interface ExtensionCommandRegistry {\n  overrides: RegisteredExtensionCommandOverride[];\n  handlers: RegisteredExtensionCommandHandler[];\n}\n\nexport interface ExtensionParserRegistry {\n  overrides: RegisteredExtensionParserOverride[];\n}\n\nexport interface ExtensionPreflightRegistry {\n  overrides: RegisteredExtensionPreflightOverride[];\n}\n\nexport interface ExtensionServiceRegistry {\n  overrides: RegisteredExtensionServiceOverride[];\n}\n\nexport interface ExtensionRendererRegistry {\n  overrides: RegisteredExtensionRendererOverride[];\n}\n\nexport interface RegisteredExtensionFlagDefinitions {\n  layer: ExtensionLayer;\n  name: string;\n  target_command: string;\n  flags: FlagDefinition[];\n}\n\nexport interface RegisteredExtensionCommandDefinition {\n  layer: ExtensionLayer;\n  name: string;\n  command: string;\n  action: string;\n  description?: string;\n  intent?: string;\n  examples: string[];\n  failure_hints: string[];\n  arguments: ExtensionCommandArgumentDefinition[];\n}\n\nexport interface RegisteredExtensionSchemaFieldDefinitions {\n  layer: ExtensionLayer;\n  name: string;\n  fields: SchemaFieldDefinition[];\n}\n\nexport interface RegisteredExtensionSchemaItemTypeDefinitions {\n  layer: ExtensionLayer;\n  name: string;\n  types: SchemaItemTypeDefinition[];\n}\n\nexport interface RegisteredExtensionSchemaMigrationDefinition {\n  layer: ExtensionLayer;\n  name: string;\n  definition: SchemaMigrationDefinition;\n  runtime_definition: SchemaMigrationDefinition;\n}\n\nexport interface RegisteredExtensionImporter {\n  layer: ExtensionLayer;\n  name: string;\n  importer: string;\n}\n\nexport interface RegisteredExtensionExporter {\n  layer: ExtensionLayer;\n  name: string;\n  exporter: string;\n}\n\nexport interface RegisteredExtensionSearchProvider {\n  layer: ExtensionLayer;\n  name: string;\n  definition: SearchProviderDefinition;\n  runtime_definition: SearchProviderDefinition;\n}\n\nexport interface RegisteredExtensionVectorStoreAdapter {\n  layer: ExtensionLayer;\n  name: string;\n  definition: VectorStoreAdapterDefinition;\n  runtime_definition: VectorStoreAdapterDefinition;\n}\n\nexport interface ExtensionRegistrationRegistry {\n  commands: RegisteredExtensionCommandDefinition[];\n  flags: RegisteredExtensionFlagDefinitions[];\n  item_fields: RegisteredExtensionSchemaFieldDefinitions[];\n  item_types: RegisteredExtensionSchemaItemTypeDefinitions[];\n  migrations: RegisteredExtensionSchemaMigrationDefinition[];\n  importers: RegisteredExtensionImporter[];\n  exporters: RegisteredExtensionExporter[];\n  search_providers: RegisteredExtensionSearchProvider[];\n  vector_store_adapters: RegisteredExtensionVectorStoreAdapter[];\n}\n\nexport interface ExtensionRegistrationCounts {\n  commands: number;\n  flags: number;\n  item_fields: number;\n  item_types: number;\n  migrations: number;\n  importers: number;\n  exporters: number;\n  search_providers: number;\n  vector_store_adapters: number;\n}\n\nexport interface ExtensionApi {\n  registerCommand(command: string, override: CommandOverride): void;\n  registerCommand(definition: CommandDefinition): void;\n  registerParser(command: string, override: ParserOverride): void;\n  registerPreflight(override: PreflightOverride): void;\n  registerService(service: ExtensionServiceName, override: ServiceOverride): void;\n  registerFlags(targetCommand: string, flags: FlagDefinition[]): void;\n  registerItemFields(fields: SchemaFieldDefinition[]): void;\n  registerItemTypes(types: SchemaItemTypeDefinition[]): void;\n  registerMigration(definition: SchemaMigrationDefinition): void;\n  registerRenderer(format: OutputRendererFormat, renderer: RendererOverride): void;\n  registerImporter(name: string, importer: Importer): void;\n  registerExporter(name: string, exporter: Exporter): void;\n  registerSearchProvider(provider: SearchProviderDefinition): void;\n  registerVectorStoreAdapter(adapter: VectorStoreAdapterDefinition): void;\n  hooks: {\n    beforeCommand(hook: BeforeCommandHook): void;\n    afterCommand(hook: AfterCommandHook): void;\n    onWrite(hook: OnWriteHook): void;\n    onRead(hook: OnReadHook): void;\n    onIndex(hook: OnIndexHook): void;\n  };\n}\n\nexport interface FailedExtensionActivation {\n  layer: ExtensionLayer;\n  name: string;\n  entry_path: string;\n  error: string;\n  trace?: ExtensionActivationFailureTrace;\n}\n\nexport interface ExtensionActivationFailureTrace {\n  method: string;\n  registration_index: number;\n  command?: string;\n  expected_schema: string;\n  received?: unknown;\n  hint?: string;\n}\n\nexport interface ExtensionActivationResult {\n  hooks: ExtensionHookRegistry;\n  commands: ExtensionCommandRegistry;\n  parsers: ExtensionParserRegistry;\n  preflight: ExtensionPreflightRegistry;\n  services: ExtensionServiceRegistry;\n  renderers: ExtensionRendererRegistry;\n  registrations: ExtensionRegistrationRegistry;\n  failed: FailedExtensionActivation[];\n  warnings: string[];\n  hook_counts: {\n    before_command: number;\n    after_command: number;\n    on_write: number;\n    on_read: number;\n    on_index: number;\n  };\n  command_override_count: number;\n  command_handler_count: number;\n  parser_override_count: number;\n  preflight_override_count: number;\n  service_override_count: number;\n  renderer_override_count: number;\n  registration_counts: ExtensionRegistrationCounts;\n}\n\nexport interface ExtensionCandidate {\n  layer: ExtensionLayer;\n  directory: string;\n  manifest_path: string;\n  entry_path: string;\n  manifest: ExtensionManifest;\n}\n\nexport interface ExtensionLayerScanResult {\n  diagnostics: ExtensionDiagnostic[];\n  warnings: string[];\n  candidates: ExtensionCandidate[];\n}\n\nexport interface ScannedExtensionDirectory {\n  diagnostic: ExtensionDiagnostic;\n  warnings: string[];\n  candidate: ExtensionCandidate | null;\n}\n\nexport interface LegacyExtensionCapabilityAliasMapping {\n  alias: string;\n  target: ExtensionCapability;\n}\n\nexport interface DiscoverExtensionsOptions {\n  pmRoot: string;\n  settings: PmSettings;\n  cwd?: string;\n  noExtensions?: boolean;\n  reload_token?: string;\n  cache_bust?: boolean;\n}\n\nexport interface ActivatableExtension {\n  activate: (api: ExtensionApi) => void | Promise<void>;\n}\n\nexport interface ServiceOverrideResult {\n  handled: boolean;\n  result: unknown;\n  warnings: string[];\n}\n\nexport interface CommandOverrideResult {\n  overridden: boolean;\n  result: unknown;\n  warnings: string[];\n}\n\nexport interface CommandHandlerResult {\n  handled: boolean;\n  result: unknown;\n  warnings: string[];\n}\n\nexport interface ParserOverrideResult {\n  overridden: boolean;\n  context: CommandHandlerContext;\n  warnings: string[];\n}\n\nexport interface PreflightOverrideResult {\n  overridden: boolean;\n  context: CommandHandlerContext;\n  decision: PreflightRuntimeDecision;\n  warnings: string[];\n}\n\nexport interface RendererOverrideResult {\n  overridden: boolean;\n  rendered: string | null;\n  warnings: string[];\n}\n\nexport interface UnknownExtensionCapabilityWarningDetails {\n  layer: ExtensionLayer;\n  name: string;\n  capability: string;\n  allowed_capabilities: string[];\n  capability_contract_version: number;\n  suggested_capability?: string;\n  suggestion_source?: \"legacy_alias\" | \"nearest_match\";\n  legacy_alias_target?: string;\n}\n"]}

package/dist/core/extensions/loader.d.ts

@@ -1,5 +1,6 @@
 import { type ExtensionDiscoveryResult, type ExtensionLoadResult, type BeforeCommandHookContext, type AfterCommandHookContext, type OnWriteHookContext, type OnReadHookContext, type OnIndexHookContext, type ExtensionHookRegistry, type CommandOverrideContext, type RendererOverrideContext, type CommandHandlerContext, type ParserOverrideContext, type PreflightOverrideContext, type ServiceOverrideContext, type ExtensionCommandRegistry, type ExtensionParserRegistry, type ExtensionPreflightRegistry, type ExtensionServiceRegistry, type ExtensionRendererRegistry, type ExtensionRegistrationRegistry, type ExtensionActivationResult, type DiscoverExtensionsOptions, type ServiceOverrideResult, type CommandOverrideResult, type CommandHandlerResult, type ParserOverrideResult, type PreflightOverrideResult, type RendererOverrideResult, type UnknownExtensionCapabilityWarningDetails } from "./extension-types.js";
 export * from "./extension-types.js";
+export declare function nextExtensionReloadToken(seed?: number): string;
 export declare function parseUnknownExtensionCapabilityWarning(warning: string): UnknownExtensionCapabilityWarningDetails | null;
 export declare function parseLegacyExtensionCapabilityAliasWarning(warning: string): UnknownExtensionCapabilityWarningDetails[];
 export declare function resolveExtensionRoots(pmRoot: string, cwd?: string): {