# pete702/pulse-task-manager architecture

> Architecture diagram of the GitHub repository pete702/pulse-task-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pete702/pulse-task-manager
- Repository: https://github.com/pete702/pulse-task-manager

## Overview

PULSE is a native Windows telemetry HUD and task manager. Its main workflow is to collect system and process metrics in a background worker, deliver snapshots to the app, and present them in tabbed views; the Processes tab also supports verified fleet actions such as trim, EcoQoS, and termination. The README documents RAM composition, disk I/O and spike detection, and network ping/jitter grading. Source excerpts show only portions of startup, app state, and worker behavior, so relationships not established by those excerpts or the README are omitted.

Main entry points: [`src/app.rs`](https://github.com/pete702/pulse-task-manager/blob/main/src/app.rs) (App state and commands), [`src/core/worker_loop.rs`](https://github.com/pete702/pulse-task-manager/blob/main/src/core/worker_loop.rs) (Telemetry worker), [`src/modules/cpu/table_menu_actions.rs`](https://github.com/pete702/pulse-task-manager/blob/main/src/modules/cpu/table_menu_actions.rs) (Process table actions), [`src/ui/chrome.rs`](https://github.com/pete702/pulse-task-manager/blob/main/src/ui/chrome.rs) (HUD chrome)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App Runtime"]
  node_entry["Application entry<br/>[main.rs]"]
  node_app["App state and commands<br/>[app.rs]"]
  node_tabs["Tab selection<br/>[app_tabs.rs]"]
end

subgraph group_collection["Telemetry Collection"]
  node_worker["Telemetry worker<br/>[worker_loop.rs]"]
  node_snapshot["System snapshots<br/>[mod.rs]"]
end

subgraph group_views["Telemetry Views"]
  node_cpu["CPU and processes<br/>[model.rs]"]
  node_memory["RAM composition<br/>[model.rs]"]
  node_storage["Disk I/O and spikes<br/>[view.rs]"]
  node_network["Network grade<br/>[model.rs]"]
  node_history["Memory history<br/>[history.rs]"]
  node_downsample["Chart downsampling<br/>[downsampling.rs]"]
end

subgraph group_process["Process Management"]
  node_process_table["Process table actions"]
  node_qos["EcoQoS controls<br/>[qos.rs]"]
  node_trim["Working-set trim<br/>[trim.rs]"]
  node_identity["Process identity gate<br/>[handle.rs]"]
end

subgraph group_support["Persistence and UI"]
  node_persist[("Saved app state<br/>[persist.rs]")]
  node_chrome["HUD chrome<br/>[chrome.rs]"]
  node_theme["Visual theme<br/>[theme.rs]"]
  node_i18n["Language support<br/>[mod.rs]"]
end

node_user(("PULSE user"))

node_user -->|"starts app"| node_entry
node_entry -->|"runs"| node_app
node_app -->|"controls telemetry"| node_worker
node_app -->|"selects tab"| node_tabs
node_tabs -->|"sets scan cadence"| node_worker
node_worker -->|"collects"| node_cpu
node_worker -->|"collects"| node_memory
node_worker -->|"collects"| node_storage
node_worker -->|"collects"| node_network
node_worker -->|"publishes"| node_snapshot
node_snapshot -.->|"delivers telemetry"| node_app
node_app -->|"renders tab"| node_storage
node_app -->|"renders tab"| node_network
node_memory -->|"records samples"| node_history
node_history -->|"downsamples series"| node_downsample
node_user -->|"requests actions"| node_process_table
node_process_table -->|"sets EcoQoS"| node_qos
node_process_table -->|"requests trim"| node_trim
node_qos -->|"verifies target"| node_identity
node_trim -->|"verifies target"| node_identity
node_app -->|"loads state"| node_persist
node_app -->|"renders HUD"| node_chrome
node_chrome -->|"uses styling"| node_theme
node_chrome -->|"uses labels"| node_i18n

click node_entry "https://github.com/pete702/pulse-task-manager/blob/main/src/main.rs"
click node_app "https://github.com/pete702/pulse-task-manager/blob/main/src/app.rs"
click node_tabs "https://github.com/pete702/pulse-task-manager/blob/main/src/app_tabs.rs"
click node_worker "https://github.com/pete702/pulse-task-manager/blob/main/src/core/worker_loop.rs"
click node_snapshot "https://github.com/pete702/pulse-task-manager/blob/main/src/core/mod.rs"
click node_cpu "https://github.com/pete702/pulse-task-manager/blob/main/src/modules/cpu/model.rs"
click node_memory "https://github.com/pete702/pulse-task-manager/blob/main/src/modules/memory/model.rs"
click node_storage "https://github.com/pete702/pulse-task-manager/blob/main/src/modules/storage/view.rs"
click node_network "https://github.com/pete702/pulse-task-manager/blob/main/src/modules/network/model.rs"
click node_history "https://github.com/pete702/pulse-task-manager/blob/main/src/modules/memory/history.rs"
click node_downsample "https://github.com/pete702/pulse-task-manager/blob/main/src/core/downsampling.rs"
click node_process_table "https://github.com/pete702/pulse-task-manager/blob/main/src/modules/cpu/table_menu_actions.rs"
click node_qos "https://github.com/pete702/pulse-task-manager/blob/main/src/platform/qos.rs"
click node_trim "https://github.com/pete702/pulse-task-manager/blob/main/src/platform/trim.rs"
click node_identity "https://github.com/pete702/pulse-task-manager/blob/main/src/platform/handle.rs"
click node_persist "https://github.com/pete702/pulse-task-manager/blob/main/src/core/persist.rs"
click node_chrome "https://github.com/pete702/pulse-task-manager/blob/main/src/ui/chrome.rs"
click node_theme "https://github.com/pete702/pulse-task-manager/blob/main/src/theme.rs"
click node_i18n "https://github.com/pete702/pulse-task-manager/blob/main/src/i18n/mod.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_app,node_tabs,node_user toneBlue
class node_worker,node_snapshot toneAmber
class node_cpu,node_memory,node_storage,node_network,node_history,node_downsample toneMint
class node_process_table,node_qos,node_trim,node_identity toneRose
class node_persist,node_chrome,node_theme,node_i18n toneIndigo
```

## Components

### App Runtime

- [Application entry](https://github.com/pete702/pulse-task-manager/blob/main/src/main.rs): `src/main.rs`
- [App state and commands](https://github.com/pete702/pulse-task-manager/blob/main/src/app.rs): `src/app.rs`
- [Tab selection](https://github.com/pete702/pulse-task-manager/blob/main/src/app_tabs.rs): `src/app_tabs.rs`

### Telemetry Collection

- [Telemetry worker](https://github.com/pete702/pulse-task-manager/blob/main/src/core/worker_loop.rs): `src/core/worker_loop.rs`
- [System snapshots](https://github.com/pete702/pulse-task-manager/blob/main/src/core/mod.rs): `src/core/mod.rs`

### Telemetry Views

- [CPU and processes](https://github.com/pete702/pulse-task-manager/blob/main/src/modules/cpu/model.rs): `src/modules/cpu/model.rs`
- [RAM composition](https://github.com/pete702/pulse-task-manager/blob/main/src/modules/memory/model.rs): `src/modules/memory/model.rs`
- [Disk I/O and spikes](https://github.com/pete702/pulse-task-manager/blob/main/src/modules/storage/view.rs): `src/modules/storage/view.rs`
- [Network grade](https://github.com/pete702/pulse-task-manager/blob/main/src/modules/network/model.rs): `src/modules/network/model.rs`
- [Memory history](https://github.com/pete702/pulse-task-manager/blob/main/src/modules/memory/history.rs): `src/modules/memory/history.rs`
- [Chart downsampling](https://github.com/pete702/pulse-task-manager/blob/main/src/core/downsampling.rs): `src/core/downsampling.rs`

### Process Management

- [Process table actions](https://github.com/pete702/pulse-task-manager/blob/main/src/modules/cpu/table_menu_actions.rs): `src/modules/cpu/table_menu_actions.rs`
- [EcoQoS controls](https://github.com/pete702/pulse-task-manager/blob/main/src/platform/qos.rs): `src/platform/qos.rs`
- [Working-set trim](https://github.com/pete702/pulse-task-manager/blob/main/src/platform/trim.rs): `src/platform/trim.rs`
- [Process identity gate](https://github.com/pete702/pulse-task-manager/blob/main/src/platform/handle.rs): `src/platform/handle.rs`

### Persistence and UI

- [Saved app state](https://github.com/pete702/pulse-task-manager/blob/main/src/core/persist.rs): `src/core/persist.rs`
- [HUD chrome](https://github.com/pete702/pulse-task-manager/blob/main/src/ui/chrome.rs): `src/ui/chrome.rs`
- [Visual theme](https://github.com/pete702/pulse-task-manager/blob/main/src/theme.rs): `src/theme.rs`
- [Language support](https://github.com/pete702/pulse-task-manager/blob/main/src/i18n/mod.rs): `src/i18n/mod.rs`

### Other components

- **PULSE user**

## Connections

- PULSE user → Application entry: starts app (evidence: `README.md`)
- Application entry → App state and commands: runs (evidence: `src/main.rs`)
- App state and commands → Telemetry worker: controls telemetry (evidence: `src/app.rs`)
- App state and commands → Tab selection: selects tab (evidence: `src/app.rs`)
- Tab selection → Telemetry worker: sets scan cadence (evidence: `src/app_tabs.rs`)
- Telemetry worker → CPU and processes: collects (evidence: `src/core/worker_loop.rs`)
- Telemetry worker → RAM composition: collects (evidence: `src/core/worker_loop.rs`)
- Telemetry worker → Disk I/O and spikes: collects (evidence: `src/core/worker_loop.rs`)
- Telemetry worker → Network grade: collects (evidence: `src/core/worker_loop.rs`)
- Telemetry worker → System snapshots: publishes (evidence: `src/core/worker_loop.rs`)
- System snapshots → App state and commands: delivers telemetry (evidence: `src/app.rs`)
- App state and commands → Disk I/O and spikes: renders tab (evidence: `src/app.rs`)
- App state and commands → Network grade: renders tab (evidence: `src/app.rs`)
- RAM composition → Memory history: records samples (evidence: `src/modules/memory/history.rs`)
- Memory history → Chart downsampling: downsamples series (evidence: `src/modules/memory/history.rs`)
- PULSE user → Process table actions: requests actions (evidence: `README.md`)
- Process table actions → EcoQoS controls: sets EcoQoS (evidence: `src/modules/cpu/table_menu_actions.rs`)
- Process table actions → Working-set trim: requests trim (evidence: `src/modules/cpu/table_menu_actions.rs`)
- EcoQoS controls → Process identity gate: verifies target (evidence: `src/platform/qos.rs`)
- Working-set trim → Process identity gate: verifies target (evidence: `src/platform/trim.rs`)
- App state and commands → Saved app state: loads state (evidence: `src/app.rs`)
- App state and commands → HUD chrome: renders HUD (evidence: `src/app.rs`)
- HUD chrome → Visual theme: uses styling (evidence: `src/ui/chrome.rs`)
- HUD chrome → Language support: uses labels (evidence: `src/ui/chrome.rs`)
