feat(docs): save chat answers as docs — edit screen, commit + push to the .env docs branch

tests/integration/test_api.py

@@ -18,13 +18,16 @@ def test_health_reports_ok(client) -> None:
 
 
 def test_config_returns_default_app_metadata(client) -> None:
-    """GET /api/config is public (anonymous) and returns exactly two keys."""
+    """GET /api/config is public (anonymous) and returns exactly three
+    keys — the phase-39 app metadata + the phase-59 docs flag (inert
+    false while BOR_DOCS_REPO is empty — the "Save as doc" gating)."""
     r = client.get("/api/config")
     assert r.status_code == 200
     body = r.json()
-    assert set(body) == {"app_name", "version"}
+    assert set(body) == {"app_name", "version", "docs_repo_configured"}
     assert body["app_name"] == "Brain of Reese"
     assert body["version"] == get_settings().app_version
+    assert body["docs_repo_configured"] is False
 
 
 def test_config_follows_overridden_app_name(client) -> None:
@@ -39,9 +42,32 @@ def test_config_follows_overridden_app_name(client) -> None:
         r = client.get("/api/config")
         assert r.status_code == 200
         body = r.json()
-        assert set(body) == {"app_name", "version"}
+        assert set(body) == {"app_name", "version", "docs_repo_configured"}
         assert body["app_name"] == "Brain of Testy"
         assert body["version"] == "0.1.0"
+        assert body["docs_repo_configured"] is False
+    finally:
+        fastapi_app.dependency_overrides.clear()
+
+
+def test_config_docs_flag_tracks_settings(client) -> None:
+    """Phase 59 (task 05): ``docs_repo_configured`` mirrors
+    ``settings.docs_configured`` — a real bool (never a truthy string)
+    that flips true the moment BOR_DOCS_REPO is non-empty: that flag is
+    the entire frontend gating of the "Save as doc" button."""
+    from app.config import Settings
+    from app.main import app as fastapi_app
+
+    fastapi_app.dependency_overrides[get_settings] = lambda: Settings(
+        app_name="Brain of Testy",
+        docs_repo="/srv/docs-repo",
+    )
+    try:
+        r = client.get("/api/config")
+        assert r.status_code == 200
+        body = r.json()
+        assert isinstance(body["docs_repo_configured"], bool)
+        assert body["docs_repo_configured"] is True
     finally:
         fastapi_app.dependency_overrides.clear()