Scaffold project and author 14-phase roadmap

Browser co-op kitchen game: FastAPI + native WebSockets, server-authoritative
20 Hz simulation, in-memory anonymous lobbies, data-driven YAML levels, Canvas 2D
vanilla ES-module client with locally authored SVG art and no external CDNs.

.agents/PLAN.md records the LOCKED decisions; .agents/user_stories/ holds the 12
flow contracts; .agents/phases/todo/ breaks them into 14 sequential, test-gated
phases (71 task files), each leaving the app launchable and the suite green.

LLM-Generated: true
This commit is contained in:
2026-10-05 17:05:56 -04:00
commit f84c6ebaef
105 changed files with 5752 additions and 0 deletions
+89
View File
@@ -0,0 +1,89 @@
[project]
name = "undercooked"
version = "0.1.0"
description = "Cooperative in-browser kitchen chaos game: anonymous lobbies, server-authoritative real-time play, escalating data-driven levels."
readme = "README.md"
requires-python = ">=3.12"
license = { text = "MIT" }
authors = [{ name = "Reese Apps" }]
dependencies = [
"fastapi>=0.115",
"uvicorn[standard]>=0.32",
"pydantic>=2.9",
"python-dotenv>=1.0",
"pyyaml>=6.0",
"websockets>=13.0",
]
[project.optional-dependencies]
dev = [
"debugpy>=1.8",
"ruff>=0.7",
"pyright>=1.1.380",
"pytest>=8.3",
"pytest-asyncio>=0.24",
"pytest-cov>=5.0",
"httpx>=0.27",
"playwright>=1.48",
]
[project.scripts]
undercooked = "undercooked.__main__:main"
undercooked-levels = "undercooked.tools.levels:main"
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[tool.hatch.build.targets.wheel]
packages = ["src/undercooked"]
[tool.ruff]
line-length = 100
target-version = "py312"
src = ["src", "tests"]
[tool.ruff.lint]
select = [
"E", "F", "W", "I", "N", "UP", "B", "C4", "SIM", "ASYNC",
"S", "RUF", "ARG", "RET", "PL", "PERF",
]
ignore = [
"PLR0913", # simulation constructors legitimately take many entity args
"PLR2004", # readable numeric assertions in tests
"S101", # assert is the test language; unsafe-usages reviewed manually
]
[tool.ruff.lint.per-file-ignores]
"tests/**" = ["S101", "PLR2004", "ARG001", "ARG002"]
[tool.pyright]
include = ["src", "tests"]
pythonVersion = "3.12"
typeCheckingMode = "standard"
reportMissingImports = "error"
reportUnusedImport = "warning"
strictListInference = true
strictDictionaryInference = true
[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "-ra --strict-markers --cov=undercooked --cov-report=term-missing --cov-fail-under=90"
asyncio_mode = "auto"
markers = [
"unit: pure, no I/O (fast)",
"integration: multi-module, in-process server/room tests",
"e2e: Playwright browser suites, one per user story",
"slow: replay/stress tests excluded from the quick loop",
]
[tool.coverage.run]
branch = true
source = ["src/undercooked"]
[tool.coverage.report]
exclude_lines = [
"pragma: no cover",
"if TYPE_CHECKING:",
"raise NotImplementedError",
]