From 007629443bd5d0efcbb2f9f0a0e93de8be0cfaeb Mon Sep 17 00:00:00 2001
From: Anish Sarkar <104695310+AnishSarkar22@users.noreply.github.com>
Date: Tue, 14 Jul 2026 00:14:28 +0530
Subject: [PATCH] feat(db): add llm_setup_completed_at column to workspace

---
 surfsense_backend/app/db.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/surfsense_backend/app/db.py b/surfsense_backend/app/db.py
index 380a8b2bf..d5bad55e0 100644
--- a/surfsense_backend/app/db.py
+++ b/surfsense_backend/app/db.py
@@ -1732,6 +1732,11 @@ class Workspace(BaseModel, TimestampMixin):
         Integer, nullable=True, default=0, server_default="0"
     )  # For vision/screenshot analysis, defaults to Auto mode
 
+    # First time this workspace went ready via its own model (source=="models").
+    # NULL = never self-configured. Set once, never cleared; splits a needs_setup
+    # verdict into first-run vs. recovery.
+    llm_setup_completed_at = Column(TIMESTAMP(timezone=True), nullable=True)
+
     user_id = Column(
         UUID(as_uuid=True), ForeignKey("user.id", ondelete="CASCADE"), nullable=False
     )