@unbrained/pm-cli 2026.7.21 → 2026.7.22

package/dist/cli-bundle/sdk.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../../../../../../sdk/search-refresh-worker.ts", "../../../../../../../sdk/telemetry-flush.ts", "../../../../../../../sdk/define.ts", "../../../../../../../sdk/index.ts"],
-  "sourcesContent": ["/**\n * @module sdk/search-refresh-worker\n *\n * Owns the detached semantic-refresh worker entry used by custom mutation hosts.\n */\nimport { runSemanticRefreshWorker } from \"../core/search/background-refresh.js\";\nimport { refreshSemanticEmbeddingsForMutatedItems } from \"../core/search/cache.js\";\nimport { resolvePmRoot } from \"../core/store/paths.js\";\n\n/** Drain the active workspace's pending semantic-refresh queue. */\nexport async function runSearchRefreshWorkerEntrypoint(): Promise<void> {\n  const pmRoot = resolvePmRoot(process.cwd(), process.env.PM_PATH);\n  await runSemanticRefreshWorker(pmRoot, (root, itemIds) =>\n    refreshSemanticEmbeddingsForMutatedItems(root, itemIds, {\n      apply_runtime_defaults: true,\n    }),\n  );\n}\n", "/**\n * @module sdk/telemetry-flush\n *\n * Owns explicit telemetry queue draining for embedded and detached hosts.\n */\nimport { flushTelemetryQueueNow } from \"../core/telemetry/runtime.js\";\n\n/** Flush the durable telemetry queue immediately. */\nexport async function flushTelemetryQueue(): Promise<void> {\n  await flushTelemetryQueueNow();\n}\n", "/**\n * @module sdk/define\n *\n * Authoring-time typed builders for every extension registration surface.\n *\n * These `define*` helpers are the third leg of the SDK ergonomics tripod:\n * {@link ../core/extensions/loader.js#ExtensionApi | `api.register*`} registers\n * a definition at activation, the `assert*`/`run*` testing helpers verify and\n * invoke it, and these builders let authors *write* the definition with full\n * type-checking and editor inference before it ever reaches `activate`.\n *\n * Every builder is a zero-cost identity function that returns its argument\n * unchanged — exactly like the SDK's {@link ./index.js#defineExtension} and the\n * wider `defineConfig`/`defineComponent` ecosystem convention. Extensions are\n * authored fully in TypeScript (ADR pm-2c28); these builders are where that type\n * safety is anchored at the definition site. Their value is entirely at the type\n * level:\n *\n * - A bare `const cmd = { ... }` satisfies the registration type only\n *   structurally and widens its literals; `const cmd = defineCommand({ ... })`\n *   checks the object against the contract *and* preserves the narrow literal\n *   type, while inferring the nested handler's `context` parameter from the\n *   builder signature.\n * - Definitions can be colocated, exported, reused, and unit-tested apart from\n *   the `activate` call instead of being trapped as inline literals.\n *\n * Object-definition builders use a generic constraint (`<T extends Def>`) so the\n * narrow literal type survives the round-trip, mirroring `defineExtension`.\n * Function-definition builders are intentionally non-generic: a generic\n * constrained to a whole function type suppresses contextual typing of a bare\n * arrow's parameter (it would fall back to implicit `any`), whereas the\n * non-generic signature lets TypeScript type the handler parameter from the\n * declared function type.\n */\nimport type {\n  AfterCommandHook,\n  BeforeCommandHook,\n  CommandDefinition,\n  CommandOverride,\n  Exporter,\n  ExtensionManifest,\n  FlagDefinition,\n  Importer,\n  OnIndexHook,\n  OnReadHook,\n  OnWriteHook,\n  ParserOverride,\n  PreflightOverride,\n  RendererOverride,\n  SchemaFieldDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SearchProviderDefinition,\n  ServiceOverride,\n  VectorStoreAdapterDefinition,\n} from \"../core/extensions/loader.js\";\nimport type { ProjectProfileDefinition } from \"../core/profile/profile-presets.js\";\n\n/**\n * Type an extension's in-module manifest mirror (the `manifest` export / field).\n *\n * Completes the `define*` family: the manifest is the one authoring surface that\n * otherwise had no builder. Contract-checks the object against\n * {@link ExtensionManifest} where it is authored, catching a missing required\n * field or a mistyped key at edit time instead of at load time. Pair with\n * {@link ./compose.js#deriveExtensionCapabilities | `deriveExtensionCapabilities`}\n * to keep `capabilities` matched to the surfaces the extension actually registers.\n */\nexport function defineExtensionManifest<TManifest extends ExtensionManifest>(\n  manifest: TManifest,\n): TManifest {\n  return manifest;\n}\n\n/**\n * Type a project-profile definition for the profile registry.\n *\n * A profile bundles item types, statuses, fields, per-type workflows, config\n * knobs, create templates, and package recommendations into one declarative\n * archetype that `pm profile apply` stages idempotently. This builder checks the\n * object against {@link ProjectProfileDefinition} where it is authored — catching\n * an invalid field type or a malformed workflow at edit time — while preserving\n * the literal `name`/`types`/`statuses` so a package's archetype stays strongly\n * typed at the definition site, mirroring {@link defineItemType}. It is the\n * authoring anchor a first-party or third-party profile package builds on.\n */\nexport function defineProjectProfile<TProfile extends ProjectProfileDefinition>(\n  profile: TProfile,\n): TProfile {\n  return profile;\n}\n\n/**\n * Type a command definition for `api.registerCommand(definition)`.\n *\n * Checks the object against {@link CommandDefinition} and infers the `run`\n * handler's `context` parameter while preserving the literal `name`/`action`\n * types. Pass the result straight to `registerCommand`, or export it so the\n * command can be invoked in tests via `runRegisteredCommandForTest`.\n */\nexport function defineCommand<TDefinition extends CommandDefinition>(\n  definition: TDefinition,\n): TDefinition {\n  return definition;\n}\n\n/**\n * Type a single flag definition for a `api.registerFlags(command, flags)` array.\n *\n * Authors compose builders into the array\n * (`api.registerFlags(\"list\", [defineFlag({ long: \"--mine\" })])`) to get\n * per-flag contract checking — `value_type`, `list`, and `default` included —\n * instead of validating a loosely-typed literal array all at once.\n */\nexport function defineFlag<TFlag extends FlagDefinition>(flag: TFlag): TFlag {\n  return flag;\n}\n\n/**\n * Type a custom item-type definition for `api.registerItemTypes([...])`.\n *\n * Preserves the literal `name`/`folder`/`aliases` so a project archetype's\n * domain types stay strongly typed where the definition is declared and reused.\n */\nexport function defineItemType<TType extends SchemaItemTypeDefinition>(\n  type: TType,\n): TType {\n  return type;\n}\n\n/**\n * Type a custom item-metadata field definition for `api.registerItemFields([...])`.\n *\n * Checks `name`/`type`/`optional` against {@link SchemaFieldDefinition} while\n * keeping the field's extra metadata (the contract carries an index signature)\n * intact.\n */\nexport function defineItemField<TField extends SchemaFieldDefinition>(\n  field: TField,\n): TField {\n  return field;\n}\n\n/**\n * Type a schema migration definition for `api.registerMigration(definition)`.\n *\n * Preserves the literal `id` and, when `run` is provided, infers the migration\n * runner's context, so the same definition can be registered and later exercised\n * through `runRegisteredMigrationForTest`.\n */\nexport function defineMigration<TMigration extends SchemaMigrationDefinition>(\n  migration: TMigration,\n): TMigration {\n  return migration;\n}\n\n/**\n * Type a search-provider definition for `api.registerSearchProvider(provider)`.\n *\n * Infers the `query`/`embed`/`embedBatch` operation contexts and result shapes\n * so a custom retrieval backend is type-checked at the definition site and\n * reusable in `runRegisteredSearchProviderForTest`.\n */\nexport function defineSearchProvider<\n  TProvider extends SearchProviderDefinition,\n>(provider: TProvider): TProvider {\n  return provider;\n}\n\n/**\n * Type a vector-store adapter definition for `api.registerVectorStoreAdapter(adapter)`.\n *\n * Infers the `query`/`upsert`/`delete` operation contexts so a package that owns\n * its own semantic index storage gets contract checking before activation and a\n * definition it can drive through `runRegisteredVectorStoreAdapterForTest`.\n */\nexport function defineVectorStoreAdapter<\n  TAdapter extends VectorStoreAdapterDefinition,\n>(adapter: TAdapter): TAdapter {\n  return adapter;\n}\n\n/**\n * Type a command-override handler for `api.registerCommand(command, override)`.\n *\n * The non-generic signature lets TypeScript contextually type the override's\n * `context` parameter from {@link CommandOverride}, so a bare arrow authored in\n * a `.js` package still gets a fully-typed argument.\n */\nexport function defineCommandOverride(\n  override: CommandOverride,\n): CommandOverride {\n  return override;\n}\n\n/**\n * Type a parser-override handler for `api.registerParser(command, override)`.\n *\n * Contextually types the `context` parameter and the returned\n * {@link ParserOverride} delta so an argument-rewriting override is checked\n * where it is written.\n */\nexport function defineParserOverride(override: ParserOverride): ParserOverride {\n  return override;\n}\n\n/**\n * Type a preflight-override handler for `api.registerPreflight(override)`.\n *\n * Contextually types the `context` parameter and the returned gate decision so a\n * package's pre-run validation override is checked at the definition site.\n */\nexport function definePreflightOverride(\n  override: PreflightOverride,\n): PreflightOverride {\n  return override;\n}\n\n/**\n * Type a service-override handler for `api.registerService(service, override)`.\n *\n * Contextually types the `context` parameter from {@link ServiceOverride} so a\n * package overriding a built-in service (output formatting, embeddings, and the\n * like) keeps its handler argument typed without an explicit annotation.\n */\nexport function defineServiceOverride(\n  override: ServiceOverride,\n): ServiceOverride {\n  return override;\n}\n\n/**\n * Type a renderer-override handler for `api.registerRenderer(format, renderer)`.\n *\n * Contextually types the `context` parameter and the `string | null | undefined`\n * return contract so a custom output renderer is checked where it is authored.\n */\nexport function defineRendererOverride(\n  renderer: RendererOverride,\n): RendererOverride {\n  return renderer;\n}\n\n/**\n * Type an importer handler for `api.registerImporter(name, importer, options)`.\n *\n * Contextually types the {@link Importer} `context` (registration, args,\n * options, pm root) so the bridge from an external system into the pm context\n * graph is type-checked and reusable in `runRegisteredImporterForTest`.\n */\nexport function defineImporter(importer: Importer): Importer {\n  return importer;\n}\n\n/**\n * Type an exporter handler for `api.registerExporter(name, exporter, options)`.\n *\n * Contextually types the {@link Exporter} `context` so the bridge from the pm\n * context graph out to an external system is checked at the definition site and\n * reusable in `runRegisteredExporterForTest`.\n */\nexport function defineExporter(exporter: Exporter): Exporter {\n  return exporter;\n}\n\n/**\n * Type a `before_command` hook for `api.hooks.beforeCommand(hook)`.\n *\n * Contextually types the {@link BeforeCommandHook} `context` so a hook that\n * inspects or annotates a command before it runs keeps its argument typed when\n * authored as a standalone, exportable, testable value.\n */\nexport function defineBeforeCommandHook(\n  hook: BeforeCommandHook,\n): BeforeCommandHook {\n  return hook;\n}\n\n/**\n * Type an `after_command` hook for `api.hooks.afterCommand(hook)`.\n *\n * Contextually types the {@link AfterCommandHook} `context` — including the\n * `affected` items pm mutated — so the natural place to react to every change\n * (\"project management = context management\") is checked where it is written.\n */\nexport function defineAfterCommandHook(\n  hook: AfterCommandHook,\n): AfterCommandHook {\n  return hook;\n}\n\n/**\n * Type an `on_write` hook for `api.hooks.onWrite(hook)`.\n *\n * Contextually types the {@link OnWriteHook} `context` so a hook reacting to\n * item persistence keeps its argument typed without an explicit annotation.\n */\nexport function defineOnWriteHook(hook: OnWriteHook): OnWriteHook {\n  return hook;\n}\n\n/**\n * Type an `on_read` hook for `api.hooks.onRead(hook)`.\n *\n * Contextually types the {@link OnReadHook} `context` so a hook augmenting items\n * as they are read is type-checked at the definition site.\n */\nexport function defineOnReadHook(hook: OnReadHook): OnReadHook {\n  return hook;\n}\n\n/**\n * Type an `on_index` hook for `api.hooks.onIndex(hook)`.\n *\n * Contextually types the {@link OnIndexHook} `context` so a hook participating\n * in index/search refresh keeps its argument typed even without TypeScript\n * annotations.\n */\nexport function defineOnIndexHook(hook: OnIndexHook): OnIndexHook {\n  return hook;\n}\n", "/**\n * @module sdk/index\n *\n * Defines public SDK APIs and package-author helpers for Index.\n */\nexport {\n  isErrnoError,\n  limitAnnotationEntries,\n  parseAnnotationTextInput,\n  readAnnotationEntries,\n  resolveAnnotationInput,\n  resolveAnnotationIndex,\n  runAnnotationCommand,\n  wrapOwnershipConflict,\n  type AnnotationCommandConfig,\n  type AnnotationCommandOptions,\n  type AnnotationCommandResult,\n  type AnnotationEntry,\n  type AnnotationInput,\n  type AnnotationSourceOptions,\n  type OwnershipConflictGuidance,\n} from \"./annotations.js\";\nexport {\n  inspectHistoryAuthorStream,\n  scanHistoryAuthorAttribution,\n  type HistoryAuthorAttributionScan,\n  type UnknownAuthorHistoryEvent,\n} from \"./author-attribution.js\";\nexport { createPmCliProgram } from \"./cli-program.js\";\nexport { runSearchRefreshWorkerEntrypoint } from \"./search-refresh-worker.js\";\nexport { flushTelemetryQueue } from \"./telemetry-flush.js\";\nexport {\n  EXECUTABLE_COMMAND_ALIASES,\n  applyBootstrapPagerPolicy,\n  coalesceRepeatedListFlags,\n  listAliasPluralKeys,\n  mergeLinkedTestTwoTokenEntries,\n  normalizeBootstrapInvocation,\n  normalizeLegacyExtensionActionSyntax,\n  parseBootstrapCommandName,\n  parseBootstrapGlobalOptions,\n  parseBootstrapHelpRequest,\n  parseBootstrapTypeValue,\n  stripGlobalBootstrapTokens,\n  type BootstrapGlobalOptions,\n  type BootstrapHelpRequest,\n  type BootstrapInvocationNormalizationResult,\n  type BootstrapNormalizationEvent,\n} from \"./cli-bootstrap.js\";\nexport {\n  quoteCommandArg,\n  quoteWindowsCommandArg,\n  renderPmCommand,\n} from \"./command-line.js\";\nexport {\n  runGc,\n  type GcCheckpointsSummary,\n  type GcLocksSummary,\n} from \"./governance/gc.js\";\nexport {\n  _testOnlyHealthCommand,\n  runHealth,\n  type HealthCheck,\n} from \"./governance/health.js\";\nexport {\n  _testOnlyValidateCommand,\n  runValidate,\n  type ValidateCheck,\n  type ValidateFixesSummary,\n  type ValidateMutationServices,\n} from \"./governance/validate.js\";\nexport { runExtension } from \"./extension.js\";\nexport {\n  runWithActiveExtensions,\n  type ActiveExtensionScopeOptions,\n} from \"./runtime.js\";\nexport { applyInvocationAuthorOverride } from \"./invocation-author.js\";\nexport { describeItemOwnershipConflict } from \"./ownership-source.js\";\nexport { discoverNearbyPmRoot } from \"./tracker-root-discovery.js\";\nexport {\n  _testOnly as _testOnlyTemplates,\n  type TemplateSource,\n} from \"./templates.js\";\nexport {\n  runConfig,\n  _testOnlyConfigCommand,\n  type NestedSettingResultValue,\n} from \"./config.js\";\nexport {\n  INIT_AGENT_GUIDANCE_MODE_VALUES,\n  runInitAgentGuidance,\n  _testOnly as _testOnlyInitAgentGuidance,\n  type InitAgentGuidanceMode,\n  type InitAgentGuidanceSummary,\n  type RunInitAgentGuidanceOptions,\n  type RunInitAgentGuidanceResult,\n} from \"./init-agent-guidance.js\";\nexport {\n  runInit,\n  summarizeInitResult,\n  _testOnly as _testOnlyInit,\n  type InitAgentGuidanceResult,\n  type InitConciseResult,\n  type InitInstalledPackagesSummary,\n  type InitRegisteredTypePresetSummary,\n  type InitTargetResolution,\n  type InitTypePresetName,\n} from \"./init.js\";\nexport {\n  PROFILE_SUBCOMMANDS,\n  formatProfileApplyHuman,\n  formatProfileLintHuman,\n  formatProfileListHuman,\n  formatProfileShowHuman,\n  runProfileApply,\n  runProfileLint,\n  runProfileList,\n  runProfileShow,\n  type ProfileApplyDimension,\n  type ProfileComposition,\n  type ProfileListEntry,\n} from \"./profile.js\";\nimport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_TRUST_MODES,\n} from \"../core/extensions/loader.js\";\nexport { RESERVED_ITEM_FIELD_NAMES } from \"../core/extensions/item-fields.js\";\nexport {\n  PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,\n  PM_PACKAGE_RESOURCE_KINDS,\n  collectPackageExtensionDirectories,\n  readPmPackageManifest,\n  type PmPackageCatalogLinkMap,\n  type PmPackageCatalogMediaMap,\n  type PmPackageCatalogMetadata,\n  type PmPackageManifest,\n  type PmPackageResourceKind,\n  type PmPackageResourceMap,\n} from \"../core/packages/manifest.js\";\nexport type {\n  CommanderOptionAliasContract,\n  CommanderOptionRegistrationContract,\n} from \"./cli-contracts.js\";\nexport {\n  ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,\n  APPEND_FLAG_CONTRACTS,\n  CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,\n  CALENDAR_FLAG_CONTRACTS,\n  CLAIM_FLAG_CONTRACTS,\n  CLOSE_FLAG_CONTRACTS,\n  CLOSE_MANY_FLAG_CONTRACTS,\n  CLOSE_TASK_FLAG_CONTRACTS,\n  COMMENTS_FLAG_CONTRACTS,\n  COMPLETION_FLAG_CONTRACTS,\n  CONFIG_FLAG_CONTRACTS,\n  CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,\n  CONTEXT_FLAG_CONTRACTS,\n  CONTRACTS_FLAG_CONTRACTS,\n  COPY_FLAG_CONTRACTS,\n  CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,\n  CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  CREATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  CREATE_FLAG_CONTRACTS,\n  DELETE_FLAG_CONTRACTS,\n  DEPS_FLAG_CONTRACTS,\n  DOCS_FLAG_CONTRACTS,\n  EVAL_FLAG_CONTRACTS,\n  EXTENSION_ACTIVATE_FLAG_CONTRACTS,\n  EXTENSION_ADOPT_ALL_FLAG_CONTRACTS,\n  EXTENSION_ADOPT_FLAG_CONTRACTS,\n  EXTENSION_CATALOG_FLAG_CONTRACTS,\n  EXTENSION_DEACTIVATE_FLAG_CONTRACTS,\n  EXTENSION_DESCRIBE_FLAG_CONTRACTS,\n  EXTENSION_DOCTOR_FLAG_CONTRACTS,\n  EXTENSION_EXPLORE_FLAG_CONTRACTS,\n  EXTENSION_FLAG_CONTRACTS,\n  EXTENSION_INIT_FLAG_CONTRACTS,\n  EXTENSION_INSTALL_FLAG_CONTRACTS,\n  EXTENSION_MANAGE_FLAG_CONTRACTS,\n  EXTENSION_RELOAD_FLAG_CONTRACTS,\n  EXTENSION_SCOPE_FLAG_CONTRACTS,\n  EXTENSION_UNINSTALL_FLAG_CONTRACTS,\n  FILES_FLAG_CONTRACTS,\n  FOCUS_FLAG_CONTRACTS,\n  GC_FLAG_CONTRACTS,\n  GET_FLAG_CONTRACTS,\n  GLOBAL_FLAG_CONTRACTS,\n  GUIDE_FLAG_CONTRACTS,\n  HEALTH_FLAG_CONTRACTS,\n  HISTORY_COMPACT_FLAG_CONTRACTS,\n  HISTORY_FLAG_CONTRACTS,\n  HISTORY_REDACT_FLAG_CONTRACTS,\n  HISTORY_REPAIR_FLAG_CONTRACTS,\n  INIT_FLAG_CONTRACTS,\n  INSTALL_FLAG_CONTRACTS,\n  LEARNINGS_FLAG_CONTRACTS,\n  LIST_COMMANDER_STRING_OPTION_CONTRACTS,\n  LIST_FILTER_FLAG_CONTRACTS,\n  MEET_FLAG_CONTRACTS,\n  NEXT_COMMANDER_STRING_OPTION_CONTRACTS,\n  NEXT_FLAG_CONTRACTS,\n  NOTES_FLAG_CONTRACTS,\n  PACKAGE_FLAG_CONTRACTS,\n  PACKAGE_INIT_FLAG_CONTRACTS,\n  PAUSE_TASK_FLAG_CONTRACTS,\n  PLAN_FLAG_CONTRACTS,\n  PM_CORE_COMMAND_NAMES,\n  PM_EXTENSION_CAPABILITY_CONTRACTS,\n  PM_EXTENSION_POLICY_MODE_CONTRACTS,\n  PM_EXTENSION_POLICY_SURFACE_CONTRACTS,\n  PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS,\n  PM_EXTENSION_SERVICE_NAME_CONTRACTS,\n  PM_EXTENSION_TRUST_MODE_CONTRACTS,\n  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA,\n  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,\n  PM_TOOL_ACTIONS,\n  PM_TOOL_ACTION_PARAMETER_CONTRACTS,\n  PM_TOOL_PARAMETERS_SCHEMA,\n  PM_TOOL_PARAMETERS_SCHEMA_MAJOR,\n  PM_TOOL_PARAMETERS_SCHEMA_VERSION,\n  PROFILE_FLAG_CONTRACTS,\n  REINDEX_FLAG_CONTRACTS,\n  RELEASE_FLAG_CONTRACTS,\n  REMIND_FLAG_CONTRACTS,\n  RESTORE_FLAG_CONTRACTS,\n  SCHEMA_FLAG_CONTRACTS,\n  SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,\n  SEARCH_FLAG_CONTRACTS,\n  START_TASK_FLAG_CONTRACTS,\n  STATS_FLAG_CONTRACTS,\n  SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,\n  TELEMETRY_FLAG_CONTRACTS,\n  TEST_ALL_FLAG_CONTRACTS,\n  TEST_FLAG_CONTRACTS,\n  TEST_RUNS_FLAG_CONTRACTS,\n  TOOL_ACTIVITY_OPTION_CONTRACTS,\n  TOOL_AGGREGATE_OPTION_CONTRACTS,\n  TOOL_CALENDAR_OPTION_CONTRACTS,\n  TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS,\n  TOOL_CONTEXT_OPTION_CONTRACTS,\n  TOOL_CREATE_OPTION_CONTRACTS,\n  TOOL_DEPS_OPTION_CONTRACTS,\n  TOOL_LIST_FILTER_OPTION_CONTRACTS,\n  TOOL_SEARCH_FILTER_OPTION_CONTRACTS,\n  TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS,\n  TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS,\n  TOOL_UPDATE_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,\n  UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  UPDATE_FLAG_CONTRACTS,\n  UPDATE_MANY_FLAG_CONTRACTS,\n  UPGRADE_FLAG_CONTRACTS,\n  compactFlagAliasContracts,\n  isPmExtensionCapabilityContract,\n  isPmExtensionPolicyModeContract,\n  isPmExtensionPolicySurfaceContract,\n  isPmExtensionServiceNameContract,\n  isPmToolAction,\n  readFirstStringFromCommanderOptions,\n  readFirstValueFromCommanderOptions,\n  readStringArrayFromCommanderOptions,\n  resolveSubcommandFlagContractsForCommand,\n  toCompletionFlagString,\n  withFlagAliasMetadata,\n} from \"./cli-contracts.js\";\nexport type {\n  CliFlagContract,\n  OptionsFromContracts,\n  PmActionSchemaContract,\n  PmBulkMutationControlOptions,\n  PmBulkMutationFilterOptions,\n  PmCloseActionOptions,\n  PmCloseManyActionOptions,\n  PmCreateActionOptions,\n  PmMutationAttributionOptions,\n  PmOptionScalar,\n  PmUpdateActionOptions,\n  PmUpdateManyActionOptions,\n  PmExtensionCapabilityContract,\n  PmExtensionPolicyModeContract,\n  PmExtensionPolicySurfaceContract,\n  PmExtensionSandboxProfileContract,\n  PmExtensionServiceNameContract,\n  PmExtensionTrustModeContract,\n  PmToolAction,\n  ToolOptionFlagContract,\n} from \"./cli-contracts.js\";\nexport * from \"./compose.js\";\nexport * from \"./context-relevance.js\";\nexport * from \"./context-packing.js\";\nexport * from \"./context-usage.js\";\nexport * from \"./history-compact.js\";\nexport * from \"./history-read.js\";\nexport * from \"./history-redact.js\";\nexport * from \"./history-repair.js\";\nexport * from \"./item-children.js\";\nexport * from \"./item-schedule.js\";\nexport * from \"./merge/index.js\";\nexport {\n  runDeps,\n  type DepsCollapseMode,\n  type DepsFormat,\n  type DepsGraphEdge,\n  type DepsGraphNode,\n  type DepsGraphResult,\n  type DepsTreeNode,\n} from \"./dependencies.js\";\nexport * from \"./graph/index.js\";\nexport { runDocs } from \"./docs.js\";\nexport {\n  runFiles,\n  runFilesDiscover,\n  type FilesDiscoveryCandidate,\n} from \"./files.js\";\nexport {\n  applyPathMigrations,\n  applyStandaloneNote,\n  artifactKey,\n  dedupeLinkedArtifacts,\n  ensureScope,\n  expandAddGlobEntries,\n  normalizeLinkedPath,\n  parseAddEntries,\n  parseAddGlobEntries,\n  parseMigrateEntries,\n  parseRemoveEntries,\n  renameArtifactsResultKey,\n  runLinkedArtifacts,\n  sortLinkedArtifacts,\n  validateLinkedPaths,\n  type AddGlobEntry,\n  type LinkedArtifact,\n  type LinkedArtifactCommandOptions,\n  type LinkedArtifactKindConfig,\n  type LinkedArtifactResult,\n  type LinkedPathValidation,\n  type PathMigration,\n} from \"./linked-artifacts.js\";\nexport * from \"./pagination.js\";\nexport * from \"./query/item-filter-options.js\";\nexport * from \"./query/parsers.js\";\nexport * from \"./output.js\";\nexport * from \"./relationship-analytics.js\";\nexport * from \"./relationship-context.js\";\nexport * from \"./relationship-history.js\";\nexport * from \"./workspace-transaction.js\";\nexport * from \"./workspace-transaction-gc.js\";\nexport * from \"./item-transaction.js\";\nexport * from \"./structured-mutations.js\";\nexport * from \"./runtime-primitives.js\";\nexport * from \"./error-runtime.js\";\nexport * from \"./relationships.js\";\nexport * from \"./actionability.js\";\nexport type {\n  PlanCommandOptions,\n  PlanCommandResult,\n  PlanDispatchInput,\n  PlanResultPlan,\n  PlanShowDepth,\n  PlanStepSummary,\n  PlanSubcommand,\n  PlanTemplateName,\n} from \"../cli/commands/plan.js\";\nexport {\n  PLAN_SHOW_DEPTH_VALUES,\n  PLAN_SUBCOMMANDS,\n  PLAN_TEMPLATE_NAMES,\n} from \"../cli/commands/plan.js\";\nexport * from \"./define.js\";\nexport {\n  BASELINE_ITEM_FORMAT_VERSION,\n  BUILTIN_ITEM_TYPE_VALUES,\n  CONFIDENCE_TEXT_VALUES,\n  CURRENT_ITEM_FORMAT_VERSION,\n  DEPENDENCY_KIND_VALUES,\n  EXIT_CODE,\n  ISSUE_SEVERITY_VALUES,\n  ITEM_TYPE_VALUES,\n  PM_CLI_EXPECTED_ERROR_NAME,\n  PmCliError,\n  PmClient,\n  RISK_VALUES,\n  STATUS_VALUES,\n  acquireLock,\n  appendHistoryEntry,\n  canonicalDocument,\n  classifyItemFormatVersion,\n  clearWorkspaceContractsCache,\n  commitImportedItem,\n  createHistoryEntry,\n  createPmCliExpectedError,\n  effectiveItemFormatVersion,\n  emptyImportedDocument,\n  ensureTrackerInitialized,\n  generateItemId,\n  getActiveExtensionRegistrations,\n  getContracts,\n  getHistoryPath,\n  getItemPath,\n  getSettingsPath,\n  getWorkspaceContracts,\n  isPmCliExpectedError,\n  isTimestampLiteral,\n  listAllItemMetadata,\n  loadCreateTemplateOptions,\n  locateItem,\n  normalizeItemMetadata,\n  normalizeItemFormatVersion,\n  normalizeItemId,\n  normalizeRawItemId,\n  normalizeStatusInput,\n  nowIso,\n  parseTags,\n  pathExists,\n  readBooleanOption,\n  readCsvListOption,\n  readFileIfExists,\n  readLocatedItem,\n  readRequiredString,\n  readSettings,\n  readStringOption,\n  removeFileIfExists,\n  renderCalendarMarkdown,\n  renderCalendarToon,\n  renderGuideMarkdown,\n  resolveCalendarOutputFormat,\n  resolveGuideOutputFormat,\n  resolveItemTypeRegistry,\n  resolvePmRoot,\n  resolveRuntimeFieldRegistry,\n  resolveRuntimeStatusRegistry,\n  runAction,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n  runCalendar,\n  runCompletion,\n  runGuide,\n  runList,\n  runReindex,\n  runSearch,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  scanItemFormatVersions,\n  selectImportAuthor,\n  serializeItemDocument,\n  splitFrontMatter,\n  toEstimatedMinutesValue,\n  toImportBoolean,\n  toImportConfidence,\n  toImportInteger,\n  toImportLinkedDocs,\n  toImportLinkedFiles,\n  toImportLinkedTests,\n  toImportLogEntries,\n  toImportNormalizedEnum,\n  toImportNumberMap,\n  toImportPriority,\n  toImportStatus,\n  toImportStringList,\n  toImportStringMap,\n  toImportTags,\n  toNonEmptyImportString,\n  writeFileAtomic,\n  aggregate,\n  append,\n  claim,\n  claimNext,\n  close,\n  closeTask,\n  comments,\n  config,\n  context,\n  copy,\n  create,\n  deleteItem,\n  deps,\n  docs,\n  extension,\n  extensionActivate,\n  extensionDeactivate,\n  extensionList,\n  files,\n  filesDiscover,\n  focus,\n  gc,\n  get,\n  graph,\n  health,\n  historyCompact,\n  historyCompactBulk,\n  historyRedact,\n  historyRepair,\n  historyRepairAll,\n  init,\n  learnings,\n  list,\n  next,\n  notes,\n  packageActivate,\n  packageCatalog,\n  packageDeactivate,\n  packageDescribe,\n  packageDoctor,\n  packageInstall,\n  packageLifecycle,\n  packageList,\n  packageManage,\n  packageReload,\n  packageUninstall,\n  pauseTask,\n  profile,\n  profileApply,\n  profileLint,\n  profileList,\n  profileShow,\n  release,\n  restore,\n  schema,\n  schemaAddField,\n  schemaAddStatus,\n  schemaAddType,\n  schemaApplyPreset,\n  schemaInferTypes,\n  schemaList,\n  schemaListFields,\n  schemaRemoveField,\n  schemaRemoveStatus,\n  schemaRemoveType,\n  schemaShow,\n  schemaShowField,\n  schemaShowStatus,\n  search,\n  startTask,\n  stats,\n  update,\n  upgrade,\n  validate,\n  type AggregateOptions,\n  type AggregateResult,\n  type AggregateRow,\n  type AppendCommandOptions,\n  type AppendResult,\n  type BlockerEntry,\n  type CalendarOptions,\n  type CalendarResult,\n  type ClaimResult,\n  type CloseResult,\n  type CloseTaskResult,\n  type CommitImportedItemParams,\n  type CommitImportedItemResult,\n  type CommentsCommandOptions,\n  type CommentsResult,\n  type ConfigCommandOptions,\n  type ConfigResult,\n  type CompletionResult,\n  type CompletionShell,\n  type ContractsCommandOptions,\n  type ContractsResult,\n  type ContextFocusItem,\n  type ContextOptions,\n  type ContextOutputFormat,\n  type ContextResult,\n  type CopyResult,\n  type CreatePmCliExpectedErrorOptions,\n  type CreateResult,\n  type CreateTemplateOptions,\n  type Dependency,\n  type DeleteResult,\n  type DepsCommandOptions,\n  type DepsResult,\n  type DocsCommandOptions,\n  type DocsResult,\n  type ExtensionCommandOptions,\n  type ExtensionCommandResult,\n  type FilesCommandOptions,\n  type FilesDiscoverOptions,\n  type FilesDiscoverResult,\n  type FilesResult,\n  type FocusResult,\n  type GcCommandOptions,\n  type GcResult,\n  type GetContractsOptions,\n  type GetOptions,\n  type GetResult,\n  type GuideDepth,\n  type GuideOptions,\n  type GuideOutputFormat,\n  type GuideResult,\n  type HealthResult,\n  type ImportLinkedScope,\n  type InitCommandOptions,\n  type InitResult,\n  type ItemFormatVersionScanEntry,\n  type ItemFormatVersionScanResult,\n  type ItemFormatVersionStatus,\n  type LearningsCommandOptions,\n  type LearningsResult,\n  type LinkedDoc,\n  type LinkedFile,\n  type LinkedTest,\n  type ListedItem,\n  type ListCompactResult,\n  type ListFullResult,\n  type ListOptions,\n  type ListProjectedItem,\n  type ListProjectedItemCore,\n  type ListResult,\n  type ListResultItem,\n  type ListSortField,\n  type ListSortOrder,\n  type ListTreeItem,\n  type ListTreeMetadata,\n  type ListVerboseResult,\n  type LogNote,\n  type NextActionableItem,\n  type NextBlockerRef,\n  type NextOptions,\n  type NextOutputFormat,\n  type NextRecommendation,\n  type NextResult,\n  type NotesCommandOptions,\n  type NotesResult,\n  type PackageCommandOptions,\n  type PackageCommandResult,\n  type PauseTaskResult,\n  type PmActionInput,\n  type PmActionName,\n  type PmActionOptions,\n  type PmClientCloseActionOptions,\n  type PmClientFullMutationOptions,\n  type PmClientMutationOptions,\n  type PmClientOptions,\n  type PmClientRunArgs,\n  type PmCliExpectedError,\n  type ProfileApplyCommandOptions,\n  type ProfileApplyResult,\n  type ProfileLintResult,\n  type ProfileListResult,\n  type ProfileResult,\n  type ProfileShowResult,\n  type ProfileSubcommand,\n  type ReindexOptions,\n  type ReindexResult,\n  type ReleaseResult,\n  type RestoreResult,\n  type RunHealthOptions,\n  type SchemaAddFieldCommandOptions,\n  type SchemaAddFieldResult,\n  type SchemaAddStatusCommandOptions,\n  type SchemaAddStatusResult,\n  type SchemaAddTypeCommandOptions,\n  type SchemaAddTypeInferCommandOptions,\n  type SchemaAddTypeInferResult,\n  type SchemaAddTypeResult,\n  type SchemaApplyPresetCommandOptions,\n  type SchemaApplyPresetResult,\n  type SchemaInspectResult,\n  type SchemaListFieldsResult,\n  type SchemaListResult,\n  type SchemaRemoveFieldCommandOptions,\n  type SchemaRemoveFieldResult,\n  type SchemaRemoveStatusCommandOptions,\n  type SchemaRemoveStatusResult,\n  type SchemaRemoveTypeCommandOptions,\n  type SchemaRemoveTypeResult,\n  type SchemaShowFieldResult,\n  type SchemaShowResult,\n  type SchemaShowStatusResult,\n  type SchemaResult,\n  type SchemaSubcommand,\n  type SearchCompactResult,\n  type SearchHit,\n  type SearchHitHighlight,\n  type SearchMatchMode,\n  type SearchOptions,\n  type ClaimNextOptions,\n  type SearchResult,\n  type SearchResultItem,\n  type SearchVerboseResult,\n  type StartTaskResult,\n  type StatsCommandOptions,\n  type StatsResult,\n  type TemplatesListResult,\n  type TemplatesSaveResult,\n  type TemplatesShowResult,\n  type TestRunsListCommandOptions,\n  type TestRunsLogsCommandOptions,\n  type TestRunsResumeCommandOptions,\n  type TestRunsStopCommandOptions,\n  type ToImportLinkedArtifactsOptions,\n  type ToImportLinkedTestsOptions,\n  type ToImportLogEntriesOptions,\n  type UpdateResult,\n  type UpgradeCommandOptions,\n  type UpgradeResult,\n  type ValidateCommandOptions,\n  type ValidateResult,\n  type WorkspaceContracts,\n  type WorkspaceContractsOptions,\n} from \"./runtime.js\";\nexport { runStats } from \"./stats.js\";\nexport {\n  DEFAULT_EVAL_QUERIES_RELATIVE_PATH,\n  runEval,\n  type EvalOptions,\n  type EvalQueryReport,\n  type EvalResult,\n} from \"./eval.js\";\nexport {\n  runTelemetry,\n  TELEMETRY_SUBCOMMANDS,\n  type TelemetryCommandOptions,\n  type TelemetrySubcommand,\n} from \"./telemetry.js\";\nexport {\n  classifyLinkedTestFailure,\n  countFailureCategories,\n  extractReferencedPmItemIdsFromCommand,\n  resolveLinkedTestFailureExitCode,\n  runLinkedTests,\n  runTest,\n  summarizeContextPreflight,\n  type LinkedTestFailureCategory,\n  type TestCommandOptions,\n  type TestResult,\n  type TestRunResult,\n} from \"./test/execution.js\";\nexport {\n  runTestAll,\n  type TestAllCommandOptions,\n  type TestAllItemResult,\n  type TestAllResult,\n} from \"./test/batch.js\";\nexport {\n  LINKED_TEST_ENV_NAME_PATTERN,\n  LINKED_TEST_PM_CONTEXT_MODE_VALUES,\n  LINKED_TEST_PROTECTED_ENV_KEYS,\n  parseLinkedTestAssertionEqualsMap,\n  parseLinkedTestAssertionGteMap,\n  parseLinkedTestBoolean,\n  parseLinkedTestContextMode,\n  parseLinkedTestEnvClear,\n  parseLinkedTestEnvSet,\n  parseLinkedTestJsonEntries,\n  parseLinkedTestMinLines,\n  parseLinkedTestRegexList,\n  parseLinkedTestStringList,\n  type LinkedTestPmContextMode,\n} from \"./test/parsers.js\";\nexport {\n  runStartBackgroundRun,\n  runTestRunsWorker,\n  type StartBackgroundRunCommandOptions,\n  type StartBackgroundRunResult,\n} from \"./test/runs.js\";\nexport {\n  BUILTIN_PROFILES,\n  listProfiles,\n  normalizeProfileName,\n  PROFILE_NAMES,\n  resolveProfile,\n  type ProfileConfigEntry,\n  type ProfileName,\n  type ProfilePackageRecommendation,\n  type ProfileTemplateEntry,\n  type ProfileTemplateOptions,\n  type ProjectProfileDefinition,\n  type ProjectProfileRegistrationInput,\n} from \"../core/profile/profile-presets.js\";\nexport {\n  planProfileApplication,\n  type ProfileApplicationPlan,\n  type ProfileChangeStatus,\n  type ProfileComponentChange,\n  type ProfileConfigChange,\n  type ProfileConfigPlan,\n  type ProfileCurrentState,\n  type ProfilePackagePlan,\n  type ProfileSchemaPlan,\n  type ProfileTemplateChange,\n  type ProfileTemplatePlan,\n  type ProfileWorkflowChange,\n  type ProfileWorkflowPlan,\n} from \"../core/profile/profile-plan.js\";\nexport {\n  describeProfileComposition,\n  describeProjectProfile,\n  type ProjectProfileComposition,\n  type ProjectProfileDescription,\n  type ProjectProfilePackageSummary,\n} from \"../core/profile/profile-describe.js\";\nexport {\n  lintProjectProfile,\n  PROFILE_LINT_CODES,\n  PROFILE_LINT_DIMENSIONS,\n  type ProfileLintCode,\n  type ProfileLintDimension,\n  type ProfileLintSeverity,\n  type ProjectProfileLintFinding,\n  type ProjectProfileLintReport,\n} from \"../core/profile/profile-lint.js\";\nexport {\n  assertExtensionBlueprint,\n  assertExtensionCapabilityUsage,\n  assertExtensionDeactivated,\n  assertExtensionManifestCompatible,\n  assertExtensionManifestMatchesBlueprint,\n  assertExtensionPreflight,\n  assertPackageManifest,\n  assertProjectProfile,\n  assertRegisteredCommandContract,\n  assertRegisteredCommandOverride,\n  assertRegisteredExporter,\n  assertRegisteredFlags,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredMigration,\n  assertRegisteredParserOverride,\n  assertRegisteredPreflightOverride,\n  assertRegisteredProfile,\n  assertRegisteredRendererOverride,\n  assertRegisteredSearchProvider,\n  assertRegisteredServiceOverride,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  createExtensionTestHarness,\n  deactivateExtensionForTest,\n  describeExtensionActivation,\n  runRegisteredCommandForTest,\n  runRegisteredCommandOverrideForTest,\n  runRegisteredExporterForTest,\n  runRegisteredHookForTest,\n  runRegisteredImporterForTest,\n  runRegisteredMigrationForTest,\n  runRegisteredParserOverrideForTest,\n  runRegisteredPreflightOverrideForTest,\n  runRegisteredRendererOverrideForTest,\n  runRegisteredSearchProviderForTest,\n  runRegisteredServiceOverrideForTest,\n  runRegisteredVectorStoreAdapterForTest,\n  type ActivateExtensionForTestOptions,\n  type AssertProjectProfileOptions,\n  type DeactivateExtensionForTestOptions,\n  type DescribeExtensionActivationOptions,\n  type ExtensionActivationSummary,\n  type RenderExtensionHarnessMarkdownOptions,\n  type RunRegisteredCommandForTestOptions,\n  type RunRegisteredExporterForTestOptions,\n  type RunRegisteredHookForTestOptions,\n  type RunRegisteredImporterForTestOptions,\n  type RunRegisteredMigrationForTestOptions,\n  type RunRegisteredSearchProviderForTestOptions,\n  type RunRegisteredVectorStoreAdapterForTestOptions,\n  type SearchProviderOperationContexts,\n  type SearchProviderOperationResults,\n  type VectorStoreAdapterOperationContexts,\n  type VectorStoreAdapterOperationResults,\n  type ExtensionCapabilityUsageAssertion,\n  type ExtensionCapabilityUsageExpectation,\n  type ExtensionDeactivationExpectation,\n  type ExtensionManifestBlueprintMatch,\n  type ExtensionTestHarness,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredCommandOverrideExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredFlagsExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredMigrationExpectation,\n  type RegisteredParserOverrideExpectation,\n  type RegisteredPreflightOverrideExpectation,\n  type RegisteredProfileAssertion,\n  type RegisteredProfileExpectation,\n  type RegisteredRendererOverrideExpectation,\n  type RegisteredSearchProviderExpectation,\n  type RegisteredServiceOverrideExpectation,\n  type RegisteredVectorStoreAdapterExpectation,\n} from \"./testing.js\";\n\n/**\n * Canonical extension capability names accepted by pm.\n *\n * Extension manifests should declare one or more of these values in\n * `capabilities`.\n */\nexport const EXTENSION_CAPABILITIES = KNOWN_EXTENSION_CAPABILITIES;\n/** Restricts extension capability values accepted by command, SDK, and storage contracts. */\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/** Canonical extension governance policy modes and registration surfaces. */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\n/** Public contract for extension policy surfaces, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\n/** Public contract for extension trust modes, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\n/** Public contract for extension sandbox profiles, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\n/** Restricts extension policy mode values accepted by command, SDK, and storage contracts. */\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\n/** Restricts extension policy surface values accepted by command, SDK, and storage contracts. */\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\n/** Restricts extension trust mode values accepted by command, SDK, and storage contracts. */\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\n/** Restricts extension sandbox profile values accepted by command, SDK, and storage contracts. */\nexport type ExtensionSandboxProfile =\n  (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/** Versioned capability contract metadata emitted by runtime diagnostics. */\nexport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n};\n\n/** Least-privilege capability reconciliation helpers: map declared capabilities against the registration surfaces a package actually exercises at activation. */\nexport {\n  EXTENSION_CAPABILITY_REGISTRATION_SURFACES,\n  collectUsedExtensionCapabilities,\n  reconcileExtensionCapabilityUsage,\n  type CollectUsedExtensionCapabilitiesOptions,\n  type ExtensionCapabilityUsageReconciliation,\n} from \"../core/extensions/capability-usage.js\";\n\n/**\n * Render an extension/package activation summary\n * ({@link describeExtensionActivation} / {@link describeExtensionBlueprint}) to a\n * deterministic Markdown reference document — the author-facing *render* leg of\n * the describe verb, for drift-free package READMEs.\n */\nexport {\n  renderExtensionSurfaceMarkdown,\n  type ExtensionSurfaceMarkdownOptions,\n} from \"../core/extensions/activation-summary-markdown.js\";\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandHandlerResult,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationFailure,\n  ExtensionDeactivationOptions,\n  ExtensionDeactivationResult,\n  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionHookRegistry,\n  ExtensionSelfIdentity,\n  ExtensionLoadResult,\n  ExtensionManifest,\n  ExtensionManifestEngines,\n  ExtensionGovernancePolicy,\n  ExtensionPolicyOverride,\n  ExtensionProvenanceMetadata,\n  ExtensionRuntimePermissionDeclaration,\n  ExtensionSearchMode,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  ExtensionServiceRegistry,\n  FlagValueType,\n  FlagDefinition,\n  ImportExportContext,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnIndexHookContext,\n  OnReadHook,\n  OnReadHookContext,\n  OnWriteHook,\n  OnWriteHookContext,\n  OutputRendererFormat,\n  ParserOverride,\n  ParserOverrideContext,\n  ParserOverrideDelta,\n  PreflightOverride,\n  PreflightOverrideContext,\n  PreflightOverrideDelta,\n  PreflightRuntimeDecision,\n  RegisteredExtensionExporter,\n  RegisteredExtensionFlagDefinitions,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionProjectProfile,\n  RegisteredExtensionSchemaMigrationDefinition,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionServiceOverride,\n  RegisteredExtensionVectorStoreAdapter,\n  RendererOverride,\n  RendererOverrideContext,\n  SchemaFieldDefinition,\n  SchemaItemTypeCommandOptionPolicyDefinition,\n  SchemaItemTypeOptionDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SchemaMigrationRunContext,\n  SchemaMigrationRunner,\n  SearchProviderEmbedBatchContext,\n  SearchProviderEmbedContext,\n  SearchProviderDefinition,\n  SearchProviderHit,\n  SearchProviderQueryContext,\n  SearchProviderQueryResult,\n  ServiceOverride,\n  ServiceOverrideContext,\n  VectorStoreAdapterDefinition,\n  VectorStoreDeleteContext,\n  VectorStoreQueryContext,\n  VectorStoreQueryHit,\n  VectorStoreUpsertContext,\n  VectorStoreUpsertPoint,\n} from \"../core/extensions/loader.js\";\n\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type {\n  ItemDocument,\n  ItemMetadata,\n  ItemStatus,\n  ItemType,\n  PmSettings,\n} from \"../types/index.js\";\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,eAAsB,mCAAgC;AACpD,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAI,QAAQ,IAAI,OAAO;AAC/D,QAAM,yBAAyB,QAAQ,CAAC,MAAM,YAC5C,yCAAyC,MAAM,SAAS;IACtD,wBAAwB;GACzB,CAAC;AAEN;;;;;;;;;;ACTA,eAAsB,sBAAmB;AACvC,QAAM,uBAAsB;AAC9B;A;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC0DM,SAAU,wBACd,UAAmB;AAEnB,SAAO;AACT;AAcM,SAAU,qBACdA,UAAiB;AAEjB,SAAOA;AACT;AAUM,SAAU,cACd,YAAuB;AAEvB,SAAO;AACT;AAUM,SAAU,WAAyC,MAAW;AAClE,SAAO;AACT;AAQM,SAAU,eACd,MAAW;AAEX,SAAO;AACT;AASM,SAAU,gBACd,OAAa;AAEb,SAAO;AACT;AASM,SAAU,gBACd,WAAqB;AAErB,SAAO;AACT;AASM,SAAU,qBAEd,UAAmB;AACnB,SAAO;AACT;AASM,SAAU,yBAEd,SAAiB;AACjB,SAAO;AACT;AASM,SAAU,sBACd,UAAyB;AAEzB,SAAO;AACT;AASM,SAAU,qBAAqB,UAAwB;AAC3D,SAAO;AACT;AAQM,SAAU,wBACd,UAA2B;AAE3B,SAAO;AACT;AASM,SAAU,sBACd,UAAyB;AAEzB,SAAO;AACT;AAQM,SAAU,uBACd,UAA0B;AAE1B,SAAO;AACT;AASM,SAAU,eAAe,UAAkB;AAC/C,SAAO;AACT;AASM,SAAU,eAAe,UAAkB;AAC/C,SAAO;AACT;AASM,SAAU,wBACd,MAAuB;AAEvB,SAAO;AACT;AASM,SAAU,uBACd,MAAsB;AAEtB,SAAO;AACT;AAQM,SAAU,kBAAkB,MAAiB;AACjD,SAAO;AACT;AAQM,SAAU,iBAAiB,MAAgB;AAC/C,SAAO;AACT;AASM,SAAU,kBAAkB,MAAiB;AACjD,SAAO;AACT;;;;;;;;;;AC4kBO,IAAM,yBAAyB;AAK/B,IAAM,yBAAyB;AAE/B,IAAM,4BAA4B;AAElC,IAAM,wBAAwB;AAE9B,IAAM,6BAA6B;",
-  "names": ["profile"]
+  "sources": ["../../../../../../../sdk/search-refresh-worker.ts", "../../../../../../../sdk/telemetry-flush.ts", "../../../../../../../sdk/compile-cache.ts", "../../../../../../../sdk/context-signal-store.ts", "../../../../../../../sdk/relationship-migration.ts", "../../../../../../../sdk/define.ts", "../../../../../../../sdk/index.ts"],
+  "sourcesContent": ["/**\n * @module sdk/search-refresh-worker\n *\n * Owns the detached semantic-refresh worker entry used by custom mutation hosts.\n */\nimport { runSemanticRefreshWorker } from \"../core/search/background-refresh.js\";\nimport { refreshSemanticEmbeddingsForMutatedItems } from \"../core/search/cache.js\";\nimport { resolvePmRoot } from \"../core/store/paths.js\";\n\n/** Drain the active workspace's pending semantic-refresh queue. */\nexport async function runSearchRefreshWorkerEntrypoint(): Promise<void> {\n  const pmRoot = resolvePmRoot(process.cwd(), process.env.PM_PATH);\n  await runSemanticRefreshWorker(pmRoot, (root, itemIds) =>\n    refreshSemanticEmbeddingsForMutatedItems(root, itemIds, {\n      apply_runtime_defaults: true,\n    }),\n  );\n}\n", "/**\n * @module sdk/telemetry-flush\n *\n * Owns explicit telemetry queue draining for embedded and detached hosts.\n */\nimport { flushTelemetryQueueNow } from \"../core/telemetry/runtime.js\";\n\n/** Flush the durable telemetry queue immediately. */\nexport async function flushTelemetryQueue(): Promise<void> {\n  await flushTelemetryQueueNow();\n}\n", "/**\n * @module sdk/compile-cache\n *\n * Provides a bounded, host-reusable lifecycle primitive for pm-owned Node\n * compile-cache generations.\n */\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nconst COMPILE_CACHE_CONCURRENT_GRACE_MS = 5 * 60 * 1000;\nconst COMPILE_CACHE_MAX_GENERATIONS = 3;\n\n/** Result of pruning superseded pm compile-cache generations. */\nexport interface CompileCachePruneResult {\n  /** Generation retained for the current pm build. */\n  retained: string;\n  /** Deterministically sorted generation names removed from the cache root. */\n  removed: string[];\n}\n\n/** Convert an optional package version into a safe compile-cache generation key. */\nexport function resolveCompileCacheGeneration(\n  packageVersion: string | undefined,\n): string {\n  return (packageVersion?.trim() || \"development\")\n    .replace(/[^a-zA-Z0-9._-]/g, \"_\")\n    .replace(/^\\./, \"_\");\n}\n\n/**\n * Retain the current and recently active generations in an exclusively\n * pm-owned compile-cache root, then remove stale entries beyond the bounded\n * generation budget. A short freshness grace protects concurrently starting\n * pm versions from deleting one another's active cache directories.\n */\nexport function pruneCompileCacheGenerations(\n  cacheRoot: string,\n  currentGeneration: string,\n): CompileCachePruneResult {\n  const normalizedGeneration = currentGeneration.trim();\n  if (!/^[a-zA-Z0-9_-][a-zA-Z0-9._-]*$/.test(normalizedGeneration)) {\n    throw new TypeError(\n      \"Compile-cache generation must be a safe non-empty filename token.\",\n    );\n  }\n  fs.mkdirSync(cacheRoot, { recursive: true });\n  const currentPath = path.join(cacheRoot, normalizedGeneration);\n  fs.mkdirSync(currentPath, { recursive: true });\n  const touchedAt = new Date();\n  fs.utimesSync(currentPath, touchedAt, touchedAt);\n  const candidates = fs\n    .readdirSync(cacheRoot)\n    .filter((name) => name !== normalizedGeneration)\n    .flatMap((name) => {\n      try {\n        return [\n          { name, mtimeMs: fs.statSync(path.join(cacheRoot, name)).mtimeMs },\n        ];\n      } catch (error) {\n        if (\n          error instanceof Error &&\n          \"code\" in error &&\n          error.code === \"ENOENT\"\n        ) {\n          return [];\n        }\n        throw error;\n      }\n    })\n    .sort(\n      (left, right) =>\n        right.mtimeMs - left.mtimeMs || left.name.localeCompare(right.name),\n    );\n  const fresh = candidates.filter(\n    (entry) =>\n      touchedAt.getTime() - entry.mtimeMs <\n      COMPILE_CACHE_CONCURRENT_GRACE_MS,\n  );\n  const staleRetention = Math.max(\n    0,\n    COMPILE_CACHE_MAX_GENERATIONS - 1 - fresh.length,\n  );\n  const removed = candidates\n    .filter(\n      (entry) =>\n        touchedAt.getTime() - entry.mtimeMs >= COMPILE_CACHE_CONCURRENT_GRACE_MS,\n    )\n    .slice(staleRetention)\n    .map((entry) => entry.name)\n    .sort((left, right) => left.localeCompare(right));\n  for (const name of removed) {\n    fs.rmSync(path.join(cacheRoot, name), {\n      recursive: true,\n      force: true,\n      maxRetries: 3,\n      retryDelay: 50,\n    });\n  }\n  return { retained: normalizedGeneration, removed };\n}\n", "/**\n * @module sdk/context-signal-store\n *\n * Rebuildable, cursor-stamped feature-store primitives for context relevance.\n * Snapshots are derived read artifacts: callers retain authoritative items and\n * history, while stale, absent, or corrupt snapshots rebuild transparently.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { randomUUID } from \"node:crypto\";\nimport {\n  buildItemContextRelevanceCandidates,\n  CONTEXT_RELEVANCE_SIGNAL_NAMES,\n  type BuildItemContextRelevanceCandidatesOptions,\n  type ContextRelevanceCandidate,\n  type ContextRelevanceSignalName,\n  type ContextRelevanceSignals,\n} from \"./context-relevance.js\";\nimport type { ItemMetadata } from \"../types/index.js\";\n\n/** Current serialized feature-store envelope version. */\nexport const CONTEXT_SIGNAL_STORE_FORMAT_VERSION = 1;\n\n/** Current canonical signal-vector version. */\nexport const CONTEXT_SIGNAL_SET_VERSION = 1;\n\nconst STORED_CONTEXT_SIGNAL_NAMES = CONTEXT_RELEVANCE_SIGNAL_NAMES.slice(1) as readonly Exclude<\n  ContextRelevanceSignalName,\n  \"structural\"\n>[];\n\n/** Authoritative substrate used to derive one snapshot. */\nexport type ContextSignalSnapshotSource = \"derived_index\" | \"scan_fallback\";\n\n/** One immutable item signal row. */\nexport interface ContextSignalSnapshotItem {\n  /** Stable item identifier. */\n  id: string;\n  /** Canonical normalized signal vector. */\n  signals: ContextRelevanceSignals;\n}\n\n/** Rebuildable, deterministic context-signal snapshot. */\nexport interface ContextSignalSnapshot {\n  /** Serialized envelope version. */\n  format_version: number;\n  /** Signal algorithm version. */\n  signal_set_version: number;\n  /** Authoritative history or derived-index cursor folded into this snapshot. */\n  source_cursor: string;\n  /** Stable clock supplied by the caller. */\n  generated_at: string;\n  /** Read substrate used for the fold. */\n  source: ContextSignalSnapshotSource;\n  /** Item rows sorted by canonical id. */\n  items: readonly ContextSignalSnapshotItem[];\n}\n\n/** Pluggable persistence boundary for context-signal snapshots. */\nexport interface ContextSignalStoreAdapter {\n  /** Read the serialized snapshot, or null when none exists. */\n  read(): Promise<unknown | null>;\n  /** Atomically replace the serialized snapshot. */\n  write(snapshot: ContextSignalSnapshot): Promise<void>;\n}\n\n/** Options required to fold authoritative items into a snapshot. */\nexport interface BuildContextSignalSnapshotOptions\n  extends BuildItemContextRelevanceCandidatesOptions {\n  /** Authoritative history or derived-index cursor. */\n  sourceCursor: string;\n  /** Substrate used to load the authoritative items. */\n  source: ContextSignalSnapshotSource;\n}\n\n/** Result of a feature-store read with explicit degradation metadata. */\nexport interface ContextSignalStoreReadResult {\n  /** Valid snapshot used for candidate assembly. */\n  snapshot: ContextSignalSnapshot;\n  /** Candidates joined to the caller's authoritative item objects. */\n  candidates: ContextRelevanceCandidate<ItemMetadata>[];\n  /** Whether the persisted snapshot was reused or rebuilt. */\n  cache_status: \"fresh\" | \"rebuilt\";\n  /** Non-fatal recovery diagnostics. */\n  warnings: readonly string[];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isNormalizedSignal(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value) && value >= 0 && value <= 1;\n}\n\nfunction compactSignals(signals: ContextRelevanceSignals): ContextRelevanceSignals {\n  const compact: ContextRelevanceSignals = {};\n  for (const name of STORED_CONTEXT_SIGNAL_NAMES) {\n    const value = signals[name];\n    if (value === undefined) continue;\n    if (!isNormalizedSignal(value)) {\n      throw new TypeError(`Context relevance signal ${name} must be a finite number from 0 to 1`);\n    }\n    compact[name] = value;\n  }\n  return compact;\n}\n\nfunction parseSnapshotItem(value: unknown): ContextSignalSnapshotItem | null {\n  if (!isRecord(value) || typeof value.id !== \"string\" || !isRecord(value.signals)) {\n    return null;\n  }\n  const signals: Record<string, number> = {};\n  const supportedSignals = new Set<string>(STORED_CONTEXT_SIGNAL_NAMES);\n  for (const [name, signal] of Object.entries(value.signals)) {\n    if (!supportedSignals.has(name) || !isNormalizedSignal(signal)) {\n      return null;\n    }\n    signals[name] = signal;\n  }\n  return { id: value.id, signals: signals as ContextRelevanceSignals };\n}\n\n/** Validate an untrusted serialized snapshot without accepting partial envelopes. */\nexport function parseContextSignalSnapshot(value: unknown): ContextSignalSnapshot | null {\n  if (\n    !isRecord(value) ||\n    value.format_version !== CONTEXT_SIGNAL_STORE_FORMAT_VERSION ||\n    value.signal_set_version !== CONTEXT_SIGNAL_SET_VERSION ||\n    typeof value.source_cursor !== \"string\" ||\n    value.source_cursor.trim().length === 0 ||\n    typeof value.generated_at !== \"string\" ||\n    !Number.isFinite(Date.parse(value.generated_at)) ||\n    (value.source !== \"derived_index\" && value.source !== \"scan_fallback\") ||\n    !Array.isArray(value.items)\n  ) {\n    return null;\n  }\n  const items = value.items.map(parseSnapshotItem);\n  if (items.some((item) => item === null)) {\n    return null;\n  }\n  const validItems = items as ContextSignalSnapshotItem[];\n  if (\n    new Set(validItems.map((item) => item.id)).size !== validItems.length ||\n    validItems.some((item) => item.id.trim().length === 0)\n  ) {\n    return null;\n  }\n  return {\n    format_version: CONTEXT_SIGNAL_STORE_FORMAT_VERSION,\n    signal_set_version: CONTEXT_SIGNAL_SET_VERSION,\n    source_cursor: value.source_cursor,\n    generated_at: value.generated_at,\n    source: value.source,\n    items: validItems.sort((left, right) => left.id.localeCompare(right.id)),\n  };\n}\n\n/** Fold authoritative items into a deterministic, immutable signal snapshot. */\nexport function buildContextSignalSnapshot(\n  items: readonly ItemMetadata[],\n  options: BuildContextSignalSnapshotOptions,\n): ContextSignalSnapshot {\n  if (typeof options.sourceCursor !== \"string\" || options.sourceCursor.trim().length === 0) {\n    throw new TypeError(\"Context signal source cursor must be non-empty\");\n  }\n  if (!Number.isFinite(Date.parse(options.now))) {\n    throw new TypeError(\"Context signal snapshot clock must be a valid timestamp\");\n  }\n  const rows = buildItemContextRelevanceCandidates(items, options)\n    .map(({ id, signals }) => ({\n      id,\n      signals: compactSignals(signals),\n    }))\n    .sort((left, right) => left.id.localeCompare(right.id));\n  return Object.freeze({\n    format_version: CONTEXT_SIGNAL_STORE_FORMAT_VERSION,\n    signal_set_version: CONTEXT_SIGNAL_SET_VERSION,\n    source_cursor: options.sourceCursor,\n    generated_at: options.now,\n    source: options.source,\n    items: Object.freeze(rows.map((row) => Object.freeze(row))),\n  });\n}\n\n/** Filesystem adapter using same-directory atomic replacement. */\nexport class JsonFileContextSignalStoreAdapter implements ContextSignalStoreAdapter {\n  private readonly filePath: string;\n\n  /** Create an adapter for an explicit derived-state file path. */\n  constructor(filePath: string) {\n    if (typeof filePath !== \"string\" || filePath.trim().length === 0) {\n      throw new TypeError(\"Context signal store path must be non-empty\");\n    }\n    this.filePath = path.resolve(filePath);\n  }\n\n  /** Read and decode the JSON snapshot, returning null when it does not exist. */\n  async read(): Promise<unknown | null> {\n    try {\n      return JSON.parse(await fs.readFile(this.filePath, \"utf8\")) as unknown;\n    } catch (error: unknown) {\n      if (isRecord(error) && error.code === \"ENOENT\") {\n        return null;\n      }\n      throw error;\n    }\n  }\n\n  /** Write a complete snapshot through a unique same-directory temporary file. */\n  async write(snapshot: ContextSignalSnapshot): Promise<void> {\n    const directory = path.dirname(this.filePath);\n    await fs.mkdir(directory, { recursive: true });\n    const temporaryPath = path.join(directory, `.${path.basename(this.filePath)}.${randomUUID()}.tmp`);\n    try {\n      await fs.writeFile(temporaryPath, `${JSON.stringify(snapshot)}\\n`, { encoding: \"utf8\", flag: \"wx\" });\n      await fs.rename(temporaryPath, this.filePath);\n    } finally {\n      try {\n        await fs.rm(temporaryPath, { force: true });\n      } catch {\n        // The complete snapshot is already committed; temporary-file cleanup is best effort.\n      }\n    }\n  }\n}\n\n/** Cursor-aware feature store that self-heals from absent, stale, or corrupt state. */\nexport class ContextSignalStore {\n  private readonly adapter: ContextSignalStoreAdapter;\n\n  /** Bind the store to a caller-selected persistence adapter. */\n  constructor(adapter: ContextSignalStoreAdapter) {\n    this.adapter = adapter;\n  }\n\n  /** Read matching signals or rebuild them from authoritative items. */\n  async readOrRebuild(\n    items: readonly ItemMetadata[],\n    options: BuildContextSignalSnapshotOptions,\n  ): Promise<ContextSignalStoreReadResult> {\n    const warnings: string[] = [];\n    let snapshot: ContextSignalSnapshot | null = null;\n    try {\n      const serialized = await this.adapter.read();\n      snapshot = parseContextSignalSnapshot(serialized);\n      if (serialized !== null && snapshot === null) {\n        warnings.push(\"context_signal_store_invalid\");\n      }\n    } catch {\n      warnings.push(\"context_signal_store_invalid\");\n    }\n    const authoritativeIds = items.map((item) => item.id).sort((left, right) => left.localeCompare(right));\n    const snapshotIds = snapshot?.items.map((item) => item.id) ?? [];\n    const fresh =\n      snapshot !== null &&\n      snapshot.source_cursor === options.sourceCursor &&\n      snapshot.source === options.source &&\n      snapshotIds.length === authoritativeIds.length &&\n      snapshotIds.every((id, index) => id === authoritativeIds[index]);\n    let resolvedSnapshot: ContextSignalSnapshot;\n    if (fresh && snapshot !== null) {\n      resolvedSnapshot = snapshot;\n    } else {\n      if (snapshot !== null) {\n        warnings.push(\"context_signal_store_stale\");\n      }\n      resolvedSnapshot = buildContextSignalSnapshot(items, options);\n      try {\n        await this.adapter.write(resolvedSnapshot);\n      } catch {\n        warnings.push(\"context_signal_store_write_failed\");\n      }\n    }\n    const signalsById = new Map(resolvedSnapshot.items.map((item) => [item.id, item.signals]));\n    return {\n      snapshot: resolvedSnapshot,\n      candidates: items.map((item) => ({ id: item.id, item, signals: signalsById.get(item.id) })),\n      cache_status: fresh ? \"fresh\" : \"rebuilt\",\n      warnings,\n    };\n  }\n}\n", "/**\n * @module sdk/relationship-migration\n *\n * Plans deterministic, resumable migration of legacy item hierarchy and\n * dependency fields into the immutable relationship-event platform. Planning\n * is storage-independent and side-effect free: callers can inspect governance\n * evidence, persist the event batch through {@link RelationshipEventStore}, or\n * feed the same plan into another conforming durable adapter.\n */\nimport { createHash } from \"node:crypto\";\nimport {\n  assembleWorkspaceRelationshipGraph,\n  type WorkspaceRelationshipItem,\n} from \"./graph/assembly.js\";\nimport type { RelationshipEventInput } from \"./relationship-history.js\";\nimport type { RelationshipKindRegistry } from \"./relationships.js\";\n\n/** Controls for deterministic legacy relationship-event planning. */\nexport interface RelationshipEventBackfillOptions {\n  /** Stable migration identity retained in generated event and relationship ids. */\n  migrationId: string;\n  /** Attributable actor responsible for the migration. */\n  author: string;\n  /** Valid event timestamp shared by the deterministic migration batch. */\n  timestamp: string;\n  /** Optional custom relationship ontology used during legacy normalization. */\n  registry?: RelationshipKindRegistry;\n  /** Event ids already committed by an earlier partial or concurrent run. */\n  existingEventIds?: Iterable<string>;\n}\n\n/** Deterministic migration plan plus compact governance evidence. */\nexport interface RelationshipEventBackfillPlan {\n  /** Caller-provided stable migration identity. */\n  migration_id: string;\n  /** SHA-256 identity of the complete normalized plan before resume filtering. */\n  fingerprint: string;\n  /** Fixed node universe required when opening a relationship event store. */\n  nodes: readonly string[];\n  /** Missing deterministic events that remain to be committed. */\n  events: readonly RelationshipEventInput[];\n  /** Total unique normalized edges represented by the complete plan. */\n  edge_count: number;\n  /** Events omitted because their deterministic ids already exist. */\n  skipped_existing_count: number;\n  /** Duplicate raw dependency identities found before graph deduplication. */\n  duplicate_dependency_rows: number;\n  /** Missing internal references retained as explicit placeholder nodes. */\n  dangling_reference_count: number;\n}\n\n/** Validate and normalize one required migration text field. */\nfunction requiredMigrationText(value: unknown, field: string): string {\n  if (typeof value !== \"string\" || value.trim().length === 0)\n    throw new TypeError(`Relationship backfill ${field} must be non-empty`);\n  return value.trim();\n}\n\n/**\n * Convert legacy item relationship fields into an immutable deterministic event\n * batch. Input order does not affect ids, fingerprints, or event order.\n * Dangling internal targets and external dependency targets become explicit\n * nodes so replay never silently drops contextual edges.\n */\nexport function planRelationshipEventBackfill(\n  items: readonly WorkspaceRelationshipItem[],\n  options: RelationshipEventBackfillOptions,\n): RelationshipEventBackfillPlan {\n  const migrationId = requiredMigrationText(options.migrationId, \"migrationId\");\n  const author = requiredMigrationText(options.author, \"author\");\n  const parsedTimestamp = Date.parse(options.timestamp);\n  if (!Number.isFinite(parsedTimestamp))\n    throw new TypeError(\"Relationship backfill timestamp must be valid\");\n  const timestamp = new Date(parsedTimestamp).toISOString();\n  const assembly = assembleWorkspaceRelationshipGraph(\n    items,\n    undefined,\n    options.registry,\n  );\n  const nodes = assembly.graph.nodes();\n  const completeEvents = assembly.graph.edges().map((edge) => {\n    const digest = createHash(\"sha256\")\n      .update(\n        JSON.stringify([\n          migrationId,\n          edge.kind,\n          edge.source,\n          edge.target,\n          edge.createdAt ?? null,\n          edge.author ?? null,\n          edge.payload ?? null,\n        ]),\n      )\n      .digest(\"hex\")\n      .slice(0, 24);\n    return Object.freeze({\n      eventId: `backfill:${migrationId}:${digest}`,\n      relationshipId: `migration:${migrationId}:${digest}`,\n      action: \"add\" as const,\n      edge,\n      author,\n      timestamp,\n      reason: `Backfill ${migrationId} from legacy item metadata`,\n    });\n  });\n  const fingerprint = createHash(\"sha256\")\n    .update(JSON.stringify({ migrationId, nodes, events: completeEvents }))\n    .digest(\"hex\");\n  const existingEventIds = new Set(\n    [...(options.existingEventIds ?? [])]\n      .filter((id): id is string => typeof id === \"string\")\n      .map((id) => id.trim())\n      .filter(Boolean),\n  );\n  const events = completeEvents.filter(\n    (event) => !existingEventIds.has(event.eventId),\n  );\n  return Object.freeze({\n    migration_id: migrationId,\n    fingerprint,\n    nodes,\n    events: Object.freeze(events),\n    edge_count: completeEvents.length,\n    skipped_existing_count: completeEvents.length - events.length,\n    duplicate_dependency_rows: assembly.duplicateRows.length,\n    dangling_reference_count:\n      assembly.dangling.active.length + assembly.dangling.legacy_terminal.length,\n  });\n}\n", "/**\n * @module sdk/define\n *\n * Authoring-time typed builders for every extension registration surface.\n *\n * These `define*` helpers are the third leg of the SDK ergonomics tripod:\n * {@link ../core/extensions/loader.js#ExtensionApi | `api.register*`} registers\n * a definition at activation, the `assert*`/`run*` testing helpers verify and\n * invoke it, and these builders let authors *write* the definition with full\n * type-checking and editor inference before it ever reaches `activate`.\n *\n * Every builder is a zero-cost identity function that returns its argument\n * unchanged — exactly like the SDK's {@link ./index.js#defineExtension} and the\n * wider `defineConfig`/`defineComponent` ecosystem convention. Extensions are\n * authored fully in TypeScript (ADR pm-2c28); these builders are where that type\n * safety is anchored at the definition site. Their value is entirely at the type\n * level:\n *\n * - A bare `const cmd = { ... }` satisfies the registration type only\n *   structurally and widens its literals; `const cmd = defineCommand({ ... })`\n *   checks the object against the contract *and* preserves the narrow literal\n *   type, while inferring the nested handler's `context` parameter from the\n *   builder signature.\n * - Definitions can be colocated, exported, reused, and unit-tested apart from\n *   the `activate` call instead of being trapped as inline literals.\n *\n * Object-definition builders use a generic constraint (`<T extends Def>`) so the\n * narrow literal type survives the round-trip, mirroring `defineExtension`.\n * Function-definition builders are intentionally non-generic: a generic\n * constrained to a whole function type suppresses contextual typing of a bare\n * arrow's parameter (it would fall back to implicit `any`), whereas the\n * non-generic signature lets TypeScript type the handler parameter from the\n * declared function type.\n */\nimport type {\n  AfterCommandHook,\n  BeforeCommandHook,\n  CommandDefinition,\n  CommandOverride,\n  Exporter,\n  ExtensionManifest,\n  FlagDefinition,\n  Importer,\n  OnIndexHook,\n  OnReadHook,\n  OnWriteHook,\n  ParserOverride,\n  PreflightOverride,\n  RendererOverride,\n  SchemaFieldDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SearchProviderDefinition,\n  ServiceOverride,\n  VectorStoreAdapterDefinition,\n} from \"../core/extensions/loader.js\";\nimport type { ProjectProfileDefinition } from \"../core/profile/profile-presets.js\";\n\n/**\n * Type an extension's in-module manifest mirror (the `manifest` export / field).\n *\n * Completes the `define*` family: the manifest is the one authoring surface that\n * otherwise had no builder. Contract-checks the object against\n * {@link ExtensionManifest} where it is authored, catching a missing required\n * field or a mistyped key at edit time instead of at load time. Pair with\n * {@link ./compose.js#deriveExtensionCapabilities | `deriveExtensionCapabilities`}\n * to keep `capabilities` matched to the surfaces the extension actually registers.\n */\nexport function defineExtensionManifest<TManifest extends ExtensionManifest>(\n  manifest: TManifest,\n): TManifest {\n  return manifest;\n}\n\n/**\n * Type a project-profile definition for the profile registry.\n *\n * A profile bundles item types, statuses, fields, per-type workflows, config\n * knobs, create templates, and package recommendations into one declarative\n * archetype that `pm profile apply` stages idempotently. This builder checks the\n * object against {@link ProjectProfileDefinition} where it is authored — catching\n * an invalid field type or a malformed workflow at edit time — while preserving\n * the literal `name`/`types`/`statuses` so a package's archetype stays strongly\n * typed at the definition site, mirroring {@link defineItemType}. It is the\n * authoring anchor a first-party or third-party profile package builds on.\n */\nexport function defineProjectProfile<TProfile extends ProjectProfileDefinition>(\n  profile: TProfile,\n): TProfile {\n  return profile;\n}\n\n/**\n * Type a command definition for `api.registerCommand(definition)`.\n *\n * Checks the object against {@link CommandDefinition} and infers the `run`\n * handler's `context` parameter while preserving the literal `name`/`action`\n * types. Pass the result straight to `registerCommand`, or export it so the\n * command can be invoked in tests via `runRegisteredCommandForTest`.\n */\nexport function defineCommand<TDefinition extends CommandDefinition>(\n  definition: TDefinition,\n): TDefinition {\n  return definition;\n}\n\n/**\n * Type a single flag definition for a `api.registerFlags(command, flags)` array.\n *\n * Authors compose builders into the array\n * (`api.registerFlags(\"list\", [defineFlag({ long: \"--mine\" })])`) to get\n * per-flag contract checking — `value_type`, `list`, and `default` included —\n * instead of validating a loosely-typed literal array all at once.\n */\nexport function defineFlag<TFlag extends FlagDefinition>(flag: TFlag): TFlag {\n  return flag;\n}\n\n/**\n * Type a custom item-type definition for `api.registerItemTypes([...])`.\n *\n * Preserves the literal `name`/`folder`/`aliases` so a project archetype's\n * domain types stay strongly typed where the definition is declared and reused.\n */\nexport function defineItemType<TType extends SchemaItemTypeDefinition>(\n  type: TType,\n): TType {\n  return type;\n}\n\n/**\n * Type a custom item-metadata field definition for `api.registerItemFields([...])`.\n *\n * Checks `name`/`type`/`optional` against {@link SchemaFieldDefinition} while\n * keeping the field's extra metadata (the contract carries an index signature)\n * intact.\n */\nexport function defineItemField<TField extends SchemaFieldDefinition>(\n  field: TField,\n): TField {\n  return field;\n}\n\n/**\n * Type a schema migration definition for `api.registerMigration(definition)`.\n *\n * Preserves the literal `id` and, when `run` is provided, infers the migration\n * runner's context, so the same definition can be registered and later exercised\n * through `runRegisteredMigrationForTest`.\n */\nexport function defineMigration<TMigration extends SchemaMigrationDefinition>(\n  migration: TMigration,\n): TMigration {\n  return migration;\n}\n\n/**\n * Type a search-provider definition for `api.registerSearchProvider(provider)`.\n *\n * Infers the `query`/`embed`/`embedBatch` operation contexts and result shapes\n * so a custom retrieval backend is type-checked at the definition site and\n * reusable in `runRegisteredSearchProviderForTest`.\n */\nexport function defineSearchProvider<\n  TProvider extends SearchProviderDefinition,\n>(provider: TProvider): TProvider {\n  return provider;\n}\n\n/**\n * Type a vector-store adapter definition for `api.registerVectorStoreAdapter(adapter)`.\n *\n * Infers the `query`/`upsert`/`delete` operation contexts so a package that owns\n * its own semantic index storage gets contract checking before activation and a\n * definition it can drive through `runRegisteredVectorStoreAdapterForTest`.\n */\nexport function defineVectorStoreAdapter<\n  TAdapter extends VectorStoreAdapterDefinition,\n>(adapter: TAdapter): TAdapter {\n  return adapter;\n}\n\n/**\n * Type a command-override handler for `api.registerCommand(command, override)`.\n *\n * The non-generic signature lets TypeScript contextually type the override's\n * `context` parameter from {@link CommandOverride}, so a bare arrow authored in\n * a `.js` package still gets a fully-typed argument.\n */\nexport function defineCommandOverride(\n  override: CommandOverride,\n): CommandOverride {\n  return override;\n}\n\n/**\n * Type a parser-override handler for `api.registerParser(command, override)`.\n *\n * Contextually types the `context` parameter and the returned\n * {@link ParserOverride} delta so an argument-rewriting override is checked\n * where it is written.\n */\nexport function defineParserOverride(override: ParserOverride): ParserOverride {\n  return override;\n}\n\n/**\n * Type a preflight-override handler for `api.registerPreflight(override)`.\n *\n * Contextually types the `context` parameter and the returned gate decision so a\n * package's pre-run validation override is checked at the definition site.\n */\nexport function definePreflightOverride(\n  override: PreflightOverride,\n): PreflightOverride {\n  return override;\n}\n\n/**\n * Type a service-override handler for `api.registerService(service, override)`.\n *\n * Contextually types the `context` parameter from {@link ServiceOverride} so a\n * package overriding a built-in service (output formatting, embeddings, and the\n * like) keeps its handler argument typed without an explicit annotation.\n */\nexport function defineServiceOverride(\n  override: ServiceOverride,\n): ServiceOverride {\n  return override;\n}\n\n/**\n * Type a renderer-override handler for `api.registerRenderer(format, renderer)`.\n *\n * Contextually types the `context` parameter and the `string | null | undefined`\n * return contract so a custom output renderer is checked where it is authored.\n */\nexport function defineRendererOverride(\n  renderer: RendererOverride,\n): RendererOverride {\n  return renderer;\n}\n\n/**\n * Type an importer handler for `api.registerImporter(name, importer, options)`.\n *\n * Contextually types the {@link Importer} `context` (registration, args,\n * options, pm root) so the bridge from an external system into the pm context\n * graph is type-checked and reusable in `runRegisteredImporterForTest`.\n */\nexport function defineImporter(importer: Importer): Importer {\n  return importer;\n}\n\n/**\n * Type an exporter handler for `api.registerExporter(name, exporter, options)`.\n *\n * Contextually types the {@link Exporter} `context` so the bridge from the pm\n * context graph out to an external system is checked at the definition site and\n * reusable in `runRegisteredExporterForTest`.\n */\nexport function defineExporter(exporter: Exporter): Exporter {\n  return exporter;\n}\n\n/**\n * Type a `before_command` hook for `api.hooks.beforeCommand(hook)`.\n *\n * Contextually types the {@link BeforeCommandHook} `context` so a hook that\n * inspects or annotates a command before it runs keeps its argument typed when\n * authored as a standalone, exportable, testable value.\n */\nexport function defineBeforeCommandHook(\n  hook: BeforeCommandHook,\n): BeforeCommandHook {\n  return hook;\n}\n\n/**\n * Type an `after_command` hook for `api.hooks.afterCommand(hook)`.\n *\n * Contextually types the {@link AfterCommandHook} `context` — including the\n * `affected` items pm mutated — so the natural place to react to every change\n * (\"project management = context management\") is checked where it is written.\n */\nexport function defineAfterCommandHook(\n  hook: AfterCommandHook,\n): AfterCommandHook {\n  return hook;\n}\n\n/**\n * Type an `on_write` hook for `api.hooks.onWrite(hook)`.\n *\n * Contextually types the {@link OnWriteHook} `context` so a hook reacting to\n * item persistence keeps its argument typed without an explicit annotation.\n */\nexport function defineOnWriteHook(hook: OnWriteHook): OnWriteHook {\n  return hook;\n}\n\n/**\n * Type an `on_read` hook for `api.hooks.onRead(hook)`.\n *\n * Contextually types the {@link OnReadHook} `context` so a hook augmenting items\n * as they are read is type-checked at the definition site.\n */\nexport function defineOnReadHook(hook: OnReadHook): OnReadHook {\n  return hook;\n}\n\n/**\n * Type an `on_index` hook for `api.hooks.onIndex(hook)`.\n *\n * Contextually types the {@link OnIndexHook} `context` so a hook participating\n * in index/search refresh keeps its argument typed even without TypeScript\n * annotations.\n */\nexport function defineOnIndexHook(hook: OnIndexHook): OnIndexHook {\n  return hook;\n}\n", "/**\n * @module sdk/index\n *\n * Defines public SDK APIs and package-author helpers for Index.\n */\nexport {\n  isErrnoError,\n  limitAnnotationEntries,\n  parseAnnotationTextInput,\n  readAnnotationEntries,\n  resolveAnnotationInput,\n  resolveAnnotationIndex,\n  runAnnotationCommand,\n  wrapOwnershipConflict,\n  type AnnotationCommandConfig,\n  type AnnotationCommandOptions,\n  type AnnotationCommandResult,\n  type AnnotationEntry,\n  type AnnotationInput,\n  type AnnotationSourceOptions,\n  type OwnershipConflictGuidance,\n} from \"./annotations.js\";\nexport {\n  inspectHistoryAuthorStream,\n  scanHistoryAuthorAttribution,\n  type HistoryAuthorAttributionScan,\n  type UnknownAuthorHistoryEvent,\n} from \"./author-attribution.js\";\nexport { createPmCliProgram } from \"./cli-program.js\";\nexport { runSearchRefreshWorkerEntrypoint } from \"./search-refresh-worker.js\";\nexport { flushTelemetryQueue } from \"./telemetry-flush.js\";\nexport {\n  EXECUTABLE_COMMAND_ALIASES,\n  applyBootstrapPagerPolicy,\n  coalesceRepeatedListFlags,\n  listAliasPluralKeys,\n  mergeLinkedTestTwoTokenEntries,\n  normalizeBootstrapInvocation,\n  normalizeLegacyExtensionActionSyntax,\n  parseBootstrapCommandName,\n  parseBootstrapGlobalOptions,\n  parseBootstrapHelpRequest,\n  parseBootstrapTypeValue,\n  stripGlobalBootstrapTokens,\n  type BootstrapGlobalOptions,\n  type BootstrapHelpRequest,\n  type BootstrapInvocationNormalizationResult,\n  type BootstrapNormalizationEvent,\n} from \"./cli-bootstrap.js\";\nexport {\n  quoteCommandArg,\n  quoteWindowsCommandArg,\n  renderPmCommand,\n} from \"./command-line.js\";\nexport {\n  runGc,\n  type GcCheckpointsSummary,\n  type GcLocksSummary,\n} from \"./governance/gc.js\";\nexport {\n  _testOnlyHealthCommand,\n  runHealth,\n  type HealthCheck,\n} from \"./governance/health.js\";\nexport {\n  _testOnlyValidateCommand,\n  runValidate,\n  type ValidateCheck,\n  type ValidateFixesSummary,\n  type ValidateMutationServices,\n} from \"./governance/validate.js\";\nexport { runExtension } from \"./extension.js\";\nexport {\n  runWithActiveExtensions,\n  type ActiveExtensionScopeOptions,\n} from \"./runtime.js\";\nexport { applyInvocationAuthorOverride } from \"./invocation-author.js\";\nexport { describeItemOwnershipConflict } from \"./ownership-source.js\";\nexport { discoverNearbyPmRoot } from \"./tracker-root-discovery.js\";\nexport {\n  _testOnly as _testOnlyTemplates,\n  type TemplateSource,\n} from \"./templates.js\";\nexport {\n  runConfig,\n  _testOnlyConfigCommand,\n  type NestedSettingResultValue,\n} from \"./config.js\";\nexport {\n  INIT_AGENT_GUIDANCE_MODE_VALUES,\n  runInitAgentGuidance,\n  _testOnly as _testOnlyInitAgentGuidance,\n  type InitAgentGuidanceMode,\n  type InitAgentGuidanceSummary,\n  type RunInitAgentGuidanceOptions,\n  type RunInitAgentGuidanceResult,\n} from \"./init-agent-guidance.js\";\nexport {\n  runInit,\n  summarizeInitResult,\n  _testOnly as _testOnlyInit,\n  type InitAgentGuidanceResult,\n  type InitConciseResult,\n  type InitInstalledPackagesSummary,\n  type InitRegisteredTypePresetSummary,\n  type InitTargetResolution,\n  type InitTypePresetName,\n} from \"./init.js\";\nexport {\n  PROFILE_SUBCOMMANDS,\n  formatProfileApplyHuman,\n  formatProfileLintHuman,\n  formatProfileListHuman,\n  formatProfileShowHuman,\n  runProfileApply,\n  runProfileLint,\n  runProfileList,\n  runProfileShow,\n  type ProfileApplyDimension,\n  type ProfileComposition,\n  type ProfileListEntry,\n} from \"./profile.js\";\nimport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_TRUST_MODES,\n} from \"../core/extensions/loader.js\";\nexport { RESERVED_ITEM_FIELD_NAMES } from \"../core/extensions/item-fields.js\";\nexport {\n  PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,\n  PM_PACKAGE_RESOURCE_KINDS,\n  collectPackageExtensionDirectories,\n  readPmPackageManifest,\n  type PmPackageCatalogLinkMap,\n  type PmPackageCatalogMediaMap,\n  type PmPackageCatalogMetadata,\n  type PmPackageManifest,\n  type PmPackageResourceKind,\n  type PmPackageResourceMap,\n} from \"../core/packages/manifest.js\";\nexport type {\n  CommanderOptionAliasContract,\n  CommanderOptionRegistrationContract,\n} from \"./cli-contracts.js\";\nexport {\n  ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,\n  APPEND_FLAG_CONTRACTS,\n  CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,\n  CALENDAR_FLAG_CONTRACTS,\n  CLAIM_FLAG_CONTRACTS,\n  CLOSE_FLAG_CONTRACTS,\n  CLOSE_MANY_FLAG_CONTRACTS,\n  CLOSE_TASK_FLAG_CONTRACTS,\n  COMMENTS_FLAG_CONTRACTS,\n  COMPLETION_FLAG_CONTRACTS,\n  CONFIG_FLAG_CONTRACTS,\n  CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,\n  CONTEXT_FLAG_CONTRACTS,\n  CONTRACTS_FLAG_CONTRACTS,\n  COPY_FLAG_CONTRACTS,\n  CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,\n  CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  CREATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  CREATE_FLAG_CONTRACTS,\n  DELETE_FLAG_CONTRACTS,\n  DEPS_FLAG_CONTRACTS,\n  DOCS_FLAG_CONTRACTS,\n  EVAL_FLAG_CONTRACTS,\n  EXTENSION_ACTIVATE_FLAG_CONTRACTS,\n  EXTENSION_ADOPT_ALL_FLAG_CONTRACTS,\n  EXTENSION_ADOPT_FLAG_CONTRACTS,\n  EXTENSION_CATALOG_FLAG_CONTRACTS,\n  EXTENSION_DEACTIVATE_FLAG_CONTRACTS,\n  EXTENSION_DESCRIBE_FLAG_CONTRACTS,\n  EXTENSION_DOCTOR_FLAG_CONTRACTS,\n  EXTENSION_EXPLORE_FLAG_CONTRACTS,\n  EXTENSION_FLAG_CONTRACTS,\n  EXTENSION_INIT_FLAG_CONTRACTS,\n  EXTENSION_INSTALL_FLAG_CONTRACTS,\n  EXTENSION_MANAGE_FLAG_CONTRACTS,\n  EXTENSION_RELOAD_FLAG_CONTRACTS,\n  EXTENSION_SCOPE_FLAG_CONTRACTS,\n  EXTENSION_UNINSTALL_FLAG_CONTRACTS,\n  FILES_FLAG_CONTRACTS,\n  FOCUS_FLAG_CONTRACTS,\n  GC_FLAG_CONTRACTS,\n  GET_FLAG_CONTRACTS,\n  GLOBAL_FLAG_CONTRACTS,\n  GUIDE_FLAG_CONTRACTS,\n  HEALTH_FLAG_CONTRACTS,\n  HISTORY_COMPACT_FLAG_CONTRACTS,\n  HISTORY_FLAG_CONTRACTS,\n  HISTORY_REDACT_FLAG_CONTRACTS,\n  HISTORY_REPAIR_FLAG_CONTRACTS,\n  INIT_FLAG_CONTRACTS,\n  INSTALL_FLAG_CONTRACTS,\n  LEARNINGS_FLAG_CONTRACTS,\n  LIST_COMMANDER_STRING_OPTION_CONTRACTS,\n  LIST_FILTER_FLAG_CONTRACTS,\n  MEET_FLAG_CONTRACTS,\n  NEXT_COMMANDER_STRING_OPTION_CONTRACTS,\n  NEXT_FLAG_CONTRACTS,\n  NOTES_FLAG_CONTRACTS,\n  PACKAGE_FLAG_CONTRACTS,\n  PACKAGE_INIT_FLAG_CONTRACTS,\n  PAUSE_TASK_FLAG_CONTRACTS,\n  PLAN_FLAG_CONTRACTS,\n  PM_CORE_COMMAND_NAMES,\n  PM_EXTENSION_CAPABILITY_CONTRACTS,\n  PM_EXTENSION_POLICY_MODE_CONTRACTS,\n  PM_EXTENSION_POLICY_SURFACE_CONTRACTS,\n  PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS,\n  PM_EXTENSION_SERVICE_NAME_CONTRACTS,\n  PM_EXTENSION_TRUST_MODE_CONTRACTS,\n  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA,\n  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,\n  PM_TOOL_ACTIONS,\n  PM_TOOL_ACTION_PARAMETER_CONTRACTS,\n  PM_TOOL_PARAMETERS_SCHEMA,\n  PM_TOOL_PARAMETERS_SCHEMA_MAJOR,\n  PM_TOOL_PARAMETERS_SCHEMA_VERSION,\n  PROFILE_FLAG_CONTRACTS,\n  REINDEX_FLAG_CONTRACTS,\n  RELEASE_FLAG_CONTRACTS,\n  REMIND_FLAG_CONTRACTS,\n  RESTORE_FLAG_CONTRACTS,\n  SCHEMA_FLAG_CONTRACTS,\n  SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,\n  SEARCH_FLAG_CONTRACTS,\n  START_TASK_FLAG_CONTRACTS,\n  STATS_FLAG_CONTRACTS,\n  SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,\n  TELEMETRY_FLAG_CONTRACTS,\n  TEST_ALL_FLAG_CONTRACTS,\n  TEST_FLAG_CONTRACTS,\n  TEST_RUNS_FLAG_CONTRACTS,\n  TOOL_ACTIVITY_OPTION_CONTRACTS,\n  TOOL_AGGREGATE_OPTION_CONTRACTS,\n  TOOL_CALENDAR_OPTION_CONTRACTS,\n  TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS,\n  TOOL_CONTEXT_OPTION_CONTRACTS,\n  TOOL_CREATE_OPTION_CONTRACTS,\n  TOOL_DEPS_OPTION_CONTRACTS,\n  TOOL_LIST_FILTER_OPTION_CONTRACTS,\n  TOOL_SEARCH_FILTER_OPTION_CONTRACTS,\n  TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS,\n  TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS,\n  TOOL_UPDATE_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,\n  UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  UPDATE_FLAG_CONTRACTS,\n  UPDATE_MANY_FLAG_CONTRACTS,\n  UPGRADE_FLAG_CONTRACTS,\n  compactFlagAliasContracts,\n  isPmExtensionCapabilityContract,\n  isPmExtensionPolicyModeContract,\n  isPmExtensionPolicySurfaceContract,\n  isPmExtensionServiceNameContract,\n  isPmToolAction,\n  readFirstStringFromCommanderOptions,\n  readFirstValueFromCommanderOptions,\n  readStringArrayFromCommanderOptions,\n  resolveSubcommandFlagContractsForCommand,\n  toCompletionFlagString,\n  withFlagAliasMetadata,\n} from \"./cli-contracts.js\";\nexport type {\n  CliFlagContract,\n  OptionsFromContracts,\n  PmActionSchemaContract,\n  PmBulkMutationControlOptions,\n  PmBulkMutationFilterOptions,\n  PmCloseActionOptions,\n  PmCloseManyActionOptions,\n  PmCreateActionOptions,\n  PmMutationAttributionOptions,\n  PmOptionScalar,\n  PmUpdateActionOptions,\n  PmUpdateManyActionOptions,\n  PmExtensionCapabilityContract,\n  PmExtensionPolicyModeContract,\n  PmExtensionPolicySurfaceContract,\n  PmExtensionSandboxProfileContract,\n  PmExtensionServiceNameContract,\n  PmExtensionTrustModeContract,\n  PmToolAction,\n  ToolOptionFlagContract,\n} from \"./cli-contracts.js\";\nexport * from \"./compose.js\";\nexport * from \"./compile-cache.js\";\nexport * from \"./context-relevance.js\";\nexport * from \"./context-signal-store.js\";\nexport * from \"./context-packing.js\";\nexport * from \"./context-usage.js\";\nexport * from \"./dependency-provenance.js\";\nexport * from \"./history-compact.js\";\nexport * from \"./history-read.js\";\nexport * from \"./history-redact.js\";\nexport * from \"./history-repair.js\";\nexport * from \"./item-children.js\";\nexport * from \"./item-schedule.js\";\nexport * from \"./merge/index.js\";\nexport {\n  runDeps,\n  type DepsCollapseMode,\n  type DepsFormat,\n  type DepsGraphEdge,\n  type DepsGraphNode,\n  type DepsGraphResult,\n  type DepsTreeNode,\n} from \"./dependencies.js\";\nexport * from \"./graph/index.js\";\nexport { runDocs } from \"./docs.js\";\nexport {\n  runFiles,\n  runFilesDiscover,\n  type FilesDiscoveryCandidate,\n} from \"./files.js\";\nexport {\n  applyPathMigrations,\n  applyStandaloneNote,\n  artifactKey,\n  dedupeLinkedArtifacts,\n  ensureScope,\n  expandAddGlobEntries,\n  normalizeLinkedPath,\n  parseAddEntries,\n  parseAddGlobEntries,\n  parseMigrateEntries,\n  parseRemoveEntries,\n  renameArtifactsResultKey,\n  runLinkedArtifacts,\n  sortLinkedArtifacts,\n  validateLinkedPaths,\n  type AddGlobEntry,\n  type LinkedArtifact,\n  type LinkedArtifactCommandOptions,\n  type LinkedArtifactKindConfig,\n  type LinkedArtifactResult,\n  type LinkedPathValidation,\n  type PathMigration,\n} from \"./linked-artifacts.js\";\nexport * from \"./pagination.js\";\nexport * from \"./query/item-filter-options.js\";\nexport * from \"./query/parsers.js\";\nexport * from \"./output.js\";\nexport * from \"./relationship-analytics.js\";\nexport * from \"./relationship-context.js\";\nexport * from \"./relationship-history.js\";\nexport * from \"./relationship-migration.js\";\nexport * from \"./workspace-transaction.js\";\nexport * from \"./workspace-transaction-gc.js\";\nexport * from \"./item-transaction.js\";\nexport * from \"./item-metadata-index.js\";\nexport * from \"./structured-mutations.js\";\nexport * from \"./runtime-primitives.js\";\nexport * from \"./error-runtime.js\";\nexport * from \"./relationships.js\";\nexport * from \"./actionability.js\";\nexport type {\n  PlanCommandOptions,\n  PlanCommandResult,\n  PlanDispatchInput,\n  PlanResultPlan,\n  PlanShowDepth,\n  PlanStepSummary,\n  PlanSubcommand,\n  PlanTemplateName,\n} from \"../cli/commands/plan.js\";\nexport {\n  PLAN_SHOW_DEPTH_VALUES,\n  PLAN_SUBCOMMANDS,\n  PLAN_TEMPLATE_NAMES,\n} from \"../cli/commands/plan.js\";\nexport * from \"./define.js\";\nexport {\n  BASELINE_ITEM_FORMAT_VERSION,\n  BUILTIN_ITEM_TYPE_VALUES,\n  CONFIDENCE_TEXT_VALUES,\n  CURRENT_ITEM_FORMAT_VERSION,\n  DEPENDENCY_KIND_VALUES,\n  EXIT_CODE,\n  ISSUE_SEVERITY_VALUES,\n  ITEM_TYPE_VALUES,\n  PM_CLI_EXPECTED_ERROR_NAME,\n  PmCliError,\n  PmClient,\n  RISK_VALUES,\n  STATUS_VALUES,\n  acquireLock,\n  appendHistoryEntry,\n  canonicalDocument,\n  classifyItemFormatVersion,\n  clearWorkspaceContractsCache,\n  commitImportedItem,\n  createHistoryEntry,\n  createPmCliExpectedError,\n  effectiveItemFormatVersion,\n  emptyImportedDocument,\n  ensureTrackerInitialized,\n  generateItemId,\n  getActiveExtensionRegistrations,\n  getContracts,\n  getHistoryPath,\n  getItemPath,\n  getSettingsPath,\n  getWorkspaceContracts,\n  isPmCliExpectedError,\n  isTimestampLiteral,\n  listAllItemMetadata,\n  loadCreateTemplateOptions,\n  locateItem,\n  normalizeItemMetadata,\n  normalizeItemFormatVersion,\n  normalizeItemId,\n  normalizeRawItemId,\n  normalizeStatusInput,\n  nowIso,\n  parseTags,\n  pathExists,\n  readBooleanOption,\n  readCsvListOption,\n  readFileIfExists,\n  readLocatedItem,\n  readRequiredString,\n  readSettings,\n  readStringOption,\n  removeFileIfExists,\n  renderCalendarMarkdown,\n  renderCalendarToon,\n  renderGuideMarkdown,\n  resolveCalendarOutputFormat,\n  resolveGuideOutputFormat,\n  resolveItemTypeRegistry,\n  resolvePmRoot,\n  resolveRuntimeFieldRegistry,\n  resolveRuntimeStatusRegistry,\n  runAction,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n  runCalendar,\n  runCompletion,\n  runGuide,\n  runList,\n  runReindex,\n  runSearch,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  scanItemFormatVersions,\n  selectImportAuthor,\n  serializeItemDocument,\n  splitFrontMatter,\n  toEstimatedMinutesValue,\n  toImportBoolean,\n  toImportConfidence,\n  toImportInteger,\n  toImportLinkedDocs,\n  toImportLinkedFiles,\n  toImportLinkedTests,\n  toImportLogEntries,\n  toImportNormalizedEnum,\n  toImportNumberMap,\n  toImportPriority,\n  toImportStatus,\n  toImportStringList,\n  toImportStringMap,\n  toImportTags,\n  toNonEmptyImportString,\n  writeFileAtomic,\n  aggregate,\n  append,\n  claim,\n  claimNext,\n  close,\n  closeTask,\n  comments,\n  config,\n  context,\n  copy,\n  create,\n  deleteItem,\n  deps,\n  docs,\n  extension,\n  extensionActivate,\n  extensionDeactivate,\n  extensionList,\n  files,\n  filesDiscover,\n  focus,\n  gc,\n  get,\n  graph,\n  health,\n  historyCompact,\n  historyCompactBulk,\n  historyRedact,\n  historyRepair,\n  historyRepairAll,\n  init,\n  learnings,\n  list,\n  next,\n  notes,\n  packageActivate,\n  packageCatalog,\n  packageDeactivate,\n  packageDescribe,\n  packageDoctor,\n  packageInstall,\n  packageLifecycle,\n  packageList,\n  packageManage,\n  packageReload,\n  packageUninstall,\n  pauseTask,\n  profile,\n  profileApply,\n  profileLint,\n  profileList,\n  profileShow,\n  release,\n  restore,\n  schema,\n  schemaAddField,\n  schemaAddStatus,\n  schemaAddType,\n  schemaApplyPreset,\n  schemaInferTypes,\n  schemaList,\n  schemaListFields,\n  schemaRemoveField,\n  schemaRemoveStatus,\n  schemaRemoveType,\n  schemaShow,\n  schemaShowField,\n  schemaShowStatus,\n  search,\n  startTask,\n  stats,\n  update,\n  upgrade,\n  validate,\n  type AggregateOptions,\n  type AggregateResult,\n  type AggregateRow,\n  type AppendCommandOptions,\n  type AppendResult,\n  type BlockerEntry,\n  type CalendarOptions,\n  type CalendarResult,\n  type ClaimResult,\n  type CloseResult,\n  type CloseTaskResult,\n  type CommitImportedItemParams,\n  type CommitImportedItemResult,\n  type CommentsCommandOptions,\n  type CommentsResult,\n  type ConfigCommandOptions,\n  type ConfigResult,\n  type CompletionResult,\n  type CompletionShell,\n  type ContractsCommandOptions,\n  type ContractsResult,\n  type ContextFocusItem,\n  type ContextOptions,\n  type ContextOutputFormat,\n  type ContextResult,\n  type CopyResult,\n  type CreatePmCliExpectedErrorOptions,\n  type CreateResult,\n  type CreateTemplateOptions,\n  type Dependency,\n  type DeleteResult,\n  type DepsCommandOptions,\n  type DepsResult,\n  type DocsCommandOptions,\n  type DocsResult,\n  type ExtensionCommandOptions,\n  type ExtensionCommandResult,\n  type FilesCommandOptions,\n  type FilesDiscoverOptions,\n  type FilesDiscoverResult,\n  type FilesResult,\n  type FocusResult,\n  type GcCommandOptions,\n  type GcResult,\n  type GetContractsOptions,\n  type GetOptions,\n  type GetResult,\n  type GuideDepth,\n  type GuideOptions,\n  type GuideOutputFormat,\n  type GuideResult,\n  type HealthResult,\n  type ImportLinkedScope,\n  type InitCommandOptions,\n  type InitResult,\n  type ItemFormatVersionScanEntry,\n  type ItemFormatVersionScanResult,\n  type ItemFormatVersionStatus,\n  type LearningsCommandOptions,\n  type LearningsResult,\n  type LinkedDoc,\n  type LinkedFile,\n  type LinkedTest,\n  type ListedItem,\n  type ListCompactResult,\n  type ListFullResult,\n  type ListOptions,\n  type ListProjectedItem,\n  type ListProjectedItemCore,\n  type ListResult,\n  type ListResultItem,\n  type ListSortField,\n  type ListSortOrder,\n  type ListTreeItem,\n  type ListTreeMetadata,\n  type ListVerboseResult,\n  type LogNote,\n  type NextActionableItem,\n  type NextBlockerRef,\n  type NextOptions,\n  type NextOutputFormat,\n  type NextRecommendation,\n  type NextResult,\n  type NotesCommandOptions,\n  type NotesResult,\n  type PackageCommandOptions,\n  type PackageCommandResult,\n  type PauseTaskResult,\n  type PmActionInput,\n  type PmActionName,\n  type PmActionOptions,\n  type PmClientCloseActionOptions,\n  type PmClientFullMutationOptions,\n  type PmClientMutationOptions,\n  type PmClientOptions,\n  type PmClientRunArgs,\n  type PmCliExpectedError,\n  type ProfileApplyCommandOptions,\n  type ProfileApplyResult,\n  type ProfileLintResult,\n  type ProfileListResult,\n  type ProfileResult,\n  type ProfileShowResult,\n  type ProfileSubcommand,\n  type ReindexOptions,\n  type ReindexResult,\n  type ReleaseResult,\n  type RestoreResult,\n  type RunHealthOptions,\n  type SchemaAddFieldCommandOptions,\n  type SchemaAddFieldResult,\n  type SchemaAddStatusCommandOptions,\n  type SchemaAddStatusResult,\n  type SchemaAddTypeCommandOptions,\n  type SchemaAddTypeInferCommandOptions,\n  type SchemaAddTypeInferResult,\n  type SchemaAddTypeResult,\n  type SchemaApplyPresetCommandOptions,\n  type SchemaApplyPresetResult,\n  type SchemaInspectResult,\n  type SchemaListFieldsResult,\n  type SchemaListResult,\n  type SchemaRemoveFieldCommandOptions,\n  type SchemaRemoveFieldResult,\n  type SchemaRemoveStatusCommandOptions,\n  type SchemaRemoveStatusResult,\n  type SchemaRemoveTypeCommandOptions,\n  type SchemaRemoveTypeResult,\n  type SchemaShowFieldResult,\n  type SchemaShowResult,\n  type SchemaShowStatusResult,\n  type SchemaResult,\n  type SchemaSubcommand,\n  type SearchCompactResult,\n  type SearchHit,\n  type SearchHitHighlight,\n  type SearchMatchMode,\n  type SearchOptions,\n  type ClaimNextOptions,\n  type SearchResult,\n  type SearchResultItem,\n  type SearchVerboseResult,\n  type StartTaskResult,\n  type StatsCommandOptions,\n  type StatsResult,\n  type TemplatesListResult,\n  type TemplatesSaveResult,\n  type TemplatesShowResult,\n  type TestRunsListCommandOptions,\n  type TestRunsLogsCommandOptions,\n  type TestRunsResumeCommandOptions,\n  type TestRunsStopCommandOptions,\n  type ToImportLinkedArtifactsOptions,\n  type ToImportLinkedTestsOptions,\n  type ToImportLogEntriesOptions,\n  type UpdateResult,\n  type UpgradeCommandOptions,\n  type UpgradeResult,\n  type ValidateCommandOptions,\n  type ValidateResult,\n  type WorkspaceContracts,\n  type WorkspaceContractsOptions,\n} from \"./runtime.js\";\nexport { runStats } from \"./stats.js\";\nexport {\n  DEFAULT_EVAL_QUERIES_RELATIVE_PATH,\n  runEval,\n  type EvalOptions,\n  type EvalQueryReport,\n  type EvalResult,\n} from \"./eval.js\";\nexport {\n  runTelemetry,\n  TELEMETRY_SUBCOMMANDS,\n  type TelemetryCommandOptions,\n  type TelemetrySubcommand,\n} from \"./telemetry.js\";\nexport {\n  classifyLinkedTestFailure,\n  countFailureCategories,\n  extractReferencedPmItemIdsFromCommand,\n  resolveLinkedTestFailureExitCode,\n  runLinkedTests,\n  runTest,\n  summarizeContextPreflight,\n  type LinkedTestFailureCategory,\n  type TestCommandOptions,\n  type TestResult,\n  type TestRunResult,\n} from \"./test/execution.js\";\nexport {\n  runTestAll,\n  type TestAllCommandOptions,\n  type TestAllItemResult,\n  type TestAllResult,\n} from \"./test/batch.js\";\nexport {\n  LINKED_TEST_ENV_NAME_PATTERN,\n  LINKED_TEST_PM_CONTEXT_MODE_VALUES,\n  LINKED_TEST_PROTECTED_ENV_KEYS,\n  parseLinkedTestAssertionEqualsMap,\n  parseLinkedTestAssertionGteMap,\n  parseLinkedTestBoolean,\n  parseLinkedTestContextMode,\n  parseLinkedTestEnvClear,\n  parseLinkedTestEnvSet,\n  parseLinkedTestJsonEntries,\n  parseLinkedTestMinLines,\n  parseLinkedTestRegexList,\n  parseLinkedTestStringList,\n  type LinkedTestPmContextMode,\n} from \"./test/parsers.js\";\nexport {\n  runStartBackgroundRun,\n  runTestRunsWorker,\n  type StartBackgroundRunCommandOptions,\n  type StartBackgroundRunResult,\n} from \"./test/runs.js\";\nexport {\n  BUILTIN_PROFILES,\n  listProfiles,\n  normalizeProfileName,\n  PROFILE_NAMES,\n  resolveProfile,\n  type ProfileConfigEntry,\n  type ProfileName,\n  type ProfilePackageRecommendation,\n  type ProfileTemplateEntry,\n  type ProfileTemplateOptions,\n  type ProjectProfileDefinition,\n  type ProjectProfileRegistrationInput,\n} from \"../core/profile/profile-presets.js\";\nexport {\n  planProfileApplication,\n  type ProfileApplicationPlan,\n  type ProfileChangeStatus,\n  type ProfileComponentChange,\n  type ProfileConfigChange,\n  type ProfileConfigPlan,\n  type ProfileCurrentState,\n  type ProfilePackagePlan,\n  type ProfileSchemaPlan,\n  type ProfileTemplateChange,\n  type ProfileTemplatePlan,\n  type ProfileWorkflowChange,\n  type ProfileWorkflowPlan,\n} from \"../core/profile/profile-plan.js\";\nexport {\n  describeProfileComposition,\n  describeProjectProfile,\n  type ProjectProfileComposition,\n  type ProjectProfileDescription,\n  type ProjectProfilePackageSummary,\n} from \"../core/profile/profile-describe.js\";\nexport {\n  lintProjectProfile,\n  PROFILE_LINT_CODES,\n  PROFILE_LINT_DIMENSIONS,\n  type ProfileLintCode,\n  type ProfileLintDimension,\n  type ProfileLintSeverity,\n  type ProjectProfileLintFinding,\n  type ProjectProfileLintReport,\n} from \"../core/profile/profile-lint.js\";\nexport {\n  assertExtensionBlueprint,\n  assertExtensionCapabilityUsage,\n  assertExtensionDeactivated,\n  assertExtensionManifestCompatible,\n  assertExtensionManifestMatchesBlueprint,\n  assertExtensionPreflight,\n  assertPackageManifest,\n  assertProjectProfile,\n  assertRegisteredCommandContract,\n  assertRegisteredCommandOverride,\n  assertRegisteredExporter,\n  assertRegisteredFlags,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredMigration,\n  assertRegisteredParserOverride,\n  assertRegisteredPreflightOverride,\n  assertRegisteredProfile,\n  assertRegisteredRendererOverride,\n  assertRegisteredSearchProvider,\n  assertRegisteredServiceOverride,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  createExtensionTestHarness,\n  deactivateExtensionForTest,\n  describeExtensionActivation,\n  runRegisteredCommandForTest,\n  runRegisteredCommandOverrideForTest,\n  runRegisteredExporterForTest,\n  runRegisteredHookForTest,\n  runRegisteredImporterForTest,\n  runRegisteredMigrationForTest,\n  runRegisteredParserOverrideForTest,\n  runRegisteredPreflightOverrideForTest,\n  runRegisteredRendererOverrideForTest,\n  runRegisteredSearchProviderForTest,\n  runRegisteredServiceOverrideForTest,\n  runRegisteredVectorStoreAdapterForTest,\n  type ActivateExtensionForTestOptions,\n  type AssertProjectProfileOptions,\n  type DeactivateExtensionForTestOptions,\n  type DescribeExtensionActivationOptions,\n  type ExtensionActivationSummary,\n  type RenderExtensionHarnessMarkdownOptions,\n  type RunRegisteredCommandForTestOptions,\n  type RunRegisteredExporterForTestOptions,\n  type RunRegisteredHookForTestOptions,\n  type RunRegisteredImporterForTestOptions,\n  type RunRegisteredMigrationForTestOptions,\n  type RunRegisteredSearchProviderForTestOptions,\n  type RunRegisteredVectorStoreAdapterForTestOptions,\n  type SearchProviderOperationContexts,\n  type SearchProviderOperationResults,\n  type VectorStoreAdapterOperationContexts,\n  type VectorStoreAdapterOperationResults,\n  type ExtensionCapabilityUsageAssertion,\n  type ExtensionCapabilityUsageExpectation,\n  type ExtensionDeactivationExpectation,\n  type ExtensionManifestBlueprintMatch,\n  type ExtensionTestHarness,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredCommandOverrideExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredFlagsExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredMigrationExpectation,\n  type RegisteredParserOverrideExpectation,\n  type RegisteredPreflightOverrideExpectation,\n  type RegisteredProfileAssertion,\n  type RegisteredProfileExpectation,\n  type RegisteredRendererOverrideExpectation,\n  type RegisteredSearchProviderExpectation,\n  type RegisteredServiceOverrideExpectation,\n  type RegisteredVectorStoreAdapterExpectation,\n} from \"./testing.js\";\n\n/**\n * Canonical extension capability names accepted by pm.\n *\n * Extension manifests should declare one or more of these values in\n * `capabilities`.\n */\nexport const EXTENSION_CAPABILITIES = KNOWN_EXTENSION_CAPABILITIES;\n/** Restricts extension capability values accepted by command, SDK, and storage contracts. */\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/** Canonical extension governance policy modes and registration surfaces. */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\n/** Public contract for extension policy surfaces, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\n/** Public contract for extension trust modes, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\n/** Public contract for extension sandbox profiles, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\n/** Restricts extension policy mode values accepted by command, SDK, and storage contracts. */\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\n/** Restricts extension policy surface values accepted by command, SDK, and storage contracts. */\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\n/** Restricts extension trust mode values accepted by command, SDK, and storage contracts. */\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\n/** Restricts extension sandbox profile values accepted by command, SDK, and storage contracts. */\nexport type ExtensionSandboxProfile =\n  (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/** Versioned capability contract metadata emitted by runtime diagnostics. */\nexport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n};\n\n/** Least-privilege capability reconciliation helpers: map declared capabilities against the registration surfaces a package actually exercises at activation. */\nexport {\n  EXTENSION_CAPABILITY_REGISTRATION_SURFACES,\n  collectUsedExtensionCapabilities,\n  reconcileExtensionCapabilityUsage,\n  type CollectUsedExtensionCapabilitiesOptions,\n  type ExtensionCapabilityUsageReconciliation,\n} from \"../core/extensions/capability-usage.js\";\n\n/**\n * Render an extension/package activation summary\n * ({@link describeExtensionActivation} / {@link describeExtensionBlueprint}) to a\n * deterministic Markdown reference document — the author-facing *render* leg of\n * the describe verb, for drift-free package READMEs.\n */\nexport {\n  renderExtensionSurfaceMarkdown,\n  type ExtensionSurfaceMarkdownOptions,\n} from \"../core/extensions/activation-summary-markdown.js\";\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandHandlerResult,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationFailure,\n  ExtensionDeactivationOptions,\n  ExtensionDeactivationResult,\n  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionHookRegistry,\n  ExtensionSelfIdentity,\n  ExtensionLoadResult,\n  ExtensionManifest,\n  ExtensionManifestEngines,\n  ExtensionGovernancePolicy,\n  ExtensionPolicyOverride,\n  ExtensionProvenanceMetadata,\n  ExtensionRuntimePermissionDeclaration,\n  ExtensionSearchMode,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  ExtensionServiceRegistry,\n  FlagValueType,\n  FlagDefinition,\n  ImportExportContext,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnIndexHookContext,\n  OnReadHook,\n  OnReadHookContext,\n  OnWriteHook,\n  OnWriteHookContext,\n  OutputRendererFormat,\n  ParserOverride,\n  ParserOverrideContext,\n  ParserOverrideDelta,\n  PreflightOverride,\n  PreflightOverrideContext,\n  PreflightOverrideDelta,\n  PreflightRuntimeDecision,\n  RegisteredExtensionExporter,\n  RegisteredExtensionFlagDefinitions,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionProjectProfile,\n  RegisteredExtensionSchemaMigrationDefinition,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionServiceOverride,\n  RegisteredExtensionVectorStoreAdapter,\n  RendererOverride,\n  RendererOverrideContext,\n  SchemaFieldDefinition,\n  SchemaItemTypeCommandOptionPolicyDefinition,\n  SchemaItemTypeOptionDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SchemaMigrationRunContext,\n  SchemaMigrationRunner,\n  SearchProviderEmbedBatchContext,\n  SearchProviderEmbedContext,\n  SearchProviderDefinition,\n  SearchProviderHit,\n  SearchProviderQueryContext,\n  SearchProviderQueryResult,\n  ServiceOverride,\n  ServiceOverrideContext,\n  VectorStoreAdapterDefinition,\n  VectorStoreDeleteContext,\n  VectorStoreQueryContext,\n  VectorStoreQueryHit,\n  VectorStoreUpsertContext,\n  VectorStoreUpsertPoint,\n} from \"../core/extensions/loader.js\";\n\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type {\n  ItemDocument,\n  ItemMetadata,\n  ItemStatus,\n  ItemType,\n  PmSettings,\n} from \"../types/index.js\";\n"],
+  "mappings": "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",
+  "names": ["fs", "path", "path", "fs", "profile"]
 }

package/dist/cli.js

@@ -5,13 +5,14 @@
  * Bootstraps the executable pm CLI entrypoint and startup optimizations.
  */
 
-!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]="075ca281-c433-52c9-bb4f-4add8c1e3d3a")}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]="820a74b6-6438-5658-92f2-232f1a7d38b1")}catch(e){}}();
 import fs from "node:fs";
 import * as nodeModule from "node:module";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { runCliWithBundleIntegrity, } from "./cli/bundle-integrity.js";
+import { pruneCompileCacheGenerations, resolveCompileCacheGeneration, } from "./sdk/compile-cache.js";
 function enableNodeCompileCache() {
     const { enableCompileCache } = nodeModule;
     if (typeof enableCompileCache !== "function" ||
@@ -21,9 +22,14 @@ function enableNodeCompileCache() {
     const userCacheKey = typeof process.getuid === "function"
         ? String(process.getuid())
         : os.userInfo().username.replace(/[^a-zA-Z0-9._-]/g, "_");
-    const cacheDir = process.env.PM_CLI_COMPILE_CACHE_DIR ??
-        path.join(os.tmpdir(), `pm-cli-node-compile-cache-${userCacheKey}`);
+    const configuredCacheDir = process.env.PM_CLI_COMPILE_CACHE_DIR;
+    const defaultCacheRoot = path.join(os.tmpdir(), `pm-cli-node-compile-cache-${userCacheKey}`);
+    const generation = resolveCompileCacheGeneration(readPackageVersionForPath(fileURLToPath(import.meta.url)));
+    const cacheDir = configuredCacheDir ?? path.join(defaultCacheRoot, generation);
     try {
+        if (configuredCacheDir === undefined) {
+            pruneCompileCacheGenerations(defaultCacheRoot, generation);
+        }
         enableCompileCache(cacheDir);
     }
     catch {
@@ -87,4 +93,4 @@ if (!printFastVersionIfRequested()) {
     await runCliWithBundleIntegrity(process.argv.slice(2), cliEntrypointPath, () => import("./cli-bundle/main.js"), process.stderr.write.bind(process.stderr));
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=075ca281-c433-52c9-bb4f-4add8c1e3d3a
+//# debugId=820a74b6-6438-5658-92f2-232f1a7d38b1

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sources":["cli.ts"],"sourceRoot":"/","sourcesContent":["#!/usr/bin/env node\n/**\n * @module cli\n *\n * Bootstraps the executable pm CLI entrypoint and startup optimizations.\n */\nimport fs from \"node:fs\";\nimport * as nodeModule from \"node:module\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  runCliWithBundleIntegrity,\n} from \"./cli/bundle-integrity.js\";\n\ntype NodeModuleWithCompileCache = typeof nodeModule & {\n  enableCompileCache?: (cacheDir?: string) => {\n    status?: number;\n    message?: string;\n  };\n};\n\nfunction enableNodeCompileCache(): void {\n  const { enableCompileCache } = nodeModule as NodeModuleWithCompileCache;\n  if (\n    typeof enableCompileCache !== \"function\" ||\n    process.env.PM_CLI_DISABLE_COMPILE_CACHE === \"1\"\n  ) {\n    return;\n  }\n  const userCacheKey =\n    typeof process.getuid === \"function\"\n      ? String(process.getuid())\n      : os.userInfo().username.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n  const cacheDir =\n    process.env.PM_CLI_COMPILE_CACHE_DIR ??\n    path.join(os.tmpdir(), `pm-cli-node-compile-cache-${userCacheKey}`);\n  try {\n    enableCompileCache(cacheDir);\n  } catch {\n    // Compile caching is a startup optimization only; never block CLI execution.\n  }\n}\n\nfunction findPackageJson(startPath: string): string | undefined {\n  let current = path.dirname(path.resolve(startPath));\n  while (true) {\n    const candidate = path.join(current, \"package.json\");\n    if (fs.existsSync(candidate)) {\n      return candidate;\n    }\n    const parent = path.dirname(current);\n    if (parent === current) {\n      return undefined;\n    }\n    current = parent;\n  }\n}\n\nfunction printFastVersionIfRequested(): boolean {\n  const args = process.argv.slice(2);\n  const versionArgs = args.filter((arg) => arg !== \"--no-extensions\");\n  if (\n    versionArgs.length !== 1 ||\n    (versionArgs[0] !== \"--version\" && versionArgs[0] !== \"-V\")\n  ) {\n    return false;\n  }\n  const version = readPackageVersionForPath(fileURLToPath(import.meta.url));\n  if (version === undefined) {\n    return false;\n  }\n  console.log(version);\n  return true;\n}\n\nfunction readPackageVersionForPath(startPath: string): string | undefined {\n  const packageJsonPath = findPackageJson(startPath);\n  if (!packageJsonPath) {\n    return undefined;\n  }\n  try {\n    const parsed = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\")) as {\n      version?: unknown;\n    };\n    if (typeof parsed.version !== \"string\") {\n      return undefined;\n    }\n    return parsed.version;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  enableNodeCompileCache,\n  findPackageJson,\n  printFastVersionIfRequested,\n  readPackageVersionForPath,\n};\n\nif (!printFastVersionIfRequested()) {\n  enableNodeCompileCache();\n  const cliEntrypointPath = fileURLToPath(import.meta.url);\n  await runCliWithBundleIntegrity(\n    process.argv.slice(2),\n    cliEntrypointPath,\n    () => import(\"./cli/main.js\"),\n    process.stderr.write.bind(process.stderr),\n  );\n}\n"],"names":[],"mappings":"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","debugId":"075ca281-c433-52c9-bb4f-4add8c1e3d3a"}
+{"version":3,"file":"cli.js","sources":["cli.ts"],"sourceRoot":"/","sourcesContent":["#!/usr/bin/env node\n/**\n * @module cli\n *\n * Bootstraps the executable pm CLI entrypoint and startup optimizations.\n */\nimport fs from \"node:fs\";\nimport * as nodeModule from \"node:module\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  runCliWithBundleIntegrity,\n} from \"./cli/bundle-integrity.js\";\nimport {\n  pruneCompileCacheGenerations,\n  resolveCompileCacheGeneration,\n} from \"./sdk/compile-cache.js\";\n\ntype NodeModuleWithCompileCache = typeof nodeModule & {\n  enableCompileCache?: (cacheDir?: string) => {\n    status?: number;\n    message?: string;\n  };\n};\n\nfunction enableNodeCompileCache(): void {\n  const { enableCompileCache } = nodeModule as NodeModuleWithCompileCache;\n  if (\n    typeof enableCompileCache !== \"function\" ||\n    process.env.PM_CLI_DISABLE_COMPILE_CACHE === \"1\"\n  ) {\n    return;\n  }\n  const userCacheKey =\n    typeof process.getuid === \"function\"\n      ? String(process.getuid())\n      : os.userInfo().username.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n  const configuredCacheDir = process.env.PM_CLI_COMPILE_CACHE_DIR;\n  const defaultCacheRoot = path.join(\n    os.tmpdir(),\n    `pm-cli-node-compile-cache-${userCacheKey}`,\n  );\n  const generation = resolveCompileCacheGeneration(\n    readPackageVersionForPath(fileURLToPath(import.meta.url)),\n  );\n  const cacheDir = configuredCacheDir ?? path.join(defaultCacheRoot, generation);\n  try {\n    if (configuredCacheDir === undefined) {\n      pruneCompileCacheGenerations(defaultCacheRoot, generation);\n    }\n    enableCompileCache(cacheDir);\n  } catch {\n    // Compile caching is a startup optimization only; never block CLI execution.\n  }\n}\n\nfunction findPackageJson(startPath: string): string | undefined {\n  let current = path.dirname(path.resolve(startPath));\n  while (true) {\n    const candidate = path.join(current, \"package.json\");\n    if (fs.existsSync(candidate)) {\n      return candidate;\n    }\n    const parent = path.dirname(current);\n    if (parent === current) {\n      return undefined;\n    }\n    current = parent;\n  }\n}\n\nfunction printFastVersionIfRequested(): boolean {\n  const args = process.argv.slice(2);\n  const versionArgs = args.filter((arg) => arg !== \"--no-extensions\");\n  if (\n    versionArgs.length !== 1 ||\n    (versionArgs[0] !== \"--version\" && versionArgs[0] !== \"-V\")\n  ) {\n    return false;\n  }\n  const version = readPackageVersionForPath(fileURLToPath(import.meta.url));\n  if (version === undefined) {\n    return false;\n  }\n  console.log(version);\n  return true;\n}\n\nfunction readPackageVersionForPath(startPath: string): string | undefined {\n  const packageJsonPath = findPackageJson(startPath);\n  if (!packageJsonPath) {\n    return undefined;\n  }\n  try {\n    const parsed = JSON.parse(fs.readFileSync(packageJsonPath, \"utf8\")) as {\n      version?: unknown;\n    };\n    if (typeof parsed.version !== \"string\") {\n      return undefined;\n    }\n    return parsed.version;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Public contract for test only, shared by SDK and presentation-layer consumers. */\nexport const _testOnly = {\n  enableNodeCompileCache,\n  findPackageJson,\n  printFastVersionIfRequested,\n  readPackageVersionForPath,\n};\n\nif (!printFastVersionIfRequested()) {\n  enableNodeCompileCache();\n  const cliEntrypointPath = fileURLToPath(import.meta.url);\n  await runCliWithBundleIntegrity(\n    process.argv.slice(2),\n    cliEntrypointPath,\n    () => import(\"./cli/main.js\"),\n    process.stderr.write.bind(process.stderr),\n  );\n}\n"],"names":[],"mappings":"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","debugId":"820a74b6-6438-5658-92f2-232f1a7d38b1"}

package/dist/core/diagnostics/remediation.js

@@ -19,7 +19,7 @@
  */
 /** Registry of every non-extension `pm health` / `pm validate` warning code and its remediation. Extension findings keep their richer, contextual `details.triage.remediation` produced by the extension health triage and are intentionally excluded here (see pm-0hnu: "all non-extension checks"). */
 
-!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]="70a08ddd-31a3-56c2-b57b-d13e29b9e40e")}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]="836f71d5-acd0-5c77-ae31-9ae98914727c")}catch(e){}}();
 export const REMEDIATION_REGISTRY = Object.freeze([
     // --- pm health: directories ---
     {
@@ -28,6 +28,11 @@ export const REMEDIATION_REGISTRY = Object.freeze([
         summary: "Recreate missing tracker directories (pm init is idempotent and restores the scaffold).",
     },
     // --- pm health: settings (read/parse) ---
+    {
+        code: "settings_read_fs_error",
+        command: "pm config list --json",
+        summary: "settings.json could not be read as a regular file and pm fell back to defaults; repair the reported path or permissions, then re-run.",
+    },
     {
         code: "settings_read_invalid_json",
         command: "pm config list --json",
@@ -444,4 +449,4 @@ export function buildRemediationCommands(warnings) {
     return Object.values(buildRemediationMap(warnings));
 }
 //# sourceMappingURL=remediation.js.map
-//# debugId=70a08ddd-31a3-56c2-b57b-d13e29b9e40e
+//# debugId=836f71d5-acd0-5c77-ae31-9ae98914727c

package/dist/core/diagnostics/remediation.js.map

@@ -1 +1 @@
-{"version":3,"file":"remediation.js","sources":["core/diagnostics/remediation.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Shared machine-executable remediation registry.\n *\n * `pm health` and `pm validate` both emit stable, colon-delimited warning tokens\n * (for example `history_drift_missing_stream:pm-abcd` or\n * `validate_resolution_missing_fields:3`). Agents that gate on these commands\n * previously had to hardcode the mapping from a warning code to the `pm` command\n * that fixes it. This module is the single source of truth for that mapping so\n * `pm health --json` (per-check `remediation_map`) and `pm validate --fix-hints`\n * (per-check `fix_hints`) can both surface executable remediation without any\n * duplicated, drift-prone lookup tables.\n *\n * Semantics of {@link RemediationEntry.command}: the suggested next `pm` command\n * an operator/agent should run to resolve findings with that code. Per-item\n * findings use an `<id>` placeholder (callers that have the concrete id may\n * substitute it); findings whose only fix is a manual file edit point at the\n * most useful diagnostic/repair command and describe the manual step in\n * {@link RemediationEntry.summary}.\n */\n\n/** Maps a stable diagnostic warning code to the command and summary that resolve it. */\nexport interface RemediationEntry {\n  /** Stable warning-code prefix this entry resolves. A warning matches when it equals this code or begins with `<code>:`. Registry codes are mutually exclusive under that colon-boundary rule (no code is a `:`-delimited prefix of another — e.g. `settings:id_prefix_empty` is distinct from a bare `settings`, which is intentionally not registered), so `resolveRemediation` uses first-match with no ordering dependency. */\n  readonly code: string;\n  /** Executable `pm` command (or imperative) that resolves the finding. May contain an `<id>` placeholder. */\n  readonly command: string;\n  /** One-line description of what the command does / which manual step it covers. */\n  readonly summary: string;\n}\n\n/** Registry of every non-extension `pm health` / `pm validate` warning code and its remediation. Extension findings keep their richer, contextual `details.triage.remediation` produced by the extension health triage and are intentionally excluded here (see pm-0hnu: \"all non-extension checks\"). */\nexport const REMEDIATION_REGISTRY: readonly RemediationEntry[] = Object.freeze([\n  // --- pm health: directories ---\n  {\n    code: \"missing_directory\",\n    command: \"pm init\",\n    summary:\n      \"Recreate missing tracker directories (pm init is idempotent and restores the scaffold).\",\n  },\n  // --- pm health: settings (read/parse) ---\n  {\n    code: \"settings_read_invalid_json\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run.\",\n  },\n  {\n    code: \"settings_read_invalid_schema\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run.\",\n  },\n  {\n    code: \"settings_read_merge_failed\",\n    command: \"pm config list --json\",\n    summary:\n      \"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files.\",\n  },\n  // --- pm health: settings_values ---\n  {\n    code: \"settings:id_prefix_empty\",\n    command: \"pm config list --json\",\n    summary:\n      'id_prefix is empty; set a non-empty \"id_prefix\" in settings.json so generated item ids are well-formed.',\n  },\n  {\n    code: \"settings:locks_ttl_non_positive\",\n    command: \"pm config list --json\",\n    summary:\n      'locks.ttl_seconds must be positive; set a positive \"locks.ttl_seconds\" in settings.json.',\n  },\n  // --- pm health: telemetry (advisory) ---\n  {\n    code: \"telemetry_state_invalid_json\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_invalid_rows\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_pending\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_high_retries\",\n    command: \"pm telemetry flush\",\n    summary:\n      \"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_failed\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_http_status\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only.\",\n  },\n  {\n    code: \"telemetry_schema_version_behind\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"Client schema is behind server; upgrade pm-cli to emit the latest event shape.\",\n  },\n  {\n    code: \"telemetry_otel_export_failing\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only.\",\n  },\n  // --- pm health: integrity ---\n  {\n    code: \"integrity_item_unreadable\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary:\n      \"An item file could not be read; restore or repair the file at the reported path.\",\n  },\n  {\n    code: \"integrity_item_parse_failed\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary:\n      \"An item file failed to parse; fix the malformed item metadata at the reported path.\",\n  },\n  {\n    code: \"integrity_item_conflict_marker\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary:\n      \"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line.\",\n  },\n  {\n    code: \"integrity_history_unreadable\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"A history stream could not be read; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_invalid_json\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"A history stream contains invalid JSON; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_conflict_marker\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain.\",\n  },\n  // --- pm validate: storage_integrity (post-merge corruption detection) ---\n  {\n    code: \"validate_storage_unreadable_items\",\n    command: \"pm validate --check-storage-integrity --verbose-diagnostics\",\n    summary:\n      \"An on-disk item file cannot be parsed (for example a botched merge resolution with stale TOON count headers); repair or restore the file at the reported path — list commands silently skip it while pm get hard-errors.\",\n  },\n  {\n    code: \"validate_storage_duplicate_item_ids\",\n    command: \"pm validate --check-storage-integrity --verbose-diagnostics\",\n    summary:\n      \"One item id is claimed by multiple item documents — usually two branches minting the same id for different items before merging (GH-600). Keep one document, recreate the other item under a fresh id (pm copy, then delete the colliding file), and consider raising ids.token_length for concurrent multi-agent work.\",\n  },\n  {\n    code: \"validate_storage_history_conflict_markers\",\n    command: \"pm merge driver history <base> <ours> <theirs>\",\n    summary:\n      \"A history stream contains unresolved Git conflict markers; re-merge it with the pm history merge driver (or resolve the markers by hand), then run pm history-repair for the item.\",\n  },\n  {\n    code: \"validate_storage_unparseable_history\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"A history stream's newest line is not valid JSONL; repair or restore the stream before further mutations.\",\n  },\n  {\n    code: \"validate_storage_resurrected_items\",\n    command: \"pm delete <id>\",\n    summary:\n      \"A live item's newest history operation is a delete: a delete/modify merge silently resurrected it. Decide the winner — re-delete the item, or keep it and append a mutation documenting the revival.\",\n  },\n  {\n    code: \"validate_storage_unparseable_config\",\n    command: \"pm merge driver json <base> <ours> <theirs>\",\n    summary:\n      \"settings.json or a schema file cannot be parsed, so pm silently falls back to defaults; re-merge it with the pm JSON merge driver or fix the file by hand, then rerun pm validate.\",\n  },\n  {\n    code: \"validate_merge_fence_drift\",\n    command: \"pm merge install\",\n    summary:\n      \"The committed .gitattributes merge fence no longer matches the active schema's type folders or tracker JSONL stores; rerun pm merge install (and commit .gitattributes) so every tracker artifact keeps its field-aware merge driver.\",\n  },\n  // --- pm health (integrity) + pm validate (format_version): item format version ---\n  {\n    code: \"integrity_item_outdated_format_version\",\n    command: \"pm validate --verbose-diagnostics\",\n    summary:\n      \"An item predates the current storage format version; a pm storage migration rewrites it. Use --verbose-diagnostics to list the affected items.\",\n  },\n  {\n    code: \"integrity_item_ahead_format_version\",\n    command: \"npm install -g @unbrained/pm-cli@latest\",\n    summary:\n      \"An item was written by a newer pm format version than this runtime supports; upgrade pm to read and validate it safely.\",\n  },\n  // --- pm health: history_drift ---\n  // `pm health` rewrites these commands to `pm history-repair --all` in the\n  // per-check remediation_map when more than one stream is drifted.\n  {\n    code: \"history_drift_missing_stream\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  {\n    code: \"history_drift_unreadable_stream\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  {\n    code: \"history_drift_hash_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  {\n    code: \"history_drift_chain_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  // --- pm health: storage (history compaction policy) ---\n  {\n    code: \"history_stream_over_compact_threshold\",\n    command: \"pm history-compact <id>\",\n    summary:\n      \"The history stream exceeds the configured compaction threshold; compact it (pm history-compact --all-streams sweeps every over-threshold stream in one pass).\",\n  },\n  {\n    code: \"history_unknown_author_events\",\n    command: \"pm validate --check-history-drift --fix-hints\",\n    summary:\n      \"Historical mutations lack attributable authorship. Configure PM_AUTHOR, pass global --author, or set author_default so future audit events are attributable.\",\n  },\n  // --- pm health: locks ---\n  {\n    code: \"locks_stale_count\",\n    command: \"pm gc --scope locks\",\n    summary:\n      \"Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them — gc retains active and unparseable locks.\",\n  },\n  {\n    code: \"locks_unreadable\",\n    command: \"pm gc --scope locks --dry-run\",\n    summary:\n      \"Some lock files could not be read; preview the sweep and inspect the unreadable files manually — gc never deletes what it cannot read.\",\n  },\n  // --- pm health: extensions ---\n  // Most extension findings keep their richer, contextual\n  // `details.triage.remediation` and are intentionally absent here. The\n  // partial-coverage code is the exception: it is not a per-extension triage\n  // result but a system-wide adoption gap (unmanaged installs the update-health\n  // scan had to skip), so it has a single deterministic fix and belongs in the\n  // shared registry like any other health finding (pm-bdvm).\n  {\n    code: \"extension_update_health_partial_coverage\",\n    command: \"pm extension --adopt-all --project\",\n    summary:\n      \"Update-health coverage is partial because unmanaged extensions were skipped; adopt the existing installs into managed metadata so the update scan covers them (use --global for global-scope extensions, or pm package --adopt-all when working with packages).\",\n  },\n  // --- pm health: vectorization ---\n  {\n    code: \"vectorization_stale_items_remaining\",\n    command: \"pm health --refresh-vectors\",\n    summary:\n      \"Some items have stale embeddings; refresh vectors so semantic search results stay current.\",\n  },\n  {\n    code: \"vectorization_embedding_identity_changed\",\n    command: \"pm reindex --mode semantic\",\n    summary:\n      \"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors.\",\n  },\n  // --- pm validate: metadata ---\n  // Note: validate_metadata_missing_author has no entry on purpose. `pm update\n  // --author` sets the mutation/audit author (history), not the item's\n  // `metadata.author` item-metadata field, and there is no CLI flag that writes\n  // that field — so emitting a command here would record an audit entry without\n  // clearing the finding. A missing item author must be restored at the source.\n  {\n    code: \"validate_metadata_missing_acceptance_criteria\",\n    command: 'pm update <id> --acceptance-criteria \"<criteria>\"',\n    summary:\n      \"Backfill the missing acceptance criteria on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_estimate\",\n    command: 'pm update <id> --estimate \"<estimate>\"',\n    summary: \"Backfill the missing estimate on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_close_reason\",\n    command: 'pm update <id> --close-reason \"<reason>\"',\n    summary:\n      \"Backfill the missing close reason on the reported closed item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_reviewer\",\n    command: 'pm update <id> --reviewer \"<name>\"',\n    summary: \"Backfill the missing reviewer on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_risk\",\n    command: 'pm update <id> --risk \"<level>\"',\n    summary: \"Backfill the missing risk on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_confidence\",\n    command: 'pm update <id> --confidence \"<level>\"',\n    summary: \"Backfill the missing confidence on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_sprint\",\n    command: 'pm update <id> --sprint \"<sprint>\"',\n    summary: \"Backfill the missing sprint on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_release\",\n    command: 'pm update <id> --release \"<release>\"',\n    summary: \"Backfill the missing release on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_custom_profile_missing_required_fields\",\n    command: 'pm config set metadata-required-fields --criterion \"<field>\"',\n    summary:\n      \"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items.\",\n  },\n  {\n    code: \"validate_metadata_duplicate_issue_codes\",\n    command: 'pm update <id> --title \"<distinct title>\"',\n    summary:\n      \"Two or more items share one logical issue code (GH-235); give each a distinct title so the derived code is unique, or close the redundant item with pm close <id> --duplicate-of <canonical-id> (closed-as-duplicate items are excluded from the check).\",\n  },\n  // --- pm validate: resolution ---\n  {\n    code: \"validate_resolution_missing_fields\",\n    command: 'pm update <id> --resolution \"<how resolved>\"',\n    summary:\n      \"Backfill resolution / expected_result / actual_result on the reported closed item(s).\",\n  },\n  // --- pm validate: lifecycle ---\n  {\n    code: \"validate_lifecycle_active_closure_like_metadata\",\n    command: \"pm update <id> --unset <closure-like-field>\",\n    summary:\n      \"Clear the closure-like field the validator flags on this active item — the detail row names it (resolution / actual-result / blocked-reason) — or close the item if it is actually done.\",\n  },\n  {\n    code: \"validate_lifecycle_active_terminal_parent\",\n    command: \"pm update <id> --parent <active-parent-id>\",\n    summary:\n      \"Reopen the terminal parent or move the active child under a non-terminal parent.\",\n  },\n  {\n    code: \"validate_lifecycle_stale_blockers\",\n    command: \"pm update <id> --unset blocked-by --unset blocked-reason\",\n    summary:\n      \"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles_error\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary:\n      \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary:\n      \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  {\n    code: \"validate_hierarchy_parent_cycle_error\",\n    command: \"pm update <id> --parent <other-id>\",\n    summary:\n      \"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent).\",\n  },\n  {\n    code: \"validate_hierarchy_parent_cycle\",\n    command: \"pm update <id> --parent <other-id>\",\n    summary:\n      \"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent).\",\n  },\n  // --- pm validate: files ---\n  {\n    code: \"validate_files_missing_linked_paths\",\n    command: \"pm <files|docs> <id> --remove <path>\",\n    summary:\n      \"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc).\",\n  },\n  {\n    code: \"validate_files_orphaned_paths\",\n    command: \"pm <files|docs> <id> --add <path>\",\n    summary:\n      \"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace.\",\n  },\n  {\n    code: \"validate_files_tracked_all_strict_forces_pm_internals\",\n    command: \"pm validate --check-files --include-pm-internals\",\n    summary:\n      \"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode.\",\n  },\n  // --- pm validate: history_drift ---\n  {\n    code: \"validate_history_drift_missing_streams\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"Re-anchor the history chains of the items missing a history stream.\",\n  },\n  {\n    code: \"validate_history_drift_unreadable_streams\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"Re-anchor the history chains of the items with an unreadable history stream.\",\n  },\n  {\n    code: \"validate_history_drift_hash_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"Re-anchor the history chains of the items whose content hash drifted.\",\n  },\n  {\n    code: \"validate_history_drift_chain_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"Re-anchor the history chains of the items with a broken history chain.\",\n  },\n  {\n    code: \"validate_history_unknown_author_events\",\n    command: \"pm config project set author_default <stable-agent-id>\",\n    summary:\n      \"Historical mutations lack attributable authorship. Set a stable default or use invocation-wide --author for future events; existing audit history remains append-only.\",\n  },\n  // --- pm validate: command_references ---\n  {\n    code: \"validate_command_references_stale_pm_ids\",\n    command:\n      'pm update <id> --replace-tests --test \"command=<corrected-command>\" [--test ...]',\n    summary:\n      \"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call.\",\n  },\n  {\n    code: \"validate_format_version_outdated_items\",\n    command: \"pm validate --verbose-diagnostics\",\n    summary:\n      \"One or more items predate the current storage format version; a pm storage migration rewrites them. Use --verbose-diagnostics to list the affected items.\",\n  },\n  {\n    code: \"validate_format_version_ahead_items\",\n    command: \"npm install -g @unbrained/pm-cli@latest\",\n    summary:\n      \"One or more items were written by a newer pm format version than this runtime supports; upgrade pm to read and validate them safely.\",\n  },\n]);\n\n/**\n * Resolve the remediation entry for a warning token, or `undefined` when no\n * entry is registered. A warning matches an entry when it equals the entry code\n * or begins with `<code>:` (the colon boundary keeps sibling codes such as\n * `validate_lifecycle_dependency_cycles` and\n * `validate_lifecycle_dependency_cycles_error` disjoint).\n *\n * First match is intentional and correct: registry codes are mutually exclusive\n * under the colon-boundary rule, so at most one entry can ever match a warning\n * and order is irrelevant. That invariant is enforced by a test (see\n * remediation-registry.spec.ts \"keeps every registry code mutually exclusive\"),\n * which is why this stays a simple linear scan rather than a longest-prefix\n * search — a longest-prefix tie-break is unreachable with disjoint codes.\n *\n * Accepts unknown input defensively (this is an exported helper SDK consumers\n * may call from untyped JS): a non-string `warning` resolves to `undefined`.\n */\nexport function resolveRemediation(\n  warning: string,\n): RemediationEntry | undefined {\n  if (typeof warning !== \"string\") {\n    return undefined;\n  }\n  const normalized = warning.trim();\n  for (const entry of REMEDIATION_REGISTRY) {\n    if (normalized === entry.code || normalized.startsWith(`${entry.code}:`)) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n\n/** Build a compact `remediation_map` (code -> command) for a set of warning tokens. First match wins per code; unknown codes are skipped. Used by `pm health --json` per-check details and as the source of deduped executable commands for `pm validate --fix-hints`. */\nexport function buildRemediationMap(\n  warnings: Iterable<string>,\n): Record<string, string> {\n  const map: Record<string, string> = {};\n  for (const warning of warnings) {\n    const entry = resolveRemediation(warning);\n    if (\n      entry !== undefined &&\n      !Object.prototype.hasOwnProperty.call(map, entry.code)\n    ) {\n      map[entry.code] = entry.command;\n    }\n  }\n  return map;\n}\n\n/** Build a deduped, ordered list of executable remediation commands for a set of warning tokens (one command per distinct matched code). Used by `pm validate --fix-hints` for checks that do not already emit per-row remediation commands. */\nexport function buildRemediationCommands(warnings: Iterable<string>): string[] {\n  return Object.values(buildRemediationMap(warnings));\n}\n"],"names":[],"mappings":"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","debugId":"70a08ddd-31a3-56c2-b57b-d13e29b9e40e"}
+{"version":3,"file":"remediation.js","sources":["core/diagnostics/remediation.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Shared machine-executable remediation registry.\n *\n * `pm health` and `pm validate` both emit stable, colon-delimited warning tokens\n * (for example `history_drift_missing_stream:pm-abcd` or\n * `validate_resolution_missing_fields:3`). Agents that gate on these commands\n * previously had to hardcode the mapping from a warning code to the `pm` command\n * that fixes it. This module is the single source of truth for that mapping so\n * `pm health --json` (per-check `remediation_map`) and `pm validate --fix-hints`\n * (per-check `fix_hints`) can both surface executable remediation without any\n * duplicated, drift-prone lookup tables.\n *\n * Semantics of {@link RemediationEntry.command}: the suggested next `pm` command\n * an operator/agent should run to resolve findings with that code. Per-item\n * findings use an `<id>` placeholder (callers that have the concrete id may\n * substitute it); findings whose only fix is a manual file edit point at the\n * most useful diagnostic/repair command and describe the manual step in\n * {@link RemediationEntry.summary}.\n */\n\n/** Maps a stable diagnostic warning code to the command and summary that resolve it. */\nexport interface RemediationEntry {\n  /** Stable warning-code prefix this entry resolves. A warning matches when it equals this code or begins with `<code>:`. Registry codes are mutually exclusive under that colon-boundary rule (no code is a `:`-delimited prefix of another — e.g. `settings:id_prefix_empty` is distinct from a bare `settings`, which is intentionally not registered), so `resolveRemediation` uses first-match with no ordering dependency. */\n  readonly code: string;\n  /** Executable `pm` command (or imperative) that resolves the finding. May contain an `<id>` placeholder. */\n  readonly command: string;\n  /** One-line description of what the command does / which manual step it covers. */\n  readonly summary: string;\n}\n\n/** Registry of every non-extension `pm health` / `pm validate` warning code and its remediation. Extension findings keep their richer, contextual `details.triage.remediation` produced by the extension health triage and are intentionally excluded here (see pm-0hnu: \"all non-extension checks\"). */\nexport const REMEDIATION_REGISTRY: readonly RemediationEntry[] = Object.freeze([\n  // --- pm health: directories ---\n  {\n    code: \"missing_directory\",\n    command: \"pm init\",\n    summary:\n      \"Recreate missing tracker directories (pm init is idempotent and restores the scaffold).\",\n  },\n  // --- pm health: settings (read/parse) ---\n  {\n    code: \"settings_read_fs_error\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json could not be read as a regular file and pm fell back to defaults; repair the reported path or permissions, then re-run.\",\n  },\n  {\n    code: \"settings_read_invalid_json\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run.\",\n  },\n  {\n    code: \"settings_read_invalid_schema\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run.\",\n  },\n  {\n    code: \"settings_read_merge_failed\",\n    command: \"pm config list --json\",\n    summary:\n      \"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files.\",\n  },\n  // --- pm health: settings_values ---\n  {\n    code: \"settings:id_prefix_empty\",\n    command: \"pm config list --json\",\n    summary:\n      'id_prefix is empty; set a non-empty \"id_prefix\" in settings.json so generated item ids are well-formed.',\n  },\n  {\n    code: \"settings:locks_ttl_non_positive\",\n    command: \"pm config list --json\",\n    summary:\n      'locks.ttl_seconds must be positive; set a positive \"locks.ttl_seconds\" in settings.json.',\n  },\n  // --- pm health: telemetry (advisory) ---\n  {\n    code: \"telemetry_state_invalid_json\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_invalid_rows\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_pending\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_high_retries\",\n    command: \"pm telemetry flush\",\n    summary:\n      \"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_failed\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_http_status\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only.\",\n  },\n  {\n    code: \"telemetry_schema_version_behind\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"Client schema is behind server; upgrade pm-cli to emit the latest event shape.\",\n  },\n  {\n    code: \"telemetry_otel_export_failing\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only.\",\n  },\n  // --- pm health: integrity ---\n  {\n    code: \"integrity_item_unreadable\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary:\n      \"An item file could not be read; restore or repair the file at the reported path.\",\n  },\n  {\n    code: \"integrity_item_parse_failed\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary:\n      \"An item file failed to parse; fix the malformed item metadata at the reported path.\",\n  },\n  {\n    code: \"integrity_item_conflict_marker\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary:\n      \"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line.\",\n  },\n  {\n    code: \"integrity_history_unreadable\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"A history stream could not be read; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_invalid_json\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"A history stream contains invalid JSON; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_conflict_marker\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain.\",\n  },\n  // --- pm validate: storage_integrity (post-merge corruption detection) ---\n  {\n    code: \"validate_storage_unreadable_items\",\n    command: \"pm validate --check-storage-integrity --verbose-diagnostics\",\n    summary:\n      \"An on-disk item file cannot be parsed (for example a botched merge resolution with stale TOON count headers); repair or restore the file at the reported path — list commands silently skip it while pm get hard-errors.\",\n  },\n  {\n    code: \"validate_storage_duplicate_item_ids\",\n    command: \"pm validate --check-storage-integrity --verbose-diagnostics\",\n    summary:\n      \"One item id is claimed by multiple item documents — usually two branches minting the same id for different items before merging (GH-600). Keep one document, recreate the other item under a fresh id (pm copy, then delete the colliding file), and consider raising ids.token_length for concurrent multi-agent work.\",\n  },\n  {\n    code: \"validate_storage_history_conflict_markers\",\n    command: \"pm merge driver history <base> <ours> <theirs>\",\n    summary:\n      \"A history stream contains unresolved Git conflict markers; re-merge it with the pm history merge driver (or resolve the markers by hand), then run pm history-repair for the item.\",\n  },\n  {\n    code: \"validate_storage_unparseable_history\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"A history stream's newest line is not valid JSONL; repair or restore the stream before further mutations.\",\n  },\n  {\n    code: \"validate_storage_resurrected_items\",\n    command: \"pm delete <id>\",\n    summary:\n      \"A live item's newest history operation is a delete: a delete/modify merge silently resurrected it. Decide the winner — re-delete the item, or keep it and append a mutation documenting the revival.\",\n  },\n  {\n    code: \"validate_storage_unparseable_config\",\n    command: \"pm merge driver json <base> <ours> <theirs>\",\n    summary:\n      \"settings.json or a schema file cannot be parsed, so pm silently falls back to defaults; re-merge it with the pm JSON merge driver or fix the file by hand, then rerun pm validate.\",\n  },\n  {\n    code: \"validate_merge_fence_drift\",\n    command: \"pm merge install\",\n    summary:\n      \"The committed .gitattributes merge fence no longer matches the active schema's type folders or tracker JSONL stores; rerun pm merge install (and commit .gitattributes) so every tracker artifact keeps its field-aware merge driver.\",\n  },\n  // --- pm health (integrity) + pm validate (format_version): item format version ---\n  {\n    code: \"integrity_item_outdated_format_version\",\n    command: \"pm validate --verbose-diagnostics\",\n    summary:\n      \"An item predates the current storage format version; a pm storage migration rewrites it. Use --verbose-diagnostics to list the affected items.\",\n  },\n  {\n    code: \"integrity_item_ahead_format_version\",\n    command: \"npm install -g @unbrained/pm-cli@latest\",\n    summary:\n      \"An item was written by a newer pm format version than this runtime supports; upgrade pm to read and validate it safely.\",\n  },\n  // --- pm health: history_drift ---\n  // `pm health` rewrites these commands to `pm history-repair --all` in the\n  // per-check remediation_map when more than one stream is drifted.\n  {\n    code: \"history_drift_missing_stream\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  {\n    code: \"history_drift_unreadable_stream\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  {\n    code: \"history_drift_hash_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  {\n    code: \"history_drift_chain_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  // --- pm health: storage (history compaction policy) ---\n  {\n    code: \"history_stream_over_compact_threshold\",\n    command: \"pm history-compact <id>\",\n    summary:\n      \"The history stream exceeds the configured compaction threshold; compact it (pm history-compact --all-streams sweeps every over-threshold stream in one pass).\",\n  },\n  {\n    code: \"history_unknown_author_events\",\n    command: \"pm validate --check-history-drift --fix-hints\",\n    summary:\n      \"Historical mutations lack attributable authorship. Configure PM_AUTHOR, pass global --author, or set author_default so future audit events are attributable.\",\n  },\n  // --- pm health: locks ---\n  {\n    code: \"locks_stale_count\",\n    command: \"pm gc --scope locks\",\n    summary:\n      \"Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them — gc retains active and unparseable locks.\",\n  },\n  {\n    code: \"locks_unreadable\",\n    command: \"pm gc --scope locks --dry-run\",\n    summary:\n      \"Some lock files could not be read; preview the sweep and inspect the unreadable files manually — gc never deletes what it cannot read.\",\n  },\n  // --- pm health: extensions ---\n  // Most extension findings keep their richer, contextual\n  // `details.triage.remediation` and are intentionally absent here. The\n  // partial-coverage code is the exception: it is not a per-extension triage\n  // result but a system-wide adoption gap (unmanaged installs the update-health\n  // scan had to skip), so it has a single deterministic fix and belongs in the\n  // shared registry like any other health finding (pm-bdvm).\n  {\n    code: \"extension_update_health_partial_coverage\",\n    command: \"pm extension --adopt-all --project\",\n    summary:\n      \"Update-health coverage is partial because unmanaged extensions were skipped; adopt the existing installs into managed metadata so the update scan covers them (use --global for global-scope extensions, or pm package --adopt-all when working with packages).\",\n  },\n  // --- pm health: vectorization ---\n  {\n    code: \"vectorization_stale_items_remaining\",\n    command: \"pm health --refresh-vectors\",\n    summary:\n      \"Some items have stale embeddings; refresh vectors so semantic search results stay current.\",\n  },\n  {\n    code: \"vectorization_embedding_identity_changed\",\n    command: \"pm reindex --mode semantic\",\n    summary:\n      \"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors.\",\n  },\n  // --- pm validate: metadata ---\n  // Note: validate_metadata_missing_author has no entry on purpose. `pm update\n  // --author` sets the mutation/audit author (history), not the item's\n  // `metadata.author` item-metadata field, and there is no CLI flag that writes\n  // that field — so emitting a command here would record an audit entry without\n  // clearing the finding. A missing item author must be restored at the source.\n  {\n    code: \"validate_metadata_missing_acceptance_criteria\",\n    command: 'pm update <id> --acceptance-criteria \"<criteria>\"',\n    summary:\n      \"Backfill the missing acceptance criteria on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_estimate\",\n    command: 'pm update <id> --estimate \"<estimate>\"',\n    summary: \"Backfill the missing estimate on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_close_reason\",\n    command: 'pm update <id> --close-reason \"<reason>\"',\n    summary:\n      \"Backfill the missing close reason on the reported closed item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_reviewer\",\n    command: 'pm update <id> --reviewer \"<name>\"',\n    summary: \"Backfill the missing reviewer on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_risk\",\n    command: 'pm update <id> --risk \"<level>\"',\n    summary: \"Backfill the missing risk on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_confidence\",\n    command: 'pm update <id> --confidence \"<level>\"',\n    summary: \"Backfill the missing confidence on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_sprint\",\n    command: 'pm update <id> --sprint \"<sprint>\"',\n    summary: \"Backfill the missing sprint on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_release\",\n    command: 'pm update <id> --release \"<release>\"',\n    summary: \"Backfill the missing release on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_custom_profile_missing_required_fields\",\n    command: 'pm config set metadata-required-fields --criterion \"<field>\"',\n    summary:\n      \"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items.\",\n  },\n  {\n    code: \"validate_metadata_duplicate_issue_codes\",\n    command: 'pm update <id> --title \"<distinct title>\"',\n    summary:\n      \"Two or more items share one logical issue code (GH-235); give each a distinct title so the derived code is unique, or close the redundant item with pm close <id> --duplicate-of <canonical-id> (closed-as-duplicate items are excluded from the check).\",\n  },\n  // --- pm validate: resolution ---\n  {\n    code: \"validate_resolution_missing_fields\",\n    command: 'pm update <id> --resolution \"<how resolved>\"',\n    summary:\n      \"Backfill resolution / expected_result / actual_result on the reported closed item(s).\",\n  },\n  // --- pm validate: lifecycle ---\n  {\n    code: \"validate_lifecycle_active_closure_like_metadata\",\n    command: \"pm update <id> --unset <closure-like-field>\",\n    summary:\n      \"Clear the closure-like field the validator flags on this active item — the detail row names it (resolution / actual-result / blocked-reason) — or close the item if it is actually done.\",\n  },\n  {\n    code: \"validate_lifecycle_active_terminal_parent\",\n    command: \"pm update <id> --parent <active-parent-id>\",\n    summary:\n      \"Reopen the terminal parent or move the active child under a non-terminal parent.\",\n  },\n  {\n    code: \"validate_lifecycle_stale_blockers\",\n    command: \"pm update <id> --unset blocked-by --unset blocked-reason\",\n    summary:\n      \"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles_error\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary:\n      \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary:\n      \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  {\n    code: \"validate_hierarchy_parent_cycle_error\",\n    command: \"pm update <id> --parent <other-id>\",\n    summary:\n      \"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent).\",\n  },\n  {\n    code: \"validate_hierarchy_parent_cycle\",\n    command: \"pm update <id> --parent <other-id>\",\n    summary:\n      \"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent).\",\n  },\n  // --- pm validate: files ---\n  {\n    code: \"validate_files_missing_linked_paths\",\n    command: \"pm <files|docs> <id> --remove <path>\",\n    summary:\n      \"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc).\",\n  },\n  {\n    code: \"validate_files_orphaned_paths\",\n    command: \"pm <files|docs> <id> --add <path>\",\n    summary:\n      \"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace.\",\n  },\n  {\n    code: \"validate_files_tracked_all_strict_forces_pm_internals\",\n    command: \"pm validate --check-files --include-pm-internals\",\n    summary:\n      \"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode.\",\n  },\n  // --- pm validate: history_drift ---\n  {\n    code: \"validate_history_drift_missing_streams\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"Re-anchor the history chains of the items missing a history stream.\",\n  },\n  {\n    code: \"validate_history_drift_unreadable_streams\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"Re-anchor the history chains of the items with an unreadable history stream.\",\n  },\n  {\n    code: \"validate_history_drift_hash_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"Re-anchor the history chains of the items whose content hash drifted.\",\n  },\n  {\n    code: \"validate_history_drift_chain_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary:\n      \"Re-anchor the history chains of the items with a broken history chain.\",\n  },\n  {\n    code: \"validate_history_unknown_author_events\",\n    command: \"pm config project set author_default <stable-agent-id>\",\n    summary:\n      \"Historical mutations lack attributable authorship. Set a stable default or use invocation-wide --author for future events; existing audit history remains append-only.\",\n  },\n  // --- pm validate: command_references ---\n  {\n    code: \"validate_command_references_stale_pm_ids\",\n    command:\n      'pm update <id> --replace-tests --test \"command=<corrected-command>\" [--test ...]',\n    summary:\n      \"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call.\",\n  },\n  {\n    code: \"validate_format_version_outdated_items\",\n    command: \"pm validate --verbose-diagnostics\",\n    summary:\n      \"One or more items predate the current storage format version; a pm storage migration rewrites them. Use --verbose-diagnostics to list the affected items.\",\n  },\n  {\n    code: \"validate_format_version_ahead_items\",\n    command: \"npm install -g @unbrained/pm-cli@latest\",\n    summary:\n      \"One or more items were written by a newer pm format version than this runtime supports; upgrade pm to read and validate them safely.\",\n  },\n]);\n\n/**\n * Resolve the remediation entry for a warning token, or `undefined` when no\n * entry is registered. A warning matches an entry when it equals the entry code\n * or begins with `<code>:` (the colon boundary keeps sibling codes such as\n * `validate_lifecycle_dependency_cycles` and\n * `validate_lifecycle_dependency_cycles_error` disjoint).\n *\n * First match is intentional and correct: registry codes are mutually exclusive\n * under the colon-boundary rule, so at most one entry can ever match a warning\n * and order is irrelevant. That invariant is enforced by a test (see\n * remediation-registry.spec.ts \"keeps every registry code mutually exclusive\"),\n * which is why this stays a simple linear scan rather than a longest-prefix\n * search — a longest-prefix tie-break is unreachable with disjoint codes.\n *\n * Accepts unknown input defensively (this is an exported helper SDK consumers\n * may call from untyped JS): a non-string `warning` resolves to `undefined`.\n */\nexport function resolveRemediation(\n  warning: string,\n): RemediationEntry | undefined {\n  if (typeof warning !== \"string\") {\n    return undefined;\n  }\n  const normalized = warning.trim();\n  for (const entry of REMEDIATION_REGISTRY) {\n    if (normalized === entry.code || normalized.startsWith(`${entry.code}:`)) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n\n/** Build a compact `remediation_map` (code -> command) for a set of warning tokens. First match wins per code; unknown codes are skipped. Used by `pm health --json` per-check details and as the source of deduped executable commands for `pm validate --fix-hints`. */\nexport function buildRemediationMap(\n  warnings: Iterable<string>,\n): Record<string, string> {\n  const map: Record<string, string> = {};\n  for (const warning of warnings) {\n    const entry = resolveRemediation(warning);\n    if (\n      entry !== undefined &&\n      !Object.prototype.hasOwnProperty.call(map, entry.code)\n    ) {\n      map[entry.code] = entry.command;\n    }\n  }\n  return map;\n}\n\n/** Build a deduped, ordered list of executable remediation commands for a set of warning tokens (one command per distinct matched code). Used by `pm validate --fix-hints` for checks that do not already emit per-row remediation commands. */\nexport function buildRemediationCommands(warnings: Iterable<string>): string[] {\n  return Object.values(buildRemediationMap(warnings));\n}\n"],"names":[],"mappings":"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","debugId":"836f71d5-acd0-5c77-ae31-9ae98914727c"}

package/dist/core/search/background-refresh.d.ts

@@ -1,5 +1,7 @@
 /** Shared lock id for any process that rewrites the local vector store. Reindex and the background mutation-refresh worker both acquire this so they never write concurrently and corrupt the store. Exported so `pm reindex` reuses the same id rather than duplicating the literal. */
 export declare const REINDEX_LOCK_ID = "reindex";
+/** Delay before a settings-failed worker dispatches one replacement child, preventing a tight retry loop while preserving eventual queue recovery. */
+export declare const SEARCH_REFRESH_RETRY_DELAY_MS = 30000;
 /** Mutation search refresh runs inline (blocking) under test runners, inside the background worker child itself, or when explicitly requested. Otherwise the semantic refresh is dispatched to a detached child so mutations return without waiting on embeddings. Mirrors the telemetry-flush inline gate so the full test suite stays deterministic. */
 export declare function shouldRunSearchRefreshInForeground(): boolean;
 /** Merge mutated item ids into the persistent pending-refresh queue. */
@@ -23,5 +25,5 @@ type SemanticRefreshFn = (pmRoot: string, itemIds: string[]) => Promise<{
     warnings: string[];
 }>;
 /** Drain the pending queue and refresh semantic vectors under the reindex lock so the local vector store is never rewritten concurrently. If the lock is held by another worker we exit immediately — that holder drains our enqueued ids. After releasing we re-check the queue once and re-dispatch if a sibling enqueued ids during our final window, guaranteeing eventual processing. */
-export declare function runSemanticRefreshWorker(pmRoot: string, refresh: SemanticRefreshFn): Promise<SemanticRefreshWorkerResult>;
+export declare function runSemanticRefreshWorker(pmRoot: string, refresh: SemanticRefreshFn, scheduleRetry?: (root: string) => void): Promise<SemanticRefreshWorkerResult>;
 export {};