75 lines
4.4 KiB
Markdown
75 lines
4.4 KiB
Markdown
# NOT TONIGHT — instructions for Claude sessions in this repo
|
|
|
|
Papers, Please-style bouncer sim. Browser game: Phaser 3 + TypeScript (strict) +
|
|
Vite + Vitest. You are probably an **Opus 4.8 lane executor** — this repo is built
|
|
by parallel "lanes" coordinated through files, reviewed by Fable.
|
|
|
|
## Before writing any code
|
|
1. Read `LANEHANDOVER.md` — find the latest REVIEW block and any block for your
|
|
lane. Review instructions override lane files.
|
|
2. Read your lane file in `lanes/` (John/Fable will tell you which lane you are;
|
|
if not stated, ask — do not guess).
|
|
3. Skim `docs/GAME_DESIGN.md`, `docs/BUILD_PLAN.md`, and read `docs/CONTRACTS.md`
|
|
fully. Contracts are law.
|
|
|
|
## Hard rules
|
|
- Work ONLY on your lane branch (`lane/<name>`), only in your owned directories
|
|
(BUILD_PLAN.md §2) + your tests + LANEHANDOVER.md. **Never merge or push main.**
|
|
- Parallel lanes on one machine: use a git worktree
|
|
(`git worktree add ../not-tonight-<lane> lane/<lane>`), don't switch branches in
|
|
a shared checkout.
|
|
- Don't modify `docs/CONTRACTS.md`, `src/core/`, or `src/data/types.ts` after
|
|
Phase 0 — file a CONTRACT CHANGE REQUEST in the handover instead, stub locally
|
|
with `// TODO(contract):`, keep working.
|
|
- No `Math.random()` — SeededRNG streams only. No cross-lane scene imports.
|
|
Game logic in pure tested functions (`src/rules/`, per-lane logic modules);
|
|
scenes stay thin.
|
|
- End EVERY session: `npm run lint && npm run build && npm test` clean, append a
|
|
SESSION block to `LANEHANDOVER.md` (template in that file), commit, push your
|
|
branch. An unpushed session didn't happen.
|
|
- Remote is Gitea: `ssh://git@100.71.119.27:222/monster/not-tonight.git`.
|
|
|
|
## Dev notes (Phase 2 landed 2026-07-19)
|
|
- The game boots into the NIGHT (Thu→Fri→Sat run, saved). Controls: click the
|
|
rope/verdicts at the door; click the venue doorway to step inside; on the
|
|
floor WASD + E (E at the entry exits back to the door). While you're inside,
|
|
Kayden works the door — badly, on purpose.
|
|
- Dev routes: N night · P parade · F floor demo · J juice demo (+ same-named
|
|
URL hashes) · M toggles the MIX DESK overlay anywhere (ear-pass rig).
|
|
`localStorage.removeItem('not-tonight-save')` for a clean run.
|
|
- Audio unlocks on first click (TechnoEngine + location filter). Before that a
|
|
StubBeatClock keeps `beat:tick` honest.
|
|
|
|
## Dev notes (Phase 0, still true)
|
|
- Gate: `npm run lint && npm run build && npm test` — all three must pass before
|
|
any push. Dev server: `npm run dev` (port 5199, config in `.claude/launch.json`).
|
|
- Key APIs (read the source, it's short): `core/EventBus` (`on` returns an
|
|
unsubscribe fn), `core/SeededRNG` (`rng.stream(name)` — NEVER `Math.random`,
|
|
eslint blocks it), `core/GameClock` (feed real ms via `update(delta)` from your
|
|
scene; `ageOn(dob, nightDate)` is the ID math), `core/meters` (emit
|
|
`meters:delta`, never mutate NightState), `patrons/generator`
|
|
(`generatePatron(ctx, clockMin, override?)`), `patrons/dollPlan` (pure,
|
|
testable) + `patrons/doll` (`renderDoll(scene, patron, pose)` → texture key),
|
|
`rules/drunk` (`drunkStage`). `StubBeatClock` needs an owning scene calling
|
|
`update(delta)` each frame.
|
|
- **Verifying in Claude's browser preview pane:** the pane tab reports
|
|
`document.hidden = true`, so Chrome suspends rAF and the Phaser loop freezes at
|
|
frame 0. Drive frames manually via the exposed debug handle:
|
|
`const b = performance.now(); for (let i = 1; i <= 900; i++) window.game.loop.step(b + i * 16.67)`
|
|
then screenshot/inspect. In a normal browser the game runs fine.
|
|
|
|
## Tone guard
|
|
The game is Aussie hospitality satire — affectionate, funny, with a moral undertow
|
|
(design doc §4.3). If content you're writing reads as mean-spirited rather than
|
|
absurd, soften toward absurd.
|
|
|
|
## Deploy (live since 2026-07-19)
|
|
- Live at **https://monsterrobot.games/not-tonight/** (botchat VPS, forum-nginx
|
|
bind mount — host path `/home/humanjing/monsterrobot.games/games/not-tonight/`,
|
|
`/not-tonight` is a symlink to it; landing tile in `../index.html`).
|
|
- Ship: `npm run build && rsync -az --delete dist/ humanjing@100.71.119.27:/home/humanjing/monsterrobot.games/games/not-tonight/`
|
|
then cache-busted curl to verify. Hashed asset names make CF cache a non-issue;
|
|
index.html is text/html (uncached by CF default).
|
|
- Cover art: `covers/nottonight.jpg` + `_riso.jpg` (MODELBEAST flux_local seed
|
|
4208 + PIL stamp text/riso pass — recipe in LANEHANDOVER Phase-3 deploy note).
|