feat: implement final approval gate workflow and checklist

packages/shared/src/api-types.ts

@@ -349,6 +349,40 @@ export type EvidenceUpdateRequest = {
   review_status?: string | null;
 };
 
+export type FinalApprovalChecklistItemSummary = {
+  blocker?: string | null;
+  completed: boolean;
+  key: string;
+  title: string;
+};
+
+export type FinalApprovalChecklistResponse = {
+  article_id: string;
+  blockers?: string[];
+  can_approve: boolean;
+  completed_items?: string[];
+  draft_version?: number | null;
+  items?: FinalApprovalChecklistItemSummary[];
+  requested_draft_version?: number | null;
+};
+
+export type FinalApprovalPublishingSettings = {
+  author?: string | null;
+  content_path?: string | null;
+  frontmatter?: Record<string, unknown> | null;
+  publishing_mode?: string | null;
+};
+
+export type FinalApprovalRequest = {
+  draft_version?: number | null;
+  publishing_settings?: FinalApprovalPublishingSettings | null;
+};
+
+export type FinalApprovalResponse = {
+  article: ArticleSummary;
+  checklist: FinalApprovalChecklistResponse;
+};
+
 export type FinalReviewIssueSummary = {
   location: string;
   message: string;
@@ -364,6 +398,16 @@ export type FinalReviewIssuesResponse = {
   unresolved_issues?: FinalReviewIssueSummary[];
 };
 
+export type FinalRevisionRequest = {
+  draft_version?: number | null;
+  reason?: string | null;
+};
+
+export type FinalRevisionRequestResponse = {
+  article: ArticleSummary;
+  checklist: FinalApprovalChecklistResponse;
+};
+
 export type HTTPValidationError = {
   detail?: ValidationError[];
 };