Address architecture + stability review (todo §0): wire buildContext, graceful shutdown, prod template caching

README.md

@@ -346,6 +346,9 @@ docker compose -f compose.yml up --build -d   # base config only, no source moun
 
 _(Production compose grows to include the Ory services and Postgres — planned.)_
 
+The server drains in-flight requests on `SIGTERM`/`SIGINT` rather than cutting them
+mid-response, so container restarts are clean.
+
 ## Layout
 
 ```
@@ -365,6 +368,8 @@ html-css-foundation/ Raw HTML/CSS design reference — the source for the
                      building-block partials; not served.
 ```
 
+Comments and docs cite roadmap phases as `§N` — the sections in `todo.md`.
+
 ## Extending the core
 
 - **New page in a plugin:** add a route + handler to the plugin manifest and a