Skip to content

feat(ground): complete regional execution result readback #4352

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
d-sorgcodexagent wants to merge 2 commits into from
Closed

feat(ground): complete regional execution result readback #4352

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
10fdac4
feat(rate-of-closure): complete regional result readback
Aug 11, 2026
12fc807
merge(rate-of-closure): propagate evidence UI into result readback
Aug 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 59 additions & 0 deletions AGENT_HANDOFF.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,41 @@
# AGENT_HANDOFF — Tools

## 2026-08-11 PR #4352 current-parent propagation candidate

This no-publish candidate keeps PR `#4352` on
`feat/4271-regional-result-readback` with base
`feat/4271-regional-execution-ui`. Exact current child
`10fdac4860035fd5c845a621752e93688e2e674e` is the first parent and exact
published PR #4351 head `4024c8a1ad2d3871c6b06ef6369250a873789c39`
is the second parent of a normal no-ff merge. The child's complete matched
PyQt6/React qualified result projection remains intact while it inherits the
current bounded evidence import/readback, the explicit Boolean local required
by protected delta-MyPy, embedded-plan execution/provenance and request-I/O
boundaries, complete regional physics ancestry, capability-only extended
finite-float serializer, and default ground safe-number boundary.

Local qualification is green: all `1,057` combined Rate-of-Closure and shared-
ground Python tests, all `113` React files / `697` tests, and the complete Cargo
workspace pass. Focused result/readback/execution/I/O/capability coverage
passes `76` Python and `37` React tests. Pinned Ruff 0.14.10 check/format passes
all three child-delta Python files; isolated-import strict MyPy passes both
child production modules and the coherent 35-module ground profile passes with
inherited imports skipped and only the parent's documented `redundant-cast`
code disabled; Bandit passes both child production files. TypeScript, zero-
warning ESLint, the 202-module Vite build, Rust format and warning-denied
clippy, both 400- and 500-LOC gates, the campaign validator and eight manifest
tests, docs/tool-manifest/blocking-gate/assertion/minimum-test governance,
child-feature and inherited Boolean-local byte checks, marker scans, and diff
checks pass. Existing Hypothesis ignored-cache, polynomial-generator empty-
legend, Node local-storage option, and 523.34 kB Vite chunk warnings remain
non-failing.

No branch has been rebased, retargeted, rewritten, force-pushed, or published.
UI executor invocation, trajectory/event tables, playback, calibration
workflows, compiled regional physics, downstream parity, protected exact-head
evidence, review, approval, dependency integration, release, and issue
completion remain open.

## 2026-08-11 PR #4351 current-parent propagation candidate

This no-publish candidate keeps PR `#4351` on
Expand Down Expand Up @@ -1124,3 +1160,26 @@ independent review is complete. UI construction of a qualified ground request
and settled bounce prefix, executor invocation, playback, measured
calibration, compiled regional physics, downstream parity, protected evidence,
release, and issue completion remain open.

## 2026-08-11 complete regional result readback continuation

Branch `feat/4271-regional-result-readback` is a local unpublished child of
exact draft PR #4351 head
`fe463b5503a8c7b599a329da18bb690d008871cd`. It extends the matched import-only
PyQt6/React readback to every qualified summary/result field required for
honest user inspection: distinct carry/bounce/skid/roll/surface-path/total,
final downrange/offline, bounce count, ground time, terminal completion, model
and surface provider IDs/versions, calibration evidence, observed phases,
typed warnings, executor provenance, and qualification limits.

Null-result cancellation/failure keeps ground-only values unavailable. Partial
evidence retains the censored-endpoint warning and is not relabeled as rest.
No physics, executor invocation, trajectory/event tables, playback, compiled
parity, calibration workflow, or downstream integration is added.

Exact local gates are green: 208 expanded Python ground/plan/PyQt/layout tests,
111 React files / 691 tests, strict MyPy, Ruff/format, TypeScript type-check,
zero-warning ESLint, the 202-module production build, campaign-manifest
validation plus eight manifest tests, documentation governance, module-size
budget, placeholder scan, and diff checks. The build retains the inherited
500 kB chunk advisory. Independently review before any GitHub write.
22 changes: 20 additions & 2 deletions SPEC.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,8 @@
| **Owner** | D-sorganization |
| **Primary Language(s)** | Python 3.11+, Rust, JavaScript, TypeScript |
| **License** | MIT |
| **Current Version** | 1.14.37 |
| **Spec Version** | 1.14.37 |
| **Current Version** | 1.14.38 |
| **Spec Version** | 1.14.38 |
| **Last Spec Update** | 2026-08-11 |

## 2. Purpose & Mission
Expand All @@ -46,6 +46,22 @@ Comprehensive monorepo housing 45+ utility tools for data processing, scientific

## 3. Goals & Non-Goals

### 2026-08-11 Complete Regional Execution Result Readback

- The matched PyQt6 and React evidence readers project every already-qualified
ground summary field without recomputation: carry, bounce-air, skid, roll,
surface-path, total, final downrange/offline, bounce count, ground time,
terminal completion, model and base-surface provider identities, calibration
evidence, ordered observed phases, typed warnings, executor provenance, and
qualification limitations.
- Null-result cancellation/failure evidence keeps all ground-only values
unavailable and emits no fabricated phases, warnings, calibration, times, or
distances. Partial results retain their censored-endpoint warning and are not
presented as final-rest outcomes.
- PyQt6 uses a readable scrollable readback while React uses an accessible
definition list and warning list. Both remain import-only consumers of the
frozen Python executor envelope; this slice does not add playback or physics.

### 2026-08-11 Regional Execution Evidence Readback

- Matched PyQt6 and React regional-plan surfaces can import a bounded strict
Expand Down Expand Up @@ -2978,6 +2994,8 @@ Active development with stable core, continuous tool expansion, and web API in p

| Date | Version | Changes |
| ---- | ------- | ------- |
| 2026-08-11 | 1.14.38 | merge(rate-of-closure, #4271 #4352): normally merge exact current regional-result readback child `10fdac4860035fd5c845a621752e93688e2e674e` first with exact published PR #4351 parent `4024c8a1ad2d3871c6b06ef6369250a873789c39` second without changing the `feat/4271-regional-execution-ui` base; preserve the complete matched PyQt6/React qualified result projection, parent bounded evidence import/readback, the explicit Boolean local required by protected delta-MyPy, embedded-plan execution/provenance and request-I/O boundaries, complete regional physics ancestry, default ground safe-number contract, capability-only extended finite-float policy, and all append-only handoff/SPEC/manifest history; keep UI executor invocation, trajectory/event tables, playback, calibration workflows, compiled regional physics, downstream parity, protected exact-head evidence, review, approval, release, and issue completion open. |
| 2026-08-11 | 1.14.36 | feat(ground-roll, #4267 #4271): complete the matched PyQt6/React import-only result projection with carry, bounce-air, skid, roll, surface-path, total, final position/offline, bounce count, ground time, terminal completion, model and surface-provider identity/version, calibration evidence, ordered observed phases, typed warnings, executor provenance, and qualification limits; preserve unavailable ground-only values for null-result cancellation/failure and keep partial censored endpoints explicit; retain UI executor invocation, trajectory/event tables, playback, calibration workflows, compiled parity, downstream parity, protected evidence, release, and issue completion as open work. |
| 2026-08-11 | 1.14.37 | merge(rate-of-closure, #4271 #4351): normally merge exact current regional-execution UI child `351a3051e9093c6b80cabf0f1db04aeeb15abfac` first with exact published PR #4350 parent `98f86990e9225903fbe84cd1f267ed38ef0a15d8` second without changing the `feat/4271-regional-execution-binding` base; preserve matched bounded PyQt6/React evidence import and readback, the explicit Boolean local required by protected delta-MyPy, the embedded-plan execution/provenance boundary, request I/O, full regional physics ancestry, default ground safe-number contract, capability-only extended finite-float policy, and all append-only handoff/SPEC/manifest history; keep UI executor invocation, playback, compiled regional physics, downstream parity, protected exact-head evidence, review, approval, release, and issue completion open. |
| 2026-08-11 | 1.14.36 | fix(rate-of-closure, #4351): make the regional request atomic-write return boundary stable under the protected changed-file MyPy profile by assigning the skipped imported helper result to an explicit Boolean local; avoid both `no-any-return` and a root-set-dependent redundant cast without changing runtime behavior. |
| 2026-08-11 | 1.14.36 | merge(ground-roll, #4271 #4350): normally merge exact current regional-execution child `dfb4b97481f187ff3594eceb08c427f650aca4e3` first with exact published PR #4342 parent `de66a851aa5dded680279cf9a2b25a5094966593` second without changing the `feat/4274-regional-plan-io` base; preserve the embedded-plan execution/provenance envelope, executor authority, transition-to-plan binding, cross-runtime fixtures, parent request I/O, matched editors, complete regional physics ancestry, default ground safe-number boundary, and capability-only extended finite-float serializer while retaining all append-only handoff, SPEC, and manifest history; keep execution UI/playback, compiled regional physics, downstream parity, protected exact-head evidence, review, approval, release, and issue completion open. |
Expand Down
58 changes: 58 additions & 0 deletions docs/development/RATE_OF_CLOSURE_CAMPAIGN_HANDOFF.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,40 @@
# Rate of Closure Ball-Flight Campaign Handoff

## 2026-08-11 PR #4352 current-parent propagation candidate

- PR `#4352` retains branch `feat/4271-regional-result-readback` and base
`feat/4271-regional-execution-ui`. Exact current child
`10fdac4860035fd5c845a621752e93688e2e674e` is first and exact published PR
#4351 head `4024c8a1ad2d3871c6b06ef6369250a873789c39` is second in a normal
no-ff merge.
- The child retains its complete matched PyQt6/React qualified result
projection while inheriting bounded evidence import/readback, the explicit
Boolean local required by protected delta-MyPy, embedded-plan execution and
provenance, request I/O, complete regional physics ancestry, the capability-
only extended finite-float serializer, and default ground safe-number
boundary.
- Local qualification passes all `1,057` combined Rate/shared-ground Python
tests, all `113` React files / `697` tests, the complete Cargo workspace,
`76` focused Python result/readback/execution/I/O/capability tests, and `37`
focused React tests. Pinned Ruff 0.14.10 check/format passes three child-delta
Python files; isolated-import strict MyPy passes both child production
modules and the coherent 35-module ground profile passes with inherited
imports skipped and only the parent's documented `redundant-cast` code
disabled; Bandit passes both production files. TypeScript, zero-warning
ESLint, the 202-module Vite build, Rust format and warning-denied clippy, both
LOC gates, the campaign validator and eight manifest tests,
docs/tool-manifest/blocking-gate/assertion/minimum-test governance, child-
feature and inherited Boolean-local byte checks, marker scans, and diff
checks pass. Existing Hypothesis ignored-cache, polynomial-generator empty-
legend, Node local-storage option, and 523.34 kB Vite chunk warnings remain
non-failing.
- The candidate has not been rebased, retargeted, rewritten, force-pushed, or
published and remains `not_released`.
- UI executor invocation, trajectory/event tables, playback, calibration
workflows, compiled regional physics, downstream parity, protected exact-
head evidence, review, approval, dependency integration, release, and issue
completion remain open.

## 2026-08-11 PR #4351 current-parent propagation candidate

- PR `#4351` retains branch `feat/4271-regional-execution-ui` and base
Expand Down Expand Up @@ -1902,3 +1937,26 @@ production build, manifest and eight manifest tests, docs governance,
structural budgets, and diff checks. The inherited 500 kB build advisory
remains. Complete an independent audit before publication; then create a normal
stacked draft child without retargeting or rewriting PR #4350.

## 2026-08-11 Complete regional result readback continuation

Local branch `feat/4271-regional-result-readback` starts exactly at draft PR
#4351 head `fe463b5503a8c7b599a329da18bb690d008871cd`. The next bounded result-
usability slice makes matched PyQt6/React evidence inspection complete for the
existing frozen result: carry, bounce-air, skid, roll, surface path, total,
final downrange/offline, bounce count, ground time, completion, model and
surface-provider identities/versions, calibration evidence, ordered observed
phases, typed warnings, executor provenance, and qualification limits.

Cancellation/failure cannot fabricate ground-only values, and partial results
remain visibly censored. React still executes no ground physics. Trajectory and
event tables, export/playback, executor input construction/invocation, measured
calibration, compiled parity, Upstream consumers, protected evidence, release,
and issue completion remain open.

Exact local gates are green: 208 expanded Python ground/plan/PyQt/layout tests,
111 React files / 691 tests, strict MyPy, Ruff/format, TypeScript type-check,
zero-warning ESLint, the 202-module production build, campaign-manifest
validation plus eight manifest tests, documentation governance, module-size
budget, placeholder scan, and diff checks. The inherited 500 kB build advisory
remains. Independent review is required before publication.
19 changes: 15 additions & 4 deletions docs/release/rate_of_closure_campaign.v1.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -264,7 +264,17 @@
"pr": 4351,
"branch": "feat/4271-regional-execution-ui",
"base_branch": "feat/4271-regional-execution-binding",
"head_sha": "351a3051e9093c6b80cabf0f1db04aeeb15abfac",
"head_sha": "4024c8a1ad2d3871c6b06ef6369250a873789c39",
"state": "open",
"merge_commit_sha": null,
"protection_evidence": "not_recorded"
},
{
"id": "pr-4352",
"pr": 4352,
"branch": "feat/4271-regional-result-readback",
"base_branch": "feat/4271-regional-execution-ui",
"head_sha": "10fdac4860035fd5c845a621752e93688e2e674e",
"state": "open",
"merge_commit_sha": null,
"protection_evidence": "not_recorded"
Expand Down Expand Up @@ -1272,7 +1282,8 @@
"pr-4335",
"pr-4339",
"pr-4342",
"pr-4350"
"pr-4350",
"pr-4351"
],
"supported_surfaces": {
"tools.pyqt6": "implemented_unverified",
Expand All @@ -1289,12 +1300,12 @@
"ground-regional-ui-helper-local-d217",
"ground-regional-io-local-8e1c"
],
"evidence_gap": "The contract, flight-transfer, impact/bounce, static-plane skid/roll, regional-surface, regional-plan wire, regional-editor, regional request-I/O, and regional execution carriers remain open on draft PRs 4285, 4288, 4302, 4304, 4332, 4335, 4339, 4342, and 4350. A local unpublished child adds matched PyQt6/React import-only readback of exact plan-bound Python execution evidence. Fresh protected evidence for the reconciled heads, UI executor invocation/playback, workspace model-input persistence, measured calibration, changing geometry, compiled-runtime physics, and downstream parity remain absent.",
"evidence_gap": "The contract, flight-transfer, impact/bounce, static-plane skid/roll, regional-surface, regional-plan wire, regional-editor, regional request-I/O, regional execution, and evidence-readback carriers remain open on draft PRs 4285, 4288, 4302, 4304, 4332, 4335, 4339, 4342, 4350, and 4351. A local unpublished child completes matched summary/result inspection, warnings, phase presence, calibration evidence, and provider identity without browser physics. Fresh protected evidence for the reconciled heads, UI executor invocation, trajectory/event tables, export/playback, workspace model-input persistence, measured calibration, changing geometry, compiled-runtime physics, and downstream parity remain absent.",
"limitations": [
"Airborne flight must first terminate against physical terrain and preserve terminal angular velocity.",
"Current UpstreamDrift terrain and putting implementations are reference inputs rather than the qualified authority.",
"The #4270 rigid impact law does not consume firmness, grass, compressibility, moisture, or rolling-resistance fields.",
"Published open PR #4304 qualifies one immutable planar profile and optional finite tangent-axis edge; open PR #4332 adds bounded coplanar material overlays; open PR #4335 adds a strict Python/TypeScript plan wire boundary and Python resolver; open PR #4339 adds matched PyQt6/React request editors; open PR #4342 adds editor-qualified canonical request import/export with native atomic semantics and explicit browser limitations; and open PR #4350 adds UI-neutral Python execution plus an embedded-plan-bound result/provenance envelope with validated transition crossings. A local child adds matched import-only execution evidence readback. Changing normals, height or velocity discontinuities, terrain deformation, torsional-spin damping, roll-to-skid transitions, UI executor invocation/playback, measured calibration, workspace model-input persistence, compiled or TypeScript regional physics, and downstream adapters remain unimplemented."
"Published open PR #4304 qualifies one immutable planar profile and optional finite tangent-axis edge; open PR #4332 adds bounded coplanar material overlays; open PR #4335 adds a strict Python/TypeScript plan wire boundary and Python resolver; open PR #4339 adds matched PyQt6/React request editors; open PR #4342 adds editor-qualified canonical request import/export with native atomic semantics and explicit browser limitations; open PR #4350 adds UI-neutral Python execution plus an embedded-plan-bound result/provenance envelope with validated transition crossings; and open PR #4351 adds matched strict plan-bound evidence import/readback. A local child completes all frozen summary/result fields, warnings, calibration, provider identity, and observed-phase readback. Changing normals, height or velocity discontinuities, terrain deformation, torsional-spin damping, roll-to-skid transitions, UI executor invocation, trajectory/event tables, export/playback, measured calibration, workspace model-input persistence, compiled or TypeScript regional physics, and downstream adapters remain unimplemented."
],
"depends_on_issues": [
4191
Expand Down
Loading
Loading