The game kit: the shared infrastructure of Wiz-War and Waving Hands as a template

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0141G6xqLeNRYEtviLWSB5Up
2026-09-23 11:00:05 -04:00
commit 1cd24e3ddd
59 changed files with 7420 additions and 0 deletions
@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# Build locally, push the static site and the game server to the droplet,
+# and restart the server. Usage: deploy/deploy.sh <droplet-ip-or-host>
+set -euo pipefail
+HOST="${1:?usage: deploy.sh <droplet-ip-or-host>}"
+
+npm run check
+npm run check:server
+npm test
+npm run build
+
+# Every production ledger must replay identically with the engine about to ship.
+deploy/verify-ledgers.sh "$HOST"
+
+# Old hashed chunks stay a week: a page loaded before this deploy can still
+# fetch the module it was built against instead of failing mid-game.
+rsync -az --delete --filter='P _app/immutable/*' \
+  build/ "root@$HOST:/opt/__SLUG__/build/"
+
+# The server runs from source with tsx and carries its own small manifest;
+# it needs only its code and the engine. Ledgers live outside this tree.
+rsync -az --delete --exclude='/server/node_modules' \
+  --include='/server/***' --include='/src/' --include='/src/lib/' --include='/src/lib/game/***' --include='/src/lib/net/' --include='/src/lib/net/view.ts' \
+  --include='/deploy/' --include='/deploy/__SLUG__.service' --include='/deploy/__SLUG__.cron' --include='/deploy/*.sh' \
+  --exclude='*' \
+  ./ "root@$HOST:/opt/__SLUG__/app/"
+
+ssh "root@$HOST" '
+  find /opt/__SLUG__/build/_app/immutable -type f -mtime +7 -delete
+  chown -R root:caddy /opt/__SLUG__/build
+  chmod -R g+rX /opt/__SLUG__/build
+  cd /opt/__SLUG__/app/server && npm install --no-audit --no-fund
+  chown -R __SLUG__:__SLUG__ /opt/__SLUG__/app
+  cp /opt/__SLUG__/app/deploy/__SLUG__.service /etc/systemd/system/__SLUG__.service
+  # Cron runs the rollup and the backup from /usr/local/bin: install them on
+  # every deploy so the live copies are always the repo copies.
+  install -m 755 /opt/__SLUG__/app/deploy/visitors.sh /usr/local/bin/__SLUG__-visitors.sh
+  install -m 755 /opt/__SLUG__/app/deploy/pulse.sh /usr/local/bin/__SLUG__-pulse.sh
+  install -m 755 /opt/__SLUG__/app/deploy/__SLUG__-rollup.sh /usr/local/bin/__SLUG__-rollup.sh
+  install -m 755 /opt/__SLUG__/app/deploy/__SLUG__-backup.sh /usr/local/bin/__SLUG__-backup.sh
+  install -m 644 /opt/__SLUG__/app/deploy/__SLUG__.cron /etc/cron.d/__SLUG__
+  mkdir -p /var/log/__SLUG__
+  systemctl daemon-reload
+  systemctl enable --now __SLUG__
+  systemctl restart __SLUG__
+  systemctl reload caddy
+  sleep 1
+  systemctl --no-pager -l status __SLUG__ | head -3
+'
+echo "deployed."