refactor: consolidate project structure and clean up documentation

- Move docs to docs/ (philosophy, roadmap, orchestration scenarios,
  claude integration, testing improvements)
- Strip completed phases from roadmap and claude integration docs
- Move dependencies from requirements*.txt into pyproject.toml
- Move pytest config from pytest.ini into pyproject.toml
- Add Makefile replacing wakeup.sh (setup, run, test, lint, etc.)
- Add CI test gate in Gitea Actions workflow
- Consolidate caches into .cache/ (pytest, mypy, ruff)
- Consolidate build output into build/ (coverage, logs)
- Update Dockerfile for pyproject.toml install
- Update cross-references in README, AGENTS.md, CLAUDE.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

pyproject.toml

@@ -7,14 +7,64 @@ name = "tatlock"
 version = "2.0.5"
 description = "OpenAI-compatible API with Ollama backend"
 requires-python = ">=3.12"
-dependencies = []
+dependencies = [
+    "fastapi>=0.123,<0.124",
+    "uvicorn[standard]>=0.38,<0.39",
+    "pydantic>=2.11,<2.13",
+    "pydantic-settings>=2.12,<2.13",
+    "pydantic-ai-slim[openai,anthropic]>=1.27,<1.28",
+    "httpx>=0.28,<0.29",
+    "sse-starlette>=3.0,<3.1",
+    "python-dotenv>=1.2,<1.3",
+    "starlette>=0.45,<0.46",
+    "redis[hiredis]>=5.2,<6.0",
+    "qdrant-client>=1.12,<2.0",
+    "structlog>=24.1,<25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3,<8.4",
+    "pytest-asyncio>=0.25,<0.26",
+    "pytest-cov>=6.0,<6.1",
+    "pytest-mock>=3.14,<3.15",
+    "ruff>=0.8,<0.9",
+    "mypy>=1.14,<1.15",
+    "faker>=34.0,<35.0",
+    "coverage[toml]>=7.7,<7.8",
+]
 
 [tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
 asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+cache_dir = ".cache/pytest"
+markers = [
+    "unit: Unit tests",
+    "integration: Integration tests",
+    "slow: Slow running tests",
+]
+addopts = [
+    "--verbose",
+    "--strict-markers",
+    "--tb=short",
+    "--cov=src",
+    "--cov-report=term-missing",
+    "--cov-report=html:build/coverage/html",
+    "--cov-report=xml:build/coverage/coverage.xml",
+    "--cov-branch",
+]
+filterwarnings = [
+    "ignore::DeprecationWarning",
+]
 
 [tool.coverage.run]
 source = ["src"]
 branch = true
+data_file = "build/coverage/.coverage"
 omit = [
     "*/tests/*",
     "*/__pycache__/*",
@@ -37,11 +87,15 @@ exclude_lines = [
 ]
 
 [tool.coverage.html]
-directory = "htmlcov"
+directory = "build/coverage/html"
+
+[tool.coverage.xml]
+output = "build/coverage/coverage.xml"
 
 [tool.ruff]
 line-length = 100
 target-version = "py312"
+cache-dir = ".cache/ruff"
 
 [tool.ruff.lint]
 select = [
@@ -64,6 +118,7 @@ ignore = [
 
 [tool.mypy]
 python_version = "3.12"
+cache_dir = ".cache/mypy"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true