v0.3.0

Added

• RPM packages for Rocky Linux 9 and 10 and the latest Fedora (x86_64, aarch64) in a signed dnf repository at https://gsi-hpc.github.io/unjam/rpm/; unjam-release installs its configuration and key.
• Install with mise use -g github:GSI-HPC/unjam; mise verifies the release's build-provenance attestation. A workflow checks this after each release.
• z pauses the live view and resumes it; the header shows [paused].
• The header shows the job name after the job id.
• --rule takes its fields split by spaces (--rule '* . 2s c') and intervals with units.

Changed

• The footer starts with ? help q quit, shows a new log line for 10 s, and shows an applied filter with how to edit or clear it.
• The help pane lists the keys of the mode with a column legend, in a titled pane that fits 80×24.
• / edits the current filter instead of clearing it. The filter ignores case, also matches a process's comm and a cgroup's path, and keeps a match's whole subtree.
• space, p, + and - on a process row act on its cgroup; ← on a leaf moves to its parent.
• The detail popup shows the full command line, CPU as %, char values as letters, and the sums of job and step rows.
• Replay names the recorded interval, shows [end], and its header line 2 shows the position in the recording.
• The table aligns with the header: its text starts one cell in, and the headings of number columns are right-aligned like the numbers.
• On a narrow terminal the header lines and the footer drop whole fields and key hints instead of cutting a value or the clock; footer keys show in the accent colour.
• The detail and help panes pad their text by one cell, also on wrapped lines, and the detail pane names the node on its first line.
• Flat rows have no tree guides, and a process cut off at the bottom of the window no longer shows └.
• Marks are underlined in every theme (amber marks did not show), and mono's cursor row has no grey slab in the history column.
• --help groups the attach flags under "Slurm attach (with --slurm)" and says that --slurm and --bcast take a value only with =.

Fixed

• The agent keeps sampling after a backward wall-clock step, and a forward step no longer ends it through the keepalive.
• A process that execs after it was first seen shows its new command name and line.
• An unreadable file, such as another user's /proc/<pid>/io, explains its NA with one warning per agent.
• Nodes without the io or pids controllers retry the absent files once per 10 s instead of on every tick.
• IO-R/s and IO-W/s are no longer doubled on nodes with LVM, dm-crypt or md disks.
• --slurm refuses to attach when the agent's own step is not below /sys/fs/cgroup (a cgroup namespace with a host-view mount), instead of sampling every cgroup on the node.
• --slurm=<array job id> attaches to the array's running task and lists the tasks when several run.
• --interval, record --interval and the +/- keys round to the nearest 100 ms, like --rule.
• --unlink-self no longer fails when another agent already removed a shared --bcast copy.
• A cgroup or process whose removal line was lost no longer stays with frozen values after a resync.
• Nodes whose subtrees are all off are no longer shown stale between their 10 s rescans.
• A node whose agent speaks another wire protocol is logged instead of staying blank.
• Keys act on the highlighted row even when new data has re-sorted the table.
• The node heat strip bands relative to the busiest node, so imbalance between many-core nodes shows.
• The TUI recording is finished when the viewer exits on an error, such as --batch into | head; --batch also quits on SIGTERM and SIGHUP.
• TUI recordings store each tick before the next tick's structure changes are applied.
• A backward seek in replay restores the rates of entities on slow rules.
• Replay of several journals steps by sampling round instead of one node at a time.
• unjam record prints why it runs the app unrecorded before it does.
• CPU% of 1000% and more is shown in full instead of as 6.9k%.
• Rows whose level is off and the rows of stale nodes show no values instead of their last ones; stale nodes read (stale).
• The first --batch snapshot waits for every node's first rate; its footer counts the nodes that never reported, and | head exits 0.
• At 80 columns, NAME no longer loses its width to an INT W that every row shares; cut names end in …; NAME stops at 72 cells on wide terminals; a terminal below 80×8 says so.
• The local header labels the host CPU as a share of all CPUs.
• The scroll position no longer leaves the last page part-empty.
• Without --batch, a stdout that is not a terminal fails with a hint instead of drawing into it.
• Common setup errors say what is wrong: missing Slurm commands, an unknown job, no running jobs, --bcast on another user's job, a bad UNJAM_THEME, a file that is no recording, a missing --root.
• --record shows rec failed when no journal could be opened, reports the recording on stderr at exit and exits 1 when it failed; a node stale before the start is not recorded.
• The heat strip shows bands by height as well as colour, with a "nodes per cell" legend; history bars of many-core nodes band against the busiest node; amber has an ASCII ramp.
• t no longer leaves mono while NO_COLOR is set.
• Header rates are taken over one interval, so they no longer drop to 0 every other second; small byte rates show B/s.
• Intervals of 1 s and more read 7.5s, not 7500ms.
• "srun ended" is logged only after some node reported.
• --at accepts a trailing Z, refuses out-of-range times, and no longer jumps to the end for a time before the start.
• Replay warns about a repeated host or files of another job or step.
• Replay of unjam record files names the step by its id, and flat replay lists processes, not task cgroups.
• Replay ignores the rule keys.

Security

• The --bcast copy gets a name other users cannot guess, and --bcast into another user's job is refused.
• Journals are created owner-only (0600) and TUI recording directories 0700; an agent-reported host name can no longer place a TUI journal outside the recording directory.
• A crafted journal with a cgroup parent cycle no longer overflows the stack during replay.
• --batch prints control characters in names as ?.

Changed

• The local host memory bar keeps /proc/meminfo open, and drawing no longer allocates per bar cell.
• mise run bench reports sampler and viewer benchmarks.
• CI: clippy errors fail the checks, the arm64 release binary is run before release, and cargo publish skips its verify build while the crates.io token is set.

v0.2.0

Added

• Terminal UI over the cgroup v2 tree with step, node and flat layouts, themes and a local-mode viewer.
• cgroup and /proc metric sources with a file-descriptor cache, and a sampler with per-entity rules.
• Hidden agent command with line-based agent and control protocols.
• unjam --slurm[=JOBID] attaches to a Slurm job through srun --overlap.
• --unlink-self makes the agent remove an srun --bcast copy of itself.
• unjam record -- CMD records a job step to an Arrow IPC journal (LZ4 frames) with unit, kind and source field metadata.
• unjam --replay FILE... replays one or more journals with play, step and jump keys, --at TIME and --batch N.
• r and --record DIR record the live view to one journal per node.
• Integration tests on sind (Slurm in Docker) for attach, isolation, rules, teardown, load, --bcast, record and replay.
• Architecture design document and usage, site and recording documentation.

Fixed

• Take the unified line of /proc/self/cgroup on hybrid cgroup hosts.

Changed

• Build: MSRV, lints and formatting; budget, binary size and dependency unsafe gates.
• CI: checks run through mise; release binaries are built with provenance.
• New dependencies: ratatui, arrow-ipc, arrow-array, arrow-schema and signal-hook.