Skip to content

feat(os-vitals): alerts, live settings, pause, and the listing images - #10

Merged
pblobp merged 11 commits into
mainfrom
feat/os-vitals-polish
Nov 18, 2026
Merged

pblobp merged 11 commits into
mainfrom
feat/os-vitals-polish

Conversation

@pblobp

@pblobp pblobp commented Nov 18, 2026

Copy link
Copy Markdown
Owner

What changed and why

The last build step for OS Vitals 1.0.0. Nothing is released by this change: the catalog stays empty and no tag is made.

  • Alerts: a memory alert fires after 30 seconds of critical pressure, or of use at or above the limit. It sends one notification naming the process using the most memory, then stays quiet for 10 minutes. The CPU alert is off by default and only changes the status bar tone. A notification Orca refuses is logged once and never retried.
  • Settings: all nine apply without a restart. A value outside its declared range is ignored and the default is used.
  • Pause: stops the panel's sampling and shows when the last reading was taken. The status bar and alerts keep running.
  • Accessibility: the lightest text tone failed 4.5:1 in three of four cases on Orca's default surfaces (as low as 3.17) and now passes in all of them (lowest 4.61). The two tabs are a real tab list with arrow keys. The process count no longer announces on every reading.
  • Layout fix, with a check that failed first: the details drawer covered the table's footer. The Processes view now fills the panel, the list scrolls inside it, and the footer sits above the drawer at every width from 220 to 640 px.
  • Listing: an icon, a cover and four screenshots in media/, generated from the panel's own code with sample data by tools/os-vitals/make-media.ts. The final plugin README and the 1.0.0 changelog.

Plugin

os-vitals

Access changes

None. The manifest gains only icon, cover and screenshots. Execution level, capabilities, commands, panels, status bar items, modules and programs are unchanged.

Tests

  • npm run check: formatting, policy, catalog and versions pass; 143 of 143 script tests pass.
  • orca plugin validate plugins/os-vitals --json: valid, including the image sizes and formats.
  • orca plugin test plugins/os-vitals --json: 23 of 23 worker tests pass, including one notification with the red tone, a refused notification, and all nine settings changed live.
  • node --test 'tests/os-vitals/**/*.test.ts': 272 of 272 pass.
  • A scripted layout check of every view at 220, 280, 400 and 640 px: no horizontal scroll, nothing past the edge, no overlapping rows.
  • Loaded in Orca 1.4.261: the Overview, the Processes view and a detail view draw after the last reload, with no new errors in the log.

Measured cost on an M4 Pro, worker plus the programs it runs: about 2.3% of one core with the Overview open, 0.13% with the panel closed, and none with background sampling off.

Not verified inside Orca itself, because its screenshot tool cannot click an HTML panel or switch theme while the window is visible: hover, keyboard and focus in the real panel, the light theme, and a real alert notification with its status bar tone. They are checked in the browser harness and with the test kit's mock host. The maintainer clicks through them by hand before the release.

Screenshots

The four listing screenshots and the cover are in plugins/os-vitals/media/ in this pull request.

🤖 Generated with Claude Code

https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD

pblobp and others added 11 commits November 17, 2026 18:35
A worker that samples CPU from node:os, an HTML panel with the
Overview CPU card, a status bar item, and the command that opens the
panel through Orca's CLI. The manifest already declares the final
access: two capabilities, one panel, one command, one status bar item.

Unit tests and the smoke test live outside the plugin folder, so they
are not installed.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
The worker reads memory from vm_stat and sysctl, the process list from
ps, and core kinds from ioreg. Process CPU comes from CPU time between
two readings. The panel gains the memory card, the top processes card,
and a sortable, filterable process table with a details drawer.

Processes are read only while a view shows them. Measured cost is
about 1.2% of one core with the Overview open and 0.16% in the
background.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
The worker sends the signal only after reading the process again and
matching its start time, owner and name. It refuses the worker's own
family, anything inside Orca's app bundle, and a protected set of
system and Orca processes. The panel confirms in a dialog, and offers
force quit when the process is still running five seconds later.

Also fixes the ancestor walk, which stopped at the worker's parent,
and re-sends a status bar update that Orca refused.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
CodeQL flagged the development server for returning an error's text
to the client. It now logs the error and answers with a fixed message.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
The worker reads network rates from netstat, disk activity and the GPU
from ioreg, volumes from df, the battery and sleep blockers from pmset,
and per-process energy impact from top. Energy is read only while its
view is open. Rates are counted per interface and per drive, so a
counter reset reads as zero.

The Overview gains four cards. Each card opens a detail view, and every
line chart has a crosshair and tooltip for pointer and keyboard.

The Orca rule in the protected set no longer catches unrelated apps
whose names merely start with the same letters.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
Linux reads /proc and /sys directly: memory with pressure, processes
with CPU from tick deltas, network, disk, volumes, AMD and NVIDIA GPUs
and the battery. Quitting works there through the same guards, and
kernel threads are never offered. Windows and other systems get CPU
and memory, and the panel says so once.

Disk and GPU are now read on every second tick outside their own
views, and energy every 10 seconds, which lowers the cost of the
Overview and of the Energy view.

Fixes the process table, whose rows collapsed when a filter was set.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
The worker raises a memory alert after 30 seconds of critical pressure
or use above the limit: one notification naming the largest process,
then ten minutes of silence. The CPU alert changes only the status bar
tone. All nine settings apply without a restart, and out-of-range
values are ignored. The pause control stops the panel's sampling.

The muted text now passes 4.5:1 on Orca's default surfaces, the tabs
are a real tab list, and the Processes view keeps its footer above the
details drawer at every width.

Adds the icon, cover and four screenshots, generated from the panel
code with sample data, and the final README and 1.0.0 changelog.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01EWVANCgSt8W3VxxxZyAyoD
@pblobp
pblobp merged commit 9d08946 into main Nov 18, 2026
11 checks passed
@pblobp
pblobp deleted the feat/os-vitals-polish branch November 18, 2026 12:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant