Deploy Hallway 8 (multi-arc memory game)

Dockerfile

@@ -0,0 +1,25 @@
+# Container image for hosting the game (works as-is on Hugging Face Spaces
+# with the Docker SDK, which expects the app on port 7860).
+FROM python:3.11-slim
+
+# Hugging Face Spaces runs containers as a non-root user (uid 1000).
+RUN useradd -m -u 1000 user
+USER user
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH \
+    HOST=0.0.0.0 \
+    PORT=7860
+
+WORKDIR /app
+
+COPY --chown=user requirements.txt .
+RUN pip install --no-cache-dir --user -r requirements.txt
+
+COPY --chown=user . .
+
+EXPOSE 7860
+
+# IMPORTANT: a single worker. Game state (and each corridor's answer) lives in
+# memory in one process; multiple workers would split that state and break runs.
+# Threads give plenty of concurrency for this lightweight app.
+CMD ["gunicorn", "-w", "1", "--threads", "8", "-b", "0.0.0.0:7860", "app:app"]

LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

README.md

@@ -1,10 +1,250 @@
 ---
-title: Hallway8
-emoji: 🚀
-colorFrom: blue
-colorTo: pink
+title: Hallway 8
+emoji: 🚪
+colorFrom: gray
+colorTo: indigo
 sdk: docker
+app_port: 7860
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Hallway 8
+
+[![Deploy to Hugging Face Spaces](https://huggingface.co/datasets/huggingface/badges/resolve/main/deploy-to-spaces-md.svg)](https://huggingface.co/new-space?sdk=docker)
+
+A small browser game about memory and doubt.
+
+You move through a place that should be identical every time. If anything
+differs from what you remember, **turn back**. If nothing has changed, **go
+on**. Reach the eighth loop without contradicting your own memory. Get it wrong
+and you start over.
+
+The trick is that the place is never described the same way twice. Only a
+handful of its details are mentioned each loop, and each is phrased from a pool
+of interchangeable sentences — so you can't compare two loops word-for-word.
+You're forced to remember *meaning*, not wording. Somewhere in that fog, one
+detail occasionally changes for real.
+
+## Scenarios (arcs)
+
+The game ships with several **arcs** — each its own backstory, vocabulary, and
+visual skin, all sharing the one mechanic. You pick one from the opening screen.
+
+- **Hallway 8** — locked in after hours, you follow a sign to the fire exit and
+  walk corridor after identical corridor toward the eighth fire door.
+- **Stairway 8** — the elevator is out of order, so you descend eight flights on
+  foot, checking each landing before you keep going down to the ground floor.
+- **Coach 8** — the conductor sent you forward to coach 8, but the night train
+  never seems to reach it; you walk carriage after identical carriage.
+
+Every arc carries more than physical changes: each has an **NPC** who is usually
+passive but can become the anomaly (turning to face you, moving, vanishing) —
+including a loop-aware twist where they *acknowledge you* — and a psychological
+`sense` layer where the wrongness is in perception, not objects (a corridor that
+feels too long, a calm that shouldn't be there).
+
+Arcs live as self-contained JSON files in `data/arcs/`. Adding a new one is just
+dropping in another file (see *Adding an arc* below) — no code changes needed.
+The design rules and the queue of future arcs are kept in
+[`docs/ARCS.md`](docs/ARCS.md).
+
+## What makes it unsettling
+
+- **Partial description.** Each corridor has eight properties (lighting, sound,
+  the man down the hall, the exit sign, a door, a camera, the floor, a poster),
+  but only four to six are ever mentioned per loop.
+- **Rotating prose.** Every detail is drawn from several equivalent sentences,
+  so the wording drifts even when nothing has actually changed.
+- **A single quiet mutation.** When a corridor *is* different, exactly one
+  property has shifted to a plausible variant — nothing screams "look here."
+- **Confidence as a mechanic.** Before you commit, you rate how sure you are.
+- **A corridor that notices you.** Linger on one detail across loops and the
+  narration begins to react to your habits.
+- **Presentation drift.** Heading, pacing, font weight, letter spacing, and the
+  background shift a fraction each loop — felt more than seen.
+
+---
+
+## Run it locally
+
+You need **Python 3.9+** (any recent Python 3 works).
+
+**1. Get the code**
+
+```bash
+git clone https://github.com/alvations/hallway8.git
+cd hallway8
+```
+
+**2. (Optional but recommended) create a virtual environment**
+
+```bash
+python -m venv .venv
+source .venv/bin/activate        # Windows: .venv\Scripts\activate
+```
+
+**3. Install the dependencies**
+
+```bash
+pip install -r requirements.txt
+```
+
+**4. Start the server**
+
+```bash
+python app.py
+```
+
+You'll see something like `Running on http://127.0.0.1:5000`.
+
+**5. Open the game in your browser**
+
+Go to **<http://127.0.0.1:5000>** and press **Begin**.
+
+To stop the server, press `Ctrl+C` in the terminal.
+
+### Options
+
+| Variable     | Default     | What it does                                            |
+|--------------|-------------|---------------------------------------------------------|
+| `PORT`       | `5000`      | Port the server listens on.                             |
+| `HOST`       | `127.0.0.1` | Interface to bind. Use `0.0.0.0` to expose on a network.|
+| `SECRET_KEY` | random      | Set a fixed value to keep sessions stable across restarts. |
+
+Example: `PORT=8000 python app.py` then open <http://127.0.0.1:8000>.
+
+---
+
+## Host it on Hugging Face Spaces
+
+This repo is ready to run as a **Docker Space**. The included `Dockerfile`
+serves the app on port `7860`, and the metadata block at the very top of this
+README is the Space card Hugging Face reads — so there's nothing extra to
+configure.
+
+**Prerequisites:** a free Hugging Face account (<https://huggingface.co/join>).
+For the git and CLI methods you'll also need a **write access token** from
+<https://huggingface.co/settings/tokens>.
+
+### Step 1 — create the Space
+
+Click the **Deploy to Spaces** badge at the top of this README, or go to
+<https://huggingface.co/new-space> and:
+
+1. **Owner / Space name** — e.g. `hallway8`.
+2. **SDK** — choose **Docker**, then the **Blank** template.
+3. **Hardware** — the free **CPU basic** tier is plenty.
+4. **Visibility** — Public or Private, your call. Create the Space.
+
+You now have an empty Space at
+`https://huggingface.co/spaces/<your-username>/hallway8`.
+
+### Step 2 — get the code into the Space
+
+Pick whichever is easiest. All three upload the same files; the Space rebuilds
+on every change.
+
+**Option A — drag and drop (no tools needed)**
+
+In the Space's **Files** tab, click **Add file → Upload files** and upload the
+whole project. Make sure these are all present at the Space root: `Dockerfile`,
+`app.py`, `hallway.py`, `anomalies.py`, `memory.py`, `requirements.txt`,
+`README.md`, and the `data/`, `templates/`, and `static/` folders.
+
+**Option B — push with git**
+
+A Space is a git repo. Add it as a remote and push:
+
+```bash
+git remote add space https://huggingface.co/spaces/<your-username>/hallway8
+git push space main
+```
+
+When prompted, enter your **Hugging Face username** and paste your **access
+token** as the password. (To avoid the prompt, run `pip install -U huggingface_hub`
+then `hf auth login` once — it installs a git credential helper.)
+
+> If the Space was created with its own starter `README.md`, your first push may
+> be rejected as out of date. Either `git pull space main --rebase` first, or
+> `git push space main --force` to overwrite the starter files with this repo.
+
+**Option C — upload with the Hugging Face CLI**
+
+```bash
+pip install -U huggingface_hub
+hf auth login                       # paste your write token once
+hf upload <your-username>/hallway8 . . --repo-type=space
+```
+
+### Step 3 — watch it build and play
+
+Open the Space's **Logs** (or **App**) tab. Hugging Face builds the Docker
+image and starts the container; the first build takes a couple of minutes. Once
+the status turns **Running**, the game plays right there in the browser at
+`https://huggingface.co/spaces/<your-username>/hallway8`.
+
+### Recommended settings
+
+- In **Settings → Variables and secrets**, add a secret named `SECRET_KEY` with
+  any long random string. This keeps player sessions valid across Space
+  restarts. (Without it a fresh key is generated on each boot, which simply
+  resets any in-progress runs.)
+- The free tier **sleeps after a period of inactivity** and wakes on the next
+  visit — normal, and fine for a game like this.
+
+> **Why the Dockerfile pins a single worker:** the game keeps each corridor's
+> answer in server memory so the page can't be inspected to cheat. That state
+> lives in one process, so the app must run with a single worker (the Dockerfile
+> already does this). Don't scale it to multiple workers/replicas.
+
+### Add your own "Open in Spaces" badge
+
+Once your Space is live, you can point people straight at it by adding this near
+the top of the README (swap in your username):
+
+```markdown
+[![Open in Spaces](https://huggingface.co/datasets/huggingface/badges/resolve/main/open-in-hf-spaces-md.svg)](https://huggingface.co/spaces/<your-username>/hallway8)
+```
+
+### Other hosts
+
+The same `Dockerfile` runs anywhere that takes a container — Fly.io, Render,
+Railway, Google Cloud Run, etc. Point the platform at the image (or use
+`gunicorn -w 1 --threads 8 -b 0.0.0.0:$PORT app:app`) and keep it to a single
+worker for the reason above.
+
+---
+
+## Layout
+
+```
+app.py             Flask server; owns all game state, arc selection, and answers
+hallway.py         loads an arc, builds and describes a loop
+anomalies.py       anomaly selection + wording/heading drift
+memory.py          tracks the player's habits across loops
+data/arcs/*.json   one file per arc: meta/skin, properties, sentence pools, story
+templates/         the page
+static/            style (skins) + client logic (rendering, pacing, drift)
+Dockerfile         container image for Hugging Face Spaces and other hosts
+```
+
+The browser only ever receives a description — never whether a place has
+changed — so you can't read the page source to cheat.
+
+### Adding an arc
+
+Copy an existing file in `data/arcs/` and edit it. Each arc is fully
+self-contained:
+
+- **`meta`** — `id`, `title`, `tagline`, a `skin` name, the two action labels
+  (`go_on` / `turn_back`), a `progress` HUD template (placeholders `{level}`,
+  `{goal}`, `{floor}`, `{remaining}`), and friendly `labels` per property.
+- **`properties`** — each with a `baseline` value, a pool of interchangeable
+  `values` sentences, and `anomalies` (each an alternate value with its own
+  sentence pool). Only these ever change between loops.
+- **`title_variants`**, **`anchor_order`**, **`adaptive`**, and **`framing`**
+  (the intro and win text).
+
+To give the arc its own colours, add a `body[data-skin="<name>"]` block in
+`static/style.css`. The new arc appears automatically on the opening screen ���
+no code changes required.

anomalies.py

@@ -0,0 +1,47 @@
+"""Anomaly selection and the small "drift" tricks.
+
+Nothing here screams. An anomaly is a single property quietly swapped for a
+plausible variant. The drift helpers change wording, punctuation, and the
+heading itself so the player can never compare two loops character-for-character
+and must fall back on memory of *meaning*.
+"""
+
+from __future__ import annotations
+
+import random
+from typing import Dict, List, Optional, Tuple
+
+
+def pick_anomaly(properties: Dict[str, dict], rng: random.Random) -> Tuple[str, str]:
+    """Choose one property and one of its anomalous values.
+
+    Returns (property_name, anomaly_value).
+    """
+    candidates = [name for name, spec in properties.items() if spec.get("anomalies")]
+    prop = rng.choice(candidates)
+    value = rng.choice(list(properties[prop]["anomalies"].keys()))
+    return prop, value
+
+
+def drift_heading(title_variants: List[str], loops: int, rng: random.Random) -> str:
+    """The heading is usually 'Hallway 8', but every so often it slips.
+
+    Early on it is stable. The longer the player survives, the more the
+    heading is allowed to wander -- a meta anomaly they can never act on.
+    """
+    if loops < 4:
+        return title_variants[0]
+    # a small, growing chance of a slipped heading
+    if rng.random() < min(0.05 + loops * 0.01, 0.30):
+        return rng.choice(title_variants)
+    return title_variants[0]
+
+
+def drift_sign(sign_variants: List[str], rng: random.Random) -> str:
+    """The exit sign's spacing/arrow drifts even when it is *not* the anomaly."""
+    return rng.choice(sign_variants)
+
+
+def render_sentence(template: str, sign_text: str) -> str:
+    """Fill the shared placeholders in a sentence template."""
+    return template.replace("{SIGN}", sign_text)

app.py

@@ -0,0 +1,208 @@
+"""A tiny Flask server for the memory-loop game.
+
+Run:  python app.py   then open  http://127.0.0.1:5000
+
+The game ships several *arcs* (skins/backstories) that share one mechanic.
+Game state -- and, crucially, the answer to each loop -- lives on the server.
+The browser only ever receives the description, never whether a place is
+anomalous, so the page cannot be inspected to cheat.
+"""
+
+from __future__ import annotations
+
+import os
+import random
+import secrets
+from typing import Dict
+
+from flask import (
+    Flask,
+    jsonify,
+    render_template,
+    request,
+    session,
+)
+
+from hallway import Hallway, GOAL, DEFAULT_ARC, list_arcs
+from memory import PlayerMemory
+
+app = Flask(__name__)
+app.secret_key = os.environ.get("SECRET_KEY", secrets.token_hex(32))
+
+# Available arcs, and a cache of one Hallway per arc (each just holds parsed
+# JSON, so sharing them across requests is safe).
+ARCS = {a["id"]: a for a in list_arcs()}
+_HALLWAYS: Dict[str, Hallway] = {}
+
+
+def get_hallway(arc_id: str) -> Hallway:
+    if arc_id not in ARCS:
+        arc_id = DEFAULT_ARC
+    if arc_id not in _HALLWAYS:
+        _HALLWAYS[arc_id] = Hallway(arc_id)
+    return _HALLWAYS[arc_id]
+
+
+# Server-side session store, keyed by a token kept in the signed cookie.
+# Holds the live PlayerMemory, the current (answer-bearing) room, the RNG,
+# and which arc is being played. In-memory is fine for a single process.
+STATE: Dict[str, dict] = {}
+
+
+def _slot() -> dict:
+    """Return this browser's server-side state, creating it if needed."""
+    token = session.get("token")
+    if not token or token not in STATE:
+        token = secrets.token_hex(16)
+        session["token"] = token
+        STATE[token] = _fresh(DEFAULT_ARC)
+    return STATE[token]
+
+
+def _fresh(arc_id: str) -> dict:
+    return {
+        "mem": PlayerMemory(),
+        "room": None,
+        "rng": random.Random(secrets.randbits(64)),
+        "arc": arc_id if arc_id in ARCS else DEFAULT_ARC,
+    }
+
+
+def _hall(slot: dict) -> Hallway:
+    return get_hallway(slot["arc"])
+
+
+def _next_room(slot: dict) -> dict:
+    mem: PlayerMemory = slot["mem"]
+    mem.loops += 1
+    room = _hall(slot).build(mem, slot["rng"])
+    slot["room"] = room
+    return room
+
+
+def _payload(slot: dict, room: dict, extra: dict | None = None) -> dict:
+    mem: PlayerMemory = slot["mem"]
+    hall = _hall(slot)
+    data = {
+        "room": hall.public(room),
+        "meta": hall.meta,
+        "level": mem.level,
+        "goal": GOAL,
+        "best": mem.best_level,
+        "loops": mem.loops,
+    }
+    if extra:
+        data.update(extra)
+    return jsonify(data)
+
+
+@app.route("/")
+def index():
+    return render_template("index.html")
+
+
+@app.route("/api/arcs", methods=["GET"])
+def api_arcs():
+    return jsonify({"arcs": list(ARCS.values()), "default": DEFAULT_ARC})
+
+
+@app.route("/api/new", methods=["POST"])
+def api_new():
+    body = request.get_json(silent=True) or {}
+    arc_id = body.get("arc", DEFAULT_ARC)
+    if arc_id not in ARCS:
+        arc_id = DEFAULT_ARC
+
+    token = session.get("token") or secrets.token_hex(16)
+    session["token"] = token
+    STATE[token] = _fresh(arc_id)
+    slot = STATE[token]
+
+    room = _next_room(slot)
+    return _payload(slot, room, {"intro": _hall(slot).intro()})
+
+
+@app.route("/api/room", methods=["GET"])
+def api_room():
+    slot = _slot()
+    room = slot["room"] or _next_room(slot)
+    return _payload(slot, room)
+
+
+@app.route("/api/inspect", methods=["POST"])
+def api_inspect():
+    """The player lingers on one detail. The place may notice."""
+    slot = _slot()
+    mem: PlayerMemory = slot["mem"]
+    prop = (request.get_json(silent=True) or {}).get("prop", "")
+    line = None
+    if prop:
+        mem.record_inspect(prop)
+        # Occasionally, staring too long earns an unsettling aside.
+        if slot["rng"].random() < 0.35:
+            line = slot["rng"].choice(_hall(slot).data["adaptive"]["long_look"])
+    return jsonify({"line": line})
+
+
+@app.route("/api/act", methods=["POST"])
+def api_act():
+    """The player commits: 'continue' goes on, 'back' turns around."""
+    slot = _slot()
+    mem: PlayerMemory = slot["mem"]
+    room = slot["room"]
+    if room is None:
+        room = _next_room(slot)
+
+    body = request.get_json(silent=True) or {}
+    choice = body.get("choice")
+    confidence = body.get("confidence")
+    mem.record_confidence(confidence)
+
+    has_anomaly = room["_has_anomaly"]
+    # Correct play: turn back on a changed place, go on when nothing changed.
+    correct = (choice == "back") == has_anomaly
+
+    if choice == "back":
+        mem.turn_backs += 1
+    else:
+        mem.continues += 1
+
+    won = False
+    if correct:
+        mem.level += 1
+        mem.best_level = max(mem.best_level, mem.level)
+        if mem.level >= GOAL:
+            won = True
+    else:
+        if not has_anomaly and choice == "back":
+            mem.false_reports += 1
+        elif has_anomaly and choice == "continue":
+            mem.missed += 1
+        mem.level = 0
+
+    result = {
+        "correct": correct,
+        "had_anomaly": has_anomaly,
+        "won": won,
+        "confidence": confidence,
+    }
+
+    if won:
+        result["win_text"] = _hall(slot).win()
+        result["stats"] = mem.to_dict()
+        # Reset progress so a fresh run starts clean, but keep the record.
+        best = mem.best_level
+        slot["mem"] = PlayerMemory(best_level=best)
+        room = _next_room(slot)
+        return _payload(slot, room, result)
+
+    room = _next_room(slot)
+    return _payload(slot, room, result)
+
+
+if __name__ == "__main__":
+    # HOST/PORT are env-driven so the same file runs locally (127.0.0.1:5000)
+    # and on a host like Hugging Face Spaces (0.0.0.0:7860).
+    host = os.environ.get("HOST", "127.0.0.1")
+    port = int(os.environ.get("PORT", "5000"))
+    app.run(host=host, port=port, debug=False)

data/arcs/coach8.json

@@ -0,0 +1,345 @@
+{
+  "_comment": "Coach arc. Same schema and mechanic as the others, different skin and story: a night train. The conductor sent you forward to coach 8, and you walk carriage after identical carriage. Turn back if a coach has changed; keep moving forward if it hasn't. Motion is part of the unease.",
+
+  "meta": {
+    "id": "coach8",
+    "title": "Coach 8",
+    "tagline": "The conductor said coach 8. The train never seems to reach it.",
+    "skin": "coach",
+    "go_on": "Next coach  →",
+    "turn_back": "Back a coach  ←",
+    "unit": "coach",
+    "progress": "Coach {level} / {goal}",
+    "labels": {
+      "lighting": "lights",
+      "sound": "sound",
+      "window": "window",
+      "passenger": "sleeping passenger",
+      "seatnum": "seat numbers",
+      "door": "connecting door",
+      "luggage": "luggage rack",
+      "table": "table",
+      "sense": "feeling"
+    }
+  },
+
+  "title_variants": ["Coach 8", "Coach 8", "Coach 8", "Coach 8", "Carriage 8", "Coach Eight", "COACH 8", "Coach  8"],
+
+  "sign_variants": ["COACH 8"],
+
+  "anchor_order": ["lighting", "sound", "window", "passenger", "seatnum", "door", "luggage", "table", "sense"],
+
+  "properties": {
+    "lighting": {
+      "baseline": "dim",
+      "values": {
+        "dim": [
+          "The cabin lights are dimmed for night, a soft amber wash.",
+          "Low night-lighting glows along the luggage racks, as always.",
+          "The overhead lights are down to their amber night setting.",
+          "The coach is lit the same soft gold as the last."
+        ]
+      },
+      "anomalies": {
+        "flicker": [
+          "The cabin lights flutter with the motion of the train, then hold.",
+          "One strip of lighting stutters overhead.",
+          "The amber light trips off, then on again."
+        ],
+        "bright": [
+          "The lights are up full, harsh and white — not the night setting.",
+          "This coach is lit far brighter than the last.",
+          "The soft amber is gone; everything glares white."
+        ],
+        "off": [
+          "The cabin is dark but for the emergency floor strips.",
+          "The lights are out here; only the aisle markers glow.",
+          "Darkness, save a thin line of light along the floor."
+        ]
+      }
+    },
+
+    "sound": {
+      "baseline": "rhythm",
+      "values": {
+        "rhythm": [
+          "The rails beat their steady rhythm beneath the floor.",
+          "The train hums along, wheels ticking over the joints.",
+          "That familiar sway and clatter of a train at speed."
+        ]
+      },
+      "anomalies": {
+        "slowing": [
+          "The rhythm of the rails is slowing. Are you stopping?",
+          "The clatter drags, as if the train is losing speed.",
+          "The beat beneath the floor stretches longer between ticks."
+        ],
+        "silence": [
+          "The wheels have gone silent. You feel no motion at all.",
+          "The train sound has stopped. Dead still.",
+          "No clatter, no sway. The train might not be moving."
+        ],
+        "announce": [
+          "A chime sounds, then a muffled announcement you can't make out.",
+          "The PA crackles with a voice, then cuts off.",
+          "An announcement plays — backwards, almost."
+        ],
+        "faster": [
+          "The rails beat faster than they should, a rising whine.",
+          "The train is accelerating, the clatter climbing in pitch.",
+          "Everything rattles harder; you're speeding up."
+        ]
+      }
+    },
+
+    "window": {
+      "baseline": "night",
+      "values": {
+        "night": [
+          "Beyond the window, black countryside and your own faint reflection.",
+          "The window shows only night and the ghost of the cabin.",
+          "Dark fields streak past the window, far-off lights scattered."
+        ]
+      },
+      "anomalies": {
+        "station": [
+          "The window shows a lit platform sliding by — a station, unannounced.",
+          "Outside, a station platform passes, empty and bright.",
+          "A station slides past the glass; you never felt the train slow."
+        ],
+        "reflection": [
+          "Your reflection in the glass is a half-second behind you.",
+          "The reflection in the window doesn't quite match the cabin.",
+          "Someone stands in the window's reflection who isn't in the coach."
+        ],
+        "daylight": [
+          "The window is bright with daylight. It was night a moment ago.",
+          "Outside the glass it is suddenly, impossibly, day.",
+          "Sunlight fills the window where there was only dark."
+        ],
+        "tunnel": [
+          "The window is pure black — a tunnel, roaring, with no end to it.",
+          "You're in a tunnel now; the glass shows only rushing dark.",
+          "Nothing but black tunnel wall streams past the window."
+        ]
+      }
+    },
+
+    "passenger": {
+      "baseline": "sleeping",
+      "values": {
+        "sleeping": [
+          "A lone passenger sleeps against the far window, coat over their face.",
+          "One passenger dozes midway down the coach, head tipped back.",
+          "The same sleeping figure slumps in a window seat, as before."
+        ]
+      },
+      "anomalies": {
+        "gone": [
+          "The seat where the passenger slept is empty now.",
+          "No one is sleeping in the coach this time.",
+          "The dozing passenger is gone; only a folded coat remains."
+        ],
+        "awake": [
+          "The passenger is awake now, sitting upright, very still.",
+          "The sleeper's eyes are open, fixed on the aisle.",
+          "The passenger no longer sleeps. They watch you pass."
+        ],
+        "moved": [
+          "The sleeping passenger has moved to a seat nearer the aisle.",
+          "The dozing figure is closer than before, on your side now.",
+          "The passenger sleeps in a different seat than a moment ago."
+        ],
+        "two": [
+          "Two passengers sleep here now, where there was one.",
+          "There are a pair of coats-over-faces this time, not one.",
+          "A second sleeping figure has joined the first."
+        ],
+        "speaks": [
+          "The sleeping passenger murmurs, without waking: 'again?'",
+          "From under the coat, a muffled voice: 'you were just here.'",
+          "The dozing figure says the name of your stop, though you told no one."
+        ]
+      }
+    },
+
+    "seatnum": {
+      "baseline": "eight",
+      "values": {
+        "eight": [
+          "The seat decals read 8A, 8B, 8C down the row.",
+          "Little brass numbers mark the seats: row 8, as always.",
+          "The coach-number panel by the door glows COACH 8."
+        ]
+      },
+      "anomalies": {
+        "wrong": [
+          "The seat decals read row 7 now, not 8.",
+          "The coach-number panel reads COACH 9.",
+          "The brass numbers say row 6; you were sure it was 8."
+        ],
+        "missing": [
+          "The seat numbers have been prised off; bare screw-holes remain.",
+          "The coach-number panel by the door is dark and blank.",
+          "There are no numbers on the seats at all this time."
+        ],
+        "letters": [
+          "The seat decals read 8X, 8Y, 8Z — letters that don't belong.",
+          "The row is numbered in an alphabet you don't recognise.",
+          "The seat labels are just symbols now, not numbers."
+        ]
+      }
+    },
+
+    "door": {
+      "baseline": "closed",
+      "values": {
+        "closed": [
+          "The connecting door at the coach's end is shut, its glass dark.",
+          "The powered door to the next carriage stands closed, as usual.",
+          "The end door is closed, the vestibule beyond it dim."
+        ]
+      },
+      "anomalies": {
+        "open": [
+          "The connecting door is stuck open, cold air rushing through.",
+          "The powered door won't close; the vestibule roars beyond.",
+          "The end door gapes open onto the shaking vestibule."
+        ],
+        "locked": [
+          "A red light burns on the connecting door: LOCKED.",
+          "The end door shows a locked indicator that was green before.",
+          "The door to the next coach reads DO NOT ENTER."
+        ],
+        "glass": [
+          "The glass in the connecting door is fogged, a hand-print on it.",
+          "Something smears the window of the end door from the far side.",
+          "The connecting door's glass is cracked in a spider's web."
+        ]
+      }
+    },
+
+    "luggage": {
+      "baseline": "stowed",
+      "values": {
+        "stowed": [
+          "A single suitcase sits in the luggage rack by the door.",
+          "The overhead racks hold the usual scattering of bags.",
+          "One hard-shell case rides the luggage rack, as before."
+        ]
+      },
+      "anomalies": {
+        "gone": [
+          "The luggage rack is empty now.",
+          "The suitcase by the door is gone.",
+          "There are no bags in the racks this time."
+        ],
+        "more": [
+          "The luggage rack is crammed full, far more bags than before.",
+          "Cases are stacked nearly to the ceiling now.",
+          "The racks overflow with luggage that wasn't there."
+        ],
+        "open": [
+          "The suitcase in the rack lies open, empty.",
+          "A case has spilled open across the luggage rack.",
+          "The hard-shell case gapes open, its contents gone."
+        ]
+      }
+    },
+
+    "table": {
+      "baseline": "coffee",
+      "values": {
+        "coffee": [
+          "A fold-down table by the aisle holds a half-finished coffee.",
+          "The tray table is down, a paper cup cooling on it, as always.",
+          "On the table, someone's coffee, still steaming faintly."
+        ]
+      },
+      "anomalies": {
+        "empty": [
+          "The table is bare; the coffee cup is gone.",
+          "The tray table holds nothing now.",
+          "There's no cup on the table this time."
+        ],
+        "cold": [
+          "The coffee on the table has gone cold, a skin across the top.",
+          "The cup is stone cold now, long abandoned.",
+          "The coffee sits cold and still, no steam at all."
+        ],
+        "many": [
+          "The table is crowded with cups now, not one but many.",
+          "Several coffees crowd the tray table where there was one.",
+          "The table is cluttered with more cups than anyone could drink."
+        ],
+        "spilled": [
+          "The coffee has spilled, a dark stain spreading over the table.",
+          "The cup is tipped, coffee running off the table's edge.",
+          "Coffee pools across the table, dripping to the floor."
+        ]
+      }
+    },
+
+    "sense": {
+      "baseline": "steady",
+      "values": {
+        "steady": [
+          "The train feels exactly as long as it always has.",
+          "You carry the same tired patience up the aisle, coach after coach.",
+          "Everything feels as ordinary as a night train should."
+        ]
+      },
+      "anomalies": {
+        "forget": [
+          "For a moment you can't remember how many coaches you've walked.",
+          "You lose count of the carriages behind you, and it frightens you.",
+          "You can't recall boarding this train at all."
+        ],
+        "calm": [
+          "You feel suddenly, wrongly calm — as if you'd already arrived.",
+          "A strange contentment settles over you that has no business being here.",
+          "You feel no urgency at all, and that itself feels wrong."
+        ],
+        "watched": [
+          "You feel watched, though every passenger is asleep.",
+          "The certainty that someone is behind you won't leave.",
+          "Your neck prickles; you are sure you are not alone in the way you were."
+        ]
+      }
+    }
+  },
+
+  "adaptive": {
+    "repeat_inspect": [
+      "You look at the {THING} again. You aren't sure why.",
+      "Your eyes go straight to the {THING}, the way they always seem to now.",
+      "The {THING} draws your attention once more."
+    ],
+    "long_look": [
+      "You spend longer looking than usual. You don't remember deciding to stop.",
+      "You realise you've been standing in the aisle. For how long?",
+      "The train sways on, and you don't know how long you've been staring."
+    ]
+  },
+
+  "framing": {
+    "intro": [
+      "COACH 8",
+      "",
+      "The conductor clipped your ticket and nodded up the train: coach 8, that way.",
+      "You've been walking forward through the carriages ever since.",
+      "",
+      "Each coach looks like the last. If one differs from what you remember, TURN BACK.",
+      "If nothing has changed, keep moving to the NEXT COACH.",
+      "",
+      "Reach coach 8 and you can finally sit down.",
+      "Lose your place, and you're back where the conductor left you."
+    ],
+    "win": [
+      "You slide open one more door — and the seat numbers read 8.",
+      "Coach 8. Your seat, empty and waiting, beside a black window.",
+      "You sink into it at last. The train rushes on through the night.",
+      "You found your seat."
+    ]
+  }
+}

data/arcs/hallway-eight.json

@@ -0,0 +1,315 @@
+{
+  "_comment": "The canonical corridor. Each property has a baseline value with a pool of equivalent sentences (wording drifts while meaning stays fixed), plus anomalous variants with their own pools. Remember MEANING, not wording.",
+
+  "meta": {
+    "id": "hallway-eight",
+    "title": "Hallway 8",
+    "tagline": "Locked in after hours. Follow the corridor to the fire exit.",
+    "skin": "hallway",
+    "go_on": "Walk on  ↑",
+    "turn_back": "Turn back  ↓",
+    "unit": "corridor",
+    "progress": "Hallway {level} / {goal}",
+    "labels": {
+      "lighting": "lights",
+      "sound": "sound",
+      "poster": "poster",
+      "figure": "man down the hall",
+      "sign": "exit sign",
+      "door": "maintenance door",
+      "camera": "camera",
+      "floor": "floor",
+      "sense": "feeling"
+    }
+  },
+
+  "title_variants": ["Hallway 8", "Hallway 8", "Hallway 8", "Hallway 8", "Corridor 8", "Hallway Eight", "HALLWAY 8", "Hallway  8"],
+
+  "sign_variants": ["EXIT →", "EXIT →", "EXIT →", "EXIT→", "Exit →", "EXIT ⇢", "EXIT → "],
+
+  "anchor_order": ["lighting", "sound", "poster", "figure", "sign", "door", "camera", "floor", "sense"],
+
+  "properties": {
+    "lighting": {
+      "baseline": "steady",
+      "values": {
+        "steady": [
+          "The fluorescent lights hum softly overhead.",
+          "The ceiling lights give off a steady, even glow.",
+          "Overhead, the fluorescents buzz at their usual pitch.",
+          "The lighting is flat and unremarkable, the way it always is."
+        ]
+      },
+      "anomalies": {
+        "flicker": [
+          "One of the fluorescent tubes stutters, then holds.",
+          "The lights flicker — once, twice — before settling.",
+          "There's a faint strobe to the ceiling lights that wasn't there before."
+        ],
+        "dim": [
+          "The corridor seems a shade darker than you remember.",
+          "The lights are dimmer here, as if half of them gave up.",
+          "A grey dimness has settled over everything."
+        ],
+        "warm": [
+          "The light has a warm, yellowish cast to it.",
+          "The fluorescents glow oddly amber, almost like sunset.",
+          "The usual cold white has turned faintly golden."
+        ]
+      }
+    },
+
+    "sound": {
+      "baseline": "vent",
+      "values": {
+        "vent": [
+          "Somewhere, ventilation exhales a low, constant breath.",
+          "The air handling hums in the walls, steady as ever.",
+          "You hear the familiar drone of distant ventilation."
+        ]
+      },
+      "anomalies": {
+        "drip": [
+          "A slow drip taps somewhere out of sight.",
+          "Water is dripping — you can't place where.",
+          "Tick. Tick. Something is dripping nearby."
+        ],
+        "silence": [
+          "The ventilation has stopped. The silence presses on your ears.",
+          "It is completely quiet. Too quiet.",
+          "You notice the hum is gone. The stillness feels wrong."
+        ],
+        "footsteps": [
+          "Footsteps echo somewhere behind you, then stop.",
+          "You hear footsteps that don't match your own.",
+          "For a moment there are two sets of footsteps."
+        ]
+      }
+    },
+
+    "poster": {
+      "baseline": "travel",
+      "values": {
+        "travel": [
+          "A faded travel poster clings to the wall — a beach, a blue sky.",
+          "The old poster of a sunny coastline is still taped to the wall.",
+          "On the wall, that washed-out advertisement for somewhere warm.",
+          "The travel poster hangs at its usual slight tilt."
+        ]
+      },
+      "anomalies": {
+        "gone": [
+          "The wall is bare. A pale rectangle marks where a poster used to be.",
+          "The travel poster is gone; only the tape remains.",
+          "Nothing hangs on the wall now."
+        ],
+        "mountains": [
+          "The poster shows snow-capped mountains, not a beach.",
+          "The coastline poster is now a photograph of grey mountains.",
+          "The advertisement pictures a cold summit under heavy cloud."
+        ],
+        "upside": [
+          "The travel poster hangs upside down.",
+          "The beach on the poster is inverted, sky at the bottom.",
+          "Someone has flipped the poster; it hangs the wrong way up."
+        ]
+      }
+    },
+
+    "figure": {
+      "baseline": "distant",
+      "values": {
+        "distant": [
+          "Far down the corridor, a man in a grey suit walks away from you.",
+          "A suited figure moves ahead in the distance, back turned.",
+          "The man in grey is up ahead, as always, walking on.",
+          "Down the hall, a man in a suit recedes toward the vanishing point."
+        ]
+      },
+      "anomalies": {
+        "closer": [
+          "The man in the grey suit is much closer than he should be.",
+          "The suited figure has stopped halfway, closer than before.",
+          "The man in grey is only a few paces ahead now, still turned away."
+        ],
+        "facing": [
+          "The man in the grey suit has stopped. He is facing you.",
+          "Down the hall, the suited figure stands still, looking your way.",
+          "The man in grey is not walking. He is watching you."
+        ],
+        "gone": [
+          "The corridor ahead is empty. No one is walking it.",
+          "There is no figure ahead this time.",
+          "The man in the grey suit is nowhere to be seen."
+        ],
+        "knows": [
+          "The man in grey has turned and raised a hand, as if he knows you.",
+          "The suited figure faces you and beckons, slow and deliberate.",
+          "The man mouths something down the corridor. It might be 'again.'"
+        ]
+      }
+    },
+
+    "sign": {
+      "baseline": "exit",
+      "values": {
+        "exit": [
+          "The illuminated {SIGN} sign glows at the far end.",
+          "Ahead, the {SIGN} sign hangs above the corridor.",
+          "The green {SIGN} sign points the way, as it should.",
+          "You can make out the {SIGN} sign in the distance."
+        ]
+      },
+      "anomalies": {
+        "reversed": [
+          "The exit sign points the wrong way — EXIT ←.",
+          "The arrow on the exit sign now points back the way you came: ←.",
+          "EXIT ←. The arrow has reversed."
+        ],
+        "dark": [
+          "The exit sign is dark. No light behind the letters.",
+          "The exit sign has gone out.",
+          "Where the exit sign should glow, there is only a dead panel."
+        ],
+        "number": [
+          "The sign reads EXIT 3. There was never a number on it.",
+          "A number has appeared on the sign: EXIT 3.",
+          "The exit sign now carries a numeral you don't remember: 3."
+        ]
+      }
+    },
+
+    "door": {
+      "baseline": "closed",
+      "values": {
+        "closed": [
+          "A grey maintenance door sits shut in the left wall.",
+          "The service door on your left is closed, as usual.",
+          "There's the maintenance door, shut tight."
+        ]
+      },
+      "anomalies": {
+        "ajar": [
+          "The maintenance door stands slightly ajar. Darkness inside.",
+          "The service door is open a crack, though you never saw it open.",
+          "The grey door is ajar; a thin black gap where it should be flush."
+        ],
+        "gone": [
+          "There is no maintenance door in the left wall. Just smooth wall.",
+          "The service door is missing entirely.",
+          "The left wall is unbroken — no door at all."
+        ]
+      }
+    },
+
+    "camera": {
+      "baseline": "away",
+      "values": {
+        "away": [
+          "A small CCTV camera in the corner points down the corridor.",
+          "The security camera watches the far end, angled away from you.",
+          "Up in the corner, the camera faces ahead, as always."
+        ]
+      },
+      "anomalies": {
+        "atyou": [
+          "The CCTV camera has turned. It points directly at you.",
+          "The security camera is angled down at you now.",
+          "The camera in the corner faces you, its lens level with your eyes."
+        ],
+        "red": [
+          "A red light blinks on the camera. It never used to blink.",
+          "The camera's recording light glows red for the first time.",
+          "The little LED on the camera pulses red."
+        ]
+      }
+    },
+
+    "floor": {
+      "baseline": "dry",
+      "values": {
+        "dry": [
+          "The grey floor tiles stretch away, dry and dull.",
+          "Underfoot, the usual scuffed grey tiles.",
+          "The tiled floor is dry, reflecting nothing."
+        ]
+      },
+      "anomalies": {
+        "wet": [
+          "The tiles ahead shine with a wet, dark sheen.",
+          "The floor is wet, though you saw no one clean it.",
+          "A slick of water spreads across the tiles."
+        ],
+        "cracked": [
+          "A crack runs across the floor tiles that wasn't there before.",
+          "One of the floor tiles is split down the middle.",
+          "The tiling is fractured in a jagged line ahead."
+        ]
+      }
+    },
+
+    "sense": {
+      "baseline": "steady",
+      "values": {
+        "steady": [
+          "The corridor feels exactly as long as it always has.",
+          "You carry the same low dread you've had since the lobby.",
+          "Everything feels ordinary, in the way this place is ever ordinary."
+        ]
+      },
+      "anomalies": {
+        "longer": [
+          "The corridor feels longer this time, though you can't say why.",
+          "The far end seems further off than it should be.",
+          "The walls feel as if they've stretched since the last stretch."
+        ],
+        "forget": [
+          "For a moment you can't remember how many doors you've passed.",
+          "You lose your count of the corridors, and it unsettles you.",
+          "You can't recall why you're down here at all."
+        ],
+        "calm": [
+          "You feel suddenly, wrongly calm — as if you'd already escaped.",
+          "A strange relief washes over you that has no business being here.",
+          "You feel no fear at all, and that itself feels wrong."
+        ]
+      }
+    }
+  },
+
+  "adaptive": {
+    "repeat_inspect": [
+      "You glance at the {THING} again. You aren't sure why.",
+      "Your eyes go straight to the {THING}, the way they always seem to now.",
+      "The {THING} draws your attention once more."
+    ],
+    "long_look": [
+      "You spend longer looking than usual. You don't remember deciding to stop.",
+      "You realise you've been standing still. For how long?",
+      "Time slips. You were staring, and you don't know for how long."
+    ]
+  },
+
+  "framing": {
+    "intro": [
+      "AFTER HOURS",
+      "",
+      "You stayed too late. The lobby doors are locked, the lights half-out.",
+      "A handwritten sign hangs over them:  FIRE EXIT — USE CORRIDOR.",
+      "",
+      "So you follow it. Each stretch of corridor looks like the last.",
+      "",
+      "If anything differs from what you remember, TURN BACK.",
+      "If nothing has changed, WALK ON.",
+      "",
+      "Reach the eighth fire door and you are out.",
+      "Lose track of what you've seen, and the corridor starts you over."
+    ],
+    "win": [
+      "The eighth fire door gives under your hands.",
+      "Cold air. A stairwell down to the street. The city, still there.",
+      "You were beginning to think the corridor had no end.",
+      "You are out."
+    ]
+  }
+}

data/arcs/stairway8.json

@@ -0,0 +1,387 @@
+{
+  "_comment": "Stairway arc. Same schema and mechanic as hallway-eight, different skin and story: the elevator is out, so you descend eight flights on foot. Each landing should be identical -- go back up if a landing has changed, keep descending if it hasn't.",
+
+  "meta": {
+    "id": "stairway8",
+    "title": "Stairway 8",
+    "tagline": "The elevator is out. Eight floors down, one landing at a time.",
+    "skin": "stairway",
+    "go_on": "Descend  ↓",
+    "turn_back": "Back up  ↑",
+    "unit": "landing",
+    "progress": "Floor {floor}   ·   {level}/{goal} down",
+    "labels": {
+      "lighting": "light",
+      "sound": "sound",
+      "number": "floor number",
+      "door": "fire door",
+      "notice": "elevator notice",
+      "railing": "handrail",
+      "extinguisher": "extinguisher",
+      "stairs": "stairs down",
+      "figure": "figure on the stairs",
+      "sense": "feeling"
+    }
+  },
+
+  "title_variants": ["Stairway 8", "Stairway 8", "Stairway 8", "Stairway 8", "Stairwell 8", "Stairway Eight", "STAIRWAY 8", "Stairway  8"],
+
+  "sign_variants": ["OUT OF ORDER"],
+
+  "anchor_order": ["lighting", "sound", "number", "door", "notice", "figure", "railing", "extinguisher", "stairs", "sense"],
+
+  "properties": {
+    "lighting": {
+      "baseline": "steady",
+      "values": {
+        "steady": [
+          "A caged bulb throws steady light across the landing.",
+          "The stairwell light burns evenly overhead, as always.",
+          "The fluorescent strip on the landing glows its usual flat white.",
+          "Light falls here the same as every landing above."
+        ]
+      },
+      "anomalies": {
+        "flicker": [
+          "The caged bulb stutters, then steadies.",
+          "The stairwell light flickers in a way it hasn't before.",
+          "Overhead, the light trips once and comes back."
+        ],
+        "dim": [
+          "This landing is dimmer than the ones above it.",
+          "The light here has half given up; the corners stay dark.",
+          "A grey murk hangs over the landing."
+        ],
+        "red": [
+          "The landing is lit red — an emergency bulb you don't remember.",
+          "Everything wears a low red emergency glow.",
+          "The white light is gone; only a red bulb remains."
+        ]
+      }
+    },
+
+    "sound": {
+      "baseline": "quiet",
+      "values": {
+        "quiet": [
+          "Your footsteps echo up the shaft and fade.",
+          "The stairwell is quiet but for your own steps.",
+          "Far below, the building hums to itself."
+        ]
+      },
+      "anomalies": {
+        "drip": [
+          "Water drips somewhere down the shaft. Tick. Tick.",
+          "A slow drip echoes up from below.",
+          "Something is dripping, floors down."
+        ],
+        "slam": [
+          "A door slams far below, then silence.",
+          "Somewhere beneath you a door bangs shut.",
+          "A heavy door closes several floors down."
+        ],
+        "footsteps": [
+          "Footsteps climb toward you, then stop.",
+          "You hear steps that aren't yours on the flight below.",
+          "For a moment, someone else is on the stairs."
+        ],
+        "silence": [
+          "The building's hum has stopped. Dead quiet.",
+          "It is completely silent. Too silent.",
+          "Even the echo of your steps seems to vanish."
+        ]
+      }
+    },
+
+    "number": {
+      "baseline": "eight",
+      "values": {
+        "eight": [
+          "A large painted 8 marks the landing wall.",
+          "The floor number — 8 — is stencilled on the concrete.",
+          "'8' is painted on the wall, drips frozen beneath the strokes.",
+          "The wall reads 8, the same as the landing before."
+        ]
+      },
+      "anomalies": {
+        "wrong": [
+          "The wall reads 7. It has always read 8.",
+          "The painted number is a 6 now, not an 8.",
+          "The floor number has changed: it says 9."
+        ],
+        "basement": [
+          "The wall reads B. Basement. You are nowhere near it.",
+          "The number is gone; a painted 'B' stands in its place.",
+          "The stencil reads B, though you've barely started down."
+        ],
+        "faded": [
+          "The painted number has faded to a grey ghost.",
+          "Someone has scrubbed the number half away.",
+          "The 8 on the wall is almost gone."
+        ],
+        "reversed": [
+          "The 8 is painted backwards, as if seen in a mirror.",
+          "The floor number is mirror-reversed.",
+          "The stencilled number reads the wrong way round."
+        ]
+      }
+    },
+
+    "door": {
+      "baseline": "closed",
+      "values": {
+        "closed": [
+          "The fire door to the floor is shut, its wired glass dark.",
+          "The heavy grey fire door stands closed on the landing.",
+          "The door onto the floor is closed, the way it should be."
+        ]
+      },
+      "anomalies": {
+        "ajar": [
+          "The fire door hangs slightly ajar. A black gap, no light.",
+          "The heavy door is open a crack; it never is.",
+          "The fire door isn't quite shut this time."
+        ],
+        "propped": [
+          "The fire door is propped wide open onto a dark floor.",
+          "Someone has wedged the fire door open.",
+          "The door stands fully open, held by nothing you can see."
+        ],
+        "window": [
+          "The wired-glass window in the door has gone black, covered.",
+          "The little window in the fire door is blocked from the other side.",
+          "Something presses against the glass in the door."
+        ],
+        "handle": [
+          "The fire door has no handle now.",
+          "Where the door handle was, only bare holes.",
+          "The handle is missing from the fire door."
+        ]
+      }
+    },
+
+    "notice": {
+      "baseline": "out",
+      "values": {
+        "out": [
+          "A taped notice on the elevator reads OUT OF ORDER — USE STAIRS.",
+          "The repair notice is still there: elevator out of order.",
+          "OUT OF ORDER, says the sign taped across the elevator doors."
+        ]
+      },
+      "anomalies": {
+        "gone": [
+          "The elevator notice is gone. Just bare metal doors.",
+          "No sign on the elevator this time.",
+          "The repair notice has been taken down."
+        ],
+        "service": [
+          "The notice now reads ELEVATOR IN SERVICE.",
+          "The sign says the elevator is working again.",
+          "OUT OF ORDER has become BACK IN SERVICE."
+        ],
+        "wording": [
+          "The notice reads DO NOT USE STAIRS.",
+          "The sign warns STAIRS CLOSED — it never did before.",
+          "The notice now tells you not to take the stairs at all."
+        ],
+        "arrow": [
+          "The arrow on the notice points up, not down.",
+          "The sign's arrow has flipped to point back up the stairs.",
+          "The notice directs you upward now."
+        ]
+      }
+    },
+
+    "railing": {
+      "baseline": "cold",
+      "values": {
+        "cold": [
+          "The steel handrail runs cold and unbroken under your hand.",
+          "The painted railing is right where it always is.",
+          "Your hand finds the handrail, continuous along the flight."
+        ]
+      },
+      "anomalies": {
+        "gap": [
+          "A section of the handrail is missing over the drop.",
+          "The railing has a gap where a length has been removed.",
+          "Part of the handrail simply isn't there."
+        ],
+        "wet": [
+          "The handrail is wet, though nothing drips on it.",
+          "Your hand comes away damp from the rail.",
+          "The railing is slick under your palm."
+        ],
+        "paint": [
+          "The railing is a different colour than the flights above.",
+          "Someone has repainted this stretch of handrail.",
+          "The rail's paint is green here, not grey."
+        ]
+      }
+    },
+
+    "extinguisher": {
+      "baseline": "present",
+      "values": {
+        "present": [
+          "A fire extinguisher hangs on its bracket beside the door.",
+          "The red extinguisher is in its place on the wall.",
+          "The landing's fire extinguisher sits on its hook."
+        ]
+      },
+      "anomalies": {
+        "gone": [
+          "The extinguisher bracket is empty.",
+          "The fire extinguisher is gone; only the bracket remains.",
+          "No extinguisher on the wall this time."
+        ],
+        "floor": [
+          "The extinguisher lies on the floor, on its side.",
+          "The fire extinguisher has been set down on the landing.",
+          "The extinguisher stands loose against the wall, off its hook."
+        ],
+        "gauge": [
+          "The extinguisher's pressure gauge reads in the red.",
+          "The needle on the extinguisher sits deep in the red.",
+          "The extinguisher's gauge has dropped to empty."
+        ]
+      }
+    },
+
+    "stairs": {
+      "baseline": "clear",
+      "values": {
+        "clear": [
+          "The flight down is clear, its steps even and dry.",
+          "The stairs descend as always, nothing on them.",
+          "The next flight drops away, clean and empty."
+        ]
+      },
+      "anomalies": {
+        "wet": [
+          "The steps below shine wet in the light.",
+          "The next flight is slick with water.",
+          "The stairs down are wet, though you saw no spill."
+        ],
+        "missing": [
+          "One of the steps in the flight below is missing.",
+          "There's a gap in the stairs where a step should be.",
+          "A tread is gone from the flight down."
+        ],
+        "up": [
+          "The arrow stencilled on the steps points UP, not down.",
+          "The direction painted on the stairs has reversed.",
+          "The steps seem to lead up now, though you are going down."
+        ],
+        "debris": [
+          "Something has been left on the steps below — a bag, maybe.",
+          "There's debris scattered across the next flight.",
+          "A dark shape sits partway down the flight."
+        ]
+      }
+    },
+
+    "figure": {
+      "baseline": "below",
+      "values": {
+        "below": [
+          "Far below, someone else winds down the stairwell, always a flight or two ahead.",
+          "A figure descends the shaft ahead of you, keeping the same distance.",
+          "Someone is on the stairs below, going down at your pace, never closer."
+        ]
+      },
+      "anomalies": {
+        "facing": [
+          "The figure below has stopped. It is looking up at you.",
+          "Down the shaft, the figure stands still, face turned up toward you.",
+          "The one on the stairs isn't descending now. It's watching you."
+        ],
+        "closer": [
+          "The figure on the stairs is much closer than before, just a flight down.",
+          "The descending figure has closed the distance; it's nearly on your landing.",
+          "Whoever is below is only a few steps down now."
+        ],
+        "gone": [
+          "The stairwell below is empty. Whoever was descending is gone.",
+          "There is no figure on the stairs this time.",
+          "The one ahead of you has vanished from the shaft."
+        ],
+        "ascending": [
+          "The figure is climbing now — coming up the stairs toward you.",
+          "Footsteps rise: the figure below is ascending, not descending.",
+          "The one on the stairs has turned around and is coming up."
+        ],
+        "knows": [
+          "The figure below looks up and lifts a hand, as if it has been waiting for you.",
+          "The figure mouths something up the shaft. It might be 'again.'",
+          "It beckons you down, slow and certain, as though it knows you."
+        ]
+      }
+    },
+
+    "sense": {
+      "baseline": "steady",
+      "values": {
+        "steady": [
+          "The shaft feels exactly as deep as it always has.",
+          "You carry the same wariness down flight after flight.",
+          "Everything feels ordinary, as far as any of this is ordinary."
+        ]
+      },
+      "anomalies": {
+        "deeper": [
+          "The shaft feels deeper than it should, the ground floor further off.",
+          "You feel you've descended far more than eight floors.",
+          "The bottom seems to have moved further away."
+        ],
+        "forget": [
+          "For a moment you can't remember how many landings you've passed.",
+          "You lose count of the flights above you, and it frightens you.",
+          "You can't recall which floor you started on."
+        ],
+        "up": [
+          "For an instant you're certain you've been climbing, not descending.",
+          "A wrong feeling grips you: that down has been up all along.",
+          "You feel, briefly and coldly, that you are going the wrong way."
+        ]
+      }
+    }
+  },
+
+  "adaptive": {
+    "repeat_inspect": [
+      "You check the {THING} again. You aren't sure why.",
+      "Your eyes go straight to the {THING}, the way they always seem to now.",
+      "The {THING} draws your attention once more."
+    ],
+    "long_look": [
+      "You spend longer looking than usual. You don't remember deciding to stop.",
+      "You realise you've been standing on the landing. For how long?",
+      "Time slips. You were staring down the shaft, and you don't know for how long."
+    ]
+  },
+
+  "framing": {
+    "intro": [
+      "OUT OF ORDER",
+      "",
+      "You press the call button. Nothing. A notice is taped across the doors:",
+      "ELEVATOR OUT OF ORDER — USE STAIRS.",
+      "",
+      "Eight floors up, and only the stairwell down. Each landing looks the same.",
+      "",
+      "If a landing differs from the one in your memory, GO BACK UP.",
+      "If nothing has changed, keep DESCENDING.",
+      "",
+      "Reach the ground floor and step out.",
+      "Lose track of the landings, and you're back at the top."
+    ],
+    "win": [
+      "The last flight opens onto the lobby.",
+      "Daylight through the doors. The street. The elevator behind you, still dead.",
+      "Eight floors down, and your memory held every landing.",
+      "Ground floor."
+    ]
+  }
+}

docs/ARCS.md

@@ -0,0 +1,138 @@
+# Arc roadmap
+
+This is the living plan for the game's arcs (skins/backstories). It records the
+design rules every arc must follow, what's already built, and the queue of
+future arcs so we can pick up any of them later without re-deriving the idea.
+
+Each arc is one self-contained `data/arcs/<id>.json` file plus a
+`body[data-skin="<name>"]` block in `static/style.css`. See the README section
+*Adding an arc* for the file schema. New arcs appear on the opening screen
+automatically.
+
+---
+
+## Design rules (apply to every arc)
+
+The mechanic is fixed: move through a place that should be identical each loop;
+**turn back** if something changed, **go on** if nothing did; eight correct
+calls in a row wins, one wrong call resets. What differs per arc is the story,
+vocabulary, skin — and the *flavour* of the anomalies. Every arc must include:
+
+1. **A strong motivation ("the hook").** A concrete in-world reason you're stuck
+   doing this, revealed in the intro — the equivalent of Stairway 8's
+   out-of-order elevator. Never "you are being tested" with no diegetic cause.
+2. **An NPC.** A recurring character that is normally passive but can become the
+   anomaly — turning, watching, approaching, vanishing, duplicating. Every arc
+   needs its own recurring uncanny figure.
+3. **A loop-aware NPC twist.** At least one NPC anomaly that breaks past physical
+   change into the uncanny: the character *acknowledges you* or the loop itself
+   (waves, beckons, mouths/says "again"). Property key convention: `knows` for
+   silent figures, `speaks` for ones that can talk.
+4. **A psychological layer (`sense`).** A non-physical property whose baseline is
+   your ordinary state and whose anomalies are perceptual/emotional wrongness —
+   losing count, a calm that shouldn't be there, a conviction you're going the
+   wrong way. Anomalies beyond objects, per the "twists" requirement.
+5. **Meta drift (free).** The engine already drifts the heading, wording, pacing,
+   weight, spacing and background every loop — no per-arc work needed, but keep
+   `title_variants` themed.
+
+Keep anomalies *plausible*, never loud. One property mutates per anomalous loop,
+and it is always among the details shown that loop (the engine guarantees this).
+
+---
+
+## Built
+
+| Arc | Hook | Loop unit | NPC (+ twist) | `sense` anomalies | Skin |
+|-----|------|-----------|---------------|-------------------|------|
+| **Hallway 8** (`hallway-eight`) | Locked in after hours; a sign points to the fire exit | corridor | man in grey suit (`knows`: turns/beckons/"again") | longer, forget, calm | cold teal |
+| **Stairway 8** (`stairway8`) | Elevator out of order; descend on foot | landing | figure on the stairs below (`knows`: looks up, waves, ascends) | deeper, forget, wrong-way | emergency green |
+| **Coach 8** (`coach8`) | Conductor sent you to coach 8; the train never reaches it | carriage | sleeping passenger (`speaks`: murmurs "again", "you were just here") | forget, calm, watched | cabin amber |
+
+---
+
+## Planned (not yet built)
+
+Each entry is enough to implement directly. Ordered by how strong/fresh the loop
+feels; pick any.
+
+### Platform 8 (`platform8`) — the underpass
+- **Hook:** last train of the night; the turnstiles are shut and a sign routes
+  you through the pedestrian underpass — FOLLOW SIGNS TO PLATFORM 8.
+- **Loop unit:** identical tiled underpass segments. **Go on** = walk on /
+  **Turn back** = double back.
+- **NPC:** a busker sitting against the wall with an open case. Twist (`knows`):
+  stops playing to watch you; case is suddenly empty/overfull; plays the same
+  bar as you pass "again."
+- **Physical anomalies:** tiled advert, the drip-puddle, map's "YOU ARE HERE"
+  dot, poster date, platform number on the sign, tile colour, a pigeon.
+- **`sense`:** the tunnel feels longer; you forget which platform you wanted; a
+  certainty you already caught the train.
+- **Skin:** cold blue-white station tile (`--hue: 205`).
+
+### Aisle 8 (`aisle8`) — locked in the supermarket
+- **Hook:** you looked up and the shop had closed around you; the tannoy loops
+  "please proceed to checkout 8 to exit."
+- **Loop unit:** identical grocery aisles. **Go on** = next aisle / **Turn
+  back** = previous aisle.
+- **NPC:** a night-shift stocker with a trolley, back to you. Twist (`knows`):
+  turns and stares; trolley abandoned mid-aisle; softly says "again" over the
+  muzak.
+- **Physical anomalies:** a shelf gap, a product facing the wrong way, a price
+  label, the end-cap promo, the muzak track, the abandoned trolley, floor sheen.
+- **`sense`:** the aisle feels longer; you forget your list; a calm certainty
+  you've already paid.
+- **Skin:** flat retail fluorescent, a touch too bright (`--hue: 60`, high L).
+
+### Ward 8 (`ward8`) — the hospital at night
+- **Hook:** visiting hours are over; the night sign says the way out is via Ward
+  8. *(Handle tone with care — dread, not gore.)*
+- **Loop unit:** identical hospital corridors. **Go on** / **Turn back**.
+- **NPC:** a patient in a gown standing in a doorway, or a nurse at the far
+  station. Twist (`knows`): the figure has moved to the next doorway; is facing
+  you; mouths "again."
+- **Physical anomalies:** a gurney's position, the room-number plate, a
+  flickering "NIL BY MOUTH" sign, the hand-gel dispenser, a chart on a door,
+  distant monitor beeps, a wheelchair.
+- **`sense`:** the corridor feels longer; you forget why you came; a wrong calm.
+- **Skin:** pale clinical green-grey (`--hue: 160`, low sat).
+
+### Level 8 (`level8`) — the underground car park
+- **Hook:** your ticket says Level 8; the lift to the street is dead, so follow
+  the ramp up. (Ascending mirror of Stairway 8.)
+- **Loop unit:** identical parking rows. **Go on** = up a ramp / **Turn back** =
+  back down.
+- **NPC:** a figure between the parked cars, or someone sitting in a driver's
+  seat. Twist (`knows`): the seated figure's headlights flick on as you pass; it
+  has moved cars; it waves.
+- **Physical anomalies:** a parked car's colour, the level number on the pillar,
+  a flickering strip light, the arrow painted on the floor, an oil stain, a
+  distant engine, a car alarm.
+- **`sense`:** the level feels deeper; you forget where you parked; certainty
+  you're descending, not climbing.
+- **Skin:** concrete grey with sodium-orange pools (`--hue: 30`, low L).
+
+### Gate 8 (`gate8`) — the airport after the last flight
+- **Hook:** you dozed off; the terminal's near-empty and the board shows one
+  route left — EXIT VIA GATE 8.
+- **Loop unit:** identical concourse stretches / travelators. **Go on** /
+  **Turn back**.
+- **NPC:** a lone cleaner with a floor-buffer, or a single seated passenger.
+  Twist (`knows`): stops buffing to watch; the seated passenger is gone/closer;
+  a gate announcement says your name.
+- **Physical anomalies:** the gate number, a departures-board row, the duty-free
+  window display, an abandoned bag (unsettling), the announcement chime, a clock,
+  a potted plant.
+- **`sense`:** the concourse feels longer; you forget your destination; a calm
+  that you've already boarded.
+- **Skin:** glassy blue night-terminal (`--hue: 215`).
+
+---
+
+## Backlog ideas (thin — flesh out before building)
+
+- **Museum after close** — galleries loop; NPC is a security guard or a statue
+  that isn't always in the same pose.
+- **Motel corridor** — reach room 8 / the exit; NPC is someone at an ice machine.
+- **Ferry decks** — climb decks to the exit; NPC a lone smoker at the rail;
+  motion + sea outside the windows.

hallway.py

@@ -0,0 +1,141 @@
+"""The corridor: building a loop and describing it.
+
+A "room" is not a paragraph. It is a set of properties, each currently at its
+baseline value or (at most one of them) at an anomalous value. The describer
+turns that into a handful of sentences drawn from rotating pools, so the same
+place reads differently every time while still being the same place.
+
+Content is organised into *arcs* (skins/backstories) under data/arcs/. Each arc
+file shares the same schema; only the theme, story, and vocabulary change.
+"""
+
+from __future__ import annotations
+
+import glob
+import json
+import os
+import random
+from typing import Dict, List, Optional
+
+import anomalies
+from memory import PlayerMemory
+
+ARCS_DIR = os.path.join(os.path.dirname(__file__), "data", "arcs")
+
+DEFAULT_ARC = "hallway-eight"
+
+# How many hallways/landings you must clear. Reaching this level wins.
+GOAL = 8
+
+# How many details are described each loop. Enough to overload memory a little,
+# few enough to keep it readable.
+MIN_DETAILS = 4
+MAX_DETAILS = 6
+
+
+def _arc_path(arc_id: str) -> str:
+    return os.path.join(ARCS_DIR, f"{arc_id}.json")
+
+
+def list_arcs() -> List[dict]:
+    """Return the selectable arcs, described by their meta block.
+
+    The default arc is listed first; the rest follow alphabetically.
+    """
+    arcs = []
+    for path in sorted(glob.glob(os.path.join(ARCS_DIR, "*.json"))):
+        with open(path, "r", encoding="utf-8") as f:
+            meta = json.load(f).get("meta", {})
+        if meta.get("id"):
+            arcs.append({
+                "id": meta["id"],
+                "title": meta.get("title", meta["id"]),
+                "tagline": meta.get("tagline", ""),
+                "skin": meta.get("skin", "hallway"),
+            })
+    arcs.sort(key=lambda a: (a["id"] != DEFAULT_ARC, a["id"]))
+    return arcs
+
+
+class Hallway:
+    def __init__(self, arc_id: str = DEFAULT_ARC):
+        path = _arc_path(arc_id)
+        if not os.path.exists(path):
+            path = _arc_path(DEFAULT_ARC)
+        with open(path, "r", encoding="utf-8") as f:
+            self.data = json.load(f)
+        self.properties: Dict[str, dict] = self.data["properties"]
+        self.meta: dict = self.data.get("meta", {})
+        self.labels: Dict[str, str] = self.meta.get("labels", {})
+
+    def build(self, mem: PlayerMemory, rng: random.Random) -> dict:
+        """Generate the next place for the player's current level.
+
+        The probability of an anomaly stays near a coin-flip so neither
+        "always continue" nor "always turn back" is a winning strategy.
+        """
+        has_anomaly = rng.random() < 0.5
+        anomaly_prop: Optional[str] = None
+        anomaly_val: Optional[str] = None
+        if has_anomaly:
+            anomaly_prop, anomaly_val = anomalies.pick_anomaly(self.properties, rng)
+
+        # Decide which properties get described this loop.
+        order = list(self.data["anchor_order"])
+        rng.shuffle(order)
+        n = rng.randint(MIN_DETAILS, MAX_DETAILS)
+        shown = order[:n]
+        # If there is an anomaly, it must be visible this loop -- otherwise
+        # the player is asked to notice something they were never shown.
+        if anomaly_prop and anomaly_prop not in shown:
+            shown[rng.randrange(len(shown))] = anomaly_prop
+        # Re-sort shown into the canonical order so the "camera" of the prose
+        # feels consistent even as content rotates.
+        shown = [p for p in self.data["anchor_order"] if p in shown]
+
+        sign_text = anomalies.drift_sign(self.data["sign_variants"], rng)
+
+        sentences: List[str] = []
+        for prop in shown:
+            spec = self.properties[prop]
+            if prop == anomaly_prop:
+                pool = spec["anomalies"][anomaly_val]
+            else:
+                baseline = spec["baseline"]
+                pool = spec["values"][baseline]
+            line = anomalies.render_sentence(rng.choice(pool), sign_text)
+            sentences.append(line)
+
+        # Adaptive touch: if the player keeps inspecting one thing, and it is
+        # on show this loop, let the place notice.
+        fav = mem.favorite
+        adaptive_line = None
+        if fav and fav in shown and rng.random() < 0.5:
+            tmpl = rng.choice(self.data["adaptive"]["repeat_inspect"])
+            adaptive_line = tmpl.replace("{THING}", self.labels.get(fav, fav))
+
+        heading = anomalies.drift_heading(
+            self.data["title_variants"], mem.loops, rng
+        )
+
+        return {
+            "heading": heading,
+            "sentences": sentences,
+            "adaptive": adaptive_line,
+            "sign_text": sign_text,
+            "shown": shown,
+            # server-authoritative truth, never sent to the client:
+            "_has_anomaly": has_anomaly,
+            "_anomaly_prop": anomaly_prop,
+            "_anomaly_val": anomaly_val,
+        }
+
+    def public(self, room: dict) -> dict:
+        """Strip the answer before sending a room to the browser."""
+        return {k: v for k, v in room.items() if not k.startswith("_")}
+
+    def intro(self) -> List[str]:
+        return self.data["framing"]["intro"]
+
+    def win(self) -> List[str]:
+        return self.data["framing"]["win"]

memory.py

@@ -0,0 +1,62 @@
+"""Tracks how the player behaves across loops.
+
+The point of this module is not scoring. It is to give the game a small
+model of the player's habits so the narration can quietly react to them:
+the corridor that "remembers you."
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field, asdict
+from typing import Dict, Optional
+
+
+@dataclass
+class PlayerMemory:
+    # progress
+    level: int = 0            # which hallway you are standing in (0 = the start)
+    best_level: int = 0       # furthest you have ever reached
+    loops: int = 0            # total corridors walked this run
+
+    # behaviour
+    turn_backs: int = 0
+    continues: int = 0
+    false_reports: int = 0    # turned back when nothing was wrong
+    missed: int = 0           # walked on past a real change
+    inspects: Dict[str, int] = field(default_factory=dict)
+
+    # confidence
+    confidence_sum: float = 0.0
+    confidence_n: int = 0
+
+    def record_inspect(self, thing: str) -> None:
+        self.inspects[thing] = self.inspects.get(thing, 0) + 1
+
+    def record_confidence(self, value: Optional[int]) -> None:
+        if value:
+            self.confidence_sum += value
+            self.confidence_n += 1
+
+    @property
+    def confidence(self) -> float:
+        if not self.confidence_n:
+            return 0.0
+        return round(self.confidence_sum / self.confidence_n, 2)
+
+    @property
+    def favorite(self) -> Optional[str]:
+        """The property the player fixates on, once a habit has formed."""
+        if not self.inspects:
+            return None
+        thing, count = max(self.inspects.items(), key=lambda kv: kv[1])
+        return thing if count >= 3 else None
+
+    def to_dict(self) -> dict:
+        return asdict(self)
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "PlayerMemory":
+        if not data:
+            return cls()
+        known = {f: data[f] for f in cls.__dataclass_fields__ if f in data}
+        return cls(**known)

requirements.txt

@@ -0,0 +1,2 @@
+Flask>=3.0
+gunicorn>=21.0

scripts/deploy_hf.py

@@ -0,0 +1,63 @@
+#!/usr/bin/env python3
+"""Deploy this repo to a Hugging Face Docker Space.
+
+Run from a machine with normal internet access (not the sandboxed web session,
+whose network policy blocks huggingface.co):
+
+    pip install "huggingface_hub>=0.24"
+    export HF_TOKEN=hf_...          # a *write* token from hf.co/settings/tokens
+    python scripts/deploy_hf.py     # defaults to alvations/hallway8
+
+Optionally pass a different target: python scripts/deploy_hf.py owner/space-name
+"""
+
+import os
+import secrets
+import sys
+
+from huggingface_hub import HfApi, get_token
+
+REPO_ID = sys.argv[1] if len(sys.argv) > 1 else "alvations/hallway8"
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+
+def main() -> None:
+    # Prefer an explicit HF_TOKEN, but fall back to a stored `hf auth login`
+    # credential so this works without exporting anything.
+    token = os.environ.get("HF_TOKEN") or get_token()
+    if not token:
+        sys.exit(
+            "No token found. Run `hf auth login` or set HF_TOKEN to a write token."
+        )
+
+    api = HfApi(token=token)
+    who = api.whoami()
+    print(f"Authenticated as {who['name']}")
+
+    url = api.create_repo(
+        repo_id=REPO_ID, repo_type="space", space_sdk="docker", exist_ok=True
+    )
+    print(f"Space ready: {url}")
+
+    # Stable session key so in-progress runs survive Space restarts.
+    try:
+        api.add_space_secret(REPO_ID, "SECRET_KEY", secrets.token_hex(32))
+        print("SECRET_KEY secret set")
+    except Exception as exc:  # non-fatal
+        print(f"Could not set SECRET_KEY (set it manually if you want): {exc}")
+
+    api.upload_folder(
+        folder_path=ROOT,
+        repo_id=REPO_ID,
+        repo_type="space",
+        commit_message="Deploy Hallway 8 (multi-arc memory game)",
+        ignore_patterns=[
+            ".git*", "**/__pycache__/**", "*.pyc", ".venv/**", "venv/**", ".env",
+        ],
+    )
+    print(f"\nDone → https://huggingface.co/spaces/{REPO_ID}")
+    print("The Space will build the Docker image and go live in a couple of minutes.")
+
+
+if __name__ == "__main__":
+    main()

static/game.js

@@ -0,0 +1,282 @@
+/* Eight -- client.
+ *
+ * The server owns the truth (whether a place changed) and ships several arcs
+ * (skins/backstories). This file lets the player pick an arc, applies its skin,
+ * then renders, paces, and quietly drifts the presentation so no two loops can
+ * be compared pixel-for-pixel. The unease is in the timing and typography as
+ * much as in the words.
+ */
+
+const $ = (sel) => document.querySelector(sel);
+
+const el = {
+  select: $("#select"),
+  arcs: $("#arcs"),
+  intro: $("#intro"),
+  introTitle: $("#intro-title"),
+  introText: $("#intro-text"),
+  begin: $("#begin"),
+  introBack: $("#intro-back"),
+  corridor: $("#corridor"),
+  progress: $("#progress"),
+  best: $("#best"),
+  heading: $("#heading"),
+  prose: $("#prose"),
+  aside: $("#aside"),
+  controls: $("#controls"),
+  confidence: $("#confidence"),
+  win: $("#win"),
+  winText: $("#win-text"),
+  again: $("#again"),
+  change: $("#change"),
+  body: document.body,
+};
+
+let current = null;       // latest room payload
+let meta = null;          // current arc's presentation meta
+let selectedArc = null;   // arc id in play
+let pendingChoice = null; // choice awaiting a confidence rating
+let drift = 0;            // slowly accumulating presentation drift
+
+// --- helpers ---------------------------------------------------------------
+
+async function get(url) {
+  const res = await fetch(url);
+  return res.json();
+}
+
+async function post(url, body) {
+  const res = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body || {}),
+  });
+  return res.json();
+}
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+// A tiny jitter so pacing feels alive but not like noise.
+const jitter = (base, spread) => base + Math.floor(Math.random() * spread);
+
+function show(section) {
+  [el.select, el.intro, el.corridor, el.win].forEach((s) =>
+    s.classList.add("hidden")
+  );
+  section.classList.remove("hidden");
+}
+
+// Nudge the presentation a fraction every loop. Individually invisible;
+// cumulatively, "something feels off."
+function applyDrift() {
+  drift += 1;
+  el.body.style.setProperty("--bg-shift", Math.min(drift * 0.25, 6).toFixed(2));
+  const weight = 340 + Math.round(Math.sin(drift / 3) * 30);
+  document.documentElement.style.setProperty("--weight", String(weight));
+  const track = (0.01 + Math.sin(drift / 5) * 0.012).toFixed(4);
+  document.documentElement.style.setProperty("--tracking", `${track}em`);
+}
+
+// Apply an arc's skin, title, and button labels.
+function applyMeta(m) {
+  meta = m;
+  el.body.dataset.skin = m.skin || "hallway";
+  document.title = m.title || "8";
+  el.introTitle.textContent = m.title || "8";
+  el.controls.querySelector('[data-choice="continue"]').textContent =
+    m.go_on || "Go on";
+  el.controls.querySelector('[data-choice="back"]').textContent =
+    m.turn_back || "Turn back";
+}
+
+// --- rendering -------------------------------------------------------------
+
+function setHud(p) {
+  const floor = p.goal - p.level;
+  const remaining = p.goal - p.level;
+  const tmpl = (meta && meta.progress) || "{level} / {goal}";
+  const label = tmpl
+    .replace("{level}", p.level)
+    .replace("{goal}", p.goal)
+    .replace("{floor}", floor)
+    .replace("{remaining}", remaining);
+  const dots = Array.from({ length: p.goal }, (_, i) =>
+    i < p.level ? "•" : "·"
+  ).join(" ");
+  el.progress.textContent = `${label}    ${dots}`;
+  el.best.textContent = p.best ? `furthest ${p.best}` : "";
+}
+
+async function renderRoom(p) {
+  current = p;
+  if (p.meta) applyMeta(p.meta);
+  setHud(p);
+  applyDrift();
+
+  el.heading.textContent = p.room.heading;
+  el.prose.innerHTML = "";
+  el.aside.textContent = "";
+  el.aside.classList.remove("show");
+  el.controls.classList.add("hidden");
+  el.confidence.classList.add("hidden");
+  pendingChoice = null;
+
+  const lines = p.room.sentences;
+  const shown = p.room.shown || [];
+
+  lines.forEach((text, i) => {
+    const div = document.createElement("div");
+    div.className = "line";
+    div.textContent = text;
+    if (shown[i]) {
+      div.dataset.prop = shown[i];
+      attachInspect(div);
+    }
+    el.prose.appendChild(div);
+  });
+
+  // Reveal one line at a time with drifting pauses. One line, occasionally,
+  // hangs noticeably longer -- a pause the player reads as significance.
+  const nodes = [...el.prose.children];
+  for (let i = 0; i < nodes.length; i++) {
+    const long = Math.random() < 0.18;
+    await sleep(long ? jitter(1100, 500) : jitter(380, 340));
+    nodes[i].classList.add("show");
+  }
+
+  if (p.room.adaptive) {
+    await sleep(600);
+    el.aside.textContent = p.room.adaptive;
+    el.aside.classList.add("show");
+  }
+
+  await sleep(400);
+  el.controls.classList.remove("hidden");
+}
+
+// Lingering on a detail may earn an unsettling aside from the server.
+function attachInspect(node) {
+  let timer = null;
+  node.addEventListener("mouseenter", () => {
+    timer = setTimeout(async () => {
+      const { line } = await post("/api/inspect", { prop: node.dataset.prop });
+      if (line && !el.aside.textContent) {
+        el.aside.textContent = line;
+        el.aside.classList.add("show");
+      }
+    }, 1300);
+  });
+  node.addEventListener("mouseleave", () => clearTimeout(timer));
+}
+
+function flash(correct) {
+  const cls = correct ? "flash-good" : "flash-bad";
+  el.corridor.classList.add(cls);
+  setTimeout(() => el.corridor.classList.remove(cls), 1400);
+}
+
+// --- flow ------------------------------------------------------------------
+
+function renderArcCards(arcs) {
+  el.arcs.innerHTML = "";
+  arcs.forEach((a) => {
+    const card = document.createElement("button");
+    card.className = "arc-card";
+    card.dataset.arc = a.id;
+    card.dataset.skin = a.skin;
+    card.innerHTML =
+      `<div class="arc-title">${a.title}</div>` +
+      `<div class="arc-tag">${a.tagline}</div>`;
+    card.addEventListener("click", () => chooseArc(a));
+    el.arcs.appendChild(card);
+  });
+}
+
+function renderIntro(lines) {
+  el.introText.innerHTML = "";
+  lines.forEach((ln, i) => {
+    const div = document.createElement("div");
+    div.textContent = ln;
+    if (i === 0) div.className = "lead";
+    el.introText.appendChild(div);
+  });
+}
+
+async function chooseArc(a) {
+  selectedArc = a.id;
+  applyMeta(a);              // skin the intro screen immediately
+  const p = await post("/api/new", { arc: a.id });
+  applyMeta(p.meta);
+  renderIntro(p.intro);
+  current = p;
+  drift = 0;
+  show(el.intro);
+}
+
+function enterCorridor() {
+  show(el.corridor);
+  renderRoom(current);
+}
+
+function showWin(p) {
+  el.winText.innerHTML = "";
+  (p.win_text || []).forEach((ln, i) => {
+    const div = document.createElement("div");
+    div.textContent = ln;
+    if (i === p.win_text.length - 1) div.className = "lead";
+    el.winText.appendChild(div);
+  });
+  show(el.win);
+}
+
+async function loadSelect() {
+  const { arcs } = await get("/api/arcs");
+  renderArcCards(arcs);
+  el.body.dataset.skin = "hallway";
+  show(el.select);
+}
+
+// choice -> ask for confidence
+el.controls.addEventListener("click", (e) => {
+  const btn = e.target.closest(".choice");
+  if (!btn) return;
+  pendingChoice = btn.dataset.choice;
+  el.controls.classList.add("hidden");
+  el.confidence.classList.remove("hidden");
+});
+
+// confidence -> commit
+el.confidence.addEventListener("click", async (e) => {
+  const btn = e.target.closest("[data-conf]");
+  if (!btn || !pendingChoice) return;
+  const confidence = parseInt(btn.dataset.conf, 10);
+  el.confidence.classList.add("hidden");
+
+  const p = await post("/api/act", { choice: pendingChoice, confidence });
+  flash(p.correct);
+  await sleep(1500);
+
+  if (p.won) {
+    showWin(p);
+    return;
+  }
+  renderRoom(p);
+});
+
+el.begin.addEventListener("click", enterCorridor);
+el.introBack.addEventListener("click", loadSelect);
+el.change.addEventListener("click", loadSelect);
+el.again.addEventListener("click", async () => {
+  const a = ARCS_BY_ID[selectedArc];
+  if (a) await chooseArc(a);
+  enterCorridor();
+});
+
+// keep a lookup of arcs so "walk it again" can restart the same one
+let ARCS_BY_ID = {};
+(async function boot() {
+  const { arcs } = await get("/api/arcs");
+  ARCS_BY_ID = Object.fromEntries(arcs.map((a) => [a.id, a]));
+  renderArcCards(arcs);
+  show(el.select);
+})();

static/style.css

@@ -0,0 +1,254 @@
+:root {
+  --bg: #0b0c0e;
+  --fg: #d7d7d2;
+  --dim: #6d7076;
+  --accent: #9fd0c0;
+  --danger: #c98b8b;
+  --hue: 210;            /* base hue of the ambient background glow */
+  --panel-w: 40rem;
+  /* These are nudged by JS a fraction at a time -- a drift you feel
+     rather than see. */
+  --bg-shift: 0;
+  --weight: 340;
+  --tracking: 0.01em;
+}
+
+/* --- skins ---------------------------------------------------------------
+   Each arc sets data-skin on <body>; these override the palette. */
+body[data-skin="hallway"] {
+  --bg: #0b0c0e;
+  --fg: #d7d7d2;
+  --dim: #6d7076;
+  --accent: #9fd0c0;    /* cold fluorescent teal */
+  --hue: 210;
+}
+body[data-skin="stairway"] {
+  --bg: #0a0d0b;
+  --fg: #d3d8d2;
+  --dim: #6a726b;
+  --accent: #8fc79a;    /* emergency-exit green */
+  --hue: 150;
+}
+body[data-skin="coach"] {
+  --bg: #0c0a08;
+  --fg: #e0d7c8;
+  --dim: #7a7060;
+  --accent: #d8b06a;    /* warm cabin amber */
+  --hue: 35;
+}
+
+* { box-sizing: border-box; }
+
+html, body {
+  margin: 0;
+  height: 100%;
+  background: var(--bg);
+  color: var(--fg);
+  font-family: "Iowan Old Style", "Palatino Linotype", Palatino, Georgia, serif;
+  -webkit-font-smoothing: antialiased;
+}
+
+body {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 100vh;
+  /* the 1%-at-a-time background shift lives here */
+  background:
+    radial-gradient(
+      120% 90% at 50% -10%,
+      hsl(var(--hue) 8% calc(9% + var(--bg-shift) * 1%)),
+      var(--bg) 70%
+    );
+  transition: background 2.4s ease;
+}
+
+#screen {
+  width: var(--panel-w);
+  max-width: 92vw;
+  padding: 2rem;
+}
+
+.panel { animation: fade-in 1.1s ease both; }
+.hidden { display: none !important; }
+
+/* --- title --- */
+.title {
+  font-size: 3rem;
+  font-weight: 300;
+  letter-spacing: 0.18em;
+  text-align: center;
+  margin: 0 0 1.5rem;
+  color: var(--fg);
+}
+
+.select-lead {
+  text-align: center;
+  color: var(--dim);
+  line-height: 1.9;
+  margin: 0 0 1rem;
+}
+
+.brief {
+  white-space: pre-wrap;
+  line-height: 1.9;
+  color: var(--dim);
+  font-size: 1.02rem;
+  min-height: 12rem;
+  margin-bottom: 2rem;
+}
+.brief .lead { color: var(--fg); letter-spacing: 0.14em; }
+
+/* --- arc cards --- */
+.arcs {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  margin-top: 2rem;
+}
+.arc-card {
+  text-align: left;
+  background: transparent;
+  color: var(--fg);
+  border: 1px solid #2a2d31;
+  border-left: 3px solid #2a2d31;
+  padding: 1.1rem 1.3rem;
+  font-family: inherit;
+  cursor: pointer;
+  transition: border-color 0.3s ease, transform 0.15s ease;
+}
+.arc-card:hover { transform: translateX(3px); }
+.arc-card[data-skin="hallway"] { border-left-color: #9fd0c0; }
+.arc-card[data-skin="hallway"]:hover { border-color: #9fd0c0; }
+.arc-card[data-skin="stairway"] { border-left-color: #8fc79a; }
+.arc-card[data-skin="stairway"]:hover { border-color: #8fc79a; }
+.arc-card[data-skin="coach"] { border-left-color: #d8b06a; }
+.arc-card[data-skin="coach"]:hover { border-color: #d8b06a; }
+.arc-title {
+  font-size: 1.3rem;
+  font-weight: 300;
+  letter-spacing: 0.12em;
+}
+.arc-tag {
+  color: var(--dim);
+  font-size: 0.95rem;
+  margin-top: 0.4rem;
+  line-height: 1.5;
+}
+
+/* --- hud --- */
+.hud {
+  display: flex;
+  justify-content: space-between;
+  font-size: 0.72rem;
+  letter-spacing: 0.24em;
+  text-transform: uppercase;
+  color: var(--dim);
+  margin-bottom: 2.5rem;
+  gap: 1rem;
+}
+.best { opacity: 0.6; white-space: nowrap; }
+
+/* --- the loop --- */
+.heading {
+  text-align: center;
+  font-weight: 300;
+  letter-spacing: 0.22em;
+  font-size: 1.5rem;
+  margin: 0 0 2.5rem;
+  color: var(--fg);
+}
+
+.prose {
+  line-height: 2.1;
+  font-size: 1.12rem;
+  font-weight: var(--weight);
+  letter-spacing: var(--tracking);
+  min-height: 11rem;
+}
+.prose .line {
+  opacity: 0;
+  cursor: default;
+  transition: opacity 0.9s ease, color 0.4s ease;
+}
+.prose .line.show { opacity: 1; }
+.prose .line:hover { color: #fff; }
+
+.aside {
+  color: var(--dim);
+  font-style: italic;
+  min-height: 1.6rem;
+  opacity: 0;
+  transition: opacity 1.2s ease;
+  margin-top: 0.5rem;
+}
+.aside.show { opacity: 0.85; }
+
+/* --- controls --- */
+.controls {
+  display: flex;
+  gap: 1rem;
+  margin-top: 2.5rem;
+  animation: fade-in 1s ease both;
+}
+
+.confidence {
+  margin-top: 1.6rem;
+  animation: fade-in 0.6s ease both;
+}
+.conf-q { color: var(--dim); font-size: 0.92rem; margin: 0 0 0.7rem; }
+.conf-row { display: flex; gap: 0.5rem; flex-wrap: wrap; }
+
+.row {
+  display: flex;
+  gap: 1rem;
+  align-items: center;
+  justify-content: center;
+}
+
+/* --- buttons --- */
+.btn {
+  background: transparent;
+  color: var(--fg);
+  border: 1px solid #2a2d31;
+  padding: 0.8rem 1.4rem;
+  font-family: inherit;
+  font-size: 1rem;
+  letter-spacing: 0.06em;
+  cursor: pointer;
+  transition: border-color 0.3s ease, background 0.3s ease, color 0.3s ease;
+}
+.btn:hover { border-color: var(--accent); color: #fff; }
+.btn:active { transform: translateY(1px); }
+.choice { flex: 1; }
+
+.btn.ghost {
+  border-color: #23262a;
+  color: var(--dim);
+  padding: 0.55rem 1rem;
+  font-size: 0.86rem;
+}
+.btn.ghost:hover { color: var(--fg); border-color: var(--dim); }
+
+#begin, #again { min-width: 12rem; }
+
+/* --- verdict flashes --- */
+.flash-good { animation: good 1.4s ease; }
+.flash-bad { animation: bad 1.4s ease; }
+
+@keyframes fade-in { from { opacity: 0; } to { opacity: 1; } }
+@keyframes good {
+  0% { box-shadow: none; }
+  30% { box-shadow: inset 0 0 120px -40px var(--accent); }
+  100% { box-shadow: none; }
+}
+@keyframes bad {
+  0% { box-shadow: none; }
+  20% { box-shadow: inset 0 0 160px -30px var(--danger); }
+  100% { box-shadow: none; }
+}
+
+@media (max-width: 640px) {
+  .title { font-size: 2.2rem; }
+  #screen { padding: 1.2rem; }
+}

templates/index.html

@@ -0,0 +1,71 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>8</title>
+  <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}" />
+</head>
+<body data-skin="hallway">
+  <main id="screen">
+
+    <!-- Scenario / arc selection -->
+    <section id="select" class="panel">
+      <h1 class="title">8</h1>
+      <p class="select-lead">Somewhere you can't quite leave.<br />Choose a way through.</p>
+      <div id="arcs" class="arcs"></div>
+    </section>
+
+    <!-- Title / intro (per arc) -->
+    <section id="intro" class="panel hidden">
+      <h1 id="intro-title" class="title">8</h1>
+      <div id="intro-text" class="brief"></div>
+      <div class="row">
+        <button id="begin" class="btn">Begin</button>
+        <button id="intro-back" class="btn ghost">Back</button>
+      </div>
+    </section>
+
+    <!-- The loop (corridor / landing) -->
+    <section id="corridor" class="panel hidden">
+      <header class="hud">
+        <span id="progress" class="progress"></span>
+        <span id="best" class="best"></span>
+      </header>
+
+      <h2 id="heading" class="heading"></h2>
+
+      <div id="prose" class="prose"></div>
+
+      <p id="aside" class="aside"></p>
+
+      <div id="controls" class="controls hidden">
+        <button class="btn choice" data-choice="continue">Go on</button>
+        <button class="btn choice" data-choice="back">Turn back</button>
+      </div>
+
+      <div id="confidence" class="confidence hidden">
+        <p class="conf-q">How certain are you?</p>
+        <div class="conf-row">
+          <button class="btn ghost" data-conf="1">Guessing</button>
+          <button class="btn ghost" data-conf="2">I think so</button>
+          <button class="btn ghost" data-conf="3">Almost sure</button>
+          <button class="btn ghost" data-conf="4">Certain</button>
+        </div>
+      </div>
+    </section>
+
+    <!-- Win -->
+    <section id="win" class="panel hidden">
+      <div id="win-text" class="brief"></div>
+      <div class="row">
+        <button id="again" class="btn">Walk it again</button>
+        <button id="change" class="btn ghost">Change scenario</button>
+      </div>
+    </section>
+
+  </main>
+
+  <script src="{{ url_for('static', filename='game.js') }}"></script>
+</body>
+</html>