@unbrained/pm-cli 2026.7.13 → 2026.7.14

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../sdk/define.ts", "../../../../../../../sdk/index.ts"],
-  "sourcesContent": ["/**\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\";\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  PmActionSchemaContract,\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 \"./pagination.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  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  health,\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 ListOptions,\n  type ListResult,\n  type ListSortField,\n  type ListSortOrder,\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 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 {\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": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEM,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;;;;;;;;;;AC0VO,IAAM,yBAAyB;AAK/B,IAAM,yBAAyB;AAE/B,IAAM,4BAA4B;AAElC,IAAM,wBAAwB;AAE9B,IAAM,6BAA6B;",
+  "sourcesContent": ["/**\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\";\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  PmActionSchemaContract,\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 {\n  collectDanglingDependencyReferences,\n  runDeps,\n  type DanglingDependencyReference,\n  type DanglingDependencyReferenceSummary,\n  type DependencyReferenceHolder,\n  type DepsCollapseMode,\n  type DepsFormat,\n  type DepsGraphEdge,\n  type DepsGraphNode,\n  type DepsGraphResult,\n  type DepsTreeNode,\n} from \"./dependencies.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 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  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  health,\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 ListOptions,\n  type ListResult,\n  type ListSortField,\n  type ListSortOrder,\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 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 {\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": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEM,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;;;;;;;;;;ACuYO,IAAM,yBAAyB;AAK/B,IAAM,yBAAyB;AAE/B,IAAM,4BAA4B;AAElC,IAAM,wBAAwB;AAE9B,IAAM,6BAA6B;",
   "names": ["profile"]
 }

package/dist/core/extensions/command-hook-context.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module core/extensions/command-hook-context
+ *
+ * Builds invocation context shared by extension hooks and derived command
+ * feedback, including core-only runs where no extensions are installed.
+ */
+import type { GlobalOptions } from "../shared/command-types.js";
+import type { ExtensionHookRegistry } from "./loader.js";
+/** Runtime state consumed after a command finishes. */
+export interface ActiveExtensionHookContext<TMigrationBlocker> {
+    /** Active extension hooks, empty for a core-only invocation. */
+    hooks: ExtensionHookRegistry;
+    /** Canonical dotted command path. */
+    commandName: string;
+    /** Positional command arguments after parser overrides. */
+    commandArgs: string[];
+    /** Command-scoped options after parser overrides. */
+    commandOptions: Record<string, unknown>;
+    /** Global options after parser overrides. */
+    globalOptions: GlobalOptions;
+    /** Tracker root for hooks and derived feedback. */
+    pmRoot: string;
+    /** Whether profile diagnostics should be rendered. */
+    profileEnabled: boolean;
+    /** Mandatory extension migrations that remain unresolved. */
+    migrationBlockers: TMigrationBlocker[];
+}
+/** Creates post-command runtime state for an invocation without extensions. */
+export declare function createCoreCommandHookContext(options: {
+    /** Canonical dotted command path. */
+    commandName: string;
+    /** Positional command arguments. */
+    commandArgs: string[];
+    /** Command-scoped options. */
+    commandOptions: Record<string, unknown>;
+    /** Parsed global options. */
+    globalOptions: GlobalOptions;
+    /** Resolved tracker root. */
+    pmRoot: string;
+}): ActiveExtensionHookContext<never>;

package/dist/core/extensions/command-hook-context.js

@@ -0,0 +1,14 @@
+
+!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]="3efead0c-2ad9-5fa1-af60-57b781a534fc")}catch(e){}}();
+import { createEmptyExtensionHookRegistry } from "./extension-registries.js";
+/** Creates post-command runtime state for an invocation without extensions. */
+export function createCoreCommandHookContext(options) {
+    return {
+        ...options,
+        hooks: createEmptyExtensionHookRegistry(),
+        profileEnabled: Boolean(options.globalOptions.profile),
+        migrationBlockers: [],
+    };
+}
+//# sourceMappingURL=command-hook-context.js.map
+//# debugId=3efead0c-2ad9-5fa1-af60-57b781a534fc

package/dist/core/extensions/command-hook-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-hook-context.js","sources":["core/extensions/command-hook-context.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/command-hook-context\n *\n * Builds invocation context shared by extension hooks and derived command\n * feedback, including core-only runs where no extensions are installed.\n */\nimport type { GlobalOptions } from \"../shared/command-types.js\";\nimport { createEmptyExtensionHookRegistry } from \"./extension-registries.js\";\nimport type { ExtensionHookRegistry } from \"./loader.js\";\n\n/** Runtime state consumed after a command finishes. */\nexport interface ActiveExtensionHookContext<TMigrationBlocker> {\n  /** Active extension hooks, empty for a core-only invocation. */\n  hooks: ExtensionHookRegistry;\n  /** Canonical dotted command path. */\n  commandName: string;\n  /** Positional command arguments after parser overrides. */\n  commandArgs: string[];\n  /** Command-scoped options after parser overrides. */\n  commandOptions: Record<string, unknown>;\n  /** Global options after parser overrides. */\n  globalOptions: GlobalOptions;\n  /** Tracker root for hooks and derived feedback. */\n  pmRoot: string;\n  /** Whether profile diagnostics should be rendered. */\n  profileEnabled: boolean;\n  /** Mandatory extension migrations that remain unresolved. */\n  migrationBlockers: TMigrationBlocker[];\n}\n\n/** Creates post-command runtime state for an invocation without extensions. */\nexport function createCoreCommandHookContext(options: {\n  /** Canonical dotted command path. */\n  commandName: string;\n  /** Positional command arguments. */\n  commandArgs: string[];\n  /** Command-scoped options. */\n  commandOptions: Record<string, unknown>;\n  /** Parsed global options. */\n  globalOptions: GlobalOptions;\n  /** Resolved tracker root. */\n  pmRoot: string;\n}): ActiveExtensionHookContext<never> {\n  return {\n    ...options,\n    hooks: createEmptyExtensionHookRegistry(),\n    profileEnabled: Boolean(options.globalOptions.profile),\n    migrationBlockers: [],\n  };\n}\n"],"names":[],"mappings":";;AAOA,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAuB7E,+EAA+E;AAC/E,MAAM,UAAU,4BAA4B,CAAC,OAW5C;IACC,OAAO;QACL,GAAG,OAAO;QACV,KAAK,EAAE,gCAAgC,EAAE;QACzC,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC;QACtD,iBAAiB,EAAE,EAAE;KACtB,CAAC;AACJ,CAAC","debugId":"3efead0c-2ad9-5fa1-af60-57b781a534fc"}

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

@@ -68,5 +68,6 @@ export declare function runActiveServiceOverride(service: ExtensionServiceName,
 /** Implements run active service override sync for the public runtime surface of this module. */
 export declare function runActiveServiceOverrideSync(service: ExtensionServiceName, payload: unknown): ServiceOverrideResult;
 export * from "./loader.js";
+export * from "./command-hook-context.js";
 export { createSerialQueue } from "../shared/serial-queue.js";
 export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, type CollectUsedExtensionCapabilitiesOptions, type ExtensionCapabilityUsageReconciliation, } from "./capability-usage.js";

package/dist/core/extensions/index.js

@@ -4,7 +4,7 @@
  * Implements extension runtime contracts and governance for Index.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6664eb48-fc42-5e7f-83d8-7ab3e9b19f23")}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]="27bb9504-233c-5768-8932-d1cae84313be")}catch(e){}}();
 import { runCommandHandler, runCommandOverride, runOnIndexHooks, runParserOverride, runPreflightOverride, runOnReadHooks, runRendererOverride, runServiceOverride, runServiceOverrideSync, runOnWriteHooks, } from "./loader.js";
 let activeExtensionHooks = null;
 let activeExtensionCommands = null;
@@ -95,7 +95,7 @@ export function getActiveCommandResult() {
 }
 /** Implements record after command affected item for the public runtime surface of this module. */
 export function recordAfterCommandAffectedItem(item) {
-    if (!item || (activeExtensionHooks?.afterCommand?.length ?? 0) === 0) {
+    if (!item) {
         return;
     }
     activeAfterCommandAffectedItems.push(item);
@@ -310,7 +310,8 @@ export function runActiveServiceOverrideSync(service, payload) {
     return runServiceOverrideSync(activeExtensionServices, buildServiceContext(service, payload));
 }
 export * from "./loader.js";
+export * from "./command-hook-context.js";
 export { createSerialQueue } from "../shared/serial-queue.js";
 export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, } from "./capability-usage.js";
 //# sourceMappingURL=index.js.map
-//# debugId=6664eb48-fc42-5e7f-83d8-7ab3e9b19f23
+//# debugId=27bb9504-233c-5768-8932-d1cae84313be

package/dist/core/extensions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["core/extensions/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/index\n *\n * Implements extension runtime contracts and governance for Index.\n */\nimport {\n  runCommandHandler,\n  runCommandOverride,\n  runOnIndexHooks,\n  runParserOverride,\n  runPreflightOverride,\n  runOnReadHooks,\n  runRendererOverride,\n  runServiceOverride,\n  runServiceOverrideSync,\n  runOnWriteHooks,\n  type CommandHandlerContext,\n  type CommandHandlerResult,\n  type CommandOverrideContext,\n  type CommandOverrideResult,\n  type ExtensionCommandRegistry,\n  type ExtensionHookRegistry,\n  type ExtensionParserRegistry,\n  type ExtensionPreflightRegistry,\n  type ExtensionRegistrationRegistry,\n  type ExtensionRendererRegistry,\n  type ExtensionServiceName,\n  type ExtensionServiceRegistry,\n  type AfterCommandAffectedItem,\n  type OnIndexHookContext,\n  type OnReadHookContext,\n  type OnWriteHookContext,\n  type OutputRendererFormat,\n  type ParserOverrideContext,\n  type ParserOverrideResult,\n  type PreflightOverrideContext,\n  type PreflightOverrideResult,\n  type RendererOverrideResult,\n  type ServiceOverrideResult,\n} from \"./loader.js\";\nimport type { ItemMetadata } from \"../../types/index.js\";\n\nlet activeExtensionHooks: ExtensionHookRegistry | null = null;\nlet activeExtensionCommands: ExtensionCommandRegistry | null = null;\nlet activeExtensionParsers: ExtensionParserRegistry | null = null;\nlet activeExtensionPreflight: ExtensionPreflightRegistry | null = null;\nlet activeExtensionServices: ExtensionServiceRegistry | null = null;\nlet activeExtensionRenderers: ExtensionRendererRegistry | null = null;\nlet activeExtensionRegistrations: ExtensionRegistrationRegistry | null = null;\nlet activeCommandContext: Omit<CommandOverrideContext, \"result\"> | null = null;\nlet activeCommandResult: unknown = undefined;\nlet activeAfterCommandAffectedItems: AfterCommandAffectedItem[] = [];\nconst AFTER_COMMAND_SNAPSHOT_OMITTED_FIELDS = new Set([\n  \"body\",\n  \"comments\",\n  \"dependencies\",\n  \"docs\",\n  \"events\",\n  \"files\",\n  \"learnings\",\n  \"notes\",\n  \"reminders\",\n  \"test_runs\",\n  \"tests\",\n]);\n\n/** Implements set active extension hooks for the public runtime surface of this module. */\nexport function setActiveExtensionHooks(\n  hooks: ExtensionHookRegistry | null,\n): void {\n  activeExtensionHooks = hooks;\n}\n\n/** Implements set active extension commands for the public runtime surface of this module. */\nexport function setActiveExtensionCommands(\n  commands: ExtensionCommandRegistry | null,\n): void {\n  activeExtensionCommands = commands;\n}\n\n/** Implements set active extension parsers for the public runtime surface of this module. */\nexport function setActiveExtensionParsers(\n  parsers: ExtensionParserRegistry | null,\n): void {\n  activeExtensionParsers = parsers;\n}\n\n/** Implements set active extension preflight for the public runtime surface of this module. */\nexport function setActiveExtensionPreflight(\n  preflight: ExtensionPreflightRegistry | null,\n): void {\n  activeExtensionPreflight = preflight;\n}\n\n/** Implements set active extension services for the public runtime surface of this module. */\nexport function setActiveExtensionServices(\n  services: ExtensionServiceRegistry | null,\n): void {\n  activeExtensionServices = services;\n}\n\n/** Implements set active extension renderers for the public runtime surface of this module. */\nexport function setActiveExtensionRenderers(\n  renderers: ExtensionRendererRegistry | null,\n): void {\n  activeExtensionRenderers = renderers;\n}\n\n/** Implements set active extension registrations for the public runtime surface of this module. */\nexport function setActiveExtensionRegistrations(\n  registrations: ExtensionRegistrationRegistry | null,\n): void {\n  activeExtensionRegistrations = registrations;\n}\n\n/** Implements get active extension registrations for the public runtime surface of this module. */\nexport function getActiveExtensionRegistrations(): ExtensionRegistrationRegistry | null {\n  return activeExtensionRegistrations;\n}\n\n/**\n * Clear every module-level active-extension registry in one step.\n *\n * The actives describe the CURRENT invocation only. One-shot `pm` processes\n * reset them for free by exiting; long-lived embeddings (in-process test\n * runners, future SDK hosts) must call this at invocation entry, otherwise an\n * extension activated by a previous invocation leaks into workspaces where it\n * is not installed (e.g. a stale command registration rejecting core flags).\n */\nexport function resetActiveExtensionRuntimeState(): void {\n  activeExtensionHooks = null;\n  activeExtensionCommands = null;\n  activeExtensionParsers = null;\n  activeExtensionPreflight = null;\n  activeExtensionServices = null;\n  activeExtensionRenderers = null;\n  activeExtensionRegistrations = null;\n  activeCommandContext = null;\n  activeCommandResult = null;\n}\n\n/** Implements set active command context for the public runtime surface of this module. */\nexport function setActiveCommandContext(\n  context: Omit<CommandOverrideContext, \"result\"> | null,\n): void {\n  activeCommandContext = context;\n}\n\n/** Implements set active command result for the public runtime surface of this module. */\nexport function setActiveCommandResult(result: unknown): void {\n  activeCommandResult = result;\n}\n\n/** Implements get active command result for the public runtime surface of this module. */\nexport function getActiveCommandResult(): unknown {\n  return activeCommandResult;\n}\n\n/** Implements record after command affected item for the public runtime surface of this module. */\nexport function recordAfterCommandAffectedItem(\n  item: AfterCommandAffectedItem,\n): void {\n  if (!item || (activeExtensionHooks?.afterCommand?.length ?? 0) === 0) {\n    return;\n  }\n  activeAfterCommandAffectedItems.push(item);\n}\n\n/** Implements project after command item snapshot for the public runtime surface of this module. */\nexport function projectAfterCommandItemSnapshot(\n  metadata: ItemMetadata,\n  changedFields: readonly string[],\n): Partial<ItemMetadata> {\n  if (!metadata || !metadata.id) {\n    return {};\n  }\n  const snapshot: Record<string, unknown> = {\n    id: metadata.id,\n    type: metadata.type,\n    status: metadata.status,\n  };\n  if (!Array.isArray(changedFields)) {\n    return snapshot as Partial<ItemMetadata>;\n  }\n  const source = metadata as unknown as Record<string, unknown>;\n  for (const field of changedFields) {\n    if (typeof field !== \"string\") {\n      continue;\n    }\n    const actualField = field.startsWith(\"unset:\")\n      ? field.slice(\"unset:\".length)\n      : field;\n    if (\n      actualField === \"id\" ||\n      actualField === \"type\" ||\n      actualField === \"status\" ||\n      AFTER_COMMAND_SNAPSHOT_OMITTED_FIELDS.has(actualField)\n    ) {\n      continue;\n    }\n    if (\n      Object.hasOwn(source, actualField) &&\n      source[actualField] !== undefined\n    ) {\n      snapshot[actualField] = source[actualField];\n    }\n  }\n  return snapshot as Partial<ItemMetadata>;\n}\n\n/** Implements consume after command affected items for the public runtime surface of this module. */\nexport function consumeAfterCommandAffectedItems():\n  | AfterCommandAffectedItem[]\n  | undefined {\n  if (activeAfterCommandAffectedItems.length === 0) {\n    return undefined;\n  }\n  const affected = activeAfterCommandAffectedItems;\n  activeAfterCommandAffectedItems = [];\n  return affected;\n}\n\n/** Implements clear active extension hooks for the public runtime surface of this module. */\nexport function clearActiveExtensionHooks(): void {\n  activeExtensionHooks = null;\n  activeExtensionCommands = null;\n  activeExtensionParsers = null;\n  activeExtensionPreflight = null;\n  activeExtensionServices = null;\n  activeExtensionRenderers = null;\n  activeExtensionRegistrations = null;\n  activeCommandContext = null;\n  activeCommandResult = undefined;\n  activeAfterCommandAffectedItems = [];\n}\n\n/** Implements run active on write hooks for the public runtime surface of this module. */\nexport async function runActiveOnWriteHooks(\n  context: OnWriteHookContext,\n): Promise<string[]> {\n  if (!activeExtensionHooks) {\n    return [];\n  }\n  return runOnWriteHooks(activeExtensionHooks, context);\n}\n\n/** Implements run active on read hooks for the public runtime surface of this module. */\nexport async function runActiveOnReadHooks(\n  context: OnReadHookContext,\n): Promise<string[]> {\n  if (!activeExtensionHooks) {\n    return [];\n  }\n  return runOnReadHooks(activeExtensionHooks, context);\n}\n\n/** Synchronous fast-path predicate: true only when at least one onRead hook is registered. Bulk readers (e.g. the metadata cache scanning hundreds of files) use this to skip per-file `await runActiveOnReadHooks(...)` calls entirely when no extension observes reads, avoiding hundreds of needless microtasks. */\nexport function hasActiveOnReadHooks(): boolean {\n  return (activeExtensionHooks?.onRead?.length ?? 0) > 0;\n}\n\n/** Implements run active on index hooks for the public runtime surface of this module. */\nexport async function runActiveOnIndexHooks(\n  context: OnIndexHookContext,\n): Promise<string[]> {\n  if (!activeExtensionHooks) {\n    return [];\n  }\n  return runOnIndexHooks(activeExtensionHooks, context);\n}\n\n/** Implements run active command override for the public runtime surface of this module. */\nexport function runActiveCommandOverride(\n  result: unknown,\n): CommandOverrideResult {\n  if (!activeExtensionCommands || !activeCommandContext) {\n    return {\n      overridden: false,\n      result,\n      warnings: [],\n    };\n  }\n  return runCommandOverride(activeExtensionCommands, {\n    command: activeCommandContext.command,\n    args: [...activeCommandContext.args],\n    options: activeCommandContext.options\n      ? { ...activeCommandContext.options }\n      : {},\n    global: activeCommandContext.global\n      ? { ...activeCommandContext.global }\n      : undefined,\n    pm_root: activeCommandContext.pm_root,\n    result,\n  });\n}\n\n/** Implements run active command handler for the public runtime surface of this module. */\nexport async function runActiveCommandHandler(\n  context: CommandHandlerContext,\n): Promise<CommandHandlerResult> {\n  if (!activeExtensionCommands) {\n    return {\n      handled: false,\n      result: null,\n      warnings: [],\n    };\n  }\n  return runCommandHandler(activeExtensionCommands, context);\n}\n\n/** Implements run active parser override for the public runtime surface of this module. */\nexport async function runActiveParserOverride(\n  context: ParserOverrideContext,\n): Promise<ParserOverrideResult> {\n  if (!activeExtensionParsers) {\n    return {\n      overridden: false,\n      context: {\n        command: context.command,\n        args: [...context.args],\n        options: { ...context.options },\n        global: { ...context.global },\n        pm_root: context.pm_root,\n      },\n      warnings: [],\n    };\n  }\n  return runParserOverride(activeExtensionParsers, context);\n}\n\n/** Implements run active preflight override for the public runtime surface of this module. */\nexport async function runActivePreflightOverride(\n  context: PreflightOverrideContext,\n): Promise<PreflightOverrideResult> {\n  if (!activeExtensionPreflight) {\n    return {\n      overridden: false,\n      context: {\n        command: context.command,\n        args: [...context.args],\n        options: { ...context.options },\n        global: { ...context.global },\n        pm_root: context.pm_root,\n      },\n      decision: { ...context.decision },\n      warnings: [],\n    };\n  }\n  return runPreflightOverride(activeExtensionPreflight, context);\n}\n\n/** Implements run active renderer override for the public runtime surface of this module. */\nexport function runActiveRendererOverride(\n  format: OutputRendererFormat,\n  result: unknown,\n): RendererOverrideResult {\n  if (!activeExtensionRenderers) {\n    return {\n      overridden: false,\n      rendered: null,\n      warnings: [],\n    };\n  }\n  return runRendererOverride(activeExtensionRenderers, {\n    format,\n    command: activeCommandContext?.command,\n    args: activeCommandContext ? [...activeCommandContext.args] : [],\n    options: activeCommandContext?.options\n      ? { ...activeCommandContext.options }\n      : {},\n    global: activeCommandContext?.global\n      ? { ...activeCommandContext.global }\n      : undefined,\n    pm_root: activeCommandContext?.pm_root,\n    result,\n  });\n}\n\nfunction buildServiceContext(service: ExtensionServiceName, payload: unknown) {\n  return {\n    service,\n    command: activeCommandContext?.command,\n    args: activeCommandContext ? [...activeCommandContext.args] : [],\n    options: activeCommandContext?.options\n      ? { ...activeCommandContext.options }\n      : {},\n    global: activeCommandContext?.global\n      ? { ...activeCommandContext.global }\n      : undefined,\n    pm_root: activeCommandContext?.pm_root,\n    payload,\n  };\n}\n\n/** Implements run active service override for the public runtime surface of this module. */\nexport async function runActiveServiceOverride(\n  service: ExtensionServiceName,\n  payload: unknown,\n): Promise<ServiceOverrideResult> {\n  if (!activeExtensionServices) {\n    return {\n      handled: false,\n      result: payload,\n      warnings: [],\n    };\n  }\n  return runServiceOverride(\n    activeExtensionServices,\n    buildServiceContext(service, payload),\n  );\n}\n\n/** Implements run active service override sync for the public runtime surface of this module. */\nexport function runActiveServiceOverrideSync(\n  service: ExtensionServiceName,\n  payload: unknown,\n): ServiceOverrideResult {\n  if (!activeExtensionServices) {\n    return {\n      handled: false,\n      result: payload,\n      warnings: [],\n    };\n  }\n  return runServiceOverrideSync(\n    activeExtensionServices,\n    buildServiceContext(service, payload),\n  );\n}\n\nexport * from \"./loader.js\";\nexport { createSerialQueue } from \"../shared/serial-queue.js\";\nexport {\n  EXTENSION_CAPABILITY_REGISTRATION_SURFACES,\n  collectUsedExtensionCapabilities,\n  reconcileExtensionCapabilityUsage,\n  type CollectUsedExtensionCapabilitiesOptions,\n  type ExtensionCapabilityUsageReconciliation,\n} from \"./capability-usage.js\";\n"],"names":[],"mappings":"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","debugId":"6664eb48-fc42-5e7f-83d8-7ab3e9b19f23"}
+{"version":3,"file":"index.js","sources":["core/extensions/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/index\n *\n * Implements extension runtime contracts and governance for Index.\n */\nimport {\n  runCommandHandler,\n  runCommandOverride,\n  runOnIndexHooks,\n  runParserOverride,\n  runPreflightOverride,\n  runOnReadHooks,\n  runRendererOverride,\n  runServiceOverride,\n  runServiceOverrideSync,\n  runOnWriteHooks,\n  type CommandHandlerContext,\n  type CommandHandlerResult,\n  type CommandOverrideContext,\n  type CommandOverrideResult,\n  type ExtensionCommandRegistry,\n  type ExtensionHookRegistry,\n  type ExtensionParserRegistry,\n  type ExtensionPreflightRegistry,\n  type ExtensionRegistrationRegistry,\n  type ExtensionRendererRegistry,\n  type ExtensionServiceName,\n  type ExtensionServiceRegistry,\n  type AfterCommandAffectedItem,\n  type OnIndexHookContext,\n  type OnReadHookContext,\n  type OnWriteHookContext,\n  type OutputRendererFormat,\n  type ParserOverrideContext,\n  type ParserOverrideResult,\n  type PreflightOverrideContext,\n  type PreflightOverrideResult,\n  type RendererOverrideResult,\n  type ServiceOverrideResult,\n} from \"./loader.js\";\nimport type { ItemMetadata } from \"../../types/index.js\";\n\nlet activeExtensionHooks: ExtensionHookRegistry | null = null;\nlet activeExtensionCommands: ExtensionCommandRegistry | null = null;\nlet activeExtensionParsers: ExtensionParserRegistry | null = null;\nlet activeExtensionPreflight: ExtensionPreflightRegistry | null = null;\nlet activeExtensionServices: ExtensionServiceRegistry | null = null;\nlet activeExtensionRenderers: ExtensionRendererRegistry | null = null;\nlet activeExtensionRegistrations: ExtensionRegistrationRegistry | null = null;\nlet activeCommandContext: Omit<CommandOverrideContext, \"result\"> | null = null;\nlet activeCommandResult: unknown = undefined;\nlet activeAfterCommandAffectedItems: AfterCommandAffectedItem[] = [];\nconst AFTER_COMMAND_SNAPSHOT_OMITTED_FIELDS = new Set([\n  \"body\",\n  \"comments\",\n  \"dependencies\",\n  \"docs\",\n  \"events\",\n  \"files\",\n  \"learnings\",\n  \"notes\",\n  \"reminders\",\n  \"test_runs\",\n  \"tests\",\n]);\n\n/** Implements set active extension hooks for the public runtime surface of this module. */\nexport function setActiveExtensionHooks(\n  hooks: ExtensionHookRegistry | null,\n): void {\n  activeExtensionHooks = hooks;\n}\n\n/** Implements set active extension commands for the public runtime surface of this module. */\nexport function setActiveExtensionCommands(\n  commands: ExtensionCommandRegistry | null,\n): void {\n  activeExtensionCommands = commands;\n}\n\n/** Implements set active extension parsers for the public runtime surface of this module. */\nexport function setActiveExtensionParsers(\n  parsers: ExtensionParserRegistry | null,\n): void {\n  activeExtensionParsers = parsers;\n}\n\n/** Implements set active extension preflight for the public runtime surface of this module. */\nexport function setActiveExtensionPreflight(\n  preflight: ExtensionPreflightRegistry | null,\n): void {\n  activeExtensionPreflight = preflight;\n}\n\n/** Implements set active extension services for the public runtime surface of this module. */\nexport function setActiveExtensionServices(\n  services: ExtensionServiceRegistry | null,\n): void {\n  activeExtensionServices = services;\n}\n\n/** Implements set active extension renderers for the public runtime surface of this module. */\nexport function setActiveExtensionRenderers(\n  renderers: ExtensionRendererRegistry | null,\n): void {\n  activeExtensionRenderers = renderers;\n}\n\n/** Implements set active extension registrations for the public runtime surface of this module. */\nexport function setActiveExtensionRegistrations(\n  registrations: ExtensionRegistrationRegistry | null,\n): void {\n  activeExtensionRegistrations = registrations;\n}\n\n/** Implements get active extension registrations for the public runtime surface of this module. */\nexport function getActiveExtensionRegistrations(): ExtensionRegistrationRegistry | null {\n  return activeExtensionRegistrations;\n}\n\n/**\n * Clear every module-level active-extension registry in one step.\n *\n * The actives describe the CURRENT invocation only. One-shot `pm` processes\n * reset them for free by exiting; long-lived embeddings (in-process test\n * runners, future SDK hosts) must call this at invocation entry, otherwise an\n * extension activated by a previous invocation leaks into workspaces where it\n * is not installed (e.g. a stale command registration rejecting core flags).\n */\nexport function resetActiveExtensionRuntimeState(): void {\n  activeExtensionHooks = null;\n  activeExtensionCommands = null;\n  activeExtensionParsers = null;\n  activeExtensionPreflight = null;\n  activeExtensionServices = null;\n  activeExtensionRenderers = null;\n  activeExtensionRegistrations = null;\n  activeCommandContext = null;\n  activeCommandResult = null;\n}\n\n/** Implements set active command context for the public runtime surface of this module. */\nexport function setActiveCommandContext(\n  context: Omit<CommandOverrideContext, \"result\"> | null,\n): void {\n  activeCommandContext = context;\n}\n\n/** Implements set active command result for the public runtime surface of this module. */\nexport function setActiveCommandResult(result: unknown): void {\n  activeCommandResult = result;\n}\n\n/** Implements get active command result for the public runtime surface of this module. */\nexport function getActiveCommandResult(): unknown {\n  return activeCommandResult;\n}\n\n/** Implements record after command affected item for the public runtime surface of this module. */\nexport function recordAfterCommandAffectedItem(\n  item: AfterCommandAffectedItem,\n): void {\n  if (!item) {\n    return;\n  }\n  activeAfterCommandAffectedItems.push(item);\n}\n\n/** Implements project after command item snapshot for the public runtime surface of this module. */\nexport function projectAfterCommandItemSnapshot(\n  metadata: ItemMetadata,\n  changedFields: readonly string[],\n): Partial<ItemMetadata> {\n  if (!metadata || !metadata.id) {\n    return {};\n  }\n  const snapshot: Record<string, unknown> = {\n    id: metadata.id,\n    type: metadata.type,\n    status: metadata.status,\n  };\n  if (!Array.isArray(changedFields)) {\n    return snapshot as Partial<ItemMetadata>;\n  }\n  const source = metadata as unknown as Record<string, unknown>;\n  for (const field of changedFields) {\n    if (typeof field !== \"string\") {\n      continue;\n    }\n    const actualField = field.startsWith(\"unset:\")\n      ? field.slice(\"unset:\".length)\n      : field;\n    if (\n      actualField === \"id\" ||\n      actualField === \"type\" ||\n      actualField === \"status\" ||\n      AFTER_COMMAND_SNAPSHOT_OMITTED_FIELDS.has(actualField)\n    ) {\n      continue;\n    }\n    if (\n      Object.hasOwn(source, actualField) &&\n      source[actualField] !== undefined\n    ) {\n      snapshot[actualField] = source[actualField];\n    }\n  }\n  return snapshot as Partial<ItemMetadata>;\n}\n\n/** Implements consume after command affected items for the public runtime surface of this module. */\nexport function consumeAfterCommandAffectedItems():\n  | AfterCommandAffectedItem[]\n  | undefined {\n  if (activeAfterCommandAffectedItems.length === 0) {\n    return undefined;\n  }\n  const affected = activeAfterCommandAffectedItems;\n  activeAfterCommandAffectedItems = [];\n  return affected;\n}\n\n/** Implements clear active extension hooks for the public runtime surface of this module. */\nexport function clearActiveExtensionHooks(): void {\n  activeExtensionHooks = null;\n  activeExtensionCommands = null;\n  activeExtensionParsers = null;\n  activeExtensionPreflight = null;\n  activeExtensionServices = null;\n  activeExtensionRenderers = null;\n  activeExtensionRegistrations = null;\n  activeCommandContext = null;\n  activeCommandResult = undefined;\n  activeAfterCommandAffectedItems = [];\n}\n\n/** Implements run active on write hooks for the public runtime surface of this module. */\nexport async function runActiveOnWriteHooks(\n  context: OnWriteHookContext,\n): Promise<string[]> {\n  if (!activeExtensionHooks) {\n    return [];\n  }\n  return runOnWriteHooks(activeExtensionHooks, context);\n}\n\n/** Implements run active on read hooks for the public runtime surface of this module. */\nexport async function runActiveOnReadHooks(\n  context: OnReadHookContext,\n): Promise<string[]> {\n  if (!activeExtensionHooks) {\n    return [];\n  }\n  return runOnReadHooks(activeExtensionHooks, context);\n}\n\n/** Synchronous fast-path predicate: true only when at least one onRead hook is registered. Bulk readers (e.g. the metadata cache scanning hundreds of files) use this to skip per-file `await runActiveOnReadHooks(...)` calls entirely when no extension observes reads, avoiding hundreds of needless microtasks. */\nexport function hasActiveOnReadHooks(): boolean {\n  return (activeExtensionHooks?.onRead?.length ?? 0) > 0;\n}\n\n/** Implements run active on index hooks for the public runtime surface of this module. */\nexport async function runActiveOnIndexHooks(\n  context: OnIndexHookContext,\n): Promise<string[]> {\n  if (!activeExtensionHooks) {\n    return [];\n  }\n  return runOnIndexHooks(activeExtensionHooks, context);\n}\n\n/** Implements run active command override for the public runtime surface of this module. */\nexport function runActiveCommandOverride(\n  result: unknown,\n): CommandOverrideResult {\n  if (!activeExtensionCommands || !activeCommandContext) {\n    return {\n      overridden: false,\n      result,\n      warnings: [],\n    };\n  }\n  return runCommandOverride(activeExtensionCommands, {\n    command: activeCommandContext.command,\n    args: [...activeCommandContext.args],\n    options: activeCommandContext.options\n      ? { ...activeCommandContext.options }\n      : {},\n    global: activeCommandContext.global\n      ? { ...activeCommandContext.global }\n      : undefined,\n    pm_root: activeCommandContext.pm_root,\n    result,\n  });\n}\n\n/** Implements run active command handler for the public runtime surface of this module. */\nexport async function runActiveCommandHandler(\n  context: CommandHandlerContext,\n): Promise<CommandHandlerResult> {\n  if (!activeExtensionCommands) {\n    return {\n      handled: false,\n      result: null,\n      warnings: [],\n    };\n  }\n  return runCommandHandler(activeExtensionCommands, context);\n}\n\n/** Implements run active parser override for the public runtime surface of this module. */\nexport async function runActiveParserOverride(\n  context: ParserOverrideContext,\n): Promise<ParserOverrideResult> {\n  if (!activeExtensionParsers) {\n    return {\n      overridden: false,\n      context: {\n        command: context.command,\n        args: [...context.args],\n        options: { ...context.options },\n        global: { ...context.global },\n        pm_root: context.pm_root,\n      },\n      warnings: [],\n    };\n  }\n  return runParserOverride(activeExtensionParsers, context);\n}\n\n/** Implements run active preflight override for the public runtime surface of this module. */\nexport async function runActivePreflightOverride(\n  context: PreflightOverrideContext,\n): Promise<PreflightOverrideResult> {\n  if (!activeExtensionPreflight) {\n    return {\n      overridden: false,\n      context: {\n        command: context.command,\n        args: [...context.args],\n        options: { ...context.options },\n        global: { ...context.global },\n        pm_root: context.pm_root,\n      },\n      decision: { ...context.decision },\n      warnings: [],\n    };\n  }\n  return runPreflightOverride(activeExtensionPreflight, context);\n}\n\n/** Implements run active renderer override for the public runtime surface of this module. */\nexport function runActiveRendererOverride(\n  format: OutputRendererFormat,\n  result: unknown,\n): RendererOverrideResult {\n  if (!activeExtensionRenderers) {\n    return {\n      overridden: false,\n      rendered: null,\n      warnings: [],\n    };\n  }\n  return runRendererOverride(activeExtensionRenderers, {\n    format,\n    command: activeCommandContext?.command,\n    args: activeCommandContext ? [...activeCommandContext.args] : [],\n    options: activeCommandContext?.options\n      ? { ...activeCommandContext.options }\n      : {},\n    global: activeCommandContext?.global\n      ? { ...activeCommandContext.global }\n      : undefined,\n    pm_root: activeCommandContext?.pm_root,\n    result,\n  });\n}\n\nfunction buildServiceContext(service: ExtensionServiceName, payload: unknown) {\n  return {\n    service,\n    command: activeCommandContext?.command,\n    args: activeCommandContext ? [...activeCommandContext.args] : [],\n    options: activeCommandContext?.options\n      ? { ...activeCommandContext.options }\n      : {},\n    global: activeCommandContext?.global\n      ? { ...activeCommandContext.global }\n      : undefined,\n    pm_root: activeCommandContext?.pm_root,\n    payload,\n  };\n}\n\n/** Implements run active service override for the public runtime surface of this module. */\nexport async function runActiveServiceOverride(\n  service: ExtensionServiceName,\n  payload: unknown,\n): Promise<ServiceOverrideResult> {\n  if (!activeExtensionServices) {\n    return {\n      handled: false,\n      result: payload,\n      warnings: [],\n    };\n  }\n  return runServiceOverride(\n    activeExtensionServices,\n    buildServiceContext(service, payload),\n  );\n}\n\n/** Implements run active service override sync for the public runtime surface of this module. */\nexport function runActiveServiceOverrideSync(\n  service: ExtensionServiceName,\n  payload: unknown,\n): ServiceOverrideResult {\n  if (!activeExtensionServices) {\n    return {\n      handled: false,\n      result: payload,\n      warnings: [],\n    };\n  }\n  return runServiceOverrideSync(\n    activeExtensionServices,\n    buildServiceContext(service, payload),\n  );\n}\n\nexport * from \"./loader.js\";\nexport * from \"./command-hook-context.js\";\nexport { createSerialQueue } from \"../shared/serial-queue.js\";\nexport {\n  EXTENSION_CAPABILITY_REGISTRATION_SURFACES,\n  collectUsedExtensionCapabilities,\n  reconcileExtensionCapabilityUsage,\n  type CollectUsedExtensionCapabilitiesOptions,\n  type ExtensionCapabilityUsageReconciliation,\n} from \"./capability-usage.js\";\n"],"names":[],"mappings":"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","debugId":"27bb9504-233c-5768-8932-d1cae84313be"}

package/dist/core/item/parse.d.ts

@@ -54,6 +54,8 @@ export interface StdinTokenResolver {
 export declare function createStdinTokenResolver(): StdinTokenResolver;
 /** Implements parse optional number for the public runtime surface of this module. */
 export declare function parseOptionalNumber(raw: string, optionName: string): number;
+/** Parse a non-negative integer option such as an item duration estimate. */
+export declare function parseOptionalNonNegativeInteger(raw: string, optionName: string): number;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
     coerceJsonTagArray: typeof coerceJsonTagArray;

package/dist/core/item/parse.js

@@ -4,7 +4,7 @@
  * Defines item parsing, formatting, and lifecycle helpers for Parse.
  */
 
-!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]="8763cf00-d6d8-5e91-94d2-f65fb3321909")}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]="fb39edac-1965-5a52-9c0c-c4330fe3a8c7")}catch(e){}}();
 import { PmCliError } from "../shared/errors.js";
 import { EXIT_CODE } from "../shared/constants.js";
 const STDIN_TOKEN = "-";
@@ -418,6 +418,15 @@ export function parseOptionalNumber(raw, optionName) {
     }
     return value;
 }
+/** Parse a non-negative integer option such as an item duration estimate. */
+export function parseOptionalNonNegativeInteger(raw, optionName) {
+    const trimmed = raw.trim();
+    const value = Number(trimmed);
+    if (trimmed === "" || !Number.isInteger(value) || value < 0) {
+        throw new PmCliError(`Invalid ${optionName} value "${raw}". Expected a non-negative integer.`, EXIT_CODE.USAGE);
+    }
+    return value;
+}
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export const _testOnly = {
     coerceJsonTagArray,
@@ -425,4 +434,4 @@ export const _testOnly = {
     parseMarkdownKeyValueLines,
 };
 //# sourceMappingURL=parse.js.map
-//# debugId=8763cf00-d6d8-5e91-94d2-f65fb3321909
+//# debugId=fb39edac-1965-5a52-9c0c-c4330fe3a8c7