@unbrained/pm-cli 2026.6.20 → 2026.6.22

package/dist/sdk/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sources":["sdk/testing.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/testing\n *\n * Defines public SDK APIs and package-author helpers for Testing.\n */\nimport 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\n/**\n * Documents the activate extension for test options payload exchanged by command, SDK, and package integrations.\n */\nexport interface ActivateExtensionForTestOptions {\n  name?: string;\n  layer?: ExtensionLayer;\n  capabilities?: readonly ExtensionCapability[];\n  policy?: ExtensionGovernancePolicy;\n}\n\n/**\n * Documents the registered command contract expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredCommandContractExpectation {\n  command: string;\n  action?: string;\n  extensionName?: string;\n  arguments?: string[];\n  flags?: string[];\n}\n\n/**\n * Documents the registered command contract assertion payload exchanged by command, SDK, and package integrations.\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\n/**\n * Documents the registered hook expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredHookExpectation {\n  kind: RegisteredHookKind;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered search provider expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredSearchProviderExpectation {\n  provider: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered vector store adapter expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredVectorStoreAdapterExpectation {\n  adapter: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered importer expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredImporterExpectation {\n  importer: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered exporter expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredExporterExpectation {\n  exporter: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered item field expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredItemFieldExpectation {\n  field: string;\n  extensionName?: string;\n  type?: SchemaFieldDefinition[\"type\"];\n}\n\n/**\n * Documents the registered item field assertion payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredItemFieldAssertion {\n  registration: RegisteredExtensionSchemaFieldDefinitions;\n  field: SchemaFieldDefinition;\n}\n\n/**\n * Documents the registered item type expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredItemTypeExpectation {\n  itemType: string;\n  extensionName?: string;\n  folder?: string;\n}\n\n/**\n * Documents the registered item type assertion payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredItemTypeAssertion {\n  registration: RegisteredExtensionSchemaItemTypeDefinitions;\n  itemType: SchemaItemTypeDefinition;\n}\n\n/**\n * Documents the registered command override expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredCommandOverrideExpectation {\n  command: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered parser override expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredParserOverrideExpectation {\n  command: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered preflight override expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredPreflightOverrideExpectation {\n  extensionName?: string;\n}\n\n/**\n * Documents the registered renderer override expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredRendererOverrideExpectation {\n  format: OutputRendererFormat;\n  extensionName?: string;\n}\n\n/**\n * Restricts package manifest resource expectation values accepted by command, SDK, and storage contracts.\n */\nexport type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;\n\n/**\n * Documents the package manifest expectation payload exchanged by command, SDK, and package integrations.\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":"a3dceb9a-70c2-54cb-ba96-71727c3dfe10"}
+{"version":3,"file":"testing.js","sources":["sdk/testing.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/testing\n *\n * Defines public SDK APIs and package-author helpers for Testing.\n */\nimport type {\n  AfterCommandHookContext,\n  BeforeCommandHookContext,\n  CommandHandlerResult,\n  CommandOverrideContext,\n  CommandOverrideResult,\n  ExtensionActivationResult,\n  ExtensionCapability,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationResult,\n  ExtensionGovernancePolicy,\n  ExtensionHookRegistry,\n  ExtensionLayer,\n  ExtensionLoadResult,\n  ExtensionManifest,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  ExtensionServiceName,\n  ExtensionServiceRegistry,\n  FlagDefinition,\n  OnIndexHookContext,\n  OnReadHookContext,\n  OnWriteHookContext,\n  OutputRendererFormat,\n  ParserOverrideContext,\n  ParserOverrideResult,\n  PreflightOverrideContext,\n  PreflightOverrideResult,\n  RegisteredExtensionCommandDefinition,\n  RegisteredExtensionCommandOverride,\n  RegisteredExtensionExporter,\n  RegisteredExtensionFlagDefinitions,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionParserOverride,\n  RegisteredExtensionPreflightOverride,\n  RegisteredExtensionRendererOverride,\n  RegisteredExtensionSchemaFieldDefinitions,\n  RegisteredExtensionSchemaItemTypeDefinitions,\n  RegisteredExtensionSchemaMigrationDefinition,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionServiceOverride,\n  RegisteredExtensionVectorStoreAdapter,\n  RendererOverrideContext,\n  RendererOverrideResult,\n  SchemaFieldDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationRunContext,\n  SearchProviderEmbedBatchContext,\n  SearchProviderEmbedContext,\n  SearchProviderQueryContext,\n  SearchProviderQueryExpansionContext,\n  SearchProviderQueryExpansionResult,\n  SearchProviderQueryResult,\n  SearchProviderRerankContext,\n  SearchProviderRerankResult,\n  ServiceOverrideContext,\n  ServiceOverrideResult,\n  VectorStoreDeleteContext,\n  VectorStoreQueryContext,\n  VectorStoreQueryHit,\n  VectorStoreUpsertContext,\n} from \"../core/extensions/loader.js\";\nimport {\n  activateExtensions,\n  deactivateExtensions,\n  runAfterCommandHooks,\n  runBeforeCommandHooks,\n  runCommandHandler,\n  runCommandOverride,\n  runOnIndexHooks,\n  runOnReadHooks,\n  runOnWriteHooks,\n  runParserOverride,\n  runPreflightOverride,\n  runRendererOverride,\n  runServiceOverride,\n} from \"../core/extensions/loader.js\";\nimport { createDefaultExtensionGovernancePolicy } from \"../core/extensions/extension-types.js\";\nimport {\n  getMigrationRuntimeDefinition,\n  resolveRegisteredSearchProvider,\n  resolveRegisteredVectorStoreAdapter,\n} from \"../core/extensions/runtime-registrations.js\";\nimport { collectUsedExtensionCapabilities } from \"../core/extensions/capability-usage.js\";\nimport { normalizeKnownExtensionCapability } from \"../core/extensions/extension-capability-aliases.js\";\nimport type { GlobalOptions } from \"../core/shared/command-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\n/**\n * Documents the activate extension for test options payload exchanged by command, SDK, and package integrations.\n */\nexport interface ActivateExtensionForTestOptions {\n  name?: string;\n  layer?: ExtensionLayer;\n  capabilities?: readonly ExtensionCapability[];\n  policy?: ExtensionGovernancePolicy;\n}\n\n/**\n * Documents the deactivate extension for test options payload exchanged by command, SDK, and package integrations.\n */\nexport interface DeactivateExtensionForTestOptions {\n  /** Overrides the in-memory extension name (defaults to `manifest.name` or `\"test-extension\"`). */\n  name?: string;\n  /** Overrides the layer recorded for the in-memory extension (defaults to `\"project\"`). */\n  layer?: ExtensionLayer;\n  /**\n   * Activation result returned by `activateExtensionForTest`. When provided, an\n   * extension whose `activate` failed is skipped — mirroring the host teardown\n   * contract that never deactivates a never-initialized extension. Pass the same\n   * `name`/`layer` to both helpers so the skip key matches.\n   */\n  activation?: Pick<ExtensionActivationResult, \"failed\">;\n  /**\n   * Per-hook teardown bound, forwarded as `deactivate_timeout_ms`. Use `0` (or\n   * `Infinity`) to wait indefinitely; omit to keep the host default.\n   */\n  deactivateTimeoutMs?: number;\n}\n\n/**\n * Options for {@link runRegisteredCommandForTest} — the inputs forwarded to a\n * registered extension command handler when exercising its behavior in a test.\n */\nexport interface RunRegisteredCommandForTestOptions {\n  /**\n   * Full registered command path to invoke, e.g. `\"hello\"` or `\"todos import\"`.\n   * Matched against `commands.handlers[].command` after normalization (trimmed,\n   * lower-cased, internal whitespace collapsed), mirroring runtime dispatch.\n   */\n  command: string;\n  /** Positional arguments forwarded as `context.args` (default: none). */\n  args?: readonly string[];\n  /** Parsed flags/options forwarded as `context.options` (default: none). */\n  options?: Record<string, unknown>;\n  /**\n   * Global option overrides merged onto the agent-safe test defaults\n   * (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`.\n   */\n  global?: Partial<GlobalOptions>;\n  /**\n   * Resolved pm workspace root forwarded as `context.pm_root` (default: `\"\"`).\n   * Most pure handlers ignore it; set it when the handler reads workspace files.\n   */\n  pmRoot?: string;\n}\n\n/**\n * Options for {@link runRegisteredHookForTest} — the lifecycle `kind` to fire and\n * the synthetic context handed to every registered hook of that kind.\n *\n * The union keeps `context` type-safe per kind: `kind: \"on_write\"` requires an\n * {@link OnWriteHookContext}, `kind: \"after_command\"` an\n * {@link AfterCommandHookContext}, and so on — so authors cannot accidentally\n * pass an index context to a read hook.\n */\nexport type RunRegisteredHookForTestOptions =\n  | { kind: \"before_command\"; context: BeforeCommandHookContext }\n  | { kind: \"after_command\"; context: AfterCommandHookContext }\n  | { kind: \"on_read\"; context: OnReadHookContext }\n  | { kind: \"on_write\"; context: OnWriteHookContext }\n  | { kind: \"on_index\"; context: OnIndexHookContext };\n\n/**\n * Maps each invokable search-provider operation to the context type its function\n * receives, keeping {@link runRegisteredSearchProviderForTest} type-safe per\n * operation. Mirrors the operations the host dispatches to a registered provider:\n * semantic `query`, single/batch embedding (`embed`/`embedBatch`),\n * `queryExpansion`, and `rerank`.\n */\nexport interface SearchProviderOperationContexts {\n  query: SearchProviderQueryContext;\n  embed: SearchProviderEmbedContext;\n  embedBatch: SearchProviderEmbedBatchContext;\n  queryExpansion: SearchProviderQueryExpansionContext;\n  rerank: SearchProviderRerankContext;\n}\n\n/**\n * Maps each invokable search-provider operation to the result type its function\n * returns, so {@link runRegisteredSearchProviderForTest} resolves a precise return\n * type from the chosen `operation` instead of a union the caller must narrow.\n */\nexport interface SearchProviderOperationResults {\n  query: SearchProviderQueryResult;\n  embed: number[];\n  embedBatch: number[][];\n  queryExpansion: SearchProviderQueryExpansionResult;\n  rerank: SearchProviderRerankResult;\n}\n\n/**\n * Options for {@link runRegisteredSearchProviderForTest}: the registered\n * `provider` name to resolve, the `operation` to invoke, and the synthetic\n * `context` handed to that operation. The discriminated union keeps `context`\n * type-safe per operation — `operation: \"embed\"` requires a\n * {@link SearchProviderEmbedContext}, `operation: \"rerank\"` a\n * {@link SearchProviderRerankContext}, and so on.\n */\nexport type RunRegisteredSearchProviderForTestOptions = {\n  [Operation in keyof SearchProviderOperationContexts]: {\n    /** Registered provider name to resolve, matched case-insensitively as the host does. */\n    provider: string;\n    /** Provider operation to invoke. */\n    operation: Operation;\n    /** Synthetic context handed to the resolved operation function. */\n    context: SearchProviderOperationContexts[Operation];\n  };\n}[keyof SearchProviderOperationContexts];\n\n/**\n * Maps each invokable vector-store-adapter operation to the context type its\n * function receives, keeping {@link runRegisteredVectorStoreAdapterForTest}\n * type-safe per operation. Mirrors the operations the host dispatches to a\n * registered adapter: nearest-neighbour `query`, `upsert`, and `delete`.\n */\nexport interface VectorStoreAdapterOperationContexts {\n  query: VectorStoreQueryContext;\n  upsert: VectorStoreUpsertContext;\n  delete: VectorStoreDeleteContext;\n}\n\n/**\n * Maps each invokable vector-store-adapter operation to the result type its\n * function returns. Only `query` has a structured result\n * ({@link VectorStoreQueryHit}[]); `upsert`/`delete` report success by not\n * throwing, so their result is `unknown` and typically ignored.\n */\nexport interface VectorStoreAdapterOperationResults {\n  query: VectorStoreQueryHit[];\n  upsert: unknown;\n  delete: unknown;\n}\n\n/**\n * Options for {@link runRegisteredVectorStoreAdapterForTest}: the registered\n * `adapter` name to resolve, the `operation` to invoke, and the synthetic\n * `context` handed to that operation. The discriminated union keeps `context`\n * type-safe per operation — `operation: \"upsert\"` requires a\n * {@link VectorStoreUpsertContext}, `operation: \"delete\"` a\n * {@link VectorStoreDeleteContext}, and so on.\n */\nexport type RunRegisteredVectorStoreAdapterForTestOptions = {\n  [Operation in keyof VectorStoreAdapterOperationContexts]: {\n    /** Registered adapter name to resolve, matched case-insensitively as the host does. */\n    adapter: string;\n    /** Adapter operation to invoke. */\n    operation: Operation;\n    /** Synthetic context handed to the resolved operation function. */\n    context: VectorStoreAdapterOperationContexts[Operation];\n  };\n}[keyof VectorStoreAdapterOperationContexts];\n\n/**\n * Options for {@link runRegisteredMigrationForTest}: which registered migration\n * to invoke and the workspace root its run context reports.\n */\nexport interface RunRegisteredMigrationForTestOptions {\n  /** Registered migration id to resolve, matched case-insensitively against `definition.id`. */\n  migration: string;\n  /** Optional extension name to disambiguate when several extensions register the same id. */\n  extensionName?: string;\n  /** Resolved pm workspace root forwarded as `context.pm_root` (default `\"\"`). */\n  pmRoot?: string;\n}\n\n/**\n * Options for {@link runRegisteredImporterForTest} — the registered importer name\n * to invoke plus the synthetic invocation context forwarded to its handler.\n *\n * The `importer` name is the value passed to `api.registerImporter(name, ...)`,\n * resolved case-insensitively (and whitespace-collapsed) against\n * `registrations.importers`; the helper derives the `\"<name> import\"` command\n * path internally, so authors never hand-build it.\n */\nexport interface RunRegisteredImporterForTestOptions {\n  /** Registered importer name to resolve, e.g. `\"csv\"` for a `\"csv import\"` handler. */\n  importer: string;\n  /** Optional extension name to disambiguate when several extensions register the same importer. */\n  extensionName?: string;\n  /** Positional arguments forwarded as `context.args` (default: none). */\n  args?: readonly string[];\n  /** Parsed flags/options forwarded as `context.options` (default: none). */\n  options?: Record<string, unknown>;\n  /**\n   * Global option overrides merged onto the agent-safe test defaults\n   * (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`.\n   */\n  global?: Partial<GlobalOptions>;\n  /** Resolved pm workspace root forwarded as `context.pm_root` (default: `\"\"`). */\n  pmRoot?: string;\n}\n\n/**\n * Options for {@link runRegisteredExporterForTest} — the registered exporter name\n * to invoke plus the synthetic invocation context forwarded to its handler.\n *\n * The `exporter` name is the value passed to `api.registerExporter(name, ...)`,\n * resolved case-insensitively (and whitespace-collapsed) against\n * `registrations.exporters`; the helper derives the `\"<name> export\"` command\n * path internally, so authors never hand-build it.\n */\nexport interface RunRegisteredExporterForTestOptions {\n  /** Registered exporter name to resolve, e.g. `\"csv\"` for a `\"csv export\"` handler. */\n  exporter: string;\n  /** Optional extension name to disambiguate when several extensions register the same exporter. */\n  extensionName?: string;\n  /** Positional arguments forwarded as `context.args` (default: none). */\n  args?: readonly string[];\n  /** Parsed flags/options forwarded as `context.options` (default: none). */\n  options?: Record<string, unknown>;\n  /**\n   * Global option overrides merged onto the agent-safe test defaults\n   * (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`.\n   */\n  global?: Partial<GlobalOptions>;\n  /** Resolved pm workspace root forwarded as `context.pm_root` (default: `\"\"`). */\n  pmRoot?: string;\n}\n\n/**\n * Documents the extension deactivation expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface ExtensionDeactivationExpectation {\n  /** Expected count of extensions whose `deactivate` ran without throwing (default `1`). */\n  deactivated?: number;\n  /** Expected count of teardown failures (default `0`). */\n  failed?: number;\n}\n\n/**\n * Documents the registered command contract expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredCommandContractExpectation {\n  command: string;\n  action?: string;\n  extensionName?: string;\n  arguments?: string[];\n  flags?: string[];\n}\n\n/**\n * Documents the registered command contract assertion payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredCommandContractAssertion {\n  command: RegisteredExtensionCommandDefinition;\n  flags: FlagDefinition[];\n}\n\n/**\n * Documents the registered flags expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredFlagsExpectation {\n  targetCommand: string;\n  extensionName?: string;\n  flags?: string[];\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\n/**\n * Documents the registered hook expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredHookExpectation {\n  kind: RegisteredHookKind;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered search provider expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredSearchProviderExpectation {\n  provider: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered vector store adapter expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredVectorStoreAdapterExpectation {\n  adapter: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered importer expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredImporterExpectation {\n  importer: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered exporter expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredExporterExpectation {\n  exporter: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered item field expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredItemFieldExpectation {\n  field: string;\n  extensionName?: string;\n  type?: SchemaFieldDefinition[\"type\"];\n}\n\n/**\n * Documents the registered item field assertion payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredItemFieldAssertion {\n  registration: RegisteredExtensionSchemaFieldDefinitions;\n  field: SchemaFieldDefinition;\n}\n\n/**\n * Documents the registered item type expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredItemTypeExpectation {\n  itemType: string;\n  extensionName?: string;\n  folder?: string;\n}\n\n/**\n * Documents the registered item type assertion payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredItemTypeAssertion {\n  registration: RegisteredExtensionSchemaItemTypeDefinitions;\n  itemType: SchemaItemTypeDefinition;\n}\n\n/**\n * Documents the registered command override expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredCommandOverrideExpectation {\n  command: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered parser override expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredParserOverrideExpectation {\n  command: string;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered preflight override expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredPreflightOverrideExpectation {\n  extensionName?: string;\n}\n\n/**\n * Documents the registered renderer override expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredRendererOverrideExpectation {\n  format: OutputRendererFormat;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered service override expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredServiceOverrideExpectation {\n  service: ExtensionServiceName;\n  extensionName?: string;\n}\n\n/**\n * Documents the registered migration expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface RegisteredMigrationExpectation {\n  migration: string;\n  extensionName?: string;\n  mandatory?: boolean;\n}\n\n/**\n * Documents the extension capability usage expectation payload exchanged by command, SDK, and package integrations.\n */\nexport interface ExtensionCapabilityUsageExpectation {\n  /**\n   * Capabilities the manifest declares. Mirror `manifest.capabilities` here so\n   * the assertion fails when the manifest grants more than the code uses.\n   */\n  declared: readonly ExtensionCapability[];\n  /** Restrict reconciliation to a single extension when the activation has several. */\n  extensionName?: string;\n  /**\n   * Capabilities allowed to be declared without being exercised (e.g. ones a\n   * runtime registers only behind a config flag). These are excluded from the\n   * least-privilege failure.\n   */\n  allowUnused?: readonly ExtensionCapability[];\n}\n\n/**\n * Documents the extension capability usage assertion payload exchanged by command, SDK, and package integrations.\n */\nexport interface ExtensionCapabilityUsageAssertion {\n  /** Declared capabilities considered, sorted and de-duplicated. */\n  declared: ExtensionCapability[];\n  /** Capabilities the extension actually registered against, sorted. */\n  used: ExtensionCapability[];\n  /** Declared capabilities with no matching registration after the allowlist. */\n  unused: ExtensionCapability[];\n}\n\n/**\n * Restricts package manifest resource expectation values accepted by command, SDK, and storage contracts.\n */\nexport type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;\n\n/**\n * Documents the package manifest expectation payload exchanged by command, SDK, and package integrations.\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 resolveTestExtensionName(manifest: Partial<ExtensionManifest>, explicitName: string | undefined): string {\n  return (\n    explicitName ??\n    (typeof manifest.name === \"string\" && manifest.name.trim().length > 0 ? manifest.name.trim() : \"test-extension\")\n  );\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 * Build the synthetic single-extension {@link ExtensionLoadResult} shared by the\n * activate/deactivate test helpers, so both stay aligned with the loader's load\n * contract as it evolves. The `loaded` entry mirrors the real on-disk shape\n * (including `capabilities` and the compatibility fields) while leaving\n * filesystem paths empty, since the module is supplied in memory.\n */\nfunction buildSingleExtensionLoadResult(\n  module: unknown,\n  manifest: Partial<ExtensionManifest>,\n  identity: { name: string; layer: ExtensionLayer; capabilities: ExtensionCapability[]; policy: ExtensionGovernancePolicy },\n): ExtensionLoadResult {\n  return {\n    disabled_by_flag: false,\n    roots: { global: \"\", project: \"\" },\n    configured_enabled: [],\n    configured_disabled: [],\n    discovered: [],\n    effective: [],\n    warnings: [],\n    policy: identity.policy,\n    failed: [],\n    loaded: [\n      {\n        layer: identity.layer,\n        directory: \"\",\n        manifest_path: \"\",\n        name: identity.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: identity.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 * 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  return activateExtensions(\n    buildSingleExtensionLoadResult(module, manifest, {\n      name: resolveTestExtensionName(manifest, options.name),\n      layer: options.layer ?? \"project\",\n      capabilities: readTestExtensionCapabilities(manifest, options),\n      policy: options.policy ?? createDefaultExtensionGovernancePolicy(),\n    }),\n  );\n}\n\n/**\n * Deactivate one in-memory extension module for package tests — the teardown\n * counterpart to {@link activateExtensionForTest}.\n *\n * Runs pm's real `deactivateExtensions` engine (including its bounded per-hook\n * timeout and best-effort failure capture) over a single synthetic load entry,\n * so authors can prove an extension's `deactivate` releases the resources its\n * `activate` opened — without importing private loader internals or staging a\n * workspace. Resolve `name`/`layer` the same way {@link activateExtensionForTest}\n * does so a forwarded `activation` result skips a failed extension correctly.\n */\nexport async function deactivateExtensionForTest(\n  module: unknown,\n  options: DeactivateExtensionForTestOptions = {},\n): Promise<ExtensionDeactivationResult> {\n  const manifest = readTestExtensionManifest(module);\n  return deactivateExtensions(\n    buildSingleExtensionLoadResult(module, manifest, {\n      name: resolveTestExtensionName(manifest, options.name),\n      layer: options.layer ?? \"project\",\n      capabilities: readTestExtensionCapabilities(manifest, {}),\n      policy: createDefaultExtensionGovernancePolicy(),\n    }),\n    options.activation,\n    options.deactivateTimeoutMs === undefined ? {} : { deactivate_timeout_ms: options.deactivateTimeoutMs },\n  );\n}\n\n/**\n * Invoke a registered extension command handler and return its real\n * {@link CommandHandlerResult} so package tests can assert on behavior — not\n * just that the command was registered.\n *\n * This is the \"invoke\" verb that completes the package-author testing loop:\n * `activateExtensionForTest` → `assertRegisteredCommandContract` → **run** →\n * `deactivateExtensionForTest`. It runs pm's real handler-dispatch engine\n * (`runCommandHandler`) over `activation.commands`, building the\n * `CommandHandlerContext` with agent-safe global defaults\n * (`{ json: true, quiet: true, noPager: true }`) that callers may override.\n *\n * Because `registerImporter`/`registerExporter` register their handlers under\n * the `\"<name> import\"` / `\"<name> export\"` command paths, this same helper\n * exercises importer and exporter handlers too.\n *\n * Throws a descriptive error (listing the available handler command paths) when\n * no handler is registered for `command`, since that is a wiring/typo bug in the\n * test rather than a behavior under test. When a handler is found, the result is\n * returned verbatim: a clean run yields `{ handled: true, result, warnings: [] }`,\n * while a handler that throws a non-exit error yields\n * `{ handled: false, warnings: [code], errorMessage }` so the failure can be\n * asserted. A handler that throws an error carrying a numeric `exitCode`\n * propagates the throw, matching runtime semantics.\n */\nexport async function runRegisteredCommandForTest(\n  commands: ExtensionCommandRegistry,\n  options: RunRegisteredCommandForTestOptions,\n): Promise<CommandHandlerResult> {\n  const command = normalizeSdkCommandName(options.command);\n  if (command.length === 0) {\n    throw new Error(\"Expected command name must be a non-empty string\");\n  }\n  const hasHandler = commands.handlers.some((entry) => entry.command === command);\n  if (!hasHandler) {\n    const available = sortedUnique(commands.handlers.map((entry) => entry.command));\n    throw new Error(\n      `Expected a registered command handler for \"${command}\" to invoke. Available command handlers: ${formatAvailable(\n        available,\n      )}`,\n    );\n  }\n  return runCommandHandler(commands, {\n    command,\n    args: options.args ? [...options.args] : [],\n    options: options.options ? { ...options.options } : {},\n    global: { json: true, quiet: true, noPager: true, ...options.global },\n    pm_root: options.pmRoot ?? \"\",\n  });\n}\n\n/**\n * Fire every registered lifecycle hook of a given `kind` through pm's real hook\n * runner and return the warnings array so package tests can assert on behavior —\n * not just that a hook was registered.\n *\n * This is the hook counterpart to {@link runRegisteredCommandForTest}, extending\n * the package-author \"invoke\" verb to the `api.hooks.*` surface. Pass the\n * `ExtensionHookRegistry` from `activateExtensionForTest(...).hooks` together with\n * the lifecycle `kind` and a synthetic context. Hooks observe their inputs via a\n * cloned context snapshot (mutations never leak back to the caller), so the\n * observable signal is twofold: any side effects the hook performs, and the\n * returned warnings. A clean run returns `[]`; a hook that throws contributes one\n * `extension_hook_failed:<layer>:<name>:<hookName>` warning, mirroring runtime\n * dispatch which isolates a failing hook without aborting the others.\n *\n * Throws a descriptive error (listing the hook kinds that do have registrations)\n * when no hook of `kind` is registered, since firing a hook the extension never\n * registered is a wiring/typo bug in the test rather than a behavior under test.\n */\nexport async function runRegisteredHookForTest(\n  hooks: ExtensionHookRegistry,\n  options: RunRegisteredHookForTestOptions,\n): Promise<string[]> {\n  if (hooks[HOOK_KIND_TO_REGISTRY_FIELD[options.kind]].length === 0) {\n    const populatedKinds = sortedUnique(\n      (Object.keys(HOOK_KIND_TO_REGISTRY_FIELD) as RegisteredHookKind[]).filter(\n        (kind) => hooks[HOOK_KIND_TO_REGISTRY_FIELD[kind]].length > 0,\n      ),\n    );\n    throw new Error(\n      `Expected a registered \"${options.kind}\" hook to invoke. Hook kinds with registrations: ${formatAvailable(\n        populatedKinds,\n      )}`,\n    );\n  }\n  switch (options.kind) {\n    case \"before_command\":\n      return runBeforeCommandHooks(hooks, options.context);\n    case \"after_command\":\n      return runAfterCommandHooks(hooks, options.context);\n    case \"on_read\":\n      return runOnReadHooks(hooks, options.context);\n    case \"on_write\":\n      return runOnWriteHooks(hooks, options.context);\n    case \"on_index\":\n      return runOnIndexHooks(hooks, options.context);\n  }\n}\n\n/**\n * Invoke a registered parser override through pm's real runner and return the\n * resolved {@link ParserOverrideResult}, so package tests can assert the rewritten\n * args/options/global an override produces for a command before dispatch.\n *\n * Guards that a parser override is registered for the (normalized) target command\n * before delegating: without a match `runParserOverride` would silently return\n * `overridden: false`, hiding a typo'd command name in the test. When a match\n * exists the result is returned verbatim — `overridden: true` with the rewritten\n * context on success, or `overridden: false` with an\n * `extension_parser_override_failed:*` warning when the override throws.\n */\nexport async function runRegisteredParserOverrideForTest(\n  parsers: ExtensionParserRegistry,\n  context: ParserOverrideContext,\n): Promise<ParserOverrideResult> {\n  const command = normalizeSdkCommandName(context.command);\n  if (!parsers.overrides.some((entry) => entry.command === command)) {\n    throw new Error(\n      `Expected a registered parser override for command \"${command}\" to invoke. Available parser override commands: ${formatAvailable(\n        sortedUnique(parsers.overrides.map((entry) => entry.command)),\n      )}`,\n    );\n  }\n  return runParserOverride(parsers, context);\n}\n\n/**\n * Invoke the active preflight override through pm's real runner and return the\n * resolved {@link PreflightOverrideResult}, so package tests can assert the\n * migration/format gate decision an override yields.\n *\n * Unlike command-scoped overrides, the runtime applies the **last** registered\n * preflight override regardless of command, so this helper guards only that at\n * least one preflight override is registered before delegating. The result is\n * returned verbatim — `overridden: true` with the adjusted decision on success,\n * or `overridden: false` with an `extension_preflight_override_failed:*` warning\n * when the override throws.\n */\nexport async function runRegisteredPreflightOverrideForTest(\n  preflight: ExtensionPreflightRegistry,\n  context: PreflightOverrideContext,\n): Promise<PreflightOverrideResult> {\n  if (preflight.overrides.length === 0) {\n    throw new Error(\n      \"Expected a registered preflight override to invoke, but none are registered.\",\n    );\n  }\n  return runPreflightOverride(preflight, context);\n}\n\n/**\n * Invoke a registered command-result override through pm's real runner and return\n * the resolved {@link CommandOverrideResult}, so package tests can assert how an\n * override transforms a command's result payload.\n *\n * Accepts the same `ExtensionCommandRegistry` exposed as\n * `activateExtensionForTest(...).commands` (it carries both handlers and\n * overrides). Guards that an override is registered for the (normalized) target\n * command before delegating, so a typo'd command name surfaces as a clear error\n * rather than a silent `overridden: false`. The result is returned verbatim —\n * including the `extension_command_override_async_unsupported:*` warning the\n * runtime emits when an override returns a Promise (command overrides are\n * synchronous), or an `extension_command_override_failed:*` warning on throw.\n */\nexport async function runRegisteredCommandOverrideForTest(\n  commands: ExtensionCommandRegistry,\n  context: CommandOverrideContext,\n): Promise<CommandOverrideResult> {\n  const command = normalizeSdkCommandName(context.command);\n  if (!commands.overrides.some((entry) => entry.command === command)) {\n    throw new Error(\n      `Expected a registered command override for command \"${command}\" to invoke. Available command override commands: ${formatAvailable(\n        sortedUnique(commands.overrides.map((entry) => entry.command)),\n      )}`,\n    );\n  }\n  return runCommandOverride(commands, context);\n}\n\n/**\n * Invoke a registered renderer override through pm's real runner and return the\n * resolved {@link RendererOverrideResult}, so package tests can assert the custom\n * string an override renders for a given output `format`.\n *\n * Guards that a renderer override is registered for `context.format` before\n * delegating, so a wrong format surfaces as a clear error rather than a silent\n * `overridden: false`. The result is returned verbatim — `overridden: true` with\n * the rendered string on success, or `overridden: false` (with an\n * `extension_renderer_invalid_result:*` / `extension_renderer_failed:*` warning\n * where applicable) when the override returns a non-string or throws.\n */\nexport async function runRegisteredRendererOverrideForTest(\n  renderers: ExtensionRendererRegistry,\n  context: RendererOverrideContext,\n): Promise<RendererOverrideResult> {\n  if (!renderers.overrides.some((entry) => entry.format === context.format)) {\n    throw new Error(\n      `Expected a registered renderer override for format \"${context.format}\" to invoke. Available renderer override formats: ${formatAvailable(\n        sortedUnique(renderers.overrides.map((entry) => entry.format)),\n      )}`,\n    );\n  }\n  return runRendererOverride(renderers, context);\n}\n\n/**\n * Invoke a registered service override through pm's real runner and return the\n * resolved {@link ServiceOverrideResult}, so package tests can assert how an\n * override handles an internal service payload (e.g. `output_format`).\n *\n * Guards that a service override is registered for `context.service` before\n * delegating, so a wrong service name surfaces as a clear error rather than a\n * silent `handled: false`. The result is returned verbatim — `handled: true` with\n * the override's result when it claims the payload, or `handled: false` with the\n * original payload (and any `extension_service_override_*` warnings) otherwise.\n */\nexport async function runRegisteredServiceOverrideForTest(\n  services: ExtensionServiceRegistry,\n  context: ServiceOverrideContext,\n): Promise<ServiceOverrideResult> {\n  if (!services.overrides.some((entry) => entry.service === context.service)) {\n    throw new Error(\n      `Expected a registered service override for service \"${context.service}\" to invoke. Available service override services: ${formatAvailable(\n        sortedUnique(services.overrides.map((entry) => entry.service)),\n      )}`,\n    );\n  }\n  return runServiceOverride(services, context);\n}\n\n/**\n * Maps each search-provider operation to the runtime-definition keys that may\n * hold its function, in priority order. The host accepts both camelCase and\n * snake_case spellings for the multi-word operations, so this helper mirrors that\n * by trying `embedBatch` before `embed_batch` and `queryExpansion` before\n * `query_expansion`.\n */\nconst SEARCH_PROVIDER_OPERATION_DEFINITION_KEYS: Record<keyof SearchProviderOperationContexts, readonly string[]> = {\n  query: [\"query\"],\n  embed: [\"embed\"],\n  embedBatch: [\"embedBatch\", \"embed_batch\"],\n  queryExpansion: [\"queryExpansion\", \"query_expansion\"],\n  rerank: [\"rerank\"],\n};\n\n/**\n * Invoke an operation of a registered search provider through the same name\n * resolution the host uses and return the operation's result, so package tests\n * can assert a custom provider's runtime behavior — not just that it registered.\n *\n * This is the search-provider counterpart to {@link runRegisteredCommandForTest},\n * extending the package-author \"invoke\" verb to the `api.registerSearchProvider`\n * surface. Pass the `ExtensionRegistrationRegistry` from\n * `activateExtensionForTest(...).registrations`, the registered provider name, the\n * `operation` to exercise (`query`, `embed`, `embedBatch`, `queryExpansion`, or\n * `rerank`), and a synthetic context. The provider is resolved via\n * {@link resolveRegisteredSearchProvider} (case-insensitive, last registration\n * wins) and the operation is invoked on its `runtime_definition` — the clone that\n * preserves live functions, matching what the runtime dispatches.\n *\n * Throws a descriptive error listing the available providers when the name is not\n * registered, and a separate error when the resolved provider does not implement\n * the requested operation, since invoking an absent provider/operation is a\n * wiring bug in the test rather than a behavior under test.\n */\nexport async function runRegisteredSearchProviderForTest<Operation extends keyof SearchProviderOperationContexts>(\n  registrations: ExtensionRegistrationRegistry,\n  options: {\n    provider: string;\n    operation: Operation;\n    context: SearchProviderOperationContexts[Operation];\n  },\n): Promise<SearchProviderOperationResults[Operation]> {\n  const registration = resolveRegisteredSearchProvider(registrations, options.provider);\n  if (!registration) {\n    const available = sortedUnique(registrations.search_providers.map((entry) => entry.definition.name));\n    throw new Error(\n      `Expected a registered search provider \"${options.provider}\" to invoke. Available search providers: ${formatAvailable(\n        available,\n      )}`,\n    );\n  }\n  const runtimeDefinition = registration.runtime_definition;\n  const operationFn = SEARCH_PROVIDER_OPERATION_DEFINITION_KEYS[options.operation]\n    .map((key) => runtimeDefinition[key])\n    .find((value) => typeof value === \"function\");\n  if (typeof operationFn !== \"function\") {\n    throw new Error(\n      `Registered search provider \"${options.provider}\" does not implement the \"${options.operation}\" operation.`,\n    );\n  }\n  return (await (operationFn as (context: SearchProviderOperationContexts[Operation]) => unknown)(\n    options.context,\n  )) as SearchProviderOperationResults[Operation];\n}\n\n/**\n * Invoke an operation of a registered vector store adapter through the same name\n * resolution the host uses and return the operation's result, so package tests\n * can assert a custom adapter's runtime behavior — not just that it registered.\n *\n * This is the vector-store counterpart to {@link runRegisteredSearchProviderForTest}.\n * Pass the `ExtensionRegistrationRegistry` from\n * `activateExtensionForTest(...).registrations`, the registered adapter name, the\n * `operation` to exercise (`query`, `upsert`, or `delete`), and a synthetic\n * context. The adapter is resolved via {@link resolveRegisteredVectorStoreAdapter}\n * (case-insensitive, last registration wins) and the operation is invoked on its\n * `runtime_definition` — the clone that preserves live functions, matching what\n * the runtime dispatches.\n *\n * Throws a descriptive error listing the available adapters when the name is not\n * registered, and a separate error when the resolved adapter does not implement\n * the requested operation.\n */\nexport async function runRegisteredVectorStoreAdapterForTest<\n  Operation extends keyof VectorStoreAdapterOperationContexts,\n>(\n  registrations: ExtensionRegistrationRegistry,\n  options: {\n    adapter: string;\n    operation: Operation;\n    context: VectorStoreAdapterOperationContexts[Operation];\n  },\n): Promise<VectorStoreAdapterOperationResults[Operation]> {\n  const registration = resolveRegisteredVectorStoreAdapter(registrations, options.adapter);\n  if (!registration) {\n    const available = sortedUnique(registrations.vector_store_adapters.map((entry) => entry.definition.name));\n    throw new Error(\n      `Expected a registered vector store adapter \"${options.adapter}\" to invoke. Available vector store adapters: ${formatAvailable(\n        available,\n      )}`,\n    );\n  }\n  const operationFn = registration.runtime_definition[options.operation];\n  if (typeof operationFn !== \"function\") {\n    throw new Error(\n      `Registered vector store adapter \"${options.adapter}\" does not implement the \"${options.operation}\" operation.`,\n    );\n  }\n  return (await (operationFn as (context: VectorStoreAdapterOperationContexts[Operation]) => unknown)(\n    options.context,\n  )) as VectorStoreAdapterOperationResults[Operation];\n}\n\n/**\n * Invoke a registered schema migration's `run` function through the same runtime\n * definition the host executes and return its result, so package tests can assert\n * a migration's behavior — not just that it registered.\n *\n * This completes the package-author \"invoke\" verb across every executable\n * registration surface. The migration is resolved by id via\n * {@link assertRegisteredMigration} (which throws a descriptive \"available\n * migrations\" error when absent), then `run` is invoked on its\n * `runtime_definition` with a context mirroring the one\n * `executeRegisteredRuntimeMigrations` builds at runtime: the resolved id,\n * `command: \"migration\"`, the registering extension's layer/name, the supplied\n * `pmRoot`, and the migration's normalized status. Unlike the runtime — which\n * skips already-applied migrations and folds a throw into a warning — this helper\n * always invokes `run` and lets a throw propagate, so authors can assert both the\n * success result and failure via rejection.\n *\n * Throws when the resolved migration declares no `run` function, since invoking a\n * runless migration is a wiring bug in the test rather than a behavior under test.\n */\nexport async function runRegisteredMigrationForTest(\n  registrations: ExtensionRegistrationRegistry,\n  options: RunRegisteredMigrationForTestOptions,\n): Promise<unknown> {\n  const migration = assertRegisteredMigration(registrations, {\n    migration: options.migration,\n    extensionName: options.extensionName,\n  });\n  const run = getMigrationRuntimeDefinition(migration).run;\n  if (typeof run !== \"function\") {\n    throw new Error(`Registered migration \"${options.migration}\" does not implement a run function to invoke.`);\n  }\n  const declaredStatus = migration.definition.status;\n  const context: SchemaMigrationRunContext = {\n    id: migration.definition.id as string,\n    command: \"migration\",\n    layer: migration.layer,\n    extension: migration.name,\n    pm_root: options.pmRoot ?? \"\",\n    status: (typeof declaredStatus === \"string\" ? declaredStatus.trim().toLowerCase() : \"\") || \"pending\",\n  };\n  return await (run as (context: SchemaMigrationRunContext) => unknown)(context);\n}\n\n/**\n * Invoke a registered extension importer through pm's real handler-dispatch\n * engine and return its {@link CommandHandlerResult}, so package tests can assert\n * an importer's behavior — not just that it registered.\n *\n * This is the importer counterpart to {@link runRegisteredCommandForTest},\n * extending the package-author \"invoke\" verb to the `api.registerImporter`\n * surface. Because `registerImporter(name, fn)` wraps `fn` into a command handler\n * at the `\"<name> import\"` path, invoking it through `runRegisteredCommandForTest`\n * requires the author to know that naming convention and to remember that an\n * importer is reachable as a command at all. This helper closes both gaps: it\n * accepts the registered importer name directly, validates via\n * {@link assertRegisteredImporter} that it is genuinely a registered importer\n * (not merely some command parked at that path), derives the command path, and\n * dispatches through the same engine.\n *\n * The full activation result is required because importer execution spans two\n * sub-registries: `registrations.importers` proves the importer exists, while\n * `commands` holds the wrapped handler. The result is returned verbatim from the\n * command engine: a clean run yields `{ handled: true, result, warnings: [] }`\n * (where `result` is the importer's return value), a non-exit throw yields\n * `{ handled: false, warnings: [code], errorMessage }`, and an error carrying a\n * numeric `exitCode` propagates — matching runtime import semantics.\n *\n * Throws a descriptive \"available importers\" error (via `assertRegisteredImporter`)\n * when no importer matches, since that is a wiring/typo bug in the test rather\n * than a behavior under test.\n */\nexport async function runRegisteredImporterForTest(\n  activation: ExtensionActivationResult,\n  options: RunRegisteredImporterForTestOptions,\n): Promise<CommandHandlerResult> {\n  const importer = assertRegisteredImporter(activation.registrations, {\n    importer: options.importer,\n    extensionName: options.extensionName,\n  });\n  return runRegisteredCommandForTest(activation.commands, {\n    command: `${importer.importer} import`,\n    args: options.args,\n    options: options.options,\n    global: options.global,\n    pmRoot: options.pmRoot,\n  });\n}\n\n/**\n * Invoke a registered extension exporter through pm's real handler-dispatch\n * engine and return its {@link CommandHandlerResult}, so package tests can assert\n * an exporter's behavior — not just that it registered.\n *\n * This is the exporter counterpart to {@link runRegisteredImporterForTest} and\n * the final surface in the package-author \"invoke\" verb. Because\n * `registerExporter(name, fn)` wraps `fn` into a command handler at the\n * `\"<name> export\"` path, this helper accepts the registered exporter name\n * directly, validates via {@link assertRegisteredExporter} that it is genuinely a\n * registered exporter, derives the command path, and dispatches through the same\n * engine. See {@link runRegisteredImporterForTest} for the full activation\n * rationale and return semantics (which apply identically here).\n *\n * Throws a descriptive \"available exporters\" error (via `assertRegisteredExporter`)\n * when no exporter matches, since that is a wiring/typo bug in the test rather\n * than a behavior under test.\n */\nexport async function runRegisteredExporterForTest(\n  activation: ExtensionActivationResult,\n  options: RunRegisteredExporterForTestOptions,\n): Promise<CommandHandlerResult> {\n  const exporter = assertRegisteredExporter(activation.registrations, {\n    exporter: options.exporter,\n    extensionName: options.extensionName,\n  });\n  return runRegisteredCommandForTest(activation.commands, {\n    command: `${exporter.exporter} export`,\n    args: options.args,\n    options: options.options,\n    global: options.global,\n    pmRoot: options.pmRoot,\n  });\n}\n\n/**\n * Assert that an {@link ExtensionDeactivationResult} reports the expected clean\n * teardown counts, throwing a descriptive error otherwise. Defaults assert the\n * single-extension happy path — exactly one extension deactivated and none\n * failed. Returns the result so assertions can chain.\n */\nexport function assertExtensionDeactivated(\n  result: ExtensionDeactivationResult,\n  expectation: ExtensionDeactivationExpectation = {},\n): ExtensionDeactivationResult {\n  const expectedDeactivated = expectation.deactivated ?? 1;\n  if (result.deactivated !== expectedDeactivated) {\n    throw new Error(\n      `Expected ${expectedDeactivated} extension${expectedDeactivated === 1 ? \"\" : \"s\"} to deactivate cleanly, ` +\n        `but ${result.deactivated} did.`,\n    );\n  }\n  const expectedFailed = expectation.failed ?? 0;\n  if (result.failed.length !== expectedFailed) {\n    const detail = result.failed.map((failure) => `${failure.layer}:${failure.name} (${failure.error})`).join(\", \");\n    throw new Error(\n      `Expected ${expectedFailed} teardown failure${expectedFailed === 1 ? \"\" : \"s\"}, ` +\n        `but observed ${result.failed.length}${detail.length > 0 ? `: ${detail}` : \"\"}.`,\n    );\n  }\n  return result;\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 registration registry contains flags\n * injected into an existing command through `api.registerFlags(...)`.\n */\nexport function assertRegisteredFlags(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredFlagsExpectation,\n): RegisteredExtensionFlagDefinitions {\n  const expectedCommand = normalizeSdkCommandName(expectation.targetCommand);\n  if (expectedCommand.length === 0) {\n    throw new Error(\"Expected target command name must be a non-empty string\");\n  }\n\n  const candidates = registrations.flags.filter((entry) => entry.target_command === expectedCommand);\n  let registration: RegisteredExtensionFlagDefinitions | undefined;\n  if (expectation.extensionName) {\n    registration = candidates.find((entry) => entry.name === expectation.extensionName);\n  } else if (candidates.length === 1) {\n    registration = candidates[0];\n  } else if (candidates.length > 1) {\n    const availableExtensions = sortedUnique(candidates.map((entry) => entry.name));\n    throw new Error(\n      `Expected flags for target command \"${expectedCommand}\" matched multiple extensions: ${formatAvailable(\n        availableExtensions,\n      )}. Specify extensionName to choose one registration.`,\n    );\n  }\n  if (!registration) {\n    const available = sortedUnique(registrations.flags.map((entry) => entry.target_command));\n    const availableExtensions = sortedUnique(candidates.map((entry) => entry.name));\n    throw new Error(\n      `Expected flags for target command \"${expectedCommand}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available flag target commands: ${formatAvailable(available)}; matching extensions: ${formatAvailable(\n        availableExtensions,\n      )}`,\n    );\n  }\n\n  if (expectation.flags !== undefined) {\n    const actualFlagLabels = collectFlagLabels(registration.flags);\n    const missingFlags = expectation.flags.filter((flag) => !actualFlagLabels.has(flag));\n    if (missingFlags.length > 0) {\n      throw new Error(\n        `Expected flags for target command \"${expectedCommand}\" to include ${formatAvailable(\n          expectation.flags,\n        )}; missing ${formatAvailable(missingFlags)}; available ${formatAvailable(\n          [...actualFlagLabels].sort((left, right) => left.localeCompare(right)),\n        )}`,\n      );\n    }\n  }\n\n  return registration;\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\n/**\n * Assert that an activated extension service registry contains a service override\n * registered via `api.registerService(service, override)` for the expected\n * service name (optionally scoped to a specific extension).\n *\n * Service overrides are surfaced via `ExtensionActivationResult.services`, not the\n * command registration registry, so this helper accepts an\n * `ExtensionServiceRegistry`.\n */\nexport function assertRegisteredServiceOverride(\n  services: ExtensionServiceRegistry,\n  expectation: RegisteredServiceOverrideExpectation,\n): RegisteredExtensionServiceOverride {\n  const expectedService = normalizeSdkIdentifier(expectation.service);\n  if (expectedService.length === 0) {\n    throw new Error(\"Expected service name must be a non-empty string\");\n  }\n\n  const candidates = services.overrides.filter((entry) => normalizeSdkIdentifier(entry.service) === expectedService);\n  const override = expectation.extensionName\n    ? candidates.find((entry) => entry.name === expectation.extensionName)\n    : candidates[0];\n  if (!override) {\n    const available = sortedUnique(services.overrides.map((entry) => entry.service));\n    throw new Error(\n      `Expected service override \"${expectedService}\"${extensionNameSuffix(\n        expectation.extensionName,\n      )} to be registered. Available service overrides: ${formatAvailable(available)}`,\n    );\n  }\n\n  return override;\n}\n\n/**\n * Assert that an activated extension registration registry contains a schema\n * migration registered via `api.registerMigration(definition)` with the expected\n * id (optionally scoped to a specific extension and asserting the `mandatory`\n * governance flag, where an unset flag is treated as non-mandatory).\n *\n * Migrations are surfaced via `ExtensionActivationResult.registrations.migrations`.\n */\nexport function assertRegisteredMigration(\n  registrations: ExtensionRegistrationRegistry,\n  expectation: RegisteredMigrationExpectation,\n): RegisteredExtensionSchemaMigrationDefinition {\n  const expectedMigration = normalizeSdkIdentifier(expectation.migration);\n  if (expectedMigration.length === 0) {\n    throw new Error(\"Expected migration id must be a non-empty string\");\n  }\n\n  const candidates = registrations.migrations.filter(\n    (entry) =>\n      (expectation.extensionName === undefined || entry.name === expectation.extensionName) &&\n      typeof entry.definition.id === \"string\" &&\n      normalizeSdkIdentifier(entry.definition.id) === expectedMigration,\n  );\n  const match = candidates.find(\n    (entry) => expectation.mandatory === undefined || (entry.definition.mandatory ?? false) === expectation.mandatory,\n  );\n  if (match) {\n    return match;\n  }\n\n  // The id (and any extension scope) matched but the `mandatory` flag did not:\n  // report the mismatch directly rather than the misleading \"not registered\"\n  // listing. Reaching here with a candidate implies `expectation.mandatory` was\n  // set, since an unset flag matches any candidate above.\n  const idMatch = candidates[0];\n  if (idMatch !== undefined) {\n    throw new Error(\n      `Expected migration \"${expectedMigration}\"${extensionNameSuffix(expectation.extensionName)} to have ` +\n        `mandatory=${expectation.mandatory}, but it is mandatory=${idMatch.definition.mandatory ?? false}.`,\n    );\n  }\n\n  const available = sortedUnique(\n    registrations.migrations.map((entry) => {\n      const id =\n        typeof entry.definition.id === \"string\" && entry.definition.id.trim().length > 0\n          ? entry.definition.id.trim()\n          : \"(unnamed)\";\n      return `${id}:${entry.definition.mandatory === true}`;\n    }),\n  );\n  throw new Error(\n    `Expected migration \"${expectedMigration}\"${extensionNameSuffix(\n      expectation.extensionName,\n    )} to be registered. Available migrations: ${formatAvailable(available)}`,\n  );\n}\n\n/**\n * Assert that an activated extension declares no capability it never uses\n * (least privilege). Pass the same capabilities as `manifest.capabilities` via\n * `expectation.declared`; the helper computes what the extension actually\n * registered against and throws when any declared capability is unused.\n *\n * This is the package-test counterpart of the advisory\n * `extension_capability_unused` warning `pm package doctor` emits, letting an\n * author catch an over-broad manifest at `npm test` time. Returns the\n * declared/used/unused breakdown for further assertions.\n */\nexport function assertExtensionCapabilityUsage(\n  activation: ExtensionActivationResult,\n  expectation: ExtensionCapabilityUsageExpectation,\n): ExtensionCapabilityUsageAssertion {\n  const toKnownCapabilitySet = (capabilities: readonly string[], field: string): Set<ExtensionCapability> => {\n    const known = new Set<ExtensionCapability>();\n    for (const capability of capabilities) {\n      const normalized = normalizeKnownExtensionCapability(capability);\n      if (normalized === null) {\n        throw new Error(\n          `Expected ${field} capability \"${capability}\" to be a known extension capability. ` +\n            \"Use canonical capability names (see manifest.capabilities).\",\n        );\n      }\n      known.add(normalized);\n    }\n    return known;\n  };\n  const declared = [...toKnownCapabilitySet(expectation.declared, \"declared\")].sort((left, right) =>\n    left.localeCompare(right),\n  );\n  const allowUnused = toKnownCapabilitySet(expectation.allowUnused ?? [], \"allowUnused\");\n  const used = collectUsedExtensionCapabilities(activation, { extensionName: expectation.extensionName });\n  const usedSet = new Set(used);\n  const unused = declared.filter((capability) => !usedSet.has(capability) && !allowUnused.has(capability));\n  if (unused.length > 0) {\n    const scopeSuffix = extensionNameSuffix(expectation.extensionName);\n    throw new Error(\n      `Expected every declared capability${scopeSuffix} to be exercised, but [${unused.join(\n        \", \",\n      )}] ${unused.length === 1 ? \"is\" : \"are\"} declared yet never registered against. ` +\n        `Remove ${unused.length === 1 ? \"it\" : \"them\"} from manifest.capabilities for least privilege, ` +\n        \"or pass allowUnused for capabilities registered only behind a runtime flag.\",\n    );\n  }\n  return { declared, used, unused };\n}\n"],"names":[],"mappings":"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","debugId":"7a8097be-5b9f-5313-9ac3-6120d2fce878"}

package/dist/types.d.ts

@@ -468,6 +468,13 @@ export interface ItemMetadata {
     title: string;
     description: string;
     type: ItemType;
+    /**
+     * On-disk front-matter format version. Absent means the implicit baseline
+     * (version 1) and is never serialized; populated only once an item advances
+     * past the baseline via a future storage migration. See
+     * core/item/item-format-version.
+     */
+    pm_format_version?: number;
     source_type?: string;
     type_options?: Record<string, string>;
     status: ItemStatus;

package/dist/types.js

@@ -4,7 +4,7 @@
  * Defines the shared project-management data model used by CLI, SDK, MCP, and packages.
  */
 
-!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]="3123775a-c8ad-5339-abf2-f3893145f1e7")}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]="46812059-b93e-5599-a222-4ac0de6f4911")}catch(e){}}();
 export const BUILTIN_ITEM_TYPE_VALUES = [
     "Epic",
     "Feature",
@@ -133,4 +133,4 @@ export const CONTEXT_SECTION_VALUES = [
     "tests",
 ];
 //# sourceMappingURL=types.js.map
-//# debugId=3123775a-c8ad-5339-abf2-f3893145f1e7
+//# debugId=46812059-b93e-5599-a222-4ac0de6f4911

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["types.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module types\n *\n * Defines the shared project-management data model used by CLI, SDK, MCP, and packages.\n */\nexport const BUILTIN_ITEM_TYPE_VALUES = [\n  \"Epic\",\n  \"Feature\",\n  \"Task\",\n  \"Chore\",\n  \"Issue\",\n  \"Decision\",\n  \"Event\",\n  \"Reminder\",\n  \"Milestone\",\n  \"Meeting\",\n  \"Plan\",\n] as const;\nexport const ITEM_TYPE_VALUES = BUILTIN_ITEM_TYPE_VALUES;\n/**\n * Restricts builtin item type values accepted by command, SDK, and storage contracts.\n */\nexport type BuiltinItemType = (typeof BUILTIN_ITEM_TYPE_VALUES)[number];\n/**\n * Restricts item type values accepted by command, SDK, and storage contracts.\n */\nexport type ItemType = string;\n\nexport const STATUS_VALUES = [\n  \"draft\",\n  \"open\",\n  \"in_progress\",\n  \"blocked\",\n  \"closed\",\n  \"canceled\",\n] as const;\n/**\n * Restricts item status values accepted by command, SDK, and storage contracts.\n */\nexport type ItemStatus = string;\n\nexport const RUNTIME_STATUS_ROLE_VALUES = [\n  \"draft\",\n  \"active\",\n  \"blocked\",\n  \"terminal\",\n  \"terminal_done\",\n  \"terminal_canceled\",\n  \"default_open\",\n  \"default_close\",\n  \"default_cancel\",\n] as const;\n/**\n * Restricts runtime status role values accepted by command, SDK, and storage contracts.\n */\nexport type RuntimeStatusRole = (typeof RUNTIME_STATUS_ROLE_VALUES)[number];\n\nexport const RUNTIME_FIELD_TYPE_VALUES = [\"string\", \"number\", \"boolean\", \"string_array\"] as const;\n/**\n * Restricts runtime field type values accepted by command, SDK, and storage contracts.\n */\nexport type RuntimeFieldType = (typeof RUNTIME_FIELD_TYPE_VALUES)[number];\n\nexport const RUNTIME_FIELD_COMMAND_VALUES = [\"create\", \"update\", \"update_many\", \"list\", \"search\", \"calendar\", \"context\"] as const;\n/**\n * Restricts runtime field command values accepted by command, SDK, and storage contracts.\n */\nexport type RuntimeFieldCommand = (typeof RUNTIME_FIELD_COMMAND_VALUES)[number];\n\nexport const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES = [\"allow\", \"warn\", \"reject\"] as const;\n/**\n * Restricts runtime unknown field policy values accepted by command, SDK, and storage contracts.\n */\nexport type RuntimeUnknownFieldPolicy = (typeof RUNTIME_UNKNOWN_FIELD_POLICY_VALUES)[number];\n\nexport const DEPENDENCY_KIND_VALUES = [\n  \"blocks\",\n  \"parent\",\n  \"child\",\n  \"parent_child\",\n  \"child_of\",\n  \"related\",\n  \"related_to\",\n  \"discovered_from\",\n  \"blocked_by\",\n  \"incident_from\",\n  \"epic\",\n  \"supersedes\",\n  \"task\",\n] as const;\n/**\n * Restricts dependency kind values accepted by command, SDK, and storage contracts.\n */\nexport type DependencyKind = (typeof DEPENDENCY_KIND_VALUES)[number];\n\nexport const SCOPE_VALUES = [\"project\", \"global\"] as const;\n/**\n * Restricts link scope values accepted by command, SDK, and storage contracts.\n */\nexport type LinkScope = (typeof SCOPE_VALUES)[number];\n\nexport const RISK_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\n/**\n * Restricts risk level values accepted by command, SDK, and storage contracts.\n */\nexport type RiskLevel = (typeof RISK_VALUES)[number];\n\nexport const ISSUE_SEVERITY_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\n/**\n * Restricts issue severity values accepted by command, SDK, and storage contracts.\n */\nexport type IssueSeverity = (typeof ISSUE_SEVERITY_VALUES)[number];\n\nexport const CONFIDENCE_TEXT_VALUES = [\"low\", \"medium\", \"high\"] as const;\n/**\n * Restricts confidence text level values accepted by command, SDK, and storage contracts.\n */\nexport type ConfidenceTextLevel = (typeof CONFIDENCE_TEXT_VALUES)[number];\n/**\n * Restricts confidence value values accepted by command, SDK, and storage contracts.\n */\nexport type ConfidenceValue = number | ConfidenceTextLevel;\n\nexport const ITEM_FORMAT_VALUES = [\"toon\", \"json_markdown\"] as const;\n/**\n * Restricts item format values accepted by command, SDK, and storage contracts.\n */\nexport type ItemFormat = (typeof ITEM_FORMAT_VALUES)[number];\n\nexport const SPRINT_RELEASE_FORMAT_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\n/**\n * Restricts sprint release format policy values accepted by command, SDK, and storage contracts.\n */\nexport type SprintReleaseFormatPolicy = (typeof SPRINT_RELEASE_FORMAT_POLICY_VALUES)[number];\nexport const PARENT_REFERENCE_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\n/**\n * Restricts parent reference policy values accepted by command, SDK, and storage contracts.\n */\nexport type ParentReferencePolicy = (typeof PARENT_REFERENCE_POLICY_VALUES)[number];\nexport const VALIDATE_METADATA_PROFILE_VALUES = [\"core\", \"strict\", \"custom\"] as const;\n/**\n * Restricts validate metadata profile values accepted by command, SDK, and storage contracts.\n */\nexport type ValidateMetadataProfile = (typeof VALIDATE_METADATA_PROFILE_VALUES)[number];\nexport const GOVERNANCE_PRESET_VALUES = [\"minimal\", \"default\", \"strict\", \"custom\"] as const;\n/**\n * Restricts governance preset values accepted by command, SDK, and storage contracts.\n */\nexport type GovernancePreset = (typeof GOVERNANCE_PRESET_VALUES)[number];\nexport const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES = [\"none\", \"warn\", \"strict\"] as const;\n/**\n * Restricts governance ownership enforcement values accepted by command, SDK, and storage contracts.\n */\nexport type GovernanceOwnershipEnforcement = (typeof GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES)[number];\nexport const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES = [\"progressive\", \"strict\"] as const;\n/**\n * Restricts governance create mode default values accepted by command, SDK, and storage contracts.\n */\nexport type GovernanceCreateModeDefault = (typeof GOVERNANCE_CREATE_MODE_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\n/**\n * Restricts governance close validation default values accepted by command, SDK, and storage contracts.\n */\nexport type GovernanceCloseValidationDefault = (typeof GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\n/**\n * Restricts governance workflow enforcement values accepted by command, SDK, and storage contracts.\n */\nexport type GovernanceWorkflowEnforcement = (typeof GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES)[number];\nexport const VALIDATE_METADATA_REQUIRED_FIELD_VALUES = [\n  \"author\",\n  \"acceptance_criteria\",\n  \"estimated_minutes\",\n  \"close_reason\",\n  \"reviewer\",\n  \"risk\",\n  \"confidence\",\n  \"sprint\",\n  \"release\",\n] as const;\n/**\n * Restricts validate metadata required field values accepted by command, SDK, and storage contracts.\n */\nexport type ValidateMetadataRequiredField = (typeof VALIDATE_METADATA_REQUIRED_FIELD_VALUES)[number];\n\nexport const RECURRENCE_FREQUENCY_VALUES = [\"daily\", \"weekly\", \"monthly\", \"yearly\"] as const;\n/**\n * Restricts recurrence frequency values accepted by command, SDK, and storage contracts.\n */\nexport type RecurrenceFrequency = (typeof RECURRENCE_FREQUENCY_VALUES)[number];\n\nexport const RECURRENCE_WEEKDAY_VALUES = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"] as const;\n/**\n * Restricts recurrence weekday values accepted by command, SDK, and storage contracts.\n */\nexport type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];\n\n/**\n * Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).\n * Shared by item serialization, create/update parsing, and calendar expansion\n * so weekday ordering cannot drift between those modules.\n */\nexport function weekdayOrderIndex(value: RecurrenceWeekday): number {\n  return RECURRENCE_WEEKDAY_VALUES.indexOf(value);\n}\n\n/**\n * Documents the dependency payload exchanged by command, SDK, and package integrations.\n */\nexport interface Dependency {\n  id: string;\n  kind: DependencyKind;\n  created_at: string;\n  author?: string;\n  source_kind?: string;\n}\n\n/**\n * Documents the comment payload exchanged by command, SDK, and package integrations.\n */\nexport interface Comment {\n  created_at: string;\n  author: string;\n  text: string;\n}\n\n/**\n * Documents the log note payload exchanged by command, SDK, and package integrations.\n */\nexport interface LogNote {\n  created_at: string;\n  author: string;\n  text: string;\n}\n\n/**\n * Documents the linked file payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedFile {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n}\n\n/**\n * Documents the linked test payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedTest {\n  command?: string;\n  path?: string;\n  scope: LinkScope;\n  timeout_seconds?: number;\n  pm_context_mode?: \"schema\" | \"tracker\" | \"auto\";\n  env_set?: Record<string, string>;\n  env_clear?: string[];\n  shared_host_safe?: boolean;\n  assert_stdout_contains?: string[];\n  assert_stdout_regex?: string[];\n  assert_stderr_contains?: string[];\n  assert_stderr_regex?: string[];\n  assert_stdout_min_lines?: number;\n  assert_json_field_equals?: Record<string, string>;\n  assert_json_field_gte?: Record<string, number>;\n  note?: string;\n}\n\n/**\n * Documents the linked doc payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedDoc {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n}\n\n/**\n * Documents the reminder payload exchanged by command, SDK, and package integrations.\n */\nexport interface Reminder {\n  at: string;\n  text: string;\n}\n\n/**\n * Documents the recurrence rule payload exchanged by command, SDK, and package integrations.\n */\nexport interface RecurrenceRule {\n  freq: RecurrenceFrequency;\n  interval?: number;\n  count?: number;\n  until?: string;\n  by_weekday?: RecurrenceWeekday[];\n  by_month_day?: number[];\n  exdates?: string[];\n}\n\n/**\n * Documents the calendar event payload exchanged by command, SDK, and package integrations.\n */\nexport interface CalendarEvent {\n  start_at: string;\n  end_at?: string;\n  title?: string;\n  description?: string;\n  location?: string;\n  all_day?: boolean;\n  timezone?: string;\n  recurrence?: RecurrenceRule;\n}\n\nexport const PLAN_MODE_VALUES = [\n  \"draft\",\n  \"research\",\n  \"review\",\n  \"approved\",\n  \"executing\",\n  \"paused\",\n  \"completed\",\n  \"superseded\",\n] as const;\n/**\n * Restricts plan mode values accepted by command, SDK, and storage contracts.\n */\nexport type PlanMode = (typeof PLAN_MODE_VALUES)[number];\n\nexport const PLAN_STEP_STATUS_VALUES = [\n  \"pending\",\n  \"in_progress\",\n  \"completed\",\n  \"blocked\",\n  \"skipped\",\n  \"superseded\",\n] as const;\n/**\n * Restricts plan step status values accepted by command, SDK, and storage contracts.\n */\nexport type PlanStepStatus = (typeof PLAN_STEP_STATUS_VALUES)[number];\n\nexport const PLAN_HARNESS_VALUES = [\"codex\", \"claude-code\", \"cursor\", \"generic\"] as const;\n/**\n * Restricts plan harness values accepted by command, SDK, and storage contracts.\n */\nexport type PlanHarness = (typeof PLAN_HARNESS_VALUES)[number];\n\nexport const PLAN_STEP_LINK_KIND_VALUES = [\n  \"related\",\n  \"blocks\",\n  \"blocked_by\",\n  \"depends_on\",\n  \"discovered_from\",\n  \"implements\",\n  \"verifies\",\n  \"supersedes\",\n] as const;\n/**\n * Restricts plan step link kind values accepted by command, SDK, and storage contracts.\n */\nexport type PlanStepLinkKind = (typeof PLAN_STEP_LINK_KIND_VALUES)[number];\n\n/**\n * Documents the plan step link payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStepLink {\n  id: string;\n  kind: PlanStepLinkKind;\n  note?: string;\n  required_before_step?: boolean;\n}\n\n/**\n * Documents the plan step file payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStepFile {\n  path: string;\n  scope?: LinkScope;\n  note?: string;\n}\n\n/**\n * Documents the plan step test payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStepTest {\n  command?: string;\n  path?: string;\n  note?: string;\n}\n\n/**\n * Documents the plan step doc payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStepDoc {\n  path: string;\n  scope?: LinkScope;\n  note?: string;\n}\n\n/**\n * Documents the plan step payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStep {\n  id: string;\n  order: number;\n  title: string;\n  body?: string;\n  status: PlanStepStatus;\n  owner?: string;\n  evidence?: string;\n  blocked_reason?: string;\n  superseded_by?: string;\n  linked_items?: PlanStepLink[];\n  files?: PlanStepFile[];\n  tests?: PlanStepTest[];\n  docs?: PlanStepDoc[];\n  created_at: string;\n  updated_at: string;\n  completed_at?: string;\n}\n\n/**\n * Documents the plan decision payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanDecision {\n  ts: string;\n  author: string;\n  decision: string;\n  rationale?: string;\n  evidence?: string;\n  step_id?: string;\n}\n\n/**\n * Documents the plan discovery payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanDiscovery {\n  ts: string;\n  author: string;\n  text: string;\n  step_id?: string;\n}\n\n/**\n * Documents the plan validation check payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanValidationCheck {\n  text: string;\n  command?: string;\n  expected?: string;\n}\n\n/**\n * Documents the item type option definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemTypeOptionDefinition {\n  key: string;\n  values: string[];\n  required?: boolean;\n  aliases?: string[];\n  description?: string;\n}\n\n/**\n * Documents the item type command option policy payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemTypeCommandOptionPolicy {\n  command: \"create\" | \"update\";\n  option: string;\n  required?: boolean;\n  visible?: boolean;\n  enabled?: boolean;\n}\n\n/**\n * Documents the item type definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemTypeDefinition {\n  name: string;\n  description?: string;\n  /**\n   * Status assigned to newly created items of this type when `--status` is not\n   * provided. Falls back to the workflow's open status when unset or invalid.\n   */\n  default_status?: string;\n  folder?: string;\n  aliases?: string[];\n  required_create_fields?: string[];\n  required_create_repeatables?: string[];\n  options?: ItemTypeOptionDefinition[];\n  command_option_policies?: ItemTypeCommandOptionPolicy[];\n}\n\n/**\n * Documents the runtime status definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeStatusDefinition {\n  id: string;\n  aliases?: string[];\n  roles?: RuntimeStatusRole[];\n  description?: string;\n  order?: number;\n}\n\n/**\n * Documents the runtime field definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeFieldDefinition {\n  key: string;\n  metadata_key?: string;\n  /**\n   * @deprecated Use metadata_key.\n   */\n  front_matter_key?: string;\n  cli_flag?: string;\n  cli_aliases?: string[];\n  description?: string;\n  type?: RuntimeFieldType;\n  commands?: RuntimeFieldCommand[];\n  repeatable?: boolean;\n  required?: boolean;\n  required_on_create?: boolean;\n  required_types?: string[];\n  allow_unset?: boolean;\n}\n\n/**\n * Documents the runtime workflow definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeWorkflowDefinition {\n  draft_status?: string;\n  open_status?: string;\n  in_progress_status?: string;\n  blocked_status?: string;\n  close_status?: string;\n  canceled_status?: string;\n}\n\n/**\n * Documents the runtime schema file config payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeSchemaFileConfig {\n  types?: string;\n  statuses?: string;\n  fields?: string;\n  workflows?: string;\n}\n\n/**\n * Per-type allowed-transition rule. A type with no matching entry is\n * unrestricted; a type with an entry allows only the listed [from, to]\n * status pairs (status tokens are resolved case-insensitively through the\n * status registry alias map; a same-status no-op is always allowed).\n */\nexport interface TypeWorkflowDefinition {\n  type: string;\n  allowed_transitions: [string, string][];\n}\n\n/**\n * Documents the runtime schema settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeSchemaSettings {\n  version: number;\n  files: RuntimeSchemaFileConfig;\n  statuses: RuntimeStatusDefinition[];\n  fields: RuntimeFieldDefinition[];\n  workflow: RuntimeWorkflowDefinition;\n  type_workflows?: TypeWorkflowDefinition[];\n  unknown_field_policy: RuntimeUnknownFieldPolicy;\n}\n\n/**\n * Documents the item test run summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemTestRunSummary {\n  run_id: string;\n  kind: \"test\" | \"test-all\";\n  status: \"passed\" | \"failed\" | \"stopped\" | \"canceled\";\n  started_at: string;\n  finished_at: string;\n  recorded_at: string;\n  attempt?: number;\n  resumed_from?: string;\n  passed: number;\n  failed: number;\n  skipped: number;\n  items?: number;\n  linked_tests?: number;\n  fail_on_skipped_triggered?: boolean;\n}\n\n/**\n * Documents the item metadata payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemMetadata {\n  id: string;\n  title: string;\n  description: string;\n  type: ItemType;\n  source_type?: string;\n  type_options?: Record<string, string>;\n  status: ItemStatus;\n  priority: 0 | 1 | 2 | 3 | 4;\n  tags: string[];\n  created_at: string;\n  updated_at: string;\n  deadline?: string;\n  reminders?: Reminder[];\n  events?: CalendarEvent[];\n  closed_at?: string;\n  assignee?: string;\n  source_owner?: string;\n  author?: string;\n  estimated_minutes?: number;\n  acceptance_criteria?: string;\n  design?: string;\n  external_ref?: string;\n  definition_of_ready?: string;\n  order?: number;\n  goal?: string;\n  objective?: string;\n  value?: string;\n  impact?: string;\n  outcome?: string;\n  why_now?: string;\n  parent?: string;\n  reviewer?: string;\n  risk?: RiskLevel;\n  confidence?: ConfidenceValue;\n  sprint?: string;\n  release?: string;\n  blocked_by?: string;\n  blocked_reason?: string;\n  unblock_note?: string;\n  reporter?: string;\n  severity?: IssueSeverity;\n  environment?: string;\n  repro_steps?: string;\n  resolution?: string;\n  expected_result?: string;\n  actual_result?: string;\n  affected_version?: string;\n  fixed_version?: string;\n  component?: string;\n  regression?: boolean;\n  customer_impact?: string;\n  dependencies?: Dependency[];\n  comments?: Comment[];\n  notes?: LogNote[];\n  learnings?: LogNote[];\n  files?: LinkedFile[];\n  tests?: LinkedTest[];\n  test_runs?: ItemTestRunSummary[];\n  docs?: LinkedDoc[];\n  close_reason?: string;\n  duplicate_of?: string;\n  plan_mode?: PlanMode;\n  plan_scope?: string;\n  plan_harness?: PlanHarness;\n  plan_steps?: PlanStep[];\n  plan_decisions?: PlanDecision[];\n  plan_discoveries?: PlanDiscovery[];\n  plan_validation?: PlanValidationCheck[];\n  plan_resume_context?: string;\n  [key: string]: unknown;\n}\n\n/**\n * @deprecated Use ItemMetadata.\n */\nexport type ItemFrontMatter = ItemMetadata;\n\n/**\n * Documents the item document payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemDocument {\n  metadata: ItemMetadata;\n  body: string;\n}\n\n/**\n * Documents the history patch op payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryPatchOp {\n  op: \"add\" | \"remove\" | \"replace\" | \"move\" | \"copy\" | \"test\";\n  path: string;\n  from?: string;\n  value?: unknown;\n}\n\n/**\n * Documents the history entry payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryEntry {\n  ts: string;\n  author: string;\n  op: string;\n  patch: HistoryPatchOp[];\n  before_hash: string;\n  after_hash: string;\n  message?: string;\n}\n\nexport const CONTEXT_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\", \"full\"] as const;\n/**\n * Restricts context depth values accepted by command, SDK, and storage contracts.\n */\nexport type ContextDepth = (typeof CONTEXT_DEPTH_VALUES)[number];\n\nexport const CONTEXT_SECTION_VALUES = [\n  \"hierarchy\",\n  \"activity\",\n  \"progress\",\n  \"recently_created\",\n  \"unparented\",\n  \"blockers\",\n  \"files\",\n  \"workload\",\n  \"staleness\",\n  \"tests\",\n] as const;\n/**\n * Restricts context section name values accepted by command, SDK, and storage contracts.\n */\nexport type ContextSectionName = (typeof CONTEXT_SECTION_VALUES)[number];\n\n/**\n * Documents the context section settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface ContextSectionSettings {\n  hierarchy: boolean;\n  activity: boolean;\n  progress: boolean;\n  recently_created: boolean;\n  unparented: boolean;\n  blockers: boolean;\n  files: boolean;\n  workload: boolean;\n  staleness: boolean;\n  tests: boolean;\n}\n\n/**\n * Documents the context settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface ContextSettings {\n  default_depth: ContextDepth;\n  activity_limit: number;\n  stale_threshold_days: number;\n  sections: ContextSectionSettings;\n}\n\n/**\n * Documents the governance settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface GovernanceSettings {\n  preset: GovernancePreset;\n  ownership_enforcement: GovernanceOwnershipEnforcement;\n  create_mode_default: GovernanceCreateModeDefault;\n  close_validation_default: GovernanceCloseValidationDefault;\n  require_close_reason: boolean;\n  parent_reference: ParentReferencePolicy;\n  metadata_profile: ValidateMetadataProfile;\n  force_required_for_stale_lock: boolean;\n  create_default_type?: string;\n  /**\n   * Per-type allowed-transition enforcement mode for `pm update --status`.\n   * Read raw from settings (not preset-derived) so existing projects are\n   * unaffected when unset; defaults to \"off\".\n   */\n  workflow_enforcement?: GovernanceWorkflowEnforcement;\n}\n\n/**\n * Restricts extension policy mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicyMode = \"off\" | \"warn\" | \"enforce\";\n/**\n * Restricts extension trust mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionTrustMode = \"off\" | \"warn\" | \"enforce\";\n/**\n * Restricts extension sandbox profile values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionSandboxProfile = \"none\" | \"restricted\" | \"strict\";\n\n/**\n * Documents the extension policy override settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface ExtensionPolicyOverrideSettings {\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\n/**\n * Documents the extension policy settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface ExtensionPolicySettings {\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: ExtensionPolicyOverrideSettings[];\n}\n\n/**\n * Documents the agent guidance settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface AgentGuidanceSettings {\n  prompt_completed: boolean;\n  declined: boolean;\n  declined_at: string;\n  template_version: number;\n  last_checked_files: string[];\n}\n\n/**\n * Restricts search mutation refresh policy values accepted by command, SDK, and storage contracts.\n */\nexport type SearchMutationRefreshPolicy = \"cache_only\" | \"semantic_configured\" | \"semantic_auto\";\n\n/**\n * Documents the search query expansion settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface SearchQueryExpansionSettings {\n  enabled: boolean;\n  provider: string;\n}\n\n/**\n * Documents the search rerank settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface SearchRerankSettings {\n  enabled: boolean;\n  model: string;\n  top_k: number;\n}\n\n/**\n * Config-driven policy for automatic history-stream compaction triage.\n *\n * When `enabled`, `pm health` surfaces an advisory warning for any history\n * stream whose non-empty entry count exceeds `max_entries`, and `pm\n * history-compact` bulk mode uses `max_entries` as its default `--all-over`\n * threshold so the configured policy drives corpus-wide sweeps. `trigger`\n * records operator intent — both values raise the health advisory; `auto`\n * additionally signals that scheduled/automatic sweeps are expected.\n */\nexport interface HistoryCompactPolicy {\n  enabled: boolean;\n  max_entries: number;\n  trigger: \"health_warn\" | \"auto\";\n}\n\n/**\n * Documents the pm settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface PmSettings {\n  version: number;\n  id_prefix: string;\n  author_default: string;\n  item_format: ItemFormat;\n  locks: {\n    ttl_seconds: number;\n  };\n  /**\n   * Retention policy for bulk-mutation rollback checkpoints written by\n   * `update-many`/`close-many`. `pm gc --scope checkpoints` prunes checkpoint\n   * files older than `retention_days`; checkpoints with an unparseable\n   * `created_at` are retained (safety-first, mirroring the stale-lock sweep).\n   */\n  checkpoints: {\n    retention_days: number;\n  };\n  output: {\n    default_format: \"toon\" | \"json\";\n  };\n  history: {\n    missing_stream: \"auto_create\" | \"strict_error\";\n    compact_policy: HistoryCompactPolicy;\n  };\n  validation: {\n    sprint_release_format: SprintReleaseFormatPolicy;\n    parent_reference: ParentReferencePolicy;\n    metadata_profile: ValidateMetadataProfile;\n    metadata_required_fields: ValidateMetadataRequiredField[];\n    lifecycle_stale_blocker_reason_patterns: string[];\n    lifecycle_closure_like_blocked_reason_patterns: string[];\n    lifecycle_closure_like_resolution_patterns: string[];\n    lifecycle_closure_like_actual_result_patterns: string[];\n    /**\n     * Per-type default estimates (minutes) used by `pm validate --auto-fix\n     * --fix-scope estimates` to backfill missing `estimated_minutes` (GH-212).\n     * Keys are item type names (case-insensitive); values are positive minutes\n     * that override the built-in defaults. Empty by default.\n     */\n    estimate_defaults_by_type: Record<string, number>;\n  };\n  governance: GovernanceSettings;\n  workflow: {\n    definition_of_done: string[];\n  };\n  testing: {\n    record_results_to_items: boolean;\n  };\n  telemetry: {\n    enabled: boolean;\n    first_run_prompt_completed: boolean;\n    capture_level: \"minimal\" | \"redacted\" | \"max\";\n    endpoint: string;\n    installation_id: string;\n    retention_days: number;\n  };\n  agent_guidance: AgentGuidanceSettings;\n  item_types: {\n    definitions: ItemTypeDefinition[];\n  };\n  schema: RuntimeSchemaSettings;\n  extensions: {\n    enabled: string[];\n    disabled: string[];\n    policy: ExtensionPolicySettings;\n  };\n  search: {\n    score_threshold: number;\n    hybrid_semantic_weight: number;\n    max_results: number;\n    embedding_model: string;\n    embedding_corpus_max_characters?: number;\n    embedding_batch_size: number;\n    embedding_timeout_ms: number;\n    scanner_max_batch_retries: number;\n    provider?: string;\n    /**\n     * Optional allow-list of corpus field names embedded for semantic search\n     * (see DEFAULT_SEARCH_CORPUS_FIELDS in core/search/corpus.ts). When unset or\n     * empty, the full default field set is used (backward compatible). When set,\n     * only the named fields are embedded — letting teams opt structured signals\n     * (priority, assignee, risk, acceptance_criteria, etc.) in/out for token\n     * efficiency. Changing this re-flags items stale on the next refresh.\n     */\n    corpus_fields?: string[];\n    mutation_refresh_policy: SearchMutationRefreshPolicy;\n    query_expansion: SearchQueryExpansionSettings;\n    rerank: SearchRerankSettings;\n    /**\n     * Offline BM25 lexical-ranking parameters (pm-75k9), applied when\n     * `search.provider` is `bm25` (or auto-selected as the offline fallback) for\n     * semantic/hybrid queries. `k1` controls term-frequency saturation, `b`\n     * controls document-length normalization. Unset → Lucene defaults (1.2/0.75).\n     */\n    bm25?: {\n      k1?: number;\n      b?: number;\n    };\n    tuning?: {\n      title_exact_bonus?: number;\n      title_weight?: number;\n      description_weight?: number;\n      tags_weight?: number;\n      status_weight?: number;\n      body_weight?: number;\n      comments_weight?: number;\n      notes_weight?: number;\n      learnings_weight?: number;\n      dependencies_weight?: number;\n      linked_content_weight?: number;\n    };\n  };\n  providers: {\n    openai: {\n      base_url: string;\n      api_key: string;\n      model: string;\n    };\n    ollama: {\n      base_url: string;\n      model: string;\n    };\n  };\n  context: ContextSettings;\n  vector_store: {\n    adapter?: string;\n    collection_name: string;\n    qdrant: {\n      url: string;\n      api_key: string;\n    };\n    lancedb: {\n      path: string;\n    };\n  };\n}\n"],"names":[],"mappings":"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","debugId":"3123775a-c8ad-5339-abf2-f3893145f1e7"}
+{"version":3,"file":"types.js","sources":["types.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module types\n *\n * Defines the shared project-management data model used by CLI, SDK, MCP, and packages.\n */\nexport const BUILTIN_ITEM_TYPE_VALUES = [\n  \"Epic\",\n  \"Feature\",\n  \"Task\",\n  \"Chore\",\n  \"Issue\",\n  \"Decision\",\n  \"Event\",\n  \"Reminder\",\n  \"Milestone\",\n  \"Meeting\",\n  \"Plan\",\n] as const;\nexport const ITEM_TYPE_VALUES = BUILTIN_ITEM_TYPE_VALUES;\n/**\n * Restricts builtin item type values accepted by command, SDK, and storage contracts.\n */\nexport type BuiltinItemType = (typeof BUILTIN_ITEM_TYPE_VALUES)[number];\n/**\n * Restricts item type values accepted by command, SDK, and storage contracts.\n */\nexport type ItemType = string;\n\nexport const STATUS_VALUES = [\n  \"draft\",\n  \"open\",\n  \"in_progress\",\n  \"blocked\",\n  \"closed\",\n  \"canceled\",\n] as const;\n/**\n * Restricts item status values accepted by command, SDK, and storage contracts.\n */\nexport type ItemStatus = string;\n\nexport const RUNTIME_STATUS_ROLE_VALUES = [\n  \"draft\",\n  \"active\",\n  \"blocked\",\n  \"terminal\",\n  \"terminal_done\",\n  \"terminal_canceled\",\n  \"default_open\",\n  \"default_close\",\n  \"default_cancel\",\n] as const;\n/**\n * Restricts runtime status role values accepted by command, SDK, and storage contracts.\n */\nexport type RuntimeStatusRole = (typeof RUNTIME_STATUS_ROLE_VALUES)[number];\n\nexport const RUNTIME_FIELD_TYPE_VALUES = [\"string\", \"number\", \"boolean\", \"string_array\"] as const;\n/**\n * Restricts runtime field type values accepted by command, SDK, and storage contracts.\n */\nexport type RuntimeFieldType = (typeof RUNTIME_FIELD_TYPE_VALUES)[number];\n\nexport const RUNTIME_FIELD_COMMAND_VALUES = [\"create\", \"update\", \"update_many\", \"list\", \"search\", \"calendar\", \"context\"] as const;\n/**\n * Restricts runtime field command values accepted by command, SDK, and storage contracts.\n */\nexport type RuntimeFieldCommand = (typeof RUNTIME_FIELD_COMMAND_VALUES)[number];\n\nexport const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES = [\"allow\", \"warn\", \"reject\"] as const;\n/**\n * Restricts runtime unknown field policy values accepted by command, SDK, and storage contracts.\n */\nexport type RuntimeUnknownFieldPolicy = (typeof RUNTIME_UNKNOWN_FIELD_POLICY_VALUES)[number];\n\nexport const DEPENDENCY_KIND_VALUES = [\n  \"blocks\",\n  \"parent\",\n  \"child\",\n  \"parent_child\",\n  \"child_of\",\n  \"related\",\n  \"related_to\",\n  \"discovered_from\",\n  \"blocked_by\",\n  \"incident_from\",\n  \"epic\",\n  \"supersedes\",\n  \"task\",\n] as const;\n/**\n * Restricts dependency kind values accepted by command, SDK, and storage contracts.\n */\nexport type DependencyKind = (typeof DEPENDENCY_KIND_VALUES)[number];\n\nexport const SCOPE_VALUES = [\"project\", \"global\"] as const;\n/**\n * Restricts link scope values accepted by command, SDK, and storage contracts.\n */\nexport type LinkScope = (typeof SCOPE_VALUES)[number];\n\nexport const RISK_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\n/**\n * Restricts risk level values accepted by command, SDK, and storage contracts.\n */\nexport type RiskLevel = (typeof RISK_VALUES)[number];\n\nexport const ISSUE_SEVERITY_VALUES = [\"low\", \"medium\", \"high\", \"critical\"] as const;\n/**\n * Restricts issue severity values accepted by command, SDK, and storage contracts.\n */\nexport type IssueSeverity = (typeof ISSUE_SEVERITY_VALUES)[number];\n\nexport const CONFIDENCE_TEXT_VALUES = [\"low\", \"medium\", \"high\"] as const;\n/**\n * Restricts confidence text level values accepted by command, SDK, and storage contracts.\n */\nexport type ConfidenceTextLevel = (typeof CONFIDENCE_TEXT_VALUES)[number];\n/**\n * Restricts confidence value values accepted by command, SDK, and storage contracts.\n */\nexport type ConfidenceValue = number | ConfidenceTextLevel;\n\nexport const ITEM_FORMAT_VALUES = [\"toon\", \"json_markdown\"] as const;\n/**\n * Restricts item format values accepted by command, SDK, and storage contracts.\n */\nexport type ItemFormat = (typeof ITEM_FORMAT_VALUES)[number];\n\nexport const SPRINT_RELEASE_FORMAT_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\n/**\n * Restricts sprint release format policy values accepted by command, SDK, and storage contracts.\n */\nexport type SprintReleaseFormatPolicy = (typeof SPRINT_RELEASE_FORMAT_POLICY_VALUES)[number];\nexport const PARENT_REFERENCE_POLICY_VALUES = [\"warn\", \"strict_error\"] as const;\n/**\n * Restricts parent reference policy values accepted by command, SDK, and storage contracts.\n */\nexport type ParentReferencePolicy = (typeof PARENT_REFERENCE_POLICY_VALUES)[number];\nexport const VALIDATE_METADATA_PROFILE_VALUES = [\"core\", \"strict\", \"custom\"] as const;\n/**\n * Restricts validate metadata profile values accepted by command, SDK, and storage contracts.\n */\nexport type ValidateMetadataProfile = (typeof VALIDATE_METADATA_PROFILE_VALUES)[number];\nexport const GOVERNANCE_PRESET_VALUES = [\"minimal\", \"default\", \"strict\", \"custom\"] as const;\n/**\n * Restricts governance preset values accepted by command, SDK, and storage contracts.\n */\nexport type GovernancePreset = (typeof GOVERNANCE_PRESET_VALUES)[number];\nexport const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES = [\"none\", \"warn\", \"strict\"] as const;\n/**\n * Restricts governance ownership enforcement values accepted by command, SDK, and storage contracts.\n */\nexport type GovernanceOwnershipEnforcement = (typeof GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES)[number];\nexport const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES = [\"progressive\", \"strict\"] as const;\n/**\n * Restricts governance create mode default values accepted by command, SDK, and storage contracts.\n */\nexport type GovernanceCreateModeDefault = (typeof GOVERNANCE_CREATE_MODE_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\n/**\n * Restricts governance close validation default values accepted by command, SDK, and storage contracts.\n */\nexport type GovernanceCloseValidationDefault = (typeof GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES)[number];\nexport const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES = [\"off\", \"warn\", \"strict\"] as const;\n/**\n * Restricts governance workflow enforcement values accepted by command, SDK, and storage contracts.\n */\nexport type GovernanceWorkflowEnforcement = (typeof GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES)[number];\nexport const VALIDATE_METADATA_REQUIRED_FIELD_VALUES = [\n  \"author\",\n  \"acceptance_criteria\",\n  \"estimated_minutes\",\n  \"close_reason\",\n  \"reviewer\",\n  \"risk\",\n  \"confidence\",\n  \"sprint\",\n  \"release\",\n] as const;\n/**\n * Restricts validate metadata required field values accepted by command, SDK, and storage contracts.\n */\nexport type ValidateMetadataRequiredField = (typeof VALIDATE_METADATA_REQUIRED_FIELD_VALUES)[number];\n\nexport const RECURRENCE_FREQUENCY_VALUES = [\"daily\", \"weekly\", \"monthly\", \"yearly\"] as const;\n/**\n * Restricts recurrence frequency values accepted by command, SDK, and storage contracts.\n */\nexport type RecurrenceFrequency = (typeof RECURRENCE_FREQUENCY_VALUES)[number];\n\nexport const RECURRENCE_WEEKDAY_VALUES = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"] as const;\n/**\n * Restricts recurrence weekday values accepted by command, SDK, and storage contracts.\n */\nexport type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];\n\n/**\n * Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).\n * Shared by item serialization, create/update parsing, and calendar expansion\n * so weekday ordering cannot drift between those modules.\n */\nexport function weekdayOrderIndex(value: RecurrenceWeekday): number {\n  return RECURRENCE_WEEKDAY_VALUES.indexOf(value);\n}\n\n/**\n * Documents the dependency payload exchanged by command, SDK, and package integrations.\n */\nexport interface Dependency {\n  id: string;\n  kind: DependencyKind;\n  created_at: string;\n  author?: string;\n  source_kind?: string;\n}\n\n/**\n * Documents the comment payload exchanged by command, SDK, and package integrations.\n */\nexport interface Comment {\n  created_at: string;\n  author: string;\n  text: string;\n}\n\n/**\n * Documents the log note payload exchanged by command, SDK, and package integrations.\n */\nexport interface LogNote {\n  created_at: string;\n  author: string;\n  text: string;\n}\n\n/**\n * Documents the linked file payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedFile {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n}\n\n/**\n * Documents the linked test payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedTest {\n  command?: string;\n  path?: string;\n  scope: LinkScope;\n  timeout_seconds?: number;\n  pm_context_mode?: \"schema\" | \"tracker\" | \"auto\";\n  env_set?: Record<string, string>;\n  env_clear?: string[];\n  shared_host_safe?: boolean;\n  assert_stdout_contains?: string[];\n  assert_stdout_regex?: string[];\n  assert_stderr_contains?: string[];\n  assert_stderr_regex?: string[];\n  assert_stdout_min_lines?: number;\n  assert_json_field_equals?: Record<string, string>;\n  assert_json_field_gte?: Record<string, number>;\n  note?: string;\n}\n\n/**\n * Documents the linked doc payload exchanged by command, SDK, and package integrations.\n */\nexport interface LinkedDoc {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n}\n\n/**\n * Documents the reminder payload exchanged by command, SDK, and package integrations.\n */\nexport interface Reminder {\n  at: string;\n  text: string;\n}\n\n/**\n * Documents the recurrence rule payload exchanged by command, SDK, and package integrations.\n */\nexport interface RecurrenceRule {\n  freq: RecurrenceFrequency;\n  interval?: number;\n  count?: number;\n  until?: string;\n  by_weekday?: RecurrenceWeekday[];\n  by_month_day?: number[];\n  exdates?: string[];\n}\n\n/**\n * Documents the calendar event payload exchanged by command, SDK, and package integrations.\n */\nexport interface CalendarEvent {\n  start_at: string;\n  end_at?: string;\n  title?: string;\n  description?: string;\n  location?: string;\n  all_day?: boolean;\n  timezone?: string;\n  recurrence?: RecurrenceRule;\n}\n\nexport const PLAN_MODE_VALUES = [\n  \"draft\",\n  \"research\",\n  \"review\",\n  \"approved\",\n  \"executing\",\n  \"paused\",\n  \"completed\",\n  \"superseded\",\n] as const;\n/**\n * Restricts plan mode values accepted by command, SDK, and storage contracts.\n */\nexport type PlanMode = (typeof PLAN_MODE_VALUES)[number];\n\nexport const PLAN_STEP_STATUS_VALUES = [\n  \"pending\",\n  \"in_progress\",\n  \"completed\",\n  \"blocked\",\n  \"skipped\",\n  \"superseded\",\n] as const;\n/**\n * Restricts plan step status values accepted by command, SDK, and storage contracts.\n */\nexport type PlanStepStatus = (typeof PLAN_STEP_STATUS_VALUES)[number];\n\nexport const PLAN_HARNESS_VALUES = [\"codex\", \"claude-code\", \"cursor\", \"generic\"] as const;\n/**\n * Restricts plan harness values accepted by command, SDK, and storage contracts.\n */\nexport type PlanHarness = (typeof PLAN_HARNESS_VALUES)[number];\n\nexport const PLAN_STEP_LINK_KIND_VALUES = [\n  \"related\",\n  \"blocks\",\n  \"blocked_by\",\n  \"depends_on\",\n  \"discovered_from\",\n  \"implements\",\n  \"verifies\",\n  \"supersedes\",\n] as const;\n/**\n * Restricts plan step link kind values accepted by command, SDK, and storage contracts.\n */\nexport type PlanStepLinkKind = (typeof PLAN_STEP_LINK_KIND_VALUES)[number];\n\n/**\n * Documents the plan step link payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStepLink {\n  id: string;\n  kind: PlanStepLinkKind;\n  note?: string;\n  required_before_step?: boolean;\n}\n\n/**\n * Documents the plan step file payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStepFile {\n  path: string;\n  scope?: LinkScope;\n  note?: string;\n}\n\n/**\n * Documents the plan step test payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStepTest {\n  command?: string;\n  path?: string;\n  note?: string;\n}\n\n/**\n * Documents the plan step doc payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStepDoc {\n  path: string;\n  scope?: LinkScope;\n  note?: string;\n}\n\n/**\n * Documents the plan step payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanStep {\n  id: string;\n  order: number;\n  title: string;\n  body?: string;\n  status: PlanStepStatus;\n  owner?: string;\n  evidence?: string;\n  blocked_reason?: string;\n  superseded_by?: string;\n  linked_items?: PlanStepLink[];\n  files?: PlanStepFile[];\n  tests?: PlanStepTest[];\n  docs?: PlanStepDoc[];\n  created_at: string;\n  updated_at: string;\n  completed_at?: string;\n}\n\n/**\n * Documents the plan decision payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanDecision {\n  ts: string;\n  author: string;\n  decision: string;\n  rationale?: string;\n  evidence?: string;\n  step_id?: string;\n}\n\n/**\n * Documents the plan discovery payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanDiscovery {\n  ts: string;\n  author: string;\n  text: string;\n  step_id?: string;\n}\n\n/**\n * Documents the plan validation check payload exchanged by command, SDK, and package integrations.\n */\nexport interface PlanValidationCheck {\n  text: string;\n  command?: string;\n  expected?: string;\n}\n\n/**\n * Documents the item type option definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemTypeOptionDefinition {\n  key: string;\n  values: string[];\n  required?: boolean;\n  aliases?: string[];\n  description?: string;\n}\n\n/**\n * Documents the item type command option policy payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemTypeCommandOptionPolicy {\n  command: \"create\" | \"update\";\n  option: string;\n  required?: boolean;\n  visible?: boolean;\n  enabled?: boolean;\n}\n\n/**\n * Documents the item type definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemTypeDefinition {\n  name: string;\n  description?: string;\n  /**\n   * Status assigned to newly created items of this type when `--status` is not\n   * provided. Falls back to the workflow's open status when unset or invalid.\n   */\n  default_status?: string;\n  folder?: string;\n  aliases?: string[];\n  required_create_fields?: string[];\n  required_create_repeatables?: string[];\n  options?: ItemTypeOptionDefinition[];\n  command_option_policies?: ItemTypeCommandOptionPolicy[];\n}\n\n/**\n * Documents the runtime status definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeStatusDefinition {\n  id: string;\n  aliases?: string[];\n  roles?: RuntimeStatusRole[];\n  description?: string;\n  order?: number;\n}\n\n/**\n * Documents the runtime field definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeFieldDefinition {\n  key: string;\n  metadata_key?: string;\n  /**\n   * @deprecated Use metadata_key.\n   */\n  front_matter_key?: string;\n  cli_flag?: string;\n  cli_aliases?: string[];\n  description?: string;\n  type?: RuntimeFieldType;\n  commands?: RuntimeFieldCommand[];\n  repeatable?: boolean;\n  required?: boolean;\n  required_on_create?: boolean;\n  required_types?: string[];\n  allow_unset?: boolean;\n}\n\n/**\n * Documents the runtime workflow definition payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeWorkflowDefinition {\n  draft_status?: string;\n  open_status?: string;\n  in_progress_status?: string;\n  blocked_status?: string;\n  close_status?: string;\n  canceled_status?: string;\n}\n\n/**\n * Documents the runtime schema file config payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeSchemaFileConfig {\n  types?: string;\n  statuses?: string;\n  fields?: string;\n  workflows?: string;\n}\n\n/**\n * Per-type allowed-transition rule. A type with no matching entry is\n * unrestricted; a type with an entry allows only the listed [from, to]\n * status pairs (status tokens are resolved case-insensitively through the\n * status registry alias map; a same-status no-op is always allowed).\n */\nexport interface TypeWorkflowDefinition {\n  type: string;\n  allowed_transitions: [string, string][];\n}\n\n/**\n * Documents the runtime schema settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface RuntimeSchemaSettings {\n  version: number;\n  files: RuntimeSchemaFileConfig;\n  statuses: RuntimeStatusDefinition[];\n  fields: RuntimeFieldDefinition[];\n  workflow: RuntimeWorkflowDefinition;\n  type_workflows?: TypeWorkflowDefinition[];\n  unknown_field_policy: RuntimeUnknownFieldPolicy;\n}\n\n/**\n * Documents the item test run summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemTestRunSummary {\n  run_id: string;\n  kind: \"test\" | \"test-all\";\n  status: \"passed\" | \"failed\" | \"stopped\" | \"canceled\";\n  started_at: string;\n  finished_at: string;\n  recorded_at: string;\n  attempt?: number;\n  resumed_from?: string;\n  passed: number;\n  failed: number;\n  skipped: number;\n  items?: number;\n  linked_tests?: number;\n  fail_on_skipped_triggered?: boolean;\n}\n\n/**\n * Documents the item metadata payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemMetadata {\n  id: string;\n  title: string;\n  description: string;\n  type: ItemType;\n  /**\n   * On-disk front-matter format version. Absent means the implicit baseline\n   * (version 1) and is never serialized; populated only once an item advances\n   * past the baseline via a future storage migration. See\n   * core/item/item-format-version.\n   */\n  pm_format_version?: number;\n  source_type?: string;\n  type_options?: Record<string, string>;\n  status: ItemStatus;\n  priority: 0 | 1 | 2 | 3 | 4;\n  tags: string[];\n  created_at: string;\n  updated_at: string;\n  deadline?: string;\n  reminders?: Reminder[];\n  events?: CalendarEvent[];\n  closed_at?: string;\n  assignee?: string;\n  source_owner?: string;\n  author?: string;\n  estimated_minutes?: number;\n  acceptance_criteria?: string;\n  design?: string;\n  external_ref?: string;\n  definition_of_ready?: string;\n  order?: number;\n  goal?: string;\n  objective?: string;\n  value?: string;\n  impact?: string;\n  outcome?: string;\n  why_now?: string;\n  parent?: string;\n  reviewer?: string;\n  risk?: RiskLevel;\n  confidence?: ConfidenceValue;\n  sprint?: string;\n  release?: string;\n  blocked_by?: string;\n  blocked_reason?: string;\n  unblock_note?: string;\n  reporter?: string;\n  severity?: IssueSeverity;\n  environment?: string;\n  repro_steps?: string;\n  resolution?: string;\n  expected_result?: string;\n  actual_result?: string;\n  affected_version?: string;\n  fixed_version?: string;\n  component?: string;\n  regression?: boolean;\n  customer_impact?: string;\n  dependencies?: Dependency[];\n  comments?: Comment[];\n  notes?: LogNote[];\n  learnings?: LogNote[];\n  files?: LinkedFile[];\n  tests?: LinkedTest[];\n  test_runs?: ItemTestRunSummary[];\n  docs?: LinkedDoc[];\n  close_reason?: string;\n  duplicate_of?: string;\n  plan_mode?: PlanMode;\n  plan_scope?: string;\n  plan_harness?: PlanHarness;\n  plan_steps?: PlanStep[];\n  plan_decisions?: PlanDecision[];\n  plan_discoveries?: PlanDiscovery[];\n  plan_validation?: PlanValidationCheck[];\n  plan_resume_context?: string;\n  [key: string]: unknown;\n}\n\n/**\n * @deprecated Use ItemMetadata.\n */\nexport type ItemFrontMatter = ItemMetadata;\n\n/**\n * Documents the item document payload exchanged by command, SDK, and package integrations.\n */\nexport interface ItemDocument {\n  metadata: ItemMetadata;\n  body: string;\n}\n\n/**\n * Documents the history patch op payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryPatchOp {\n  op: \"add\" | \"remove\" | \"replace\" | \"move\" | \"copy\" | \"test\";\n  path: string;\n  from?: string;\n  value?: unknown;\n}\n\n/**\n * Documents the history entry payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryEntry {\n  ts: string;\n  author: string;\n  op: string;\n  patch: HistoryPatchOp[];\n  before_hash: string;\n  after_hash: string;\n  message?: string;\n}\n\nexport const CONTEXT_DEPTH_VALUES = [\"brief\", \"standard\", \"deep\", \"full\"] as const;\n/**\n * Restricts context depth values accepted by command, SDK, and storage contracts.\n */\nexport type ContextDepth = (typeof CONTEXT_DEPTH_VALUES)[number];\n\nexport const CONTEXT_SECTION_VALUES = [\n  \"hierarchy\",\n  \"activity\",\n  \"progress\",\n  \"recently_created\",\n  \"unparented\",\n  \"blockers\",\n  \"files\",\n  \"workload\",\n  \"staleness\",\n  \"tests\",\n] as const;\n/**\n * Restricts context section name values accepted by command, SDK, and storage contracts.\n */\nexport type ContextSectionName = (typeof CONTEXT_SECTION_VALUES)[number];\n\n/**\n * Documents the context section settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface ContextSectionSettings {\n  hierarchy: boolean;\n  activity: boolean;\n  progress: boolean;\n  recently_created: boolean;\n  unparented: boolean;\n  blockers: boolean;\n  files: boolean;\n  workload: boolean;\n  staleness: boolean;\n  tests: boolean;\n}\n\n/**\n * Documents the context settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface ContextSettings {\n  default_depth: ContextDepth;\n  activity_limit: number;\n  stale_threshold_days: number;\n  sections: ContextSectionSettings;\n}\n\n/**\n * Documents the governance settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface GovernanceSettings {\n  preset: GovernancePreset;\n  ownership_enforcement: GovernanceOwnershipEnforcement;\n  create_mode_default: GovernanceCreateModeDefault;\n  close_validation_default: GovernanceCloseValidationDefault;\n  require_close_reason: boolean;\n  parent_reference: ParentReferencePolicy;\n  metadata_profile: ValidateMetadataProfile;\n  force_required_for_stale_lock: boolean;\n  create_default_type?: string;\n  /**\n   * Per-type allowed-transition enforcement mode for `pm update --status`.\n   * Read raw from settings (not preset-derived) so existing projects are\n   * unaffected when unset; defaults to \"off\".\n   */\n  workflow_enforcement?: GovernanceWorkflowEnforcement;\n}\n\n/**\n * Restricts extension policy mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicyMode = \"off\" | \"warn\" | \"enforce\";\n/**\n * Restricts extension trust mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionTrustMode = \"off\" | \"warn\" | \"enforce\";\n/**\n * Restricts extension sandbox profile values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionSandboxProfile = \"none\" | \"restricted\" | \"strict\";\n\n/**\n * Documents the extension policy override settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface ExtensionPolicyOverrideSettings {\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\n/**\n * Documents the extension policy settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface ExtensionPolicySettings {\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: ExtensionPolicyOverrideSettings[];\n}\n\n/**\n * Documents the agent guidance settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface AgentGuidanceSettings {\n  prompt_completed: boolean;\n  declined: boolean;\n  declined_at: string;\n  template_version: number;\n  last_checked_files: string[];\n}\n\n/**\n * Restricts search mutation refresh policy values accepted by command, SDK, and storage contracts.\n */\nexport type SearchMutationRefreshPolicy = \"cache_only\" | \"semantic_configured\" | \"semantic_auto\";\n\n/**\n * Documents the search query expansion settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface SearchQueryExpansionSettings {\n  enabled: boolean;\n  provider: string;\n}\n\n/**\n * Documents the search rerank settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface SearchRerankSettings {\n  enabled: boolean;\n  model: string;\n  top_k: number;\n}\n\n/**\n * Config-driven policy for automatic history-stream compaction triage.\n *\n * When `enabled`, `pm health` surfaces an advisory warning for any history\n * stream whose non-empty entry count exceeds `max_entries`, and `pm\n * history-compact` bulk mode uses `max_entries` as its default `--all-over`\n * threshold so the configured policy drives corpus-wide sweeps. `trigger`\n * records operator intent — both values raise the health advisory; `auto`\n * additionally signals that scheduled/automatic sweeps are expected.\n */\nexport interface HistoryCompactPolicy {\n  enabled: boolean;\n  max_entries: number;\n  trigger: \"health_warn\" | \"auto\";\n}\n\n/**\n * Documents the pm settings payload exchanged by command, SDK, and package integrations.\n */\nexport interface PmSettings {\n  version: number;\n  id_prefix: string;\n  author_default: string;\n  item_format: ItemFormat;\n  locks: {\n    ttl_seconds: number;\n  };\n  /**\n   * Retention policy for bulk-mutation rollback checkpoints written by\n   * `update-many`/`close-many`. `pm gc --scope checkpoints` prunes checkpoint\n   * files older than `retention_days`; checkpoints with an unparseable\n   * `created_at` are retained (safety-first, mirroring the stale-lock sweep).\n   */\n  checkpoints: {\n    retention_days: number;\n  };\n  output: {\n    default_format: \"toon\" | \"json\";\n  };\n  history: {\n    missing_stream: \"auto_create\" | \"strict_error\";\n    compact_policy: HistoryCompactPolicy;\n  };\n  validation: {\n    sprint_release_format: SprintReleaseFormatPolicy;\n    parent_reference: ParentReferencePolicy;\n    metadata_profile: ValidateMetadataProfile;\n    metadata_required_fields: ValidateMetadataRequiredField[];\n    lifecycle_stale_blocker_reason_patterns: string[];\n    lifecycle_closure_like_blocked_reason_patterns: string[];\n    lifecycle_closure_like_resolution_patterns: string[];\n    lifecycle_closure_like_actual_result_patterns: string[];\n    /**\n     * Per-type default estimates (minutes) used by `pm validate --auto-fix\n     * --fix-scope estimates` to backfill missing `estimated_minutes` (GH-212).\n     * Keys are item type names (case-insensitive); values are positive minutes\n     * that override the built-in defaults. Empty by default.\n     */\n    estimate_defaults_by_type: Record<string, number>;\n  };\n  governance: GovernanceSettings;\n  workflow: {\n    definition_of_done: string[];\n  };\n  testing: {\n    record_results_to_items: boolean;\n  };\n  telemetry: {\n    enabled: boolean;\n    first_run_prompt_completed: boolean;\n    capture_level: \"minimal\" | \"redacted\" | \"max\";\n    endpoint: string;\n    installation_id: string;\n    retention_days: number;\n  };\n  agent_guidance: AgentGuidanceSettings;\n  item_types: {\n    definitions: ItemTypeDefinition[];\n  };\n  schema: RuntimeSchemaSettings;\n  extensions: {\n    enabled: string[];\n    disabled: string[];\n    policy: ExtensionPolicySettings;\n  };\n  search: {\n    score_threshold: number;\n    hybrid_semantic_weight: number;\n    max_results: number;\n    embedding_model: string;\n    embedding_corpus_max_characters?: number;\n    embedding_batch_size: number;\n    embedding_timeout_ms: number;\n    scanner_max_batch_retries: number;\n    provider?: string;\n    /**\n     * Optional allow-list of corpus field names embedded for semantic search\n     * (see DEFAULT_SEARCH_CORPUS_FIELDS in core/search/corpus.ts). When unset or\n     * empty, the full default field set is used (backward compatible). When set,\n     * only the named fields are embedded — letting teams opt structured signals\n     * (priority, assignee, risk, acceptance_criteria, etc.) in/out for token\n     * efficiency. Changing this re-flags items stale on the next refresh.\n     */\n    corpus_fields?: string[];\n    mutation_refresh_policy: SearchMutationRefreshPolicy;\n    query_expansion: SearchQueryExpansionSettings;\n    rerank: SearchRerankSettings;\n    /**\n     * Offline BM25 lexical-ranking parameters (pm-75k9), applied when\n     * `search.provider` is `bm25` (or auto-selected as the offline fallback) for\n     * semantic/hybrid queries. `k1` controls term-frequency saturation, `b`\n     * controls document-length normalization. Unset → Lucene defaults (1.2/0.75).\n     */\n    bm25?: {\n      k1?: number;\n      b?: number;\n    };\n    tuning?: {\n      title_exact_bonus?: number;\n      title_weight?: number;\n      description_weight?: number;\n      tags_weight?: number;\n      status_weight?: number;\n      body_weight?: number;\n      comments_weight?: number;\n      notes_weight?: number;\n      learnings_weight?: number;\n      dependencies_weight?: number;\n      linked_content_weight?: number;\n    };\n  };\n  providers: {\n    openai: {\n      base_url: string;\n      api_key: string;\n      model: string;\n    };\n    ollama: {\n      base_url: string;\n      model: string;\n    };\n  };\n  context: ContextSettings;\n  vector_store: {\n    adapter?: string;\n    collection_name: string;\n    qdrant: {\n      url: string;\n      api_key: string;\n    };\n    lancedb: {\n      path: string;\n    };\n  };\n}\n"],"names":[],"mappings":"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","debugId":"46812059-b93e-5599-a222-4ac0de6f4911"}

package/docs/ARCHITECTURE.md

@@ -143,6 +143,8 @@ body: |
 
 Legacy JSON-front-matter markdown files are read only for one-way migration into TOON. Runtime internals use `metadata` as the item metadata model key.
 
+Front-matter carries an explicit, monotonically increasing storage format version (`pm_format_version`). The baseline version (`1`) is the implicit default and is **never** serialized, so the field stays absent for the entire current corpus and adds no per-item token cost; it only materializes once an item advances past the baseline via a future breaking migration. Absence therefore always means the baseline. `core/item/item-format-version.ts` owns the constant and the classification helpers (`effectiveItemFormatVersion`, `classifyItemFormatVersion`, `scanItemFormatVersions`) that `pm health` (the `integrity` check) and `pm validate` (the `format_version` check) use to flag items that are outdated (a future migration would rewrite them) or ahead of the runtime (written by a newer pm). When a breaking front-matter change ships, bump `CURRENT_ITEM_FORMAT_VERSION` and add a migration that rewrites items below it — the version gate makes that a per-item decision instead of a full-corpus structural re-parse.
+
 Built-in item types (11; confirm at runtime with `pm schema list`):
 
 - `Epic`