@unbrained/pm-cli 2026.8.22 → 2026.8.23

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,54 @@
       ],
       "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."
     }
   ],
   "entrypoints": {
@@ -1174,6 +1222,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 +1396,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 +1456,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 +2482,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",
@@ -2728,6 +2836,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",
@@ -3542,7 +3656,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 +4282,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",
@@ -7822,6 +7942,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 +8000,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 +8014,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 +8092,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 +8260,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 +8488,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 +8632,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 +8788,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 +8818,12 @@
           "name": "normalizeBootstrapInvocation",
           "signature": "(argv: string[]) => BootstrapInvocationNormalizationResult | calls: (argv: string[]) => BootstrapInvocationNormalizationResult"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "NormalizedAgentProvenanceAdapterValue",
+          "signature": "export interface NormalizedAgentProvenanceAdapterValue { raw: string; normalized: string; vocabulary: \"v1\"; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -9238,6 +9424,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 +9646,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 +10144,12 @@
           "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_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 +10184,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.8.0\""
+          "signature": "\"4.9.0\""
         },
         {
           "classification": "contract_data",
@@ -10504,6 +10708,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 +10936,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 +11000,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",
@@ -10876,6 +11122,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 +11144,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",
@@ -11848,6 +12106,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",
@@ -12790,6 +13054,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",
@@ -13096,6 +13378,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 +13570,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 +13606,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 +14638,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 +15070,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",
@@ -15460,6 +15790,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 +16040,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 +16058,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 +16082,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",
@@ -18964,6 +19300,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 +19646,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.8.0\""
+          "signature": "\"4.9.0\""
         },
         {
           "classification": "contract_data",
@@ -19768,6 +20116,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 +20168,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 +20452,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 +20860,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 +21016,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 +21478,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 +21520,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 +21752,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 +21796,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 +27086,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 +27806,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 +28418,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",
@@ -29942,6 +30344,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",
@@ -30012,6 +30415,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 +30467,7 @@
     "type_duplicate",
     "type_invalid",
     "undeclared_observation",
+    "unexpected_refusal_probe",
     "unknown_command",
     "unknown_context_intent",
     "unknown_error",