@unbrained/pm-cli 2026.8.22 → 2026.8.24

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1782,
+    "covered_symbols": 1793,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1783
+    "required_symbols": 1794
   },
   "breaking_acknowledgements": [
     {
@@ -1060,6 +1060,127 @@
       ],
       "package_version": "2026.8.21",
       "reason": "Correct projected diagnostic types to model deterministic field omission and disclose bounded omission overflow."
+    },
+    {
+      "changes": [
+        "signature ./sdk:ConfigResult",
+        "signature ./sdk:PmReadOutputTruncationDisclosure",
+        "signature ./sdk/contracts:PmReadOutputTruncationDisclosure",
+        "signature ./sdk/runtime:ConfigResult"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "pm-c0lrdm pm-yds9dt pm-xam9bt: add adapter/config receipts and widen incorrect fixed recovery-budget literals to measured number or explicit null/unbounded"
+    },
+    {
+      "changes": [
+        "signature ./sdk:LinkedTest",
+        "signature ./sdk:PmSettings",
+        "signature ./sdk:TestAllCommandOptions",
+        "signature ./sdk:TestCommandOptions",
+        "signature ./sdk:TestRunResult",
+        "signature ./sdk/core:PmSettings",
+        "signature ./sdk/runtime:LinkedTest",
+        "signature ./sdk/runtime:PmSettings"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "Extend linked-test trust and workspace-context contracts across SDK entrypoints"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "Extend linked-test trust and workspace-context contracts across SDK entrypoints"
+    },
+    {
+      "changes": [
+        "signature ./sdk:LinkedTestFailureCategory",
+        "signature ./sdk:LinkedTestTrustDecision"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "Add explicit trust-refusal and invalid-provenance classifications required by linked-test execution safety"
+    },
+    {
+      "changes": [
+        "signature ./sdk:LinkedTest",
+        "signature ./sdk/runtime:LinkedTest"
+      ],
+      "package_version": "2026.8.22",
+      "reason": "Additive optional provenance_invalid marker preserves fail-closed storage state without widening the existing provenance source_kind union; two trust helpers are newly exported for CLI-consumer parity."
+    },
+    {
+      "changes": [
+        "signature ./sdk:CommandDefinition",
+        "signature ./sdk:RegisteredExtensionCommandDefinition",
+        "signature ./sdk/authoring:CommandDefinition"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Add optional tier and family metadata to extension command definitions while preserving existing producer call shapes; expose additive explicit-registry projections and refusal-census contracts."
+    },
+    {
+      "changes": [
+        "signature ./sdk:WorkspaceExtensionCommandContract",
+        "signature ./sdk/runtime:WorkspaceExtensionCommandContract"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Require tier and family metadata on projected workspace extension command contracts so every consumer receives explicit visibility and capability routing."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmCommandCapabilityFamily"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Capability-family literals are unchanged; the public alias now derives from the canonical extension metadata contract to prevent type drift."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmBulkMutationFilterOptions",
+        "signature ./sdk/contracts:PmBulkMutationFilterOptions"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Bulk mutation ids now also accept source-compatible readonly string arrays."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE",
+        "signature ./sdk:PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Refusal closure ratchets now include three executable bulk ID input states."
+    },
+    {
+      "changes": [
+        "signature ./sdk:CliFlagInvocationContract",
+        "signature ./sdk/contracts:CliFlagInvocationContract"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Expose the optional file_token_prefix metadata field for @path CLI inputs; existing consumers remain source-compatible"
+    },
+    {
+      "changes": [
+        "signature ./sdk:normalizeBulkIdsValue",
+        "signature ./sdk:PmBulkMutationFilterOptions",
+        "signature ./sdk/contracts:PmBulkMutationFilterOptions"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Restore source-compatible numeric scalar IDs while retaining transport-native ID arrays"
+    },
+    {
+      "changes": [
+        "signature ./sdk:normalizeBulkIdsValue",
+        "signature ./sdk:PmBulkMutationFilterOptions",
+        "signature ./sdk/contracts:PmBulkMutationFilterOptions"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Expand bulk ID contracts to finite numeric array members and fail closed on unsupported explicit selectors"
+    },
+    {
+      "changes": [
+        "signature ./sdk:HistoryCompactBulkCommandOptions"
+      ],
+      "package_version": "2026.8.23",
+      "reason": "Align history-compaction SDK ID inputs with bulk transport contracts and fail closed on invalid explicit selectors"
     }
   ],
   "entrypoints": {
@@ -1174,6 +1295,12 @@
           "name": "acceptAssuranceProposals",
           "signature": "(pmRoot: string, proposals: readonly AssuranceDerivedProposal[], options?: { author?: string; message?: string; }) => Promise<AssuranceBundleMutationReceipt> | calls: (pmRoot: string, proposals: readonly AssuranceDerivedProposal[], options?: { author?: string; message?: string; }) => Promise<AssuranceBundleMutationReceipt>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "acknowledgeLinkedTests",
+          "signature": "(pmRoot: string, tests: LinkedTest[], acknowledgedAt: string) => Promise<{ acknowledged: number; fingerprints: string[]; }> | calls: (pmRoot: string, tests: LinkedTest[], acknowledgedAt: string) => Promise<{ acknowledged: number; fingerprints: string[]; }>"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -1342,6 +1469,42 @@
           "name": "AgentEpisodeIdentity",
           "signature": "export interface AgentEpisodeIdentity { id: string; label?: string; parent_id?: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabulary",
+          "signature": "export interface AgentIdentityVocabulary { version: number; aliases: Record<string, string>; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabularyMutationInput",
+          "signature": "export interface AgentIdentityVocabularyMutationInput { operation: AgentIdentityVocabularyOperation; legacy_author?: string; canonical_harness?: string; observed_authors?: readonly string[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabularyMutationPlan",
+          "signature": "export interface AgentIdentityVocabularyMutationPlan { vocabulary: AgentIdentityVocabulary; preview: AgentIdentityVocabularyMutationPreview; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabularyMutationPreview",
+          "signature": "export interface AgentIdentityVocabularyMutationPreview { operation: AgentIdentityVocabularyOperation; changed: boolean; version_before: number; version_after: number; alias_count: number; residual_author_count: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AgentIdentityVocabularyOperation",
+          "signature": "export type AgentIdentityVocabularyOperation = \"add\" | \"remove\" | \"clear\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AgentIdentityVocabularySummary",
+          "signature": "export interface AgentIdentityVocabularySummary { version: number; alias_count: number; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -1366,6 +1529,12 @@
           "name": "AgentProvenanceAbsenceReason",
           "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentProvenanceAdapter",
+          "signature": "export interface AgentProvenanceAdapter { contract_version: 1; adapter_version: string; priority: number; harness: string; descriptor: HarnessSignalDescriptor; supported_dimensions: readonly string[]; native_sources: readonly (\"environment\" | \"argv\" | \"mcp_client\" | \"session_file\")[]; probe_policy: { max_bytes: number; max_lines: number; network_access: false; subprocess_access: false; }; normalization: { model_family: \"v1\"; effort: \"v1\"; preserve_raw: true; }; confidence: \"high\" | \"medium\" | \"low\"; waivers?: Readonly<Record<string, string>>; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -2386,6 +2555,18 @@
           "name": "attachContextIntentReceipt",
           "signature": "<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => Result & { context_intent?: PmContextIntentReceipt; } | calls: <Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => Result & { context_intent?: PmContextIntentReceipt; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "attachLinkedTestMutationProvenance",
+          "signature": "(tests: LinkedTest[] | undefined, author: string, createdAt: string) => Promise<LinkedTest[] | undefined> | calls: (tests: LinkedTest[] | undefined, author: string, createdAt: string) => Promise<LinkedTest[] | undefined>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "attachLinkedTestProvenance",
+          "signature": "(tests: LinkedTest[] | undefined, author: string, createdAt: string, sourceRef: string | undefined) => LinkedTest[] | undefined | calls: (tests: LinkedTest[] | undefined, author: string, createdAt: string, sourceRef: string | undefined) => LinkedTest[] | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -2680,6 +2861,12 @@
           "name": "buildPmActionToolInputSchema",
           "signature": "(action: PmToolAction, options?: PmActionToolInputSchemaOptions) => Record<string, unknown> | calls: (action: PmToolAction, options?: PmActionToolInputSchemaOptions) => Record<string, unknown>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "buildPmRefusalClosureCensus",
+          "signature": "(catalog: readonly PmErrorCodeContract[], closedDomains: readonly PmClosedDomainContract[], grammar: readonly PmGrammarRefusalContract[]) => PmRefusalClosureCensusReport | calls: (catalog: readonly PmErrorCodeContract[], closedDomains: readonly PmClosedDomainContract[], grammar: readonly PmGrammarRefusalContract[]) => PmRefusalClosureCensusReport"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -2728,6 +2915,12 @@
           "name": "buildWorkspaceMemorySnapshot",
           "signature": "(items: readonly ItemMetadata[], options: { statusRegistry: RuntimeStatusRegistry; sourceCursor: string; now: string; }) => WorkspaceMemorySnapshot | calls: (items: readonly ItemMetadata[], options: { statusRegistry: RuntimeStatusRegistry; sourceCursor: string; now: string; }) => WorkspaceMemorySnapshot"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "BUILTIN_AGENT_PROVENANCE_ADAPTERS",
+          "signature": "readonly AgentProvenanceAdapter[]"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -2764,6 +2957,30 @@
           "name": "BuiltinCorpusShapeName",
           "signature": "export type BuiltinCorpusShapeName = \"scratch\" | \"representative\" | \"deep-graph\" | \"multi-decade\" | \"disconnected-archive\";"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "BulkIdsFileReader",
+          "signature": "export type BulkIdsFileReader = (path: string) => Promise<string>;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "BulkIdsInputReaders",
+          "signature": "export interface BulkIdsInputReaders { readFile?: BulkIdsFileReader; readStdin?: BulkIdsStdinReader; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "BulkIdsStdinReader",
+          "signature": "export type BulkIdsStdinReader = (optionName: string) => Promise<string>;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "BulkIdsValue",
+          "signature": "export type BulkIdsValue = string | number | readonly (string | number)[] | undefined;"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -3014,7 +3231,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "CliFlagInvocationContract",
-          "signature": "export interface CliFlagInvocationContract extends CliFlagContract { description: string; takes_value: boolean; value_required: boolean; value_type: \"string\" | \"number\" | \"boolean\"; required: boolean; repeatable: boolean; input_sources: CliFlagInputSource[]; stdin_token?: \"-\"; }"
+          "signature": "export interface CliFlagInvocationContract extends CliFlagContract { description: string; takes_value: boolean; value_required: boolean; value_type: \"string\" | \"number\" | \"boolean\"; required: boolean; repeatable: boolean; input_sources: CliFlagInputSource[]; stdin_token?: \"-\"; file_token_prefix?: \"@\"; }"
         },
         {
           "classification": "contract_data",
@@ -3242,7 +3459,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommandDefinition",
-          "signature": "export interface CommandDefinition { name: string; run?: CommandHandler; handler?: CommandHandler; action?: string; description?: string; intent?: string; examples?: string[]; failure_hints?: string[]; arguments?: ExtensionCommandArgumentDefinition[]; flags?: FlagDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface CommandDefinition { name: string; run?: CommandHandler; handler?: CommandHandler; action?: string; description?: string; intent?: string; examples?: string[]; failure_hints?: string[]; arguments?: ExtensionCommandArgumentDefinition[]; flags?: FlagDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; family?: ExtensionCommandCapabilityFamily; }"
         },
         {
           "classification": "contract_data",
@@ -3542,7 +3759,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ConfigResult",
-          "signature": "export interface ConfigResult { scope: ConfigScope; key?: ConfigKey | string; criteria?: string[]; format?: ItemFormat; policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string; nested_setting?: NestedSettingResultValue; nested_settings?: NestedSettingResultValue[]; keys?: ConfigKeyDescriptor[]; values?: Record<ConfigKey, ConfigValue>; count?: number; context_settings?: ContextConfigValue; has_explicit_item_format?: boolean; migration?: { target_format: ItemFormat; scanned: number; migrated: string[]; removed: string[]; warnings: string[]; }; settings_path: string; changed: boolean; warnings?: string[]; }"
+          "signature": "export interface ConfigResult { scope: ConfigScope; key?: ConfigKey | string; criteria?: string[]; format?: ItemFormat; policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string; nested_setting?: NestedSettingResultValue; nested_settings?: NestedSettingResultValue[]; keys?: ConfigKeyDescriptor[]; values?: Record<ConfigKey, ConfigValue>; count?: number; context_settings?: ContextConfigValue; identity_vocabulary?: AgentIdentityVocabularySummary; vocabulary_mutation?: AgentIdentityVocabularyMutationPreview; has_explicit_item_format?: boolean; migration?: { target_format: ItemFormat; scanned: number; migrated: string[]; removed: string[]; warnings: string[]; }; settings_path: string; changed: boolean; warnings?: string[]; }"
         },
         {
           "classification": "advanced_export",
@@ -4168,6 +4385,12 @@
           "name": "createRelationshipKindRegistry",
           "signature": "() => RelationshipKindRegistry | calls: () => RelationshipKindRegistry"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "createReproducibleProcessRunner",
+          "signature": "(environment: ReproducibleProcessEnvironment) => ReproducibleProcessRunner | calls: (environment: ReproducibleProcessEnvironment) => ReproducibleProcessRunner"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -7004,7 +7227,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "HistoryCompactBulkCommandOptions",
-          "signature": "export interface HistoryCompactBulkCommandOptions { ids?: string[]; scope?: HistoryCompactScope; allOver?: number; minEntries?: number; dryRun?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface HistoryCompactBulkCommandOptions { ids?: BulkIdsValue; scope?: HistoryCompactScope; allOver?: number; minEntries?: number; dryRun?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -7822,6 +8045,12 @@
           "name": "LINKED_TEST_PROTECTED_ENV_KEYS",
           "signature": "Set<string>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES",
+          "signature": "readonly [\"source\", \"isolated\", \"snapshot\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "type",
@@ -7874,13 +8103,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "LinkedTest",
-          "signature": "export interface LinkedTest { command?: string; path?: string; scope: LinkScope; timeout_seconds?: number; pm_context_mode?: \"schema\" | \"tracker\" | \"auto\"; env_set?: Record<string, string>; env_clear?: string[]; shared_host_safe?: boolean; assert_stdout_contains?: string[]; assert_stdout_regex?: string[]; assert_stderr_contains?: string[]; assert_stderr_regex?: string[]; assert_stdout_min_lines?: number; assert_json_field_equals?: Record<string, string>; assert_json_field_gte?: Record<string, number>; note?: string; }"
+          "signature": "export interface LinkedTest { command?: string; path?: string; scope: LinkScope; timeout_seconds?: number; pm_context_mode?: \"schema\" | \"tracker\" | \"auto\"; workspace_context_mode?: \"source\" | \"isolated\" | \"snapshot\"; provenance?: LinkedTestProvenance; provenance_invalid?: true; env_set?: Record<string, string>; env_clear?: string[]; shared_host_safe?: boolean; assert_stdout_contains?: string[]; assert_stdout_regex?: string[]; assert_stderr_contains?: string[]; assert_stderr_regex?: string[]; assert_stdout_min_lines?: number; assert_json_field_equals?: Record<string, string>; assert_json_field_gte?: Record<string, number>; note?: string; }"
         },
         {
           "classification": "advanced_export",
           "kind": "type",
           "name": "LinkedTestFailureCategory",
-          "signature": "export type LinkedTestFailureCategory = \"infra_collision\" | \"assertion_failure\" | \"empty_run\" | \"timeout\" | \"max_buffer\" | \"spawn_error\" | \"signal\";"
+          "signature": "export type LinkedTestFailureCategory = \"infra_collision\" | \"trust_refusal\" | \"assertion_failure\" | \"empty_run\" | \"timeout\" | \"max_buffer\" | \"spawn_error\" | \"signal\";"
         },
         {
           "classification": "advanced_export",
@@ -7888,6 +8117,24 @@
           "name": "LinkedTestPmContextMode",
           "signature": "export type LinkedTestPmContextMode = (typeof LINKED_TEST_PM_CONTEXT_MODE_VALUES)[number];"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "LinkedTestTrustDecision",
+          "signature": "export interface LinkedTestTrustDecision { fingerprint: string; trusted: boolean; reason: \"legacy\" | \"local_mutation\" | \"local_source_ref\" | \"acknowledged\" | \"invalid_provenance\" | \"foreign_source_ref\"; source_ref?: string; current_source_ref?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "linkedTestTrustFingerprint",
+          "signature": "(test: LinkedTest) => string | calls: (test: LinkedTest) => string"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "LinkedTestWorkspaceContextMode",
+          "signature": "export type LinkedTestWorkspaceContextMode = (typeof LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES)[number];"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -7948,6 +8195,12 @@
           "name": "LIST_SORT_ORDER_VALUES",
           "signature": "readonly [\"asc\", \"desc\"]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "listAgentProvenanceAdapters",
+          "signature": "() => readonly AgentProvenanceAdapter[] | calls: () => readonly AgentProvenanceAdapter[]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8110,6 +8363,18 @@
           "name": "listPmMcpToolsForProfile",
           "signature": "(availableTools: readonly string[], profile: Exclude<PmMcpToolProfile, \"custom\">) => string[] | calls: (availableTools: readonly string[], profile: Exclude<PmMcpToolProfile, \"custom\">) => string[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "listPmRequiredArgumentRefusalContracts",
+          "signature": "(contracts?: readonly PmCommandPositionalContract[]) => PmRequiredArgumentRefusalContract[] | calls: (contracts?: readonly PmCommandPositionalContract[]) => PmRequiredArgumentRefusalContract[]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "listPmSubcommandRefusalContracts",
+          "signature": "(contracts?: readonly PmCommandPositionalContract[]) => PmSubcommandRefusalContract[] | calls: (contracts?: readonly PmCommandPositionalContract[]) => PmSubcommandRefusalContract[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -8326,6 +8591,12 @@
           "name": "MERGE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "MERGE_SUBCOMMAND_VALUES",
+          "signature": "readonly [\"install\", \"reconcile\", \"report\", \"driver\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8464,6 +8735,12 @@
           "name": "mergeSortedWarnings",
           "signature": "(...warningGroups: Array<string[] | undefined>) => string[] | calls: (...warningGroups: Array<string[] | undefined>) => string[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "MergeSubcommand",
+          "signature": "export type MergeSubcommand = (typeof MERGE_SUBCOMMAND_VALUES)[number];"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8614,6 +8891,12 @@
           "name": "NextResult",
           "signature": "export interface NextResult { output_default: \"toon\"; now: string; recommended: NextRecommendation | null; ready: NextActionableItem[]; decision_needed: NextActionableItem[]; blocked: NextActionableItem[]; held_by_others: Array<{ id: string; assignee: string; }>; summary: NextSummary; filters: { type: string | null; tag: string | null; priority: string | number | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; parent: string | null; limit: number; blocked_limit: number; ready_only: boolean; include_decisions: boolean; token_budget: number; }; suggestions?: string[]; warnings?: string[]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; truncation?: { decision_needed_total?: number; held_by_others_total?: number; }; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "normalizeAgentProvenanceAdapterValue",
+          "signature": "(dimension: \"effort\" | \"model\", value: string) => NormalizedAgentProvenanceAdapterValue | calls: (dimension: \"model\" | \"effort\", value: string) => NormalizedAgentProvenanceAdapterValue"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8638,6 +8921,18 @@
           "name": "normalizeBootstrapInvocation",
           "signature": "(argv: string[]) => BootstrapInvocationNormalizationResult | calls: (argv: string[]) => BootstrapInvocationNormalizationResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "normalizeBulkIdsValue",
+          "signature": "(value: BulkIdsValue) => string | undefined | calls: (value: BulkIdsValue) => string | undefined"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "NormalizedAgentProvenanceAdapterValue",
+          "signature": "export interface NormalizedAgentProvenanceAdapterValue { raw: string; normalized: string; vocabulary: \"v1\"; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -9088,6 +9383,12 @@
           "name": "parseBootstrapTypeValue",
           "signature": "(argv: string[]) => string | undefined | calls: (argv: string[]) => string | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "parseBulkIdsText",
+          "signature": "(raw: string) => string[] | calls: (raw: string) => string[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -9238,6 +9539,12 @@
           "name": "parseLinkedTestStringList",
           "signature": "(raw: string | undefined) => string[] | undefined | calls: (raw: string | undefined) => string[] | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "parseLinkedTestWorkspaceContextMode",
+          "signature": "(raw: string | undefined, optionName: string) => LinkedTest[\"workspace_context_mode\"] | undefined | calls: (raw: string | undefined, optionName: string) => LinkedTest[\"workspace_context_mode\"] | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -9454,6 +9761,12 @@
           "name": "PLAN_TEMPLATE_NAMES",
           "signature": "readonly [\"bug-investigation\", \"feature-implementation\", \"refactoring-sprint\"]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "planAgentIdentityVocabularyMutation",
+          "signature": "(current: AgentIdentityVocabulary | undefined, input: AgentIdentityVocabularyMutationInput) => AgentIdentityVocabularyMutationPlan | calls: (current: AgentIdentityVocabulary | undefined, input: AgentIdentityVocabularyMutationInput) => AgentIdentityVocabularyMutationPlan"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -9946,6 +10259,24 @@
           "name": "PM_RECOVERY_REFERENCE_KINDS",
           "signature": "readonly [\"suggested_retry\", \"candidate_command\", \"example\", \"next_step\", \"migration_hint\", \"restore_with\"]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE",
+          "signature": "readonly [\"bulk_ids_input_empty\", \"bulk_ids_input_missing_path\", \"bulk_ids_input_unreadable\", \"invalid_argument_value\", \"missing_lifecycle_target\", \"missing_required_argument\", \"projection_options_mutually_exclusive\", \"tracker_not_initialized\", \"tracker_root_missing\", \"tracker_root_not_directory\", \"tracker_root_unreadable\", \"unknown_context_intent\", \"unknown_field_projection\", \"unknown_option\", \"unknown_subcommand\"]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE",
+          "signature": "16"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_REPRODUCIBLE_PROCESS_ENV",
+          "signature": "Readonly<{ readonly clock: \"PM_CLOCK\"; readonly tickMs: \"PM_CLOCK_TICK_MS\"; readonly seed: \"PM_SEED\"; }>"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -9980,7 +10311,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.8.0\""
+          "signature": "\"4.9.0\""
         },
         {
           "classification": "contract_data",
@@ -10040,7 +10371,7 @@
           "classification": "contract_data",
           "kind": "type",
           "name": "PmBulkMutationFilterOptions",
-          "signature": "export type PmBulkMutationFilterOptions = OptionsFromContracts<typeof TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE>;"
+          "signature": "export type PmBulkMutationFilterOptions = Omit<OptionsFromContracts<typeof TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE>, \"ids\"> & { ids?: string | number | readonly (string | number)[]; };"
         },
         {
           "classification": "supported",
@@ -10166,7 +10497,7 @@
           "classification": "advanced_export",
           "kind": "type",
           "name": "PmCommandCapabilityFamily",
-          "signature": "export type PmCommandCapabilityFamily = \"workspace\" | \"intake\" | \"context\" | \"lifecycle\" | \"evidence\" | \"graph\" | \"quality\" | \"automation\" | \"extensions\" | \"internal\";"
+          "signature": "export type PmCommandCapabilityFamily = ExtensionCommandCapabilityFamily;"
         },
         {
           "classification": "contract_data",
@@ -10504,6 +10835,36 @@
           "name": "PmFlagValueKind",
           "signature": "export type PmFlagValueKind = \"boolean\" | \"string\" | \"number\" | \"list\";"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmGrammarRefusalClosureReport",
+          "signature": "export interface PmGrammarRefusalClosureReport { ok: boolean; probe_count: number; closed_probe_count: number; findings: PmGrammarRefusalFinding[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmGrammarRefusalContract",
+          "signature": "export interface PmGrammarRefusalContract { probe_id: string; command: string; refusal_args: readonly string[]; recovery_args: readonly string[]; error_code: \"invalid_argument_value\" | \"missing_lifecycle_target\" | \"missing_required_argument\" | \"unknown_subcommand\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmGrammarRefusalFinding",
+          "signature": "export interface PmGrammarRefusalFinding { code: PmGrammarRefusalFindingCode; probe_id: string; detail: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "PmGrammarRefusalFindingCode",
+          "signature": "export type PmGrammarRefusalFindingCode = \"refusal_allowed_values_mismatch\" | \"refusal_error_code_mismatch\" | \"refusal_exit_code_mismatch\" | \"refusal_mutated_state\" | \"refusal_probe_missing\" | \"refusal_recovery_failed\" | \"unexpected_refusal_probe\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmGrammarRefusalObservation",
+          "signature": "export interface PmGrammarRefusalObservation { probe_id: string; error_code: string; exit_code: number; allowed_values: readonly string[]; recovery_succeeded: boolean; refusal_mutated_state: boolean; mutated_paths?: readonly string[]; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -10702,6 +11063,18 @@
           "name": "PmReadOutputReceipt",
           "signature": "export interface PmReadOutputReceipt { contract_version: 1; command: PmReadOutputSurface; requested_dimensions: PmReadOutputDimension[]; budget_source?: \"default\"; budget_tokens?: number; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; canonical_options_used?: string[]; legacy_aliases_used: string[]; migration_hints: string[]; estimated_tokens: number; within_budget: boolean; strings_compacted: boolean; rows_compacted: boolean; compacted_row_paths?: string[]; result_omitted: boolean; omitted_result_estimated_tokens?: number; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputRecoveryBudget",
+          "signature": "export interface PmReadOutputRecoveryBudget { output_budget: number | \"unbounded\"; recovery_budget_multiplier: number | null; rule_version: \"v1\"; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputRecoveryBudgetInput",
+          "signature": "export interface PmReadOutputRecoveryBudgetInput { effective_budget_tokens: number; measured_result_tokens: number; }"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -10754,7 +11127,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputTruncationDisclosure",
-          "signature": "export interface PmReadOutputTruncationDisclosure { reason: \"output_budget_reached\"; budget_source: PmReadOutputDimensionSource | \"session\"; budget_tokens: number; overridden_dimensions: PmReadOutputDimension[]; compacted_row_paths: string[]; continuation_cursor_rebased: boolean; continuation_available: boolean; recovery_budget_multiplier: 1; continuations: PmReadOutputContinuation[]; restore_with: string; recovery: { cursor: string; cli: \"--output-cursor\"; sdk: \"outputCursor\"; mcp: \"outputCursor\"; } | { cli: string; sdk: { outputBudget: number; }; mcp: { outputBudget: number; }; }; }"
+          "signature": "export interface PmReadOutputTruncationDisclosure { reason: \"output_budget_reached\"; budget_source: PmReadOutputDimensionSource | \"session\"; budget_tokens: number; overridden_dimensions: PmReadOutputDimension[]; compacted_row_paths: string[]; continuation_cursor_rebased: boolean; continuation_available: boolean; recovery_budget_multiplier: number | null; continuations: PmReadOutputContinuation[]; restore_with: string; recovery: { cursor: string; cli: \"--output-cursor\"; sdk: \"outputCursor\"; mcp: \"outputCursor\"; } | { cli: string; sdk: { outputBudget: number | \"unbounded\"; }; mcp: { outputBudget: number | \"unbounded\"; }; }; }"
         },
         {
           "classification": "advanced_export",
@@ -10834,6 +11207,18 @@
           "name": "PmRecoveryReferenceSemantics",
           "signature": "export type PmRecoveryReferenceSemantics = \"recovery\" | \"replacement\" | \"behavior_preserving\";"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmRefusalClosureCensusReport",
+          "signature": "export interface PmRefusalClosureCensusReport { ok: boolean; catalog_error_code_count: number; executable_error_code_count: number; uncovered_error_code_count: number; coverage_fraction: number; closed_domain_probe_count: number; grammar_probe_count: number; uncovered_error_codes: string[]; rows: PmRefusalClosureCensusRow[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmRefusalClosureCensusRow",
+          "signature": "export interface PmRefusalClosureCensusRow { code: string; canonical_code: string; disposition: \"executable\" | \"uncovered\"; evidence_kinds: PmRefusalEvidenceKind[]; probe_ids: string[]; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -10852,6 +11237,12 @@
           "name": "PmRefusalClosureReport",
           "signature": "export interface PmRefusalClosureReport { ok: boolean; probe_count: number; closed_probe_count: number; closure_fraction: number; findings: readonly PmRefusalClosureFinding[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "PmRefusalEvidenceKind",
+          "signature": "export type PmRefusalEvidenceKind = \"owned_state\" | \"closed_domain\" | \"grammar\";"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -10876,6 +11267,12 @@
           "name": "PmRefusalStateContract",
           "signature": "export interface PmRefusalStateContract { state: string; probe_id: string; entrypoints: string[]; expected_exit_class: PmErrorCodeClass; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmRequiredArgumentRefusalContract",
+          "signature": "export interface PmRequiredArgumentRefusalContract extends PmGrammarRefusalContract { missing_argument: string; missing_argument_index: number; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -10892,7 +11289,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmSettings",
-          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
+          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; allow_untrusted_linked_tests: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmSubcommandRefusalContract",
+          "signature": "export interface PmSubcommandRefusalContract extends PmGrammarRefusalContract { rejected_value: string; allowed_values: readonly string[]; }"
         },
         {
           "classification": "contract_data",
@@ -11020,6 +11423,18 @@
           "name": "prepareSimilarityText",
           "signature": "(value: string) => PreparedSimilarityText | calls: (value: string) => PreparedSimilarityText"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "preserveMutationStdinTokenFields",
+          "signature": "<T extends object>(options: T, fields: readonly PropertyKey[]) => T | calls: <T extends object>(options: T, fields: readonly PropertyKey[]) => T"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "preserveMutationStdinTokenLiterals",
+          "signature": "<T extends object>(options: T) => T | calls: <T extends object>(options: T) => T"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -11848,6 +12263,12 @@
           "name": "refreshSearchArtifactsForMutation",
           "signature": "(pmRoot: string, itemIds: string[], options?: RefreshSearchArtifactsForMutationOptions) => Promise<SearchMutationArtifactRefreshResult> | calls: (pmRoot: string, itemIds: string[], options?: RefreshSearchArtifactsForMutationOptions) => Promise<SearchMutationArtifactRefreshResult>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "registerAgentProvenanceAdapters",
+          "signature": "(adapters: readonly AgentProvenanceAdapter[]) => () => void | calls: (adapters: readonly AgentProvenanceAdapter[]) => () => void"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -11882,7 +12303,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "RegisteredExtensionCommandDefinition",
-          "signature": "export interface RegisteredExtensionCommandDefinition { layer: ExtensionLayer; name: string; source_package?: string; command: string; action: string; description?: string; intent?: string; examples: string[]; failure_hints: string[]; arguments: ExtensionCommandArgumentDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface RegisteredExtensionCommandDefinition { layer: ExtensionLayer; name: string; source_package?: string; command: string; action: string; description?: string; intent?: string; examples: string[]; failure_hints: string[]; arguments: ExtensionCommandArgumentDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; family?: ExtensionCommandCapabilityFamily; }"
         },
         {
           "classification": "supported",
@@ -12742,6 +13163,12 @@
           "name": "renderPmFlagLexiconMarkdown",
           "signature": "() => string | calls: () => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "renderPmRefusalClosureCensusMarkdown",
+          "signature": "(report: PmRefusalClosureCensusReport) => string | calls: (report: PmRefusalClosureCensusReport) => string"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12790,6 +13217,24 @@
           "name": "replayToItemDocument",
           "signature": "(document: ReplayDocument) => ItemDocument | calls: (document: ReplayDocument) => ItemDocument"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ReproducibleExecutionSettings",
+          "signature": "export interface ReproducibleExecutionSettings { seed: string; clock: string; tickMs: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ReproducibleProcessEnvironment",
+          "signature": "export type ReproducibleProcessEnvironment = Readonly<Record<string, string | undefined>>;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ReproducibleProcessRunner",
+          "signature": "export type ReproducibleProcessRunner = ReproducibleExecutionRunner;"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12886,6 +13331,12 @@
           "name": "resolveClaimPrincipal",
           "signature": "(author: string) => string | calls: (author: string) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveCliBulkIdsInput",
+          "signature": "(value: string | undefined, optionName?: string, readers?: BulkIdsInputReaders) => Promise<string | undefined> | calls: (value: string | undefined, optionName?: string, readers?: BulkIdsInputReaders) => Promise<string | undefined>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -13096,6 +13547,30 @@
           "name": "resolveLinkedTestFailureExitCode",
           "signature": "(execution: Pick<LinkedTestExecutionResult, \"exitCode\" | \"maxBufferExceeded\" | \"timedOut\">) => number | calls: (execution: Pick<LinkedTestExecutionResult, \"exitCode\" | \"timedOut\" | \"maxBufferExceeded\">) => number"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveLinkedTestSourceRef",
+          "signature": "(cwd?: string) => Promise<string | undefined> | calls: (cwd?: string) => Promise<string | undefined>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveLinkedTestSourceWorkspaceRoot",
+          "signature": "(cwd?: string) => string | calls: (cwd?: string) => string"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveLinkedTestTrust",
+          "signature": "(pmRoot: string, test: LinkedTest, currentSourceRef?: string) => Promise<LinkedTestTrustDecision> | calls: (pmRoot: string, test: LinkedTest, currentSourceRef?: string) => Promise<LinkedTestTrustDecision>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveLinkedTestTrustBatch",
+          "signature": "(pmRoot: string, tests: LinkedTest[], currentSourceRef?: string) => Promise<LinkedTestTrustDecision[]> | calls: (pmRoot: string, tests: LinkedTest[], currentSourceRef?: string) => Promise<LinkedTestTrustDecision[]>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -13264,6 +13739,12 @@
           "name": "resolveReadOutputEncoding",
           "signature": "(command: string, options: Record<string, unknown>) => \"json\" | \"toon\" | undefined | calls: (command: string, options: Record<string, unknown>) => \"json\" | \"toon\" | undefined"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolveReadOutputRecoveryBudget",
+          "signature": "(input: PmReadOutputRecoveryBudgetInput) => PmReadOutputRecoveryBudget | calls: (input: PmReadOutputRecoveryBudgetInput) => PmReadOutputRecoveryBudget"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -13294,6 +13775,12 @@
           "name": "resolveRegisteredVectorStoreAdapter",
           "signature": "(registrations: ExtensionRegistrationRegistry | null, configuredAdapter: string | undefined) => RegisteredExtensionVectorStoreAdapter | null | calls: (registrations: ExtensionRegistrationRegistry | null, configuredAdapter: string | undefined) => RegisteredExtensionVectorStoreAdapter | null"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveReproducibleProcessEnvironment",
+          "signature": "(environment: ReproducibleProcessEnvironment) => ReproducibleExecutionSettings | undefined | calls: (environment: ReproducibleProcessEnvironment) => ReproducibleExecutionSettings | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -14320,6 +14807,12 @@
           "name": "runWithHarnessDetectionSignals",
           "signature": "<T>(signals: HarnessDetectionSignals, callback: () => T) => T | calls: <T>(signals: HarnessDetectionSignals, callback: () => T) => T"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "runWithReproducibleProcessEnvironment",
+          "signature": "<T>(environment: ReproducibleProcessEnvironment, operation: () => Promise<T>) => Promise<T> | calls: <T>(environment: ReproducibleProcessEnvironment, operation: () => Promise<T>) => Promise<T>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -14746,6 +15239,12 @@
           "name": "scoreItemSimilarity",
           "signature": "(leftTitle: string, rightTitle: string) => ItemSimilarityScore | calls: (leftTitle: string, rightTitle: string) => ItemSimilarityScore"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "scorePmGrammarRefusalClosure",
+          "signature": "(contracts: readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[], observations: readonly PmGrammarRefusalObservation[]) => PmGrammarRefusalClosureReport | calls: (contracts: readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[], observations: readonly PmGrammarRefusalObservation[]) => PmGrammarRefusalClosureReport"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -15166,6 +15665,18 @@
           "name": "shouldPersistDurableGraphCache",
           "signature": "(itemCount: number, envelopeExists: boolean) => boolean | calls: (itemCount: number, envelopeExists: boolean) => boolean"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "shouldResolveMutationStdinTokenField",
+          "signature": "(options: object, field: PropertyKey) => boolean | calls: (options: object, field: PropertyKey) => boolean"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "shouldResolveMutationStdinTokens",
+          "signature": "(options: object) => boolean | calls: (options: object) => boolean"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -15460,6 +15971,12 @@
           "name": "SubscribeMutationEventsOptions",
           "signature": "export interface SubscribeMutationEventsOptions extends ListMutationEventsOptions { intervalMs?: number; signal?: AbortSignal; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "summarizeAgentIdentityVocabulary",
+          "signature": "(vocabulary: AgentIdentityVocabulary | undefined) => AgentIdentityVocabularySummary | calls: (vocabulary: AgentIdentityVocabulary | undefined) => AgentIdentityVocabularySummary"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -15704,7 +16221,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestAllCommandOptions",
-          "signature": "export interface TestAllCommandOptions { author?: string; status?: string; limit?: string; offset?: string; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; }"
+          "signature": "export interface TestAllCommandOptions { author?: string; status?: string; limit?: string; offset?: string; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; workspaceContext?: string; overrideLinkedWorkspaceContext?: boolean; allowUntrustedLinkedTests?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -15722,7 +16239,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestCommandOptions",
-          "signature": "export interface TestCommandOptions { add?: string[]; addJson?: string[]; remove?: string[]; removeIndex?: Array<string | number>; list?: boolean; run?: boolean; match?: string; onlyIndex?: string | number; onlyLast?: boolean; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; author?: string; message?: string; force?: boolean; measure?: string[]; metricBelow?: string; metricDiff?: string; }"
+          "signature": "export interface TestCommandOptions { add?: string[]; addJson?: string[]; remove?: string[]; removeIndex?: Array<string | number>; list?: boolean; run?: boolean; match?: string; onlyIndex?: string | number; onlyLast?: boolean; timeout?: string; progress?: boolean; envSet?: string[]; envClear?: string[]; sharedHostSafe?: boolean; pmContext?: string; overrideLinkedPmContext?: boolean; workspaceContext?: string; overrideLinkedWorkspaceContext?: boolean; allowUntrustedLinkedTests?: boolean; acknowledgeLinkedTests?: boolean; failOnContextMismatch?: boolean; failOnSkipped?: boolean; failOnEmptyTestRun?: boolean; requireAssertionsForPm?: boolean; checkContext?: boolean; autoPmContext?: boolean; author?: string; message?: string; force?: boolean; measure?: string[]; metricBelow?: string; metricDiff?: string; }"
         },
         {
           "classification": "supported",
@@ -15746,7 +16263,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestRunResult",
-          "signature": "export interface TestRunResult { command?: string; path?: string; status: \"passed\" | \"failed\" | \"skipped\"; exit_code?: number; failure_category?: LinkedTestFailureCategory; execution_context?: { requested_pm_context_mode: LinkedTestPmContextMode; pm_context_mode: LinkedTestPmContextMode; auto_pm_context_applied: boolean; is_pm_command: boolean; is_pm_tracker_read_command: boolean; source_project_pm_path: string; sandbox_project_pm_path: string; source_global_pm_path: string; sandbox_global_pm_path: string; source_project_item_count: number; sandbox_project_item_count: number; source_global_item_count: number; sandbox_global_item_count: number; mismatch_detected: boolean; project_extensions_seeded: boolean; global_extensions_seeded: boolean; }; stdout?: string; stderr?: string; error?: string; }"
+          "signature": "export interface TestRunResult { command?: string; path?: string; status: \"passed\" | \"failed\" | \"skipped\"; exit_code?: number; failure_category?: LinkedTestFailureCategory; execution_context?: { requested_pm_context_mode: LinkedTestPmContextMode; pm_context_mode: LinkedTestPmContextMode; auto_pm_context_applied: boolean; is_pm_command: boolean; is_pm_tracker_read_command: boolean; source_project_pm_path: string; sandbox_project_pm_path: string; source_global_pm_path: string; sandbox_global_pm_path: string; source_project_item_count: number; sandbox_project_item_count: number; source_global_item_count: number; sandbox_global_item_count: number; mismatch_detected: boolean; project_extensions_seeded: boolean; global_extensions_seeded: boolean; requested_workspace_context_mode: LinkedTestWorkspaceContextMode; workspace_context_mode: LinkedTestWorkspaceContextMode; working_directory: string; source_workspace_root: string; trust: LinkedTestTrustDecision; }; stdout?: string; stderr?: string; error?: string; }"
         },
         {
           "classification": "advanced_export",
@@ -16066,6 +16583,12 @@
           "name": "toReplayDocument",
           "signature": "(document: ItemDocument) => ReplayDocument | calls: (document: ItemDocument) => ReplayDocument"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "transferMutationStdinTokenPolicy",
+          "signature": "<T extends object>(source: object, target: T) => T | calls: <T extends object>(source: object, target: T) => T"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -16480,6 +17003,18 @@
           "name": "verifyPmRecoveryReferences",
           "signature": "(obligations: readonly PmRecoveryReferenceObligation[], observations: readonly PmRecoveryReferenceObservation[]) => PmRecoveryReferenceReport | calls: (obligations: readonly PmRecoveryReferenceObligation[], observations: readonly PmRecoveryReferenceObservation[]) => PmRecoveryReferenceReport"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "verifyPmRefusalClosureIdentityRatchet",
+          "signature": "(report: PmRefusalClosureCensusReport, requiredCanonicalCodes?: readonly string[]) => { ok: boolean; required_canonical_codes: string[]; missing_required_canonical_codes: string[]; } | calls: (report: PmRefusalClosureCensusReport, requiredCanonicalCodes?: readonly string[]) => { ok: boolean; required_canonical_codes: string[]; missing_required_canonical_codes: string[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "verifyPmRefusalClosureRatchet",
+          "signature": "(report: PmRefusalClosureCensusReport, baseline?: number) => { ok: boolean; baseline: number; actual: number; } | calls: (report: PmRefusalClosureCensusReport, baseline?: number) => { ok: boolean; baseline: number; actual: number; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -16556,7 +17091,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "WorkspaceExtensionCommandContract",
-          "signature": "export interface WorkspaceExtensionCommandContract { command: string; action: string; arguments: Array<{ name: string; required: boolean; variadic: boolean; description?: string; }>; description?: string; tier: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface WorkspaceExtensionCommandContract { command: string; action: string; arguments: Array<{ name: string; required: boolean; variadic: boolean; description?: string; }>; description?: string; tier: \"core\" | \"standard\" | \"full\" | \"internal\"; family: PmCommandCapabilityFamily; }"
         },
         {
           "classification": "advanced_export",
@@ -16940,7 +17475,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommandDefinition",
-          "signature": "export interface CommandDefinition { name: string; run?: CommandHandler; handler?: CommandHandler; action?: string; description?: string; intent?: string; examples?: string[]; failure_hints?: string[]; arguments?: ExtensionCommandArgumentDefinition[]; flags?: FlagDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface CommandDefinition { name: string; run?: CommandHandler; handler?: CommandHandler; action?: string; description?: string; intent?: string; examples?: string[]; failure_hints?: string[]; arguments?: ExtensionCommandArgumentDefinition[]; flags?: FlagDefinition[]; tier?: \"core\" | \"standard\" | \"full\" | \"internal\"; family?: ExtensionCommandCapabilityFamily; }"
         },
         {
           "classification": "supported",
@@ -18374,7 +18909,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "CliFlagInvocationContract",
-          "signature": "export interface CliFlagInvocationContract extends CliFlagContract { description: string; takes_value: boolean; value_required: boolean; value_type: \"string\" | \"number\" | \"boolean\"; required: boolean; repeatable: boolean; input_sources: CliFlagInputSource[]; stdin_token?: \"-\"; }"
+          "signature": "export interface CliFlagInvocationContract extends CliFlagContract { description: string; takes_value: boolean; value_required: boolean; value_type: \"string\" | \"number\" | \"boolean\"; required: boolean; repeatable: boolean; input_sources: CliFlagInputSource[]; stdin_token?: \"-\"; file_token_prefix?: \"@\"; }"
         },
         {
           "classification": "contract_data",
@@ -18964,6 +19499,18 @@
           "name": "MERGE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "MERGE_SUBCOMMAND_VALUES",
+          "signature": "readonly [\"install\", \"reconcile\", \"report\", \"driver\"]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "MergeSubcommand",
+          "signature": "export type MergeSubcommand = (typeof MERGE_SUBCOMMAND_VALUES)[number];"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -19298,7 +19845,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.8.0\""
+          "signature": "\"4.9.0\""
         },
         {
           "classification": "contract_data",
@@ -19334,7 +19881,7 @@
           "classification": "contract_data",
           "kind": "type",
           "name": "PmBulkMutationFilterOptions",
-          "signature": "export type PmBulkMutationFilterOptions = OptionsFromContracts<typeof TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE>;"
+          "signature": "export type PmBulkMutationFilterOptions = Omit<OptionsFromContracts<typeof TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE>, \"ids\"> & { ids?: string | number | readonly (string | number)[]; };"
         },
         {
           "classification": "contract_data",
@@ -19768,6 +20315,18 @@
           "name": "PmReadOutputReceipt",
           "signature": "export interface PmReadOutputReceipt { contract_version: 1; command: PmReadOutputSurface; requested_dimensions: PmReadOutputDimension[]; budget_source?: \"default\"; budget_tokens?: number; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; canonical_options_used?: string[]; legacy_aliases_used: string[]; migration_hints: string[]; estimated_tokens: number; within_budget: boolean; strings_compacted: boolean; rows_compacted: boolean; compacted_row_paths?: string[]; result_omitted: boolean; omitted_result_estimated_tokens?: number; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputRecoveryBudget",
+          "signature": "export interface PmReadOutputRecoveryBudget { output_budget: number | \"unbounded\"; recovery_budget_multiplier: number | null; rule_version: \"v1\"; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputRecoveryBudgetInput",
+          "signature": "export interface PmReadOutputRecoveryBudgetInput { effective_budget_tokens: number; measured_result_tokens: number; }"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -19808,7 +20367,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputTruncationDisclosure",
-          "signature": "export interface PmReadOutputTruncationDisclosure { reason: \"output_budget_reached\"; budget_source: PmReadOutputDimensionSource | \"session\"; budget_tokens: number; overridden_dimensions: PmReadOutputDimension[]; compacted_row_paths: string[]; continuation_cursor_rebased: boolean; continuation_available: boolean; recovery_budget_multiplier: 1; continuations: PmReadOutputContinuation[]; restore_with: string; recovery: { cursor: string; cli: \"--output-cursor\"; sdk: \"outputCursor\"; mcp: \"outputCursor\"; } | { cli: string; sdk: { outputBudget: number; }; mcp: { outputBudget: number; }; }; }"
+          "signature": "export interface PmReadOutputTruncationDisclosure { reason: \"output_budget_reached\"; budget_source: PmReadOutputDimensionSource | \"session\"; budget_tokens: number; overridden_dimensions: PmReadOutputDimension[]; compacted_row_paths: string[]; continuation_cursor_rebased: boolean; continuation_available: boolean; recovery_budget_multiplier: number | null; continuations: PmReadOutputContinuation[]; restore_with: string; recovery: { cursor: string; cli: \"--output-cursor\"; sdk: \"outputCursor\"; mcp: \"outputCursor\"; } | { cli: string; sdk: { outputBudget: number | \"unbounded\"; }; mcp: { outputBudget: number | \"unbounded\"; }; }; }"
         },
         {
           "classification": "contract_data",
@@ -20092,6 +20651,12 @@
           "name": "resolveReadOutputEncoding",
           "signature": "(command: string, options: Record<string, unknown>) => \"json\" | \"toon\" | undefined | calls: (command: string, options: Record<string, unknown>) => \"json\" | \"toon\" | undefined"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "resolveReadOutputRecoveryBudget",
+          "signature": "(input: PmReadOutputRecoveryBudgetInput) => PmReadOutputRecoveryBudget | calls: (input: PmReadOutputRecoveryBudgetInput) => PmReadOutputRecoveryBudget"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -20494,6 +21059,12 @@
           "name": "AgentProvenanceAbsenceReason",
           "signature": "export type AgentProvenanceAbsenceReason = \"harness_unavailable\" | \"resolver_failed\" | \"resolver_not_configured\" | \"probes_disabled\" | \"invalid_value\";"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentProvenanceAdapter",
+          "signature": "export interface AgentProvenanceAdapter { contract_version: 1; adapter_version: string; priority: number; harness: string; descriptor: HarnessSignalDescriptor; supported_dimensions: readonly string[]; native_sources: readonly (\"environment\" | \"argv\" | \"mcp_client\" | \"session_file\")[]; probe_policy: { max_bytes: number; max_lines: number; network_access: false; subprocess_access: false; }; normalization: { model_family: \"v1\"; effort: \"v1\"; preserve_raw: true; }; confidence: \"high\" | \"medium\" | \"low\"; waivers?: Readonly<Record<string, string>>; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -20644,6 +21215,12 @@
           "name": "boundAgentEpisodeIdentity",
           "signature": "(value: unknown, strict: boolean) => AgentEpisodeIdentity | undefined | calls: (value: unknown, strict: boolean) => AgentEpisodeIdentity | undefined"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "BUILTIN_AGENT_PROVENANCE_ADAPTERS",
+          "signature": "readonly AgentProvenanceAdapter[]"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -21100,6 +21677,12 @@
           "name": "list",
           "signature": "<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options, clientOptions?: PmClientOptions) => ReadPromise<ListResult, Options> | calls: <Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options, clientOptions?: PmClientOptions) => ReadPromise<ListResult, Options>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "listAgentProvenanceAdapters",
+          "signature": "() => readonly AgentProvenanceAdapter[] | calls: () => readonly AgentProvenanceAdapter[]"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -21136,6 +21719,18 @@
           "name": "NextResult",
           "signature": "export interface NextResult { output_default: \"toon\"; now: string; recommended: NextRecommendation | null; ready: NextActionableItem[]; decision_needed: NextActionableItem[]; blocked: NextActionableItem[]; held_by_others: Array<{ id: string; assignee: string; }>; summary: NextSummary; filters: { type: string | null; tag: string | null; priority: string | number | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; parent: string | null; limit: number; blocked_limit: number; ready_only: boolean; include_decisions: boolean; token_budget: number; }; suggestions?: string[]; warnings?: string[]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; truncation?: { decision_needed_total?: number; held_by_others_total?: number; }; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "normalizeAgentProvenanceAdapterValue",
+          "signature": "(dimension: \"effort\" | \"model\", value: string) => NormalizedAgentProvenanceAdapterValue | calls: (dimension: \"model\" | \"effort\", value: string) => NormalizedAgentProvenanceAdapterValue"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "NormalizedAgentProvenanceAdapterValue",
+          "signature": "export interface NormalizedAgentProvenanceAdapterValue { raw: string; normalized: string; vocabulary: \"v1\"; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -21356,7 +21951,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmSettings",
-          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
+          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; allow_untrusted_linked_tests: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
         },
         {
           "classification": "supported",
@@ -21400,6 +21995,12 @@
           "name": "RecurrenceReceipt",
           "signature": "export interface RecurrenceReceipt { reason: string; from_status: string; to_status: string; previous_terminal: PreviousTerminalEvidence; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "registerAgentProvenanceAdapters",
+          "signature": "(adapters: readonly AgentProvenanceAdapter[]) => () => void | calls: (adapters: readonly AgentProvenanceAdapter[]) => () => void"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -26684,7 +27285,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ConfigResult",
-          "signature": "export interface ConfigResult { scope: ConfigScope; key?: ConfigKey | string; criteria?: string[]; format?: ItemFormat; policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string; nested_setting?: NestedSettingResultValue; nested_settings?: NestedSettingResultValue[]; keys?: ConfigKeyDescriptor[]; values?: Record<ConfigKey, ConfigValue>; count?: number; context_settings?: ContextConfigValue; has_explicit_item_format?: boolean; migration?: { target_format: ItemFormat; scanned: number; migrated: string[]; removed: string[]; warnings: string[]; }; settings_path: string; changed: boolean; warnings?: string[]; }"
+          "signature": "export interface ConfigResult { scope: ConfigScope; key?: ConfigKey | string; criteria?: string[]; format?: ItemFormat; policy?: HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | string; nested_setting?: NestedSettingResultValue; nested_settings?: NestedSettingResultValue[]; keys?: ConfigKeyDescriptor[]; values?: Record<ConfigKey, ConfigValue>; count?: number; context_settings?: ContextConfigValue; identity_vocabulary?: AgentIdentityVocabularySummary; vocabulary_mutation?: AgentIdentityVocabularyMutationPreview; has_explicit_item_format?: boolean; migration?: { target_format: ItemFormat; scanned: number; migrated: string[]; removed: string[]; warnings: string[]; }; settings_path: string; changed: boolean; warnings?: string[]; }"
         },
         {
           "classification": "supported",
@@ -27404,7 +28005,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "LinkedTest",
-          "signature": "export interface LinkedTest { command?: string; path?: string; scope: LinkScope; timeout_seconds?: number; pm_context_mode?: \"schema\" | \"tracker\" | \"auto\"; env_set?: Record<string, string>; env_clear?: string[]; shared_host_safe?: boolean; assert_stdout_contains?: string[]; assert_stdout_regex?: string[]; assert_stderr_contains?: string[]; assert_stderr_regex?: string[]; assert_stdout_min_lines?: number; assert_json_field_equals?: Record<string, string>; assert_json_field_gte?: Record<string, number>; note?: string; }"
+          "signature": "export interface LinkedTest { command?: string; path?: string; scope: LinkScope; timeout_seconds?: number; pm_context_mode?: \"schema\" | \"tracker\" | \"auto\"; workspace_context_mode?: \"source\" | \"isolated\" | \"snapshot\"; provenance?: LinkedTestProvenance; provenance_invalid?: true; env_set?: Record<string, string>; env_clear?: string[]; shared_host_safe?: boolean; assert_stdout_contains?: string[]; assert_stdout_regex?: string[]; assert_stderr_contains?: string[]; assert_stderr_regex?: string[]; assert_stdout_min_lines?: number; assert_json_field_equals?: Record<string, string>; assert_json_field_gte?: Record<string, number>; note?: string; }"
         },
         {
           "classification": "supported",
@@ -28016,7 +28617,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmSettings",
-          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
+          "signature": "export interface PmSettings { version: number; id_prefix: string; ids: { token_length: number; }; author_default: string; agent_identity?: { probes_enabled?: boolean; identity_vocabulary?: { version: number; aliases: Record<string, string>; }; harness_signals: Array<{ harness: string; environment_keys?: string[]; model_environment_keys?: string[]; session_environment_keys?: string[]; provenance_environment_keys?: Record<string, string[]>; provenance_resolvers?: Record<string, \"ai_agent_version\" | \"claude_session_file\">; provenance_unavailable_dimensions?: string[]; argv_markers?: string[]; client_names?: string[]; }>; }; mutation_guard: { require_attributed_author: boolean; secret_guard: \"off\" | \"advise\" | \"block\"; stale_in_progress_hours: number; }; item_format: ItemFormat; locks: { ttl_seconds: number; wait_ms: number; }; checkpoints: { retention_days: number; }; output: { default_format: \"toon\" | \"json\"; }; ux?: { deprecation_hints?: boolean; }; history: { missing_stream: \"auto_create\" | \"strict_error\"; compact_policy: HistoryCompactPolicy; }; validation: { sprint_release_format: SprintReleaseFormatPolicy; parent_reference: ParentReferencePolicy; metadata_profile: ValidateMetadataProfile; metadata_required_fields: ValidateMetadataRequiredField[]; lifecycle_stale_blocker_reason_patterns: string[]; lifecycle_closure_like_blocked_reason_patterns: string[]; lifecycle_closure_like_resolution_patterns: string[]; lifecycle_closure_like_actual_result_patterns: string[]; estimate_defaults_by_type: Record<string, number>; }; governance: GovernanceSettings; workflow: { definition_of_done: string[]; }; testing: { record_results_to_items: boolean; allow_untrusted_linked_tests: boolean; }; telemetry: { enabled: boolean; first_run_prompt_completed: boolean; capture_level: \"minimal\" | \"redacted\" | \"max\"; endpoint: string; installation_id: string; retention_days: number; }; agent_guidance: AgentGuidanceSettings; item_types: { definitions: ItemTypeDefinition[]; }; schema: RuntimeSchemaSettings; extensions: { enabled: string[]; disabled: string[]; policy: ExtensionPolicySettings; }; search: { score_threshold: number; hybrid_semantic_weight: number; max_results: number; embedding_model: string; embedding_corpus_max_characters?: number; embedding_batch_size: number; embedding_timeout_ms: number; scanner_max_batch_retries: number; provider?: string; corpus_fields?: string[]; mutation_refresh_policy: SearchMutationRefreshPolicy; query_expansion: SearchQueryExpansionSettings; rerank: SearchRerankSettings; bm25?: { k1?: number; b?: number; }; tuning?: { title_exact_bonus?: number; title_weight?: number; description_weight?: number; tags_weight?: number; status_weight?: number; body_weight?: number; comments_weight?: number; notes_weight?: number; learnings_weight?: number; dependencies_weight?: number; linked_content_weight?: number; }; }; providers: { openai: { base_url: string; api_key: string; model: string; }; ollama: { base_url: string; model: string; }; }; context: ContextSettings; vector_store: { adapter?: string; collection_name: string; qdrant: { url: string; api_key: string; }; lancedb: { path: string; }; }; }"
         },
         {
           "classification": "supported",
@@ -29198,7 +29799,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "WorkspaceExtensionCommandContract",
-          "signature": "export interface WorkspaceExtensionCommandContract { command: string; action: string; arguments: Array<{ name: string; required: boolean; variadic: boolean; description?: string; }>; description?: string; tier: \"core\" | \"standard\" | \"full\" | \"internal\"; }"
+          "signature": "export interface WorkspaceExtensionCommandContract { command: string; action: string; arguments: Array<{ name: string; required: boolean; variadic: boolean; description?: string; }>; description?: string; tier: \"core\" | \"standard\" | \"full\" | \"internal\"; family: PmCommandCapabilityFamily; }"
         },
         {
           "classification": "advanced_export",
@@ -29823,6 +30424,9 @@
     "body_file_missing_path",
     "body_file_unreadable",
     "budget_exceeded",
+    "bulk_ids_input_empty",
+    "bulk_ids_input_missing_path",
+    "bulk_ids_input_unreadable",
     "bundle_integrity_torn_install",
     "capability_undeclared",
     "capability_unused",
@@ -29942,6 +30546,7 @@
     "invalid_provenance_predicate",
     "invalid_query_cursor",
     "invalid_read_output_session",
+    "invalid_reproducible_process_environment",
     "invalid_workspace_snapshot_target",
     "item_already_active",
     "item_document_invalid",
@@ -29961,6 +30566,8 @@
     "malformed_plan_step_evidence",
     "manifest_capabilities_absent",
     "manifest_unknown_key",
+    "mcp_annotation_file_unavailable",
+    "mcp_stdin_unavailable",
     "merge_conflict_markers_detected",
     "merge_decisions_unreviewed",
     "merge_git_config_unwritable",
@@ -30012,6 +30619,12 @@
     "read_output_cursor_stale",
     "recovery_kind_mismatch",
     "redundant_edge",
+    "refusal_allowed_values_mismatch",
+    "refusal_error_code_mismatch",
+    "refusal_exit_code_mismatch",
+    "refusal_mutated_state",
+    "refusal_probe_missing",
+    "refusal_recovery_failed",
     "reindex_already_running",
     "removed_canonical_spelling",
     "removed_compatibility_spelling",
@@ -30058,6 +30671,7 @@
     "type_duplicate",
     "type_invalid",
     "undeclared_observation",
+    "unexpected_refusal_probe",
     "unknown_command",
     "unknown_context_intent",
     "unknown_error",