feat(task-013): add draft assembly API, immutable versioning, and editor preview

packages/shared/src/api-types.ts

@@ -35,8 +35,8 @@ export type AgentJobSummary = {
   input_files?: RunnerFileRef[];
   job_type: AgentJobType;
   output_files?: RunnerFileRef[];
-  payload?: Record<string, unknown>;
   parent_job_id?: string | null;
+  payload?: Record<string, unknown>;
   queued_at: string;
   started_at?: string | null;
   status: AgentJobStatus;
@@ -168,17 +168,52 @@ export type CurrentUserResponse = {
   user: CurrentUser;
 };
 
+export type DraftAssembleResponse = {
+  draft: DraftSummary;
+};
+
+export type DraftFaqItem = {
+  answer: string;
+  question: string;
+};
+
+export type DraftListResponse = {
+  drafts?: DraftSummary[];
+};
+
+export type DraftResponse = {
+  draft: DraftSummary;
+};
+
 export type DraftSummary = {
   article_id: string;
+  based_on_draft_id?: string | null;
+  body_markdown?: string;
   body_object_key?: string | null;
+  created_at: string;
+  evidence_references?: string[];
+  faq_items?: DraftFaqItem[];
   id: string;
   meta_description?: string | null;
   meta_title?: string | null;
   slug: string;
   status: ArticleWorkflowStatus;
   title: string;
+  unsupported_claim_warnings?: string[];
   updated_at: string;
   version: number;
+  visual_placeholders?: string[];
+};
+
+export type DraftUpdateRequest = {
+  body_markdown?: string | null;
+  evidence_references?: string[] | null;
+  faq_items?: DraftFaqItem[] | null;
+  meta_description?: string | null;
+  meta_title?: string | null;
+  title?: string | null;
+  unsupported_claim_warnings?: string[] | null;
+  visual_placeholders?: string[] | null;
 };
 
 export type EvidenceCreateRequest = {