roboco/panel/src/lib/api/prompter.ts

import type { Team, TaskType, TaskNature, Complexity } from "@/types";

// ---------------------------------------------------------------------------
// Prompter draft types — shared by the live intake hook (`prompter-live.ts`),
// the draft card, and the confirm dialog. The chat itself is driven by the
// spawned agent over SSE (`prompter-live.ts`); these are just the shapes of
// the structured draft the agent proposes and the human confirms.
// ---------------------------------------------------------------------------

/** One cell's slice of the work — the per-cell breakdown of The Work. */
export interface CellWork {
  team: Team;
  summary: string;
  items: string[];
}

/** A structured task draft, mirroring the backend PrompterDraftTask. */
export interface DraftProposal {
  title: string;
  description: string;
  acceptance_criteria: string[];
  team: Team;
  priority?: number;
  task_type?: TaskType;
  nature?: TaskNature;
  estimated_complexity?: Complexity;
  // Structured spec fields
  objective?: string | null;
  what_this_builds?: string[];
  the_work?: CellWork[];
  notes?: string[];
  // Targeting (resolved at confirm time)
  project_id?: string | null;
  product_id?: string | null;
}

/** Single-cell project vs board-led multi-cell product. */
export type DraftScale = "single" | "multi";

/** What the human picked/edited at confirm time. `route` is which start button:
 *  "board" (Board review & Start) or "main_pm" (Approve & Start). */
export interface ConfirmPayload {
  project_id?: string;
  product_id?: string;
  draft?: DraftProposal;
  route?: "board" | "main_pm";
}