@unbrained/pm-cli 2026.8.10 → 2026.8.12

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1483,
+    "covered_symbols": 1506,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1484
+    "required_symbols": 1507
   },
   "breaking_acknowledgements": [
     {
@@ -181,6 +181,214 @@
       ],
       "package_version": "2026.8.9",
       "reason": "Adds fail-fast dependency targets, lossless acceptance-criteria errors, and explicit unresolved dependency options across typed SDK contracts."
+    },
+    {
+      "changes": [
+        "signature ./sdk:AgentModelSource",
+        "signature ./sdk:AgentProvenanceObservation",
+        "signature ./sdk:FilesLookupMatch",
+        "signature ./sdk:FilesLookupOptions",
+        "signature ./sdk:FilesLookupResult",
+        "signature ./sdk:PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/contracts:PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/core:AgentModelSource",
+        "signature ./sdk/core:AgentProvenanceObservation",
+        "signature ./sdk/runtime:FilesLookupOptions",
+        "signature ./sdk/runtime:FilesLookupResult"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Intentional additive semantic-attribution and explained source-traceability SDK contract expansion for pm-3zgh2c and pm-f86lth; schema constants advance with transport fields."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmCliErrorRecoveryPayload",
+        "signature ./sdk:PmErrorCodeContract",
+        "signature ./sdk/contracts:PmErrorCodeContract",
+        "signature ./sdk/runtime:PmErrorCodeContract"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Intentional compatible public contract expansion: optional recovery and owned-state fields plus new refusal primitives; existing consumers require no changes."
+    },
+    {
+      "changes": [
+        "error code missing_probe removed",
+        "error code undeclared_probe removed",
+        "error code wrong_error_code removed",
+        "error code wrong_exit_class removed",
+        "signature ./sdk:PmRefusalReachabilityFinding"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Refusal-verifier findings are typed report members rather than emitted CLI error codes; the finding union models executable reachability mismatches without polluting the runtime error-code catalog."
+    },
+    {
+      "changes": [
+        "signature ./sdk:UnknownSubcommandErrorOptions"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Intentional compatible public contract expansion adds configurable refusal display labels and preserves stable alias migration: unknown_lifecycle_action resolves canonically to unknown_subcommand while retaining its catalog identity."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmRefusalProbeObservation",
+        "signature ./sdk:PmRefusalReachabilityFinding"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Intentional verifier contract hardening: observations now identify the exercised entrypoint and findings distinguish duplicate probes and wrong entrypoints so conformance cannot pass with the wrong transport path."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_CORE_COMMAND_NAMES",
+        "signature ./sdk:PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk:PmClient",
+        "signature ./sdk/contracts:PM_CORE_COMMAND_NAMES",
+        "signature ./sdk/contracts:PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/core:PmClient",
+        "signature ./sdk/runtime:PmClient"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Additive assurance action and typed PmClient method intentionally extend public command and schema contracts"
+    },
+    {
+      "changes": [
+        "error code assurance_action_invalid removed",
+        "error code assurance_definition_id_mismatch removed",
+        "error code assurance_definition_invalid removed",
+        "error code assurance_definition_invalid_json removed",
+        "error code assurance_gate_missing removed",
+        "error code assurance_id_missing removed",
+        "error code assurance_kind_invalid removed",
+        "error code assurance_trigger_missing removed",
+        "symbol ./sdk:assurance removed",
+        "symbol ./sdk/runtime:assurance removed"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Assurance governance namespace and PmClient action extend the public SDK surface"
+    },
+    {
+      "changes": [
+        "signature ./sdk:AssuranceActionInput",
+        "signature ./sdk:AssuranceActionResult"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Assurance action projections and canonical CLI flag contracts extend the additive SDK surface"
+    },
+    {
+      "changes": [
+        "signature ./sdk:AssuranceActionInput",
+        "signature ./sdk:CreateAssuranceWorkspaceContextOptions",
+        "signature ./sdk:listAssuranceVerdicts"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Assurance is an unreleased API added by this PR; exact-head review expanded its optional bounds and runtime controls before first publication."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmClient",
+        "signature ./sdk/core:PmClient",
+        "signature ./sdk/runtime:PmClient"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Normalize PmClient assurance signatures to newly exported public transport types without changing runtime behavior"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmClient",
+        "signature ./sdk/core:PmClient",
+        "signature ./sdk/runtime:PmClient"
+      ],
+      "package_version": "2026.8.10",
+      "reason": "Expose public assurance action transport types while preserving the PmClient method contract"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ActivityCommandOptions",
+        "signature ./sdk:ActivityResult",
+        "signature ./sdk:BootstrapGlobalOptions",
+        "signature ./sdk:GlobalOptions",
+        "signature ./sdk:PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS",
+        "signature ./sdk:PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
+        "signature ./sdk:PM_READ_ROW_CONTRACTS",
+        "signature ./sdk:PmReadOutputOptions",
+        "signature ./sdk:ReadRowContract",
+        "signature ./sdk:StatsCommandOptions",
+        "signature ./sdk:StatsResult",
+        "signature ./sdk/contracts:PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
+        "signature ./sdk/contracts:PmReadOutputOptions",
+        "signature ./sdk/core:PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
+        "signature ./sdk/core:PmReadOutputOptions",
+        "signature ./sdk/query:ActivityCommandOptions",
+        "signature ./sdk/query:ActivityResult",
+        "signature ./sdk/runtime:GlobalOptions",
+        "signature ./sdk/runtime:PmReadOutputOptions",
+        "signature ./sdk/runtime:StatsCommandOptions",
+        "signature ./sdk/runtime:StatsResult"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "stats now returns compact lifecycle rows by default; activity defaults to item digests; row contracts are explicit opt-in"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ItemDocumentMergeResult",
+        "signature ./sdk:MergeDecisionReceipt",
+        "signature ./sdk:MergeDecisionReceiptSummary",
+        "signature ./sdk:MergeDriverResult",
+        "signature ./sdk/merge:ItemDocumentMergeResult",
+        "signature ./sdk/merge:MergeDecisionReceipt",
+        "signature ./sdk/merge:MergeDecisionReceiptSummary",
+        "signature ./sdk/merge:MergeDriverResult"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "GH-974 corrects misleading merge preferred fields to requested_preference; retained decision evidence is authoritative and legacy stored receipts remain readable"
+    },
+    {
+      "changes": [
+        "signature ./sdk:AssuranceAssertionVerdict",
+        "signature ./sdk:AssuranceItemRecord",
+        "signature ./sdk:AssuranceItemsSource",
+        "signature ./sdk:AssuranceMeasurementResult",
+        "signature ./sdk:HealthCheck",
+        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk:PmCliErrorRecoveryPayload",
+        "signature ./sdk:RelationshipAuditDelta",
+        "signature ./sdk:RelationshipCoverageProfile",
+        "signature ./sdk:TestCommandOptions",
+        "signature ./sdk:TestResult",
+        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/governance:HealthCheck",
+        "signature ./sdk/graph:RelationshipAuditDelta",
+        "signature ./sdk/graph:RelationshipCoverageProfile"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "pm-py7qv2 pm-33mjrw pm-q6n8sj pm-h97qxd pm-rncuf7 pm-m0b7h8: explicit truthful context and evidence contract tranche"
+    },
+    {
+      "changes": [
+        "signature ./sdk:TestResult"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "pm-m0b7h8: removed count is present only for successful linked-test removals"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ValidateCheck",
+        "signature ./sdk/governance:ValidateCheck"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "ValidateCheck now exposes the same required machine-readable ok predicate as HealthCheck, preventing consumers from re-deriving status semantics; review-hardened before release."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmReadOutputSessionReceipt",
+        "signature ./sdk/contracts:PmReadOutputSessionReceipt",
+        "signature ./sdk/core:PmReadOutputSessionReceipt",
+        "signature ./sdk/runtime:PmReadOutputSessionReceipt"
+      ],
+      "package_version": "2026.8.11",
+      "reason": "Add optional seen_item_overflow_count receipt while preserving every existing SDK input and below-capacity output"
     }
   ],
   "entrypoints": {
@@ -377,7 +585,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ActivityCommandOptions",
-          "signature": "export interface ActivityCommandOptions { id?: string; op?: string; author?: string; from?: string; to?: string; limit?: string; compact?: boolean; unbounded?: boolean; provenance?: boolean; provenanceSummary?: boolean; harness?: string | readonly string[]; agentInstance?: string | readonly string[]; provenanceFilter?: string | readonly string[]; }"
+          "signature": "export interface ActivityCommandOptions { id?: string; op?: string; author?: string; from?: string; to?: string; limit?: string; compact?: boolean; raw?: boolean; unbounded?: boolean; provenance?: boolean; provenanceSummary?: boolean; harness?: string | readonly string[]; agentInstance?: string | readonly string[]; provenanceFilter?: string | readonly string[]; }"
         },
         {
           "classification": "supported",
@@ -389,7 +597,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ActivityResult",
-          "signature": "export interface ActivityResult { activity?: ActivityEntry[]; compact_activity?: CompactActivityEntry[]; provenance_activity?: HistoryProvenanceRow[]; compact: boolean; projection: { mode: \"compact\" | \"provenance\" | \"full\"; row_key: \"compact_activity\" | \"provenance_activity\" | \"activity\"; }; omission_receipt: OutputOmissionReceipt; count: number; total_count: number; limit: number | null; omitted_count: number; has_more: boolean; applied_bound: { kind: \"limit\" | \"unbounded\"; source: \"default\" | \"explicit\"; value: number | null; }; provenance_summary?: HistoryProvenanceSummary; }"
+          "signature": "export interface ActivityResult { activity_digest?: ActivityDigestEntry[]; activity?: ActivityEntry[]; compact_activity?: CompactActivityEntry[]; provenance_activity?: HistoryProvenanceRow[]; compact: boolean; projection: { mode: \"digest\" | \"compact\" | \"provenance\" | \"full\"; row_key: \"activity_digest\" | \"compact_activity\" | \"provenance_activity\" | \"activity\"; }; omission_receipt: OutputOmissionReceipt; count: number; total_count: number; limit: number | null; omitted_count: number; has_more: boolean; applied_bound: { kind: \"limit\" | \"unbounded\"; source: \"default\" | \"explicit\"; value: number | null; }; activity_summary?: { window: { from: string | null; to: string | null; }; event_count: number; item_count: number; author_count: number; operation_counts: Record<string, number>; }; provenance_summary?: HistoryProvenanceSummary; }"
         },
         {
           "classification": "advanced_export",
@@ -449,7 +657,7 @@
           "classification": "supported",
           "kind": "type",
           "name": "AgentModelSource",
-          "signature": "export type AgentModelSource = \"override\" | \"environment\" | \"mcp_client\" | \"argv\" | \"host\" | \"session\" | \"probe\";"
+          "signature": "export type AgentModelSource = \"override\" | \"environment\" | \"mcp_client\" | \"argv\" | \"host\" | \"session\" | \"probe\" | \"inferred\";"
         },
         {
           "classification": "supported",
@@ -479,7 +687,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AgentProvenanceObservation",
-          "signature": "export interface AgentProvenanceObservation { value: string; source: AgentModelSource; }"
+          "signature": "export interface AgentProvenanceObservation { value: string; source: AgentModelSource; confidence?: \"high\" | \"medium\" | \"low\"; rule_version?: \"v2\"; evidence?: readonly string[]; }"
         },
         {
           "classification": "supported",
@@ -487,6 +695,18 @@
           "name": "AgentProvenanceOutcome",
           "signature": "export interface AgentProvenanceOutcome { status: \"resolved\" | \"unavailable\" | \"not_configured\" | \"failed\"; reason?: AgentProvenanceAbsenceReason; resolver?: AgentProvenanceResolver; rule_version: \"v1\"; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentSemanticAttributionCoverage",
+          "signature": "export interface AgentSemanticAttributionCoverage { harness: string; dimension: \"role\" | \"topic\"; entries: number; observed: number; by_source: Partial<Record<AgentModelSource, number>>; coverage: number; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentSemanticAttributionCoverageGate",
+          "signature": "export interface AgentSemanticAttributionCoverageGate { passed: boolean; minimum_coverage: number; minimum_entries: number; rows: AgentSemanticAttributionCoverage[]; failures: string[]; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -1009,6 +1229,300 @@
           "name": "assertRelationshipGraphAdapterConformance",
           "signature": "(adapter: RelationshipGraphAdapter, options?: { workspace?: string; }) => Promise<RelationshipGraphAdapterConformanceReport> | calls: (adapter: RelationshipGraphAdapter, options?: { workspace?: string; }) => Promise<RelationshipGraphAdapterConformanceReport>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "ASSURANCE_ACTIONS",
+          "signature": "readonly [\"list\", \"show\", \"put\", \"remove\", \"run\", \"verdicts\"]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "ASSURANCE_DECLARATION_KINDS",
+          "signature": "readonly [\"measurement\", \"assertion\", \"gate\"]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "ASSURANCE_DOCUMENT_VERSION",
+          "signature": "1"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "ASSURANCE_FLAG_CONTRACTS",
+          "signature": "CliFlagContract[]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "ASSURANCE_GATE_TRIGGERS",
+          "signature": "readonly [\"pre-commit\", \"pre-push\", \"pre-merge\", \"ci\", \"pre-release\", \"post-release\", \"scheduled\", \"on-claim\", \"on-close\"]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceAction",
+          "signature": "export type AssuranceAction = (typeof ASSURANCE_ACTIONS)[number];"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AssuranceActionInput",
+          "signature": "export interface AssuranceActionInput { action: string; kind?: string; id?: string; definition?: unknown; trigger?: string; tree?: string; gate?: string; limit?: number | string; dry_run?: boolean; fullChangedFields?: boolean; idOnly?: boolean; author?: string; message?: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "AssuranceActionResult",
+          "signature": "export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | { id: string; } | { items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { items: AssuranceGateVerdict[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; };"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceArithmeticExpression",
+          "signature": "export interface AssuranceArithmeticExpression { operator: \"add\" | \"subtract\" | \"multiply\" | \"divide\" | \"min\" | \"max\"; operands: AssuranceDerivedExpression[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceAssertionDefinition",
+          "signature": "export interface AssuranceAssertionDefinition { id: string; measurement_id: string; owner_item_id: string; scope: AssuranceScope; ceiling?: number; floor?: number; equals?: AssuranceValue; zero?: true; monotone_nondecreasing?: number; monotone_nonincreasing?: number; subset_of?: string[]; lifetime?: AssuranceLifetime; retire_reason?: string; enforcement: AssuranceEnforcement; negative_control: AssuranceNegativeControl; authorization_decision?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "assuranceAssertionUpdateIsLoosening",
+          "signature": "(before: AssuranceAssertionDefinition, after: AssuranceAssertionDefinition) => boolean | calls: (before: AssuranceAssertionDefinition, after: AssuranceAssertionDefinition) => boolean"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceAssertionVerdict",
+          "signature": "export interface AssuranceAssertionVerdict { assertion_id: string; measurement_id: string; measurement_definition_fingerprint: string; scope: AssuranceScope; population_size: number; observed: AssuranceValue; bound: AssuranceBound; distance: number | null; verdict: \"pass\" | \"fail\" | \"retired\"; enforcement: AssuranceEnforcement; negative_control_proven: boolean; cost: AssuranceMeasurementCost; contributors: string[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceBound",
+          "signature": "export interface AssuranceBound { polarity: \"ceiling\" | \"floor\" | \"equals\" | \"zero\" | \"monotone_nondecreasing\" | \"monotone_nonincreasing\" | \"subset_of\"; value: AssuranceValue; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceDeclaration",
+          "signature": "export type AssuranceDeclaration = AssuranceMeasurementDefinition | AssuranceAssertionDefinition | AssuranceGateDefinition;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceDeclarationKind",
+          "signature": "export type AssuranceDeclarationKind = \"measurement\" | \"assertion\" | \"gate\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceDependencyKindSource",
+          "signature": "export interface AssuranceDependencyKindSource { kind: \"dependency_kind\"; dependency_kind: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceDependencyRecord",
+          "signature": "export interface AssuranceDependencyRecord { id: string; kind: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceDerivedExpression",
+          "signature": "export type AssuranceDerivedExpression = AssuranceMeasurementReference | AssuranceLiteralExpression | AssuranceArithmeticExpression;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceDerivedSource",
+          "signature": "export interface AssuranceDerivedSource { kind: \"derived\"; expression: AssuranceDerivedExpression; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceDocument",
+          "signature": "export interface AssuranceDocument { version: typeof ASSURANCE_DOCUMENT_VERSION; measurements: AssuranceMeasurementDefinition[]; assertions: AssuranceAssertionDefinition[]; gates: AssuranceGateDefinition[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceEnforcement",
+          "signature": "export type AssuranceEnforcement = \"block\" | \"warn\" | \"observe\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceEvaluationContext",
+          "signature": "export interface AssuranceEvaluationContext { tree_id: string; items: AssuranceItemRecord[]; history: AssuranceHistoryRecord[]; terminal_statuses?: string[]; external: (source: AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceProviderSource) => Promise<AssuranceExternalMeasurementResult>; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceExternalMeasurementResult",
+          "signature": "export interface AssuranceExternalMeasurementResult { value: AssuranceValue; population_size: number; cost: number; contributors?: string[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceGateDefinition",
+          "signature": "export interface AssuranceGateDefinition { id: string; assertion_ids: string[]; triggers: AssuranceGateTrigger[]; description?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceGateTrigger",
+          "signature": "export type AssuranceGateTrigger = (typeof ASSURANCE_GATE_TRIGGERS)[number];"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceGateVerdict",
+          "signature": "export interface AssuranceGateVerdict { gate_id: string; tree_id: string; trigger: AssuranceGateTrigger; dry_run: boolean; evaluated_at: string; verdict: \"pass\" | \"warn\" | \"block\"; exit_code: 0 | 1; assertions: AssuranceAssertionVerdict[]; cost: AssuranceMeasurementCost; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceGraphSource",
+          "signature": "export interface AssuranceGraphSource { kind: \"graph\"; operation: string; field: string; parameters?: Record<string, string | number | boolean>; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceHealthSource",
+          "signature": "export interface AssuranceHealthSource { kind: \"health\"; check: string; field: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceHistoryRecord",
+          "signature": "export interface AssuranceHistoryRecord { op: string; author: string; agent_harness?: string; agent_model?: string; [key: string]: unknown; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceHistorySource",
+          "signature": "export interface AssuranceHistorySource { kind: \"history\"; op?: string; author?: string; harness?: string; model?: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceItemRecord",
+          "signature": "export interface AssuranceItemRecord { id: string; status: string; type: string; tags?: string[]; priority?: string | number; dependencies?: AssuranceDependencyRecord[]; files?: object[]; tests?: object[]; docs?: object[]; [key: string]: unknown; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceItemsSource",
+          "signature": "export interface AssuranceItemsSource { kind: \"items\"; statuses?: string[]; types?: string[]; tags?: string[]; field?: string; equals?: string | number | boolean | null; state?: \"present\" | \"missing\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceLifetime",
+          "signature": "export type AssuranceLifetime = \"hold\" | \"retire\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceLinksSource",
+          "signature": "export interface AssuranceLinksSource { kind: \"links\"; link: \"files\" | \"tests\" | \"docs\"; state: \"present\" | \"missing\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceLiteralExpression",
+          "signature": "export interface AssuranceLiteralExpression { literal: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceMeasurementCost",
+          "signature": "export interface AssuranceMeasurementCost { units: number; items_scanned: number; history_entries: number; provider_calls: number; duration_ms: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceMeasurementDefinition",
+          "signature": "export interface AssuranceMeasurementDefinition { id: string; description?: string; source: AssuranceMeasurementSource; max_cost?: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceMeasurementReference",
+          "signature": "export interface AssuranceMeasurementReference { measurement: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceMeasurementResult",
+          "signature": "export interface AssuranceMeasurementResult { id: string; definition_fingerprint: string; value: AssuranceValue; population_size: number; cost: AssuranceMeasurementCost; contributors: string[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceMeasurementSource",
+          "signature": "export type AssuranceMeasurementSource = AssuranceItemsSource | AssuranceDependencyKindSource | AssuranceGraphSource | AssuranceValidateSource | AssuranceHealthSource | AssuranceHistorySource | AssuranceLinksSource | AssuranceProviderSource | AssuranceDerivedSource;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceMutationOptions",
+          "signature": "export interface AssuranceMutationOptions { author?: string; message?: string; authorized_decision_ids?: string[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceMutationReceipt",
+          "signature": "export interface AssuranceMutationReceipt { changed: boolean; action: \"created\" | \"updated\" | \"removed\"; kind: AssuranceDeclarationKind; id: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceNegativeControl",
+          "signature": "export interface AssuranceNegativeControl { cases: AssuranceNegativeControlCase[]; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceNegativeControlCase",
+          "signature": "export interface AssuranceNegativeControlCase { observed: AssuranceValue; expected: \"pass\" | \"fail\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceProviderResolver",
+          "signature": "export type AssuranceProviderResolver = (source: AssuranceProviderSource) => Promise<AssuranceExternalMeasurementResult>;"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceProviderSource",
+          "signature": "export interface AssuranceProviderSource { kind: \"provider\"; provider: string; key: string; parameters?: Record<string, string | number | boolean | null>; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceScope",
+          "signature": "export type AssuranceScope = { kind: \"all\"; } | { kind: \"active\"; } | { kind: \"filter\"; measurement_id: string; };"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "AssuranceValidateSource",
+          "signature": "export interface AssuranceValidateSource { kind: \"validate\"; check: string; field: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "AssuranceValue",
+          "signature": "export type AssuranceValue = number | string[];"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -1121,7 +1635,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "BootstrapGlobalOptions",
-          "signature": "export interface BootstrapGlobalOptions { path?: string; noExtensions: boolean; noPager: boolean; json: boolean; quiet: boolean; lean: boolean; tokenAccounting: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; author?: string; authorMissingValue?: true; }"
+          "signature": "export interface BootstrapGlobalOptions { path?: string; noExtensions: boolean; noPager: boolean; json: boolean; quiet: boolean; lean: boolean; tokenAccounting: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; outputRowContract?: boolean; author?: string; authorMissingValue?: true; }"
         },
         {
           "classification": "advanced_export",
@@ -2545,6 +3059,18 @@
           "name": "CREATE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "createAssuranceWorkspaceContext",
+          "signature": "(pmRoot: string, options?: CreateAssuranceWorkspaceContextOptions) => Promise<AssuranceEvaluationContext> | calls: (pmRoot: string, options?: CreateAssuranceWorkspaceContextOptions) => Promise<AssuranceEvaluationContext>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "CreateAssuranceWorkspaceContextOptions",
+          "signature": "export interface CreateAssuranceWorkspaceContextOptions { tree_id?: string; include_history?: boolean; resolve_tree?: boolean; providers?: Readonly<Record<string, AssuranceProviderResolver>>; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -2563,6 +3089,12 @@
           "name": "createCorpusShapeMeasurement",
           "signature": "(shape: Readonly<CorpusShape>) => CorpusShapeMeasurement | calls: (shape: Readonly<CorpusShape>) => CorpusShapeMeasurement"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "createEmptyAssuranceDocument",
+          "signature": "() => AssuranceDocument | calls: () => AssuranceDocument"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -2695,6 +3227,12 @@
           "name": "CreateTemplateOptions",
           "signature": "export type CreateTemplateOptions = Record<string, TemplateOptionValue>;"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "createUnknownSubcommandError",
+          "signature": "(options: UnknownSubcommandErrorOptions) => PmCliError | calls: (options: UnknownSubcommandErrorOptions) => PmCliError"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -2707,6 +3245,12 @@
           "name": "CreateWorkspaceSnapshotResult",
           "signature": "export interface CreateWorkspaceSnapshotResult { manifest: WorkspaceSnapshotManifest; name?: string; deduplicated: boolean; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "CURRENT_HISTORY_ITEM_HASH_VERSION",
+          "signature": "2"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -3505,12 +4049,30 @@
           "name": "EvalResult",
           "signature": "export interface EvalResult { k: number; query_count: number; aggregate: { ndcg: number; mrr: number; precision: number; recall: number; }; queries: EvalQueryReport[]; fail_under?: number; passed: boolean; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "evaluateAssuranceAssertion",
+          "signature": "(definition: AssuranceAssertionDefinition, measurement: AssuranceMeasurementResult, options?: { owner_terminal?: boolean; }) => AssuranceAssertionVerdict | calls: (definition: AssuranceAssertionDefinition, measurement: AssuranceMeasurementResult, options?: { owner_terminal?: boolean; }) => AssuranceAssertionVerdict"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "evaluateAssuranceGate",
+          "signature": "(gateId: string, document: AssuranceDocument, context: AssuranceEvaluationContext, options: { trigger: AssuranceGateTrigger; dry_run?: boolean; }) => Promise<AssuranceGateVerdict> | calls: (gateId: string, document: AssuranceDocument, context: AssuranceEvaluationContext, options: { trigger: AssuranceGateTrigger; dry_run?: boolean; }) => Promise<AssuranceGateVerdict>"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "evaluateContextRanking",
           "signature": "(input: ContextRankingEvaluationInput) => ContextRankingEvaluation | calls: (input: ContextRankingEvaluationInput) => ContextRankingEvaluation"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "evaluateMeasurement",
+          "signature": "(definition: AssuranceMeasurementDefinition, context: AssuranceEvaluationContext, definitions?: AssuranceMeasurementDefinition[]) => Promise<AssuranceMeasurementResult> | calls: (definition: AssuranceMeasurementDefinition, context: AssuranceEvaluationContext, definitions?: AssuranceMeasurementDefinition[]) => Promise<AssuranceMeasurementResult>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -3529,6 +4091,12 @@
           "name": "evaluateProvenanceCoverage",
           "signature": "(entries: readonly HistoryEntry[], descriptors: readonly HarnessSignalDescriptor[], minimumSample: number) => Omit<ProvenanceCoverageAnalytics, \"window\"> | calls: (entries: readonly HistoryEntry[], descriptors: readonly HarnessSignalDescriptor[], minimumSample: number) => Omit<ProvenanceCoverageAnalytics, \"window\">"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "evaluateSemanticAttributionCoverage",
+          "signature": "(entries: readonly Pick<HistoryEntry, \"agent_harness\" | \"agent_provenance\">[], options?: { minimumCoverage?: number; minimumEntries?: number; }) => AgentSemanticAttributionCoverageGate | calls: (entries: readonly Pick<HistoryEntry, \"agent_harness\" | \"agent_provenance\">[], options?: { minimumCoverage?: number; minimumEntries?: number; }) => AgentSemanticAttributionCoverageGate"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -3601,6 +4169,12 @@
           "name": "expandAddGlobEntries",
           "signature": "(entries: AddGlobEntry[], workspaceRoot?: string, invocationRoot?: string) => Promise<LinkedArtifact[]> | calls: (entries: AddGlobEntry[], workspaceRoot?: string, invocationRoot?: string) => Promise<LinkedArtifact[]>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "explainSourceTraceability",
+          "signature": "(params: { workspaceRoot: string; paths: readonly string[]; candidates: readonly TraceabilityCandidate[]; corpus: readonly ItemMetadata[]; lineRange?: SourceLineRange; decisionDepth?: number; }) => Promise<{ explanations: Map<string, SourceTraceabilityExplanation>; receipt: SourceTraceabilityReceipt; }> | calls: (params: { workspaceRoot: string; paths: readonly string[]; candidates: readonly TraceabilityCandidate[]; corpus: readonly ItemMetadata[]; lineRange?: SourceLineRange; decisionDepth?: number; }) => Promise<{ explanations: Map<string, SourceTraceabilityExplanation>; receipt: SourceTraceabilityReceipt; }>"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -4331,19 +4905,19 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "FilesLookupMatch",
-          "signature": "export interface FilesLookupMatch { item: FilesLookupItem; files: LinkedFile[]; }"
+          "signature": "export interface FilesLookupMatch { item: FilesLookupItem; files: LinkedFile[]; traceability?: SourceTraceabilityExplanation; }"
         },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "FilesLookupOptions",
-          "signature": "export interface FilesLookupOptions { paths: string[]; scope?: LinkScope; limit?: number; offset?: number; noTruncate?: boolean; strictRead?: boolean; }"
+          "signature": "export interface FilesLookupOptions { paths: string[]; scope?: LinkScope; limit?: number; offset?: number; noTruncate?: boolean; strictRead?: boolean; explain?: boolean; lineRange?: SourceLineRange; decisionDepth?: number; }"
         },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "FilesLookupResult",
-          "signature": "export interface FilesLookupResult { paths: string[]; total: number; count: number; offset: number; limit: number | null; has_more: boolean; truncated: boolean; completeness: { status: \"complete\" | \"partial\" | \"unchecked\"; source: \"index\" | \"source_scan\"; }; warnings: string[]; matches: FilesLookupMatch[]; }"
+          "signature": "export interface FilesLookupResult { paths: string[]; total: number; count: number; offset: number; limit: number | null; has_more: boolean; truncated: boolean; completeness: { status: \"complete\" | \"partial\" | \"unchecked\"; source: \"index\" | \"source_scan\"; }; warnings: string[]; matches: FilesLookupMatch[]; traceability_receipt?: SourceTraceabilityReceipt; }"
         },
         {
           "classification": "supported",
@@ -4591,6 +5165,12 @@
           "name": "getActiveExtensionRegistrations",
           "signature": "() => ExtensionRegistrationRegistry | null | calls: () => ExtensionRegistrationRegistry | null"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "getAssuranceDeclaration",
+          "signature": "(pmRoot: string, kind: AssuranceDeclarationKind, id: string) => Promise<AssuranceDeclaration> | calls: (pmRoot: string, kind: AssuranceDeclarationKind, id: string) => Promise<AssuranceDeclaration>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -4697,7 +5277,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "GlobalOptions",
-          "signature": "export interface GlobalOptions { json?: boolean; quiet?: boolean; noChangedFields?: boolean; fullChangedFields?: boolean; idOnly?: boolean; lean?: boolean; tokenAccounting?: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
+          "signature": "export interface GlobalOptions { json?: boolean; quiet?: boolean; noChangedFields?: boolean; fullChangedFields?: boolean; idOnly?: boolean; lean?: boolean; tokenAccounting?: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; outputRowContract?: boolean; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
         },
         {
           "classification": "supported",
@@ -5011,6 +5591,12 @@
           "name": "hashDocument",
           "signature": "(document: ItemDocument) => string | calls: (document: ItemDocument) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "hashDocumentForVersion",
+          "signature": "(document: ItemDocument, version: HistoryItemHashVersion) => string | calls: (document: ItemDocument, version: HistoryItemHashVersion) => string"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -5051,7 +5637,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "HealthCheck",
-          "signature": "export interface HealthCheck { name: \"settings\" | \"directories\" | \"settings_values\" | \"telemetry\" | \"extensions\" | \"storage\" | \"locks\" | \"integrity\" | \"history_drift\" | \"vectorization\"; status: HealthStatus; details: Record<string, unknown>; }"
+          "signature": "export interface HealthCheck { name: \"settings\" | \"directories\" | \"settings_values\" | \"telemetry\" | \"extensions\" | \"storage\" | \"locks\" | \"integrity\" | \"history_drift\" | \"vectorization\"; status: HealthStatus; ok: boolean; details: Record<string, unknown>; }"
         },
         {
           "classification": "supported",
@@ -5221,6 +5807,12 @@
           "name": "historyEntryMatchesProvenance",
           "signature": "(entry: HistoryEntry, filters: HistoryProvenanceFilters, vocabulary?: AuthorIdentityVocabulary, dimensions?: readonly string[]) => boolean | calls: (entry: HistoryEntry, filters: HistoryProvenanceFilters, vocabulary?: AuthorIdentityVocabulary, dimensions?: readonly string[]) => boolean"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "HistoryItemHashVersion",
+          "signature": "export type HistoryItemHashVersion = (typeof SUPPORTED_HISTORY_ITEM_HASH_VERSIONS)[number];"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -5575,6 +6167,12 @@
           "name": "InstallSource",
           "signature": "export type InstallSource = LocalInstallSource | GithubInstallSource | NpmInstallSource;"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "isAlreadyClaimedError",
+          "signature": "(error: unknown) => boolean | calls: (error: unknown) => boolean"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -5783,7 +6381,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ItemDocumentMergeResult",
-          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
+          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
         },
         {
           "classification": "advanced_export",
@@ -6109,6 +6707,18 @@
           "name": "listAllItemMetadataLight",
           "signature": "(pmRoot: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>, warnings?: string[], schema?: RuntimeSchemaSettings) => Promise<ItemMetadata[]> | calls: (pmRoot: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>, warnings?: string[], schema?: RuntimeSchemaSettings) => Promise<ItemMetadata[]>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "listAssuranceDeclarations",
+          "signature": "(pmRoot: string, kind: AssuranceDeclarationKind) => Promise<{ items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [\"items\"]; jq_selector: \".items[]\"; }; }> | calls: (pmRoot: string, kind: AssuranceDeclarationKind) => Promise<{ items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [\"items\"]; jq_selector: \".items[]\"; }; }>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "listAssuranceVerdicts",
+          "signature": "(pmRoot: string, options?: { gate_id?: string; limit?: number; }) => Promise<AssuranceGateVerdict[]> | calls: (pmRoot: string, options?: { gate_id?: string; limit?: number; }) => Promise<AssuranceGateVerdict[]>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -6401,13 +7011,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; 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[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceiptSummary",
-          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
+          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
         },
         {
           "classification": "supported",
@@ -6431,7 +7041,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDriverResult",
-          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; preferred: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; requested_preference: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -7333,6 +7943,12 @@
           "name": "ParserOverrideDelta",
           "signature": "export interface ParserOverrideDelta { args?: string[]; options?: Record<string, unknown>; global?: GlobalOptions; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "parseSourceLineRange",
+          "signature": "(value: string) => SourceLineRange | calls: (value: string) => SourceLineRange"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7613,7 +8229,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_CORE_COMMAND_NAMES",
-          "signature": "readonly [\"init\", \"config\", \"extension\", \"package\", \"packages\", \"install\", \"upgrade\", \"create\", \"item\", \"copy\", \"focus\", \"list\", \"list-all\", \"list-draft\", \"list-open\", \"list-in-progress\", \"list-blocked\", \"list-closed\", \"list-canceled\", \"aggregate\", \"context\", \"ctx\", \"get\", \"graph\", \"search\", \"duplicates\", \"eval\", \"next\", \"history\", \"events\", \"history-redact\", \"history-repair\", \"history-compact\", \"history-author-acknowledge\", \"merge\", \"schema\", \"profile\", \"activity\", \"restore\", \"update\", \"update-many\", \"close\", \"close-many\", \"delete\", \"append\", \"comments\", \"notes\", \"learnings\", \"files\", \"docs\", \"deps\", \"plan\", \"test\", \"test-all\", \"telemetry\", \"stats\", \"health\", \"validate\", \"gc\", \"workspace\", \"contracts\", \"claim\", \"release\", \"start-task\", \"pause-task\", \"close-task\", \"meet\", \"event\", \"remind\", \"help\"]"
+          "signature": "readonly [\"init\", \"config\", \"extension\", \"package\", \"packages\", \"install\", \"upgrade\", \"create\", \"item\", \"copy\", \"focus\", \"list\", \"list-all\", \"list-draft\", \"list-open\", \"list-in-progress\", \"list-blocked\", \"list-closed\", \"list-canceled\", \"aggregate\", \"context\", \"ctx\", \"get\", \"graph\", \"search\", \"duplicates\", \"eval\", \"next\", \"history\", \"events\", \"history-redact\", \"history-repair\", \"history-compact\", \"history-author-acknowledge\", \"merge\", \"schema\", \"profile\", \"activity\", \"restore\", \"update\", \"update-many\", \"close\", \"close-many\", \"delete\", \"append\", \"comments\", \"notes\", \"learnings\", \"files\", \"docs\", \"deps\", \"plan\", \"test\", \"test-all\", \"telemetry\", \"stats\", \"health\", \"validate\", \"assurance\", \"gc\", \"workspace\", \"contracts\", \"claim\", \"release\", \"start-task\", \"pause-task\", \"close-task\", \"meet\", \"event\", \"remind\", \"help\"]"
         },
         {
           "classification": "advanced_export",
@@ -7733,7 +8349,7 @@
           "classification": "advanced_export",
           "kind": "value",
           "name": "PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS",
-          "signature": "readonly [{ readonly command: \"activity\"; readonly complete_mode: \"full\"; readonly omissions_by_mode: { readonly compact: readonly [{ readonly name: \"provenance\"; readonly restore_with: \"--full\"; }]; readonly provenance: readonly [{ readonly name: \"patch_and_hashes\"; readonly restore_with: \"--full\"; }]; }; }, { readonly command: \"history\"; readonly complete_mode: \"full\"; readonly omissions_by_mode: { readonly compact: readonly [{ readonly name: \"raw_history\"; readonly restore_with: \"--full\"; }]; readonly provenance: readonly [{ readonly name: \"patch_and_hashes\"; readonly restore_with: \"--full\"; }]; }; }]"
+          "signature": "readonly [{ readonly command: \"activity\"; readonly complete_mode: \"full\"; readonly omissions_by_mode: { readonly digest: readonly [{ readonly name: \"event_rows\"; readonly restore_with: \"--raw\"; }]; readonly compact: readonly [{ readonly name: \"provenance\"; readonly restore_with: \"--full\"; }]; readonly provenance: readonly [{ readonly name: \"patch_and_hashes\"; readonly restore_with: \"--full\"; }]; }; }, { readonly command: \"history\"; readonly complete_mode: \"full\"; readonly omissions_by_mode: { readonly compact: readonly [{ readonly name: \"raw_history\"; readonly restore_with: \"--full\"; }]; readonly provenance: readonly [{ readonly name: \"patch_and_hashes\"; readonly restore_with: \"--full\"; }]; }; }]"
         },
         {
           "classification": "supported",
@@ -7781,13 +8397,13 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"1.1.0\""
+          "signature": "\"1.3.0\""
         },
         {
           "classification": "supported",
           "kind": "value",
           "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
-          "signature": "readonly [\"--output-session\"]"
+          "signature": "readonly [\"--output-session\", \"--output-row-contract\"]"
         },
         {
           "classification": "supported",
@@ -7829,7 +8445,7 @@
           "classification": "advanced_export",
           "kind": "value",
           "name": "PM_READ_ROW_CONTRACTS",
-          "signature": "{ readonly context: { readonly row_keys: readonly [\"high_level\", \"low_level\"]; readonly fields: \"supported\"; }; readonly get: { readonly row_keys: readonly [\"children\"]; readonly fields: \"supported\"; }; readonly list: { readonly row_keys: readonly [\"items\"]; readonly fields: \"supported\"; }; readonly next: { readonly row_keys: readonly [\"recommended\", \"ready\", \"decision_needed\", \"blocked\", \"held_by_others\"]; readonly fields: \"unsupported\"; }; readonly search: { readonly row_keys: readonly [\"items\"]; readonly fields: \"supported\"; }; readonly activity: { readonly row_keys: readonly [\"compact_activity\", \"provenance_activity\", \"activity\"]; readonly fields: \"unsupported\"; }; readonly history: { readonly row_keys: readonly [\"compact_history\", \"provenance_history\", \"history\"]; readonly fields: \"unsupported\"; }; readonly deps: { readonly row_keys: readonly [\"graph.nodes\", \"graph.edges\", \"context.nodes\", \"context.edges\"]; readonly fields: \"unsupported\"; }; readonly health: { readonly row_keys: readonly [\"checks\"]; readonly fields: \"unsupported\"; }; readonly aggregate: { readonly row_keys: readonly [\"groups\"]; readonly fields: \"unsupported\"; }; readonly duplicates: { readonly row_keys: readonly [\"clusters\"]; readonly fields: \"unsupported\"; }; readonly stats: { readonly row_keys: readonly [\"by_type\", \"by_status\"]; readonly fields: \"unsupported\"; }; readonly comments: { readonly row_keys: readonly [\"comments\"]; readonly fields: \"unsupported\"; }; readonly notes: { readonly row_keys: readonly [\"notes\"]; readonly fields: \"unsupported\"; }; readonly learnings: { readonly row_keys: readonly [\"learnings\"]; readonly fields: \"unsupported\"; }; readonly files: { readonly row_keys: readonly [\"files\"]; readonly fields: \"unsupported\"; }; readonly docs: { readonly row_keys: readonly [\"docs\"]; readonly fields: \"unsupported\"; }; readonly validate: { readonly row_keys: readonly [\"checks\", \"warnings\"]; readonly fields: \"unsupported\"; }; readonly contracts: { readonly row_keys: readonly [\"command_summaries\", \"commands\"]; readonly fields: \"unsupported\"; }; }"
+          "signature": "{ readonly context: { readonly row_keys: readonly [\"high_level\", \"low_level\"]; readonly fields: \"supported\"; }; readonly get: { readonly row_keys: readonly [\"children\"]; readonly fields: \"supported\"; }; readonly list: { readonly row_keys: readonly [\"items\"]; readonly fields: \"supported\"; }; readonly next: { readonly row_keys: readonly [\"recommended\", \"ready\", \"decision_needed\", \"blocked\", \"held_by_others\"]; readonly fields: \"unsupported\"; }; readonly search: { readonly row_keys: readonly [\"items\"]; readonly fields: \"supported\"; }; readonly activity: { readonly row_keys: readonly [\"activity_digest\", \"compact_activity\", \"provenance_activity\", \"activity\"]; readonly fields: \"unsupported\"; }; readonly history: { readonly row_keys: readonly [\"compact_history\", \"provenance_history\", \"history\"]; readonly fields: \"unsupported\"; }; readonly deps: { readonly row_keys: readonly [\"graph.nodes\", \"graph.edges\", \"context.nodes\", \"context.edges\"]; readonly fields: \"unsupported\"; }; readonly health: { readonly row_keys: readonly [\"checks\"]; readonly fields: \"unsupported\"; }; readonly aggregate: { readonly row_keys: readonly [\"groups\"]; readonly fields: \"unsupported\"; }; readonly duplicates: { readonly row_keys: readonly [\"clusters\"]; readonly fields: \"unsupported\"; }; readonly stats: { readonly row_keys: readonly [\"by_type\", \"by_status\"]; readonly fields: \"unsupported\"; }; readonly comments: { readonly row_keys: readonly [\"comments\"]; readonly fields: \"unsupported\"; }; readonly notes: { readonly row_keys: readonly [\"notes\"]; readonly fields: \"unsupported\"; }; readonly learnings: { readonly row_keys: readonly [\"learnings\"]; readonly fields: \"unsupported\"; }; readonly files: { readonly row_keys: readonly [\"files\"]; readonly fields: \"unsupported\"; }; readonly docs: { readonly row_keys: readonly [\"docs\"]; readonly fields: \"unsupported\"; }; readonly validate: { readonly row_keys: readonly [\"checks\", \"warnings\"]; readonly fields: \"unsupported\"; }; readonly contracts: { readonly row_keys: readonly [\"command_summaries\", \"commands\"]; readonly fields: \"unsupported\"; }; }"
         },
         {
           "classification": "advanced_export",
@@ -7871,7 +8487,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.4.1\""
+          "signature": "\"4.7.0\""
         },
         {
           "classification": "contract_data",
@@ -7937,7 +8553,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "advanced_export",
@@ -7985,7 +8601,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "PmCliErrorRecoveryPayload",
-          "signature": "export interface PmCliErrorRecoveryPayload { recovery_mode?: \"compact\"; attempted_command?: string; normalized_args?: string[]; provided_fields?: string[]; missing?: string[]; missing_required_fields?: string[]; suggested_flags?: string[]; suggested_retry?: string; retry_after_ms?: number; fallback_candidates?: Array<{ source: string; command: string; reason: string; }>; next_best_command?: string; }"
+          "signature": "export interface PmCliErrorRecoveryPayload { recovery_mode?: \"compact\"; attempted_command?: string; normalized_args?: string[]; parsed_positionals?: Array<{ role: string; value: string; }>; provided_fields?: string[]; missing?: string[]; missing_required_fields?: string[]; suggested_flags?: string[]; allowed_values?: string[]; candidate_commands?: string[]; candidate_commands_total?: number; candidate_commands_truncated?: boolean; suggested_retry?: string; retry_after_ms?: number; fallback_candidates?: Array<{ source: string; command: string; reason: string; }>; next_best_command?: string; }"
         },
         {
           "classification": "advanced_export",
@@ -8141,7 +8757,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmErrorCodeContract",
-          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; }"
+          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; owned_states?: PmRefusalStateContract[]; }"
         },
         {
           "classification": "contract_data",
@@ -8333,7 +8949,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; outputRowContract?: boolean; }"
         },
         {
           "classification": "supported",
@@ -8363,7 +8979,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputSessionReceipt",
-          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; seen_item_overflow_count?: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
         },
         {
           "classification": "supported",
@@ -8389,6 +9005,30 @@
           "name": "PmReadOutputSurfaceContract",
           "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmRefusalProbeObservation",
+          "signature": "export interface PmRefusalProbeObservation { probe_id: string; entrypoint: string; code: string; exit_class: PmErrorCodeClass; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmRefusalReachabilityFinding",
+          "signature": "export interface PmRefusalReachabilityFinding { kind: \"duplicate_probe\" | \"missing_probe\" | \"wrong_entrypoint\" | \"wrong_error_code\" | \"wrong_exit_class\" | \"undeclared_probe\"; probe_id: string; detail: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmRefusalReachabilityReport",
+          "signature": "export interface PmRefusalReachabilityReport { ok: boolean; declared_probe_count: number; observed_probe_count: number; findings: PmRefusalReachabilityFinding[]; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmRefusalStateContract",
+          "signature": "export interface PmRefusalStateContract { state: string; probe_id: string; entrypoints: string[]; expected_exit_class: PmErrorCodeClass; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -8869,6 +9509,12 @@
           "name": "pruneCompileCacheGenerations",
           "signature": "(cacheRoot: string, currentGeneration: string) => CompileCachePruneResult | calls: (cacheRoot: string, currentGeneration: string) => CompileCachePruneResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "putAssuranceDeclaration",
+          "signature": "(pmRoot: string, kind: AssuranceDeclarationKind, definition: AssuranceDeclaration, options?: AssuranceMutationOptions) => Promise<AssuranceMutationReceipt> | calls: (pmRoot: string, kind: AssuranceDeclarationKind, definition: AssuranceDeclaration, options?: AssuranceMutationOptions) => Promise<AssuranceMutationReceipt>"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -9059,7 +9705,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "ReadRowContract",
-          "signature": "export interface ReadRowContract { command: string; row_kind: \"collection\" | \"none\"; row_keys: string[]; fields: \"supported\" | \"unsupported\"; jq_selector?: string; }"
+          "signature": "export interface ReadRowContract { command: string; row_kind: \"collection\" | \"none\"; row_keys: string[]; fields: \"supported\" | \"unsupported\"; jq_selector?: string; toon_encoding?: \"tabular_when_uniform\"; }"
         },
         {
           "classification": "advanced_export",
@@ -9139,6 +9785,18 @@
           "name": "recordAfterCommandAffectedItem",
           "signature": "(item: AfterCommandAffectedItem) => void | calls: (item: AfterCommandAffectedItem) => void"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "recordAssuranceVerdict",
+          "signature": "(pmRoot: string, verdict: AssuranceGateVerdict, options?: AssuranceMutationOptions) => Promise<void> | calls: (pmRoot: string, verdict: AssuranceGateVerdict, options?: AssuranceMutationOptions) => Promise<void>"
+        },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "recordClaimSemanticAttribution",
+          "signature": "(params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId: string; }) => Promise<void> | calls: (params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId: string; }) => Promise<void>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -9157,6 +9815,12 @@
           "name": "recordContextUsageTouches",
           "signature": "(options: ContextUsageLedgerOptions & { author: string; itemIds: readonly string[]; intent: string; }) => Promise<void> | calls: (options: ContextUsageLedgerOptions & { author: string; itemIds: readonly string[]; intent: string; }) => Promise<void>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "recordFocusSemanticAttribution",
+          "signature": "(params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId?: string; }) => Promise<void> | calls: (params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId?: string; }) => Promise<void>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -9175,6 +9839,12 @@
           "name": "RecordImprovementObservationResult",
           "signature": "export interface RecordImprovementObservationResult { changed: boolean; observation: ImprovementObservation; ledger_path: \"improvement-ledger.json\"; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "recordReleaseSemanticAttribution",
+          "signature": "(params: { pmRoot: string; principal: string; itemId: string; }) => Promise<void> | calls: (params: { pmRoot: string; principal: string; itemId: string; }) => Promise<void>"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -9391,6 +10061,12 @@
           "name": "registerHarnessSignalDescriptors",
           "signature": "(descriptors: readonly HarnessSignalDescriptor[]) => () => void | calls: (descriptors: readonly HarnessSignalDescriptor[]) => () => void"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "registerOutputMaterialFieldGroups",
+          "signature": "(result: object, fieldGroups: readonly string[]) => void | calls: (result: object, fieldGroups: readonly string[]) => void"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -9431,7 +10107,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipAuditDelta",
-          "signature": "export interface RelationshipAuditDelta { baseline_saved_at: string; same_snapshot: boolean; affected_subjects_by_code: Record<string, number>; profile: { nodes: number; edges: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; edges_by_kind: Record<string, number>; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }; }"
+          "signature": "export interface RelationshipAuditDelta { baseline_saved_at: string; same_snapshot: boolean; affected_subjects_by_code: Record<string, number>; profile: { nodes: number; edges: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }; }"
         },
         {
           "classification": "supported",
@@ -9551,7 +10227,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipCoverageProfile",
-          "signature": "export interface RelationshipCoverageProfile { nodes: number; edges: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }"
+          "signature": "export interface RelationshipCoverageProfile { nodes: number; edges: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }"
         },
         {
           "classification": "supported",
@@ -9949,6 +10625,12 @@
           "name": "ReminderShortcutOptions",
           "signature": "export interface ReminderShortcutOptions extends SchedulingShortcutCommonOptions { at?: string; text?: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "removeAssuranceDeclaration",
+          "signature": "(pmRoot: string, kind: AssuranceDeclarationKind, id: string, options?: AssuranceMutationOptions) => Promise<AssuranceMutationReceipt> | calls: (pmRoot: string, kind: AssuranceDeclarationKind, id: string, options?: AssuranceMutationOptions) => Promise<AssuranceMutationReceipt>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -10573,6 +11255,12 @@
           "name": "resolveSemanticCorpusCharacterLimit",
           "signature": "(providerName: string | undefined, configuredMaxCharacters: unknown) => SemanticCorpusCharacterLimitResolution | calls: (providerName: string | undefined, configuredMaxCharacters: unknown) => SemanticCorpusCharacterLimitResolution"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "resolveSemanticLineageIds",
+          "signature": "(pmRoot: string, settings: Awaited<ReturnType<typeof readSettings>>, itemId: string) => Promise<string[]> | calls: (pmRoot: string, settings: Awaited<ReturnType<typeof readSettings>>, itemId: string) => Promise<string[]>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -10801,6 +11489,18 @@
           "name": "runAppend",
           "signature": "(id: string, options: AppendCommandOptions, global: GlobalOptions) => Promise<AppendResult> | calls: (id: string, options: AppendCommandOptions, global: GlobalOptions) => Promise<AppendResult>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "runAssuranceAction",
+          "signature": "(input: AssuranceActionInput, global?: Pick<GlobalOptions, \"path\">) => Promise<AssuranceActionResult> | calls: (input: AssuranceActionInput, global?: Pick<GlobalOptions, \"path\">) => Promise<AssuranceActionResult>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "runAssuranceDispatch",
+          "signature": "(args: Record<string, unknown>, options: Record<string, unknown>, global: GlobalOptions) => Promise<AssuranceActionResult> | calls: (args: Record<string, unknown>, options: Record<string, unknown>, global: GlobalOptions) => Promise<AssuranceActionResult>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12139,6 +12839,18 @@
           "name": "selectWorkspaceMemoryRollups",
           "signature": "(snapshot: WorkspaceMemorySnapshot, tokenBudget: number, limit?: number) => WorkspaceMemoryRollup[] | calls: (snapshot: WorkspaceMemorySnapshot, tokenBudget: number, limit?: number) => WorkspaceMemoryRollup[]"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "SEMANTIC_ATTRIBUTION_LIMITS",
+          "signature": "{ readonly lineage_depth: 16; readonly active_items: 64; readonly evidence_rows: 32; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "semanticAttributionAffinity",
+          "signature": "(attribution: AgentSemanticAttribution | undefined) => Readonly<Record<string, number>> | undefined | calls: (attribution: AgentSemanticAttribution | undefined) => Readonly<Record<string, number>> | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12385,6 +13097,42 @@
           "name": "SourceContextWritePolicy",
           "signature": "export interface SourceContextWritePolicy { access: SourceContextAccessMode; write_override_applied: boolean; source_writes_allowed: boolean; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceDecisionPath",
+          "signature": "export interface SourceDecisionPath { status: \"found\" | \"ambiguous\" | \"not_found\"; nodes: string[]; kinds: string[]; alternative_decision_ids: string[]; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceLineRange",
+          "signature": "export interface SourceLineRange { start: number; end: number; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceTraceabilityEvidence",
+          "signature": "export interface SourceTraceabilityEvidence { kind: \"linked_file\" | \"git_commit\"; reference: string; contribution_lines?: number; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceTraceabilityExplanation",
+          "signature": "export interface SourceTraceabilityExplanation { score: number; contribution_lines: number; evidence: SourceTraceabilityEvidence[]; rationale: SourceTraceabilityRationale; decision_path: SourceDecisionPath; ambiguities: string[]; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceTraceabilityRationale",
+          "signature": "export interface SourceTraceabilityRationale { value: string | null; why_now: string | null; outcome: string | null; objective: string | null; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceTraceabilityReceipt",
+          "signature": "export interface SourceTraceabilityReceipt { line_range: SourceLineRange | null; blamed_commit_count: number; mapped_commit_count: number; unmapped_commit_count: number; decision_depth: number; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12403,6 +13151,12 @@
           "name": "splitFrontMatter",
           "signature": "(content: string) => { frontMatter: string; body: string; } | calls: (content: string) => { frontMatter: string; body: string; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "stabilizeReadOutputReceiptEstimates",
+          "signature": "(result: Record<string, unknown>, options: Record<string, unknown>) => Record<string, unknown> | calls: (result: Record<string, unknown>, options: Record<string, unknown>) => Record<string, unknown>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12485,13 +13239,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "StatsCommandOptions",
-          "signature": "export interface StatsCommandOptions { storage?: boolean; metadataCoverage?: boolean; byAssignee?: boolean; byTag?: boolean; byPriority?: boolean; tagPrefix?: string; fieldUtilization?: boolean; measurements?: boolean; metric?: string; measurementLimit?: number; observe?: string[]; direction?: ImprovementDirection; measurementSource?: string; measurementItem?: string; measurementRevision?: string; author?: string; message?: string; provenanceCoverage?: boolean; fleetAttribution?: boolean; since?: string; eventLimit?: number; minimumSample?: number; }"
+          "signature": "export interface StatsCommandOptions { includeEmpty?: boolean; storage?: boolean; metadataCoverage?: boolean; byAssignee?: boolean; byTag?: boolean; byPriority?: boolean; tagPrefix?: string; fieldUtilization?: boolean; measurements?: boolean; metric?: string; measurementLimit?: number; observe?: string[]; direction?: ImprovementDirection; measurementSource?: string; measurementItem?: string; measurementRevision?: string; author?: string; message?: string; provenanceCoverage?: boolean; fleetAttribution?: boolean; since?: string; eventLimit?: number; minimumSample?: number; }"
         },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "StatsResult",
-          "signature": "export interface StatsResult { totals: { items: number; history_streams: number; history_entries: number; }; by_type: Record<ItemType, number>; by_status: Record<ItemStatus, number>; metadata_coverage?: MetadataCoverageReport; breakdowns?: { assignee?: GroupedBreakdown; tag?: GroupedBreakdown; priority?: GroupedBreakdown; }; storage?: HistoryStorageStats; field_utilization?: ContentFieldUtilizationReport; improvement_ledger?: ImprovementLedgerResult; recorded_observations?: RecordImprovementObservationResult[]; provenance_coverage?: ProvenanceCoverageAnalytics; fleet_attribution?: FleetAttributionAnalytics; generated_at: string; }"
+          "signature": "export interface StatsResult { totals: { items: number; history_streams: number; history_entries: number; }; by_type: StatsTypeBreakdown; by_status: Partial<Record<ItemStatus, number>>; omitted_zero_buckets: number; metadata_coverage?: MetadataCoverageReport; breakdowns?: { assignee?: GroupedBreakdown; tag?: GroupedBreakdown; priority?: GroupedBreakdown; }; storage?: HistoryStorageStats; field_utilization?: ContentFieldUtilizationReport; improvement_ledger?: ImprovementLedgerResult; recorded_observations?: RecordImprovementObservationResult[]; provenance_coverage?: ProvenanceCoverageAnalytics; fleet_attribution?: FleetAttributionAnalytics; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -12583,6 +13337,12 @@
           "name": "summarizeMergeReceipt",
           "signature": "(receipt: MergeDecisionReceipt) => MergeDecisionReceiptSummary | calls: (receipt: MergeDecisionReceipt) => MergeDecisionReceiptSummary"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "SUPPORTED_HISTORY_ITEM_HASH_VERSIONS",
+          "signature": "readonly [1, 2]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -12797,7 +13557,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestCommandOptions",
-          "signature": "export interface TestCommandOptions { add?: string[]; addJson?: string[]; remove?: string[]; 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; 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",
@@ -12809,7 +13569,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "TestResult",
-          "signature": "export interface TestResult { ok: boolean; id: string; tests: LinkedTest[]; run_results: TestRunResult[]; failure_categories: Record<LinkedTestFailureCategory, number>; selection?: Omit<LinkedTestRunSelection, \"selected\">; fail_on_skipped_triggered?: boolean; warnings?: string[]; changed: boolean; count: number; measurements?: TestRunMeasurement[]; metric_below?: Array<TestRunMeasurement & { run_id: string; }>; metric_diff?: TestRunMeasurementDiff; }"
+          "signature": "export interface TestResult { ok: boolean; id: string; tests: LinkedTest[]; run_results: TestRunResult[]; failure_categories: Record<LinkedTestFailureCategory, number>; selection?: Omit<LinkedTestRunSelection, \"selected\">; fail_on_skipped_triggered?: boolean; warnings?: string[]; changed: boolean; count: number; removed?: number; measurements?: TestRunMeasurement[]; metric_below?: Array<TestRunMeasurement & { run_id: string; }>; metric_diff?: TestRunMeasurementDiff; }"
         },
         {
           "classification": "advanced_export",
@@ -13141,12 +13901,24 @@
           "name": "TYPE_TO_FOLDER",
           "signature": "Record<\"Chore\" | \"Decision\" | \"Epic\" | \"Event\" | \"Feature\" | \"Issue\" | \"Meeting\" | \"Milestone\" | \"Plan\" | \"Reminder\" | \"Task\", string>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "UNKNOWN_SUBCOMMAND_COMPATIBILITY_CODES",
+          "signature": "readonly [{ readonly code: \"unknown_lifecycle_action\"; }]"
+        },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "UnknownAuthorHistoryEvent",
           "signature": "export interface UnknownAuthorHistoryEvent { item_id: string; line: number; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "UnknownSubcommandErrorOptions",
+          "signature": "export interface UnknownSubcommandErrorOptions { command_path: string; token: string; allowed: readonly string[]; display_name?: string; token_kind?: \"subcommand\" | \"action\" | \"path\"; trailing_args?: readonly string[]; retry_command?: string; message_suffix?: string; fallback_candidates?: PmCliErrorRecoveryPayload[\"fallback_candidates\"]; exit_code?: number; examples?: readonly string[]; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -13285,11 +14057,23 @@
           "name": "VALIDATE_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "validateAssertionDefinition",
+          "signature": "(definition: AssuranceAssertionDefinition) => AssuranceAssertionDefinition | calls: (definition: AssuranceAssertionDefinition) => AssuranceAssertionDefinition"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "validateAssuranceDocument",
+          "signature": "(document: AssuranceDocument) => AssuranceDocument | calls: (document: AssuranceDocument) => AssuranceDocument"
+        },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "ValidateCheck",
-          "signature": "export interface ValidateCheck { name: ValidateCheckName; status: ValidateStatus; details: Record<string, unknown>; }"
+          "signature": "export interface ValidateCheck { name: ValidateCheckName; status: ValidateStatus; ok: boolean; details: Record<string, unknown>; }"
         },
         {
           "classification": "supported",
@@ -13315,6 +14099,12 @@
           "name": "ValidateFixesSummary",
           "signature": "export interface ValidateFixesSummary { mode: \"apply\" | \"dry_run\"; auto_fix: boolean; prune_missing: boolean; granted_fix_scopes: string[]; planned_count: number; applied_count: number; gated_count: number; failed_count: number; planned_fixes: Array<Record<string, unknown>>; applied_fixes: Array<Record<string, unknown>>; gated_fixes: Array<Record<string, unknown>>; failed_fixes: Array<Record<string, unknown>>; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "validateGateDefinition",
+          "signature": "(definition: AssuranceGateDefinition) => AssuranceGateDefinition | calls: (definition: AssuranceGateDefinition) => AssuranceGateDefinition"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -13327,6 +14117,12 @@
           "name": "validateLinkedPaths",
           "signature": "(paths: string[], workspaceRoot?: string) => Promise<LinkedPathValidation> | calls: (paths: string[], workspaceRoot?: string) => Promise<LinkedPathValidation>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "validateMeasurementDefinition",
+          "signature": "(definition: AssuranceMeasurementDefinition) => AssuranceMeasurementDefinition | calls: (definition: AssuranceMeasurementDefinition) => AssuranceMeasurementDefinition"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -13429,12 +14225,24 @@
           "name": "verifyHistoryChain",
           "signature": "(entries: HistoryEntry[]) => { ok: boolean; errors: string[]; } | calls: (entries: HistoryEntry[]) => { ok: boolean; errors: string[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "verifyHistoryChainWithVersion",
+          "signature": "(entries: HistoryEntry[]) => { ok: boolean; errors: string[]; item_hash_version?: HistoryItemHashVersion; } | calls: (entries: HistoryEntry[]) => { ok: boolean; errors: string[]; item_hash_version?: HistoryItemHashVersion; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
           "name": "verifyHistoryEntries",
           "signature": "(history: HistoryEntry[], currentDocument?: ItemDocument) => HistoryVerificationResult | calls: (history: HistoryEntry[], currentDocument?: ItemDocument) => HistoryVerificationResult"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "verifyPmRefusalReachability",
+          "signature": "(catalog: readonly PmErrorCodeContract[], observations: readonly PmRefusalProbeObservation[]) => PmRefusalReachabilityReport | calls: (catalog: readonly PmErrorCodeContract[], observations: readonly PmRefusalProbeObservation[]) => PmRefusalReachabilityReport"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -15181,6 +15989,12 @@
           "name": "applyReadOutputDimensions",
           "signature": "<Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => PmReadOutputResult<Result> | calls: <Result extends Record<string, unknown>>(command: string, options: Record<string, unknown>, result: Result) => PmReadOutputResult<Result>"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "ASSURANCE_FLAG_CONTRACTS",
+          "signature": "CliFlagContract[]"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -15863,7 +16677,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_CORE_COMMAND_NAMES",
-          "signature": "readonly [\"init\", \"config\", \"extension\", \"package\", \"packages\", \"install\", \"upgrade\", \"create\", \"item\", \"copy\", \"focus\", \"list\", \"list-all\", \"list-draft\", \"list-open\", \"list-in-progress\", \"list-blocked\", \"list-closed\", \"list-canceled\", \"aggregate\", \"context\", \"ctx\", \"get\", \"graph\", \"search\", \"duplicates\", \"eval\", \"next\", \"history\", \"events\", \"history-redact\", \"history-repair\", \"history-compact\", \"history-author-acknowledge\", \"merge\", \"schema\", \"profile\", \"activity\", \"restore\", \"update\", \"update-many\", \"close\", \"close-many\", \"delete\", \"append\", \"comments\", \"notes\", \"learnings\", \"files\", \"docs\", \"deps\", \"plan\", \"test\", \"test-all\", \"telemetry\", \"stats\", \"health\", \"validate\", \"gc\", \"workspace\", \"contracts\", \"claim\", \"release\", \"start-task\", \"pause-task\", \"close-task\", \"meet\", \"event\", \"remind\", \"help\"]"
+          "signature": "readonly [\"init\", \"config\", \"extension\", \"package\", \"packages\", \"install\", \"upgrade\", \"create\", \"item\", \"copy\", \"focus\", \"list\", \"list-all\", \"list-draft\", \"list-open\", \"list-in-progress\", \"list-blocked\", \"list-closed\", \"list-canceled\", \"aggregate\", \"context\", \"ctx\", \"get\", \"graph\", \"search\", \"duplicates\", \"eval\", \"next\", \"history\", \"events\", \"history-redact\", \"history-repair\", \"history-compact\", \"history-author-acknowledge\", \"merge\", \"schema\", \"profile\", \"activity\", \"restore\", \"update\", \"update-many\", \"close\", \"close-many\", \"delete\", \"append\", \"comments\", \"notes\", \"learnings\", \"files\", \"docs\", \"deps\", \"plan\", \"test\", \"test-all\", \"telemetry\", \"stats\", \"health\", \"validate\", \"assurance\", \"gc\", \"workspace\", \"contracts\", \"claim\", \"release\", \"start-task\", \"pause-task\", \"close-task\", \"meet\", \"event\", \"remind\", \"help\"]"
         },
         {
           "classification": "contract_data",
@@ -15947,13 +16761,13 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"1.1.0\""
+          "signature": "\"1.3.0\""
         },
         {
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
-          "signature": "readonly [\"--output-session\"]"
+          "signature": "readonly [\"--output-session\", \"--output-row-contract\"]"
         },
         {
           "classification": "contract_data",
@@ -16013,7 +16827,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.4.1\""
+          "signature": "\"4.7.0\""
         },
         {
           "classification": "contract_data",
@@ -16175,7 +16989,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmErrorCodeContract",
-          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; }"
+          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; owned_states?: PmRefusalStateContract[]; }"
         },
         {
           "classification": "contract_data",
@@ -16307,7 +17121,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; outputRowContract?: boolean; }"
         },
         {
           "classification": "contract_data",
@@ -16331,7 +17145,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmReadOutputSessionReceipt",
-          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; seen_item_overflow_count?: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
         },
         {
           "classification": "contract_data",
@@ -16351,6 +17165,12 @@
           "name": "PmReadOutputSurfaceContract",
           "signature": "export interface PmReadOutputSurfaceContract { command: PmReadOutputSurface; dimensions: Record<PmReadOutputDimension, PmReadOutputDimensionContract>; precedence: readonly [ \"canonical\", \"legacy\", \"intent\", \"default\" ]; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmRefusalStateContract",
+          "signature": "export interface PmRefusalStateContract { state: string; probe_id: string; entrypoints: string[]; expected_exit_class: PmErrorCodeClass; }"
+        },
         {
           "classification": "contract_data",
           "kind": "interface",
@@ -16555,6 +17375,12 @@
           "name": "SEARCH_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "stabilizeReadOutputReceiptEstimates",
+          "signature": "(result: Record<string, unknown>, options: Record<string, unknown>) => Record<string, unknown> | calls: (result: Record<string, unknown>, options: Record<string, unknown>) => Record<string, unknown>"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -16811,7 +17637,7 @@
           "classification": "supported",
           "kind": "type",
           "name": "AgentModelSource",
-          "signature": "export type AgentModelSource = \"override\" | \"environment\" | \"mcp_client\" | \"argv\" | \"host\" | \"session\" | \"probe\";"
+          "signature": "export type AgentModelSource = \"override\" | \"environment\" | \"mcp_client\" | \"argv\" | \"host\" | \"session\" | \"probe\" | \"inferred\";"
         },
         {
           "classification": "supported",
@@ -16841,7 +17667,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AgentProvenanceObservation",
-          "signature": "export interface AgentProvenanceObservation { value: string; source: AgentModelSource; }"
+          "signature": "export interface AgentProvenanceObservation { value: string; source: AgentModelSource; confidence?: \"high\" | \"medium\" | \"low\"; rule_version?: \"v2\"; evidence?: readonly string[]; }"
         },
         {
           "classification": "supported",
@@ -16849,6 +17675,18 @@
           "name": "AgentProvenanceOutcome",
           "signature": "export interface AgentProvenanceOutcome { status: \"resolved\" | \"unavailable\" | \"not_configured\" | \"failed\"; reason?: AgentProvenanceAbsenceReason; resolver?: AgentProvenanceResolver; rule_version: \"v1\"; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentSemanticAttributionCoverage",
+          "signature": "export interface AgentSemanticAttributionCoverage { harness: string; dimension: \"role\" | \"topic\"; entries: number; observed: number; by_source: Partial<Record<AgentModelSource, number>>; coverage: number; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AgentSemanticAttributionCoverageGate",
+          "signature": "export interface AgentSemanticAttributionCoverageGate { passed: boolean; minimum_coverage: number; minimum_entries: number; rows: AgentSemanticAttributionCoverage[]; failures: string[]; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -16927,6 +17765,18 @@
           "name": "applyReadOutputSessionReferences",
           "signature": "(result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown> | calls: (result: Record<string, unknown>, state: PmReadOutputSessionState) => Record<string, unknown>"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AssuranceActionInput",
+          "signature": "export interface AssuranceActionInput { action: string; kind?: string; id?: string; definition?: unknown; trigger?: string; tree?: string; gate?: string; limit?: number | string; dry_run?: boolean; fullChangedFields?: boolean; idOnly?: boolean; author?: string; message?: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "AssuranceActionResult",
+          "signature": "export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | { id: string; } | { items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { items: AssuranceGateVerdict[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; };"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -17191,12 +18041,24 @@
           "name": "emptyImportedDocument",
           "signature": "() => ItemDocument | calls: () => ItemDocument"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "evaluateSemanticAttributionCoverage",
+          "signature": "(entries: readonly Pick<HistoryEntry, \"agent_harness\" | \"agent_provenance\">[], options?: { minimumCoverage?: number; minimumEntries?: number; }) => AgentSemanticAttributionCoverageGate | calls: (entries: readonly Pick<HistoryEntry, \"agent_harness\" | \"agent_provenance\">[], options?: { minimumCoverage?: number; minimumEntries?: number; }) => AgentSemanticAttributionCoverageGate"
+        },
         {
           "classification": "supported",
           "kind": "value",
           "name": "EXIT_CODE",
           "signature": "{ readonly SUCCESS: 0; readonly GENERIC_FAILURE: 1; readonly USAGE: 2; readonly NOT_FOUND: 3; readonly CONFLICT: 4; readonly DEPENDENCY_FAILED: 5; readonly NO_EFFECT: 6; readonly PARTIAL_EFFECT: 7; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "explainSourceTraceability",
+          "signature": "(params: { workspaceRoot: string; paths: readonly string[]; candidates: readonly TraceabilityCandidate[]; corpus: readonly ItemMetadata[]; lineRange?: SourceLineRange; decisionDepth?: number; }) => Promise<{ explanations: Map<string, SourceTraceabilityExplanation>; receipt: SourceTraceabilityReceipt; }> | calls: (params: { workspaceRoot: string; paths: readonly string[]; candidates: readonly TraceabilityCandidate[]; corpus: readonly ItemMetadata[]; lineRange?: SourceLineRange; decisionDepth?: number; }) => Promise<{ explanations: Map<string, SourceTraceabilityExplanation>; receipt: SourceTraceabilityReceipt; }>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -17287,6 +18149,12 @@
           "name": "HarnessSignalDescriptor",
           "signature": "export interface HarnessSignalDescriptor { harness: string; environment_keys?: readonly string[]; model_environment_keys?: readonly string[]; session_environment_keys?: readonly string[]; provenance_environment_keys?: Readonly<Record<string, readonly string[] | undefined>>; provenance_resolvers?: Readonly<Record<string, AgentProvenanceResolver | undefined>>; provenance_unavailable_dimensions?: readonly string[]; argv_markers?: readonly string[]; client_names?: readonly string[]; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "isAlreadyClaimedError",
+          "signature": "(error: unknown) => boolean | calls: (error: unknown) => boolean"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -17455,6 +18323,12 @@
           "name": "parseReadOutputSession",
           "signature": "(value: unknown) => PmReadOutputSessionState | undefined | calls: (value: unknown) => PmReadOutputSessionState | undefined"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "parseSourceLineRange",
+          "signature": "(value: string) => SourceLineRange | calls: (value: string) => SourceLineRange"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -17465,7 +18339,7 @@
           "classification": "supported",
           "kind": "value",
           "name": "PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS",
-          "signature": "readonly [\"--output-session\"]"
+          "signature": "readonly [\"--output-session\", \"--output-row-contract\"]"
         },
         {
           "classification": "supported",
@@ -17507,7 +18381,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "supported",
@@ -17543,7 +18417,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; outputRowContract?: boolean; }"
         },
         {
           "classification": "supported",
@@ -17567,7 +18441,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputSessionReceipt",
-          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; seen_item_overflow_count?: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
         },
         {
           "classification": "supported",
@@ -17611,6 +18485,24 @@
           "name": "readOutputSessionRemainingTokens",
           "signature": "(state: PmReadOutputSessionState) => number | calls: (state: PmReadOutputSessionState) => number"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "recordClaimSemanticAttribution",
+          "signature": "(params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId: string; }) => Promise<void> | calls: (params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId: string; }) => Promise<void>"
+        },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "recordFocusSemanticAttribution",
+          "signature": "(params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId?: string; }) => Promise<void> | calls: (params: { pmRoot: string; settings: Awaited<ReturnType<typeof readSettings>>; principal: string; itemId?: string; }) => Promise<void>"
+        },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "recordReleaseSemanticAttribution",
+          "signature": "(params: { pmRoot: string; principal: string; itemId: string; }) => Promise<void> | calls: (params: { pmRoot: string; principal: string; itemId: string; }) => Promise<void>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -17671,6 +18563,12 @@
           "name": "resolveReadOutputSurface",
           "signature": "(command: string) => PmReadOutputSurface | undefined | calls: (command: string) => PmReadOutputSurface | undefined"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "resolveSemanticLineageIds",
+          "signature": "(pmRoot: string, settings: Awaited<ReturnType<typeof readSettings>>, itemId: string) => Promise<string[]> | calls: (pmRoot: string, settings: Awaited<ReturnType<typeof readSettings>>, itemId: string) => Promise<string[]>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -17755,12 +18653,60 @@
           "name": "SearchResult",
           "signature": "export type SearchResult = SearchCompactResult | SearchVerboseResult;"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "SEMANTIC_ATTRIBUTION_LIMITS",
+          "signature": "{ readonly lineage_depth: 16; readonly active_items: 64; readonly evidence_rows: 32; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "semanticAttributionAffinity",
+          "signature": "(attribution: AgentSemanticAttribution | undefined) => Readonly<Record<string, number>> | undefined | calls: (attribution: AgentSemanticAttribution | undefined) => Readonly<Record<string, number>> | undefined"
+        },
         {
           "classification": "supported",
           "kind": "function",
           "name": "serializeItemDocument",
           "signature": "(document: ItemDocument, options?: ItemDocumentFormatOptions) => string | calls: (document: ItemDocument, options?: ItemDocumentFormatOptions) => string"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceDecisionPath",
+          "signature": "export interface SourceDecisionPath { status: \"found\" | \"ambiguous\" | \"not_found\"; nodes: string[]; kinds: string[]; alternative_decision_ids: string[]; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceLineRange",
+          "signature": "export interface SourceLineRange { start: number; end: number; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceTraceabilityEvidence",
+          "signature": "export interface SourceTraceabilityEvidence { kind: \"linked_file\" | \"git_commit\"; reference: string; contribution_lines?: number; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceTraceabilityExplanation",
+          "signature": "export interface SourceTraceabilityExplanation { score: number; contribution_lines: number; evidence: SourceTraceabilityEvidence[]; rationale: SourceTraceabilityRationale; decision_path: SourceDecisionPath; ambiguities: string[]; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceTraceabilityRationale",
+          "signature": "export interface SourceTraceabilityRationale { value: string | null; why_now: string | null; outcome: string | null; objective: string | null; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "SourceTraceabilityReceipt",
+          "signature": "export interface SourceTraceabilityReceipt { line_range: SourceLineRange | null; blamed_commit_count: number; mapped_commit_count: number; unmapped_commit_count: number; decision_depth: number; }"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -17957,7 +18903,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "HealthCheck",
-          "signature": "export interface HealthCheck { name: \"settings\" | \"directories\" | \"settings_values\" | \"telemetry\" | \"extensions\" | \"storage\" | \"locks\" | \"integrity\" | \"history_drift\" | \"vectorization\"; status: HealthStatus; details: Record<string, unknown>; }"
+          "signature": "export interface HealthCheck { name: \"settings\" | \"directories\" | \"settings_values\" | \"telemetry\" | \"extensions\" | \"storage\" | \"locks\" | \"integrity\" | \"history_drift\" | \"vectorization\"; status: HealthStatus; ok: boolean; details: Record<string, unknown>; }"
         },
         {
           "classification": "supported",
@@ -18335,7 +19281,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ValidateCheck",
-          "signature": "export interface ValidateCheck { name: ValidateCheckName; status: ValidateStatus; details: Record<string, unknown>; }"
+          "signature": "export interface ValidateCheck { name: ValidateCheckName; status: ValidateStatus; ok: boolean; details: Record<string, unknown>; }"
         },
         {
           "classification": "supported",
@@ -19061,7 +20007,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipAuditDelta",
-          "signature": "export interface RelationshipAuditDelta { baseline_saved_at: string; same_snapshot: boolean; affected_subjects_by_code: Record<string, number>; profile: { nodes: number; edges: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; edges_by_kind: Record<string, number>; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }; }"
+          "signature": "export interface RelationshipAuditDelta { baseline_saved_at: string; same_snapshot: boolean; affected_subjects_by_code: Record<string, number>; profile: { nodes: number; edges: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }; }"
         },
         {
           "classification": "supported",
@@ -19181,7 +20127,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "RelationshipCoverageProfile",
-          "signature": "export interface RelationshipCoverageProfile { nodes: number; edges: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }"
+          "signature": "export interface RelationshipCoverageProfile { nodes: number; edges: number; edge_basis: \"deduplicated_directed\"; edges_by_kind: Record<string, number>; edge_share_by_kind: Record<string, number>; semantic_edges: number; semantic_edge_share: number; active_nodes: number; missing_nodes: number; isolated_active_nodes: number; degree_leq_one_active_nodes: number; coverage_by_type: Record<string, RelationshipCoverageTypeProfile>; }"
         },
         {
           "classification": "supported",
@@ -19697,7 +20643,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ItemDocumentMergeResult",
-          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
+          "signature": "export interface ItemDocumentMergeResult { merged: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; conflict_decisions: ItemMergeConflictDecision[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; }"
         },
         {
           "classification": "supported",
@@ -19733,13 +20679,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; 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[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceiptSummary",
-          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
+          "signature": "export interface MergeDecisionReceiptSummary { receipt_id: string; item_id: string; item_path: string; conflict_fields: string[]; fields_from_theirs: string[]; union_fields: string[]; requested_preference: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; decisions: Array<{ field: string; retained_hash: string; discarded_hash: string; }>; }"
         },
         {
           "classification": "supported",
@@ -19763,7 +20709,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDriverResult",
-          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; preferred: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
+          "signature": "export interface MergeDriverResult { ok: boolean; artifact: MergeDriverArtifact; output_path: string; requested_preference: MergePreferredSide; conflicts: string[]; history?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; relationship?: { strategy: string; common_entries: number; entries_from_ours: number; entries_from_theirs: number; entries_total: number; reanchored: boolean; }; item?: { fields_from_theirs: string[]; union_fields: string[]; conflict_resolution: \"stable_value_order\"; }; json?: { paths_from_theirs: string[]; }; receipt?: MergeDecisionReceiptSummary; guidance: string[]; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -19973,7 +20919,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ActivityCommandOptions",
-          "signature": "export interface ActivityCommandOptions { id?: string; op?: string; author?: string; from?: string; to?: string; limit?: string; compact?: boolean; unbounded?: boolean; provenance?: boolean; provenanceSummary?: boolean; harness?: string | readonly string[]; agentInstance?: string | readonly string[]; provenanceFilter?: string | readonly string[]; }"
+          "signature": "export interface ActivityCommandOptions { id?: string; op?: string; author?: string; from?: string; to?: string; limit?: string; compact?: boolean; raw?: boolean; unbounded?: boolean; provenance?: boolean; provenanceSummary?: boolean; harness?: string | readonly string[]; agentInstance?: string | readonly string[]; provenanceFilter?: string | readonly string[]; }"
         },
         {
           "classification": "supported",
@@ -19985,7 +20931,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ActivityResult",
-          "signature": "export interface ActivityResult { activity?: ActivityEntry[]; compact_activity?: CompactActivityEntry[]; provenance_activity?: HistoryProvenanceRow[]; compact: boolean; projection: { mode: \"compact\" | \"provenance\" | \"full\"; row_key: \"compact_activity\" | \"provenance_activity\" | \"activity\"; }; omission_receipt: OutputOmissionReceipt; count: number; total_count: number; limit: number | null; omitted_count: number; has_more: boolean; applied_bound: { kind: \"limit\" | \"unbounded\"; source: \"default\" | \"explicit\"; value: number | null; }; provenance_summary?: HistoryProvenanceSummary; }"
+          "signature": "export interface ActivityResult { activity_digest?: ActivityDigestEntry[]; activity?: ActivityEntry[]; compact_activity?: CompactActivityEntry[]; provenance_activity?: HistoryProvenanceRow[]; compact: boolean; projection: { mode: \"digest\" | \"compact\" | \"provenance\" | \"full\"; row_key: \"activity_digest\" | \"compact_activity\" | \"provenance_activity\" | \"activity\"; }; omission_receipt: OutputOmissionReceipt; count: number; total_count: number; limit: number | null; omitted_count: number; has_more: boolean; applied_bound: { kind: \"limit\" | \"unbounded\"; source: \"default\" | \"explicit\"; value: number | null; }; activity_summary?: { window: { from: string | null; to: string | null; }; event_count: number; item_count: number; author_count: number; operation_counts: Record<string, number>; }; provenance_summary?: HistoryProvenanceSummary; }"
         },
         {
           "classification": "supported",
@@ -21541,6 +22487,18 @@
           "name": "applyTerminalOrderingPolicy",
           "signature": "(metadata: ItemMetadata, policy: Pick<TerminalTransitionPolicy, \"orderingEdges\">) => TerminalOrderingMutation | calls: (metadata: ItemMetadata, policy: Pick<TerminalTransitionPolicy, \"orderingEdges\">) => TerminalOrderingMutation"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "AssuranceActionInput",
+          "signature": "export interface AssuranceActionInput { action: string; kind?: string; id?: string; definition?: unknown; trigger?: string; tree?: string; gate?: string; limit?: number | string; dry_run?: boolean; fullChangedFields?: boolean; idOnly?: boolean; author?: string; message?: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "AssuranceActionResult",
+          "signature": "export type AssuranceActionResult = AssuranceDeclaration | AssuranceMutationReceipt | AssuranceGateVerdict | { id: string; } | { items: AssuranceDeclaration[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; } | { items: AssuranceGateVerdict[]; count: number; row_contract: { row_keys: [ \"items\" ]; jq_selector: \".items[]\"; }; };"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -22043,13 +23001,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "FilesLookupOptions",
-          "signature": "export interface FilesLookupOptions { paths: string[]; scope?: LinkScope; limit?: number; offset?: number; noTruncate?: boolean; strictRead?: boolean; }"
+          "signature": "export interface FilesLookupOptions { paths: string[]; scope?: LinkScope; limit?: number; offset?: number; noTruncate?: boolean; strictRead?: boolean; explain?: boolean; lineRange?: SourceLineRange; decisionDepth?: number; }"
         },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "FilesLookupResult",
-          "signature": "export interface FilesLookupResult { paths: string[]; total: number; count: number; offset: number; limit: number | null; has_more: boolean; truncated: boolean; completeness: { status: \"complete\" | \"partial\" | \"unchecked\"; source: \"index\" | \"source_scan\"; }; warnings: string[]; matches: FilesLookupMatch[]; }"
+          "signature": "export interface FilesLookupResult { paths: string[]; total: number; count: number; offset: number; limit: number | null; has_more: boolean; truncated: boolean; completeness: { status: \"complete\" | \"partial\" | \"unchecked\"; source: \"index\" | \"source_scan\"; }; warnings: string[]; matches: FilesLookupMatch[]; traceability_receipt?: SourceTraceabilityReceipt; }"
         },
         {
           "classification": "supported",
@@ -22175,7 +23133,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "GlobalOptions",
-          "signature": "export interface GlobalOptions { json?: boolean; quiet?: boolean; noChangedFields?: boolean; fullChangedFields?: boolean; idOnly?: boolean; lean?: boolean; tokenAccounting?: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
+          "signature": "export interface GlobalOptions { json?: boolean; quiet?: boolean; noChangedFields?: boolean; fullChangedFields?: boolean; idOnly?: boolean; lean?: boolean; tokenAccounting?: boolean; outputInclude?: string; outputLimit?: string; outputBudget?: string; outputFormat?: \"toon\" | \"json\"; outputSession?: string; outputRowContract?: boolean; path?: string; noExtensions?: boolean; noPager?: boolean; profile?: boolean; author?: string; defaultOutputFormat?: \"toon\" | \"json\"; }"
         },
         {
           "classification": "supported",
@@ -22781,7 +23739,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "advanced_export",
@@ -22835,7 +23793,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmErrorCodeContract",
-          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; }"
+          "signature": "export interface PmErrorCodeContract { code: string; meaning: string; stability: PmErrorCodeStability; exit_code: 1 | 2 | 3 | 4 | 5; class: PmErrorCodeClass; recovery: string; sources: string[]; emitting_commands: string[]; canonical_code?: string; aliases?: string[]; owned_states?: PmRefusalStateContract[]; }"
         },
         {
           "classification": "supported",
@@ -22847,7 +23805,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputOptions",
-          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputOptions { outputInclude?: string | string[]; outputLimit?: string | number | \"unbounded\"; outputBudget?: string | number; outputFormat?: \"json\" | \"toon\"; outputSession?: string | PmReadOutputSessionState; outputRowContract?: boolean; }"
         },
         {
           "classification": "supported",
@@ -22865,7 +23823,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "PmReadOutputSessionReceipt",
-          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
+          "signature": "export interface PmReadOutputSessionReceipt { contract_version: 1; id: string; measurement_scope: \"complete_read_envelope\"; estimator: \"ceil(utf8_bytes / 4)\"; token_budget: number; spent_before_tokens: number; spent_this_call_tokens: number; charged_this_call_tokens: number; spent_total_tokens: number; remaining_tokens: number; exhausted: boolean; seen_before_count: number; new_item_count: number; seen_item_overflow_count?: number; suppressed_repeat_count: number; reference_format: \"session:<session-id>:<item-id>\"; restore_reference_with: \"pm get <item-id> --brief\"; next_state: PmReadOutputSessionState; }"
         },
         {
           "classification": "supported",
@@ -23711,13 +24669,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "StatsCommandOptions",
-          "signature": "export interface StatsCommandOptions { storage?: boolean; metadataCoverage?: boolean; byAssignee?: boolean; byTag?: boolean; byPriority?: boolean; tagPrefix?: string; fieldUtilization?: boolean; measurements?: boolean; metric?: string; measurementLimit?: number; observe?: string[]; direction?: ImprovementDirection; measurementSource?: string; measurementItem?: string; measurementRevision?: string; author?: string; message?: string; provenanceCoverage?: boolean; fleetAttribution?: boolean; since?: string; eventLimit?: number; minimumSample?: number; }"
+          "signature": "export interface StatsCommandOptions { includeEmpty?: boolean; storage?: boolean; metadataCoverage?: boolean; byAssignee?: boolean; byTag?: boolean; byPriority?: boolean; tagPrefix?: string; fieldUtilization?: boolean; measurements?: boolean; metric?: string; measurementLimit?: number; observe?: string[]; direction?: ImprovementDirection; measurementSource?: string; measurementItem?: string; measurementRevision?: string; author?: string; message?: string; provenanceCoverage?: boolean; fleetAttribution?: boolean; since?: string; eventLimit?: number; minimumSample?: number; }"
         },
         {
           "classification": "advanced_export",
           "kind": "interface",
           "name": "StatsResult",
-          "signature": "export interface StatsResult { totals: { items: number; history_streams: number; history_entries: number; }; by_type: Record<ItemType, number>; by_status: Record<ItemStatus, number>; metadata_coverage?: MetadataCoverageReport; breakdowns?: { assignee?: GroupedBreakdown; tag?: GroupedBreakdown; priority?: GroupedBreakdown; }; storage?: HistoryStorageStats; field_utilization?: ContentFieldUtilizationReport; improvement_ledger?: ImprovementLedgerResult; recorded_observations?: RecordImprovementObservationResult[]; provenance_coverage?: ProvenanceCoverageAnalytics; fleet_attribution?: FleetAttributionAnalytics; generated_at: string; }"
+          "signature": "export interface StatsResult { totals: { items: number; history_streams: number; history_entries: number; }; by_type: StatsTypeBreakdown; by_status: Partial<Record<ItemStatus, number>>; omitted_zero_buckets: number; metadata_coverage?: MetadataCoverageReport; breakdowns?: { assignee?: GroupedBreakdown; tag?: GroupedBreakdown; priority?: GroupedBreakdown; }; storage?: HistoryStorageStats; field_utilization?: ContentFieldUtilizationReport; improvement_ledger?: ImprovementLedgerResult; recorded_observations?: RecordImprovementObservationResult[]; provenance_coverage?: ProvenanceCoverageAnalytics; fleet_attribution?: FleetAttributionAnalytics; generated_at: string; }"
         },
         {
           "classification": "supported",
@@ -24618,9 +25576,12 @@
     "already_claimed_by",
     "ambiguous_list_all",
     "ambiguous_option_combination",
+    "annotation_alias_conflict",
     "annotation_flag_like_value",
     "annotation_message_without_text",
+    "annotation_transposed_subcommand",
     "append_empty_body",
+    "assurance_registry_invalid",
     "body_file_conflicts_with_body",
     "body_file_missing_path",
     "body_file_unreadable",
@@ -24632,6 +25593,7 @@
     "close_through_update",
     "close_validation_missing_fields",
     "collected_zero_items",
+    "collection_transposed_subcommand",
     "command_failed",
     "command_namespace",
     "command_override_conflict",
@@ -24729,6 +25691,7 @@
     "item_id_collision",
     "item_not_found",
     "likely_duplicate",
+    "linked_test_remove_no_match",
     "linked_test_value_not_quoted",
     "list_source_incomplete",
     "local_package_archive_unsafe",