@unbrained/pm-cli 2026.8.23 → 2026.8.25

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1793,
+    "covered_symbols": 1796,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1794
+    "required_symbols": 1797
   },
   "breaking_acknowledgements": [
     {
@@ -1108,6 +1108,154 @@
       ],
       "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"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ContractsResult",
+        "signature ./sdk:PmReadOutputSurfaceContract",
+        "signature ./sdk/contracts:PmReadOutputSurfaceContract",
+        "signature ./sdk/core:PmReadOutputSurfaceContract",
+        "signature ./sdk/runtime:ContractsResult",
+        "signature ./sdk/runtime:PmReadOutputSurfaceContract"
+      ],
+      "package_version": "2026.8.24",
+      "reason": "Additive optional runtime metadata and public helpers; no accepted input, export, or behavior was removed"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmReadOutputContinuationFingerprintPolicy",
+        "signature ./sdk/contracts:PmReadOutputContinuationFingerprintPolicy"
+      ],
+      "package_version": "2026.8.24",
+      "reason": "Pre-release continuation policy correction binds nonvolatile checks and dynamic telemetry row identity; no accepted input, export, or runtime command was removed"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmReadOutputContinuationFingerprintPolicy",
+        "signature ./sdk/contracts:PmReadOutputContinuationFingerprintPolicy"
+      ],
+      "package_version": "2026.8.24",
+      "reason": "Replace unreleased broad telemetry-detail exclusion with fail-closed field-scoped continuation policy v3 after security review"
+    },
+    {
+      "changes": [
+        "signature ./sdk:MergeDecisionReceipt",
+        "signature ./sdk/merge:MergeDecisionReceipt"
+      ],
+      "package_version": "2026.8.24",
+      "reason": "Add optional merged-field hash proofs to the unreleased receipt-attribution contract so health fails closed on stale or forged evidence."
+    },
+    {
+      "changes": [
+        "signature ./sdk:HistoryRepairCommandOptions",
+        "signature ./sdk:HistoryRepairResult",
+        "signature ./sdk:MergeDecisionReceipt",
+        "signature ./sdk/merge:MergeDecisionReceipt"
+      ],
+      "package_version": "2026.8.24",
+      "reason": "Add fail-closed clone-local receipt proof metadata and apply-boundary validation to the unreleased merge-reconciliation contract."
+    },
+    {
+      "changes": [
+        "signature ./sdk:HistoryRepairAllStreamResult"
+      ],
+      "package_version": "2026.8.24",
+      "reason": "Expose receipt-scoped merge reconciliation proof in history repair stream contracts"
+    },
+    {
+      "changes": [
+        "signature ./sdk:HistoryRepairCommandOptions"
+      ],
+      "package_version": "2026.8.24",
+      "reason": "Expose bounded per-item receipt proof indexing and receipt-scoped reconciliation results"
+    },
+    {
+      "changes": [
+        "signature ./sdk:MergeReceiptProofResult"
+      ],
+      "package_version": "2026.8.24",
+      "reason": "Expose exact receipt-id sets for bounded multi-receipt reconciliation proof"
+    },
+    {
+      "changes": [
+        "signature ./sdk:markMergeReceiptReconciled",
+        "signature ./sdk/merge:markMergeReceiptReconciled"
+      ],
+      "package_version": "2026.8.24",
+      "reason": "Add strict requireExisting settlement mode while preserving default idempotency"
     }
   ],
   "entrypoints": {
@@ -2788,6 +2936,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",
@@ -2878,6 +3032,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",
@@ -3128,7 +3306,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",
@@ -3356,7 +3534,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",
@@ -4028,7 +4206,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ContractsResult",
-          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; grammar_contracts?: { nouns: readonly string[]; shared_verbs: readonly string[]; scope_before_verb: boolean; visible_top_level_ceiling: number; ceiling_raise_requires_pm_item: boolean; positional_shape_budget: number; positional_shape_count: number; positional_action_count: number; positional_action_parents: readonly string[]; positional_signatures?: readonly PmCommandPositionalContract[]; destinations?: readonly PmCommandDestinationContract[]; }; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; assurance_contracts?: { measurement_source_kinds: readonly string[]; gate_triggers: readonly string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[]; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
+          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; grammar_contracts?: { nouns: readonly string[]; shared_verbs: readonly string[]; scope_before_verb: boolean; visible_top_level_ceiling: number; ceiling_raise_requires_pm_item: boolean; positional_shape_budget: number; positional_shape_count: number; positional_action_count: number; positional_action_parents: readonly string[]; positional_signatures?: readonly PmCommandPositionalContract[]; destinations?: readonly PmCommandDestinationContract[]; }; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; output_projection_contracts?: { global_ladder_field: \"output_policy.degradation_ladder\"; global_ladder_scope: \"union_not_per_command\"; discovery: \"pm contracts --command <command> --summary\"; commands?: Array<{ command: string; modes: string[]; }>; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; assurance_contracts?: { measurement_source_kinds: readonly string[]; gate_triggers: readonly string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[]; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
         },
         {
           "classification": "supported",
@@ -7124,7 +7302,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",
@@ -7244,13 +7422,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "HistoryRepairAllStreamResult",
-          "signature": "export interface HistoryRepairAllStreamResult { id: string; outcome: \"repaired\" | \"skipped_clean\" | \"failed\"; entries_rehashed?: number; entries_patch_repaired?: number; reconciled_with_item?: boolean; reconciliation?: HistoryRepairReconciliationReport; warnings?: string[]; error?: string; }"
+          "signature": "export interface HistoryRepairAllStreamResult { id: string; outcome: \"repaired\" | \"skipped_clean\" | \"failed\"; entries_rehashed?: number; entries_patch_repaired?: number; reconciled_with_item?: boolean; reconciliation?: HistoryRepairReconciliationReport; merge_receipt_proof?: MergeReceiptProofResult; warnings?: string[]; error?: string; }"
         },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "HistoryRepairCommandOptions",
-          "signature": "export interface HistoryRepairCommandOptions { dryRun?: boolean; author?: string; message?: string; force?: boolean; auditOperation?: string; auditContext?: Record<string, unknown>; auditContextById?: Record<string, Record<string, unknown>>; forceAuditEntry?: boolean; normalizeProvenance?: boolean; }"
+          "signature": "export interface HistoryRepairCommandOptions { dryRun?: boolean; author?: string; message?: string; force?: boolean; auditOperation?: string; auditContext?: Record<string, unknown>; auditContextById?: Record<string, Record<string, unknown>>; forceAuditEntry?: boolean; normalizeProvenance?: boolean; mergeReceiptProof?: { gitWorkspaceRoot: string | null; receipts: MergeDecisionReceipt[]; }; mergeReceiptProofById?: Record<string, { gitWorkspaceRoot: string | null; receipts: MergeDecisionReceipt[]; }>; }"
         },
         {
           "classification": "advanced_export",
@@ -7268,7 +7446,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "HistoryRepairResult",
-          "signature": "export interface HistoryRepairResult { id: string; dry_run: boolean; changed: boolean; history: { path: string; entries_scanned: number; chain_drift_before: boolean; entries_rehashed: number; entries_patch_repaired: number; converted_replace_to_add: number; skipped_ops: number; reconciled_with_item: boolean; audit_entry_added: boolean; verify_ok: boolean; verify_errors: string[]; item_hash_version_before: number | null; item_hash_version_after: number; version_disposition: \"preserved\" | \"selected_for_ambiguous_stream\"; }; item: { exists: boolean; path: string | null; matched_chain_before: boolean | null; }; provenance_normalization: ProvenanceNormalizationReceipt & { requested: boolean; }; reconciliation?: HistoryRepairReconciliationReport; warnings: string[]; generated_at: string; }"
+          "signature": "export interface HistoryRepairResult { id: string; dry_run: boolean; changed: boolean; history: { path: string; entries_scanned: number; chain_drift_before: boolean; entries_rehashed: number; entries_patch_repaired: number; converted_replace_to_add: number; skipped_ops: number; reconciled_with_item: boolean; audit_entry_added: boolean; verify_ok: boolean; verify_errors: string[]; item_hash_version_before: number | null; item_hash_version_after: number; version_disposition: \"preserved\" | \"selected_for_ambiguous_stream\"; }; item: { exists: boolean; path: string | null; matched_chain_before: boolean | null; }; provenance_normalization: ProvenanceNormalizationReceipt & { requested: boolean; }; reconciliation?: HistoryRepairReconciliationReport; merge_receipt_proof?: MergeReceiptProofResult; warnings: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -8432,7 +8610,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "markMergeReceiptReconciled",
-          "signature": "(cwd: string, receipt: MergeDecisionReceipt) => Promise<void> | calls: (cwd: string, receipt: MergeDecisionReceipt) => Promise<void>"
+          "signature": "(cwd: string, receipt: MergeDecisionReceipt, options?: { requireExisting?: boolean; }) => Promise<void> | calls: (cwd: string, receipt: MergeDecisionReceipt, options?: { requireExisting?: boolean; }) => Promise<void>"
         },
         {
           "classification": "advanced_export",
@@ -8504,7 +8682,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; preferred?: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; preferred?: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; merged_field_hashes?: Record<string, string>; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; evidence_source?: \"clone_local\" | \"durable\"; }"
         },
         {
           "classification": "supported",
@@ -8602,6 +8780,12 @@
           "name": "MergePreferredSide",
           "signature": "export type MergePreferredSide = \"ours\" | \"theirs\";"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "MergeReceiptProofResult",
+          "signature": "export interface MergeReceiptProofResult { trusted: boolean; reason: \"trusted_clone_local_driver_evidence\" | \"git_workspace_unavailable\" | \"item_path_unavailable\" | \"no_item_receipts\" | \"no_receipt_set_proves_snapshot\"; receipt_ids: string[]; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -8818,6 +9002,12 @@
           "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",
@@ -9274,6 +9464,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",
@@ -10084,6 +10280,12 @@
           "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
           "signature": "readonly [\"--output-session\", \"--output-cursor\", \"--output-row-contract\"]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES",
+          "signature": "Readonly<Partial<Record<\"activity\" | \"aggregate\" | \"assurance\" | \"comments-audit\" | \"comments\" | \"context\" | \"contracts\" | \"deps\" | \"docs\" | \"duplicates\" | \"events\" | \"files\" | \"get\" | \"graph\" | \"health\" | \"history\" | \"list\" | \"next\" | \"notes\" | \"package-catalog\" | \"package-manage\" | \"search\" | \"stats\" | \"validate\", PmReadOutputContinuationFingerprintPolicy>>>"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -10144,6 +10346,18 @@
           "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",
@@ -10244,7 +10458,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",
@@ -10370,7 +10584,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",
@@ -10894,6 +11108,12 @@
           "name": "PmReadOutputContinuation",
           "signature": "export interface PmReadOutputContinuation { path: string; cursor: string; retained_rows: number; remaining_rows: number; total_rows: number; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputContinuationFingerprintPolicy",
+          "signature": "export interface PmReadOutputContinuationFingerprintPolicy { version: 3; paths: readonly string[]; ignored_detail_field_names_by_row: Readonly<Record<string, readonly string[]>>; guarantee: \"nonvolatile_snapshot_and_stable_configuration\"; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -10994,7 +11214,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputSurfaceContract",
-          "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; budget_retention_policy: \"ordered_prefix\" | \"verdict_priority\"; }"
+          "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; budget_retention_policy: \"ordered_prefix\" | \"verdict_priority\"; projection_modes?: readonly string[]; }"
         },
         {
           "classification": "contract_data",
@@ -11080,6 +11300,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",
@@ -11098,6 +11330,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",
@@ -11278,6 +11516,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",
@@ -11878,6 +12128,12 @@
           "name": "readOutputBudgetCollections",
           "signature": "(result: Record<string, unknown>) => PmReadOutputRowCollection[] | calls: (result: Record<string, unknown>) => PmReadOutputRowCollection[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "readOutputCollectionFingerprint",
+          "signature": "(path: string, value: unknown[] | Record<string, unknown>, command?: PmReadOutputSurface) => string | calls: (path: string, value: unknown[] | Record<string, unknown>, command?: PmReadOutputSurface) => string"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12146,7 +12402,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",
@@ -13006,6 +13262,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",
@@ -13168,6 +13430,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",
@@ -15496,6 +15764,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",
@@ -16402,6 +16682,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",
@@ -16816,6 +17102,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",
@@ -16892,7 +17190,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",
@@ -17276,7 +17574,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",
@@ -18710,7 +19008,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",
@@ -19588,6 +19886,12 @@
           "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
           "signature": "readonly [\"--output-session\", \"--output-cursor\", \"--output-row-contract\"]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_READ_OUTPUT_CONTINUATION_FINGERPRINT_POLICIES",
+          "signature": "Readonly<Partial<Record<\"activity\" | \"aggregate\" | \"assurance\" | \"comments-audit\" | \"comments\" | \"context\" | \"contracts\" | \"deps\" | \"docs\" | \"duplicates\" | \"events\" | \"files\" | \"get\" | \"graph\" | \"health\" | \"history\" | \"list\" | \"next\" | \"notes\" | \"package-catalog\" | \"package-manage\" | \"search\" | \"stats\" | \"validate\", PmReadOutputContinuationFingerprintPolicy>>>"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -19682,7 +19986,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",
@@ -20074,6 +20378,12 @@
           "name": "PmReadOutputContinuation",
           "signature": "export interface PmReadOutputContinuation { path: string; cursor: string; retained_rows: number; remaining_rows: number; total_rows: number; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmReadOutputContinuationFingerprintPolicy",
+          "signature": "export interface PmReadOutputContinuationFingerprintPolicy { version: 3; paths: readonly string[]; ignored_detail_field_names_by_row: Readonly<Record<string, readonly string[]>>; guarantee: \"nonvolatile_snapshot_and_stable_configuration\"; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -20162,7 +20472,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputSurfaceContract",
-          "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; budget_retention_policy: \"ordered_prefix\" | \"verdict_priority\"; }"
+          "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; budget_retention_policy: \"ordered_prefix\" | \"verdict_priority\"; projection_modes?: readonly string[]; }"
         },
         {
           "classification": "contract_data",
@@ -20314,6 +20624,12 @@
           "name": "readFirstValueFromCommanderOptions",
           "signature": "(options: Record<string, unknown>, contract: CommanderOptionAliasContract) => unknown | calls: (options: Record<string, unknown>, contract: CommanderOptionAliasContract) => unknown"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "readOutputCollectionFingerprint",
+          "signature": "(path: string, value: unknown[] | Record<string, unknown>, command?: PmReadOutputSurface) => string | calls: (path: string, value: unknown[] | Record<string, unknown>, command?: PmReadOutputSurface) => string"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -21746,7 +22062,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputSurfaceContract",
-          "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; budget_retention_policy: \"ordered_prefix\" | \"verdict_priority\"; }"
+          "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; budget_retention_policy: \"ordered_prefix\" | \"verdict_priority\"; projection_modes?: readonly string[]; }"
         },
         {
           "classification": "supported",
@@ -24932,7 +25248,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "markMergeReceiptReconciled",
-          "signature": "(cwd: string, receipt: MergeDecisionReceipt) => Promise<void> | calls: (cwd: string, receipt: MergeDecisionReceipt) => Promise<void>"
+          "signature": "(cwd: string, receipt: MergeDecisionReceipt, options?: { requireExisting?: boolean; }) => Promise<void> | calls: (cwd: string, receipt: MergeDecisionReceipt, options?: { requireExisting?: boolean; }) => Promise<void>"
         },
         {
           "classification": "supported",
@@ -24944,7 +25260,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; preferred?: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; requested_preference?: MergePreferredSide; preferred?: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; merged_field_hashes?: Record<string, string>; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; evidence_source?: \"clone_local\" | \"durable\"; }"
         },
         {
           "classification": "supported",
@@ -27134,7 +27450,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ContractsResult",
-          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; grammar_contracts?: { nouns: readonly string[]; shared_verbs: readonly string[]; scope_before_verb: boolean; visible_top_level_ceiling: number; ceiling_raise_requires_pm_item: boolean; positional_shape_budget: number; positional_shape_count: number; positional_action_count: number; positional_action_parents: readonly string[]; positional_signatures?: readonly PmCommandPositionalContract[]; destinations?: readonly PmCommandDestinationContract[]; }; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; assurance_contracts?: { measurement_source_kinds: readonly string[]; gate_triggers: readonly string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[]; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
+          "signature": "export interface ContractsResult { schema_version: string | null; schema_id: string | null; selected: { action: string | null; command: string | null; summary: boolean; schema_only: boolean; flags_only: boolean; availability_only: boolean; runtime_only: boolean; command_scoped: boolean; }; actions?: string[]; action_availability?: ContractsActionAvailability[]; commands: string[]; schema?: Record<string, unknown>; schema_omitted_reason?: string; command_flags_omitted_reason?: string; commander_aliases_omitted_reason?: string; command_flags?: CommandFlagSurface[]; list_projections?: ListCommandProjectionSurface[]; command_aliases?: CommandAliasSurface[]; grammar_contracts?: { nouns: readonly string[]; shared_verbs: readonly string[]; scope_before_verb: boolean; visible_top_level_ceiling: number; ceiling_raise_requires_pm_item: boolean; positional_shape_budget: number; positional_shape_count: number; positional_action_count: number; positional_action_parents: readonly string[]; positional_signatures?: readonly PmCommandPositionalContract[]; destinations?: readonly PmCommandDestinationContract[]; }; commander_aliases?: Record<string, CommanderOptionAliasContract[]>; extension_commands?: ExtensionCommandContract[]; command_summaries?: CommandSummarySurface[]; output_policy?: { token_estimate: \"ceil(utf8_bytes / 4)\"; degradation_ladder: string[]; allows_unbounded_opt_out: boolean; }; output_projection_contracts?: { global_ladder_field: \"output_policy.degradation_ladder\"; global_ladder_scope: \"union_not_per_command\"; discovery: \"pm contracts --command <command> --summary\"; commands?: Array<{ command: string; modes: string[]; }>; }; runtime_schema?: { statuses: string[]; open_status: string; close_status: string; canceled_status: string; types: string[]; fields_by_command: Record<string, string[]>; }; relationship_kind_contracts?: Array<{ canonical: string; aliases: string[]; inverse?: string; ordering: boolean; hierarchy: boolean; }>; extension_contracts?: { capabilities: string[]; services: string[]; policy_modes: string[]; policy_mode_scope: \"extensions.policy.mode\"; policy_surfaces: string[]; trust_modes: string[]; trust_mode_scope: \"extensions.policy.trust_mode\"; sandbox_profiles: string[]; manifest_versions: number[]; compatibility: { current: string; previous: string[]; breaking_strategy: string; }; }; governance_contracts?: { ownership_enforcement_modes: string[]; create_modes: string[]; close_validation_modes: string[]; workflow_enforcement_modes: string[]; }; assurance_contracts?: { measurement_source_kinds: readonly string[]; gate_triggers: readonly string[]; }; mcp_tools?: McpToolContract[]; context_intents?: readonly PmContextIntentContract[]; read_output_dimensions?: readonly PmReadOutputSurfaceContract[]; error_codes?: readonly PmErrorCodeContract[]; command_output_contracts?: Array<{ budget: PmCommandOutputBudgetContract; envelope: PmCommandOutputEnvelopeContract; }>; diagnostic_output_contracts?: readonly PmDiagnosticOutputBudgetContract[]; command_exit_contracts?: { vocabulary: readonly PmCommandExitOutcomeContract[]; command_sets: Array<{ commands: string[]; exit_codes: PmCommandExitContract[\"exit_codes\"]; }>; }; }"
         },
         {
           "classification": "supported",
@@ -28412,7 +28728,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputSurfaceContract",
-          "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; budget_retention_policy: \"ordered_prefix\" | \"verdict_priority\"; }"
+          "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; budget_retention_policy: \"ordered_prefix\" | \"verdict_priority\"; projection_modes?: readonly string[]; }"
         },
         {
           "classification": "supported",
@@ -29600,7 +29916,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",
@@ -30225,6 +30541,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",
@@ -30300,6 +30619,7 @@
     "history_author_acknowledge_target_unreadable",
     "history_drift_chain_mismatch",
     "history_drift_hash_mismatch",
+    "history_drift_merge_receipt",
     "history_drift_missing_stream",
     "history_drift_unreadable_stream",
     "history_merge_conflict_markers_detected",
@@ -30364,10 +30684,15 @@
     "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",
+    "merge_receipt_evidence_invalid",
+    "merge_receipts_pending",
     "merge_reconcile_discards_require_acceptance",
+    "merge_reconcile_receipt_evidence_untrusted",
     "merge_root_not_found",
     "missing_allowed_values",
     "missing_budget",