feat: Add config analysis lifecycle guarantees

Stainless-Generated-From: 3a35e0b87b6364867c5a45f32039f9448f234afd

Author: kernel-internal[bot]

src/kernel/types/analysis.py

@@ -17,14 +17,17 @@ class Analysis(BaseModel):
     created_at: datetime
     """Time the analysis was created."""
 
+    expires_at: datetime
+    """Deadline after which a still-running analysis becomes expired."""
+
     failure: Optional[ErrorModel] = None
-    """Present for failed or canceled analyses.
+    """Present for failed, canceled, or expired analyses.
 
     Messages contain safe retry guidance rather than internal workflow errors.
     """
 
     finished_at: Optional[datetime] = None
     """Time the analysis reached a terminal status. Null while it is running."""
 
-    status: Literal["running", "completed", "failed", "canceled"]
+    status: Literal["running", "completed", "failed", "canceled", "expired"]
     """Lifecycle status of a background analysis."""

src/kernel/types/recommendation_summary.py

@@ -14,7 +14,7 @@ class RecommendationSummary(BaseModel):
     analysis_id: str
     """ID of the most recently requested analysis for this exact target."""
 
-    analysis_status: Literal["running", "completed", "failed", "canceled"]
+    analysis_status: Literal["running", "completed", "failed", "canceled", "expired"]
     """Lifecycle status of the most recently requested analysis for this exact target."""
 
     last_requested_at: datetime