Repository navigation
feat: add /log-file support and enable DEBUG level when logging is requested - #932
Merged
Merged
Conversation
… flag conventions WHAT: - Add structured Windows /flag parser supporting /console, /log-file <PATH>, /log-file=<PATH>, /quit, /help, and /?. - Enable DEBUG level tracing subscriber when /console or /log-file is requested (suppressed in background mode to avoid GUI hangs). - Use tracing_subscriber::registry() with composable layers for independent console (ANSI color) and log file (plain text) formatting. - Add raw backend input logging in BackendManager to complement existing output tracing. - Add unit tests for command line parsing in PIMELauncher/src/main.rs. - Document debugging options in HACKING.txt, README.md, and PIMELauncher/README.md. WHY: - Developers and users diagnosing backend timeouts, crashes, or IPC issues need visibility into runtime behavior without GUI subsystem deadlocks. - Following Windows /flag conventions maintains consistency with Windows system tools and installer scripts. Generated with assistance from Antigravity
PCMan
force-pushed
the
feature/launcher-debug-logging
branch
from
October 17, 2026 07:10
9b3c91c to
e15c751
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Provides improved diagnostic capabilities for
PIMELauncherby enablingDEBUGlevel tracing on demand and adding headless file logging via/log-file <path>, adhering strictly to Windows/flagconventions.When neither
/consolenor/log-fileis specified (normal background operation), all debug logging remains completely suppressed tostd::io::sinkwith zero I/O overhead.Key Changes
LauncherArgs: Structured CLI parser strictly supporting Windows/flagstyle (/console,/log-file <PATH>,/log-file=<PATH>,/quit,/help,/?).DEBUGLevel on/console: When runningPIMELauncher.exe /console, the tracing subscriber max level is now set toLevel::DEBUG(previouslyINFO), allowing developers to inspect RPC request/response details and backend routing in real time./log-file <path>:/consoleto capture detailed debug logs in headless background mode.tracing::debug!("Backend Input Raw: {:?}", data)inBackendManagerto complement existing raw output logging.setup_loggingandopen_log_fileto keepmain()concise, readable, and focused./helpand/?options to print available CLI options.src/main.rsforLauncherArgs::parse.HACKING.txt,README.md, andPIMELauncher/README.mdwith usage examples.AI Declaration
Generated with assistance from Antigravity (Gemini 3.8 Flash).