@gluecharm-lab/easyspecs-cli 0.0.26 → 0.0.27

package/commands.md

@@ -85,6 +85,15 @@ When Analysis (or other callers) passes a **`diagnosticLog`** sink into the exte
 
 Tune concurrent agents with **`easyspecs.workstations.maxConcurrentAi`**, **`applyHostConcurrencyCap`**, and **`easyspecs-cli workstation info`** (**SRS-62** / **SRS-64**); these lines help interpret **live** pressure alongside that configuration.
 
+### Workstation pool host pressure (**SRS-68**)
+
+While the synthesis / remediation **workstation pool** has **≥ 1** in-flight OpenCode run, **`easyspecs-cli`** (human **`diagnosticLog`** / stderr path) emits a **pair** of lines every **45 seconds** (not configurable in v1 — **no** env/flag to disable):
+
+1. **`[host-pool]`** — **`activeWorkstations`**, **`staticMaxConcurrentAi`**, **`adaptiveMaxConcurrentAi`**, host RAM bytes, **`load1`**, **`load1PerCpu`**, optional Linux **`swapTotalB` / `swapFreeB`**, and four hints: **`hintScheduler`**, **`hintMemory`**, **`hintLimits`**, **`hintIo`** each **`OK`**, **`KO`**, or **`UNK`**. Hints are **heuristic** (not proof of root cause).
+2. **`[host-pool-rec]`** — **`kind=none`** when no hint is **`KO`**; otherwise **`kind=advice text=…`** with short guidance tuned for **dedicated workers** (e.g. **Celery** running only this task): lower **`easyspecs.workstations.maxConcurrentAi`**, worker memory/CPU limits, **`ulimit`**, disk checks — **not** “close other desktop apps”. **`text=`** is capped in length and may truncate with **` …`**.
+
+See **[SRS-68](../../.gluecharm/docs/srs/srs-68.md)** and **`USER-MANUAL-SRS-68.md`**.
+
 ---
 
 ## Shared configuration (SRS-43)