src/main.py

@@ -21,6 +21,12 @@ app.add_middleware(
 app.include_router(frontend_router)
 
 
+@app.get("/healthz")
+def health() -> dict[str, str]:
+    """Return process liveness without depending on Gitea."""
+    return {"status": "ok", "service": "stackchain-dashboard"}
+
+
 @app.get("/api/v1/context")
 async def context() -> JSONResponse:
     try:

tests/test_health.py

@@ -0,0 +1,6 @@
+from src.main import app, health
+
+
+def test_health_endpoint_reports_service_liveness_without_gitea_access():
+    assert any(getattr(route, "path", None) == "/healthz" for route in app.routes)
+    assert health() == {"status": "ok", "service": "stackchain-dashboard"}