fix(api): return queued or failed rows from /extract/url instead of 500

Submitting a URL whose row already existed but was not finished (pending,
processing or failed) returned 500: ExtractionResponse required a full
ReelExtraction and a title, and it dropped status/error. The response
model now matches what the table actually holds, so the dashboard shows
the queue or failure banner for that reel.

Claude-Session: https://claude.ai/code/session_0166W7S7XvHg5P2uyJtP4GiC

main.py

@@ -160,13 +160,18 @@ class ReelExtraction(BaseModel):
         return str(item).strip()
 
 class ExtractionResponse(BaseModel):
+    """A saved reel row. /extract/url can return one that is still queued or
+    failed (the URL was already submitted), so only finished rows carry a
+    title and a full ReelExtraction in extracted_json."""
     id: Optional[str] = None
     url: Optional[str] = None
-    title: str
+    title: Optional[str] = None
     raw_transcript: Optional[str] = None
     post_caption: Optional[str] = None
-    extracted_json: ReelExtraction
+    extracted_json: dict
     created_at: Optional[str] = None
+    status: str = "done"
+    error: Optional[str] = None
 
 
 def _chat_json(task: str, system_prompt: str, user_prompt: str, parse):

verify_pipeline.py

@@ -167,6 +167,26 @@ def test_extract_url_regression():
         main.db.get_reel_by_url = orig_cache
 
 
+def test_extract_url_returns_unfinished_row():
+    print("Testing POST /extract/url returns an already-queued or failed row instead of 500...")
+    import main
+    orig = main.db.get_reel_by_url
+    try:
+        # title is None for rows the iPhone Shortcut inserts over REST
+        for status, title, error in (("pending", None, None), ("failed", "Reel (Q)", "Meta blocking request")):
+            main.db.get_reel_by_url = lambda url: {
+                "id": "row-q", "url": url, "title": title, "raw_transcript": "", "post_caption": None,
+                "extracted_json": {}, "created_at": "2026-10-10T00:00:00Z", "cluster": "Unclustered",
+                "status": status, "error": error}
+            r = client.post("/extract/url", json={"url": "https://www.instagram.com/reel/QUEUED1/"})
+            assert r.status_code == 200, r.text
+            assert r.json()["status"] == status, r.json()
+            assert r.json()["error"] == error, r.json()
+        print("[OK] extract_url unfinished-row passthrough passed!")
+    finally:
+        main.db.get_reel_by_url = orig
+
+
 def test_worker_tick_success():
     print("Testing worker_tick processes a pending reel (mocked)...")
     import main
@@ -701,6 +721,7 @@ if __name__ == "__main__":
     test_worker_tick_empty()
     test_run_worker_drain()
     test_extract_url_regression()
+    test_extract_url_returns_unfinished_row()
     test_delete_reel()
     test_get_reel_details()
     test_reels_include_cluster()