release: v0.3.9 — process breakdown, tree view, TUI improvements (#86)

Author: zz85

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## v0.3.9
+
+### New Features
+
+- **Group by process** (`--group-by-process`) — prefix each stack with `process_name (pid)` to split flamegraphs into per-process sub-trees. Works with all output formats. (#86)
+- **TUI process list view** — new Processes tab (via Tab key) showing all processes sorted by sample count with CPU% bar visualization. Enter to zoom into a process.
+- **TUI expandable call tree** — press `t` to toggle tree mode in Top or Processes views. Shows a perf report-style expandable call tree with overhead% and self%, expand/collapse with Enter/h. Expanded state persists across live data refreshes.
+- **TUI PID mode toggle** — press `p` to toggle PID mode on the fly, splitting the flamegraph by process without restarting.
+- **CodeGuru idle stack classification** — idle/swapper stacks (pid == 0) now use the `IDLE` counter type, which CodeGuru excludes from CPU and Latency views.
+
 ## v0.3.8
 
 ### New Features

README.md

@@ -87,7 +87,7 @@ Run `probee` with no arguments or `probee --help` for the full list of options a
 - **Automatic termination** — stops when `--pid` target or `--cmd` process exits
 - **Rust & C++ demangling** — via gimli/blazesym
 - **BPF-based aggregation** — stack counting in kernel to reduce userspace data transfer
-- **Group by CPU** — per-core flamegraph breakdown
+- **Group by CPU / process** — per-core or per-PID flamegraph breakdown (`--group-by-cpu`, `--group-by-process`)
 
 ---
 
@@ -116,6 +116,9 @@ sudo probee --time 5000 --html out.html --json out.json --collapse out.txt --svg
 
 # Grouped by CPU
 sudo probee --svg profile.svg --frequency 999 --time 2000 --group-by-cpu
+
+# Grouped by process (each PID gets its own flamegraph sub-tree)
+sudo probee --svg profile.svg --time 5000 --group-by-process
 ```
 
 ### Targeting
@@ -237,12 +240,25 @@ cargo build --release --no-default-features
 | `hjkl` / arrows | Navigate cursor |
 | `Enter` | Zoom into selected frame |
 | `Esc` | Reset zoom |
+| `Tab` | Cycle views: Flamegraph → Top → Processes (→ Output) |
+| `t` | Toggle tree mode (expandable call tree in Top/Processes) |
+| `p` | Toggle PID mode (split flamegraph by process) |
 | `/` | Search frames with regex |
 | `#` | Highlight selected frame |
 | `n` / `N` | Next / previous match |
+| `m` | Cycle update mode: Accumulate / Reset / Decay |
 | `z` | Freeze / unfreeze live updates |
 | `q` or `Ctrl+C` | Quit |
 
+**Views:**
+
+| View | Description |
+|------|-------------|
+| **Flamegraph** | Interactive flame chart (default) |
+| **Top** | Flat function list sorted by overhead. Press `t` for expandable call tree. |
+| **Processes** | Process list with CPU% breakdown. `Enter` to zoom into a process. Press `t` for tree. |
+| **Output** | Child process stdout/stderr (when using `--cmd` or `--`) |
+
 ---
 
 ## Stack Unwinding

profile-bee-common/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "profile-bee-common"
-version = "0.3.8"
+version = "0.3.9"
 edition = "2021"
 license = "MIT"
 description = "Shared types between profile-bee userspace and eBPF programs"

profile-bee-tui/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "profile-bee-tui"
-version = "0.3.8"
+version = "0.3.9"
 edition = "2021"
 license = "MIT"
 description = "Terminal-based flamegraph viewer for profile-bee (forked from flamelens)"

profile-bee/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "profile-bee"
-version = "0.3.8"
+version = "0.3.9"
 edition = "2021"
 license = "MIT"
 description = "eBPF-based CPU profiler with flamegraph generation, DWARF unwinding, and interactive TUI"
@@ -20,8 +20,8 @@ include = [
 [dependencies]
 aya = { git = "https://github.com/Brskt/aya", rev = "9e8f2dc" }
 aya-log = { git = "https://github.com/Brskt/aya", rev = "9e8f2dc" }
-profile-bee-common = { version = "0.3.8", path = "../profile-bee-common", features=["user"] }
-profile-bee-tui = { version = "0.3.8", path = "../profile-bee-tui", optional = true }
+profile-bee-common = { version = "0.3.9", path = "../profile-bee-common", features=["user"] }
+profile-bee-tui = { version = "0.3.9", path = "../profile-bee-tui", optional = true }
 anyhow = "1.0.42"
 clap = { version = "4.0", features = ["derive"] }
 tokio = { version = "1.18", features = ["macros", "rt", "rt-multi-thread", "net", "signal", "time", "process"] }