@gluecharm-lab/easyspecs-cli 0.0.27 → 0.0.28

package/commands.md

@@ -68,9 +68,11 @@ Environment (stderr styling): `**NO_COLOR`** (any non-empty value) disables ANSI
 
 ---
 
-## Workstation host inventory (**SRS-64** / **SRS-62**)
+## Workstation host inventory (**SRS-69** / **SRS-62**)
 
-`**easyspecs-cli workstation info**` prints the CPU count used for the **SRS-64 §4.1** heuristic, total installed RAM, **`N_sys`** (JSON key **`maxSystemConcurrentAiWorkstations`**), and **`hostHardMaxConcurrentAi`** = **`min(N_sys, 64)`** (product agent ceiling per **SRS-62**). **macOS** (`darwin`) and **Linux** only; on other platforms the CLI exits **non-zero**, writes a short message to stderr, and does **not** print JSON on stdout (even if **`--json`** was passed).
+`**easyspecs-cli workstation info**` prints the CPU count used for the **SRS-69 §4** heuristic, total installed RAM, **`N_sys`** (JSON key **`maxSystemConcurrentAiWorkstations`**), and **`hostHardMaxConcurrentAi`** = **`min(N_sys, 64)`** (product agent ceiling per **SRS-62**). **macOS** (`darwin`) and **Linux** only; on other platforms the CLI exits **non-zero**, writes a short message to stderr, and does **not** print JSON on stdout (even if **`--json`** was passed).
+
+**Formula (SRS-69 §4 — supersedes SRS-64 §4.1):** `N_float = min(P, R_GiB / 8)` where **`P`** is the physical CPU count and **`R_GiB`** is total installed RAM in GiB. Then **`N_sys = max(1, Math.round(N_float))`** and **`hostHardMax = min(64, N_sys)`**. In plain English: **one AI workstation per physical core, but never more than one per 8 GiB of installed RAM** — whichever dimension is tighter wins. **Worked example:** **`P=11, R=44 GiB → N_sys = 6 → hostHardMax = 6`** (was 100 under SRS-64). Operators on shared / interactive hosts (laptops also running an IDE + browser + chat apps) should set **`easyspecs.workstations.maxConcurrentAi`** *below* the reported `hostHardMax`. See live signals via **`[host-pool]`** / **`[host-pool-rec]`** (**SRS-68**).
 
 Use the **global** **`--json`** flag (before the subcommand) for one parseable summary line. JSON includes **`totalMemBytes`**, **`platform`**, **`cpusForCap`**, **`cpusForCapSource`**, **`physicalCpus`** (integer when physical cores are known, else **`null`**), **`maxSystemConcurrentAiWorkstations`**, and **`hostHardMaxConcurrentAi`**.
 
@@ -83,7 +85,7 @@ When Analysis (or other callers) passes a **`diagnosticLog`** sink into the exte
 - **`scope=host`** — machine-wide **RAM** (**total** / **free** / **used** bytes) plus **1-minute load average**, logical **CPU** count, and **load / CPUs** (not the same metric as the **SRS-62** runtime pool **CPU guard** — see **[SRS-65](../../.gluecharm/docs/srs/srs-65.md)**).
 - **`scope=child`** — once per run: **child CPU time** (milliseconds) and **RSS** bytes for that **PID** (**Linux**: **`/proc`**, **macOS**: **`ps`**), or **`childRssBytes=unknown`** on unsupported platforms / read errors.
 
-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.
+Tune concurrent agents with **`easyspecs.workstations.maxConcurrentAi`**, **`applyHostConcurrencyCap`**, and **`easyspecs-cli workstation info`** (**SRS-62** / **SRS-69**); these lines help interpret **live** pressure alongside that configuration.
 
 ### Workstation pool host pressure (**SRS-68**)
 

package/dist/main.cjs

@@ -10707,7 +10707,7 @@ function createEasyspecsCliProgram() {
   program2.command("help").description("Show help");
   program2.command("version").description("Print CLI version");
   const workstation = program2.command("workstation").description("Host inventory for AI workstation sizing");
-  workstation.command("info").description("Print CPU, RAM, and SRS-64 N_sys (macOS and Linux only; use global --json)").allowUnknownOption(false);
+  workstation.command("info").description("Print CPU, RAM, and SRS-69 N_sys (macOS and Linux only; use global --json)").allowUnknownOption(false);
   program2.command("doctor").description("Check readiness and/or inspect configuration").option("--readiness", "Print readiness summary (default)").option("--inspect-config", "Print redacted merged configuration");
   const auth = program2.command("auth").description("Authentication");
   auth.command("login").description("Log in").option("--email <email>", "Email address").option("--password <password>", "Password").option("--session-path <path>", "Session JSON path override for this run").option("--ci", "Use easyspecs.auth.ciLogin from config when argv credentials are omitted");
@@ -11245,6 +11245,8 @@ var import_node_child_process2 = require("node:child_process");
 var ABSOLUTE_MAX_CONCURRENT_AI = 64;
 
 // src/config/machineConcurrentAiFromHost.ts
+var AGENTS_PER_PHYSICAL_CORE = 1;
+var RAM_GIB_PER_AGENT = 8;
 function clampProductConcurrentLimits(n) {
   if (!Number.isFinite(n)) {
     return DEFAULT_MAX_CONCURRENT_AI;
@@ -11261,13 +11263,9 @@ function machineConcurrentAiCapFromHost(profile) {
   if (!Number.isFinite(rGib) || rGib <= 0) {
     return 1;
   }
-  let nCpuFloat;
-  if (p <= 11) {
-    nCpuFloat = 15 + 8.5 * (p - 1);
-  } else {
-    nCpuFloat = 100 + 8.5 * (p - 11);
-  }
-  const ramFactor = Math.min(1, rGib / (4 * p));
+  const nCpuFloat = AGENTS_PER_PHYSICAL_CORE * p;
+  const ramRefGib = RAM_GIB_PER_AGENT * p;
+  const ramFactor = Math.min(1, rGib / ramRefGib);
   const nFloat = nCpuFloat * ramFactor;
   const rounded = Math.round(nFloat);
   return Math.max(1, rounded);
@@ -28397,7 +28395,7 @@ function formatCliStderrLine(line, useAnsi) {
 }
 
 // src/cli/main.ts
-var PKG_VERSION = "0.0.27";
+var PKG_VERSION = "0.0.28";
 function isNonEmptyFactoryFailureArray(x) {
   if (!Array.isArray(x) || x.length === 0) {
     return false;