pyre-cli 7.0.0 → 8.0.0

package/README.md

@@ -17,31 +17,35 @@ Mac system monitoring CLI: temps, CPU, memory, disk, battery, GPU, power draw, l
 - **Real-time system stats & per-core CPU** — CPU brand, cores, frequency, load, per-core utilization mini-bars, and overall usage
 - **GPU monitoring** — GPU model, VRAM, utilization, temperature, and process count (detailed mode)
 - **Power draw monitoring** — CPU watts, GPU watts, and combined power draw via SMC/ioreg
-- **Memory monitoring** — usage, swap, and total/available
+- **Memory monitoring & pressure** — usage, swap, wired, compressed, purgeable, swapins/outs, and kernel VM pressure level
 - **Disk I/O throughput & space** — read/write speed per volume and mounted volume space usage
 - **Battery & power health** — level, power source, condition, charge cycles, max capacity, health trends, estimated time to empty, discharge rate, power draw in watts
 - **Packet monitor** — network packet counts, packet rates, active TCP connections, top network processes
 - **Task list** — running tasks/applications sorted by CPU with PID, user, memory, state, and runtime
 - **Thermal state** — CPU temperature via `pmset` and `powermetrics` (sudo for detailed readings)
 - **Network** — RX/TX bytes and per-second rates
-- **Top processes & search-as-you-type** — live filtering, tree view, sorting by CPU/memory/PID, and process kill with signal picker
+- **Top processes & search-as-you-type** — live filtering, tree view, sorting by CPU/memory/PID, and process kill with protected PID confirmation guard
 - **Interactive live dashboard** — full-screen TUI with keyboard-driven controls, mouse support, configurable panel layout, and tab-based panel navigation
 - **Snapshot export** — JSON, CSV, TSV, HTML, or Markdown output formats
-- **Continuous CSV logging** — automatic per-tick data logging to timestamped files with log rotation
+- **Continuous CSV logging & Anomaly Digest** — automatic per-tick logging and statistical spike analysis (`pyre anomalies`)
 - **Visual themes & custom themes** — six built-in color themes plus user-defined JSON theme support in `~/.config/pyre/themes/`
-- **Persistent configuration** — save default themes, intervals, and thresholds in `~/.config/pyre/config.json`
+- **Persistent configuration & Profiles** — save themes and thresholds in `~/.config/pyre/config.json`, plus atomic profile management (`pyre profile`)
 - **Alert system & webhooks** — configurable threshold alerts with terminal bell, desktop notifications, webhook POST payload execution (`--webhook-url`), and custom shell command execution (`--alert-cmd`)
-- **System diagnostic tool (`pyre doctor`)** — check permissions, SMC access, network reachability, and configuration health
+- **System diagnostic tool (`pyre doctor`)** — check permissions, SMC access, Gatekeeper, SIP status, XProtect definitions, and P2P reachability
+- **Security & Ecosystem inspectors** — System Extensions inspector (`pyre extensions`), Homebrew health (`pyre brew`), and Time Machine backup status
+- **Accessible plain-text mode** — `--plain`/`--a11y` mode for screen readers and ANSI-free logging
+- **Grafana Integration** — ready-to-import Grafana dashboard template (`grafana/pyre-dashboard.json`)
 - **History & Snapshot Diff** — query historical CSV log trends (`pyre history`) and compare snapshot files side-by-side (`pyre diff`)
 - **Multi-host fleet dashboard** — stream and tile stats from multiple remote Macs (`pyre fleet`)
 - **Menu Bar & xbar integration** — generate menu bar plugin script (`pyre xbar`) for continuous background status display
 - **Graph mode toggle** — switch between sparkline and bar graph rendering in the live dashboard
 - **P2P dashboard panel** — monitor P2P server status and peer events directly from the live dashboard
 - **Temperature unit toggle** — switch between Celsius and Fahrenheit display in live mode
-- **Hardware overview** — `pyre info` prints a concise hardware summary
+- **Hardware & Displays overview** — `pyre info` prints hardware, connected displays, and Time Machine status
 - **Remote SSH monitoring** — `pyre ssh <host>` streams a remote Mac's live dashboard locally
 - **Web dashboard** — `pyre web` serves an auto-refreshing HTML dashboard with real-time SSE stream on a local port
-- **Micro-benchmarking** — `pyre bench <cmd>` logs resource usage during any command
+- **Micro-benchmarking & Energy Cost** — `pyre bench <cmd>` logs resource usage and estimates energy consumption/cost (kWh)
+- **Update checker** — `pyre update` checks npm registry for new pyre-cli releases
 
 ## Installation
 
@@ -63,17 +67,21 @@ curl -fsSL https://raw.githubusercontent.com/somalip/pyre/main/install.sh | bash
 pyre                           # Static snapshot, all system stats
 pyre --detailed                # Include sensor / powermetrics detail
 pyre --json                    # JSON output (also --csv, --tsv, --html, --md)
-pyre --html --out report.html  # Self-contained HTML report
+pyre --plain                   # Plain-text accessible output without ANSI noise
 
 pyre live                      # Interactive live dashboard
 pyre live --interval 3 --log   # Custom refresh interval + auto-logging
 pyre live --alert-cpu 80 --alert-temp 85 --temp-unit f
 
-pyre server                    # Print ready-to-paste P2P server/client commands for your LAN
-pyre info                      # Concise hardware overview
-pyre ssh build-server          # Stream remote Mac stats over SSH
-pyre web                       # Serve HTML dashboard on localhost
-pyre bench "make build"        # Log resources during a command
+pyre anomalies --since 7d      # Statistical resource spike digest from past CSV logs
+pyre doctor                    # System diagnostics (Gatekeeper, SIP, XProtect, powermetrics)
+pyre extensions                # System extensions inspector (systemextensionsctl)
+pyre brew                      # Homebrew health summary & cellar size
+pyre update                    # Check for pyre-cli updates
+pyre profile save dev          # Save active configuration profile
+pyre profile load dev          # Load configuration profile
+pyre info                      # Concise hardware, display & Time Machine overview
+pyre bench "make build"        # Benchmark command & estimate kWh energy cost
 ```
 
 ## Options Reference
@@ -87,7 +95,9 @@ These options apply to both static snapshots and `pyre live`, except where noted
 | `--md` | Output as Markdown |
 | `-c, --csv` | Output as CSV |
 | `-t, --tsv` | Output as TSV |
+| `--plain` / `--a11y` | Plain text output mode without ANSI colors or line-drawing characters |
 | `--detailed` | Include detailed system info and sensor readings |
+| `--since <range>` | Time range for anomaly digest (e.g. `1d`, `7d`, `yesterday`) |
 | `--theme <name>` | Theme for live mode (`default`, `dracula`, `cyberpunk`, `monochrome`, `nord`, `gruvbox`) |
 | `--interval <seconds>` | Refresh interval for live mode (default: `2`) |
 | `--once` | Show a single static snapshot instead of live feed |
@@ -115,7 +125,11 @@ These options apply to both static snapshots and `pyre live`, except where noted
 | `pyre --json` | JSON output |
 | `pyre --html` | Self-contained HTML report |
 | `pyre --md` | Markdown tables |
-| `pyre doctor` | Run system diagnostics (permissions, powermetrics access, P2P network check) |
+| `pyre doctor` | Run system diagnostics (permissions, Gatekeeper, SIP, XProtect, P2P network) |
+| `pyre extensions` | System Extensions inspector (`systemextensionsctl list`) |
+| `pyre brew` | Homebrew health panel (installed formulae, outdated count, Cellar disk size, doctor summary) |
+| `pyre update` | Check npm registry for latest `pyre-cli` release |
+| `pyre profile <save\|load\|list> [name]` | Atomic configuration profile management (`~/.config/pyre/profiles/`) |
 | `pyre config <show\|reset>` | View or reset persistent configuration file (`~/.config/pyre/config.json`) |
 | `pyre completions <zsh\|bash\|fish>` | Generate shell auto-completion scripts |
 
@@ -123,7 +137,8 @@ These options apply to both static snapshots and `pyre live`, except where noted
 
 | Command | Description |
 |---|---|
-| `pyre info` | Concise hardware summary (CPU, memory, GPU, battery, thermal) |
+| `pyre info` | Concise hardware summary (CPU, memory pressure, GPU, battery, displays, Time Machine) |
+| `pyre anomalies [--since N]` | Compute z-score anomalies and print plain-language resource spike digest |
 | `pyre history [--days N]` | Graph historical resource trends from CSV logs over past N days |
 | `pyre diff <file1.json> <file2.json>` | Compare two saved snapshot files side-by-side |
 
@@ -131,7 +146,7 @@ These options apply to both static snapshots and `pyre live`, except where noted
 
 | Command | Description |
 |---|---|
-| `pyre bench <cmd>` | Log CPU, memory, network, and thermal usage while running a command |
+| `pyre bench <cmd>` | Log CPU, memory, network, power draw, and estimate kWh energy cost during command execution |
 | `pyre xbar` | Generate an xbar / SwiftBar menu bar plugin script for stats display |
 
 ### Remote & Multi-host monitoring
@@ -425,11 +440,16 @@ timestamp,cpu_usage,mem_usage_percent,temp_c,net_rx_bytes,net_tx_bytes,net_rx_pa
 pyre/
 ├── src/
 │   ├── index.ts            # CLI entry point (commander definitions, main())
+│   ├── anomaliesCmd.ts     # Resource spike & anomaly digest generator
+│   ├── brewHealth.ts       # Homebrew health & cellar usage inspector
+│   ├── doctor.ts           # System diagnostics (permissions, Gatekeeper, SIP, XProtect)
+│   ├── extensions.ts       # System Extensions inspector (systemextensionsctl list)
+│   ├── updateCheck.ts      # Passive and on-demand npm registry version check
 │   ├── monitors/           # System metric collection (CPU, memory, disk, battery, thermal, network, packets, power, tasks)
 │   │   ├── index.ts        # Public API: collectAll, collectPower, collectPackets, collectTasks
 │   │   ├── types.ts        # TypeScript interfaces for all metric types
 │   │   ├── smc.ts          # SMC sensor reading with caching
-│   │   ├── collectors.ts   # Individual metric collectors and orchestrator
+│   │   ├── collectors.ts   # Individual metric collectors, displays, Time Machine, and orchestrator
 │   │   └── run.ts          # Shared shell-execution helper
 │   ├── formatters/         # Output formatting and rendering
 │   │   ├── index.ts        # Public API: formatTable, formatJson, formatCsv, formatTsv, formatGraphs
@@ -440,7 +460,7 @@ pyre/
 │   ├── live/               # Interactive live dashboard
 │   │   ├── index.ts        # Public API: startLive, stopLive
 │   │   ├── state.ts        # Shared mutable session state
-│   │   ├── input.ts        # Keypress handling and session lifecycle
+│   │   ├── input.ts        # Keypress handling, signal picker, protected PID kill guards
 │   │   ├── render.ts       # Screen rendering and alert checking
 │   │   ├── export.ts       # Snapshot export and CSV logging
 │   │   └── types.ts        # LiveOptions, ExportFormat, InputMode, SortMode
@@ -450,10 +470,13 @@ pyre/
 │   │   ├── protocol.ts     # Length-prefixed JSON message framing
 │   │   ├── server.ts       # TCP server: auth, TLS, rate limiting, IP filtering, audit logging, HMAC signing, data streaming
 │   │   └── client.ts       # TCP client that connects and displays live data
+│   ├── state/              # Config & profile state management
+│   │   └── config.ts       # Config file I/O & atomic profile save/load
 │   ├── history.ts          # Rolling history buffer for sparkline data
-│   ├── sparkline.ts        # ASCII sparkline rendering
+│   ├── sparkline.ts        # ASCII sparkline rendering & plain-text mode
 │   └── utils/              # Shared utility functions
 ├── dist/                   # Built output (esm)
+├── grafana/                # Grafana dashboard JSON template
 ├── pyre-exports/           # Default directory for snapshot exports and logs
 ├── Formula/                # Homebrew formula
 ├── install.sh              # curl installation script

package/dist/anomaliesCmd-TO52YY2B.js

@@ -0,0 +1,117 @@
+// src/anomaliesCmd.ts
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+function runAnomaliesDigest(opts = {}) {
+  const dir = opts.dir || "./pyre-exports";
+  const sinceStr = opts.since || "7d";
+  console.log(chalk.bold(`
+  pyre anomalies \u2014 Resource Spike & Anomaly Digest
+`));
+  if (!fs.existsSync(dir)) {
+    console.log(chalk.yellow(`  No logs directory found for range '${sinceStr}' at ${dir}.`));
+    console.log(chalk.dim("  Enable background logging with `pyre --log` to record history.\n"));
+    return;
+  }
+  const files = fs.readdirSync(dir).filter((f) => f.startsWith("pyre-log-") && f.endsWith(".csv"));
+  if (files.length === 0) {
+    console.log(chalk.yellow(`  No CSV logs found for range '${sinceStr}' in ${dir}.`));
+    console.log(chalk.dim("  Enable background logging with `pyre --log` to record history.\n"));
+    return;
+  }
+  let cutoff = Date.now() - 7 * 24 * 60 * 60 * 1e3;
+  if (sinceStr === "yesterday" || sinceStr === "1d") {
+    cutoff = Date.now() - 24 * 60 * 60 * 1e3;
+  } else if (sinceStr.endsWith("d")) {
+    const d = parseInt(sinceStr.slice(0, -1), 10);
+    if (!isNaN(d)) cutoff = Date.now() - d * 24 * 60 * 60 * 1e3;
+  } else if (!isNaN(Date.parse(sinceStr))) {
+    cutoff = Date.parse(sinceStr);
+  }
+  const rows = [];
+  for (const file of files.sort()) {
+    const fullPath = path.join(dir, file);
+    try {
+      const content = fs.readFileSync(fullPath, "utf-8");
+      const lines = content.split("\n").slice(1);
+      for (const line of lines) {
+        if (!line.trim()) continue;
+        const parts = line.split(",");
+        if (parts.length >= 3) {
+          const ts = new Date(parts[0]);
+          if (!isNaN(ts.getTime()) && ts.getTime() >= cutoff) {
+            const cpu = parseFloat(parts[1]);
+            const mem = parseFloat(parts[2]);
+            const temp = parts.length >= 4 ? parseFloat(parts[3]) : void 0;
+            const topProc = parts.length >= 5 ? parts[4] : void 0;
+            if (!isNaN(cpu) && !isNaN(mem)) {
+              rows.push({ ts, cpu, mem, temp: isNaN(temp) ? void 0 : temp, topProc });
+            }
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  if (rows.length < 5) {
+    console.log(chalk.yellow(`  Insufficient data recorded since ${sinceStr} (need at least 5 samples).`));
+    console.log(chalk.dim("  Run pyre with `--log` for longer intervals to build history.\n"));
+    return;
+  }
+  const cpuVals = rows.map((r) => r.cpu);
+  const memVals = rows.map((r) => r.mem);
+  const tempVals = rows.filter((r) => r.temp !== void 0).map((r) => r.temp);
+  const calcMeanStd = (arr) => {
+    if (arr.length === 0) return { mean: 0, std: 0 };
+    const mean = arr.reduce((a, b) => a + b, 0) / arr.length;
+    const variance = arr.reduce((a, b) => a + Math.pow(b - mean, 2), 0) / arr.length;
+    return { mean, std: Math.sqrt(variance) };
+  };
+  const cpuStats = calcMeanStd(cpuVals);
+  const memStats = calcMeanStd(memVals);
+  const tempStats = calcMeanStd(tempVals);
+  const anomalies = [];
+  for (const r of rows) {
+    if (cpuStats.std > 0) {
+      const z = (r.cpu - cpuStats.mean) / cpuStats.std;
+      if (z >= 2.5) {
+        anomalies.push({ ts: r.ts, metric: "CPU", value: r.cpu, baseline: cpuStats.mean, zScore: z, topProc: r.topProc });
+      }
+    }
+    if (memStats.std > 0) {
+      const z = (r.mem - memStats.mean) / memStats.std;
+      if (z >= 2.5) {
+        anomalies.push({ ts: r.ts, metric: "Memory", value: r.mem, baseline: memStats.mean, zScore: z, topProc: r.topProc });
+      }
+    }
+    if (r.temp !== void 0 && tempStats.std > 0) {
+      const z = (r.temp - tempStats.mean) / tempStats.std;
+      if (z >= 2.5) {
+        anomalies.push({ ts: r.ts, metric: "Temperature", value: r.temp, baseline: tempStats.mean, zScore: z, topProc: r.topProc });
+      }
+    }
+  }
+  console.log(`  Analyzed ${chalk.bold(rows.length)} samples since ${chalk.bold(sinceStr)}.`);
+  if (anomalies.length === 0) {
+    console.log(chalk.green("  \u2714 No statistical anomalies detected in this time range.\n"));
+    return;
+  }
+  console.log(chalk.yellow(`  \u26A0 Found ${anomalies.length} anomaly spike event(s):
+`));
+  for (const a of anomalies.slice(0, 15)) {
+    const timeFormatted = a.ts.toLocaleString();
+    const severityColor = a.zScore >= 3.5 ? chalk.red : chalk.yellow;
+    const unit = a.metric === "Temperature" ? "\xB0C" : "%";
+    console.log(`  \u2022 [${chalk.dim(timeFormatted)}] ${severityColor(a.metric)} spike: ${chalk.bold(a.value.toFixed(1) + unit)} (baseline: ${a.baseline.toFixed(1)}${unit}, +${a.zScore.toFixed(1)}\u03C3)`);
+    if (a.topProc) {
+      console.log(chalk.dim(`     Top Process: ${a.topProc}`));
+    }
+  }
+  if (anomalies.length > 15) {
+    console.log(chalk.dim(`  ... and ${anomalies.length - 15} more anomaly events.`));
+  }
+  console.log();
+}
+export {
+  runAnomaliesDigest
+};

package/dist/brewHealth-6NE37NAU.js

@@ -0,0 +1,74 @@
+import {
+  run
+} from "./chunk-GLH7EKAX.js";
+
+// src/brewHealth.ts
+import chalk from "chalk";
+async function getBrewHealth() {
+  try {
+    const brewPath = await run("which brew 2>&1", "");
+    if (!brewPath.trim() || brewPath.includes("not found")) {
+      return { installedCount: 0, outdatedCount: 0, cellarSize: "N/A", doctorWarnings: [], brewAvailable: false };
+    }
+    const outdatedRaw = await run("brew outdated --quiet 2>&1", "");
+    const outdatedLines = outdatedRaw.trim().split("\n").filter((l) => l.length > 0 && !l.startsWith("Homebrew") && !l.startsWith("==>"));
+    const listRaw = await run("brew list --formula -1 2>&1", "");
+    const listLines = listRaw.trim().split("\n").filter((l) => l.length > 0);
+    let cellarSize = "N/A";
+    try {
+      const cellarPath = await run("brew --cellar 2>&1", "");
+      if (cellarPath.trim()) {
+        const duRaw = await run(`du -sh "${cellarPath.trim()}" 2>&1`, "");
+        const duMatch = duRaw.match(/^([0-9\.\,]+[KMGTP]?i?B?)/i);
+        if (duMatch) cellarSize = duMatch[1];
+      }
+    } catch {
+      cellarSize = "N/A";
+    }
+    const doctorRaw = await run("brew doctor 2>&1", "");
+    const doctorWarnings = [];
+    const docLines = doctorRaw.split("\n");
+    for (const line of docLines) {
+      if (line.startsWith("Warning:")) {
+        doctorWarnings.push(line.replace(/^Warning:\s*/, "").trim());
+      }
+    }
+    return {
+      installedCount: listLines.length,
+      outdatedCount: outdatedLines.length,
+      cellarSize,
+      doctorWarnings,
+      brewAvailable: true
+    };
+  } catch (err) {
+    return { installedCount: 0, outdatedCount: 0, cellarSize: "N/A", doctorWarnings: [], brewAvailable: false };
+  }
+}
+async function printBrewHealthReport() {
+  console.log(chalk.bold("\n  pyre brew \u2014 Homebrew Health Summary\n"));
+  const health = await getBrewHealth();
+  if (!health.brewAvailable) {
+    console.log(chalk.yellow("  \u26A0 Homebrew is not installed or not available on PATH.\n"));
+    return;
+  }
+  console.log(`  \u{1F4E6} Installed Formulae: ${chalk.bold(health.installedCount)}`);
+  console.log(`  \u23F3 Outdated Packages:   ${health.outdatedCount > 0 ? chalk.yellow.bold(health.outdatedCount) : chalk.green("0 (Up to date)")}`);
+  console.log(`  \u{1F4BE} Cellar Disk Usage:  ${chalk.bold(health.cellarSize)}`);
+  console.log();
+  if (health.doctorWarnings.length === 0) {
+    console.log(chalk.green("  \u2714 brew doctor: No warnings detected system-wide."));
+  } else {
+    console.log(chalk.yellow(`  \u26A0 brew doctor warnings (${health.doctorWarnings.length}):`));
+    for (const warn of health.doctorWarnings.slice(0, 5)) {
+      console.log(chalk.dim(`     \u2022 ${warn}`));
+    }
+    if (health.doctorWarnings.length > 5) {
+      console.log(chalk.dim(`     ... and ${health.doctorWarnings.length - 5} more.`));
+    }
+  }
+  console.log();
+}
+export {
+  getBrewHealth,
+  printBrewHealthReport
+};

package/dist/chunk-GLH7EKAX.js

@@ -0,0 +1,15 @@
+// src/monitors/run.ts
+import { exec } from "child_process";
+import { promisify } from "util";
+var execAsync = promisify(exec);
+async function run(cmd, fallback = "", timeout = 5e3) {
+  try {
+    return (await execAsync(cmd, { encoding: "utf8", timeout })).stdout.trim();
+  } catch {
+    return fallback;
+  }
+}
+
+export {
+  run
+};