feat(governance): complete stale km owner review

apps/api/src/models/governance.py

@@ -227,6 +227,10 @@ class KnowledgeStaleCandidate(BaseModel):
     related_playbook_id: str | None = None
     related_approval_id: str | None = None
     tags: list[str] = Field(default_factory=list)
+    owner_review_dispatch_id: str | None = None
+    owner_review_status: str | None = None
+    owner_review_stage: str | None = None
+    owner_review_next_action: str | None = None
 
 
 class KnowledgeStaleCandidatesResponse(BaseModel):
@@ -268,6 +272,57 @@ class KnowledgeStaleOwnerReviewResponse(BaseModel):
     generated_at: datetime
 
 
+class KnowledgeStaleOwnerReviewCompleteRequest(BaseModel):
+    dispatch_id: str | None = Field(
+        default=None,
+        max_length=120,
+        description="Owner-review dispatch id. Optional when the backend can resolve the active item by entry id.",
+    )
+    owner: str = Field(default="operator_console", min_length=1, max_length=100)
+    owner_approved: bool = False
+    dry_run: bool = False
+    review_outcome: Literal[
+        "refresh_with_evidence",
+        "archive",
+        "supersede",
+    ]
+    owner_note: str | None = Field(default=None, max_length=500)
+    updated_title: str | None = Field(default=None, min_length=1, max_length=255)
+    updated_content: str | None = Field(default=None, min_length=1)
+    superseded_by_entry_id: str | None = Field(default=None, max_length=120)
+    dry_run_plan_fingerprint: str | None = Field(
+        default=None,
+        max_length=80,
+        description="Dry-run response fingerprint that must be echoed before a write.",
+    )
+
+
+class KnowledgeStaleOwnerReviewCompleteResponse(BaseModel):
+    schema_version: str = "km_stale_owner_review_complete_v1"
+    entry_id: str
+    project_id: str
+    status: Literal["dry_run", "completed", "already_completed"]
+    review_outcome: Literal[
+        "refresh_with_evidence",
+        "archive",
+        "supersede",
+    ]
+    governance_event_id: str
+    dispatch_id: str
+    audit_dispatch_id: str | None = None
+    stale_ratio_recheck_dispatch_id: str | None = None
+    workflow_stage: str
+    owner: str
+    owner_approved: bool
+    dry_run: bool
+    writes_km: bool
+    writes_governance_audit: bool
+    stale_ratio_snapshot: KnowledgeReviewDraftStaleRatioSnapshot | None = None
+    dry_run_plan_fingerprint: str | None = None
+    next_action: str = "stale_ratio_recheck"
+    generated_at: datetime
+
+
 # =============================================================================
 # Endpoint 3: summary
 # =============================================================================