Archived: point-in-time note from 2026-09-24; may be out of date.
Written by a cloud session that could change and test code but had no VM
access and no LiDAR. Everything below is on main. The job now is to build
with it, look at the results on real roofs, and fix what the real data shows.
bash tests/run_all.sh passes on main. That includes the
synthetic region (tests/synthetic/run.py), which builds ten made-up
roofs through the real stages and checks the output against a reference.
The goldens (tests/test_golden.py) are stale ON PURPOSE: the geometry
moved.src/plane_seams.py: roof a face took from its neighbour across a
hip or valley goes back, when the returns show it. On the synthetic
L roof it removed phantom obstructions. Turn it off with
SOLAR_PLANE_SEAMS=0 to compare.src/outline_axis.py: panels are racked, and faces straightened, to
the building’s WALLS instead of its bounding rectangle, which lies on the
diagonal of a stepped outline. That affects 1,300 of 26,592 Queenstown
outlines. A building with a wing at another angle straightens each face
to its own wall family.roof_segmentation.roof_confidence: plant standing on a flat roof no
longer counts against the publish gate (17 Church St was withheld at
0.42).BACKLOG.md.full once, which
is expected.cd <the repo>
git pull origin main
bash tests/run_all.sh # must pass before anything ships
./tools/sync_vm.sh # refuses if the VM is mid-build; do not --force without checking
Check that the new files reached ~/solar-map on the VM:
src/outline_axis.py, src/plane_seams.py, tools/explain_obstructions.py,
tests/synthetic/run.py. (sync_vm.sh skipped subdirectories until
24 Sep; it now passes --recurse.)
sync_vm.sh does not copy data/. data/roof_cases.json on main has
six new cases (the table below). tools/cases.py also writes history into
that file on the VM, so do not overwrite it blindly. Either re-add the six
there (tools/cases.py add <id> "<note>"), or merge the two files. The VM is claude-doing-things, project
downloads-417521, zone australia-southeast1-b.
Run long jobs on the VM detached (nohup ... > log 2>&1 &, or tmux) so a
dropped SSH session does not kill them.
bash tests/run_all.sh: the same result as on the laptop, on the VM’s
Python..venv/bin/python tests/test_golden.py --record, then look at the render
of every golden whose count moved and record the reason in the commit
(made on the laptop). Judge by the renders, not the counts.bash src/run_district_build.sh rebuilds all regions (incremental, which
is a full build this once). Watch the log for STAGE FAILED..venv/bin/python src/invariants.py <region> for each region..venv/bin/python tools/cases.py check --render re-measures every
flagged roof and renders the ones that changed to
data/preview/cases.html..venv/bin/python tools/explain_obstructions.py 5370328 5371137 5372604
shows, for every obstruction on those roofs, which detector drew it and
how far its returns sit off the face’s plane..venv/bin/python tools/predeploy_check.py; then, from the LAPTOP,
tools/deploy_from_vm.sh. Look at what it shows, then run
tools/deploy_from_vm.sh --push.| Roof | ID | Complaint | What should have changed |
|---|---|---|---|
| 11A Camp St | 4735274 | wonky roof lines | walls at 40 deg, bounding box said 55; faces now straightened to 40 |
| 17 Church St | 4726056 | flat roof with plant, no panels | confidence no longer penalises plant; should publish with panels between the plant |
| 9 Marine Parade | 5370328 | wrong lines, obstructions over clear roof (202 m2 of 743) | partly plane_seams; run explain_obstructions |
| 1 Ballarat St | 5372604 | panels over unmarked vents; lines miss ridges and valleys | plane_seams for the valleys; vents are UNDIAGNOSED |
| 12 Stanley St | 4725580 | pyramid roof, lines misaligned | two wall families (47 and 76 deg); each face now takes its own |
| 8 Sydney St | 5371137 | panels at an odd angle, obstructions over clear roof | one bearing, ~79 deg, along the walls (was 21 deg skew); run explain_obstructions |
Show Josh the renders. He decides fixed or wrong
(tools/cases.py verdict <id> fixed|wrong), not the numbers.
explain_obstructions for each
roof:
plane_seams.STATS counts roofs and moves.HEIGHT_RESIDUAL_THRESHOLD_M and HEIGHT_MIN_CLUSTER_POINTS in
src/obstruction_detection.py.sync_vm.sh refuses; respect it).bash tests/run_all.sh. If the synthetic reference
moves on purpose, tests/synthetic/run.py --record, with the reason in
the commit.