Task 009 implement plan generation review gate

packages/shared/src/api-types.ts

@@ -197,13 +197,36 @@ export type HTTPValidationError = {
   detail?: ValidationError[];
 };
 
+export type PlanListResponse = {
+  plans: PlanSummary[];
+};
+
+export type PlanResponse = {
+  plan: PlanSummary;
+};
+
 export type PlanReviewStatus = "PENDING_REVIEW" | "APPROVED" | "REVISION_REQUESTED";
 
+export type PlanRevisionRequest = {
+  notes: string;
+};
+
+export type PlanSectionEditRequest = {
+  claims_to_support?: string[];
+  evidence_needs?: string[];
+  heading: string;
+  key_points?: string[];
+  purpose?: string | null;
+  target_word_count?: number | null;
+};
+
 export type PlanSectionSummary = {
   article_plan_id: string;
   claims_to_support?: string[];
+  evidence_needs?: string[];
   heading: string;
   id: string;
+  key_points?: string[];
   purpose?: string | null;
   sort_order: number;
   target_word_count?: number | null;
@@ -211,16 +234,43 @@ export type PlanSectionSummary = {
 
 export type PlanSummary = {
   article_id: string;
+  audience?: string | null;
   claims_to_prove?: string[];
   created_at: string;
+  evidence_needs?: string[];
+  excluded_sources?: string[];
   id: string;
+  reader_persona?: string | null;
   recommended_title?: string | null;
   risks?: string[];
   search_intent?: string | null;
   sections?: PlanSectionSummary[];
+  seo_notes?: string[];
+  source_requirements?: string[];
   status: PlanReviewStatus;
   thesis?: string | null;
+  title_options?: string[];
+  tone?: string | null;
   version: number;
+  visual_needs?: string[];
+};
+
+export type PlanUpdateRequest = {
+  audience?: string | null;
+  claims_to_prove?: string[] | null;
+  evidence_needs?: string[] | null;
+  excluded_sources?: string[] | null;
+  reader_persona?: string | null;
+  recommended_title?: string | null;
+  risks?: string[] | null;
+  search_intent?: string | null;
+  sections?: PlanSectionEditRequest[] | null;
+  seo_notes?: string[] | null;
+  source_requirements?: string[] | null;
+  thesis?: string | null;
+  title_options?: string[] | null;
+  tone?: string | null;
+  visual_needs?: string[] | null;
 };
 
 export type PublishCommitSummary = {