t\j(TSrSSKJr SSKrSSKrSSKrSSKrSSKrSSKJ r J r SSK J r \ "\ 5R5RRr\S- rSrS/r/S QrS /r1S krSS jrSS jrSSjrSSjrSrSSjrSSjr"SS\ 5rSSjr\ S:Xa\"5 gg)userve.py — the one committed entrypoint for the Holtburger dev web server. WHY THIS EXISTS --------------- The 3D renderer's baked data (manifest/shards + per-landblock scenery/spawns/ events) used to be bound into the web-served tree by a fan-out of FOUR gitignored, machine-local, cross-drive symlinks. They were absent on every fresh checkout, on every git worktree, on a new host, or whenever someone forgot to hand-run `setup-dist-symlinks.sh` — and because the wasm client treats a per-landblock 404 as "0 placements here" (correct for an empty LB), a whole unbound layer rendered an emptier world with ZERO error signal. Outdoor scenery vanished this way repeatedly. The dev server itself had the same disease: it was an uncommitted `/tmp/nocache-server.py` that got wiped on reboot. This script ends both failure modes: * The baked layers are now consolidated as REAL dirs under ONE canonical root (`$HOLTBURGER_DIST`), so only a single `external/holtburger/dist` symlink is needed — and this script (re)creates it automatically, so a fresh tree or worktree just works. * It VALIDATES every required layer is present + non-empty before serving and refuses to start (loud, exit 1) if one is missing — no more silent serving of a scenery-less world. * It writes `dist/_health.json` (per-layer file counts) that the page reads at boot to show a visible banner if a layer ever goes missing despite all this. It is a committed `ThreadingHTTPServer` (the single-threaded `http.server` wedges when a client pulls the 3.6 MB wasm over the reverse tunnel) that serves the `external/holtburger/` tree from any cwd. USAGE scripts/serve.py # validate, write _health.json, serve on :8765 scripts/serve.py --check # validate + write _health.json, then exit (CI/preflight) scripts/serve.py --allow-missing # serve even if a baked layer is absent (UI-only / worktree dev) scripts/serve.py --port 9000 # override port (default 8765, env PORT) ENV HOLTBURGER_DIST canonical baked-data root. Default /mnt/wbterminal2/holtburger-dist. (Honours the legacy HOLTBURGER_DIST_V2 as a fallback alias.) PORT listen port (default 8765 — the proxy.cjs / perf-worker contract). ) annotationsN)SimpleHTTPRequestHandlerThreadingHTTPServer)Pathdistz /mnt/wbterminal2/holtburger-dist manifest.json)shardssceneryspawnsevents>r r r c[RRS5=(d, [RRS5=(d [n[ U5$)z-Resolve the single canonical baked-data root.HOLTBURGER_DISTHOLTBURGER_DIST_V2)osenvironget DEFAULT_ROOTr)roots scripts/serve.pycanonical_rootrKs8 ::>>+ , d ?S0T dXdD :cp[S[R"U555$![a gf=f)zBCheap non-recursive file count (layers are flat: one file per LB).c3R# UHoR5(dMSv M g7f)N)is_file).0es r count_files..Ts;myy{11ms' 'r)sumrscandirOSErrords r count_filesr%Qs2;bjjm;;; s %( 55cb[[R"U55$![a gf=f)NF)anyrr!r"r#s r dir_nonemptyr(Ys,2::a=!! s ! ..cUR5(d:SU3nU(a[SUS3[RS9 g[ SUS3/U5 [ R 5(ay[[R"[ 55U:Xag[R"[ 5 [R"U[ 5 [SU3[RS9 g[ R5(a![S [ S 3[RS9 g[R"U[ 5 [S U3[RS9 g) zMake `external/holtburger/dist` point at `root`, creating/repairing as needed. The whole point: a fresh checkout/worktree gets the binding for free. Never clobbers a real directory someone may have baked directly into dist/.zbaked-data root not found: zWARN: u2 — serving without baked data (--allow-missing).fileNzroot 'z?' does not exist (is the /mnt drive mounted? has the bake run?)zrepaired dist symlink -> zNOTE: u4 is a real path, not a symlink — leaving it as-is.zcreated dist symlink -> ) existsprintsysstderrdie_loud DIST_LINK is_symlinkrrreadlinkremovesymlink)r allow_missingmsgs rensure_dist_symlinkr8`s ;;==+D62  F3%QRY\YcYc d F4& _`acgh  I& '4 /  ) 4# )$0szzB yk!UV]`]g]ghJJtY $TF +#**=rcz0n/n[S- nUR5nX3(aSOSS.US'U(dURS5 [[-Hn[U- nUR 5=(a [ U5nU[;a UR 5(a [U5O U(aSOSnX6S.X'U(aMrU[;dM~URSUSU35 M [RR5R5RSS 9[[55US .nXq4$) zJInspect every layer through the dist link; return (health_dict, failures).rrr)presentfilesu0manifest.json missing — run the dat-shard bakezlayer 'z/' missing or empty at seconds)timespec) generated_atrlayers)r1rappend REQUIRED_DIRSRECOMMENDED_DIRSis_dirr( COUNTED_DIRSr%datetimenow astimezone isoformatstrr)r?failuresfr:namer$r;healths r build_healthrN|s FHO#AiikG*1AaPF? JK 00  ((*0a#'<#7AHHJJ ASZa`a#*; w4=0 OOgdV+B1#F G 1!))--/::<FFPYFZN$%F  rc[S- nUR[R"USS9S-5 g![a(n[ SUSU3[ RS9 SnAgSnAff=f)Nz _health.json)indent zWARN: could not write z: r*)r1 write_textjsondumpsr"r-r.r/)rMoutrs r write_healthrWs\ n $CD tzz&3d:; D &se2aS1 CDs'3 A%A  A%c SnSUSUSU3S/nUHnURSU35 M USSS S S S US/- n[S RU5[RS9 [R "S5 g)NzH!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!uF!! HOLTBURGER DEV SERVER — REFUSING TO START: baked data is unboundz!! canonical root: z9!! the following required layer(s) are missing or empty:z !! - z!!zM!! This is the bug that silently emptied the world. Fix it, don't ignore it:zE!! * make sure /mnt/wbterminal2 (and /mnt/wbterminal1) are mounteduN!! * (re)run the bake — see external/holtburger/docs/emit-dynamic-site.mdzE!! * point HOLTBURGER_DIST at the root if the bake lives elsewherezL!! * for UI-only / worktree work with no baked data, pass --allow-missingrRr*r)r@r-joinr.r/exit)rJrbarlinesfails rr0r0s C  P tf%C  E z$()  WOXOV    E $))E ,HHQKrcD^\rSrSrSrU4SjrU4SjrU4SjrSrU=r $)HandleruServe the external/holtburger/ tree with dev no-cache headers (the reason the old /tmp/nocache-server.py existed — Firefox/Chrome ES-module + wasm caching makes inner-loop iteration confusing). Caching for production-shaped runs is applied by proxy.cjs in front, not here.cD>[TU]"US[[50UD6 g)N directory)super__init__rI HOLT_ROOT)selfargskwargs __class__s rreHandler.__init__s $C#i.CFCrc>URSS5 URSS5 URSS5 [TU] 5 g)Nz Cache-Controlz#no-cache, no-store, must-revalidatePragmazno-cacheExpires0) send_headerrd end_headers)rgrjs rrqHandler.end_headerss? *OP :. C( rc>[US5nUS:a[TU]"U/UQ76 gg![[4a SnN-f=f)Nrri)int IndexError ValueErrorrd log_message)rgfmtrhstatusrjs rrwHandler.log_messagesP a\F S= G  +d + J' F s *??) __name__ __module__ __qualname____firstlineno____doc__rerqrw__static_attributes__ __classcell__)rjs@rr`r`s8 D ,,rr`c [R"SS9nURSSSS9 URSSSS9 URS [[[R R S S 55S 9 URS SS9 UR5n[5n[X!R5 [5up4[U5 SRSUSR555n[SUSU3[ R"S9 U(aUR(d [%XB5 U(aI[S['U5S3[ R"S9 UHn[SU3[ R"S9 M UR((a%[SU(aSOS-[ R"S9 g[+UR,UR.4[05nSUR,SUR.S3n[S[2S U3[ R"S9 UR55 g![6a+ [S![ R"S9 UR95 gf=f)"Nz3Holtburger dev web server (single-root, validated).) descriptionz--check store_truez4validate + write _health.json, then exit (no server))actionhelpz--allow-missingz%serve even if a baked layer is absentz--portPORT8765)typedefaultz--bindz 127.0.0.1)rz c3R# UHupUSUS(aUSOS3v M g7f)=r:r;MISSINGNr{)rrLinfos rrmain..s12JD &4 ?$w- BC2s%'r?z [serve] root=z [serve] layers: r*z[serve] --allow-missing: z# required layer(s) absent, ignored:z [serve] - z[serve] --check OKz (with --allow-missing)z: all required layers present.zhttp://:z/apps/holtburger-web/index.htmlz[serve] serving z# (threaded, no-cache) [serve] open z [serve] shutting down.)argparseArgumentParser add_argumentrtrrr parse_argsrr8r6rNrWrZitemsr-r.r/r0lencheckrbindportr`rf serve_foreverKeyboardInterruptshutdown) aprhrrMrJsummaryr^httpdurls rmainrs  -b cBOOIl9oOpOO%lAhOiOOH3BJJNN664R0SOTOOHkO2 ==?D  D001#~Fii *002G M$1' ;#**M**  )#h-8[\cfcmcmnD L'cjj 9 zz "8&?Qqry|zDzD E DII 6 @E DII;a {*I JC YK'KC5 QX[XbXbc   (szz: sH002I%$I%__main__)returnr)r$rrrt)r$rrbool)rrr6rrNone)rMdictrr)rJz list[str]rrrr)rr)!r __future__rrrErTrr. http.serverrrpathlibr__file__resolveparentrfr1r REQUIRED_FILErArBrDrr%r(r8rNrWr0r`rr|r{rrrs(T# E N " " $ + + 2 2   1 !! / : /  >8:D4,&,2'T zFr