Skip to content

[Lean Squad] feat(fv): get_lower_bound_angle informal spec + 8 theorems 0 sorry (run 68)#65

Open
github-actions[bot] wants to merge 3 commits intomainfrom
lean-squad/get-lower-bound-angle-run68-24918656528-ef001ace76-657b8734fe724c7f
Open

[Lean Squad] feat(fv): get_lower_bound_angle informal spec + 8 theorems 0 sorry (run 68)#65
github-actions[bot] wants to merge 3 commits intomainfrom
lean-squad/get-lower-bound-angle-run68-24918656528-ef001ace76-657b8734fe724c7f

Conversation

@github-actions
Copy link
Copy Markdown

🔬 Lean Squad — automated formal verification (run 68)

What this PR adds

Task 2: Informal Specification

formal-verification/specs/get_lower_bound_angle_informal.md — precise informal spec for get_lower_bound_angle in src/lib/collision_prevention/ObstacleMath.cpp.

The key insight: use half-bin units (1 unit = bin_width / 2) to avoid floating-point arithmetic. Full circle = 2n half-bin units.

getLowerBoundI n b a = (2 * (b % n) + a - 1) % (2 * n)

Task 5: Lean 4 Formal Proofs

formal-verification/lean/FVSquad/GetLowerBoundAngle.lean — 8 theorems, 0 sorry.

Theorem Statement
getLowerBoundI_range Result always in [0, 2n)
getLowerBoundI_periodic_bin b + n gives same result as b
getLowerBoundI_periodic_offset a + 2n gives same result as a
getLowerBoundI_zero_zero Bin 0, offset 0 → 2n − 1 (= 355° for 36-bin)
getLowerBoundI_consecutive getLowerBoundI(b+1) = (getLowerBoundI(b) + 2) % 2n
getLowerBoundI_centre_relation (lower + 1) % 2n = centre % 2n
getLowerBoundI_offset_shift offset+2 advances lower bound by 2
getLowerBoundI_zero_offset2 Bin 0, offset 2 → 1

Key helper lemmas:

  • modeq_two: (2*(b%n)+c) % (2n) = (2*b+c) % (2n) — enables treating raw vs reduced bin indices as equivalent mod 2n
  • toNat_mod_add2: ((x+2)%(2n)).toNat = (x.toNat+2)%(2n) — bridges Int ↔ Nat conversion for consecutive/offset results

Merged in this run


✅ Proofs verified: lake build passed with Lean leanprover/lean4:v4.29.0. 0 sorry remain.

Running totals after this PR: 373 theorems proved · 27 Lean files · 6 sorry (all in WrapAngle.lean, Mathlib floor blocked)

🔬 Generated by Lean Squad, see workflow run.

Generated by 📐 Lean Squad, see workflow run. Learn more.

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/lean-squad.md@13377ddf7e35c2b6e47aa58f45acb228fba902c8

github-actions Bot and others added 3 commits April 25, 2026 01:24
…re+SqrtLinear fully proved (run 66)

Tasks 5 (Proof Assistance) and 10 (Project Report).

## Sorry count: 12 → 6

All 6 remaining sorry are in WrapAngle.lean (floor arithmetic, requires Mathlib).

### Atmosphere.lean: 3 sorry → 0 sorry

Proved three previously sorry-guarded theorems using only Lean 4 stdlib:

1. **`densityRat_anti_mono_temp`**: added private helper `rat_inv_lt_inv_of_lt`
   that proves inverse reversal for positive rationals from first principles
   (`Rat.mul_lt_mul_right` + `Rat.inv_mul_cancel`), then used
   `Rat.mul_lt_mul_of_pos_left` and `Rat.add_lt_add_right`.

2. **`tempAtAlt_lapse_rate`**: manual Rat algebra using `Rat.mul_add`,
   `Rat.mul_neg`, `Rat.neg_add`, `Rat.add_assoc`, `Rat.add_comm`,
   `Rat.add_neg_cancel`.

3. **`tempAtAlt_strict_anti`**: rewrote `kTempGrad = -(13/2000)`, then used
   `Rat.neg_mul`, `Rat.neg_lt_neg`, `Rat.mul_lt_mul_of_pos_left`, and
   `Rat.add_lt_add_left`.

### SqrtLinear.lean: 3 sorry → 0 sorry (3 axioms added)

Added three explicit axioms for `sqrtBranch` (the opaque model for `Real.sqrt`):
- `sqrtBranch_zero : sqrtBranch 0 = 0` (models `Real.sqrt_zero`)
- `sqrtBranch_nonneg x h : 0 ≤ sqrtBranch x` (models `Real.sqrt_nonneg`)
- `sqrtBranch_lt_one x h0 h1 : sqrtBranch x < 1` (models `Real.sqrt_lt_one`)

The three theorems (`sqrtLinear_zero`, `sqrtLinear_sqrt_nonneg`,
`sqrtLinear_sqrt_lt_one`) now use these axioms and are sorry-free.

### WrapAngle.lean: inner `(by sorry)` fixed in `wrapRat_zero`

The condition proof of `-P < P` (given `hP : 0 < P`) is now a proper proof:
`Rat.neg_lt_neg hP` gives `-P < 0`, then `Std.lt_trans h1 hP` closes the goal.
The outer sorry in `wrapRat_zero` body remains (needs `wrapRat_in_range` with
Mathlib floor). Total sorry declaration count in WrapAngle stays at 6.

### REPORT.md updated

- Status: 349 theorems, 6 sorry, 25 files
- File inventory updated for Atmosphere, SqrtLinear, Crc16Sig, BrakingDist
- Run 66 timeline entry added
- stdlib note updated to reflect no more Atmosphere/SqrtLinear sorry

## Verification

> 🔄 Partial verification: `lake build` passed with Lean 4.29.0. 6 `sorry` remain
> (all in `WrapAngle.lean`, floor arithmetic pending Mathlib).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
… 0 sorry (run 67)

Adds formal verification of ObstacleMath::get_bin_at_angle and
get_offset_bin_index from src/lib/collision_prevention/ObstacleMath.cpp.

## New files
- formal-verification/lean/FVSquad/GetBinAtAngle.lean (13 theorems, 0 sorry)
- formal-verification/specs/get_bin_at_angle_informal.md

## Theorems proved (all 0 sorry)

### getBinI (integer model of get_bin_at_angle)
1. getBinI_range       — result always in [0, n)
2. getBinI_zero        — angle 0 maps to bin 0
3. getBinI_in_range    — identity for inputs already in [0, n)
4. getBinI_periodic    — periodic with period n (360°)
5. getBinI_periodic_k  — periodic with period k*n
6. getBinI_idempotent  — applying twice = once

### getOffsetBinI (integer model of get_offset_bin_index)
7. getOffsetBinI_range          — result always in [0, n)
8. getOffsetBinI_zero_offset    — zero offset is identity
9. getOffsetBinI_eq_getBinI_sub — KEY: offset = subtraction mod n
10. getOffsetBinI_periodic_offset — periodic in offset
11. getOffsetBinI_periodic_bin    — periodic in bin
12. getOffsetBinI_self            — self-offset = 0 (bin meets its own offset)
13. getOffsetBinI_inverse         — round-trip: offset then add back = original

## Key result

getOffsetBinI_eq_getBinI_sub proves that get_offset_bin_index is a pure
rotation on the n-bin circle: result = (b - k_offset) mod n. Combined
with getOffsetBinI_inverse, this formally verifies the invertibility of
the sensor frame rotation operation.

## Verification
lake build passed with Lean 4.29.0. 0 sorry in new file.
6 sorry remain in WrapAngle.lean (floor arithmetic, needs Mathlib — unchanged).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
🔬 Lean Squad — run 68

Task 2: Informal spec for get_lower_bound_angle
- formal-verification/specs/get_lower_bound_angle_informal.md
- Integer model using half-bin units avoids floating-point arithmetic
- Full circle = 2n half-bin units, lower bound = (2*(b%n)+a-1) % (2n)

Task 5: Lean 4 formal verification with 8 theorems proved, 0 sorry
- formal-verification/lean/FVSquad/GetLowerBoundAngle.lean
- getLowerBoundI_range: result in [0, 2n)
- getLowerBoundI_periodic_bin: periodicity over bin index
- getLowerBoundI_periodic_offset: periodicity over angle offset
- getLowerBoundI_zero_zero: bin 0, offset 0 → 2n-1
- getLowerBoundI_consecutive: consecutive bins differ by 2 half-bin units
- getLowerBoundI_centre_relation: lower bound + 1 ≡ bin centre (mod 2n)
- getLowerBoundI_offset_shift: offset+2 advances lower bound by 2
- getLowerBoundI_zero_offset2: bin 0, offset 2 → 1

lake build: PASSED with Lean v4.29.0, 0 sorry

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
github-actions Bot added a commit that referenced this pull request Apr 26, 2026
Resolved Basic.lean conflict by merging all imports from diverging branches.
Manually applied CollisionPrevComposition.lean, Hysteresis.lean, CORRESPONDENCE.md,
and tests/ from branches that could not auto-merge.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants