bin/mem-report

#!/usr/bin/env ruby
# frozen_string_literal: true

require "json"
require "optparse"
require "open3"

options = { group_top: 20, json: false, color: true }

OptionParser.new do |opts|
  opts.banner = "Usage: mem-report [options]"
  opts.on("--group-top N", Integer, "Number of top groups to show (default: 20)") { options[:group_top] = it }
  opts.on("--json", "Output as JSON") { options[:json] = true }
  opts.on("--no-color", "Disable colored output") { options[:color] = false }
end.parse!

def run(cmd) = `#{cmd}`.strip

def human_bytes(mb)
  if mb >= 1024
    format("%.1f GB", mb / 1024.0)
  else
    format("%.0f MB", mb)
  end
end

# --- System memory summary ---

page_size = run("sysctl -n hw.pagesize").to_i
phys_mem_bytes = run("sysctl -n hw.memsize").to_i
phys_mem_mb = phys_mem_bytes / 1024.0 / 1024.0

vm_stat_output = run("vm_stat")
vm = {}
vm_stat_output.each_line do |line|
  case line
  when /Pages free:\s+([\d.]+)/          then vm[:free] = $1.to_i
  when /Pages active:\s+([\d.]+)/        then vm[:active] = $1.to_i
  when /Pages inactive:\s+([\d.]+)/      then vm[:inactive] = $1.to_i
  when /Pages speculative:\s+([\d.]+)/   then vm[:speculative] = $1.to_i
  when /Pages wired down:\s+([\d.]+)/    then vm[:wired] = $1.to_i
  when /Pages occupied by compressor:\s+([\d.]+)/ then vm[:compressor] = $1.to_i
  when /File-backed pages:\s+([\d.]+)/   then vm[:file_backed] = $1.to_i
  when /Pages purgeable:\s+([\d.]+)/     then vm[:purgeable] = $1.to_i
  end
end

to_mb = ->(pages) { (pages * page_size) / 1024.0 / 1024.0 }

used_mb = to_mb.call((vm[:active] || 0) + (vm[:wired] || 0) + (vm[:compressor] || 0) + (vm[:inactive] || 0))
cache_mb = to_mb.call((vm[:file_backed] || 0) + (vm[:purgeable] || 0))
app_mb = [used_mb - cache_mb, 0].max

system_summary = {
  physical_memory: phys_mem_mb.round(0),
  used_memory: used_mb.round(0),
  filesystem_cache: cache_mb.round(0),
  app_memory: app_mb.round(0),
  free_memory: to_mb.call((vm[:free] || 0) + (vm[:speculative] || 0)).round(0),
}

# --- Per-process memory (via ps) ---

ps_output = run("ps -axo pid=,user=,rss=,comm=")
processes = ps_output.each_line.filter_map do |line|
  parts = line.strip.split(/\s+/, 4)
  next if parts.size < 4

  pid, user, rss_kb, comm = parts
  rss_mb = rss_kb.to_f / 1024.0
  next if rss_mb < 0.1

  { pid: pid.to_i, user:, rss_mb:, command: comm }
end

# --- Grouped memory ---

GROUP_RULES = [
  [/com\.apple\.WebKit|Safari/i, "Safari / WebKit"],
  [/Simulator|CoreSimulator|simctl/i, "Simulator"],
  [/Xcode|SourceKit|clang|swift-frontend|IBAgent|XCBBuildService|devicectl/i, "Xcode Toolchain"],
  [/OrbStack|orbctl|orb-/i, "OrbStack"],
  [/Google Chrome|chrome_/i, "Google Chrome"],
  [/Arc|arc\./i, "Arc Browser"],
  [/Firefox|firefox/i, "Firefox"],
  [/Slack/i, "Slack"],
  [/Discord/i, "Discord"],
  [/Spotify/i, "Spotify"],
  [/docker|Docker/i, "Docker"],
  [/Terminal|iTerm|Alacritty|kitty|ghostty|WezTerm/i, "Terminal"],
  [/claude/i, "Claude"],
  [/WindowServer/, "WindowServer"],
  [/kernel_task/, "kernel_task"],
]

def group_name(command)
  GROUP_RULES.each do |pattern, name|
    return name if command.match?(pattern)
  end
  File.basename(command).sub(/\.\w+$/, "")
end

groups = Hash.new { |h, k| h[k] = { rss_mb: 0.0, count: 0 } }
processes.each do |proc|
  name = group_name(proc[:command])
  groups[name][:rss_mb] += proc[:rss_mb]
  groups[name][:count] += 1
end

top_groups = groups.sort_by { -it[1][:rss_mb] }.first(options[:group_top])

# --- Output ---

if options[:json]
  data = {
    system: system_summary.transform_values(&:to_i),
    top_groups: top_groups.map do |name, info|
      { group: name, rss_mb: info[:rss_mb].round(1), process_count: info[:count] }
    end,
    note: "RSS values and group sums can overcount shared memory (shared libraries, frameworks, mmap regions).",
  }
  puts JSON.pretty_generate(data)
  exit
end

bold  = options[:color] ? "\e[1m" : ""
dim   = options[:color] ? "\e[2m" : ""
cyan  = options[:color] ? "\e[36m" : ""
reset = options[:color] ? "\e[0m" : ""

puts "#{bold}=== System Memory ==#{reset}"
puts
puts "  Physical memory:    #{cyan}#{human_bytes(system_summary[:physical_memory])}#{reset}"
puts "  Used memory:        #{human_bytes(system_summary[:used_memory])}"
puts "  Filesystem cache:   #{human_bytes(system_summary[:filesystem_cache])}"
puts "  App memory:         #{cyan}#{human_bytes(system_summary[:app_memory])}#{reset}"
puts "  Free memory:        #{human_bytes(system_summary[:free_memory])}"
puts

puts "#{bold}=== Top #{options[:group_top]} Grouped Programs ==#{reset}"
puts
puts "  #{dim}%-28s %10s %8s#{reset}" % ["GROUP", "RSS", "PROCS"]
top_groups.each do |name, info|
  puts "  %-28s %10s %8d" % [name, human_bytes(info[:rss_mb]), info[:count]]
end
puts
puts "#{dim}Note: RSS and group sums can overcount shared memory (shared libs, frameworks, mmap).#{reset}"