Restore review-flagged comment content cut too aggressively in comment reduction

src/shell/capture/capture.cpp

@@ -50,9 +50,10 @@ namespace {
 
 // The no-dialog render is the built-in action "File: Render project, using the
 // most recent render settings" — command id 42230. Stock main action id, not in
-// reaper_plugin_functions.h, confirmed against a running REAPER. Renders
-// headlessly using whatever RENDER_* settings are currently on the project —
-// why we set them all explicitly first.
+// reaper_plugin_functions.h, so it cannot be verified against the SDK header
+// (offline capture shipping as the default is the empirical evidence it holds).
+// Renders headlessly using whatever RENDER_* settings are currently on the
+// project — why we set them all explicitly first.
 constexpr int kActionRenderUsingMostRecentSettings = 42230;
 
 // RENDER_BOUNDSFLAG 0 = custom time bounds (we set STARTPOS/ENDPOS ourselves
@@ -275,9 +276,10 @@ CaptureResult OfflineRenderBackend::capture(const CaptureRequest& request) {
     // the .rpp location, and is never empty even when unsaved (the original bug —
     // captures landed in REAPER's default media location instead of by the .rpp).
     //
-    // Flow: read .rpp path; if empty, Main_SaveProject(proj, true) prompts
-    // Save-As and blocks until dismissed; re-read; if still empty (cancelled),
-    // refuse with NoProject and write nothing.
+    // Flow: read .rpp path; if empty, Main_SaveProject(proj, true) — true =
+    // forceSaveAsIn — prompts Save-As and (per SDK header) blocks until dismissed,
+    // though that blocking behaviour cannot be verified from the header itself;
+    // re-read; if still empty (cancelled), refuse with NoProject and write nothing.
     auto readRppPath = [&]() -> std::string {
         std::vector<char> buf(4096, '\0');
         EnumProjects(-1, buf.data(), static_cast<int>(buf.size()));

src/shell/capture/capture_orchestrator.cpp

@@ -450,7 +450,7 @@ void RunCancelRealtime(ReaSamplerSession& session)
 // via InsertMedia, undo-wrapped. `conform` selects the explicit opt-in tempo-match
 // variant (never silent — it fires only from the distinct "conform" action). This
 // is the INTENDED placement path: it adds items to the arrange on purpose
-// (CONTEXT.md §load-bearing principle) and runs only from a user-invoked action.
+// (CLAUDE.md §The load-bearing principle) and runs only from a user-invoked action.
 void RunInsertSelected(ReaSamplerSession& session, bool conform)
 {
     InsertRequest req;