Refine OpenClaw payloads and reorganize docs

src/summary_mcp/models/candidate_review.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Literal
+
+from pydantic import BaseModel
+
+
+ReviewStatus = Literal["pending", "confirmed", "rejected", "deferred"]
+KnowledgeDecision = Literal["pending", "ingest", "skip"]
+
+
+class CandidateReviewStatus(BaseModel):
+    candidate_id: str
+    review_status: ReviewStatus = "pending"
+    reviewed_at: datetime | None = None
+    review_note: str | None = None
+    knowledge_decision: KnowledgeDecision = "pending"
+    knowledge_note: str | None = None