[1.0.0] Scope freeze: reconcile dark corners

[brendancol]

Scope freeze: reconcile dark corners before 1.0.0

1.0.0 freezes the public surface to the README feature matrix. Before the freeze we resolve every function that lives in the code but is not cleanly accounted for in the matrix: either promote it (export from xrspatial/__init__.py and document it in the matrix) or drop it from the public surface (mark private or keep experimental). Each group tracking issue blocks its "Scope frozen" checkbox on the relevant decisions here.

Multispectral indices (in README, not exported) — xrspatial/multispectral.py

• gci: promote or drop
• ebbi: promote or drop
• nbr2: promote or drop
• true_color: promote or drop

Focal (in README, not exported) — xrspatial/focal.py

• apply: promote or drop
• hotspots (Getis-Ord Gi*): promote or drop. Distinct from the exported emerging_hotspots.
• focal_stats: promote or drop

Experimental — xrspatial/experimental/min_observable_height.py

• min_observable_height: keep experimental, promote, or drop

Exported but underdocumented in the matrix

• diagnose (xrspatial/diagnostics.py): document or mark internal
• hypsometric_integral (xrspatial/zonal.py): document or mark internal
• suggest_zonal_canvas (xrspatial/zonal.py): document or mark internal
• clip_polygon (xrspatial/polygon_clip.py): document or mark internal

LTS commitment

• Declare the xrspatial/__init__.py high-level spellings and the .xrs accessor as LTS. See the stability policy doc and Epic: Library-wide feature tiers and production-readiness contract #2415.

Re-sweep currency (process)

• Approved current models: opus-4.x, gpt-5.5. A sweep field is set to Clear only after a fresh /deep-sweep <module> by a current model finds no new CRITICAL/HIGH. Record Last swept = <model> <date> on the item.
• One fix per PR for sweep findings.
• When a newer frontier model ships, add it to the approved list. The "Stale sweeps" board view then surfaces every group whose Last swept predates it, and those re-enter sweeping. A Clear is provisional until re-swept by the newest model.