Add startup background heartbeat loop

app/background.py

@@ -0,0 +1,11 @@
+import asyncio
+from app.drive_client import write_heartbeat_to_drive
+
+async def heartbeat_loop(root_folder_id: str, poll_seconds: int):
+    # ✅ once on startup (immediate)
+    write_heartbeat_to_drive(root_folder_id)
+
+    # ✅ then every poll_seconds
+    while True:
+        await asyncio.sleep(poll_seconds)
+        write_heartbeat_to_drive(root_folder_id)

app/config.py

@@ -1,4 +1,4 @@
 import os
 
-ROOT_FOLDER_ID = os.getenv("ROOT_FOLDER_ID")
+ROOT_FOLDER_ID = os.getenv("ROOT_FOLDER_ID","")
 POLL_SECONDS = int(os.getenv("POLL_SECONDS", "300"))

app/drive_client.py

@@ -0,0 +1,18 @@
+import json
+from datetime import datetime, timezone
+
+def heartbeat_payload(version: str = "0.1.0") -> dict:
+    return {
+        "service": "sa-resume-worker",
+        "status": "alive",
+        "last_seen": datetime.now(timezone.utc).isoformat().replace("+00:00", "Z"),
+        "version": version,
+    }
+
+def write_heartbeat_to_drive(root_folder_id: str) -> None:
+    """
+    TODO: Replace this with real Google Drive API upload/update.
+    For now: print payload so you prove the coroutine timing works.
+    """
+    payload = heartbeat_payload()
+    print(f"[HEARTBEAT] root={root_folder_id} payload={json.dumps(payload)}")

app/main.py

@@ -1,10 +1,36 @@
+import asyncio
 from fastapi import FastAPI
+
 from app.health import router as health_router
+from app.config import ROOT_FOLDER_ID, POLL_SECONDS
+from app.background import heartbeat_loop
 
 app = FastAPI(title="SA Resume Worker")
 
+# Root endpoint (for HF UI)
 @app.get("/")
 def root():
-    return {"service": "sa-resume-worker", "status": "running"}
+    return {
+        "service": "sa-resume-worker",
+        "status": "running"
+    }
+
+# Health endpoint
+app.include_router(health_router)
+
+# 🔹 STARTUP HOOK
+@app.on_event("startup")
+async def start_background_tasks():
+    # ---- TEMPORARY CONFIG LOGS (REMOVE LATER) ----
+    print("[STARTUP] Worker starting up")
+    print(f"[CONFIG] ROOT_FOLDER_ID set: {bool(ROOT_FOLDER_ID)}")
+    print(f"[CONFIG] POLL_SECONDS = {POLL_SECONDS}")
+    # --------------------------------------------
 
-app.include_router(health_router)
+    # Start ONE background coroutine (do not await)
+    asyncio.create_task(
+        heartbeat_loop(
+            root_folder_id=ROOT_FOLDER_ID,
+            poll_seconds=POLL_SECONDS
+        )
+    )