Pass damage spans through to row rendering in the compositor

evidence/native-damage-span-admission-20261005/SCOPE.md

@@ -0,0 +1,95 @@
+# Keep original damage spans through native paint admission
+
+Source base: merged Text67 d7337ee084f6dcda42cbd8a41c7417e87d60ae78.
+
+`Compositor.render_partial_update` already owns exact nonoverlapping damaged
+horizontal spans. It passes only row membership into `_render_chops`, which
+allocates every cut on each dirty row inside the broad damage union. Separated
+horizontal damage therefore asks intervening foreground content to render;
+`ChopsUpdate` only removes that work later when publishing exact spans.
+
+Use the existing `ChopsUpdate` cut-boundary owner for both compositor admission
+and terminal / Rich publication. Carry original spans through every full,
+partial, inline/export and subtree-capture caller. Preserve layer order,
+wide-cell splitting, source metadata, clipping and exposure. Delete the
+row-only reduction and separate cut-selection calculation. No new map, cache,
+flag, timer, class, scene backend or Toad implementation.
+
+NRA/refactor-audit IMPL-12: one damage/cut relation calculated differently at
+paint admission and publication. AST before/after will cover all native and
+Toad production, test and tool callers, with parsing and dynamic limits explicit.
+
+Source reasoning and complete implementation precede proportionate affected
+controls. Installed saved-history motion/CPU improvement is unqualified. No
+build, environment, installed package, provider or recording purpose exists.
+
+## Working checkpoint
+
+Production: 68a9755b411819090283f180a362bf7659757b01.
+Authored affected App controls: 4b5076efbd4c6f02fa53990e082fee96ed530a07.
+One production file: 29 added / 23 deleted lines against merged Text67.
+
+- `ChopsUpdate._span_cuts` is the sole damaged-span/cut-cell selector.
+  The original Unicode-aware Strip crop remains at final publication.
+- `Compositor._render_chops` admits those original cells before exposure and
+  `Widget.render_lines`; both exposure and strip assignment retain membership
+  in that same admitted chop resource.
+- All four callers migrate: full update, partial update, render_strips (inline /
+  export), and nonzero/negative-origin subtree capture. Full capture and ordinary
+  full update still admit their complete bounds. render_strips retains the
+  original scene row limit when a requested size exceeds the published scene.
+- Deleted the damaged-row predicate and the separate terminal cut-selection
+  algorithm. The existing geometry/cut maps and front-to-back order are intact.
+
+`before.json` covers native production249/tests460 and Toad
+production288/tests397/tools41, all parse omissions0. `after.json` covers the
+changed native production249/tests460, omissions0; unmodified dependency
+consumer evidence is retained at its original pinned source. Four render-chop
+callers, one span-cut declaration, zero old dirty-row predicates. Syntactic AST
+queries do not prove arbitrary runtime rebinding or unregistered external
+private-method consumers.
+
+## Remaining qualification
+
+Native source App scope qualified / Draft; installed behavior unqualified.
+The actual-native App controls check that horizontal damage islands do not render the intervening pane,
+with output parity against the same scene's full strips, including mid-wide-cell
+edges, links and disjoint / overlapping damaged rows. Existing frame resize,
+partial vertical redraw, layered exposure and original subtree-coordinate
+controls cover the other changed callers. The authorized final bounded batch ran once; accepted Text67 controls were not
+part of it. Only two invalid-markup fixture cases were corrected and rerun.
+
+No installed prefix, wheel, UI movie, provider or public mutation was attempted.
+No causal CPU gain, measured cadence, smoothness or whole-workflow readiness is
+claimed. All scene members are still walked to select layered candidates, and
+full-frame cut construction cost is unmeasured; this removes unnecessary content
+painting, not those legitimate traversal/geometry operations.
+
+## Actual source App qualification
+
+- Batch01 source8c4cb3563ae7dc14e84e87edccdd627f583e05d5:
+  14 PASS / 2 FAIL in4.19s, controller5.798375586979091s, exit1.
+  Both failures occurred at App startup because the authored link markup used
+  an unquoted URL, contrary to native Content markup. Original full failure log
+  and source are retained; no damage assertion ran in those two cases.
+- Correction51f1971c2ea29b443ef15764036fa54b3de51c25 changes ONLY that
+  fixture literal to the existing quoted native link declaration. No product
+  bytes or assertions changed. Only those two cases ran: 2 PASS in0.40s,
+  controller1.6918718189699575s, exit0.
+- Thus16 affected cases are qualified across the original batch plus the two
+  corrected cases; this is not a claim of one clean16-case run. Exact production
+  remains68a9755b411819090283f180a362bf7659757b01.
+- Damage islands left the middle native pane unrendered; resulting emitted
+  strips match the same full scene, including link metadata, mid-wide-cell
+  damage, overlap and differing selected rows. Existing partial vertical,
+  layered exposure, resize/old-caption damage, native writer crop, and subtree
+  original-coordinate/capture custody controls also passed.
+
+`source-batch01/02.json` bind their original logs by SHA. Resource readback
+reported10.7GiB available RAM and17.0GiB swap; this was one short sequential
+source batch and its two corrected cases, without a new environment or native
+process/package/SDK/media purpose. No accepted Text67/66 controls were repeated.
+
+Remaining boundary: normal standalone artifact and joined installed saved
+workflow acceptance. No source App control measures CPU, first paint cadence,
+physical input/frame latency, smoothness,144Hz or a global performance gain.