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

src/core/capture/tail_control.h

@@ -1,13 +1,7 @@
 #pragma once
 // tail_control — the REAPER-free logic behind the docked bank_panel's tail-mode
-// toggle. The panel shell (shell/panel/) owns the SWELL window, LICE drawing, and
-// click hit-testing; what is NOT DAW-bound — the cycle order, the manual-length
-// clamp, and the toggle's label text — lives here so it is unit-tested outside the
-// DAW (CLAUDE.md §load-bearing split). Mirror of bank_grid / mode_switch.
-//
-// PURE MODULE: NO REAPER types, NO SWELL, NO vendor/ includes. Standard library
-// only (plus render_settings for the pure TailMode enum). Builds and unit-tests
-// without REAPER.
+// toggle. The panel shell owns the SWELL window, LICE drawing, and click
+// hit-testing; the cycle order, manual-length clamp, and label text live here.
 
 #include <optional>
 #include <string>
@@ -16,54 +10,40 @@
 
 namespace reasampler::capture {
 
-// The Manual-mode starting length. 2 s is a musically useful default tail (a bar of
-// reverb throw at a moderate tempo) that is well under the 8 s cap. Also the value a
-// project with no stored tail setting (older / never-adjusted) falls back to on load.
+// The Manual-mode starting length: 2s, a musically useful default (a bar of
+// reverb throw at moderate tempo), well under the 8s cap. Also the fallback
+// for a project with no stored tail setting.
 inline constexpr double kDefaultManualTailMs = 2000.0;
 
-// The fine-adjust step per scroll-wheel notch in Manual mode. 250 ms is coarse enough
-// that a few notches cover the useful range, fine enough to dial a length precisely.
-// Daniel-set. The panel maps one wheel notch to +/- this many ms via adjustManualMs.
+// Fine-adjust step per scroll-wheel notch in Manual mode. Daniel-set.
 inline constexpr double kManualStepMs = 250.0;
 
-// The panel's current tail setting: the mode plus the length used ONLY when the
-// mode is Manual. Held as in-memory panel/session state (shell/panel), default
-// None so a capture with no explicit choice stays exact-bounds / byte-identical to
-// today. `manualMs` is a stored default a future fine-adjust UI can tune; it is
-// clamped to the 8 s cap (kMaxTailMs) before it ever reaches a CaptureRequest.
+// The panel's current tail setting: mode + the length used only when Manual.
+// Default None so a capture with no explicit choice stays exact-bounds.
+// `manualMs` is clamped to kMaxTailMs before it ever reaches a CaptureRequest.
 struct TailSetting {
     TailMode mode     = TailMode::None;
     double   manualMs = kDefaultManualTailMs;
 };
 
-// Cycles the tail mode: None -> Auto -> Manual -> None. Pure so the wrap order is
-// pinned by a test and the panel's click handler owns no enum arithmetic of its own.
-// An out-of-range value (unreachable for a valid enum) cycles back to None.
+// Cycles the tail mode: None -> Auto -> Manual -> None.
 TailMode cycleTailMode(TailMode current);
 
-// The effective manual length a Manual capture uses: `manualMs` clamped to
-// [0, kMaxTailMs] (the runaway guard the pure tailRenderSettingsFor also applies).
-// Exposed so the panel can show the clamped value and main.cpp hands a pre-clamped
-// tailMs into the CaptureRequest. Meaningful only for TailMode::Manual.
+// The effective manual length a Manual capture uses: clamped to [0, kMaxTailMs].
+// Exposed so the panel can show the clamped value. Meaningful only for Manual.
 double clampManualMs(double manualMs);
 
-// Applies `notches` scroll-wheel steps of `stepMs` each to `current`, clamped to
-// [0, kMaxTailMs]. Positive notches lengthen, negative shorten. Pure so the fine-adjust
-// arithmetic (and its clamp at both bounds) is unit-tested; the panel wheel handler
-// owns no arithmetic of its own. Meaningful only for TailMode::Manual.
+// Applies `notches` scroll-wheel steps of `stepMs` each to `current`, clamped
+// to [0, kMaxTailMs]. Meaningful only for TailMode::Manual.
 double adjustManualMs(double current, int notches, double stepMs);
 
-// The toggle's label for a setting, e.g. "Tail: Off", "Tail: Auto". In Manual mode the
-// clamped length is appended in seconds to one decimal, e.g. "Tail: Manual 2.0s" —
-// Off/Auto carry no length. Pure so the exact strings (and the Manual format) are
-// test-pinned, including the boundary lengths (0.0s, 8.0s).
+// The toggle's label, e.g. "Tail: Off", "Tail: Auto", or (Manual, clamped
+// length to one decimal) "Tail: Manual 2.0s".
 std::string tailToggleLabel(const TailSetting& setting);
 
-// JSON round-trip of a TailSetting (mode + manualMs), for persist to store the tail
-// setting per-project alongside the bank and view model. Kept pure/testable here —
-// the natural home, mirroring bank_model's serialize/deserialize. serialize emits a
-// compact object; deserialize returns std::nullopt on malformed input so the caller
-// (persist) falls back to a default setting, exactly as an absent key does.
+// JSON round-trip of a TailSetting, for persist to store per-project. Pure/
+// testable here, mirroring bank_model's serialize/deserialize; deserialize
+// returns nullopt on malformed input so the caller falls back to a default.
 std::string serializeTailSetting(const TailSetting& setting);
 std::optional<TailSetting> deserializeTailSetting(const std::string& json);