Repository navigation
Releases
Releases · bnorthern42/GridLock
v0.8.65
Added
- Attach to Running Process (
Ctrl+Alt+P,ProcessScanner,AttachProcessDialog): Added a Linux/procprocess scanner with automatic OpenMPI, MPICH/PMI, PMIx, and SLURM MPI world-rank grouping (MPI Job (N ranks)),kernel.yama.ptrace_scopepermission diagnostics with a 1-clicksysctlclipboard fix, and single-PID or full-MPI-job attach via GDB/MI3 (-target-attach) and DAP (attach). - Remote Target (
target remote/extended-remote) Support (ProcessScanner,GdbRankCoordinator,AttachProcessDialog): Added aRemote Target (gdbserver / QEMU)tab supporting direct connections toqemu-user -g <port>stubs,gdbserverinstances inside VMs, and multi-rankhost:port..portranges or comma-separatedhost:portendpoints with local ELF DWARF symbol loading (-file-exec-and-symbols) andgdb-multiarchselection. - GitHub Community Standards & Automated Wiki Sync (
ACCESSIBILITY.md,.github/,scripts/sync_wiki.sh): AddedACCESSIBILITY.md, structured YAML issue forms (bug_report.yml,feature_request.yml,accessibility.yml,config.yml), a standardized pull request template, and an automated GitHub Wiki sync workflow with generated_Sidebar.mdand_Footer.md.
Changed & Fixed
- Documentation Screenshots (
MainWindowCohesion,scripts/capture_ui.sh,docs/screenshots/): Refreshed all 19 workstation, dialog, and theme screenshots to reflect current UI state with real MPI tutorial source files (tutorial/deadlock_ring.cpp) and line-anchored breakpoint popovers, while keeping normalmeson testruns side-effect-free. - Repository & Test Suite Cleanup (
tests/,.gitignore): Removed obsolete top-level directories (docker/,assets/,scratch/,.jules/,packaging/), untracked runtime.gridlock/state in.gitignore, consolidated redundant and meta-linting test targets (26 -> 22Meson suites), and stripped leftoverif constexpr (requires ...)test scaffolding.
What's Changed
- ci(deps): bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in #29
Full Changelog: v0.8.6...v0.8.65
v0.8.6
Added
- Visual Library & Heap Memory Profiler (
MemoryProfilerWidget,MemView): Added aLIBRARY MEMORY MAPview insideMemViewcombining/proc/<pid>/smapsvirtual memory region attribution with a lightweightLD_PRELOADcaller-attribution tracker (malloc/calloc/realloc/freeunwinding pastlibstdc++operator newwithaddr2linesymbol resolution), an interactive 2D treemap and proportional stacked bar, a sortable and filterable breakdown table, a⤢ POP OUT/⤡ DOCKstandalone window toggle, and five configurable color schemes (Distinct,Viridis,Plasma,Ocean,HighContrast) inPreferences -> Appearanceand the profiler toolbar. - Inline Variable Ghost Values (
SourceCodeView,EditorTabManager,ConfigManager): Added muted italic inline variable values at the end of visible source lines when paused at a breakpoint or stack frame, resolving both local scalar variables and dotted/arrow member chains (such asdomain_cfg.solver.rel_tolerance) while suppressing opaque{...}placeholders, with a toggle inPreferences -> Editing. - Non-Suspending Logpoints & Breakpoint Hit Ignore Counts (
ConditionalBreakpointDialog,GdbRankCoordinator,DapCoordinator): Added breakpoint log messages ({expr}expression evaluation streamed directly toPROGRAM OUTPUTwithout pausing ranks or stalling MPI barriers, rendered with an amber/cyan diamond gutter marker) and hit ignore counts (-break-insert -i N/-break-afterand DAPhitCondition). - Interactive Pointer & Struct Graph Visualizer (
PointerGraphDialog,VariablesDockWidget): Added a DDD-inspired 2D pointer and struct graph canvas (Variablescontext menu andTools -> Pointer & Struct Graph Visualizer...) with draggable struct cards, automatic 1-hop composite and pointer expansion, directed cubic Bezier edges, layered DAG auto-layout, null-pointer (0x0) guards, and cycle/shared-alias detection. - Reverse Debugging / Time-Travel Execution (
GdbRankCoordinator,DapCoordinator,MainWindow): Added GDB Process Record (record fullwith scheduler-locking support) and DAP reverse execution (stepBack/reverseContinue), exposing⏺ Record,↶ Step Back, and⏮ Rev Continuecontrols in the main execution toolbar.
Changed
- Incremental Output Streaming & Lazy Memory Map Refreshes (
MainWindowDocks,GdbConsoleWidget,MainWindowExecution,MemView): KeptPROGRAM OUTPUTandGDB CONSOLEflushes strictly incremental by filtering incoming rank output on arrival, debounced dotted inline variable evaluations, and deferred/proc/<pid>/smapsrefreshes untilLIBRARY MEMORY MAPis active and visible on the focused rank.
Fixed
- Clean Shutdown Lifecycle (
ClangdLspClient,MainWindow,MemView,TerminalDockWidget): Fixed an exit segmentation fault on window close by shutting downClangdLspClientonQCoreApplication::aboutToQuit, guarding signal teardown during destruction, and re-docking popped-outMemViewwindows before teardown. - Wayland Splitter Resize Warnings: Eliminated Wayland non-popup mouse-grab warnings when dragging dock and panel splitters by enabling
setOpaqueResize(true)across allQSplitterinstances. - Variable Deduplication & Access-Specifier Unwrapping (
VariableTreeModel,GdbRankCoordinator,GdbRankInspection): Fixed duplicate variable rows ({...}vs{...} @ 0x...and@entryparameter shadows), unwrapped C++public/protected/privateaccess-specifier pseudo-nodes at all tree depths, and restrictedVariablesDockWidgetlive updates to the focused rank. - Toolbar Layout & Tiling Window Controls (
MemView,PointerGraphDialog): Fixed button and source badge overlap inMemView's toolbar when switching modes, and added an explicit✕ CLOSEtoolbar button toPointerGraphDialogfor frameless and tiling Wayland compositors.
Full Changelog: v0.8.5...v0.8.6
v0.8.5
Added
- Live Multi-Rank Orchestration (
GdbRankCoordinator,DapCoordinator): Added live GDB/MI3 MPMD multi-rank process launching and stepping (GdbRankCoordinator) alongside Debug Adapter Protocol coordination (DapCoordinator), replacing the staticobjdumpstepping simulation. - Per-Rank PID Capture,
/procAttach & Cross-Rank Memory Diffing (AttachProcessDialog,MemView,MemoryDiffer): Captured live inferior OS PIDs (=thread-group-started/systemProcessId), added a live/procprocess scanner inAttachProcessDialog, and implemented cross-rank memory reads (process_vm_readvwith GDB/DAP memory-read fallback) with byte diff highlighting inMemView. - Call Stack Unwinding & Thread Switching (
CallStackDockWidget): Added theCALL STACKdock supporting 64-frame backtrace unwinding, OS/OpenMP thread selection, and caller-frame local variable, register, and source synchronization. - Expandable Composite Variables & Live Table Filtering/Sorting (
VariablesDockWidget,VariableTreeModel,RegisterView,ProjectExplorerWidget): Added recursive GDB/MI3 and DAP{...}struct, class, and vector child expansion, plus live search inputs and click-to-sort interactive column headers acrossVARIABLES,REGISTERS,SYMBOLS, andSTRINGS. - Rank-Coded Breakpoint Gutter Badges (
SourceCodeView): Added crimson All-Ranks badges with a white ring alongside deterministic per-rank accordion colors, rank index labels, and gutter context-menu actions. - Live Deadlock Analysis, REPL Console & Data Watchpoints (
DeadlockAnalyzer,MpiNetworkLogWidget,GdbConsoleWidget,MiSanitizer): Wired real rank call stacks intoDeadlockAnalyzerfor circular wait and collective divergence detection (MPI_BcastvsMPI_Barrier), streamed live events toMpiNetworkLogWidget, enabledMiSanitizer-validated interactive commands inGdbConsoleWidget, and added hardware data watchpoints (Write,Read,ReadWrite). - Dedicated Program Output Dock (
MainWindowExecution,MainWindowDocks): Added aPROGRAM OUTPUTbottom dock tab displaying a read-only launch command and working directory header bar above 60 FPS coalesced inferior stdout/stderr output with rank filtering. - Cross-File
clangdNavigation & Build Database Discovery (ClangdLspClient): Enabled workspace-scoped JSON-RPC 2.0F12Go-to-Definition,findReferences, AST-safeWorkspaceEditsymbol rename, livepublishDiagnosticseditor squiggles, and automaticcompile_commands.jsondiscovery acrossbuilddir,build,build_meson, andbuild_cmake. - Session Persistence, Dirty Close Prompts & Syntax Modes (
SessionManager,EditorTabManager,SourceCodeView): Added live background Git diff gutter refreshes,Save/Discard/Cancelprompts on dirty tab and window close,File -> Save Sessionwith workspace auto-save to.gridlock/workspace.toml, persistentFile -> Recent Sessionsin~/.config/gridlock/debugger.conf, syntax highlighters forTOML,YAML,Markdown, andCSV/TSV, and stateful Rainbow Brackets inPreferences -> Editing. - Upgraded Project Settings,
MemViewSource Mode & Dual AppImages (ProjectSettingsDialog,FileDialogHelper,scripts/build_appimage.sh): Added workspace ELF auto-discovery, file/folder browsers,Program Arguments, andWorking Directoryterminal synchronization inProjectSettingsDialog; added explicitMemViewsource mode indicators (IDLE (NO BINARY),STATIC ELF (READ-ONLY),LIVE RANK N (PID M)); and packaged both Lite (GridLock-<version>-x86_64.AppImage) and Tutorials (GridLock-<version>-Tutorials-x86_64.AppImage) AppImage editions.
Changed
- Clean Idle & Unbuilt Workspace State: Removed startup constructor mock fixtures across
VariablesDockWidget,RegisterView,MemView,MpiDiagnosticsWidget,MpiNetworkLogWidget,ProjectExplorerWidget,DisassemblyView,ServerRackView, the section navigation ribbon, and status bar telemetry so idle and unbuilt workspaces start clean. - Non-Blocking Asynchronous Pipelines: Moved
clangddocument completion, Git diff gutter refreshes, and 8-rankPROGRAM OUTPUT/GDB CONSOLEbatch insertion off synchronous GUI blocking paths.
Fixed
- Multi-Rank MPI + OpenMP Stalls (
GdbRankCoordinator): Guarded running-state MI inspection queries, resumed all stopped ranks onContinue, allowed dynamic breakpoint updates while ranks execute, and tunedOMP_NUM_THREADS/OMP_WAIT_POLICY=PASSIVEfor responsive hybrid debugging. - Secondary-Tab Breakpoint Focus Jump: Prevented toggling a breakpoint in another source file tab from snapping focus back to the stopped execution file.
- Atomic Workspace Switching (
MainWindowWorkspace): SynchronizedProjectExplorerWidget(FILES),TARGET:, andTerminalDockWidgetworking directory together when opening external workspaces or.gridlock/workspace.tomlsessions. - Control Flow Graph & Decompiler Polish (
DisassemblyView): Clamped wide demangled C++ template signatures in CFG basic blocks, left-anchored wide blocks in the viewport, cleared the stuck hand-pan cursor, and honored the"Show Pseudo-C Decompiler when Source Editor is visible"preference consistently whenever any source tab is open. - File Dialogs & Diagnostics Table Layout (
FileDialogHelper,MpiDiagnosticsWidget,MpiNetworkLogWidget): DefaultedQFileDialogto the active workspace, pruned non-existent ghost bookmarks fromsidebarUrls(), and enabled interactive column resizing without PID truncation inMPI DIAGNOSTICSandNETWORK LOG.
Full Changelog: v0.8.0...v0.8.5
Full Changelog: v0.8.0...v0.8.5
v0.8.0
Added
- File Tree CRUD Operations & Build Registration (
ProjectExplorerWidget): Added context-menu and programmatic operations for creating source/header files, creating folders, renaming (F2), and deleting entries, with external filesystem synchronization and 1-click source registration inmeson.buildandCMakeLists.txt. - Split Source Editors & Dirty Buffer Tracking (
EditorTabManager,SourceCodeView): Added horizontal (Split Right) and vertical (Split Down) split editor views, unsaved buffer markers (*/●) with save/discard prompts,Ctrl+Shift+S(Save All), Header/Source switching (F10), and a scope breadcrumb bar. clangdDiagnostics, Hover & AST Navigation (ClangdLspClient): Added inline compiler error and warning underlines (textDocument/publishDiagnostics), hover type and Doxygen tooltips (textDocument/hover),F12go-to-definition (textDocument/definition),Shift+F12find references (textDocument/references),Shift+F6AST symbol rename (textDocument/rename), andCtrl+Spaceauto-completion.- Git Diff Gutter Indicators (
SourceCodeView): Added gutter line markers for added, modified, and deleted lines parsed from unifiedgit diffhunks. - Configurable Debugger Backend Engine (
PreferencesDialog,ConfigManager): Added debugger backend selection (gdb,lldb-dap,cuda-gdb,rocgdb), custom binary path configuration, andmpirunlaunch argument settings inPreferences -> Debugger. - 12-Theme Palette Catalog (
ThemePalette,ThemeManager): Expanded the theme engine to 12 built-in themes (8 Dark, 4 Light), addingNord,One Dark Pro,Dracula, andOne Light. - Live Status Bar Resource Telemetry (
ElfBinaryInspector,MainWindow): Added real-time per-rankSTACKandHEAPmemory usage alongside systemRAM(in GB/total or%) andCPU %in the bottom status bar ribbon, with a configurable display format inPreferences. - 5 New MPI Debugging Showcase Examples & Expanded Tutorial (
tutorial/,docs/TUTORIAL.md): Addedcollective_mismatch.cpp,ghost_cell_drift.cpp,heap_imbalance.cpp,tag_mismatch_stall.cpp, andsimd_struct_watch.cpp(bringing the suite to 7 runnable examples registered in theTARGET:selector) and expandeddocs/TUTORIAL.mdwith step-by-step walkthroughs. - Static Analysis & Compiler Quality Gates (
sonar-project.properties,meson.build): Addedsonar-project.propertiesfor complexity and coverage tracking, rancppcheckandclang-tidysweeps acrosssrc/andtests/, and enforced-Wall -Wextra -Wpedanticwith zero compiler warnings.
Changed
- Default Control Flow Graph & Conditional Decompiler Visibility (
DisassemblyView): DefaultedDisassemblyViewto the multi-block Control Flow Graph (MAP (CFG)) view and hid the redundant pseudo-C decompiler pane when the C++ source editor is visible (configurable inPreferences -> Debugger). - Right-Sidebar Dock Consolidation & Movable Toolbars (
MainWindow): TabifiedWatchinto the top-rightVARIABLES | REGISTERS | WATCHdock tab group aboveSERVER RACKand enabled movable main toolbars (setMovable(true)). - Documentation Overhaul (
README.md,ROADMAP.md,docs/*.md): Rewrote project documentation, architecture guides, and user manuals in concise developer prose.
Fixed
- Live GDB Disassembly CFG Splitting (
DisassemblyView): Fixed theBB:1 E:0Control Flow Graph collapse when stepping through live GDB disassembly containing<symbol+offset>xjmpannotations. - Light-Theme Contrast (
ThemeManager,MemView,ProjectExplorerWidget): Fixed light-theme contrast across thePreferencescategory sidebar, binary section ribbon,FILES | SYMBOLS | STRINGStoggles,CODE | REVERSE | MPIswitches, and non-zeroMemViewhex bytes. - Main Toolbar Control Sizing (
MainWindowWorkspace): Fixed clipped digits in theRANKS (-np)spinbox, truncated text in theTARGET:dropdown, and oversizedRun Targetbutton height. - Subprocess Pipe Guards (
DapCoordinator,LspCoordinator,GdbRankCoordinator,ClangdLspClient,TerminalDockWidget): GuardedQProcess::writeandcloseWriteChannelcalls against closed or unstarted pipes.
Full Changelog: v0.7.0...v0.8.0
Full Changelog: v0.7.0...v0.8.0
v0.7.0
What's Changed
- On-Demand ELF64 Compilation & DWARF
.debug_lineDisassembly Mapping (ElfBinaryInspector::disassembleSymbolWithDwarf): Compiles C/C++ MPI targets on demand with-g -O0(mpicxx/mpicc/g++) and parses.debug_lineand.textdisassembly viaobjdump,nm, andreadelffor exact bidirectional source-line to instruction-address synchronization. ClangdLspClientVirtual-Buffer JSON-RPC 2.0 Expression Autocomplete: RealclangdLanguage Server Protocol client splicing breakpoint condition expressions into an in-memory C++ translation unit at target lineNto provide context-aware struct, vector, and local variable completions insideConditionalBreakpointDialogandSourceCodeView.- Cursor-Anchored
Qt::PopupConditional Breakpoint Popover (ConditionalBreakpointDialog): Frameless popover anchored directly beneath the gutter badge displaying target line context, anEnabledtoggle,Suspend: All | Rankradio scope buttons, MPI condition preset pills, and liveclangdcompletion. - Two-Lane Antialiased Vector Gutter (
SourceCodeView): Dedicated20pxleft badge lane renderingQPainterPathvector indicators (Breakpointcircle,ConditionalBreakpointamber diamond,ExecutionPcemerald chevron, and combined ring+chevron) isolated from right-aligned line numbers and editor context menus. - 36px Left Vertical Tool-Window Icon Rail (
#bottomToolWindowRail): Organizes the bottom dock into four linked contextual tool groups (Debug,MPI,Terminal,Docs) with a flattened single-rowMPI Diagnosticsheader (Deadlock AnalyzerandNetwork Log). - Multi-Distro HPC & System Package Manager (
HpcConsoleWidget): Automatic backend discovery (spack,pacman,dnf4/dnf5,apt,zypper,rpm,dpkg-query,eb) with live two-stage local/repository querying and switchableTable,List, andRawviews. - 16-Directive SLURM
#SBATCHAuto-Detector (PreferencesDialogSlurm): Parses.sbatch/.shjob scripts to auto-populate 16 SLURM directives (--job-name,--partition,--account,--qos,--nodes,--ntasks,--ntasks-per-node,--cpus-per-task,--gres,--mem,--time,--constraint,--reservation,--chdir,--output,--error) andmodule loadtoolchains. - 8 Curated Dark & Light Workstation Themes (
ThemeManager): Full palette and QSS propagation across 5 dark themes (GridLock Slate,Obsidian Teal,Tokyo Night,Catppuccin Mocha,Gruvbox Industrial) and 3 high-contrast light themes (Daylight Paper,Solarized Warm,Catppuccin Latte) with live UI and code font scaling. - Splitter-Aware Dock Pop-Out & Redocking: Supports popping out
Variables,Registers,Server Rack, andProject Explorerinto floating windows with translucent drop-zone overlays and 1-click/double-click redocking across X11 and Wayland.
Full Changelog: v0.6.2...v0.7.0
What's Changed
- Fix AppImage CQtDeployer build failure by @bnorthern42 in #15
- 🔒 Fix GDB MI command injection in expression evaluation by @bnorthern42 in #17
- Update Flatpak Qt runtime version to 6.8 by @bnorthern42 in #16
- 🧪 Add tests for Float and Double MemoryExporter bounds checks by @bnorthern42 in #18
- ⚡ Optimize QMap range-based loops to prevent copies by @bnorthern42 in #20
- ⚡ Optimize DocsetManager::suggestDocsets file scanning by @bnorthern42 in #19
- 🧪 [testing improvement] Add missing coverage for MemoryBoundsValidator by @bnorthern42 in #21
- 🧪 Add tests for CliParser by @bnorthern42 in #22
Full Changelog: v0.6.2...v0.7.0
V0.6.2
v0.6.2 Merge pull request #14 from bnorthern42/jules-16884473812188123149-23…
V0.6.1
Add flatpak and fix appimage and toolpak thing
v0.6.0
Full Changelog: v0.5.3...v0.6.0
Added
- Integrated Interactive Terminal: Real embedded terminal leveraging
qtermwidget, providing a full PTY-backed interactive shell inside the IDE asTerminalDockWidget. - Centralized
VersionManager: Themeson.buildfile is now the single source of truth for the project version. AVersionConfig.hpp.intemplate is configured at build time, exposingGRIDLOCK_VERSION_MAJOR,GRIDLOCK_VERSION_MINOR, andGRIDLOCK_VERSION_PATCHconstants to all C++ translation units via theVersionManagerAPI. - DAP Exception Handling: The DAP lifecycle now catches fatal target exceptions (e.g.,
SIGFPE, segfaults). WhenDapCoordinatorreceives a stopped event withreason: "exception", it emits atargetCrashed(QString reason)signal.MainWindowconnects this signal to display a clean, non-blocking warning dialog rather than leaving the UI in a hung state. - Project-Local Configuration Overrides:
ConfigManagernow implements a two-tier resolution hierarchy. On startup and session load, it checks for<project_root>/.gridlock/workspace.tomlfirst. If present, values in that file override global XDG settings (~/.config/gridlock/config.toml), enabling fully reproducible, project-portable debug configurations. - Automated Stylesheet Asset Bundling:
Qt-Advanced-Stylesheetstheme assets are now compiled directly into a Qt Resource (.qrc) file via a Mesoncustom_target. The generatedacss_resources.qrcis processed byqt.compile_resources(), embedding all style assets into the binary for flawless zero-dependency deployment. - Persistent Layout Restoration:
MainWindownow saves and restoresQMainWindow::saveGeometry(),QMainWindow::saveState(), and individual dock widget positions between sessions usingQSettings. The layout is persisted on close and fully restored on the next launch.
Changed
- Terminal Architecture Separation: The old monolithic pseudo-terminal was split into two distinct docks:
MpiNetworkLogWidget(read-only, captures DAP/GDB stdout streams for MPI Diagnostics) andTerminalDockWidget(a live, fully interactive shell viaqtermwidget). BreakpointManagerScoping: TheBreakpointManageris now scoped to the active Workspace Directory. All breakpoint paths are stored as absolute paths relative to the project root. This prevents global breakpoint accumulation across projects and eliminates the flood of<PENDING>GDB/MI traffic that occurred when stale paths from other workspaces were sent to the debugger on session load.ProjectWizardDialogPersistent Memory: The Project Wizard now automatically re-populates all fields (binary path, arguments, MPI rank count, working directory) with the values from the last session. Fields are persisted viaQSettingsand restored on the next time the wizard is opened.- CI Pipeline Overhaul: The GitHub Actions
release.ymlpipeline was updated to build all Qt6-native subproject dependencies from source on older Ubuntu runners. This includeslxqt-build-tools,qtermwidget, andQt-Advanced-Stylesheets(pinned to their2.0.0tags), ensuring a reproducible and hermetic build environment.
Fixed
- Wayland/Niri Dock Regressions: Resolved compositor-specific regressions affecting dock widget dragging and floating window management under Wayland compositors, specifically the Niri tiling compositor.
mpi_mm.cDivide-by-Zero Crash: Fixed a fatal divide-by-zero crash in the MPI matrix multiplication tutorial (tutorial/mpi_mm.c) that occurred when the program was executed in singleton mode (rank count of 1) without any worker ranks, causing an integer division by zero when computing the row distribution.