@unbrained/pm-cli 2026.8.10 → 2026.8.11

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1483,
+    "covered_symbols": 1504,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1484
+    "required_symbols": 1505
   },
   "breaking_acknowledgements": [
     {
@@ -181,6 +181,127 @@
       ],
       "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"
     }
   ],
   "entrypoints": {
@@ -449,7 +570,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 +600,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 +608,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 +1142,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; 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?: Array<Record<string, unknown>>; tests?: Array<Record<string, unknown>>; docs?: Array<Record<string, unknown>>; [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; }"
+        },
+        {
+          "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; 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",
@@ -2540,10 +2967,22 @@
           "signature": "\"Closed at creation via pm create\""
         },
         {
-          "classification": "contract_data",
-          "kind": "value",
-          "name": "CREATE_FLAG_CONTRACTS",
-          "signature": "CliFlagContract[]"
+          "classification": "contract_data",
+          "kind": "value",
+          "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",
@@ -2563,6 +3002,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 +3140,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",
@@ -3505,12 +3956,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 +3998,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 +4076,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 +4812,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 +5072,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",
@@ -6109,6 +6596,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",
@@ -7333,6 +7832,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 +8118,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",
@@ -7781,7 +8286,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"1.1.0\""
+          "signature": "\"1.3.0\""
         },
         {
           "classification": "supported",
@@ -7871,7 +8376,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.4.1\""
+          "signature": "\"4.6.0\""
         },
         {
           "classification": "contract_data",
@@ -7937,7 +8442,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 +8490,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[]; 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 +8646,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",
@@ -8389,6 +8894,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 +9398,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",
@@ -9139,6 +9674,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 +9704,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 +9728,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",
@@ -9949,6 +10508,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 +11138,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 +11372,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 +12722,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 +12980,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",
@@ -13141,12 +13772,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,6 +13928,18 @@
           "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",
@@ -13315,6 +13970,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 +13988,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",
@@ -13435,6 +14102,12 @@
           "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 +15854,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 +16542,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,7 +16626,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"1.1.0\""
+          "signature": "\"1.3.0\""
         },
         {
           "classification": "contract_data",
@@ -16013,7 +16692,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.4.1\""
+          "signature": "\"4.6.0\""
         },
         {
           "classification": "contract_data",
@@ -16175,7 +16854,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",
@@ -16351,6 +17030,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",
@@ -16811,7 +17496,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 +17526,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 +17534,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 +17624,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 +17900,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",
@@ -17455,6 +18176,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",
@@ -17507,7 +18234,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",
@@ -17611,6 +18338,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 +18416,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 +18506,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",
@@ -21541,6 +22340,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 +22854,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",
@@ -22781,7 +23592,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 +23646,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",
@@ -24621,6 +25432,7 @@
     "annotation_flag_like_value",
     "annotation_message_without_text",
     "append_empty_body",
+    "assurance_registry_invalid",
     "body_file_conflicts_with_body",
     "body_file_missing_path",
     "body_file_unreadable",