@unbrained/pm-cli 2026.8.30 → 2026.9.1

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1811,
+    "covered_symbols": 1824,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1812
+    "required_symbols": 1825
   },
   "breaking_acknowledgements": [
     {
@@ -1406,6 +1406,63 @@
       ],
       "package_version": "2026.8.28",
       "reason": "Broaden resolveItemBlockers input to accept optional id and updated_at context already consumed by blocker projection"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_MCP_LEGACY_PROTOCOL_VERSIONS"
+      ],
+      "package_version": "2026.8.30",
+      "reason": "pm-edywqn: the legacy accept list widens to the full initialize-era set (2025-11-25 plus 2025-06-18) so every current MCP host can complete a handshake; the tuple literal type changes because the declared set is the contract, and no runtime behaviour is removed"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ListOptions",
+        "signature ./sdk:PmPositionalActionContract",
+        "signature ./sdk:RuntimeStatusRegistry",
+        "signature ./sdk/contracts:PmPositionalActionContract",
+        "signature ./sdk/core:ListOptions",
+        "signature ./sdk/query:ListOptions",
+        "signature ./sdk/runtime:ListOptions"
+      ],
+      "package_version": "2026.8.30",
+      "reason": "Add lifecycle-aware list selection, explicit workflow anchors, and workspace position contracts for SDK consumers."
+    },
+    {
+      "changes": [
+        "signature ./sdk:_testOnlyWorkspacePosition",
+        "signature ./sdk/governance:_testOnlyWorkspacePosition"
+      ],
+      "package_version": "2026.8.30",
+      "reason": "Add lifecycle-aware list selection, explicit workflow anchors, and workspace position contracts for SDK consumers."
+    },
+    {
+      "changes": [
+        "signature ./sdk:StatusRoleDiagnostics",
+        "signature ./sdk:WorkspacePositionResult",
+        "signature ./sdk:WorkspacePositionState",
+        "signature ./sdk/governance:StatusRoleDiagnostics",
+        "signature ./sdk/governance:WorkspacePositionResult",
+        "signature ./sdk/governance:WorkspacePositionState"
+      ],
+      "package_version": "2026.8.30",
+      "reason": "Fail closed on malformed history evidence and expose complete bounded lifecycle-role diagnostics"
+    },
+    {
+      "changes": [
+        "signature ./sdk:MergeReceiptEvidenceReport",
+        "signature ./sdk:MergeReceiptEvidenceScan",
+        "signature ./sdk/merge:MergeReceiptEvidenceReport",
+        "signature ./sdk/merge:MergeReceiptEvidenceScan"
+      ],
+      "package_version": "2026.8.30",
+      "reason": "Add optional clone-local resolution evidence to loss-aware receipt scans and reports so gates fail closed while existing structural consumers remain compatible."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmToolDiscoveryOptions"
+      ],
+      "package_version": "2026.8.31",
+      "reason": "Add optional host-owned cursor integrity key for deployment-stable pagination; existing callers and process-local fallback remain compatible."
     }
   ],
   "entrypoints": {
@@ -1514,6 +1571,12 @@
           "name": "_testOnlyValidateCommand",
           "signature": "{ applyValidateFix: typeof applyValidateFix; applyValidateFixes: typeof applyValidateFixes; attachValidateFixHints: typeof attachValidateFixHints; buildCommandReferencesCheck: typeof buildCommandReferencesCheck; buildDependencyReferencesCheck: typeof buildDependencyReferencesCheck; buildCloseReasonBackfillRows: typeof buildCloseReasonBackfillRows; buildFilesCheck: typeof buildFilesCheck; buildLifecycleCheck: typeof buildLifecycleCheck; buildLifecycleDependencyGraph: typeof buildLifecycleDependencyGraph; buildLifecycleParentGraph: typeof buildLifecycleParentGraph; buildEstimateBackfillRows: typeof buildEstimateBackfillRows; buildMetadataCounts: typeof buildMetadataCounts; buildMissingFieldOccurrences: typeof buildMissingFieldOccurrences; buildOrphanedPathRows: typeof buildOrphanedPathRows; classifyOrphanedPath: typeof classifyOrphanedPath; collectDefaultProjectFileCandidates: typeof collectDefaultProjectFileCandidates; collectTrackedGitFileCandidates: typeof collectTrackedGitFileCandidates; detectLifecycleDependencyCycles: typeof detectLifecycleDependencyCycles; detectLifecycleParentCycles: typeof detectLifecycleParentCycles; escapeRegExp: typeof escapeRegExp; extractItemIds: typeof extractItemIds; findLifecycleDependencyCycleComponents: typeof findLifecycleDependencyCycleComponents; isMetadataFieldMissing: typeof isMetadataFieldMissing; linkedArtifactPathExceedsFilesystemLimits: typeof linkedArtifactPathExceedsFilesystemLimits; listFilesRecursive: typeof listFilesRecursive; resolveDependencyCycleSeverity: typeof resolveDependencyCycleSeverity; resolveParentCycleSeverity: typeof resolveParentCycleSeverity; resolveFileScanMode: typeof resolveFileScanMode; resolveLifecycleDependencyCycleSamplePath: typeof resolveLifecycleDependencyCycleSamplePath; resolveRequestedChecks: typeof resolveRequestedChecks; resolveValidateMetadataProfile: typeof resolveValidateMetadataProfile; resolveWorkspaceRoot: typeof resolveWorkspaceRoot; sharedDirectoryPrefixLength: typeof sharedDirectoryPrefixLength; summarizeOrphanedPathRows: typeof summarizeOrphanedPathRows; summarizeDuplicateIssueCodes: typeof summarizeDuplicateIssueCodes; toMeaningfulString: typeof toMeaningfulString; }"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "_testOnlyWorkspacePosition",
+          "signature": "{ commandForWorkspacePositionState: typeof commandForWorkspacePositionState; normalizeWorkspaceHistoryDrift: typeof normalizeWorkspaceHistoryDrift; selectWorkspacePositionState: typeof selectWorkspacePositionState; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -3182,6 +3245,12 @@
           "name": "buildSemanticCorpusInput",
           "signature": "(document: ItemDocument, options?: SemanticCorpusInputOptions) => string | calls: (document: ItemDocument, options?: SemanticCorpusInputOptions) => string"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "buildStatusRoleWarnings",
+          "signature": "(diagnostics: StatusRoleDiagnostics) => string[] | calls: (diagnostics: StatusRoleDiagnostics) => string[]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -3476,6 +3545,12 @@
           "name": "classifyItemFormatVersion",
           "signature": "(version: number, current?: number) => ItemFormatVersionStatus | calls: (version: number, current?: number) => ItemFormatVersionStatus"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "classifyLinkedTestCommandSafety",
+          "signature": "(command: string) => LinkedTestCommandSafetyClassification | calls: (command: string) => LinkedTestCommandSafetyClassification"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -5450,6 +5525,12 @@
           "name": "discoverNearbyPmRoot",
           "signature": "(cwd: string, excludedRoot?: string) => string | undefined | calls: (cwd: string, excludedRoot?: string) => string | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "discoverPmTools",
+          "signature": "(candidates: readonly PmToolDiscoveryCandidate[], options?: PmToolDiscoveryOptions) => PmToolDiscoveryResult | calls: (candidates: readonly PmToolDiscoveryCandidate[], options?: PmToolDiscoveryOptions) => PmToolDiscoveryResult"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -6890,6 +6971,12 @@
           "name": "formatVectorIndexRecoveryWarnings",
           "signature": "(staleCount: number, recovery: VectorIndexRecovery) => string[] | calls: (staleCount: number, recovery: VectorIndexRecovery) => string[]"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "formatWorkspacePositionHuman",
+          "signature": "(result: WorkspacePositionResult) => string | calls: (result: WorkspacePositionResult) => string"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8024,6 +8111,12 @@
           "name": "inspectHistoryAuthorStream",
           "signature": "(itemId: string, raw: string, sampleLimit?: number, acknowledgedEvents?: ReadonlySet<string>) => Pick<HistoryAuthorAttributionScan, \"acknowledged_actionable_event_count\" | \"actionable_events\" | \"actionable_unknown_event_count\" | \"checked_events\" | \"legacy_unknown_event_count\" | \"samples_truncated\" | \"samples\" | \"unknown_event_count\"> | calls: (itemId: string, raw: string, sampleLimit?: number, acknowledgedEvents?: ReadonlySet<string>) => Pick<HistoryAuthorAttributionScan, \"checked_events\" | \"unknown_event_count\" | \"legacy_unknown_event_count\" | \"actionable_unknown_event_count\" | \"acknowledged_actionable_event_count\" | \"samples\" | \"samples_truncated\" | \"actionable_events\">"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "inspectMergeReceiptEvidence",
+          "signature": "(cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; pmRoot?: string; }) => Promise<MergeReceiptEvidenceScan> | calls: (cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; pmRoot?: string; }) => Promise<MergeReceiptEvidenceScan>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8042,6 +8135,12 @@
           "name": "InspectStaleInProgressOptions",
           "signature": "export interface InspectStaleInProgressOptions { in_progress_status?: string; threshold_hours: number; now?: Date; last_history_activity?: (item: ItemMetadata) => string | undefined; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "inspectStatusRoleAssignments",
+          "signature": "(statusRegistry: RuntimeStatusRegistry, items: readonly ItemMetadata[], itemLimit?: number) => StatusRoleDiagnostics | calls: (statusRegistry: RuntimeStatusRegistry, items: readonly ItemMetadata[], itemLimit?: number) => StatusRoleDiagnostics"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8558,6 +8657,12 @@
           "name": "LinkedTest",
           "signature": "export interface LinkedTest { command?: string; path?: string; scope: LinkScope; timeout_seconds?: number; pm_context_mode?: \"schema\" | \"tracker\" | \"auto\"; workspace_context_mode?: \"source\" | \"isolated\" | \"snapshot\"; provenance?: LinkedTestProvenance; provenance_invalid?: true; env_set?: Record<string, string>; env_clear?: string[]; shared_host_safe?: boolean; assert_stdout_contains?: string[]; assert_stdout_regex?: string[]; assert_stderr_contains?: string[]; assert_stderr_regex?: string[]; assert_stdout_min_lines?: number; assert_json_field_equals?: Record<string, string>; assert_json_field_gte?: Record<string, number>; note?: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "LinkedTestCommandSafetyClassification",
+          "signature": "export interface LinkedTestCommandSafetyClassification { accepted: true; command_kind: \"direct_runner\" | \"sandbox_runner\" | \"other\"; tracker_isolation: \"runtime_injected\"; trust_boundary: \"provenance\"; advisory: string; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "type",
@@ -8784,7 +8889,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ListOptions",
-          "signature": "export interface ListOptions extends SharedItemFilterOptions { ids?: string; assigneeFilter?: string; today?: boolean; recent?: boolean; limit?: string; offset?: string; after?: string; noTruncate?: boolean; includeBody?: boolean; compact?: boolean; brief?: boolean; full?: boolean; fields?: string; sort?: string; order?: string; tree?: boolean; treeDepth?: string; excludeTerminal?: boolean; strictRead?: boolean; dependencyBlocked?: boolean; filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; }"
+          "signature": "export interface ListOptions extends SharedItemFilterOptions { ids?: string; assigneeFilter?: string; today?: boolean; recent?: boolean; limit?: string; offset?: string; after?: string; noTruncate?: boolean; includeBody?: boolean; compact?: boolean; brief?: boolean; full?: boolean; fields?: string; sort?: string; order?: string; tree?: boolean; treeDepth?: string; excludeTerminal?: boolean; strictRead?: boolean; dependencyBlocked?: boolean; lifecycleBucket?: \"open\" | \"in_progress\"; filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; }"
         },
         {
           "classification": "contract_data",
@@ -9182,6 +9287,18 @@
           "name": "MergePreferredSide",
           "signature": "export type MergePreferredSide = \"ours\" | \"theirs\";"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "MergeReceiptEvidenceReport",
+          "signature": "export interface MergeReceiptEvidenceReport { ok: boolean; complete: boolean; count: number; invalid_evidence_count: number; clone_local_evidence_resolved?: boolean; receipts: MergeDecisionReceipt[]; generated_at: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "MergeReceiptEvidenceScan",
+          "signature": "export interface MergeReceiptEvidenceScan { receipts: MergeDecisionReceipt[]; invalid_evidence_count: number; clone_local_evidence_resolved?: boolean; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -10100,6 +10217,12 @@
           "name": "parsePmAgentTaskTranscriptCorpus",
           "signature": "(value: unknown) => PmAgentTaskTranscriptCorpus | calls: (value: unknown) => PmAgentTaskTranscriptCorpus"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "parsePmToolDiscoveryOptions",
+          "signature": "(input: Record<string, unknown>) => PmToolDiscoveryOptions | calls: (input: Record<string, unknown>) => PmToolDiscoveryOptions"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -10682,6 +10805,12 @@
           "name": "PM_MCP_APPS_SPEC_VERSION",
           "signature": "\"2026-01-26\""
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_ENTRY_TOOL_NAMES",
+          "signature": "readonly string[]"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -10704,7 +10833,7 @@
           "classification": "advanced_export",
           "kind": "value",
           "name": "PM_MCP_LEGACY_PROTOCOL_VERSIONS",
-          "signature": "readonly [\"2025-06-18\"]"
+          "signature": "readonly [\"2025-11-25\", \"2025-06-18\"]"
         },
         {
           "classification": "advanced_export",
@@ -10712,6 +10841,18 @@
           "name": "PM_MCP_META_KEYS",
           "signature": "{ readonly clientCapabilities: \"io.modelcontextprotocol/clientCapabilities\"; readonly clientInfo: \"io.modelcontextprotocol/clientInfo\"; readonly protocolVersion: \"io.modelcontextprotocol/protocolVersion\"; readonly serverInfo: \"io.modelcontextprotocol/serverInfo\"; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_PROGRESSIVE_DISCOVERY_EXTENSION",
+          "signature": "\"dev.unbrained.pm/progressive-tool-discovery\""
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_PROGRESSIVE_DISCOVERY_SERVER_CAPABILITY",
+          "signature": "Readonly<{ version: 1; discoveryTool: \"pm_discover\"; canonicalResult: \"structuredContent.result\"; compatibilityText: \"pointer\"; }>"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -11982,7 +12123,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmPositionalActionContract",
-          "signature": "export interface PmPositionalActionContract extends PmCommandPositionalContract { parent: \"assurance\" | \"plan\" | \"workspace snapshot\"; action: string; accepted_flags: readonly string[]; description: string; example: string; }"
+          "signature": "export interface PmPositionalActionContract extends PmCommandPositionalContract { parent: \"assurance\" | \"plan\" | \"workspace\" | \"workspace snapshot\"; action: string; accepted_flags: readonly string[]; description: string; example: string; }"
         },
         {
           "classification": "contract_data",
@@ -12308,6 +12449,54 @@
           "name": "PmToolCustomFieldCollision",
           "signature": "export interface PmToolCustomFieldCollision { field: string; property: string; owner: \"mcp_tool_input\"; nested_path: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmToolDiscoveryAppliedSignal",
+          "signature": "export interface PmToolDiscoveryAppliedSignal { value: number; weight: number; available: boolean; source: \"computed\" | \"host\" | \"authorization\" | \"unavailable\"; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmToolDiscoveryCandidate",
+          "signature": "export interface PmToolDiscoveryCandidate { name: string; description: string; inputSchema: Record<string, unknown>; authorized?: boolean; signals?: PmToolDiscoverySignalInput; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmToolDiscoveryOmissionReceipt",
+          "signature": "export interface PmToolDiscoveryOmissionReceipt { has_omissions: boolean; omitted: Array<{ name: \"input_schema\" | \"tools\"; reason: \"compact_projection\" | \"limit\" | \"token_budget\"; restore_with: string; }>; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmToolDiscoveryOptions",
+          "signature": "export interface PmToolDiscoveryOptions { query?: string; family?: PmCommandCapabilityFamily; tier?: Exclude<PmCommandVisibilityTier, \"internal\">; limit?: number; cursor?: string; includeSchema?: boolean; outputBudget?: number | \"unbounded\"; profile?: PmMcpToolProfile; cursorIntegrityKey?: Uint8Array; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmToolDiscoveryResult",
+          "signature": "export interface PmToolDiscoveryResult { result_type: \"pm_tool_discovery\"; contract_version: 1; query: string; profile: PmMcpToolProfile; tools: PmToolDiscoveryResultRow[]; total: number; returned: number; has_more: boolean; next_cursor?: string; token_cost: { estimated_tokens: number; budget: number | \"unbounded\"; within_budget: boolean; }; ranking_policy: { version: 1; formula: \"weighted_sum_then_name\"; weights: Readonly<Record<PmToolDiscoverySignalName, number>>; }; cache: { key: string; ttl_ms: number; scope: \"private\"; invalidates_on: readonly string[]; }; omission_receipt: PmToolDiscoveryOmissionReceipt; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmToolDiscoveryResultRow",
+          "signature": "export interface PmToolDiscoveryResultRow { name: string; description: string; command: string; tier: PmCommandVisibilityTier; family: PmCommandCapabilityFamily; score: number; signals: Readonly<Record<PmToolDiscoverySignalName, PmToolDiscoveryAppliedSignal>>; input_schema?: Record<string, unknown>; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmToolDiscoverySignalInput",
+          "signature": "export interface PmToolDiscoverySignalInput { semantic?: number; graph?: number; freshness?: number; usage?: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "PmToolDiscoverySignalName",
+          "signature": "export type PmToolDiscoverySignalName = \"lexical\" | \"semantic\" | \"graph\" | \"permission\" | \"freshness\" | \"usage\";"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -13160,6 +13349,12 @@
           "name": "readWorkspaceMemory",
           "signature": "(items: readonly ItemMetadata[], options: { pmRoot: string; statusRegistry: RuntimeStatusRegistry; now: string; minimumItems?: number; sourceCursor?: string; }) => Promise<WorkspaceMemoryReadResult> | calls: (items: readonly ItemMetadata[], options: { pmRoot: string; statusRegistry: RuntimeStatusRegistry; now: string; minimumItems?: number; sourceCursor?: string; }) => Promise<WorkspaceMemoryReadResult>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "readWorkspacePosition",
+          "signature": "(global: GlobalOptions) => Promise<WorkspacePositionResult> | calls: (global: GlobalOptions) => Promise<WorkspacePositionResult>"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -15446,6 +15641,12 @@
           "name": "runMergeInstall",
           "signature": "(options: MergeInstallOptions, global: GlobalOptions) => Promise<MergeInstallResult> | calls: (options: MergeInstallOptions, global: GlobalOptions) => Promise<MergeInstallResult>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "runMergeReceiptEvidenceReport",
+          "signature": "(options: { includeReconciled?: boolean; cwd?: string; }) => Promise<MergeReceiptEvidenceReport> | calls: (options: { includeReconciled?: boolean; cwd?: string; }) => Promise<MergeReceiptEvidenceReport>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -15798,7 +15999,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "RuntimeStatusRegistry",
-          "signature": "export interface RuntimeStatusRegistry { definitions: RuntimeStatusDefinitionResolved[]; by_id: Map<string, RuntimeStatusDefinitionResolved>; alias_to_id: Map<string, string>; terminal_statuses: Set<string>; terminal_done_statuses: Set<string>; terminal_canceled_statuses: Set<string>; active_statuses: Set<string>; blocked_statuses: Set<string>; draft_statuses: Set<string>; open_status: string; close_status: string; canceled_status: string; }"
+          "signature": "export interface RuntimeStatusRegistry { definitions: RuntimeStatusDefinitionResolved[]; by_id: Map<string, RuntimeStatusDefinitionResolved>; alias_to_id: Map<string, string>; terminal_statuses: Set<string>; terminal_done_statuses: Set<string>; terminal_canceled_statuses: Set<string>; active_statuses: Set<string>; blocked_statuses: Set<string>; draft_statuses: Set<string>; open_status: string; in_progress_status: string; blocked_status: string; close_status: string; canceled_status: string; }"
         },
         {
           "classification": "advanced_export",
@@ -16994,6 +17195,12 @@
           "name": "statusIsTerminal",
           "signature": "(status: string, registry: RuntimeStatusRegistry) => boolean | calls: (status: string, registry: RuntimeStatusRegistry) => boolean"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "StatusRoleDiagnostics",
+          "signature": "export interface StatusRoleDiagnostics { roleless_status_count: number; roleless_statuses: string[]; roleless_statuses_truncated: boolean; affected_item_count: number; affected_item_ids: string[]; affected_item_ids_truncated: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -18308,6 +18515,24 @@
           "name": "WorkspaceMemorySnapshot",
           "signature": "export interface WorkspaceMemorySnapshot { format_version: number; source_cursor: string; source_item_count: number; generated_at: string; completion_time_sources?: Record<CompletionTimestampSource, number>; rollups: WorkspaceMemoryRollup[]; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "WorkspacePositionNextAction",
+          "signature": "export interface WorkspacePositionNextAction { command: string | null; reason: WorkspacePositionState; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "WorkspacePositionResult",
+          "signature": "export interface WorkspacePositionResult { ok: boolean; state: WorkspacePositionState; merge_fence: { committed: MergeFenceAuditResult; clone_local_drivers: MergeDriverConfigurationAuditResult | null; }; merge_receipts: { pending_decision_count: number; pending_item_ids: string[]; pending_item_ids_truncated: boolean; lossless_count: number; invalid_evidence_count: number; }; history_drift: { evidence_valid: boolean; drifted_item_count: number; drifted_item_ids: string[]; drifted_item_ids_truncated: boolean; counts: Record<string, unknown>; }; next_action: WorkspacePositionNextAction; warnings: string[]; generated_at: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "WorkspacePositionState",
+          "signature": "export type WorkspacePositionState = \"ready\" | \"merge_evidence_invalid\" | \"history_evidence_invalid\" | \"merge_reconciliation_required\" | \"history_repair_required\" | \"merge_fence_unprepared\";"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -21450,7 +21675,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmPositionalActionContract",
-          "signature": "export interface PmPositionalActionContract extends PmCommandPositionalContract { parent: \"assurance\" | \"plan\" | \"workspace snapshot\"; action: string; accepted_flags: readonly string[]; description: string; example: string; }"
+          "signature": "export interface PmPositionalActionContract extends PmCommandPositionalContract { parent: \"assurance\" | \"plan\" | \"workspace\" | \"workspace snapshot\"; action: string; accepted_flags: readonly string[]; description: string; example: string; }"
         },
         {
           "classification": "contract_data",
@@ -22908,7 +23133,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ListOptions",
-          "signature": "export interface ListOptions extends SharedItemFilterOptions { ids?: string; assigneeFilter?: string; today?: boolean; recent?: boolean; limit?: string; offset?: string; after?: string; noTruncate?: boolean; includeBody?: boolean; compact?: boolean; brief?: boolean; full?: boolean; fields?: string; sort?: string; order?: string; tree?: boolean; treeDepth?: string; excludeTerminal?: boolean; strictRead?: boolean; dependencyBlocked?: boolean; filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; }"
+          "signature": "export interface ListOptions extends SharedItemFilterOptions { ids?: string; assigneeFilter?: string; today?: boolean; recent?: boolean; limit?: string; offset?: string; after?: string; noTruncate?: boolean; includeBody?: boolean; compact?: boolean; brief?: boolean; full?: boolean; fields?: string; sort?: string; order?: string; tree?: boolean; treeDepth?: string; excludeTerminal?: boolean; strictRead?: boolean; dependencyBlocked?: boolean; lifecycleBucket?: \"open\" | \"in_progress\"; filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; }"
         },
         {
           "classification": "supported",
@@ -23504,6 +23729,12 @@
           "name": "_testOnlyValidateCommand",
           "signature": "{ applyValidateFix: typeof applyValidateFix; applyValidateFixes: typeof applyValidateFixes; attachValidateFixHints: typeof attachValidateFixHints; buildCommandReferencesCheck: typeof buildCommandReferencesCheck; buildDependencyReferencesCheck: typeof buildDependencyReferencesCheck; buildCloseReasonBackfillRows: typeof buildCloseReasonBackfillRows; buildFilesCheck: typeof buildFilesCheck; buildLifecycleCheck: typeof buildLifecycleCheck; buildLifecycleDependencyGraph: typeof buildLifecycleDependencyGraph; buildLifecycleParentGraph: typeof buildLifecycleParentGraph; buildEstimateBackfillRows: typeof buildEstimateBackfillRows; buildMetadataCounts: typeof buildMetadataCounts; buildMissingFieldOccurrences: typeof buildMissingFieldOccurrences; buildOrphanedPathRows: typeof buildOrphanedPathRows; classifyOrphanedPath: typeof classifyOrphanedPath; collectDefaultProjectFileCandidates: typeof collectDefaultProjectFileCandidates; collectTrackedGitFileCandidates: typeof collectTrackedGitFileCandidates; detectLifecycleDependencyCycles: typeof detectLifecycleDependencyCycles; detectLifecycleParentCycles: typeof detectLifecycleParentCycles; escapeRegExp: typeof escapeRegExp; extractItemIds: typeof extractItemIds; findLifecycleDependencyCycleComponents: typeof findLifecycleDependencyCycleComponents; isMetadataFieldMissing: typeof isMetadataFieldMissing; linkedArtifactPathExceedsFilesystemLimits: typeof linkedArtifactPathExceedsFilesystemLimits; listFilesRecursive: typeof listFilesRecursive; resolveDependencyCycleSeverity: typeof resolveDependencyCycleSeverity; resolveParentCycleSeverity: typeof resolveParentCycleSeverity; resolveFileScanMode: typeof resolveFileScanMode; resolveLifecycleDependencyCycleSamplePath: typeof resolveLifecycleDependencyCycleSamplePath; resolveRequestedChecks: typeof resolveRequestedChecks; resolveValidateMetadataProfile: typeof resolveValidateMetadataProfile; resolveWorkspaceRoot: typeof resolveWorkspaceRoot; sharedDirectoryPrefixLength: typeof sharedDirectoryPrefixLength; summarizeOrphanedPathRows: typeof summarizeOrphanedPathRows; summarizeDuplicateIssueCodes: typeof summarizeDuplicateIssueCodes; toMeaningfulString: typeof toMeaningfulString; }"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "_testOnlyWorkspacePosition",
+          "signature": "{ commandForWorkspacePositionState: typeof commandForWorkspacePositionState; normalizeWorkspaceHistoryDrift: typeof normalizeWorkspaceHistoryDrift; selectWorkspacePositionState: typeof selectWorkspacePositionState; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -23984,6 +24215,12 @@
           "name": "BuildDefectRecurrenceIndexOptions",
           "signature": "export interface BuildDefectRecurrenceIndexOptions { previous_index?: DefectRecurrenceIndex; changed_item_ids?: string[]; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "buildStatusRoleWarnings",
+          "signature": "(diagnostics: StatusRoleDiagnostics) => string[] | calls: (diagnostics: StatusRoleDiagnostics) => string[]"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -24242,6 +24479,12 @@
           "name": "FindSimilarItemsOptions",
           "signature": "export interface FindSimilarItemsOptions { pmRoot?: string; cwd?: string; limit?: number; threshold?: number; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "formatWorkspacePositionHuman",
+          "signature": "(result: WorkspacePositionResult) => string | calls: (result: WorkspacePositionResult) => string"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -24338,6 +24581,12 @@
           "name": "InspectStaleInProgressOptions",
           "signature": "export interface InspectStaleInProgressOptions { in_progress_status?: string; threshold_hours: number; now?: Date; last_history_activity?: (item: ItemMetadata) => string | undefined; }"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "inspectStatusRoleAssignments",
+          "signature": "(statusRegistry: RuntimeStatusRegistry, items: readonly ItemMetadata[], itemLimit?: number) => StatusRoleDiagnostics | calls: (statusRegistry: RuntimeStatusRegistry, items: readonly ItemMetadata[], itemLimit?: number) => StatusRoleDiagnostics"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -24524,6 +24773,12 @@
           "name": "putAssuranceDeclarationBundle",
           "signature": "(pmRoot: string, bundle: AssuranceDeclarationBundle, options?: AssuranceMutationOptions) => Promise<AssuranceBundleMutationReceipt> | calls: (pmRoot: string, bundle: AssuranceDeclarationBundle, options?: AssuranceMutationOptions) => Promise<AssuranceBundleMutationReceipt>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "readWorkspacePosition",
+          "signature": "(global: GlobalOptions) => Promise<WorkspacePositionResult> | calls: (global: GlobalOptions) => Promise<WorkspacePositionResult>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -24716,6 +24971,12 @@
           "name": "StaleInProgressScan",
           "signature": "export interface StaleInProgressScan { threshold_hours: number; count: number; items: StaleInProgressItem[]; remediation: string; }"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "StatusRoleDiagnostics",
+          "signature": "export interface StatusRoleDiagnostics { roleless_status_count: number; roleless_statuses: string[]; roleless_statuses_truncated: boolean; affected_item_count: number; affected_item_ids: string[]; affected_item_ids_truncated: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -24877,6 +25138,24 @@
           "kind": "interface",
           "name": "WaivedBoundaryRecord",
           "signature": "export interface WaivedBoundaryRecord { id: string; producer: string; consumer: string; format: string; waiver_reason: string; waiver_owner: string; waiver_expires_at: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "WorkspacePositionNextAction",
+          "signature": "export interface WorkspacePositionNextAction { command: string | null; reason: WorkspacePositionState; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "WorkspacePositionResult",
+          "signature": "export interface WorkspacePositionResult { ok: boolean; state: WorkspacePositionState; merge_fence: { committed: MergeFenceAuditResult; clone_local_drivers: MergeDriverConfigurationAuditResult | null; }; merge_receipts: { pending_decision_count: number; pending_item_ids: string[]; pending_item_ids_truncated: boolean; lossless_count: number; invalid_evidence_count: number; }; history_drift: { evidence_valid: boolean; drifted_item_count: number; drifted_item_ids: string[]; drifted_item_ids_truncated: boolean; counts: Record<string, unknown>; }; next_action: WorkspacePositionNextAction; warnings: string[]; generated_at: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "type",
+          "name": "WorkspacePositionState",
+          "signature": "export type WorkspacePositionState = \"ready\" | \"merge_evidence_invalid\" | \"history_evidence_invalid\" | \"merge_reconciliation_required\" | \"history_repair_required\" | \"merge_fence_unprepared\";"
         }
       ],
       "types": "dist/sdk/governance.d.ts"
@@ -26300,6 +26579,12 @@
           "name": "HistoryMergeStrategy",
           "signature": "export type HistoryMergeStrategy = \"identical\" | \"fast_forward_ours\" | \"fast_forward_theirs\" | \"union_reanchor\";"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "inspectMergeReceiptEvidence",
+          "signature": "(cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; pmRoot?: string; }) => Promise<MergeReceiptEvidenceScan> | calls: (cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; pmRoot?: string; }) => Promise<MergeReceiptEvidenceScan>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -26444,6 +26729,18 @@
           "name": "MergePreferredSide",
           "signature": "export type MergePreferredSide = \"ours\" | \"theirs\";"
         },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "MergeReceiptEvidenceReport",
+          "signature": "export interface MergeReceiptEvidenceReport { ok: boolean; complete: boolean; count: number; invalid_evidence_count: number; clone_local_evidence_resolved?: boolean; receipts: MergeDecisionReceipt[]; generated_at: string; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "MergeReceiptEvidenceScan",
+          "signature": "export interface MergeReceiptEvidenceScan { receipts: MergeDecisionReceipt[]; invalid_evidence_count: number; clone_local_evidence_resolved?: boolean; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -26528,6 +26825,12 @@
           "name": "runMergeInstall",
           "signature": "(options: MergeInstallOptions, global: GlobalOptions) => Promise<MergeInstallResult> | calls: (options: MergeInstallOptions, global: GlobalOptions) => Promise<MergeInstallResult>"
         },
+        {
+          "classification": "supported",
+          "kind": "function",
+          "name": "runMergeReceiptEvidenceReport",
+          "signature": "(options: { includeReconciled?: boolean; cwd?: string; }) => Promise<MergeReceiptEvidenceReport> | calls: (options: { includeReconciled?: boolean; cwd?: string; }) => Promise<MergeReceiptEvidenceReport>"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -27402,7 +27705,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ListOptions",
-          "signature": "export interface ListOptions extends SharedItemFilterOptions { ids?: string; assigneeFilter?: string; today?: boolean; recent?: boolean; limit?: string; offset?: string; after?: string; noTruncate?: boolean; includeBody?: boolean; compact?: boolean; brief?: boolean; full?: boolean; fields?: string; sort?: string; order?: string; tree?: boolean; treeDepth?: string; excludeTerminal?: boolean; strictRead?: boolean; dependencyBlocked?: boolean; filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; }"
+          "signature": "export interface ListOptions extends SharedItemFilterOptions { ids?: string; assigneeFilter?: string; today?: boolean; recent?: boolean; limit?: string; offset?: string; after?: string; noTruncate?: boolean; includeBody?: boolean; compact?: boolean; brief?: boolean; full?: boolean; fields?: string; sort?: string; order?: string; tree?: boolean; treeDepth?: string; excludeTerminal?: boolean; strictRead?: boolean; dependencyBlocked?: boolean; lifecycleBucket?: \"open\" | \"in_progress\"; filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; }"
         },
         {
           "classification": "supported",
@@ -29268,7 +29571,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ListOptions",
-          "signature": "export interface ListOptions extends SharedItemFilterOptions { ids?: string; assigneeFilter?: string; today?: boolean; recent?: boolean; limit?: string; offset?: string; after?: string; noTruncate?: boolean; includeBody?: boolean; compact?: boolean; brief?: boolean; full?: boolean; fields?: string; sort?: string; order?: string; tree?: boolean; treeDepth?: string; excludeTerminal?: boolean; strictRead?: boolean; dependencyBlocked?: boolean; filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; }"
+          "signature": "export interface ListOptions extends SharedItemFilterOptions { ids?: string; assigneeFilter?: string; today?: boolean; recent?: boolean; limit?: string; offset?: string; after?: string; noTruncate?: boolean; includeBody?: boolean; compact?: boolean; brief?: boolean; full?: boolean; fields?: string; sort?: string; order?: string; tree?: boolean; treeDepth?: string; excludeTerminal?: boolean; strictRead?: boolean; dependencyBlocked?: boolean; lifecycleBucket?: \"open\" | \"in_progress\"; filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; }"
         },
         {
           "classification": "supported",
@@ -31873,6 +32176,7 @@
     "stale_observed_signature",
     "status_duplicate",
     "status_invalid",
+    "status_lifecycle_role_required",
     "stdin_json_invalid",
     "stdin_json_unknown_key",
     "structured_event_immutable",