fix(dev): exclude runtime state from gateway reload (#3426)

backend/tests/test_dev_entrypoint.py

@@ -40,6 +40,19 @@ def test_entrypoint_script_exists_and_is_posix_sh():
     assert proc.returncode == 0, proc.stderr
 
 
+def test_entrypoint_excludes_runtime_state_from_uvicorn_reload():
+    content = ENTRYPOINT.read_text(encoding="utf-8")
+
+    assert ': "${DEER_FLOW_HOME:=/app/backend/.deer-flow}"' in content
+    assert 'mkdir -p "$DEER_FLOW_HOME" /app/backend/.deer-flow' in content
+    assert "--reload-include='*.yaml .env'" not in content
+    assert "--reload-include='*.yaml'" in content
+    assert "--reload-include='.env'" in content
+    assert "--reload-exclude=/app/backend/sandbox" in content
+    assert '--reload-exclude="$DEER_FLOW_HOME"' in content
+    assert "--reload-exclude=/app/backend/.deer-flow" in content
+
+
 def test_no_uv_extras_yields_empty_flags():
     proc = _run(None)
     assert proc.returncode == 0

backend/tests/test_gateway_runtime_cleanup.py

@@ -43,6 +43,19 @@ def test_service_launchers_always_use_gateway_runtime():
         assert "LANGGRAPH_REWRITE" not in content, path
 
 
+def test_local_dev_gateway_reload_excludes_runtime_state_with_absolute_dirs():
+    serve_sh = _read("scripts/serve.sh")
+
+    assert 'export DEER_FLOW_PROJECT_ROOT="$REPO_ROOT"' in serve_sh
+    assert 'BACKEND_RUNTIME_HOME="$REPO_ROOT/backend/.deer-flow"' in serve_sh
+    assert 'export DEER_FLOW_HOME="$BACKEND_RUNTIME_HOME"' in serve_sh
+    assert 'mkdir -p "$DEER_FLOW_HOME" "$BACKEND_RUNTIME_HOME"' in serve_sh
+    assert "--reload-exclude='$DEER_FLOW_HOME'" in serve_sh
+    assert "--reload-exclude='$BACKEND_RUNTIME_HOME'" in serve_sh
+    assert "--reload-exclude='sandbox/'" not in serve_sh
+    assert "--reload-exclude='.deer-flow/'" not in serve_sh
+
+
 def test_backend_container_only_exposes_gateway_port():
     dockerfile = _read("backend/Dockerfile")