snxraven/bare-operating-system
1
1
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Update btop

Browse Source
This commit is contained in:
Raven Scott
2026-04-05 17:07:57 -04:00
parent 7c6b77ed62
commit f3c8ef1fc5
33 changed files with 9771 additions and 1090 deletions
Download Patch File Download Diff File Expand all files Collapse all files
handbook/09-posix-utilities-shell-and-vfs.md
+1 -1
View File
@@ -247,7 +247,7 @@ When **`BARE_OS_VFS_UNION_PREFIXES`** overlays the personal drive on system path
### 5.2a1 Session monitor (`baretop`)
- **`baretop`** / **`btop`** — Full-screen **htop-style** terminal dashboard for **session / operator** state plus a **logical process table** from **`/proc/bare_os/process_table.json`** (schema 7 synthetic PIDs — not host OS PIDs). Pulls **`/proc/bare_os/metrics_live.json`** ( **`schema` 4** — replication live, kernel counters, warm cache, IPC, boot budgets, swarm lifecycle, embedded **`processTable`** when present), **`ctx.bareOsReadProcMetricsLive`**, **`/proc/bare_os_resources`** / **`ctx.bareOsGetResourceStatus`**, pseudo **`/proc/meminfo`** / **`loadavg`** / **`cpuinfo`**, **`ctx.bareOsReadBareTopSnapshot`** (optional **`{ lite: true }`** for a smaller batch), plus optional **`ctx.bareOsReadDelegateFairnessSnapshot`**, **`ctx.bareOsReadSubprocessBridgeSnapshot`**, **`ctx.bareOsHostStats`**. **Eleven tabs:** **overview** (pinned HUD + **scrollable** sections: delegates, replication, kernel counters, budgets, initd readiness, etc.; **`BARE_TOP_OVERVIEW_COMPACT`**, **`BARE_TOP_OVERVIEW_SECTIONS`**, **`/`** filters section titles), **processes** (sort **`pid`/`name`/`state`/`time`**, **F6**/**S**, **V** tree, **TIME+** column, state colors, optional **`BARE_TOP_MOUSE`**, **`ctx.bareOsSendSignal`** via **`k`** / **F9**), initd, network, features, diagnostics, operator, Pear, catalog, host (**`[`** **`]`**), keys. **`1`–`9`** jump first nine tabs; **`0`** = keys. **`r`**/**F5** refresh burst; pause skips live **`tick`** until **`.`** step or refresh. Shell aliases **`top`** / **`btop`** → **`baretop`**. See **`src/baretop.js --help`** and **`man baretop`** for env (**`BARE_TOP_SNAPSHOT_LITE`**, **`BARE_TOP_EXPORT_REDACT`**, **`BARE_TOP_HEALTH_DETAIL`**, …). Source: **`src/baretop.js`** + **`lib/baretop-snapshot.js`**, **`lib/baretop-ui-helpers.js`**, **`lib/baretop-tui.js`**.
- **`baretop`** / **`btop`** — Full-screen **htop-style** terminal dashboard for **session / operator** state plus a **logical process table** from **`/proc/bare_os/process_table.json`** (schema 7 synthetic PIDs — not host OS PIDs). Pulls **`/proc/bare_os/metrics_live.json`** ( **`schema` 4** — replication live, kernel counters, warm cache, IPC, boot budgets, swarm lifecycle, embedded **`processTable`** when present), **`ctx.bareOsReadProcMetricsLive`**, **`/proc/bare_os_resources`** / **`ctx.bareOsGetResourceStatus`**, pseudo **`/proc/meminfo`** / **`loadavg`** / **`cpuinfo`**, **`ctx.bareOsReadBareTopSnapshot`** (optional **`{ lite: true }`** for a smaller batch), plus optional **`ctx.bareOsReadDelegateFairnessSnapshot`**, **`ctx.bareOsReadSubprocessBridgeSnapshot`**, **`ctx.bareOsHostStats`**. **Eleven tabs:** **overview** (pinned HUD + **scrollable** sections: delegates, replication, kernel counters, budgets, initd readiness, etc.; **`BARE_TOP_OVERVIEW_COMPACT`**, **`BARE_TOP_OVERVIEW_SECTIONS`**, **`/`** filters section titles), **processes** (sort **`pid`/`name`/`state`/`time`**, **F6**/**S**, **V** tree, **TIME+** column, state colors, optional **`BARE_TOP_MOUSE`**, **`ctx.bareOsSendSignal`** via **`k`** / **F9**), initd, network, features, diagnostics, operator, Pear, catalog, host (**`[`** **`]`**), keys. **`1`–`9`** jump first nine tabs; **`0`** = keys. **`r`**/**F5** refresh burst; pause skips live **`tick`** until **`.`** step or refresh. Shell aliases **`top`** / **`btop`** → **`baretop`**. **`bareOsReadBareTopSnapshot`** may return **`metricsLiveText`** (same JSON as **`metrics_live.json`**) so the client can skip a duplicate read. The composite **health** score treats operational **`replicationLive.stallHint`** values (**`no_peers`**, **`length_unavailable`**, **`ok`**) as non-fault. **`BARE_TOP_INCREMENTAL=2`** enables experimental line-diff terminal updates; **`BARE_TOP_LAYOUT_AUTO=1`** picks a wide split on large terminals; **F2** setup hints, **F3**/**F4** process row jump, **F10** quit. See **`src/baretop.js --help`** and **`man baretop`** for env (**`BARE_TOP_SNAPSHOT_LITE`**, **`BARE_TOP_EXPORT_REDACT`**, **`BARE_TOP_HEALTH_DETAIL`**, …). Source: **`src/baretop.js`** + **`lib/baretop-snapshot.js`**, **`lib/baretop-ui-helpers.js`**, **`lib/baretop-tui.js`**.
#### 5.2a1a Operator proc catalog (baretop panels)