test: integration coverage report, suite docs and harness isolation fix

tests/integration/test_scenario_issue_pull.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import asyncio
 import time
 
 from tests.integration.conftest import McpSession, RegularUser, RepoRef, b64
@@ -109,7 +110,7 @@ async def test_issue_lifecycle(
         found = await mcp.ok("gitea_issue_list_issues", q="widget", **repo)
         hits = [item["number"] for item in found.data]
         if index not in hits:
-            time.sleep(0.5)
+            await asyncio.sleep(0.5)
     assert index in hits
     assert (await mcp.ok("gitea_issue_search_issues", q="Broken widget")).data is not None