docs: add tested local quickstart for issue 24

tests/test_readme.py

@@ -2,6 +2,7 @@ from pathlib import Path
 
 
 README = Path(__file__).parents[1] / "README.md"
+REQUIREMENTS = Path(__file__).parents[1] / "requirements.txt"
 
 
 def test_release_worker_instructions_use_direct_agent_execution():
@@ -10,3 +11,15 @@ def test_release_worker_instructions_use_direct_agent_execution():
     assert "codex" not in text.lower()
     assert "RELEASE_AGENT_COMMAND=true" in text
     assert "--issue 19" in text
+
+
+def test_readme_documents_a_complete_local_quickstart():
+    text = README.read_text()
+
+    assert "python3 -m venv .venv" in text
+    assert "pip install -r requirements.txt" in text
+    assert "GITEA_URL" in text
+    assert "GITEA_TOKEN" in text
+    assert "uvicorn src.main:app" in text
+    assert "http://127.0.0.1:8000/api/v1/context" in text
+    assert "uvicorn==" in REQUIREMENTS.read_text()