CHANGELOG - libstereo_bolt selected4 delivery
================================================

## 2026-07-10 selected4-v2

Packaging and acceptance:
- Added the eight original 12 MP BMP files for frames 19, 20, 28 and 43
  under validation/inputs/.
- Added validation/run_selected4.sh for package-local manifest, dependency,
  precise-interface and ranging-interface verification on RK3588.
- Updated installation commands so no external sample path is required.
- Added validation/selected4_package_reverify.log captured on RK3588 while
  running only the files extracted from this delivery package.
- Added the explicit config/config.rk3588.selected4.top_plane.yaml alias,
  SELECTED4_PROVENANCE.txt and an RK3588 c_example_centerline binary.
- The one-click test now exercises both sb_create(YAML) and sb_create_ex(model
  bytes) before accepting the package.
- Fixed c_example_centerline to preserve its success return code before freeing
  the result structure; its previous post-free check incorrectly returned 3
  after printing a successful eight-bolt result.

## 2026-07-09 selected4-v1

Scope:
- Fixed validation set: frames 19, 20, 28 and 43 from the 7.3 stereo data.
- New RKNN model: obb_plus_halcon_seg_1024_fp16.rknn.
- Precise and ranging interfaces use the same four stereo pairs for acceptance.

Algorithm and interface:
- Complete cap far/near edge-pair evidence now outranks an isolated one-eye
  gradient when selecting the bolt top.
- Cap-pair stereo tolerance scales with bolt width; candidates outside the
  original trusted band remain explicitly suspect.
- Plane height is measured along the fitted bolt axis to the support-plane
  intersection. The selected4 plane-anchor standard-deviation gate is 20 mm.
- StereoBoltParamsC appends support-plane controls at the tail. struct_size
  keeps callers using the previous shorter struct compatible.

RK3588 acceptance:
- Frames 19/20/28/43: left YOLO=8, right YOLO=8, pairs=8,
  precise bolts=8 and ranging bolts=8 for every frame.
- Local WSL tests: 28/28 passed.
- Exact logs and input hashes are under validation/.

## Historical baseline retained

- 2026-07-01 v4: precise partial-output contract rejects left-only product heights.
- 2026-07-01 v3: stable OBB-axis ranging summary and pairing-swap repair.
- 2026-06-30 v2: OBB model route and optional plane-skip optimization.