feat(governance): surface stale km owner review inbox

apps/api/src/models/governance.py

@@ -331,6 +331,51 @@ class KnowledgeStaleOwnerReviewBatchQueueResponse(BaseModel):
     generated_at: datetime
 
 
+class KnowledgeStaleOwnerReviewInboxItem(BaseModel):
+    dispatch_id: str
+    governance_event_id: str
+    entry_id: str
+    project_id: str
+    title: str
+    dispatch_status: str
+    workflow_stage: str
+    next_action: str | None = None
+    owner: str | None = None
+    owner_note: str | None = None
+    batch_governance_event_id: str | None = None
+    batch_dispatch_id: str | None = None
+    priority_tier: Literal["P0", "P1", "P2"]
+    priority_score: int
+    recommended_action: Literal[
+        "refresh_with_evidence",
+        "owner_review",
+        "archive_or_supersede",
+    ]
+    stale_days: int
+    view_count: int
+    correlation_sources: list[str] = Field(default_factory=list)
+    reasons: list[str] = Field(default_factory=list)
+    related_incident_id: str | None = None
+    related_playbook_id: str | None = None
+    related_approval_id: str | None = None
+    dry_run_plan_fingerprint: str | None = None
+    queued_at: datetime | None = None
+    started_at: datetime | None = None
+    completed_at: datetime | None = None
+
+
+class KnowledgeStaleOwnerReviewInboxResponse(BaseModel):
+    schema_version: str = "km_stale_owner_review_inbox_v1"
+    project_id: str
+    dispatch_status: str
+    total: int
+    returned: int
+    writes_on_read: bool = False
+    manual_review_required: bool = True
+    items: list[KnowledgeStaleOwnerReviewInboxItem] = Field(default_factory=list)
+    generated_at: datetime
+
+
 class KnowledgeStaleOwnerReviewCompleteRequest(BaseModel):
     dispatch_id: str | None = Field(
         default=None,