Fix overlay shapes ignoring the z-buffer (bugreport 20260920-131610)

Solid geometry never occluded Line or Billboard/GlowingPoint output:
their span writers blended pixels unconditionally ('overlay semantics'),
so wireframe shapes, text sprites and glow points showed through solid
surfaces — e.g. wireframe pyramids visible through the solid sphere in
ShapeGalleryDemo.

Lines: interpolate 1/z per pixel (projectively linear along the 2D
projected segment; thick path projects each span pixel onto the line
parameter, thin paths reuse their walk parameter) and depth-test with
the same idiom as SolidPolygon. Sprites: screen-aligned, so one 1/z
value covers the whole quad. Both depth-TEST only and never depth-
WRITE (like pass-2 translucent geometry): a line/sprite must not
occlude geometry painted after it, and the HiZ pyramid is unaffected.

Verified: bug-pose render (Snapshot.cameraFromPose on the bugreport
pose) shows a clean sphere disc; all 21 unaffected goldens bit-
identical; shape-gallery + stereo goldens re-blessed after visual
review confirmed every changed pixel is a correct occlusion (wireframe
lines/grid/particles blocked by the solid sphere). Engine 48/48.

Add CsgTest (9 tests) — first-ever coverage of the CSG/BSP machinery

Covers: union/subtract/intersect for disjoint+overlapping boxes
(interior-face and containment invariants), determinism (bit-exact
repeat runs), input immutability, and degenerate empty operands.

The test immediately caught a real defect: Csg.intersect with an empty
operand returned the FIRST operand unchanged (classic BSP sequence
degenerates: clips against an empty tree are no-ops and the inverts
cancel). Csg now guards empty operands explicitly in all three ops.
A naive polygon-count assertion in the test itself was also corrected
to the meaningful centroid invariant (BSP splits boundary faces,
making net counts meaningless).

OctreeVolume: fail loudly on cell-pool exhaustion instead of hanging

getNewCellPointer looped forever when the pool was full (wrap-rescan
with no exit). Two guards now: the usedCellsCount fast path (made honest
— the master cell at index 0 is now counted at initWorld) and an
authoritative full-scan-cycle check that throws IllegalStateException
with capacity + remediation in the message. Verified with a tiny-pool
harness: 7 allocations + master fill 8 cells, the 9th throws (was: hang).

Also: class javadoc now states the subsystem's demo-only status and the
traceCell coverage reality; OctreeVolumeTest (2 tests) pins the
exhaustion behavior with a timeout that fails on the old implementation.

Extract CSG engine + device hotplug; resolve blend-formula question

- New Csg utility (pure polygon-list functions: union/subtract/intersect
  over BSP clip/invert sequences). AbstractCompositeShape's three CSG
  methods are now one-line delegates; clonePolygons moved into Csg.
  Composite drops 95 lines and its dependency on BspTree.
- New gui/DeviceHotplug: head-tracker + SpaceMouse hot-plug managers,
  extracted from ViewPanel (which now holds a single field and two
  delegating getters). ViewPanel loses its HeadTrackingManager/
  SpaceMouseManager lifecycle code.
- Blend formulas: PROVEN bit-identical. SolidPolygon's
  ((255-a)*dest + a*src)>>8 and TexturedTriangle's lerp form
  dest + ((a*(src-dest) - dest)>>8) agree for all 16.6M (a,src,dest)
  inputs (exhaustive check). Documented at both span writers; no change.
- transformChildrenParallel's aggregator param: NOT dead as the review
  claimed — it feeds the serial-fallback paths. Restored with accurate
  javadoc (was nearly deleted on the review's say-so; the build caught
  it before commit).

Deliberately NOT split: ViewPanel's render-loop core (mailbox, present
gates, pending paints) and AbstractCompositeShape's parallel-transform
planner — both are concurrency-critical and deliberate; extraction
trades cohesion for race-condition risk with zero functional gain.

Package relocation: make package structure real and acyclic

Moved (git mv, move-only, no behavior change):
- gui -> renderer.raster: RenderingContext, SegmentRenderingContext,
  HiZPyramid, CullingStatistics, StereoEye, Frustum, Vertex (math)
- gui -> diag: ThreadActivityRecorder, DebugLogBuffer
- gui -> geometry: Camera (decoupled from gui.FrameListener: dead
  ViewPanel param dropped, panel registers a lambda adapter)
- geometry -> renderer.raster.shapes.composite.base: Plane, BspTree,
  PolygonType (CSG machinery, used only by shapes)
- renderer.octree -> geometry: IntegerPoint (zero-dep coordinate type)
- ShapeCollection's ViewPanel overloads deleted (trivial delegates;
  callers pass getCamera()); RenderingContext.bufferedImage made public
  (AWT shell blits it); javadoc {@link}s re-qualified.

Resulting layering: math <- geometry <- renderer.raster <- gui, with
diag a standalone leaf. Remaining known renderer->gui edges (next
refactor): DeveloperTools field + mouse-picking API types
(MouseEvent/MouseInteractionController/ViewSpaceTracker/TextPointer)
and demo-only RayTracer->ViewPanel.

Verified: engine 37/37 tests, all 3 consumer repos (demos, aukio,
aukio-environment-fo4) compile, demo goldens bit-identical to the
pre-relocation run.

Hoist per-triangle mipmap metrics out of the per-tile paint path

- paintFlat no longer recomputes the screen-edge perimeter (3 sqrt) per
  overlapped tile: callers pass it in. Object path already computed it
  in paintTriangle (it was computed twice per paint); mesh handles read
  a per-slot value computed once in TriangleMeshBlock.transform (queued
  triangles only). Clipped fan sub-triangles compute inline (rare).
- TriangleMeshBlock UV perimeter (origTtd) precomputed once at build
  into uvPerimeter[] instead of 3 sqrt over the final uv[] per paint.

Bit-exact: same expressions, same accumulation order, same inputs —
verified by identical golden diff counts against the pre-change run
(23/23 scenes).

Parallel radix sort for large render queues

The radix path now uses the paint executor: key build, the 8 LSD passes
(per-chunk histograms, digit-major/chunk-minor offsets, per-chunk
scatter) and the final permute all run chunked in parallel. Stability is
preserved exactly, so the output is bit-identical to the serial sort for
any chunk count (pinned by a new RadixLongSortTest property test over
sizes 0..250k x chunk counts 1..8) — golden-image determinism intact.

Also deletes the now-unreachable parallelMergeSort/runSortTasks/
mergeRuns (~100 LOC) and routes the no-executor (headless) path through
the serial radix instead of Arrays.parallelSort.

Measured on a 24-core desktop (450k pairs, SortBench/SortSweep harnesses):
sort phase ~7 ms serial -> ~4-5 ms parallel (1.2-1.8x; bandwidth-bound,
frequency-capped test machine). Key-build/permute parallelization comes
on top in the full pipeline.

Comment/doc truth pass: purge painter-era and double-buffer-era staleness

Code comments/javadoc now match the z-buffer, triple-buffered reality:
- RenderAggregator class javadoc (was painter's algorithm), ctor slot docs
- ViewPanel frameContexts/frameParity comments (was double-buffer/parity)
- RenderingContext depth comment (dropped dead -Daukio.zbuffer knob and
  'Null in classic painter mode' — depth is always allocated)
- TexturedTriangle/ShapeCollection/package-info: slot ranges 0..2,
  javadoc links retargeted off deleted painter span writers
- AGENTS.org: removed dead BSP-painter and Agentic-development doc links,
  added Depth buffer doc, LightmappedCompositeShape + TriangleMeshBlock
  to the class catalog, render-pipeline overview now describes the
  radix-sort + two-pass z-buffer flow
- TODO.org: dropped completed 'Add 3D mouse support' (SpaceMouse exists)

No behavior change.

Delete verified dead code (~340 LOC)

Classes unreferenced across engine, tests and all consumer repos
(demos, aukio, aukio-environment-fo4): geometry.Circle,
gui.ViewUpdateTimerTask, gui.humaninput.Connexion3D,
renderer.octree.raytracer.RayHit,
shapes.composite.solid.SolidPolygonMesh,
shapes.composite.wireframe.WireframeDrawing.

Also: ViewPanel.renderExecutor — a thread pool that was created,
resized and shut down but never submitted to; and the write-only
static renderFrameCount counter.

Rename doc/ to Documentation/ and unify version at 1.0.0-SNAPSHOT

- Documentation/ picks up the whole former doc/ tree (org sources,
  diagrams, screenshots); export-docs.sh comments follow
- .gitignore, AGENTS.org and Tools/Update web site updated to the new
  layout (export scan, javadoc staging, graphs, upload)
- pom.xml: 1.5-SNAPSHOT -> 1.0.0-SNAPSHOT; correct <scm> to the
  current hosting URL

initial commit