Add fine-grained Win startup constructor tracing

Author: secup

src/gui/audio_engine.cpp

@@ -1,14 +1,17 @@
 #define _USE_MATH_DEFINES  // For M_PI on MSVC
 #include <cmath>
 #include "audio_engine.hpp"
+#include "gui/startup_trace.hpp"
 #include "ultra/logging.hpp"
 #include <cstring>
 #include <algorithm>
 
 namespace ultra {
 namespace gui {
 
-AudioEngine::AudioEngine() = default;
+AudioEngine::AudioEngine() {
+    startupTrace("AudioEngine", "ctor");
+}
 
 AudioEngine::~AudioEngine() {
     shutdown();

src/gui/main_gui.cpp

@@ -2,6 +2,7 @@
 // Uses Dear ImGui with SDL2 + OpenGL 2.1 for maximum compatibility
 
 #include "app.hpp"
+#include "startup_trace.hpp"
 
 #include "imgui.h"
 #include "imgui_impl_sdl2.h"
@@ -150,6 +151,9 @@ LONG WINAPI startupUnhandledExceptionFilter(EXCEPTION_POINTERS* ex) {
 int main(int argc, char* argv[]) {
     initStartupLog();
 #ifdef _WIN32
+    if (!g_startup_log_path.empty()) {
+        _putenv_s("ULTRA_STARTUP_LOG", g_startup_log_path.c_str());
+    }
     SetUnhandledExceptionFilter(startupUnhandledExceptionFilter);
 #endif
     std::set_terminate([]() {

src/gui/modem/modem_engine.cpp

@@ -2,6 +2,7 @@
 // Constructor, destructor, configuration, and TX functions
 
 #include "modem_engine.hpp"
+#include "gui/startup_trace.hpp"
 #include "ultra/logging.hpp"
 #include <cstring>
 #include <algorithm>
@@ -12,7 +13,9 @@ namespace ultra {
 namespace gui {
 
 ModemEngine::ModemEngine() {
+    startupTrace("ModemEngine", "ctor-enter");
     config_ = presets::balanced();
+    startupTrace("ModemEngine", "presets-balanced");
 
     // CRITICAL: Disable pilots for DQPSK mode - uses all 30 carriers for data
     // This doubles throughput (30 data carriers vs 15 with pilots)
@@ -36,6 +39,7 @@ ModemEngine::ModemEngine() {
     chirp_cfg.use_dual_chirp = true; // Enable dual chirp for CFO estimation
     chirp_cfg.tx_cfo_hz = config_.tx_cfo_hz;  // Pass TX CFO for simulation
     chirp_sync_ = std::make_unique<sync::ChirpSync>(chirp_cfg);
+    startupTrace("ModemEngine", "chirp-sync-created");
 
     // Multi-Carrier DPSK (for fading channels - frequency diversity)
     // Using level8: 8 carriers, 93.75 baud, DQPSK (~735 bps)
@@ -50,16 +54,20 @@ ModemEngine::ModemEngine() {
 
     // Initialize StreamingEncoder (unified TX path)
     streaming_encoder_ = std::make_unique<StreamingEncoder>();
+    startupTrace("ModemEngine", "streaming-encoder-created");
     streaming_encoder_->setOFDMConfig(config_);
     streaming_encoder_->setMCDPSKCarriers(mc_dpsk_config_.num_carriers);
+    startupTrace("ModemEngine", "streaming-encoder-configured");
 
     // Initialize audio filters
     rebuildFilters();
+    startupTrace("ModemEngine", "filters-built");
 
     // ========================================================================
     // Initialize StreamingDecoder (primary RX path)
     // ========================================================================
     streaming_decoder_ = std::make_unique<StreamingDecoder>();
+    startupTrace("ModemEngine", "streaming-decoder-created");
     streaming_decoder_->setLogPrefix(log_prefix_);
 
     // Set callbacks to wire into existing ModemEngine callbacks
@@ -99,15 +107,18 @@ ModemEngine::ModemEngine() {
     // When connected, use the negotiated waveform
     protocol::WaveformMode decoder_mode = connected_ ? waveform_mode_ : protocol::WaveformMode::MC_DPSK;
     streaming_decoder_->setMode(decoder_mode, connected_);
+    startupTrace("ModemEngine", "decoder-mode-set");
 
     // Sync MC-DPSK carrier count with ModemEngine's config
     streaming_decoder_->setMCDPSKCarriers(mc_dpsk_config_.num_carriers);
+    startupTrace("ModemEngine", "decoder-carriers-set");
 
     LOG_MODEM(INFO, "[%s] StreamingDecoder initialized (MC-DPSK: %d carriers)",
               log_prefix_.c_str(), mc_dpsk_config_.num_carriers);
 
     // Defer RX decode thread startup until audio is actually fed.
     // This reduces startup-time failure surface on low-end systems.
+    startupTrace("ModemEngine", "ctor-exit");
 }
 
 ModemEngine::~ModemEngine() {

src/gui/modem/streaming_decoder.cpp

@@ -13,6 +13,7 @@
 // - FFT-based correlation for speed when signal present
 
 #include "streaming_decoder.hpp"
+#include "gui/startup_trace.hpp"
 #include "waveform/ofdm_cox_waveform.hpp"
 #include "waveform/ofdm_chirp_waveform.hpp"
 #include "fec/frame_interleaver.hpp"  // Frame-level interleaving for 4-CW frames
@@ -126,12 +127,18 @@ static void dumpBufferSnapshot(const std::vector<float>& buffer, size_t write_po
 }
 
 StreamingDecoder::StreamingDecoder() {
+    startupTrace("StreamingDecoder", "ctor-enter");
     buffer_.resize(MAX_BUFFER_SAMPLES, 0.0f);
+    startupTrace("StreamingDecoder", "buffer-resized");
     waveform_ = WaveformFactory::create(protocol::WaveformMode::MC_DPSK);
+    startupTrace("StreamingDecoder", "waveform-created");
     interleaver_ = std::make_unique<ChannelInterleaver>(16, v2::LDPC_CODEWORD_BITS);
+    startupTrace("StreamingDecoder", "interleaver-created");
     codec_ = fec::CodecFactory::create(fec::CodecType::LDPC, CodeRate::R1_4);
+    startupTrace("StreamingDecoder", "codec-created");
 
     LOG_MODEM(INFO, "StreamingDecoder: Initialized (buffer=%zu samples)", MAX_BUFFER_SAMPLES);
+    startupTrace("StreamingDecoder", "ctor-exit");
 }
 
 StreamingDecoder::~StreamingDecoder() {

src/gui/startup_trace.hpp

@@ -0,0 +1,68 @@
+#pragma once
+
+#include <chrono>
+#include <cstdio>
+#include <cstdlib>
+#include <cstring>
+#include <filesystem>
+#include <mutex>
+#include <string>
+
+namespace ultra {
+namespace gui {
+
+inline void startupTrace(const char* component, const char* phase) {
+#ifdef _WIN32
+    static std::mutex trace_mutex;
+    std::lock_guard<std::mutex> lock(trace_mutex);
+
+    namespace fs = std::filesystem;
+
+    std::string line;
+    {
+        using namespace std::chrono;
+        auto now = system_clock::now();
+        auto ms = duration_cast<milliseconds>(now.time_since_epoch()).count();
+        char buf[512];
+        std::snprintf(
+            buf, sizeof(buf), "[%lld][STARTUP][%s] %s\n",
+            static_cast<long long>(ms),
+            component ? component : "<unknown>",
+            phase ? phase : "<unknown>"
+        );
+        line = buf;
+    }
+
+    std::string env_log;
+    if (const char* p = std::getenv("ULTRA_STARTUP_LOG")) {
+        env_log = p;
+    }
+
+    fs::path log_path;
+    if (!env_log.empty()) {
+        log_path = fs::path(env_log);
+    } else if (const char* temp = std::getenv("TEMP")) {
+        log_path = fs::path(temp) / "ProjectUltra" / "startup.log";
+    } else {
+        log_path = fs::path("startup.log");
+    }
+
+    std::error_code ec;
+    if (!log_path.parent_path().empty()) {
+        fs::create_directories(log_path.parent_path(), ec);
+    }
+
+    if (FILE* f = std::fopen(log_path.string().c_str(), "a")) {
+        std::fwrite(line.data(), 1, line.size(), f);
+        std::fflush(f);
+        std::fclose(f);
+    }
+#else
+    (void)component;
+    (void)phase;
+#endif
+}
+
+}  // namespace gui
+}  // namespace ultra
+

src/gui/widgets/constellation.cpp

@@ -1,10 +1,15 @@
 #include "constellation.hpp"
 #include "imgui.h"
+#include "gui/startup_trace.hpp"
 #include <cmath>
 
 namespace ultra {
 namespace gui {
 
+ConstellationWidget::ConstellationWidget() {
+    startupTrace("ConstellationWidget", "ctor");
+}
+
 void ConstellationWidget::render(const std::vector<std::complex<float>>& symbols,
                                   Modulation mod) {
     // Show symbol count for debugging

src/gui/widgets/constellation.hpp

@@ -10,6 +10,7 @@ namespace gui {
 
 class ConstellationWidget {
 public:
+    ConstellationWidget();
     void render(const std::vector<std::complex<float>>& symbols, Modulation mod);
 
 private:

src/gui/widgets/controls.cpp

@@ -1,10 +1,15 @@
 #include "controls.hpp"
 #include "imgui.h"
+#include "gui/startup_trace.hpp"
 #include <cstdio>
 
 namespace ultra {
 namespace gui {
 
+ControlsWidget::ControlsWidget() {
+    startupTrace("ControlsWidget", "ctor");
+}
+
 // Helper to get modulation name
 static const char* getModulationName(Modulation mod) {
     switch (mod) {

src/gui/widgets/controls.hpp

@@ -13,7 +13,7 @@ class ControlsWidget {
         None
     };
 
-    ControlsWidget() = default;
+    ControlsWidget();
 
     // Render channel status panel
     // data_mod/data_rate are the protocol's negotiated mode (displayed as current mode)

src/gui/widgets/file_browser.cpp

@@ -3,14 +3,17 @@
 #include <algorithm>
 #include <cstdlib>
 #include <filesystem>
+#include "gui/startup_trace.hpp"
 
 namespace fs = std::filesystem;
 
 namespace ultra {
 namespace gui {
 
 FileBrowser::FileBrowser() {
+    startupTrace("FileBrowser", "ctor-enter");
     current_path_ = getHomeDirectory();
+    startupTrace("FileBrowser", "ctor-exit");
 }
 
 std::string FileBrowser::getHomeDirectory() {