[infra] GUTS is live at partly.party/gutsy — deploy wired, ship-check clean

README said "target: partly.party, not wired yet". It's wired.

tools/deploy.sh follows the GAMES doctrine (deploy-map skill): QA gate -> rsync
web/ to VPS staging -> docker cp into forum-nginx -> verify. No build step, so
web/ ships as-is: vanilla ES modules + importmap with three r175 vendored, all
paths relative or resolved from import.meta.url, which is why it runs from a
subdirectory with no base rewrite. 6.6 MB. nginx.conf needed no edit — its
catch-all `root /usr/share/nginx/html` already routes any new directory, which is
how blobbo works. /gutsy (no slash) 301s to /gutsy/.

Excludes web/dev/ (ruling #5: never shipped). Verified live, not assumed: the
lane harnesses 404 through to the arcade index.

THE 200 THAT ISN'T. That same catch-all try_files means ANY missing file returns
the arcade's index.html with HTTP 200. A deploy that lost every module would
still curl 200 on all of them. So every check asserts on CONTENT, never on the
status code — this is the failure deploy-map records as ".bin data URLs serving
arcade HTML". The guard caught itself, too: it originally grepped for
`<title>MonsterRobot`, but the arcade's real title is
`~*~W3LC0M3 2 TH3 M0NST3R R0B0T P4RTY 4RC4D3~*~`, so it could never have fired.
Matched against the live box now.

DURABILITY, and it's John's call. This docker-cp's into the container's own
layer, matching blobbo/glytch: zero downtime, nothing else touched, survives
restarts and reboots (restart: unless-stopped) — but NOT `docker compose up
--force-recreate` or an nginx image bump, which wipe it. Re-running the script is
the fix. The durable alternative is a bind mount in forum/docker-compose.yml like
cratewars/roguelike have, which costs a forum-nginx recreate and brief downtime
across ALL of partly.party, so this script does not take that decision.

ship-check (README says run it before deploying — I ran it after; my miss, and it
came back clean):
  1 auth        N/A — static files, no endpoint/API/admin surface
  2 secrets     PASS — nothing secret-shaped in the payload or the diff
  3 input/SSRF  PASS — the only user string reaching a fetch is ?lvl=, and C
                gates it on the CAMPAIGN allowlist BEFORE the load
                (levels/index.js:151). Traversal tested live with
                `curl --path-as-is` (plain curl normalises ../ away and proves
                nothing): /etc/passwd never leaked. DEPOT_BASE in assets.js is
                unused — the manifest has zero external URLs.
  4 money       N/A
  5 deploy      PASS — verified by content + booted in a real browser:
                assets.misses() == [], 15 draws, 69k tris, zero console errors.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
type-two 2026-07-17 23:02:04 +10:00
parent 83c30bf344
commit 77ddf88c31
2 changed files with 99 additions and 2 deletions

View File

@ -45,5 +45,15 @@ optional at runtime — the game boots and plays asset-free with procedural fall
## Deploy
Target: partly.party (static). Not wired yet — when it's time, consult the `deploy-map` skill
and run `ship-check` first. Origin: `ssh://git@100.71.119.27:222/monster/guts.git`.
**Live: https://partly.party/gutsy/** — `bash tools/deploy.sh` (QA gate → rsync `web/` minus
`dev/``docker cp` into `forum-nginx` → verify). No build step; `web/` ships as-is.
Two things to know before you touch it, both documented at length in the script header:
- **It's ephemeral.** Content lives in the container's own layer (like blobbo/glytch), so a
`docker compose up --force-recreate` or nginx image bump wipes it — re-run the script. The
durable fix is a bind mount in `forum/docker-compose.yml` (what cratewars/roguelike use),
which costs a forum-nginx recreate and brief partly.party downtime.
- **A 404 there returns HTTP 200.** nginx's catch-all `try_files ... /index.html` serves the
arcade index for any missing file. Verify on content, never on status codes.
Origin: `ssh://git@100.71.119.27:222/monster/guts.git`.

87
tools/deploy.sh Executable file
View File

@ -0,0 +1,87 @@
#!/usr/bin/env bash
# =====================================================================
# GUTS — deploy to https://partly.party/gutsy/
# =====================================================================
# Usage: bash tools/deploy.sh
#
# 1. QA gate (never ship red)
# 2. rsync web/ to VPS staging — MINUS web/dev/ (ruling #5: never shipped)
# 3. docker cp into forum-nginx web root
# 4. verify index AND data endpoints (see "the 200 that isn't" below)
#
# No build step: GUTS is vanilla ES modules + an importmap with three r175 vendored, so
# web/ ships as-is. All paths are relative (index.html) or resolved from import.meta.url
# (core/assets.js), which is why it runs from a subdirectory with no base rewrite.
#
# THE 200 THAT ISN'T. nginx.conf serves `root /usr/share/nginx/html` with a catch-all
# `try_files $uri $uri/ /index.html`. That's what routes /gutsy/ with no location block of
# its own — but it also means ANY missing file returns the forum's index.html with HTTP 200.
# A deploy that lost every module would still curl 200 on all of them. So each check below
# asserts on CONTENT, never on the status code alone. (This is the failure the deploy-map
# skill records as ".bin data URLs serving arcade HTML".)
#
# DURABILITY. This docker-cp's into the container's own layer, matching blobbo/glytch. It
# survives restarts and reboots (restart: unless-stopped) but NOT `docker compose up
# --force-recreate` or an nginx image bump — those wipe it, and re-running this script is
# the fix. The durable alternative is a bind mount in forum/docker-compose.yml like
# cratewars/roguelike have, which costs a forum-nginx recreate (brief partly.party downtime)
# and so is John's call to schedule, not this script's to take.
#
# Requirements: ssh humanjing@100.71.119.27 (tailscale), container forum-nginx.
# =====================================================================
set -euo pipefail
VPS="humanjing@100.71.119.27"
CONTAINER="forum-nginx"
REMOTE_WEB_ROOT="/usr/share/nginx/html/gutsy"
STAGING="/tmp/gutsy_deploy"
LIVE="https://partly.party/gutsy"
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
echo "[1/4] QA gate ..."
bash "$ROOT/tools/qa.sh" > /tmp/gutsy_qa.log 2>&1 || { echo " ✗ QA RED — not shipping. See /tmp/gutsy_qa.log"; exit 1; }
echo " ✓ QA green"
echo "[2/4] Syncing web/ to VPS staging (excluding dev harnesses) ..."
ssh "$VPS" "rm -rf '$STAGING' && mkdir -p '$STAGING'"
rsync -az --delete --exclude='.DS_Store' --exclude='dev/' "$ROOT/web/" "$VPS:$STAGING/"
echo " $(ssh "$VPS" "du -sh $STAGING | cut -f1") staged"
echo "[3/4] Replacing container content ..."
ssh "$VPS" "docker exec $CONTAINER sh -c 'rm -rf ${REMOTE_WEB_ROOT:?} && mkdir -p ${REMOTE_WEB_ROOT:?}' && docker cp $STAGING/. $CONTAINER:$REMOTE_WEB_ROOT"
echo "[4/4] Verifying live endpoints (content, not status) ..."
BUST="$(date +%s)"
fail=0
check() { # check <label> <url-suffix> <grep-pattern>
local label="$1" url="$LIVE$2?v=$BUST" pat="$3" body
body="$(curl -fsS --max-time 20 "$url" 2>/dev/null || true)"
if [ -z "$body" ]; then
echo "$label — empty/failed response"; fail=1; return
fi
# The arcade index is what try_files falls through TO. Match its real title — checked
# against the live box, not guessed; the guard is worthless if the marker is wrong.
if grep -q 'M0NST3R R0B0T P4RTY 4RC4D3' <<<"$body" 2>/dev/null; then
echo "$label — served the ARCADE index (file is missing; try_files fell through)"; fail=1; return
fi
if ! grep -q "$pat" <<<"$body" 2>/dev/null; then
echo "$label — 200 but content unrecognised"; fail=1; return
fi
echo "$label"
}
check "index.html" "/" 'id="game"'
check "js/boot.js" "/js/boot.js" 'Lane F'
check "ui/hud.js" "/js/ui/hud.js" 'createHUD'
check "vendor/three r175" "/vendor/three.module.js" 'REVISION'
check "assets/manifest" "/assets/manifest.json" 'textures'
# the no-trailing-slash form John will actually type
REDIR="$(curl -s -o /dev/null -w '%{http_code}' --max-time 20 "$LIVE?v=$BUST")"
echo " · $LIVE (no slash) -> HTTP $REDIR (301/302 to /gutsy/ expected)"
[ "$fail" = "0" ] || { echo " ✗ DEPLOY UNVERIFIED"; exit 1; }
echo " ✓ deployed: $LIVE/"
echo
echo "Cloudflare fronts partly.party — purge the cache if you redeploy over existing files."