@gluecharm-lab/easyspecs-cli 0.0.25 → 0.0.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +1 -1
  2. package/commands.md +10 -1
  3. package/dist/main.cjs +496 -187
  4. package/dist/main.cjs.map +4 -4
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -247,7 +247,7 @@ Every command the CLI accepts, with command-specific tokens. Global flags above
247
247
  | ------- | ------------------------------- | ------------------ |
248
248
  | `help` or first token `--help` | — | Prints usage (same as **`--help`** before the command). |
249
249
  | `version` | — | Prints the CLI package version string. |
250
- | `doctor` | **`--readiness`**, **`--inspect-config`** (optional; default if none → readiness-style check) | Does **not** create **`config.json`**. **`--readiness`**: repo root, API URL, OpenCode, agents dir. **`--inspect-config`**: redacted merged settings + config JSON. Both flags together runs both. |
250
+ | `doctor` | **`--readiness`**, **`--inspect-config`** (optional; default if none → readiness-style check) | Does **not** create **`config.json`**. **`--readiness`**: **`cliVersion=`** (same as **`version`**), repo root, API URL, OpenCode, agents dir; **`--json`** adds **`cliVersion`** on the envelope. **`--inspect-config`**: redacted merged settings + config JSON. Both flags together runs both. |
251
251
  | `config init` | **`--overwrite`** (optional) | Writes **`.easyspecs/config.json`** with defaults; may import legacy **`.easyspecs/cli.json`** once if present. Existing file unchanged unless **`--overwrite`**. |
252
252
  | `config set-project-id <easyspecsProjectId>` | — | Sets **`easyspecs.easyspecsProjectId`** (creates config with defaults if missing). |
253
253
  | `config set-git-remote <url>` | — | Sets **`easyspecs.defaultGitRemoteUrl`** (same bootstrap-if-missing behaviour). |
package/commands.md CHANGED
@@ -85,6 +85,15 @@ When Analysis (or other callers) passes a **`diagnosticLog`** sink into the exte
85
85
 
86
86
  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.
87
87
 
88
+ ### Workstation pool host pressure (**SRS-68**)
89
+
90
+ 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):
91
+
92
+ 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).
93
+ 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 **` …`**.
94
+
95
+ See **[SRS-68](../../.gluecharm/docs/srs/srs-68.md)** and **`USER-MANUAL-SRS-68.md`**.
96
+
88
97
  ---
89
98
 
90
99
  ## Shared configuration (SRS-43)
@@ -158,7 +167,7 @@ Each row lists **command-specific CLI tokens**, then **what configuration applie
158
167
  | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
159
168
  | `help`, `--help` | — | Global options only; prints usage. |
160
169
  | `version` | — | Prints `[PKG_VERSION](../../src/cli/main.ts)` from the bundle. |
161
- | `doctor` | Optional `**--readiness`**, `**--inspect-config**` | **Does not** create `config.json`. Default (no flags) = `**--readiness`**: repo root, resolved API URL, OpenCode installed/credentials, agents dir. `**--inspect-config**` alone: redacted `**merged**` + `**easyspecsConfig**`. `**--readiness --inspect-config**`: both. Global flags apply (`**--cwd**`, `**--ci**`, `**--api-base-url**`, `**--session-path**`, `**--environment**`, `**--promote**` / `**--no-promote**`). |
170
+ | `doctor` | Optional `**--readiness`**, `**--inspect-config**` | **Does not** create `config.json`. Default (no flags) = `**--readiness`**: first line `**cliVersion=**` (same as **`version`** / **`--version`**), then repo root, resolved API URL, OpenCode installed/credentials, agents dir. With **`--json`**, readiness adds top-level **`cliVersion`** (string) plus **`lines`**. `**--inspect-config**` alone: redacted `**merged**` + `**easyspecsConfig**` (no **`cliVersion`** line). `**--readiness --inspect-config**`: both. Global flags apply (`**--cwd**`, `**--ci**`, `**--api-base-url**`, `**--session-path**`, `**--environment**`, `**--promote**` / `**--no-promote**`). |
162
171
  | `config init` | Optional `**--overwrite**` | Creates `**<repo>/.easyspecs/config.json**` with full defaults if missing; imports legacy `**cli.json**` / `**settings.json**` (ACE) when present, same as first-time bootstrap. If the file already exists, does nothing unless `**--overwrite**` (replaces with that bootstrap content). Does not run other commands. |
163
172
  | `config set-project-id <id>` | — | Writes `**easyspecs.easyspecsProjectId**` to `**config.json**`, replacing any previous value. Creates `**config.json**` (defaults + legacy import) if missing. |
164
173
  | `config set-git-remote <url>` | — | Writes `**easyspecs.defaultGitRemoteUrl**` to `**config.json**`, replacing any previous value. Same bootstrap-if-missing behaviour as `**set-project-id**`. |