HardYards/THREADS.md

THREADS — append-only lane log

One line per landed feature, contract change, or open question. Format: [lane letter] YYYY-MM-DD — note

[.] 2026-07-16 — repo seeded: DESIGN.md (canon), PLAN3D.md (build plan), prototype/ (2D reference, do not modify)

[A] 2026-07-16 — M0 LANDED on main — rebase your lane onto it now. stdlib server.py on :8801 (--selfcheck verifies the tree + prints URLs), .claude/launch.json → "shades3d", three r175 vendored in-repo at web/world/vendor/ (no more reaching into 90sDJsim at runtime), contracts.js, graybox 30×20 m yard, third-person camera, selftest harness. python3 server.py and it runs. Selftest green: 18 pass / 4 skip (your lanes) in ~90 ms.

[A] 2026-07-16 — Yard layout is now FACT, build against it: 7 anchors, same shape as the prototype's — h1/h2/h3 house fascia at x=-5/0/+5, y=2.6, z=-9.9 · t1 tree (-9, 3.2, 2) · t2 tree (8, 3.1, -2) · p1 post (-6.4, 3.9, 7.4) · p2 post (5.3, 3.9, 8) — posts are raked 8° away from yard centre. Garden bed rect {x:1, z:2, w:6, d:4}. North (-Z) is the house edge. Sun sits in the NORTH (Australian yard), elevation 55°, so sail shadows fall south onto the bed — and the house's yard-facing wall is permanently backlit, which is correct and not a bug.

[A] 2026-07-16 — CONTRACT ADDITIONS. PLAN3D §4 didn't cover these and the code needs them. All are in contracts.js with JSDoc. Shout here if any of them fight your lane: · world.heightAt(x,z) -> number — ground height, closed-form, pure. Lane D clamps the player to it, Lane C bounces debris off it. · world.gardenBed -> {x,z,w,d} — the rect you pass to sailRig.coverageOver(). · world.sunDir -> Vector3 — unit vector from the GROUND toward the sun. Shade test is raycast(origin=groundPoint, direction=sunDir); a hit means shaded. · world.solids -> Object3D[] — obstacles ONLY. The ground is deliberately not in it — use heightAt(), it's exact and free. Raycasting 4800 terrain triangles a frame took the camera selftest from 78 ms to 4088 ms before I pulled it out. · player.update(dt,t) — main.js has to step the player from somewhere. · camera.yaw -> number — Lane D, your WASD is relative to this. · game.on(type, fn) with type 'phaseChange' → {from, to}. §4 wrote it as game.on(phaseChange); implemented Emitter-style for consistency with sailRig.events. · checkContract(name, obj) -> string[] — asserts a module matches its contract. This is the merge tripwire; I run it on every lane's module after every merge.

[A] 2026-07-16 — CONTRACT CLARIFICATION — Lane B read this one. anchor.sway(t) returns the ABSOLUTE world position, not an offset. It is exactly what you pin a cloth corner to: node.copy(anchor.sway(t)). (The prototype's anchorPos() is the precedent.) House and post anchors return a constant; tree anchors wander with the wind they stand in — that wander IS dynamic load, and it's why a tree anchor is the scary choice. Each anchor owns its own scratch vector so two anchors can never alias, but the vector is reused between calls on the same anchor: clone before you store it. Asserted both ways in js/tests/a.test.js.

[A] 2026-07-16 — selftest.html is import-only and nobody edits it. Each lane owns web/world/js/tests/<letter>.test.js — stubs are pre-created and currently skip, with your PLAN3D asserts written into the header comment. Five lanes sharing one selftest.html would be the single guaranteed merge conflict in this repo. Harness + assert helpers in js/testkit.js; drive time with fixedLoop(), never rAF (rAF is throttled in a hidden tab — verified, the game loop genuinely stalls at t=0.07 s there, so a rAF-driven selftest would be a lie).

[A] 2026-07-16 — main.js drives an M0 placeholder capsule that satisfies the Player contract, purely so the camera has something to follow. Lane D: when player.js is ready, ping here — I'll swap the factory call in boot() and delete the placeholder. You shouldn't need to touch main.js.

[A] 2026-07-16 — ⚠️ PLAN3D §2's asset inventory was substantially wrong and is now corrected in-place. Verified against the filesystem on m3ultra (Spotlight + find over ~ and /Volumes): · 3D-STORE is at ~/Documents/Destroyulater/3D-STORE/, not ~/Documents/3D-STORE/. clean_glbs/ is there and does contain exactly the promised debris (BlueCrate_v2, BlackTub_v2, WhiteTub_v2, WoodenBin_v2, LibraryTrolley_v1). build_booth_room_v23.py is there too, and also at ~/Documents/3dstore/. Lane E: your inputs are real, just relocated. · DOES NOT EXIST anywhere on this box: ~/Documents/3D=models/ (characters, the 32 anim clips, street-furniture incl. building_shell_01.glb, furniture, props-scenes), ~/Documents/character_kit/, ~/Documents/mixamo-fetch/, ~/Documents/FBX/. · Real and verified: the 21-ped fleet at 90sDJsim/web/world/models/peds/, and 90sDJsim/DEVMANUAL.md. Lane D, this lands on you: §5-D assumed the character_kit retarget pipeline and a Mixamo clip library; neither is here. The only clips I found are peds/idle.glb and peds/walk.glb. A walking character is still reachable; Running / Falling / Crouch-To-Stand / crank / dig are not sourced. Don't spend a day looking — answer is needed from whoever wrote §2.

[A] 2026-07-16 — ❓ OPEN QUESTION, needs a human. PLAN3D §0 says lanes run on "the M1 Ultra (johnking@100.91.239.7, Tailscale)", but this box is m3ultra and already has ~/Documents/shades-laneB/ and shades-laneE/ checked out — so lanes are in fact running here, and §0's clone path is what people are actually using. If the four missing libraries above live on that other machine, this isn't a path fix, it's a decision about where lanes run. Flagging rather than guessing.