1 files changed, 60 insertions, 0 deletions
diff --git a/makima/src/db/models.rs b/makima/src/db/models.rs
index 72ba6f2..99c8b8e 100644
--- a/makima/src/db/models.rs
+++ b/makima/src/db/models.rs
@@ -1264,6 +1264,11 @@ pub struct Contract {
     /// without a COMPLETION_GATE indicating ready: true.
     #[serde(default)]
     pub autonomous_loop: bool,
+    /// Whether to wait for user confirmation before progressing to the next phase.
+    /// When enabled, the supervisor will pause and ask the user to review and approve
+    /// phase outputs (like plans, requirements, etc.) before continuing.
+    #[serde(default)]
+    pub phase_guard: bool,
     pub version: i32,
     pub created_at: DateTime<Utc>,
     pub updated_at: DateTime<Utc>,
@@ -1389,6 +1394,11 @@ pub struct CreateContractRequest {
     /// without a COMPLETION_GATE indicating ready: true.
     #[serde(default)]
     pub autonomous_loop: Option<bool>,
+    /// Enable phase guard mode for this contract.
+    /// When enabled, the supervisor will pause and ask the user to review and approve
+    /// phase outputs before progressing to the next phase.
+    #[serde(default)]
+    pub phase_guard: Option<bool>,
 }
 
 /// Request payload for updating a contract
@@ -1405,6 +1415,11 @@ pub struct UpdateContractRequest {
     /// Enable or disable autonomous loop mode for tasks in this contract.
     #[serde(default)]
     pub autonomous_loop: Option<bool>,
+    /// Enable or disable phase guard mode for this contract.
+    /// When enabled, the supervisor will pause and ask the user to review and approve
+    /// phase outputs before progressing to the next phase.
+    #[serde(default)]
+    pub phase_guard: Option<bool>,
     /// Version for optimistic locking
     pub version: Option<i32>,
 }
@@ -1443,6 +1458,51 @@ pub struct CreateManagedRepositoryRequest {
 #[serde(rename_all = "camelCase")]
 pub struct ChangePhaseRequest {
     pub phase: String,
+    /// If phase_guard is enabled, this must be true to confirm the transition.
+    /// If not provided or false, returns phase deliverables for review.
+    #[serde(default)]
+    pub confirmed: Option<bool>,
+    /// User feedback for changes (used when not confirming)
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub feedback: Option<String>,
+}
+
+/// Response for phase transition when phase_guard is enabled
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct PhaseTransitionRequest {
+    /// Current contract phase
+    pub current_phase: String,
+    /// Requested next phase
+    pub next_phase: String,
+    /// Summary of phase deliverables/outputs
+    pub deliverables_summary: String,
+    /// List of files created in this phase
+    pub phase_files: Vec<PhaseFileInfo>,
+    /// List of completed tasks in this phase
+    pub phase_tasks: Vec<PhaseTaskInfo>,
+    /// Whether user confirmation is required
+    pub requires_confirmation: bool,
+    /// Unique ID for tracking this transition request
+    pub transition_id: String,
+}
+
+/// File info for phase transition review
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct PhaseFileInfo {
+    pub id: Uuid,
+    pub name: String,
+    pub description: Option<String>,
+}
+
+/// Task info for phase transition review
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct PhaseTaskInfo {
+    pub id: Uuid,
+    pub name: String,
+    pub status: String,
 }
 
 /// Contract event record from the database