Cut core/capture and core/version comment bloat ~45% (comments only, zero code change)

src/core/capture/batch_capture.h

@@ -1,29 +1,24 @@
 #pragma once
-// batch_capture — the REAPER-free logic behind M11 batch capture (one action fires
-// N captures: one bank sample per selected item / per razor area).
+// batch_capture — the REAPER-free logic behind batch capture (one action fires N
+// captures: one bank sample per selected item / per razor area).
 //
-// PURE MODULE (CLAUDE.md §load-bearing split): NO REAPER types, NO SWELL, NO
-// vendor/ includes. Standard library only. The batch shell (main.cpp) reads the DAW
-// state (selected items -> their exact bounds; every track's P_RAZOREDITS -> areas)
-// and hands the raw ranges here so the genuinely-pure, easy-to-get-wrong pieces are
-// unit-tested outside the DAW:
+// PURE MODULE: NO REAPER types, NO SWELL, NO vendor/ includes. Standard library
+// only. The batch shell reads the DAW state (selected items -> exact bounds;
+// each track's P_RAZOREDITS -> areas) and hands the raw ranges here:
 //
-//   1. planCaptureUnits: an ordered list of (start,end) source ranges -> an ordered
-//      list of CaptureUnit, each carrying its 1-based ordinal and validated bounds.
-//      Empty/inverted ranges are DROPPED (mirrors the offline backend's own
-//      end>start guard) so a zero-length item/area never produces a stray render.
-//      Order is preserved: unit ordinals count only the KEPT units, so a batch of
-//      three valid items yields ordinals 1,2,3 regardless of dropped neighbors.
-//   2. BatchOutcome: order-preserving aggregation of per-unit results into a summary
-//      (succeeded / failed counts + the ordered list of failures) so the shell can
-//      report a mixed result with one console line and no partial-corruption
-//      ambiguity. The AGGREGATION is pure; the render loop that feeds it is shell.
+//   1. planCaptureUnits: an ordered list of (start,end) ranges -> an ordered
+//      list of CaptureUnit, each with a 1-based ordinal and validated bounds.
+//      Empty/inverted ranges are dropped (mirrors the offline backend's own
+//      end>start guard); ordinals count only the kept units, so three valid
+//      items yield 1,2,3 regardless of dropped neighbors.
+//   2. BatchOutcome: order-preserving aggregation of per-unit results into a
+//      summary (succeeded/failed counts + ordered failures) for one console
+//      line with no partial-corruption ambiguity.
 //
-// Range is the ONLY thing that varies per unit here. FX scope (item vs track) is a
-// per-ACTION constant the shell already owns (fxBypassPlanFor); it is not a
-// per-unit field. Item-batch uses item scope; razor-batch uses track scope — the
-// shell passes the scope straight through to each render, unchanged from the
-// single-capture path.
+// Range is the only thing that varies per unit here. FX scope (item vs track) is
+// a per-action constant the shell already owns; item-batch uses item scope,
+// razor-batch uses track scope, passed through unchanged from the single-capture
+// path.
 
 #include <cstddef>
 #include <string>
@@ -31,10 +26,10 @@
 
 namespace reasampler::capture {
 
-// One capture in a batch: an exact source range plus its 1-based ordinal within the
-// KEPT set. The ordinal disambiguates per-unit file stems (the offline backend's
-// unique tag is 1-second-granular, so a fast batch could otherwise collide N files
-// onto one name) and labels a failure in the summary.
+// One capture in a batch: an exact source range plus its 1-based ordinal within
+// the kept set. The ordinal disambiguates per-unit file stems (the offline
+// backend's unique tag is 1-second-granular, so a fast batch could otherwise
+// collide N files onto one name) and labels a failure in the summary.
 struct CaptureUnit {
     int    ordinal      = 0;    // 1-based, counts kept units only
     double startSeconds = 0.0;  // exact — no rounding
@@ -42,20 +37,18 @@ struct CaptureUnit {
 };
 
 // A source range handed in by the shell (a selected item's [pos, pos+len] or one
-// razor area's [start, end]). Kept as a distinct type from CaptureUnit so the input
-// (raw, possibly-invalid) and the output (validated, ordinal-assigned) do not share
-// a shape by accident. Named BatchRange (not SourceRange) to avoid collision with
-// bank_model's SourceRange, which carries PPQ fields this planner does not need.
+// razor area's [start, end]). Named BatchRange (not SourceRange) to avoid
+// collision with bank_model's SourceRange, which carries PPQ fields this planner
+// doesn't need.
 struct BatchRange {
     double startSeconds = 0.0;
     double endSeconds   = 0.0;
 };
 
 // Validates + orders a batch's source ranges into capture units. Preserves input
-// order; DROPS every range with end <= start (empty/inverted) so no stray render is
-// planned; assigns 1-based ordinals over the KEPT units. An empty input (no selected
-// item / no razor area) yields an empty plan — the shell reports "nothing to batch"
-// and writes nothing (the same no-op posture the single-capture path takes).
+// order; drops every range with end <= start; assigns 1-based ordinals over the
+// kept units. An empty input yields an empty plan — the shell reports "nothing
+// to batch" and writes nothing.
 std::vector<CaptureUnit> planCaptureUnits(const std::vector<BatchRange>& ranges);
 
 // The per-unit verdict the shell records after each render attempt, in unit order.
@@ -65,10 +58,9 @@ struct BatchUnitResult {
     std::string detail;          // failure reason (empty on success) — for the summary
 };
 
-// Order-preserving aggregation of a batch's per-unit results. Built incrementally by
-// the shell (record() after each unit) so a mid-batch failure is captured without
-// aborting the remaining units (no partial corruption: each unit is independent, and
-// the selection is restored on every exit path by the shell's RAII guard).
+// Order-preserving aggregation of a batch's per-unit results. Built incrementally
+// by the shell (record() after each unit) so a mid-batch failure doesn't abort
+// the remaining units — each unit is independent.
 class BatchOutcome {
 public:
     // Records one unit's verdict. Order of calls IS the reported order.