Repository navigation
Roadmap
github-actions[bot] edited this page Nov 18, 2026
·
2 revisions
This roadmap tracks completed milestones (Phases 1–12 / v0.8.65) and upcoming releases for GridLock, a C++23 and Qt6 MPI debugger and ELF binary inspector on Linux.
- ELF64 & DWARF Debugging (
ElfBinaryInspector,GdbRankCoordinator,DapCoordinator): Disassembly viaobjdump -d -M intel --insn-width=10, symbol extraction vianm, and.debug_linesource-to-address mapping viaobjdump --dwarf=decodedline/readelf -wL. - Breakpoint-First Execution & Deadlock Detection (
DeadlockAnalyzer): On-demand target compilation (mpicxx -g -O0), automatic halt at user-set breakpoints ormain()entry, and wait-for cycle detection across blockedMPI_Send,MPI_Recv, andMPI_Barriercalls. - Process Memory Reading & Cross-Rank Diffing (
NativeMemoryReader,MemoryDiffer,MemView):process_vm_readvmemory reads with stride bounds validation (MemoryBoundsValidator), cross-rank byte diffing, and live hex/instruction binary patching (savePatchedBinary). - Cross-Rank Variables & Registers (
DifferentialGrid,VariablesDockWidget,RegisterView): Side-by-side inspection of C/C++ expressions, stack frames, and x86_64 registers across active MPI ranks.
- Editor Gutter & Breakpoint Popover (
SourceCodeView,ConditionalBreakpointDialog): Separate gutter columns for breakpoints, current instruction pointer, and line numbers, plus a right-click popover for rank-filtered conditional breakpoints (All MPI RanksorFocused Rank Only). -
clangdJSON-RPC 2.0 Completion (ClangdLspClient): Asynchronous stdio client providing C/C++ struct and member completion insideConditionalBreakpointDialogandSourceCodeView(Ctrl+Spaceor.,->,::). - Dock Layout & Wayland Support: Left vertical icon rail (
Debug,MPI,Terminal,Docs) for the bottom dock and native drag/redock behavior for floating panels (ServerRackView,RegisterView,VariablesDockWidget). - Themes & SLURM Script Importer (
ThemeManager,PreferencesDialog): Live theme switching and#SBATCHbatch script import/export for 16 common SLURM directives. - System Package Search & Offline Docsets (
HpcConsoleWidget,DocsetManager): Package search acrossrpm,dnf5/dnf4,pacman,apt,zypper, andspackwithTable,List, andRawviews, SQLite3 Zeal.docsetandmanlookup (F1), and embeddedQTermWidgetPTY terminals. - GitHub Actions
appimagetoolRelease Pipeline: Self-containedAppDirbundling with$ORIGIN/../libRPATH configuration, headless Meson test runs, andAppImagepackaging.
- External Static Analysis Passes (
cppcheck,clang-tidy):- Ran
cppcheckandclang-tidy(bugprone-*,modernize-*,performance-*,cppcoreguidelines-*) acrosssrc/andtests/to clean up dead code, uninitialized members, variable shadowing, andQObjectlifetime issues.
- Ran
- SonarQube / SonarCloud & Compiler Quality Gates:
- Updated
sonar-project.properties(sonar.projectVersion=0.8.6) for complexity and coverage tracking alongside zero-warning compiler flags (-Wall -Wextra -Wpedantic).
- Updated
- Memory & Process Security Audit (
MemoryBoundsValidator,ElfBinaryInspector,MiSanitizer):- Validated
uint64_toverflow guards inMemoryBoundsValidator, corrupt/truncated ELF header rejection inElfBinaryInspector, shell metacharacter filtering inMiSanitizer, and direct argument-list process spawning across allQProcessandKPtyProcesscall sites under ASan, UBSan, andMALLOC_PERTURB_.
- Validated
- Light Theme Contrast Fixes (
daylight_light,solarized_light,catppuccin_latte):- Replaced hardcoded dark backgrounds in
MemViewbyte cells,ProjectExplorerWidget(FILES | SYMBOLS | STRINGS) buttons, the binary section navigation bar (.plt,.text,.rodata,.data,stack), andCODE | REVERSEtoggle buttons with theme-aware colors.
- Replaced hardcoded dark backgrounds in
- Disassembly Header Sizing & Theme Screenshots:
- Fixed horizontal label clipping on the
SPLIT (CFG+DECOMP),DECOMPILER, andCFG (SPACE)buttons inDisassemblyViewand generated preview screenshots forSolarized Warm(theme_solarized_light.png) andCatppuccin Latte(theme_catppuccin_latte.png) indocs/THEMES.md.
- Fixed horizontal label clipping on the
- Palette Token Struct & 12 Built-In Themes (
ThemePalette,ThemeManager):- Added semantic
ThemePalettetokens (canvasBg,panelBg,headerBg,border,accent,textPrimary,textMuted,selectionBg,disasmOpcode,disasmRegister,disasmAddress,cfgEdgeTrue,cfgEdgeFalse,cfgEdgeUncond) and expanded the catalog to 12 themes withNord(nord_dark),One Dark Pro(one_dark_pro),One Light(one_light), andDracula(dracula_dark).
- Added semantic
- Movable Toolbars, Live CFG Map Default & Status Bar Memory Telemetry (
MainWindow,DisassemblyView,ElfBinaryInspector):- Enabled movable toolbars, made the multi-block Control Flow Graph (
MAP (CFG)) the persistent default disassembly view across live stepping, and added real-time per-rankSTACKandHEAPtelemetry alongside hostRAMandCPU %in the bottom status bar ribbon.
- Enabled movable toolbars, made the multi-block Control Flow Graph (
- Step-by-Step Walkthrough (
docs/TUTORIAL.md):- Expanded the hands-on developer guide covering:
- Building and selecting all 7 bundled MPI showcase examples (
deadlock_ring.cpp,inspection_demo.cpp,collective_mismatch.cpp,ghost_cell_drift.cpp,heap_imbalance.cpp,tag_mismatch_stall.cpp,simd_struct_watch.cpp) from theTARGET:toolbar selector or CLI. - Diagnosing circular
MPI_Senddeadlocks,MPI_Bcastvs.MPI_Barriercollective divergence, 1D stencilNaNpropagation, per-rankSTACK/HEAPtelemetry imbalance, and point-to-point tag stalls. - Comparing cross-rank watch expressions in
DifferentialGrid, highlighting memory differences across ranks withDIFF RANKS, and saving memory slices withEXPORTinMemView. - Looking up C/C++, MPI, and x86_64/ARM64 assembly documentation in offline Zeal docsets and
manpages (F1), importing#SBATCHscripts, and searching dependencies in thePACKAGE MANAGERdock.
- Building and selecting all 7 bundled MPI showcase examples (
- Expanded the hands-on developer guide covering:
Scope Note: GridLock focuses on local and workstation MPI debugging and offline
#SBATCHscript generation; live remote SLURM queue submission is out of scope.
- Project File Tree Operations (
ProjectExplorerWidget):- Added right-click context menu actions and programmatic helpers on the
FILEStree forNew Source File (.cpp),New Header File (.hpp),New Folder,Rename (F2),Delete, and 1-click source registration inmeson.buildorCMakeLists.txt.
- Added right-click context menu actions and programmatic helpers on the
- Dirty Buffer Tracking & Split Editors (
EditorTabManager,SourceCodeView):- Added unsaved buffer indicators (
●) on editor tabs, close prompts,Ctrl+Shift+S(Save All), horizontal and vertical split editor panes (Split Right,Split Down), Header/Source switching (F10), and a scope breadcrumb bar (File > Class/Struct > Function).
- Added unsaved buffer indicators (
-
clangdDiagnostics, Hover & Navigation (ClangdLspClient,SourceCodeView):- Added inline compiler error and warning underlines (
textDocument/publishDiagnostics), symbol/Doxygen hover tooltips (textDocument/hover),F12Go-to-Definition (textDocument/definition),Shift+F12Find References (textDocument/references), andShift+F6AST symbol rename (textDocument/rename).
- Added inline compiler error and warning underlines (
- Git Diff Gutter & Debugger Engine Selector (
SourceCodeView,PreferencesDialog,ConfigManager):- Added
git diffgutter indicators (added, modified, and deleted line markers) inSourceCodeViewand a debugger backend selector (gdb,lldb-dap,cuda-gdb,rocgdb) inPreferences -> Debugger.
- Added
- Live Multi-Rank GDB/MI3 & DAP Backends (
GdbRankCoordinator,DapCoordinator):- Replaced static simulation stepping with real MPMD GDB/MI3 process orchestration, per-rank OS PID tracking,
/proctarget attach (AttachProcessDialog), hardware data watchpoints, and 60 FPS coalescedPROGRAM OUTPUT/GDB CONSOLEstreaming.
- Replaced static simulation stepping with real MPMD GDB/MI3 process orchestration, per-rank OS PID tracking,
- Stack Unwinding, Composite Inspection & Live Filtering (
CallStackDockWidget,VariablesDockWidget,RegisterView,ProjectExplorerWidget):- Added 64-frame call stack unwinding and OpenMP/OS thread selection, recursive
{...}struct/class/vector expansion, and live search filtering plus interactive column sorting acrossVARIABLES,REGISTERS,SYMBOLS, andSTRINGS.
- Added 64-frame call stack unwinding and OpenMP/OS thread selection, recursive
- MPI + OpenMP Execution Reliability & Workspace Sync (
MainWindowWorkspace,SessionManager,TerminalDockWidget):- Eliminated running-state MI stalls across multi-rank OpenMP solvers, synchronized
ProjectExplorerWidget+TARGET:+TerminalDockWidgetworking directory on workspace switch, persisted recent sessions indebugger.conf, and packaged dual Lite and Tutorials AppImage editions.
- Eliminated running-state MI stalls across multi-rank OpenMP solvers, synchronized
- Visual Library & Heap Memory Profiler (
MemoryProfilerWidget,MemView):- Combined
/proc/<pid>/smapsVMA region attribution with a lightweightLD_PRELOADcaller-attribution tracker andaddr2linesymbol resolution in an interactive 2D treemap, proportional stacked bar, and sortable table with 5 color schemes (Distinct,Viridis,Plasma,Ocean,HighContrast) and standalone pop-out window support.
- Combined
- Interactive Pointer & Struct Graph Visualizer (
PointerGraphDialog):- Added a DDD-inspired 2D pointer and struct graph canvas with draggable struct cards, automatic 1-hop composite and pointer expansion, directed cubic Bezier edges, null-pointer (
0x0) guards, and cycle/shared-alias detection.
- Added a DDD-inspired 2D pointer and struct graph canvas with draggable struct cards, automatic 1-hop composite and pointer expansion, directed cubic Bezier edges, null-pointer (
- Inline Variable Ghost Values, Logpoints & Reverse Debugging (
SourceCodeView,GdbRankCoordinator,DapCoordinator):- Added inline variable ghost values (resolving local scalars and dotted/arrow member chains), non-suspending Logpoints (
{expr}) and breakpoint hit ignore counts, and GDB Process Record / DAP reverse execution (⏺ Record,↶ Step Back,⏮ Rev Continue).
- Added inline variable ghost values (resolving local scalars and dotted/arrow member chains), non-suspending Logpoints (
-
Non-Linear Execution Control (
Run to Cursor,Set Next Statement / Jump,Force Early Return):Ctrl+F10Run to Cursor (-exec-until), draggable gutter PC arrow /Set PC Here($pc/-exec-jumpwith lexical scope guard), andForce Return Immediately...(-exec-return [expr]). -
First-Class Catchpoints & Signal Disposition Manager: C++
throw/rethrow/catchcatchpoints (with type regex filtering), Linux syscall catchpoints (mmap,openat,clone3,ioctl),dlopen/dlcloseregex catchpoints, and a per-signal (SIGFPE,SIGPIPE,SIGUSR1,SIGBUS) Stop/Print/Pass matrix. -
Instant Copy-on-Write Fork Checkpoints (
checkpoint/restart): Native hardware-speed process state snapshots via GDBcheckpoint/restartwith/proc/[pid]/fdand/proc/[pid]/mapsIPC/RDMA safety checks. -
Unified Fuzzy Command Palette (
Ctrl+Shift+P/Ctrl+P): Modal-free fuzzy launcher acrossShortcutManageractions (>), workspace files (Ctrl+P),clangd/ELF symbols (@), themes, and live MPI ranks/groups (#).
-
Cross-Rank IEEE-754 Anomaly & Poison-Pattern Scanner (
NaN/Inf/ Subnormals): Concurrentprocess_vm_readvsweep across stopped ranks with per-rank distribution sparklines (Min | Mean | Max | L2 Norm), exact index flagging for Quiet/SignalingNaN,±Inf, IEEE-754 denormals/subnormals, and allocator poison patterns (0xdeadbeef,0xcdcdcdcd), plus a 1-click$mxcsrhardware FP exception trap toggle (FE_INVALID | FE_DIVBYZERO | FE_OVERFLOW). -
Watch Expression Format Specifiers & AoS Columnar Table Views: Inline comma suffixes (
ptr, [N],,x,,b) and Array-of-Structs tabular projections (particles, [1000], cols(pos.x, pos.y, energy)) strided locally viaprocess_vm_readvand DWARF /ptype /omember offsets. -
Typed SIMD Vector Lane & Control/Flag Bitfield Inspector: Expandable
XMM/YMM/ZMMtyped vector lanes (f64x4/f64x8,f32x8/f32x16,i64x8,i32x16) with per-lane step diff highlighting,k0..k7AVX-512 mask checkboxes, and decodedRFLAGS/MXCSRsticky exception badges (IE,DE,ZE,OE,UE,PE,FTZ,DAZ). -
Multidimensional Array, Slice & Heatmap Visualizer: Dockable 1D/2D/3D array and tensor inspector (
[Nx, Ny, Nz]shape/stride, row-major vs. Fortran column-major) with a virtualized 2D numerical table, multi-rank 1D curve overlays for halo/ghost-cell verification, and a 2DQImageheatmap (Viridis/Plasma/Ocean).
-
Post-Mortem Core Dump & Multi-Rank Crash Loader (
coredumpctlIntegration):File -> Open Core Dump(s)...(multi-rankcore.*globs) andFile -> Recent System Crashes (systemd-coredump)(coredumpctl list --json=short+coredumpctl dump), ELFPT_NOTE(NT_GNU_BUILD_ID/NT_FILE) executable matching, andPOST-MORTEMinspection across all docks. -
DWARF Struct Layout, Alignment Padding, Cache-Line & Hex-Dump Overlay Inspector:
pahole-style struct byte-map showing field offsets, bitfields, vptr slots, compiler padding holes, wasted byte %, optimal field packing preview, 64-byte hardware cache-line boundaries for OpenMP false-sharing analysis, and live(StructType*)0x...typed hex-grid overlays inMemView. -
Annotated Stack Frame Memory & Pointer-Telescoping Inspector: Aligned 8-byte stack slot table (
[RSP .. RBP .. Caller CFA]) bracketing stack frames, highlighting savedRIP,RBPchains, stack canaries, DWARF stack locals, and 4-hop pointer telescoping (stack -> heap -> .rodatasymbol/string resolution).
-
Merged Parallel Stack Tree ("STAT-Style" Prefix Aggregation) & Dynamic Rank Control Sub-Groups: Prefix-trie call graph in
CallStackDockWidgetmerging backtraces across all$N$ ranks with proportional[M/N ranks]membership bars to isolate stragglers, paired withRankBitsetexecution sub-groups (All Ranks,Root (0),Workers (1..N-1),Stopped Ranks, or custom branch subsets). -
OpenMP Logical Region, Task & Barrier Inspector (
OMPD/libompd.so+ Thread Alignment): Logical OpenMP team/thread hierarchy labeling, runtime frame collapsing, originatingomp taskbacktraces, and a 1-click"Align All Team Threads Here"button. -
MPI Message Queue & Unmatched
MPI_RequestInspector (MPIR/mqs_DLL Interface): Host adapter formpi_interface.h(libompi_dbg_msgq.so/libtvmpich.so) backed byprocess_vm_readvcallbacks, exposing Posted Receives, Pending Sends, and Unexpected Messages insideMpiDiagnosticsWidgetalongside a 2D Rank × Rank communication matrix.
v0.9.x → v1.0.0 — UI/UX Cohesion, Visual Ergonomics & Workstation Unification (Feature Freeze & Polish)
- Progressive Disclosure & Visual De-Cluttering: Consolidating overlapping toolbars, context menus, and dock headers so advanced HPC and reverse-engineering tools appear contextually when needed without overwhelming the primary viewport.
- Task-Focused Workspace Perspective Presets: 1-click and auto-switching layout perspectives (Source & MPI Debugging, Binary CFG & Decompiler, Memory & Numerical Profiling, Post-Mortem Crash Triage) with clean splitter proportions and zero clipped headers across 1080p, 1440p, and 4K/tiling Wayland setups.
-
Unified Cross-View Selection, Navigation & Theme Harmony: Consistent typography, spacing, badge semantics, keyboard navigation (
Ctrl+Shift+P), and synchronized address/symbol/rank selection across all docks and pop-out windows. -
Real-World Dogfooding &
v1.0.0Release Readiness: Addressing community and production HPC user feedback, hardening OpenMPI/MPICH/SLURM edge cases, and stabilizing ABI/config compatibility forv1.0.0.
GridLock Repository | Releases | Report an Issue | Roadmap | Accessibility | License (MIT)
Documentation mirrored from docs/ on master.
User Guides
Architecture & Plan
Developer Docs