@unbrained/pm-cli 2026.7.9 → 2026.7.10

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/index\n *\n * Defines public SDK APIs and package-author helpers for Index.\n */\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 {\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 { CommanderOptionAliasContract, CommanderOptionRegistrationContract } 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_AUDIT_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  DEDUPE_AUDIT_FLAG_CONTRACTS,\n  DEDUPE_MERGE_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  NORMALIZE_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_DEDUPE_AUDIT_OPTION_CONTRACTS,\n  TOOL_DEPS_OPTION_CONTRACTS,\n  TOOL_LIST_FILTER_OPTION_CONTRACTS,\n  TOOL_NORMALIZE_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 \"./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  listAllFrontMatter,\n  loadCreateTemplateOptions,\n  locateItem,\n  normalizeFrontMatter,\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  runCommentsAudit,\n  runCompletion,\n  runDedupeAudit,\n  runDedupeMerge,\n  runGuide,\n  runNormalize,\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  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 CommentsAuditEntry,\n  type CommentsAuditHistoryRow,\n  type CommentsAuditOptions,\n  type CommentsAuditResult,\n  type CommentsAuditSummary,\n  type CommentsAuditTypeSummary,\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 DedupeAuditCandidate,\n  type DedupeAuditCluster,\n  type DedupeAuditOptions,\n  type DedupeAuditResult,\n  type DedupeMergeChildReparent,\n  type DedupeMergeCloseAction,\n  type DedupeMergeDuplicateOutcome,\n  type DedupeMergeOptions,\n  type DedupeMergeResult,\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 ItemMetadata,\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 NormalizeCommandOptions,\n  type NormalizeResult,\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 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/**\n * Restricts extension capability values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/**\n * Canonical extension governance policy modes and registration surfaces.\n */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\n/**\n * Restricts extension policy mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\n/**\n * Restricts extension policy surface values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\n/**\n * Restricts extension trust mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\n/**\n * Restricts extension sandbox profile values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionSandboxProfile = (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/**\n * Versioned capability contract metadata emitted by runtime diagnostics.\n */\nexport { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES };\n\n/**\n * Least-privilege capability reconciliation helpers: map declared capabilities\n * against the registration surfaces a package actually exercises at activation.\n */\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 { ItemDocument, ItemFrontMatter, ItemStatus, ItemType, PmSettings } from \"../types/index.js\";\n"],"names":[],"mappings":"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","debugId":"a5711d42-f13d-5316-9112-0ed678f3a1ce"}
+{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/index\n *\n * Defines public SDK APIs and package-author helpers for Index.\n */\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 {\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 { CommanderOptionAliasContract, CommanderOptionRegistrationContract } 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_AUDIT_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  DEDUPE_AUDIT_FLAG_CONTRACTS,\n  DEDUPE_MERGE_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  NORMALIZE_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_DEDUPE_AUDIT_OPTION_CONTRACTS,\n  TOOL_DEPS_OPTION_CONTRACTS,\n  TOOL_LIST_FILTER_OPTION_CONTRACTS,\n  TOOL_NORMALIZE_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 \"./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  listAllFrontMatter,\n  loadCreateTemplateOptions,\n  locateItem,\n  normalizeFrontMatter,\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  runCommentsAudit,\n  runCompletion,\n  runDedupeAudit,\n  runDedupeMerge,\n  runGuide,\n  runNormalize,\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  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 CommentsAuditEntry,\n  type CommentsAuditHistoryRow,\n  type CommentsAuditOptions,\n  type CommentsAuditResult,\n  type CommentsAuditSummary,\n  type CommentsAuditTypeSummary,\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 DedupeAuditCandidate,\n  type DedupeAuditCluster,\n  type DedupeAuditOptions,\n  type DedupeAuditResult,\n  type DedupeMergeChildReparent,\n  type DedupeMergeCloseAction,\n  type DedupeMergeDuplicateOutcome,\n  type DedupeMergeOptions,\n  type DedupeMergeResult,\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 ItemMetadata,\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 NormalizeCommandOptions,\n  type NormalizeResult,\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 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/**\n * Restricts extension capability values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/**\n * Canonical extension governance policy modes and registration surfaces.\n */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\n/**\n * Restricts extension policy mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\n/**\n * Restricts extension policy surface values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\n/**\n * Restricts extension trust mode values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\n/**\n * Restricts extension sandbox profile values accepted by command, SDK, and storage contracts.\n */\nexport type ExtensionSandboxProfile = (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/**\n * Versioned capability contract metadata emitted by runtime diagnostics.\n */\nexport { EXTENSION_CAPABILITY_CONTRACT, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES };\n\n/**\n * Least-privilege capability reconciliation helpers: map declared capabilities\n * against the registration surfaces a package actually exercises at activation.\n */\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 { ItemDocument, ItemFrontMatter, ItemStatus, ItemType, PmSettings } from \"../types/index.js\";\n"],"names":[],"mappings":"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","debugId":"db6acc46-6442-58d4-9436-be4229cb5d18"}

package/docs/COMMANDS.md

@@ -50,6 +50,8 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 ```bash
 pm init
 pm init --defaults --with-packages
+pm init --workspace ./new-project --defaults
+pm init ./sandbox-tracker --defaults
 pm init --agent-guidance status
 pm init --agent-guidance add
 pm config project list
@@ -58,6 +60,7 @@ pm telemetry status
 ```
 
 `pm init` creates `.agents/pm`. `pm health --check-only --summary --json` gives the smallest machine-readable health gate without refreshing optional search artifacts.
+Use `pm init --workspace <dir>` when `<dir>` is a project root; it creates `<dir>/.agents/pm`. A path-like positional remains the advanced tracker-root form and writes tracker files directly at that path. Both explicit target forms return `target.mode`, `target.tracker_root`, and tracker-scoped executable `next_steps` so agents can run the suggestions from any working directory.
 `pm init --agent-guidance ask` is the default behavior: prompt in TTY only when AGENTS/CLAUDE guidance is missing and no decline is recorded.
 Use `--agent-guidance add` to write guidance, `--agent-guidance skip` to persist a decline without writing, and `--agent-guidance status` to inspect guidance state.
 Use `--with-packages` for one-step agent setup when bundled package commands should be active immediately.
@@ -78,6 +81,7 @@ pm upgrade --cli-only --repair
 ```
 
 `pm install` and `pm package` are the preferred package-first workflow. `pm package` and `pm extension` bare invocations default to `--explore` so agents can list installed packages without remembering an action flag. `pm install '*'`, shell-expanded `pm install *`, and `pm install all` install bundled first-party packages. `pm extension` remains as a compatibility command for direct extension lifecycle operations.
+Install output includes a light `verification` summary with target tracker root, activation state, registered commands/actions/item types, and an `ok|degraded` health verdict. Runtime activation failure sets the command result and process exit status to failure; inspect `activation_diagnostics` and `command_discovery.next_steps` for the exact recovery path.
 When package-owned commands are unavailable, usage guidance includes an install-ready retry (for example `pm install calendar`, `pm install search-advanced`, `pm install governance-audit`, or `pm install guide-shell`).
 
 ## Triage
@@ -178,7 +182,7 @@ pm search "auth tag:area:auth status:open"        # query "auth" + --tag area:au
 pm search "ranking type:Task priority:1"          # query "ranking" + --type Task --priority 1
 ```
 
-Precedence: an **explicit `--flag` always wins** over a conflicting inline token. When both are supplied, the flag value is used and the result carries a `search_inline_filter_ignored:<field>:flag_takes_precedence` warning so the override is observable. On the CLI, an unquoted `tag:value` token is already rewritten to `--tag value` by argument normalization; the in-query parser additionally covers quoted multi-word queries and the `pm_search` MCP tool, where the whole query arrives as a single string. A query consisting solely of inline tokens (no keyword terms) is rejected — use `pm list` with the equivalent `--tag`/`--status`/`--type`/`--priority` flags for pure filtering.
+Precedence: an **explicit `--flag` always wins** over a conflicting inline token. When both are supplied, the flag value is used and the result carries a `search_inline_filter_ignored:<field>:flag_takes_precedence` warning so the override is observable. On the CLI, both unquoted inline tokens (`status:all scene`) and quoted multi-word queries (`"status:all scene"`) stay query input so the search parser can remove inline filters and preserve the remaining keywords. The same parser covers the `pm_search` MCP tool, where the whole query arrives as a single string. A query consisting solely of inline tokens (no keyword terms) is rejected — use `pm list` with the equivalent `--tag`/`--status`/`--type`/`--priority` flags for pure filtering.
 
 Pass `--highlight` to emit per-field matched-text snippets on each hit (off by default for token efficiency). Each matched field gets a `{ field, snippet }` entry under `highlights`, with the matching token runs wrapped in `«…»` and a `…` ellipsis where the field text was windowed:
 
@@ -420,6 +424,8 @@ Use `pm close <duplicate-id> --duplicate-of <canonical-id>` to close duplicates.
 
 `pm close` accepts short aliases for the common flags: `-m` (`--message`), `-r` (`--reason`), and `-d` (`--duplicate-of`). When `governance.require_close_reason` is enabled and no positional/`--reason` text is given, the close reason is derived from the next-best signal in priority order — explicit reason text, then `--duplicate-of` (`Duplicate of <id>`), then `--resolution` — so a single `pm close <id> --resolution "<summary>"` no longer hard-blocks. The resolution is still written to the item's `resolution` field.
 
+`pm create --blocked-by <id>` and `pm update --blocked-by <id>` keep the scalar `blocked_by` field as the latest/primary blocker for compatibility. When the value resolves to a real item, the command also appends a `blocked_by` dependency edge so `pm deps` and reverse dependency scans see the full blocker graph. Repeating `pm update --blocked-by` with a different blocker preserves the prior blocker edge and appends the new one; repeating the same blocker is deduplicated. Use `pm update <id> --unset blocked-by` to clear the scalar and all `blocked_by` dependency edges.
+
 When closing a blocker, `pm close` scans reverse `blocked_by` edges and auto-unblocks dependent items only when every resolvable blocker is now terminal. Each unblocked item is updated through the normal audited mutation path, gets an `unblock_note`, and the close result reports compact `auto_unblocked:<id>:resolved_blockers=<ids>` warnings. Items with another active blocker remain blocked.
 
 Over MCP the mutation tools (`pm_create`/`pm_update`/`pm_close`/`pm_run` append/update-many) are compact by default; pass `fullChangedFields=true` to restore the full `changed_fields` delta, or `idOnly=true` for single-item id/status output.

package/docs/EXTENSIONS.md

@@ -40,7 +40,9 @@ pm install kanban --project
 
 `pm install '*'`, `pm install all`, and shell-expanded `pm install *` are normalized to the same bundled install-all request. First-party package aliases come from each package manifest, with a fallback derived from the `packages/pm-*` directory name.
 
-External registry packages are installed by exact package name. If `npm:<name>` returns a registry 404, JSON error output includes `fallback_candidates` and `next_best_command`; unpublished first-party packages fall back to `pm install --project github.com/unbraind/<name>`. Install results include package-owned `command_paths`, `action_paths`, and `command_discovery`; agents should read `details.command_discovery.command_paths` and `details.command_discovery.help_commands` instead of guessing from the package name.
+External registry packages are installed by exact package name. If `npm:<name>` returns a registry 404, JSON error output includes `fallback_candidates` and `next_best_command`; unpublished first-party packages fall back to `pm install --project github.com/unbraind/<name>`. Install results include package-owned `command_paths`, `action_paths`, `command_discovery`, and a light `verification` block covering the target tracker, activation status, registered commands/actions/item types, and health verdict. Agents should consume those fields instead of guessing from the package name or immediately spending another invocation on doctor. A failed runtime activation returns `ok: false`, `activated: false`, a non-zero CLI exit, and actionable diagnostics; missing SDK resolution adds an explicit dependency recovery step.
+
+An explicit `--pm-path` scopes project installs to that tracker root, including extension files, managed state, settings, type-folder scaffolding, and verification output. This is the safe form for temporary package testing from inside another repository checkout.
 
 ```bash
 npm search "pm-cli pm-package"

package/docs/SDK.md

@@ -106,6 +106,8 @@ Command/action contract exports:
 - `PmClient` / `runAction` (high-level in-process action execution for custom tools, bots, CI, and embedded runtimes)
 - Typed read primitives on `PmClient`: `get`, `list`, `search`, `context`, `next`, `aggregate`, and `stats`
 - Read primitive option/result contracts: `GetOptions` / `GetResult`, `ListOptions` / `ListResult`, `SearchOptions` / `SearchResult`, `ContextOptions` / `ContextResult`, `NextOptions` / `NextResult`, `AggregateOptions` / `AggregateResult`, `StatsCommandOptions` / `StatsResult`
+- Context relevance primitives: `defaultScoreContextCandidates`, `scoreContextCandidates`, `scoreContextCandidatesWithActiveExtensions`, `evaluateContextRanking`, `runContextEvaluationScenario`, `runContextEvaluationCorpus`, and `summarizeContextEvaluationReports`
+- Context relevance contracts: `ContextRelevanceCandidate`, `ContextRelevanceSignals`, `ContextRelevanceScorer`, `ContextRelevanceReport`, `ContextEvaluationReader`, `ContextEvaluationScenario`, `ContextEvaluationScenarioReport`, `ContextEvaluationThresholds`, and `ContextEvaluationCorpusReport`
 - Typed annotation and relationship primitives on `PmClient`: `comments`, `notes`, `learnings`, `files`, `filesDiscover`, `docs`, `deps`, and `append`
 - Annotation and relationship option/result contracts: `CommentsCommandOptions` / `CommentsResult`, `NotesCommandOptions` / `NotesResult`, `LearningsCommandOptions` / `LearningsResult`, `FilesCommandOptions` / `FilesResult`, `FilesDiscoverOptions` / `FilesDiscoverResult`, `DocsCommandOptions` / `DocsResult`, `DepsCommandOptions` / `DepsResult`, `AppendCommandOptions` / `AppendResult`
 - Typed customization primitives on `PmClient`: `init`, `config`, `schema`, `schemaList`, `schemaShow`, `schemaAddType`, `schemaRemoveType`, `schemaAddStatus`, `schemaRemoveStatus`, `schemaAddField`, `schemaRemoveField`, `schemaListFields`, `schemaShowField`, `schemaApplyPreset`, `schemaInferTypes`, `schemaShowStatus`, `profile`, `profileList`, `profileShow`, `profileApply`, and `profileLint`
@@ -529,6 +531,17 @@ tools. `pm.init` stages a tracker, `pm.config` reads/writes settings,
 methods list, inspect, apply, and lint project archetypes. These helpers let a
 package or app construct an opinionated project-management experience while
 staying on the same schema/profile primitives the CLI and MCP use.
+`pm.init` accepts `workspace` to initialize `<workspace>/.agents/pm`; path-target
+calls retain tracker-root semantics. `InitResult.target` exposes the resolved
+mode, tracker root, and optional workspace root, while every explicit-target
+`next_steps` command carries `--pm-path` so embedded tools can display runnable
+recovery without depending on the caller's current directory.
+
+Package install results include `details.verification`, a light doctor-equivalent
+projection of activation, registered commands/actions/item types, target tracker
+root, and health verdict. Treat `ok: false` or `verification.status: "degraded"`
+as an install failure even when files were copied successfully; use
+`activation_diagnostics` and `command_discovery.next_steps` for remediation.
 
 Governance and maintenance convenience methods expose the operational floor a
 custom PM host should run before it trusts or publishes tracker state.
@@ -538,6 +551,71 @@ the same bounded maintenance engine as the CLI. Prefer these typed calls over
 shelling out when building CI, editor integrations, or long-running agent
 runtimes.
 
+### Context relevance and evaluation
+
+Tracked by [pm-4k6b](../.agents/pm/features/pm-4k6b.toon),
+[pm-h3no](../.agents/pm/tasks/pm-h3no.toon), and
+[pm-atfm](../.agents/pm/features/pm-atfm.toon).
+
+`pm context` and `pm next` share the public deterministic relevance model.
+Candidate order is the structural baseline; normalized metadata signals add
+explainable weighted contributions. Package authors can call
+`scoreContextCandidates` with a scorer callback, while installed extensions can
+register the governed `context_relevance` service override. A malformed or
+throwing override degrades to the deterministic default and emits an
+`extension_context_relevance_invalid_result` warning instead of breaking the
+read path.
+
+Use `--explain-ranking --json` on `pm context` or `pm next` to include the model,
+available signals, baseline rank, final rank, score, and per-signal
+contributions. Explanation data is opt-in so default agent output stays bounded.
+
+Custom tools can evaluate the same behavior without shelling out:
+
+```ts
+import {
+  PmClient,
+  runContextEvaluationCorpus,
+  type ContextEvaluationScenario,
+  type ContextEvaluationThresholds,
+} from "@unbrained/pm-cli/sdk";
+
+const pm = new PmClient({
+  pmRoot: ".agents/pm",
+  author: "context-quality-ci",
+});
+
+const scenarios: ContextEvaluationScenario[] = [
+  {
+    id: "returning-agent",
+    surface: "context",
+    options: { limit: "5" },
+    judgments: { "pm-current": 3, "pm-support": 2 },
+    required_ids: ["pm-current"],
+    continuity_ids: ["pm-current", "pm-support"],
+    token_budget: 1200,
+    rationale: "Resume claimed work with its supporting context.",
+  },
+];
+
+const thresholds: ContextEvaluationThresholds = {
+  ndcg: 0.9,
+  reciprocal_rank: 0.9,
+  required_recall: 1,
+  continuity_coverage: 1,
+  token_budget_adherence: 1,
+};
+
+const report = await runContextEvaluationCorpus(scenarios, pm, thresholds);
+if (!report.passed) throw new Error(report.failures.join(", "));
+```
+
+The evaluator calls only the public `context()` / `next()` reader contract. It
+scores nDCG, reciprocal rank, required-item recall, returning-agent continuity,
+and deterministic `ceil(UTF-8 JSON bytes / 4)` token-budget adherence. Reports
+retain attribution only for served items, while token accounting measures the
+normal packet without the opt-in ranking explanation.
+
 `PmClient` and `runAction` share the same process-wide extension activation
 queue as MCP. Calls from one process are serialized across extension load,
 activation, dispatch, cleanup, and deactivate so active extension registries stay

package/docs/TESTING.md

@@ -2,7 +2,7 @@
 
 This page describes safe local tests, linked tests, coverage, and release-readiness checks.
 
-Tracked implementation updates: [pm-52eh](../.agents/pm/features/pm-52eh.toon), [pm-mcxr](../.agents/pm/issues/pm-mcxr.toon), [pm-u42x](../.agents/pm/issues/pm-u42x.toon).
+Tracked implementation updates: [pm-52eh](../.agents/pm/features/pm-52eh.toon), [pm-mcxr](../.agents/pm/issues/pm-mcxr.toon), [pm-u42x](../.agents/pm/issues/pm-u42x.toon), [pm-atfm](../.agents/pm/features/pm-atfm.toon), [pm-xmp5](../.agents/pm/tasks/pm-xmp5.toon).
 
 ## Agent Quick Context
 
@@ -109,6 +109,45 @@ Fixture authoring notes:
 
 CI currently runs this gate in advisory mode (`continue-on-error: true`), so failures do not block merges by default; treat failing nDCG as a quality signal to investigate, not as a silent ignore.
 
+## Context Quality Evaluation
+
+The required context relevance gate proves that `pm context` and `pm next`
+assemble the right bounded working set, not only that search returns relevant
+documents.
+
+Fixture and baseline sources:
+
+- `tests/context-eval/golden-scenarios.json` — reviewable scratch,
+  real-shaped, synthetic-scale, and returning-agent continuity judgments.
+- `tests/context-eval/baseline.json` — committed aggregate and per-scenario
+  metrics from the accepted structural/scorer behavior.
+
+Run the required gate locally:
+
+```bash
+pnpm build
+pnpm quality:context-eval
+```
+
+The gate creates isolated temporary trackers through `PmClient`, reads them only
+through the public `context()` / `next()` SDK primitives, and reports nDCG,
+reciprocal rank, required-item recall, continuity coverage, token-budget
+adherence, and served-item signal attribution. It fails when an explicit corpus
+threshold is missed or any aggregate metric regresses below the committed
+baseline.
+
+When a deliberate ranking change improves or intentionally redefines the golden
+judgments, review the scenario-level diff first, then refresh the baseline:
+
+```bash
+pnpm quality:context-eval -- --update
+pnpm quality:context-eval
+```
+
+Do not update the baseline merely to make CI green. Change judgments and
+rationales in the corpus when product intent changes, and commit the corpus,
+baseline, scorer tests, and SDK documentation together.
+
 ## Linked Tests
 
 Add tests to the item that owns the work:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.7.9",
+  "version": "2026.7.10",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",
@@ -80,7 +80,9 @@
     "lint:complexity:baseline": "eslint . --suppress-rule complexity",
     "lint:duplicates": "jscpd --config .jscpd.json",
     "lint:codefactor": "pnpm quality:static",
-    "quality:static": "node scripts/release/static-quality-gate.mjs --min-docstring-coverage 92.93 --min-exported-docstring-coverage 84.41 --min-member-docstring-coverage 13.655",
+    "quality:static": "pnpm build && node scripts/release/static-quality-gate.mjs --min-docstring-coverage 92.93 --min-exported-docstring-coverage 84.41 --min-member-docstring-coverage 13.655 && node scripts/release/token-budget-gate.mjs",
+    "quality:token-budget": "node scripts/release/token-budget-gate.mjs",
+    "quality:context-eval": "node scripts/release/context-eval-gate.mjs",
     "quality:docs-skills": "node scripts/release/docs-skills-gate.mjs",
     "quality:docs-links": "node scripts/release/docs-skills-gate.mjs --links-only",
     "contracts:update": "node scripts/contracts-snapshot.mjs --update",

package/dist/cli-bundle/chunks/append-CDPAYYSB.js

@@ -1,11 +0,0 @@
-import {
-  runAppend
-} from "./chunk-GSQVQINP.js";
-import "./chunk-WW4E2DC3.js";
-import "./chunk-CGDUIPJL.js";
-import "./chunk-BPJ5NYSJ.js";
-import "./chunk-2BVD4ZD2.js";
-export {
-  runAppend
-};
-//# sourceMappingURL=append-CDPAYYSB.js.map