@gluecharm-lab/easyspecs-cli 0.0.26 → 0.0.28

package/dist/main.cjs

@@ -960,7 +960,7 @@ var require_command = __commonJS({
     var EventEmitter = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
     var path60 = require("node:path");
-    var fs62 = require("node:fs");
+    var fs63 = require("node:fs");
     var process2 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1893,10 +1893,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
           const localBin = path60.resolve(baseDir, baseName);
-          if (fs62.existsSync(localBin)) return localBin;
+          if (fs63.existsSync(localBin)) return localBin;
           if (sourceExt.includes(path60.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs62.existsSync(`${localBin}${ext}`)
+            (ext) => fs63.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1908,7 +1908,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs62.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs63.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
@@ -10622,12 +10622,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats2(ajv2, list, fs62, exportName) {
+    function addFormats2(ajv2, list, fs63, exportName) {
       var _a;
       var _b;
       (_a = (_b = ajv2.opts.code).formats) !== null && _a !== void 0 ? _a : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv2.addFormat(f, fs62[f]);
+        ajv2.addFormat(f, fs63[f]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -10636,7 +10636,7 @@ var require_dist = __commonJS({
 });
 
 // src/cli/main.ts
-var fs61 = __toESM(require("node:fs"));
+var fs62 = __toESM(require("node:fs"));
 var path59 = __toESM(require("node:path"));
 
 // src/cli/exitCodes.ts
@@ -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);
@@ -13192,7 +13190,7 @@ function createFileBackedWorkspaceState(repoRoot) {
 }
 
 // src/pipelines/synthesis/synthesisPipeline.ts
-var fs36 = __toESM(require("fs"));
+var fs37 = __toESM(require("fs"));
 var path32 = __toESM(require("path"));
 
 // src/analysis/analysisDynamicTestSteps.ts
@@ -20329,6 +20327,295 @@ function nextAdaptiveMaxAfterCpuSample(p) {
   return { adaptiveMax: p.priorAdaptiveMax, changed: false };
 }
 
+// src/hostPoolPeriodicDiagnostics.ts
+var fs36 = __toESM(require("fs"));
+var DEFAULT_HOST_POOL_INTERVAL_MS = 45e3;
+var MAX_ADVICE_TEXT_CHARS = 400;
+var MAX_FD_ENUM = 4096;
+var TEMPLATE_MEMORY_KO = "Low free RAM or swap in this worker: lower easyspecs.workstations.maxConcurrentAi (or host concurrency cap), raise Celery worker or container memory if you can, and verify with vmstat or cgroup memory stats.";
+var TEMPLATE_SCHEDULER_KO = "High load vs CPUs in this worker: lower easyspecs.workstations.maxConcurrentAi and watch earlier [pool] lines for adaptive cap changes; if load stays high while only this task runs, check worker CPU limits or VM CPU steal.";
+var TEMPLATE_IO_KO = "Elevated I/O wait (Linux /proc delta): check disk saturation with iostat or vmstat; fewer easyspecs concurrent agents help; on a host dedicated to this task, inspect storage latency, disk quotas, or shared volume contention.";
+var TEMPLATE_LIMITS_KO = "This Node process is near soft FD/process/thread limits: raise ulimit or prlimit for the Celery worker process, or lower easyspecs.workstations.maxConcurrentAi; confirm with /proc/self/limits.";
+function hintSchedulerFromSnapshot(s) {
+  const p = s.load1PerCpu;
+  if (p === null || !Number.isFinite(p)) {
+    return "UNK";
+  }
+  if (p >= 1.25) {
+    return "KO";
+  }
+  if (p < 1) {
+    return "OK";
+  }
+  return "UNK";
+}
+function hintMemoryFrom(platform, s, swap) {
+  const total = s.hostRamTotalB;
+  if (total <= 0) {
+    return "UNK";
+  }
+  const freeRatio = s.hostRamFreeB / total;
+  let ram;
+  if (freeRatio < 0.07) {
+    ram = "KO";
+  } else if (freeRatio < 0.1) {
+    ram = "UNK";
+  } else {
+    ram = "OK";
+  }
+  let swapH = "OK";
+  if (platform === "linux" && swap !== null && swap.swapTotalB > 0) {
+    const sf = swap.swapFreeB / swap.swapTotalB;
+    if (sf < 0.08) {
+      swapH = "KO";
+    } else if (sf < 0.15) {
+      swapH = "UNK";
+    } else {
+      swapH = "OK";
+    }
+  }
+  if (ram === "KO" || swapH === "KO") {
+    return "KO";
+  }
+  if (ram === "UNK" || swapH === "UNK") {
+    return "UNK";
+  }
+  return "OK";
+}
+function hintLimitsFrom(sample) {
+  if (sample === null) {
+    return "UNK";
+  }
+  if (sample.truncated) {
+    return "UNK";
+  }
+  const ratios = [];
+  if (sample.fdRatio !== null && Number.isFinite(sample.fdRatio)) {
+    ratios.push(sample.fdRatio);
+  }
+  if (sample.procRatio !== null && Number.isFinite(sample.procRatio)) {
+    ratios.push(sample.procRatio);
+  }
+  if (ratios.length === 0) {
+    return "UNK";
+  }
+  if (ratios.some((r) => r >= 0.85)) {
+    return "KO";
+  }
+  if (ratios.every((r) => r < 0.75)) {
+    return "OK";
+  }
+  return "UNK";
+}
+function hintIoFrom(prev, curr) {
+  if (prev === null || curr === null) {
+    return "UNK";
+  }
+  const dTotal = curr.total - prev.total;
+  const dIo = curr.iowait - prev.iowait;
+  if (dTotal <= 0 || !Number.isFinite(dTotal) || !Number.isFinite(dIo)) {
+    return "UNK";
+  }
+  const share = dIo / dTotal;
+  if (!Number.isFinite(share)) {
+    return "UNK";
+  }
+  if (share >= 0.22) {
+    return "KO";
+  }
+  if (share <= 0.12) {
+    return "OK";
+  }
+  return "UNK";
+}
+function computeHostPoolHints(input) {
+  return {
+    hintScheduler: hintSchedulerFromSnapshot(input.snapshot),
+    hintMemory: hintMemoryFrom(input.platform, input.snapshot, input.swap),
+    hintLimits: hintLimitsFrom(input.limits),
+    hintIo: hintIoFrom(input.prevStat, input.currStat)
+  };
+}
+function tryReadLinuxSwapBytesFromMeminfo(readFileSyncImpl = fs36.readFileSync) {
+  let raw;
+  try {
+    raw = readFileSyncImpl("/proc/meminfo", { encoding: "utf8", flag: "r" });
+  } catch {
+    return null;
+  }
+  let swapTotalKb = null;
+  let swapFreeKb = null;
+  for (const line of raw.split(/\r?\n/)) {
+    const tm = /^\s*SwapTotal:\s+(\d+)\s+kB/i.exec(line);
+    if (tm) {
+      swapTotalKb = Number(tm[1]);
+    }
+    const fm = /^\s*SwapFree:\s+(\d+)\s+kB/i.exec(line);
+    if (fm) {
+      swapFreeKb = Number(fm[1]);
+    }
+  }
+  if (swapTotalKb === null || swapFreeKb === null || !Number.isFinite(swapTotalKb) || !Number.isFinite(swapFreeKb) || swapTotalKb < 0 || swapFreeKb < 0) {
+    return null;
+  }
+  return {
+    swapTotalB: Math.floor(swapTotalKb * 1024),
+    swapFreeB: Math.floor(swapFreeKb * 1024)
+  };
+}
+function tryReadLinuxAggregateCpuJiffies(readFileSyncImpl = fs36.readFileSync) {
+  let raw;
+  try {
+    raw = readFileSyncImpl("/proc/stat", { encoding: "utf8", flag: "r" });
+  } catch {
+    return null;
+  }
+  const firstLine = raw.split(/\r?\n/)[0] ?? "";
+  return parseLinuxAggregateCpuLine(firstLine);
+}
+function parseLinuxAggregateCpuLine(line) {
+  const t = line.trim();
+  if (!t.startsWith("cpu") || /^cpu\d/.test(t)) {
+    return null;
+  }
+  const parts = t.split(/\s+/);
+  if (parts.length < 6 || parts[0] !== "cpu") {
+    return null;
+  }
+  const nums = [];
+  for (let i = 1; i < parts.length; i++) {
+    const n = Number(parts[i]);
+    if (!Number.isFinite(n) || n < 0) {
+      return null;
+    }
+    nums.push(Math.floor(n));
+  }
+  const total = nums.reduce((a, b) => a + b, 0);
+  const iowait = nums.length >= 5 ? nums[4] : 0;
+  return { total, iowait };
+}
+function parseProcSelfLimitsSoft(content, label) {
+  const re = label === "Max open files" ? /^\s*Max open files\s+(\d+)\s+(\d+)/m : /^\s*Max processes\s+(\d+)\s+(\d+)/m;
+  const m = re.exec(content);
+  if (!m) {
+    return null;
+  }
+  const soft = Number(m[1]);
+  return Number.isFinite(soft) && soft > 0 ? soft : null;
+}
+function parseProcSelfStatusThreads(content) {
+  const m = /^\s*Threads:\s*(\d+)/m.exec(content);
+  if (!m) {
+    return null;
+  }
+  const n = Number(m[1]);
+  return Number.isFinite(n) && n >= 0 ? n : null;
+}
+function trySampleLinuxLimits(platform, readFileSyncImpl = fs36.readFileSync, readdirSyncImpl = fs36.readdirSync) {
+  if (platform !== "linux") {
+    return null;
+  }
+  let limitsRaw;
+  let statusRaw;
+  try {
+    limitsRaw = readFileSyncImpl("/proc/self/limits", { encoding: "utf8", flag: "r" });
+    statusRaw = readFileSyncImpl("/proc/self/status", { encoding: "utf8", flag: "r" });
+  } catch {
+    return null;
+  }
+  const nofileSoft = parseProcSelfLimitsSoft(limitsRaw, "Max open files");
+  const nprocSoft = parseProcSelfLimitsSoft(limitsRaw, "Max processes");
+  const threads = parseProcSelfStatusThreads(statusRaw);
+  let fdCount = 0;
+  let truncated = false;
+  try {
+    const names = readdirSyncImpl("/proc/self/fd");
+    truncated = names.length > MAX_FD_ENUM;
+    fdCount = Math.min(names.length, MAX_FD_ENUM);
+  } catch {
+    return { fdRatio: null, procRatio: null, truncated: true };
+  }
+  const fdRatio = nofileSoft !== null && nofileSoft > 0 ? Math.min(1, fdCount / nofileSoft) : null;
+  const procRatio = nprocSoft !== null && nprocSoft > 0 && threads !== null ? Math.min(1, threads / nprocSoft) : null;
+  return { fdRatio, procRatio, truncated };
+}
+function formatHostPoolPeriodicLine(params) {
+  const s = params.snapshot;
+  const load1Str = s.load1 === null ? "unknown" : String(s.load1);
+  const perCpuStr = s.load1PerCpu === null ? "unknown" : String(s.load1PerCpu);
+  const swapPart = params.swap !== null ? ` swapTotalB=${String(params.swap.swapTotalB)} swapFreeB=${String(params.swap.swapFreeB)}` : "";
+  return `[host-pool] activeWorkstations=${String(params.activeWorkstations)} staticMaxConcurrentAi=${String(params.staticMaxConcurrentAi)} adaptiveMaxConcurrentAi=${String(params.adaptiveMaxConcurrentAi)} hostRamTotalB=${String(s.hostRamTotalB)} hostRamFreeB=${String(s.hostRamFreeB)} hostRamUsedB=${String(s.hostRamUsedB)} cpusLogical=${String(s.cpusLogical)} load1=${load1Str} load1PerCpu=${perCpuStr}${swapPart} hintScheduler=${params.hints.hintScheduler} hintMemory=${params.hints.hintMemory} hintLimits=${params.hints.hintLimits} hintIo=${params.hints.hintIo}`;
+}
+function anyKo(h) {
+  return h.hintMemory === "KO" || h.hintScheduler === "KO" || h.hintIo === "KO" || h.hintLimits === "KO";
+}
+function formatHostPoolRecLine(hints) {
+  if (!anyKo(hints)) {
+    return "[host-pool-rec] kind=none";
+  }
+  const parts = [];
+  if (hints.hintMemory === "KO") {
+    parts.push(TEMPLATE_MEMORY_KO);
+  }
+  if (hints.hintScheduler === "KO") {
+    parts.push(TEMPLATE_SCHEDULER_KO);
+  }
+  if (hints.hintIo === "KO") {
+    parts.push(TEMPLATE_IO_KO);
+  }
+  if (hints.hintLimits === "KO") {
+    parts.push(TEMPLATE_LIMITS_KO);
+  }
+  let text = parts.join(" | ");
+  if (text.length > MAX_ADVICE_TEXT_CHARS) {
+    text = `${text.slice(0, MAX_ADVICE_TEXT_CHARS - 2)} \u2026`;
+  }
+  return `[host-pool-rec] kind=advice text=${text}`;
+}
+function createHostPoolTick(deps) {
+  const platform = deps.platform ?? process.platform;
+  const collect = deps.collectHostSnapshotFn ?? collectHostSnapshot;
+  const readFs = deps.readFileSyncFn ?? fs36.readFileSync;
+  const readDir = deps.readdirSyncFn ?? fs36.readdirSync;
+  return () => {
+    const { active, staticMaxConcurrentAi, adaptiveMaxConcurrentAi } = deps.getPoolState();
+    if (active < 1) {
+      return;
+    }
+    const snapshot = collect();
+    let swap = null;
+    let currStat = null;
+    let limits = null;
+    if (platform === "linux") {
+      swap = tryReadLinuxSwapBytesFromMeminfo(readFs);
+      currStat = tryReadLinuxAggregateCpuJiffies(readFs);
+      limits = trySampleLinuxLimits(platform, readFs, readDir);
+    }
+    const hints = computeHostPoolHints({
+      platform,
+      snapshot,
+      swap,
+      limits,
+      prevStat: deps.prevProcStatRef.current,
+      currStat
+    });
+    const metrics = formatHostPoolPeriodicLine({
+      activeWorkstations: active,
+      staticMaxConcurrentAi,
+      adaptiveMaxConcurrentAi,
+      snapshot,
+      hints,
+      swap
+    });
+    const rec = formatHostPoolRecLine(hints);
+    deps.log(metrics);
+    deps.log(rec);
+    if (platform === "linux" && currStat !== null) {
+      deps.prevProcStatRef.current = currStat;
+    }
+  };
+}
+
 // src/pipelines/synthesis/synthesisPipeline.ts
 var FE = /^FE-\d+$/;
 var UC = /^UC-\d+$/;
@@ -20341,7 +20628,7 @@ function stripBom2(s) {
 }
 function readJson4(filePath) {
   try {
-    const raw = stripBom2(fs36.readFileSync(filePath, "utf-8"));
+    const raw = stripBom2(fs37.readFileSync(filePath, "utf-8"));
     return JSON.parse(raw);
   } catch {
     return null;
@@ -20436,7 +20723,7 @@ function featureDetailTarget(contextDir2, code, name, slug) {
     displayName: "Feature detail",
     outputBasename: basename17,
     taskDescription: `Document feature **${code}** (**${name}**, slug **${slug}**) per \`.gluecharm/context/features-list.json\`: scope, behaviour, main dependencies, entry points, and links to code under the worktree. Write exactly one markdown file at the output path; cite substantive claims with file and line (or range).`,
-    exists: fs36.existsSync(path32.join(contextDir2, basename17)) && fs36.statSync(path32.join(contextDir2, basename17)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, basename17)) && fs37.statSync(path32.join(contextDir2, basename17)).size > 0
   };
 }
 function viewDetailTarget(row2, contextDir2) {
@@ -20447,7 +20734,7 @@ function viewDetailTarget(row2, contextDir2) {
     displayName: "View detail",
     outputBasename: basename17,
     taskDescription: `Describe view **${row2.code}** (**${row2.name}**, slug **${row2.slug}**) per \`.gluecharm/context/experiences-list.json\`: purpose, layout, controls, navigation, data shown; ground in components and routes.`,
-    exists: fs36.existsSync(path32.join(contextDir2, basename17)) && fs36.statSync(path32.join(contextDir2, basename17)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, basename17)) && fs37.statSync(path32.join(contextDir2, basename17)).size > 0
   };
 }
 function interactionDetailTarget(viewCode, ix, contextDir2) {
@@ -20458,7 +20745,7 @@ function interactionDetailTarget(viewCode, ix, contextDir2) {
     displayName: "Interaction detail",
     outputBasename: basename17,
     taskDescription: `Document interaction **${ix.code}** (**${ix.name}**) on view **${viewCode}** per \`.gluecharm/context/experiences-list.json\`.`,
-    exists: fs36.existsSync(path32.join(contextDir2, basename17)) && fs36.statSync(path32.join(contextDir2, basename17)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, basename17)) && fs37.statSync(path32.join(contextDir2, basename17)).size > 0
   };
 }
 function serviceDetailTarget(row2, contextDir2) {
@@ -20469,7 +20756,7 @@ function serviceDetailTarget(row2, contextDir2) {
     displayName: "Service detail",
     outputBasename: basename17,
     taskDescription: `Describe service **${row2.code}** (**${row2.name}**, slug **${row2.slug}**) per \`.gluecharm/context/services-list.json\`: responsibilities, consumers, errors, integration points.`,
-    exists: fs36.existsSync(path32.join(contextDir2, basename17)) && fs36.statSync(path32.join(contextDir2, basename17)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, basename17)) && fs37.statSync(path32.join(contextDir2, basename17)).size > 0
   };
 }
 function methodDetailTarget(svc, m, contextDir2) {
@@ -20480,7 +20767,7 @@ function methodDetailTarget(svc, m, contextDir2) {
     displayName: "Method detail",
     outputBasename: basename17,
     taskDescription: `Document method **${m.code}** (**${m.name}**) on service **${svc.code}** per \`.gluecharm/context/services-list.json\`.`,
-    exists: fs36.existsSync(path32.join(contextDir2, basename17)) && fs36.statSync(path32.join(contextDir2, basename17)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, basename17)) && fs37.statSync(path32.join(contextDir2, basename17)).size > 0
   };
 }
 function entityDetailTarget(dmCode, ename, slug, contextDir2) {
@@ -20491,7 +20778,7 @@ function entityDetailTarget(dmCode, ename, slug, contextDir2) {
     displayName: "Entity detail",
     outputBasename: basename17,
     taskDescription: `Describe entity **${dmCode}** (**${ename}**, slug **${slug}**) per \`.gluecharm/context/data-model-list.json\`: lifecycle, invariants, storage, ORM/schema mapping.`,
-    exists: fs36.existsSync(path32.join(contextDir2, basename17)) && fs36.statSync(path32.join(contextDir2, basename17)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, basename17)) && fs37.statSync(path32.join(contextDir2, basename17)).size > 0
   };
 }
 function fieldDetailTarget(dmCode, fdCode, fname, fSlug, contextDir2) {
@@ -20502,7 +20789,7 @@ function fieldDetailTarget(dmCode, fdCode, fname, fSlug, contextDir2) {
     displayName: "Field detail",
     outputBasename: basename17,
     taskDescription: `Document field **${fdCode}** (**${fname}**) on entity **${dmCode}** per \`.gluecharm/context/${dmCode}-fields-list.json\`. Cite types and constraints with file and line.`,
-    exists: fs36.existsSync(path32.join(contextDir2, basename17)) && fs36.statSync(path32.join(contextDir2, basename17)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, basename17)) && fs37.statSync(path32.join(contextDir2, basename17)).size > 0
   };
 }
 function toolDetailTarget(row2, contextDir2) {
@@ -20513,7 +20800,7 @@ function toolDetailTarget(row2, contextDir2) {
     displayName: "Tool detail",
     outputBasename: basename17,
     taskDescription: `Describe tool **${row2.code}** (**${row2.name}**, slug **${row2.slug}**) per \`.gluecharm/context/tech-stack-list.json\`: role, version hints, configuration, boundaries.`,
-    exists: fs36.existsSync(path32.join(contextDir2, basename17)) && fs36.statSync(path32.join(contextDir2, basename17)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, basename17)) && fs37.statSync(path32.join(contextDir2, basename17)).size > 0
   };
 }
 function useCaseDetailTarget(feCode, ucCode, ucName, ucSlug, contextDir2) {
@@ -20526,7 +20813,7 @@ function useCaseDetailTarget(feCode, ucCode, ucName, ucSlug, contextDir2) {
     taskDescription: `Document use case **${ucCode}** (**${ucName}**) under feature **${feCode}** per \`.gluecharm/context/${feCode}-use-cases-list.json\`. Do not change stable codes.
 
 Follow bundled agent **agent-md-use-case-detail**: include **## Data inputs and validation** (concrete fields, mandatory vs optional, rules, failure behaviour). **## Code flow** must trace **implementation order** (entrypoint \u2192 validation \u2192 business rules \u2192 persistence \u2192 response) with **real** symbols and files\u2014not generic \u201Cuser does X\u201D. Add a **Mermaid** fenced diagram under Code flow when there are **two or more** implementation stages. **## Evidence index** must cite **each major stage** (validation, persistence, response), not only the outer entrypoint.`,
-    exists: fs36.existsSync(path32.join(contextDir2, ucBase)) && fs36.statSync(path32.join(contextDir2, ucBase)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, ucBase)) && fs37.statSync(path32.join(contextDir2, ucBase)).size > 0
   };
 }
 function scenarioDetailTarget(feCode, ucCode, scCode, scName, contextDir2) {
@@ -20537,7 +20824,7 @@ function scenarioDetailTarget(feCode, ucCode, scCode, scName, contextDir2) {
     displayName: "Scenario detail",
     outputBasename: basename17,
     taskDescription: `Document scenario **${scCode}** (**${scName}**) for **${feCode}** / **${ucCode}** per \`.gluecharm/context/${feCode}_${ucCode}-scenarios-list.json\`. Cite steps with file and line where possible.`,
-    exists: fs36.existsSync(path32.join(contextDir2, basename17)) && fs36.statSync(path32.join(contextDir2, basename17)).size > 0
+    exists: fs37.existsSync(path32.join(contextDir2, basename17)) && fs37.statSync(path32.join(contextDir2, basename17)).size > 0
   };
 }
 function parentsDone(item, byId) {
@@ -21097,6 +21384,20 @@ async function drainWorkstationPool(p) {
     const intervalMs = p.__testOnlyCpuPressureIntervalMs ?? 3e4;
     pressureInterval = setInterval(() => applyCpuPressure(), intervalMs);
   }
+  const hostPoolPrevStat = { current: null };
+  const hostPoolTick = createHostPoolTick({
+    log,
+    getPoolState: () => ({
+      active,
+      staticMaxConcurrentAi: staticMaxC,
+      adaptiveMaxConcurrentAi: adaptiveMax
+    }),
+    prevProcStatRef: hostPoolPrevStat
+  });
+  const hostPoolIntervalMs = p.__testOnlyHostPoolIntervalMs ?? DEFAULT_HOST_POOL_INTERVAL_MS;
+  const hostPoolInterval = setInterval(() => {
+    hostPoolTick();
+  }, hostPoolIntervalMs);
   try {
     while (true) {
       while (fifo.length > 0 && active < currentCap() && !abortSignal?.aborted) {
@@ -21127,6 +21428,7 @@ async function drainWorkstationPool(p) {
     if (pressureInterval) {
       clearInterval(pressureInterval);
     }
+    clearInterval(hostPoolInterval);
     if (poolAbortListenerRegistered && abortSignal) {
       abortSignal.removeEventListener("abort", onPipelineAbort);
     }
@@ -21166,7 +21468,7 @@ async function runSynthesisPipelineDrainFromPreparedWorktree(storageContext, rep
     offlineLearnAfterSameSessionTrace: getAceOfflineLearnAfterSameSessionTrace(handle.path)
   };
   const contextDir2 = path32.join(handle.path, ".gluecharm", "context");
-  fs36.mkdirSync(contextDir2, { recursive: true });
+  fs37.mkdirSync(contextDir2, { recursive: true });
   const initialItems = buildRootItems();
   await startArtefactRun(storageContext, repoRoot, handle.path, initialItems);
   await cb.onBootstrapReady?.({ worktreeRoot: handle.path, contextDir: contextDir2 });
@@ -21267,27 +21569,27 @@ async function runSynthesisPipeline(storageContext, repoRoot, workspaceLabel, ex
 }
 
 // src/workspaceContextPromote.ts
-var fs37 = __toESM(require("fs"));
+var fs38 = __toESM(require("fs"));
 var path33 = __toESM(require("path"));
 function promoteContextDirectoryToWorkspaceFs(sourceContextDir, workspaceRootFs) {
   const dest = path33.join(workspaceRootFs, ".gluecharm", "context");
-  fs37.mkdirSync(path33.join(workspaceRootFs, ".gluecharm"), { recursive: true });
-  fs37.mkdirSync(dest, { recursive: true });
+  fs38.mkdirSync(path33.join(workspaceRootFs, ".gluecharm"), { recursive: true });
+  fs38.mkdirSync(dest, { recursive: true });
   let names;
   try {
-    names = fs37.readdirSync(sourceContextDir);
+    names = fs38.readdirSync(sourceContextDir);
   } catch {
     return { filesCopied: 0 };
   }
   let filesCopied = 0;
   for (const name of names) {
     const srcPath = path33.join(sourceContextDir, name);
-    if (!fs37.statSync(srcPath).isFile()) {
+    if (!fs38.statSync(srcPath).isFile()) {
       continue;
     }
-    const buf = fs37.readFileSync(srcPath);
+    const buf = fs38.readFileSync(srcPath);
     const target = path33.join(dest, name);
-    fs37.writeFileSync(target, buf);
+    fs38.writeFileSync(target, buf);
     filesCopied += 1;
   }
   return { filesCopied };
@@ -21947,7 +22249,7 @@ async function runGenerateContextFactory(deps) {
 }
 
 // src/factory/generateContextFactoryHeadlessHost.ts
-var fs46 = __toESM(require("node:fs"));
+var fs47 = __toESM(require("node:fs"));
 var path43 = __toESM(require("node:path"));
 
 // src/stores/pipelineRunStore.ts
@@ -22048,11 +22350,11 @@ async function noteAgentsMaterialized(context) {
 }
 
 // src/pipelines/remediation/missingWorkstations.ts
-var fs39 = __toESM(require("fs"));
+var fs40 = __toESM(require("fs"));
 var path35 = __toESM(require("path"));
 
 // src/analysis/analysisDetailMarkdownDiscovery.ts
-var fs38 = __toESM(require("fs"));
+var fs39 = __toESM(require("fs"));
 var path34 = __toESM(require("path"));
 var SLUG4 = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var FE2 = /^FE-\d+$/;
@@ -22074,7 +22376,7 @@ var STEM_TO_AGENT = {
 };
 function readJson5(filePath) {
   try {
-    let raw = fs38.readFileSync(filePath, "utf-8");
+    let raw = fs39.readFileSync(filePath, "utf-8");
     if (raw.length > 0 && raw.charCodeAt(0) === 65279) {
       raw = raw.slice(1);
     }
@@ -22342,7 +22644,7 @@ function fileAndValidationFromKind(kind) {
 function classifyMissingWorkstationOutputFileStatus(row2, contextDir2, worktreeRoot) {
   const abs = path35.join(contextDir2, row2.relativePath);
   try {
-    const st = fs39.statSync(abs);
+    const st = fs40.statSync(abs);
     if (!st.isFile()) {
       return { kind: "absent", detail: "Path exists but is not a regular file." };
     }
@@ -22380,7 +22682,7 @@ function classifyMissingWorkstationOutputFileStatus(row2, contextDir2, worktreeR
     };
   }
   const schemaAbs = path35.join(worktreeRoot, ".opencode", "schemas", "context-lists", schemaBn);
-  if (!fs39.existsSync(schemaAbs)) {
+  if (!fs40.existsSync(schemaAbs)) {
     return {
       kind: "invalid",
       detail: `Schema not found (${schemaBn}). Run **Materialize agents** on this checkout.`
@@ -22616,7 +22918,7 @@ function listMissingWorkstations(contextDir2, worktreeRoot, snapshot) {
       }
     }
   }
-  if (!fs39.existsSync(contextDir2)) {
+  if (!fs40.existsSync(contextDir2)) {
     return [...map.values()].sort((a, b) => a.key.localeCompare(b.key));
   }
   const dynamic = discoverDynamicAnalysisTestSteps(contextDir2);
@@ -22797,11 +23099,11 @@ async function runRemediationPipelineMissingPass(p) {
 
 // src/pipelines/coverage/coveragePipeline.ts
 var import_child_process5 = require("child_process");
-var fs41 = __toESM(require("fs"));
+var fs42 = __toESM(require("fs"));
 var path38 = __toESM(require("path"));
 
 // src/analysis/coverageReferenceValidationSchemaValidate.ts
-var fs40 = __toESM(require("fs"));
+var fs41 = __toESM(require("fs"));
 var path37 = __toESM(require("path"));
 var import__5 = __toESM(require__());
 function stripUtf8Bom4(s) {
@@ -22831,7 +23133,7 @@ function getValidate() {
     return compiledValidate;
   }
   const schemaPath = bundledCoverageReferenceValidationSchemaPath();
-  const schemaRaw = stripUtf8Bom4(fs40.readFileSync(schemaPath, "utf-8"));
+  const schemaRaw = stripUtf8Bom4(fs41.readFileSync(schemaPath, "utf-8"));
   const schema = JSON.parse(schemaRaw);
   const ajv2 = new import__5.default({ allErrors: true, strict: false });
   compiledValidate = ajv2.compile(schema);
@@ -22847,7 +23149,7 @@ function validateCoverageReferenceValidationData(data) {
 function readAndValidateCoverageReferenceValidationFile(jsonAbsolutePath) {
   let raw;
   try {
-    raw = stripUtf8Bom4(fs40.readFileSync(jsonAbsolutePath, "utf-8"));
+    raw = stripUtf8Bom4(fs41.readFileSync(jsonAbsolutePath, "utf-8"));
   } catch (e) {
     return {
       ok: false,
@@ -22889,7 +23191,7 @@ var DEFAULT_IGNORE_DIR_BASENAMES = [
 var GIT_LS_FILES_MAX_BUFFER = 64 * 1024 * 1024;
 function tryLoadGitNonIgnoredPathSet(repositoryRootAbs) {
   const root = path38.resolve(repositoryRootAbs);
-  if (!fs41.existsSync(path38.join(root, ".git"))) {
+  if (!fs42.existsSync(path38.join(root, ".git"))) {
     return null;
   }
   const env = { ...process.env, GIT_TERMINAL_PROMPT: "0" };
@@ -23044,7 +23346,7 @@ function extractEvidenceIndexPathCitations(body) {
 function listContextFilesRecursive(dir, acc) {
   let entries;
   try {
-    entries = fs41.readdirSync(dir, { withFileTypes: true });
+    entries = fs42.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
@@ -23062,7 +23364,7 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
   const walk = (dir) => {
     let entries;
     try {
-      entries = fs41.readdirSync(dir, { withFileTypes: true });
+      entries = fs42.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -23092,7 +23394,7 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
         }
         let st;
         try {
-          st = fs41.statSync(full);
+          st = fs42.statSync(full);
         } catch {
           continue;
         }
@@ -23102,7 +23404,7 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
         }
         let buf;
         try {
-          buf = fs41.readFileSync(full);
+          buf = fs42.readFileSync(full);
         } catch {
           excludedOut.push({ path: rel, reason: "read error" });
           continue;
@@ -23122,7 +23424,7 @@ function walkRepositoryFiles(repoRoot, ignoreBasenames, maxBytes, excludedOut, g
 }
 function collectReferencesFromContext(contextDirAbs, repositoryRootAbs, warnings) {
   const references = [];
-  if (!fs41.existsSync(contextDirAbs)) {
+  if (!fs42.existsSync(contextDirAbs)) {
     warnings.push(`Context directory missing: ${contextDirAbs}`);
     return references;
   }
@@ -23138,7 +23440,7 @@ function collectReferencesFromContext(contextDirAbs, repositoryRootAbs, warnings
       }
       let raw;
       try {
-        raw = fs41.readFileSync(abs, "utf-8");
+        raw = fs42.readFileSync(abs, "utf-8");
       } catch (e) {
         warnings.push(`Skip JSON (read error): ${sourceArtefact} \u2014 ${e instanceof Error ? e.message : String(e)}`);
         continue;
@@ -23169,7 +23471,7 @@ function collectReferencesFromContext(contextDirAbs, repositoryRootAbs, warnings
     if (ext === ".md") {
       let text;
       try {
-        const buf = fs41.readFileSync(abs);
+        const buf = fs42.readFileSync(abs);
         text = decodeBufferForLineCount(buf);
       } catch (e) {
         warnings.push(`Skip markdown (read/decode error): ${sourceArtefact} \u2014 ${e instanceof Error ? e.message : String(e)}`);
@@ -23226,7 +23528,7 @@ function buildCoverageReferenceValidationDocument(repositoryRootAbs, contextDirA
   }
   const excludedFiles = [];
   const gitNonIgnoredPaths = tryLoadGitNonIgnoredPathSet(repoRoot);
-  if (fs41.existsSync(path38.join(repoRoot, ".git")) && gitNonIgnoredPaths === null) {
+  if (fs42.existsSync(path38.join(repoRoot, ".git")) && gitNonIgnoredPaths === null) {
     warnings.push(
       "Repository has .git but git ls-files failed or git is unavailable; .gitignore / exclude-standard not applied."
     );
@@ -23277,10 +23579,10 @@ function buildCoverageReferenceValidationDocument(repositoryRootAbs, contextDirA
 function runCoveragePipeline(opts) {
   const repoRoot = path38.resolve(opts.repositoryRootAbs);
   const contextDir2 = path38.resolve(opts.contextDirAbs);
-  if (!fs41.existsSync(repoRoot)) {
+  if (!fs42.existsSync(repoRoot)) {
     return { ok: false, error: `Repository root does not exist: ${repoRoot}` };
   }
-  if (!fs41.existsSync(contextDir2)) {
+  if (!fs42.existsSync(contextDir2)) {
     return {
       ok: false,
       error: `Missing .gluecharm/context: ${contextDir2}`
@@ -23302,7 +23604,7 @@ ${schemaCheck.errors.join("\n")}`,
   if (opts.write) {
     try {
       const payload = stableStringifyCoverageDocument(document);
-      fs41.writeFileSync(outPath, payload, "utf-8");
+      fs42.writeFileSync(outPath, payload, "utf-8");
     } catch (e) {
       return {
         ok: false,
@@ -23316,11 +23618,11 @@ ${schemaCheck.errors.join("\n")}`,
 
 // src/pipelines/remediation/zeroReferenceWorkstationChain.ts
 var crypto = __toESM(require("crypto"));
-var fs43 = __toESM(require("fs"));
+var fs44 = __toESM(require("fs"));
 var path40 = __toESM(require("path"));
 
 // src/analysis/zeroReferenceRemediationSchemaValidate.ts
-var fs42 = __toESM(require("fs"));
+var fs43 = __toESM(require("fs"));
 var path39 = __toESM(require("path"));
 var import__6 = __toESM(require__());
 function stripUtf8Bom5(s) {
@@ -23342,7 +23644,7 @@ function formatAjvErrors6(errors) {
 var ajv = new import__6.default({ allErrors: true, strict: false });
 function compileSchema(basename17) {
   const schemaPath = path39.join(schemasDir(), basename17);
-  const schemaRaw = stripUtf8Bom5(fs42.readFileSync(schemaPath, "utf-8"));
+  const schemaRaw = stripUtf8Bom5(fs43.readFileSync(schemaPath, "utf-8"));
   const schema = JSON.parse(schemaRaw);
   return ajv.compile(schema);
 }
@@ -23386,7 +23688,7 @@ var ZERO_REF_STAGING_JSON_TOTAL_ATTEMPTS = 5;
 var ZERO_REF_STAGING_FILE_PREVIEW_MAX_CHARS = 6e3;
 function readStagingOutputPreview(outAbs) {
   try {
-    const s = fs43.readFileSync(outAbs, "utf-8");
+    const s = fs44.readFileSync(outAbs, "utf-8");
     if (s.length <= ZERO_REF_STAGING_FILE_PREVIEW_MAX_CHARS) {
       return s;
     }
@@ -23669,14 +23971,14 @@ function readNonReferencedFilesFromRepositoryRoot(repositoryRootAbs) {
   return { ok: true, paths, ...generatedAt ? { generatedAt } : {} };
 }
 function readOrInitRoutingDoc(routingAbs, coverageReferenceGeneratedAt) {
-  if (!fs43.existsSync(routingAbs)) {
+  if (!fs44.existsSync(routingAbs)) {
     return {
       schemaVersion: ROUTING_SCHEMA_VERSION,
       ...coverageReferenceGeneratedAt ? { coverageReferenceGeneratedAt } : {},
       records: {}
     };
   }
-  const raw = fs43.readFileSync(routingAbs, "utf-8");
+  const raw = fs44.readFileSync(routingAbs, "utf-8");
   const data = JSON.parse(raw);
   if (!data.records || typeof data.records !== "object") {
     return {
@@ -23688,10 +23990,10 @@ function readOrInitRoutingDoc(routingAbs, coverageReferenceGeneratedAt) {
   return data;
 }
 function readOrInitTriageDoc(triageAbs) {
-  if (!fs43.existsSync(triageAbs)) {
+  if (!fs44.existsSync(triageAbs)) {
     return { schemaVersion: TRIAGE_SCHEMA_VERSION, records: {} };
   }
-  const raw = fs43.readFileSync(triageAbs, "utf-8");
+  const raw = fs44.readFileSync(triageAbs, "utf-8");
   const data = JSON.parse(raw);
   if (!data.records || typeof data.records !== "object") {
     return { schemaVersion: TRIAGE_SCHEMA_VERSION, records: {} };
@@ -23742,7 +24044,7 @@ function lineCountRepoFile(worktreeRootAbs, relPosix) {
   const abs = path40.join(worktreeRootAbs, ...relPosix.split("/"));
   let buf;
   try {
-    buf = fs43.readFileSync(abs);
+    buf = fs44.readFileSync(abs);
   } catch {
     return 1;
   }
@@ -23796,7 +24098,7 @@ async function applyCoordinationListTriageMerge(input) {
   const cfg = LIST_MERGE_CFG[input.listKind];
   const listPath = path40.join(input.contextDirAbs, cfg.listBasename);
   const schemaPath = path40.join(resolveContextListSchemasDir(), cfg.schemaBasename);
-  if (!fs43.existsSync(listPath)) {
+  if (!fs44.existsSync(listPath)) {
     return {
       ok: false,
       message: `${cfg.listBasename} not found \u2014 run coordination step ${LIST_STEP_HINT[input.listKind]} first.`
@@ -23807,7 +24109,7 @@ async function applyCoordinationListTriageMerge(input) {
     return withCoordinationListFileLock(listPath, {}, async () => {
       let raw;
       try {
-        raw = fs43.readFileSync(listPath, "utf-8");
+        raw = fs44.readFileSync(listPath, "utf-8");
       } catch (e) {
         return { ok: false, message: e instanceof Error ? e.message : String(e) };
       }
@@ -23875,7 +24177,7 @@ async function applyCoordinationListTriageMerge(input) {
       });
       const tmp = `${listPath}.tmp.${process.pid}`;
       try {
-        fs43.writeFileSync(tmp, `${JSON.stringify(doc, null, 2)}
+        fs44.writeFileSync(tmp, `${JSON.stringify(doc, null, 2)}
 `, "utf-8");
       } catch (e) {
         return { ok: false, message: e instanceof Error ? e.message : String(e) };
@@ -23883,13 +24185,13 @@ async function applyCoordinationListTriageMerge(input) {
       const v = validateCoordinationListJson(tmp, schemaPath);
       if (!v.ok) {
         try {
-          fs43.unlinkSync(tmp);
+          fs44.unlinkSync(tmp);
         } catch {
         }
         return { ok: false, message: `${cfg.listBasename} validation failed: ${JSON.stringify(v.failure)}` };
       }
       try {
-        fs43.renameSync(tmp, listPath);
+        fs44.renameSync(tmp, listPath);
       } catch (e) {
         return { ok: false, message: e instanceof Error ? e.message : String(e) };
       }
@@ -23899,9 +24201,9 @@ async function applyCoordinationListTriageMerge(input) {
 }
 async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, workspaceLabel) {
   const outAbs = stagingPathForTarget(contextDirAbs, "classifier", targetFilePathPosix);
-  fs43.mkdirSync(path40.dirname(outAbs), { recursive: true });
+  fs44.mkdirSync(path40.dirname(outAbs), { recursive: true });
   const runDir = path40.join(common.worktreeRoot, ".opencode", "_run");
-  fs43.mkdirSync(runDir, { recursive: true });
+  fs44.mkdirSync(runDir, { recursive: true });
   const outputBasename = path40.basename(outAbs);
   const listTaskDescription = [
     `Target file (repo-relative, POSIX): **${targetFilePathPosix}**`,
@@ -23939,7 +24241,7 @@ async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, wo
       ...repairAppendix ? { repairAppendix } : {}
     });
     const promptPath = path40.join(runDir, `zero-ref-classify-a${attempt}-${Date.now()}.prompt.txt`);
-    fs43.writeFileSync(promptPath, body, "utf-8");
+    fs44.writeFileSync(promptPath, body, "utf-8");
     const argv = expandArgvTemplate4(common.argvTemplate, {
       promptFile: promptPath,
       agentId: ZERO_REF_CLASSIFY_AGENT_STEM,
@@ -23966,7 +24268,7 @@ async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, wo
     const canRetry = attempt < ZERO_REF_STAGING_JSON_TOTAL_ATTEMPTS - 1;
     let st;
     try {
-      st = fs43.statSync(outAbs);
+      st = fs44.statSync(outAbs);
     } catch {
       st = void 0;
     }
@@ -23988,7 +24290,7 @@ async function runClassifierAgent(common, contextDirAbs, targetFilePathPosix, wo
     }
     let parsed;
     try {
-      parsed = JSON.parse(fs43.readFileSync(outAbs, "utf-8"));
+      parsed = JSON.parse(fs44.readFileSync(outAbs, "utf-8"));
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       lastFailureMessage = `Classifier output not valid JSON: ${msg}`;
@@ -24073,7 +24375,7 @@ async function runMarkdownReferenceAgent(common, contextDirAbs, targetFilePathPo
   const mdAbs = path40.join(contextDirAbs, mdBasename);
   const agentStem = which === "project" ? ZERO_REF_ADD_REF_PROJECT_AGENT_STEM : ZERO_REF_ADD_REF_ARCH_AGENT_STEM;
   const runDir = path40.join(common.worktreeRoot, ".opencode", "_run");
-  fs43.mkdirSync(runDir, { recursive: true });
+  fs44.mkdirSync(runDir, { recursive: true });
   const lines = [
     `# SRS-30 \u2014 Add reference to ${mdBasename}`,
     ``,
@@ -24089,7 +24391,7 @@ async function runMarkdownReferenceAgent(common, contextDirAbs, targetFilePathPo
     `- Do not remove unrelated content; append or extend the most appropriate section.`
   ];
   const promptPath = path40.join(runDir, `zero-ref-md-${which}-${Date.now()}.prompt.txt`);
-  fs43.writeFileSync(promptPath, lines.join("\n"), "utf-8");
+  fs44.writeFileSync(promptPath, lines.join("\n"), "utf-8");
   const argv = expandArgvTemplate4(common.argvTemplate, {
     promptFile: promptPath,
     agentId: agentStem,
@@ -24116,9 +24418,9 @@ async function runMarkdownReferenceAgent(common, contextDirAbs, targetFilePathPo
 async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathPosix, routingSummary, workspaceLabel, triageScope) {
   const meta = TRIAGE_SCOPE_META[triageScope];
   const outAbs = stagingPathForTarget(contextDirAbs, "triage", targetFilePathPosix);
-  fs43.mkdirSync(path40.dirname(outAbs), { recursive: true });
+  fs44.mkdirSync(path40.dirname(outAbs), { recursive: true });
   const runDir = path40.join(common.worktreeRoot, ".opencode", "_run");
-  fs43.mkdirSync(runDir, { recursive: true });
+  fs44.mkdirSync(runDir, { recursive: true });
   const outputBasename = path40.basename(outAbs);
   const listTaskDescription = [
     `Target file: **${targetFilePathPosix}** (${workspaceLabel})`,
@@ -24150,7 +24452,7 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
       ...repairAppendix ? { repairAppendix } : {}
     });
     const promptPath = path40.join(runDir, `zero-ref-triage-a${attempt}-${Date.now()}.prompt.txt`);
-    fs43.writeFileSync(promptPath, body, "utf-8");
+    fs44.writeFileSync(promptPath, body, "utf-8");
     const argv = expandArgvTemplate4(common.argvTemplate, {
       promptFile: promptPath,
       agentId: ZERO_REF_TRIAGE_COORD_AGENT_STEM,
@@ -24177,7 +24479,7 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
     const canRetry = attempt < ZERO_REF_STAGING_JSON_TOTAL_ATTEMPTS - 1;
     let st;
     try {
-      st = fs43.statSync(outAbs);
+      st = fs44.statSync(outAbs);
     } catch {
       st = void 0;
     }
@@ -24199,7 +24501,7 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
     }
     let parsed;
     try {
-      parsed = JSON.parse(fs43.readFileSync(outAbs, "utf-8"));
+      parsed = JSON.parse(fs44.readFileSync(outAbs, "utf-8"));
     } catch (e) {
       const msg = e instanceof Error ? e.message : String(e);
       lastFailureMessage = `Triage output not valid JSON: ${msg}`;
@@ -24255,7 +24557,7 @@ async function runCoordinationTriageAgent(common, contextDirAbs, targetFilePathP
       return { ok: false, message: lastFailureMessage, stagingPath: outAbs };
     }
     try {
-      fs43.writeFileSync(outAbs, `${JSON.stringify(parsed, null, 2)}
+      fs44.writeFileSync(outAbs, `${JSON.stringify(parsed, null, 2)}
 `, "utf-8");
     } catch {
     }
@@ -24273,7 +24575,7 @@ async function runOneUnreferencedFilePipeline(p) {
   }
   let stagingParsed;
   try {
-    stagingParsed = JSON.parse(fs43.readFileSync(cr.stagingPath, "utf-8"));
+    stagingParsed = JSON.parse(fs44.readFileSync(cr.stagingPath, "utf-8"));
   } catch (e) {
     return { ok: false, message: String(e) };
   }
@@ -24289,8 +24591,8 @@ async function runOneUnreferencedFilePipeline(p) {
     if (!s.ok) {
       throw new Error(s.errors.join("; "));
     }
-    fs43.mkdirSync(path40.dirname(routingAbs), { recursive: true });
-    fs43.writeFileSync(routingAbs, s.json, "utf-8");
+    fs44.mkdirSync(path40.dirname(routingAbs), { recursive: true });
+    fs44.writeFileSync(routingAbs, s.json, "utf-8");
   });
   const routing = stagingParsed.routing;
   const routingSummary = typeof stagingParsed.projectRelationSummary === "string" ? stagingParsed.projectRelationSummary : "";
@@ -24321,7 +24623,7 @@ async function runOneUnreferencedFilePipeline(p) {
   }
   let triageParsed;
   try {
-    triageParsed = JSON.parse(fs43.readFileSync(tr.stagingPath, "utf-8"));
+    triageParsed = JSON.parse(fs44.readFileSync(tr.stagingPath, "utf-8"));
   } catch (e) {
     return { ok: false, message: String(e) };
   }
@@ -24338,8 +24640,8 @@ async function runOneUnreferencedFilePipeline(p) {
     if (!s.ok) {
       throw new Error(s.errors.join("; "));
     }
-    fs43.mkdirSync(path40.dirname(triageAbs), { recursive: true });
-    fs43.writeFileSync(triageAbs, s.json, "utf-8");
+    fs44.mkdirSync(path40.dirname(triageAbs), { recursive: true });
+    fs44.writeFileSync(triageAbs, s.json, "utf-8");
   });
   const decision = triageParsed.decision;
   if (decision === "new_item" || decision === "enrich_existing") {
@@ -24427,7 +24729,7 @@ async function runRemediationPipelineZeroRefPass(p) {
 }
 
 // src/pipelines/coverage/coverageExecutionReport.ts
-var fs44 = __toESM(require("fs"));
+var fs45 = __toESM(require("fs"));
 var path41 = __toESM(require("path"));
 var REFERENCE_COVERAGE_EXECUTION_REPORT_BASENAME = "reference-coverage-execution-report.md";
 function inlineMdText(s) {
@@ -24524,7 +24826,7 @@ function collectNoActionRowsFromRoutingDoc(doc) {
   return rows;
 }
 function readRoutingDocFromDisk(routingAbs) {
-  if (!fs44.existsSync(routingAbs)) {
+  if (!fs45.existsSync(routingAbs)) {
     return {
       ok: true,
       doc: { schemaVersion: "1", records: {} }
@@ -24532,7 +24834,7 @@ function readRoutingDocFromDisk(routingAbs) {
   }
   let raw;
   try {
-    raw = fs44.readFileSync(routingAbs, "utf-8");
+    raw = fs45.readFileSync(routingAbs, "utf-8");
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : String(e) };
   }
@@ -24572,20 +24874,20 @@ async function runCoverageExecutionReport(p) {
   }
   let previous;
   try {
-    if (fs44.existsSync(outAbs)) {
-      previous = fs44.readFileSync(outAbs, "utf-8");
+    if (fs45.existsSync(outAbs)) {
+      previous = fs45.readFileSync(outAbs, "utf-8");
     }
   } catch {
     previous = void 0;
   }
   try {
-    fs44.mkdirSync(path41.dirname(outAbs), { recursive: true });
-    fs44.writeFileSync(outAbs, md, "utf-8");
+    fs45.mkdirSync(path41.dirname(outAbs), { recursive: true });
+    fs45.writeFileSync(outAbs, md, "utf-8");
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
     if (previous !== void 0) {
       try {
-        fs44.writeFileSync(outAbs, previous, "utf-8");
+        fs45.writeFileSync(outAbs, previous, "utf-8");
       } catch {
       }
     }
@@ -24596,7 +24898,7 @@ async function runCoverageExecutionReport(p) {
 }
 
 // src/gluecharm/minimalGluecharmLayout.ts
-var fs45 = __toESM(require("node:fs"));
+var fs46 = __toESM(require("node:fs"));
 var path42 = __toESM(require("node:path"));
 var MINIMAL_GLUECHARM_RELATIVE_DIRS = [
   [".gluecharm", "docs", "srs"],
@@ -24609,7 +24911,7 @@ function ensureMinimalGluecharmLayoutNode(repoRootAbs) {
   for (const segments of MINIMAL_GLUECHARM_RELATIVE_DIRS) {
     const dir = path42.join(root, ...segments);
     try {
-      fs45.mkdirSync(dir, { recursive: true });
+      fs46.mkdirSync(dir, { recursive: true });
     } catch (e) {
       const err = e;
       const msg = e instanceof Error ? e.message : String(e);
@@ -24991,13 +25293,13 @@ function buildFactoryDepsHeadless(input) {
     },
     runPrepareAnalysisWorktree: async (resume) => {
       if (resume) {
-        if (adHocWorktree && fs46.existsSync(path43.join(adHocWorktree.path, ".git"))) {
+        if (adHocWorktree && fs47.existsSync(path43.join(adHocWorktree.path, ".git"))) {
           return { ok: true };
         }
         const snap = readAnalysisWorkspaceSnapshot(storageContext);
         const wtPath = snap?.adHocWorktreePath?.trim();
         const repo = snap?.adHocRepositoryRoot?.trim() || repoRoot;
-        if (wtPath && fs46.existsSync(path43.join(wtPath, ".git"))) {
+        if (wtPath && fs47.existsSync(path43.join(wtPath, ".git"))) {
           adHocWorktree = attachWorktreeHandle(wtPath, repo);
           macroSourceBranch = snap?.adHocSourceBranchAtCreation;
           macroFinalize = () => {
@@ -25222,7 +25524,7 @@ function stderrLinesForFactoryFailures(failures, exitCode) {
 var path48 = __toESM(require("node:path"));
 
 // src/factory/updateContext/updateContextBaseline.ts
-var fs47 = __toESM(require("node:fs"));
+var fs48 = __toESM(require("node:fs"));
 var path44 = __toESM(require("node:path"));
 function isValidIso(s) {
   const t = Date.parse(s);
@@ -25233,7 +25535,7 @@ function maxMtimeRegularFilesUnderDir(dirAbs) {
   const walk = (d) => {
     let entries;
     try {
-      entries = fs47.readdirSync(d, { withFileTypes: true });
+      entries = fs48.readdirSync(d, { withFileTypes: true });
     } catch {
       return;
     }
@@ -25243,7 +25545,7 @@ function maxMtimeRegularFilesUnderDir(dirAbs) {
         walk(p);
       } else if (e.isFile()) {
         try {
-          const st = fs47.statSync(p);
+          const st = fs48.statSync(p);
           const m = st.mtimeMs;
           if (best === null || m > best) {
             best = m;
@@ -25265,7 +25567,7 @@ function resolveUpdateContextBaseline(repoRootAbs, repoConfig) {
     return { baselineIsoUtc: new Date(last).toISOString(), source: "lastRunAt" };
   }
   const ctxDir = path44.join(repoRootAbs, ".gluecharm", "context");
-  if (!fs47.existsSync(ctxDir)) {
+  if (!fs48.existsSync(ctxDir)) {
     return null;
   }
   const maxMs = maxMtimeRegularFilesUnderDir(ctxDir);
@@ -25288,7 +25590,7 @@ function persistUpdateContextLastRunAt(repoRootAbs, isoUtc) {
 
 // src/factory/updateContext/updateContextGitWindow.ts
 var import_node_child_process3 = require("node:child_process");
-var fs48 = __toESM(require("node:fs"));
+var fs49 = __toESM(require("node:fs"));
 var path45 = __toESM(require("node:path"));
 var GIT_ENV = { ...process.env, GIT_TERMINAL_PROMPT: "0" };
 function gitLines(repoRootAbs, args) {
@@ -25314,7 +25616,7 @@ function parseGitLogIso(line) {
 }
 function discoverCommitWindowAndTouchedPaths(repoRootAbs, baselineIsoUtc) {
   const root = path45.resolve(repoRootAbs);
-  if (!fs48.existsSync(path45.join(root, ".git"))) {
+  if (!fs49.existsSync(path45.join(root, ".git"))) {
     return { ok: false, error: "Not a git repository (missing .git)." };
   }
   const baselineMs = Date.parse(baselineIsoUtc);
@@ -25379,7 +25681,7 @@ function filterPathsExistingInWorktree(worktreeRootAbs, pathsPosix) {
     const rel = p.replace(/\\/g, "/");
     const abs = path45.join(root, ...rel.split("/"));
     try {
-      if (fs48.existsSync(abs) && fs48.statSync(abs).isFile()) {
+      if (fs49.existsSync(abs) && fs49.statSync(abs).isFile()) {
         out.push(rel);
       }
     } catch {
@@ -25389,7 +25691,7 @@ function filterPathsExistingInWorktree(worktreeRootAbs, pathsPosix) {
 }
 
 // src/factory/updateContext/updateContextReport.ts
-var fs49 = __toESM(require("node:fs"));
+var fs50 = __toESM(require("node:fs"));
 var path46 = __toESM(require("node:path"));
 var CHANGES_SINCE_DATE_BASENAME = "changes-since-date.md";
 function renderChangesSinceDateMarkdown(p) {
@@ -25431,9 +25733,9 @@ function renderChangesSinceDateMarkdown(p) {
 }
 function writeChangesSinceDateReport(contextDirAbs, body) {
   try {
-    fs49.mkdirSync(contextDirAbs, { recursive: true });
+    fs50.mkdirSync(contextDirAbs, { recursive: true });
     const target = path46.join(contextDirAbs, CHANGES_SINCE_DATE_BASENAME);
-    fs49.writeFileSync(target, body, "utf-8");
+    fs50.writeFileSync(target, body, "utf-8");
     return { ok: true };
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : String(e) };
@@ -25441,13 +25743,13 @@ function writeChangesSinceDateReport(contextDirAbs, body) {
 }
 
 // src/factory/updateContext/updateContextSeedCheck.ts
-var fs50 = __toESM(require("node:fs"));
+var fs51 = __toESM(require("node:fs"));
 var path47 = __toESM(require("node:path"));
 var INDEX_BASENAME = "index-application-context.json";
 var CHANGES_REPORT = "changes-since-date.md";
 function tryParseJsonFile(abs) {
   try {
-    const raw = fs50.readFileSync(abs, "utf-8");
+    const raw = fs51.readFileSync(abs, "utf-8");
     JSON.parse(raw);
     return true;
   } catch {
@@ -25455,16 +25757,16 @@ function tryParseJsonFile(abs) {
   }
 }
 function isWorktreeContextSeeded(contextDirAbs) {
-  if (!fs50.existsSync(contextDirAbs)) {
+  if (!fs51.existsSync(contextDirAbs)) {
     return false;
   }
   const indexAbs = path47.join(contextDirAbs, INDEX_BASENAME);
-  if (fs50.existsSync(indexAbs) && fs50.statSync(indexAbs).isFile() && tryParseJsonFile(indexAbs)) {
+  if (fs51.existsSync(indexAbs) && fs51.statSync(indexAbs).isFile() && tryParseJsonFile(indexAbs)) {
     return true;
   }
   let names;
   try {
-    names = fs50.readdirSync(contextDirAbs);
+    names = fs51.readdirSync(contextDirAbs);
   } catch {
     return false;
   }
@@ -25478,7 +25780,7 @@ function isWorktreeContextSeeded(contextDirAbs) {
     }
     const p = path47.join(contextDirAbs, name);
     try {
-      if (fs50.statSync(p).isFile()) {
+      if (fs51.statSync(p).isFile()) {
         distinct.add(name);
       }
     } catch {
@@ -25780,11 +26082,11 @@ async function runUpdateContextFactory(deps) {
 }
 
 // src/factory/contextDrift/runContextDriftFactory.ts
-var fs56 = __toESM(require("node:fs"));
+var fs57 = __toESM(require("node:fs"));
 var path53 = __toESM(require("node:path"));
 
 // src/factory/contextDrift/contextDriftManifest.ts
-var fs51 = __toESM(require("node:fs"));
+var fs52 = __toESM(require("node:fs"));
 var path49 = __toESM(require("node:path"));
 var MAX_REFERENCE_BYTES = 256 * 1024;
 var MAX_EVIDENCE_FILES = 300;
@@ -25793,7 +26095,7 @@ var MAX_EXCERPT = 4e3;
 function readFileLimited(abs, maxBytes) {
   let buf;
   try {
-    buf = fs51.readFileSync(abs);
+    buf = fs52.readFileSync(abs);
   } catch {
     return { text: "", truncated: false };
   }
@@ -25806,14 +26108,14 @@ function collectEvidencePaths(repoRoot) {
   const roots = ["src", "test", "tests", "packages", ".gluecharm", "scripts"];
   for (const rel of roots) {
     const abs = path49.join(repoRoot, rel);
-    if (!fs51.existsSync(abs)) {
+    if (!fs52.existsSync(abs)) {
       continue;
     }
     walkFiles(abs, repoRoot, out, 0);
   }
   for (const leaf of ["package.json", "tsconfig.json"]) {
     const abs = path49.join(repoRoot, leaf);
-    if (fs51.existsSync(abs) && fs51.statSync(abs).isFile()) {
+    if (fs52.existsSync(abs) && fs52.statSync(abs).isFile()) {
       const r = path49.relative(repoRoot, abs).split(path49.sep).join("/");
       out.push(r);
     }
@@ -25831,7 +26133,7 @@ function walkFiles(dir, repoRoot, out, depth) {
   }
   let entries;
   try {
-    entries = fs51.readdirSync(dir, { withFileTypes: true });
+    entries = fs52.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
@@ -25868,7 +26170,7 @@ function buildComparisonManifest(args) {
   const evidenceFiles = [];
   for (const rel of evidencePathsTrimmed) {
     const abs = path49.join(args.worktreeRoot, ...rel.split("/"));
-    const st = fs51.existsSync(abs) ? fs51.statSync(abs) : null;
+    const st = fs52.existsSync(abs) ? fs52.statSync(abs) : null;
     const size = st && st.isFile() ? st.size : 0;
     const { text, truncated } = readFileLimited(abs, MAX_EVIDENCE_READ);
     const excerpt = truncated ? `${text.slice(0, MAX_EXCERPT)}
@@ -25890,7 +26192,7 @@ function buildComparisonManifest(args) {
 }
 
 // src/factory/contextDrift/contextDriftAgent.ts
-var fs52 = __toESM(require("node:fs"));
+var fs53 = __toESM(require("node:fs"));
 var path50 = __toESM(require("node:path"));
 
 // src/factory/contextDrift/contextDriftPayload.ts
@@ -26037,16 +26339,16 @@ function buildDriftPrompt(args) {
 }
 async function runDriftComparisonOpenCode(args) {
   const runDir = path50.join(args.worktreeRoot, ".opencode", "_run");
-  fs52.mkdirSync(runDir, { recursive: true });
+  fs53.mkdirSync(runDir, { recursive: true });
   const manifestPath = path50.join(runDir, "context-drift-manifest.json");
   const outputPath = path50.join(runDir, "context-drift-payload.json");
-  fs52.writeFileSync(manifestPath, `${JSON.stringify(args.manifestObject, null, 2)}
+  fs53.writeFileSync(manifestPath, `${JSON.stringify(args.manifestObject, null, 2)}
 `, "utf8");
-  if (fs52.existsSync(outputPath)) {
-    fs52.unlinkSync(outputPath);
+  if (fs53.existsSync(outputPath)) {
+    fs53.unlinkSync(outputPath);
   }
   const promptPath = path50.join(runDir, `context-drift-${Date.now()}.prompt.txt`);
-  fs52.writeFileSync(
+  fs53.writeFileSync(
     promptPath,
     buildDriftPrompt({
       worktreeRoot: args.worktreeRoot,
@@ -26088,7 +26390,7 @@ async function runDriftComparisonOpenCode(args) {
   }
   let raw;
   try {
-    const txt = fs52.readFileSync(outputPath, "utf8");
+    const txt = fs53.readFileSync(outputPath, "utf8");
     raw = JSON.parse(txt);
   } catch (e) {
     return {
@@ -26105,7 +26407,7 @@ async function runDriftComparisonOpenCode(args) {
 
 // src/factory/contextDrift/contextDriftPaths.ts
 var crypto2 = __toESM(require("node:crypto"));
-var fs53 = __toESM(require("node:fs"));
+var fs54 = __toESM(require("node:fs"));
 var path51 = __toESM(require("node:path"));
 var DRIFT_CONTEXT_SUBDIR = path51.join(".gluecharm", "context", "drift");
 function sanitizeSlug(raw) {
@@ -26144,7 +26446,7 @@ function maybeDedupeSlug(slug, referenceRelPosix) {
 function discoverReferenceBundle(worktreeRoot, referenceAbsInWorktree) {
   let st;
   try {
-    st = fs53.statSync(referenceAbsInWorktree);
+    st = fs54.statSync(referenceAbsInWorktree);
   } catch {
     return { ok: false, error: `Reference path not found in analysis worktree: ${referenceAbsInWorktree}` };
   }
@@ -26165,7 +26467,7 @@ function discoverReferenceBundle(worktreeRoot, referenceAbsInWorktree) {
     }
     let entries;
     try {
-      entries = fs53.readdirSync(dir, { withFileTypes: true });
+      entries = fs54.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -26190,7 +26492,7 @@ function discoverReferenceBundle(worktreeRoot, referenceAbsInWorktree) {
 }
 function pickReferenceRootDocument(args) {
   if (args.indexOverrideAbs) {
-    if (!fs53.existsSync(args.indexOverrideAbs) || !args.indexOverrideAbs.endsWith(".md")) {
+    if (!fs54.existsSync(args.indexOverrideAbs) || !args.indexOverrideAbs.endsWith(".md")) {
       return { ok: false, error: "--index must point to an existing .md file under the repo." };
     }
     return { ok: true, path: args.indexOverrideAbs };
@@ -26201,7 +26503,7 @@ function pickReferenceRootDocument(args) {
   const dir = args.referenceAbsInWorktree;
   for (const name of ["index.md", "README.md"]) {
     const p = path51.join(dir, name);
-    if (fs53.existsSync(p) && fs53.statSync(p).isFile()) {
+    if (fs54.existsSync(p) && fs54.statSync(p).isFile()) {
       return { ok: true, path: p };
     }
   }
@@ -26218,13 +26520,13 @@ function toPosixPath(p) {
 }
 
 // src/factory/contextDrift/contextDriftIndex.ts
-var fs54 = __toESM(require("node:fs"));
+var fs55 = __toESM(require("node:fs"));
 var START = "<!-- easyspecs-drift-links:start -->";
 var END = "<!-- easyspecs-drift-links:end -->";
 function patchReferenceIndexWithDriftLink(args) {
   let body;
   try {
-    body = fs54.readFileSync(args.referenceRootAbsolute, "utf8");
+    body = fs55.readFileSync(args.referenceRootAbsolute, "utf8");
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : String(e) };
   }
@@ -26245,7 +26547,7 @@ ${block}
 `;
   }
   try {
-    fs54.writeFileSync(args.referenceRootAbsolute, next, "utf8");
+    fs55.writeFileSync(args.referenceRootAbsolute, next, "utf8");
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : String(e) };
   }
@@ -26256,13 +26558,13 @@ function escapeRe(s) {
 }
 
 // src/factory/contextDrift/contextDriftPromote.ts
-var fs55 = __toESM(require("node:fs"));
+var fs56 = __toESM(require("node:fs"));
 var path52 = __toESM(require("node:path"));
 function copyWorktreeFileToWorkspace(args) {
   const src = path52.join(args.worktreeRoot, ...args.relativePosix.split("/"));
   const dest = path52.join(args.workspaceRoot, ...args.relativePosix.split("/"));
-  fs55.mkdirSync(path52.dirname(dest), { recursive: true });
-  fs55.copyFileSync(src, dest);
+  fs56.mkdirSync(path52.dirname(dest), { recursive: true });
+  fs56.copyFileSync(src, dest);
 }
 
 // src/factory/contextDrift/runContextDriftFactory.ts
@@ -26281,7 +26583,7 @@ async function runContextDriftFactory(deps) {
     };
   }
   const refAbsWorkspace = resolved.abs;
-  if (!fs56.existsSync(refAbsWorkspace)) {
+  if (!fs57.existsSync(refAbsWorkspace)) {
     return {
       exitOk: false,
       ok: false,
@@ -26294,7 +26596,7 @@ async function runContextDriftFactory(deps) {
   let indexOverrideAbsWorkspace;
   if (deps.indexOverrideArg?.trim()) {
     const ir = resolveInsideRepo(deps.repoRootAbs, deps.indexOverrideArg.trim());
-    if (!ir.ok || !fs56.existsSync(ir.abs)) {
+    if (!ir.ok || !fs57.existsSync(ir.abs)) {
       return {
         exitOk: false,
         ok: false,
@@ -26312,7 +26614,7 @@ async function runContextDriftFactory(deps) {
       ok: true,
       code: "DRY_RUN",
       ...baseMeta,
-      referenceRootDocument: toPosixPath(path53.relative(deps.repoRootAbs, refAbsWorkspace)) + (fs56.statSync(refAbsWorkspace).isDirectory() ? "/" : ""),
+      referenceRootDocument: toPosixPath(path53.relative(deps.repoRootAbs, refAbsWorkspace)) + (fs57.statSync(refAbsWorkspace).isDirectory() ? "/" : ""),
       driftReportPath: null,
       analysisWorktreeRoot: "",
       promoted: false,
@@ -26381,7 +26683,7 @@ async function runContextDriftFactory(deps) {
   }
   const indexWt = indexOverrideAbsWorkspace ? path53.join(wt, ...path53.relative(deps.repoRootAbs, indexOverrideAbsWorkspace).split(path53.sep)) : void 0;
   const rootPick = pickReferenceRootDocument({
-    referencePathIsFile: fs56.statSync(refAbsWt).isFile(),
+    referencePathIsFile: fs57.statSync(refAbsWt).isFile(),
     referenceAbsInWorktree: refAbsWt,
     bundleFiles: bundle.bundleFiles,
     indexOverrideAbs: indexWt
@@ -26408,7 +26710,7 @@ async function runContextDriftFactory(deps) {
   slug = maybeDedupeSlug(slug, refRel);
   const driftBase = driftFilename(slug, runDate);
   const driftDirWt = path53.join(wt, DRIFT_CONTEXT_SUBDIR);
-  fs56.mkdirSync(driftDirWt, { recursive: true });
+  fs57.mkdirSync(driftDirWt, { recursive: true });
   const driftAbsWt = path53.join(driftDirWt, driftBase);
   let payload;
   if (deps.testOnlyFixturePayload) {
@@ -26445,7 +26747,7 @@ async function runContextDriftFactory(deps) {
     manifestTruncation: manifest.truncation
   });
   try {
-    fs56.writeFileSync(driftAbsWt, md, "utf8");
+    fs57.writeFileSync(driftAbsWt, md, "utf8");
   } catch (e) {
     finalizeWt?.();
     return {
@@ -26524,7 +26826,7 @@ async function runContextDriftFactory(deps) {
 }
 
 // src/analysis/coordinationDuplicatesDiagnosis.ts
-var fs57 = __toESM(require("fs"));
+var fs58 = __toESM(require("fs"));
 var path54 = __toESM(require("path"));
 var import__7 = __toESM(require__());
 var COORDINATION_DUPLICATES_REPORT_BASENAME = "coordination-duplicates-report.json";
@@ -26561,11 +26863,11 @@ function looksLikeCoordinationDetailMarkdownBasename(basename17) {
 }
 function loadRawFeatureRows(contextDirAbs) {
   const p = path54.join(contextDirAbs, "features-list.json");
-  if (!fs57.existsSync(p)) {
+  if (!fs58.existsSync(p)) {
     return [];
   }
   try {
-    const raw = stripUtf8Bom6(fs57.readFileSync(p, "utf-8"));
+    const raw = stripUtf8Bom6(fs58.readFileSync(p, "utf-8"));
     const doc = JSON.parse(raw);
     return Array.isArray(doc.features) ? doc.features : [];
   } catch {
@@ -26600,7 +26902,7 @@ function findOrphanCoordinationMarkdown(contextDirAbs) {
   const featureRows = loadRawFeatureRows(contextDirAbs);
   let dirents;
   try {
-    dirents = fs57.readdirSync(contextDirAbs, { withFileTypes: true });
+    dirents = fs58.readdirSync(contextDirAbs, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -26854,13 +27156,13 @@ function buildCoordinationDuplicatesReport(input) {
   const duplicateGroups = [];
   for (const entry of COORDINATION_LIST_SCAN_ENTRIES) {
     const filePath = path54.join(input.contextDirAbsolute, entry.basename);
-    if (!fs57.existsSync(filePath)) {
+    if (!fs58.existsSync(filePath)) {
       lists.push({ basename: entry.basename, status: "missing" });
       continue;
     }
     let raw;
     try {
-      raw = stripUtf8Bom6(fs57.readFileSync(filePath, "utf-8"));
+      raw = stripUtf8Bom6(fs58.readFileSync(filePath, "utf-8"));
     } catch (e) {
       lists.push({
         basename: entry.basename,
@@ -26909,7 +27211,7 @@ function validateReportData(data) {
   if (!validateReportCompiled) {
     const ajv2 = new import__7.default({ allErrors: true, strict: false });
     const schemaPath = path54.join(resolveContextListSchemasDir(), "coordination-duplicates-report.schema.json");
-    const schemaRaw = stripUtf8Bom6(fs57.readFileSync(schemaPath, "utf-8"));
+    const schemaRaw = stripUtf8Bom6(fs58.readFileSync(schemaPath, "utf-8"));
     validateReportCompiled = ajv2.compile(JSON.parse(schemaRaw));
   }
   if (validateReportCompiled(data)) {
@@ -26932,15 +27234,15 @@ function runCoordinationDuplicatesDiagnosis(input) {
 `;
   const tmp = `${outPath}.tmp.${process.pid}`;
   try {
-    fs57.writeFileSync(tmp, payload, "utf-8");
+    fs58.writeFileSync(tmp, payload, "utf-8");
   } catch (e) {
     return { ok: false, message: e instanceof Error ? e.message : String(e) };
   }
   try {
-    fs57.renameSync(tmp, outPath);
+    fs58.renameSync(tmp, outPath);
   } catch (e) {
     try {
-      fs57.unlinkSync(tmp);
+      fs58.unlinkSync(tmp);
     } catch {
     }
     return { ok: false, message: e instanceof Error ? e.message : String(e) };
@@ -26974,7 +27276,7 @@ function runCoordinationDuplicatesDiagnosis(input) {
 }
 
 // src/pipelines/download/downloadPipeline.ts
-var fs58 = __toESM(require("node:fs"));
+var fs59 = __toESM(require("node:fs"));
 var path55 = __toESM(require("node:path"));
 var SRS_DISCOVERY_BATCH_GET_CHUNK_SIZE = 200;
 function isRecord7(v) {
@@ -27080,19 +27382,19 @@ function chunkIds(ids, size) {
   return out;
 }
 function clearContextDirectoryForCloudReplace(contextDirAbs) {
-  if (!fs58.existsSync(contextDirAbs) || !fs58.statSync(contextDirAbs).isDirectory()) {
+  if (!fs59.existsSync(contextDirAbs) || !fs59.statSync(contextDirAbs).isDirectory()) {
     return { filesRemoved: 0 };
   }
   const preserveAbs = path55.resolve(contextDirAbs, UPLOAD_TARGET_FILENAME);
   const preserveSet = /* @__PURE__ */ new Set();
-  if (fs58.existsSync(preserveAbs) && fs58.statSync(preserveAbs).isFile()) {
+  if (fs59.existsSync(preserveAbs) && fs59.statSync(preserveAbs).isFile()) {
     preserveSet.add(preserveAbs);
   }
   let filesRemoved = 0;
   const walkRm = (dir) => {
     let entries;
     try {
-      entries = fs58.readdirSync(dir, { withFileTypes: true });
+      entries = fs59.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -27101,7 +27403,7 @@ function clearContextDirectoryForCloudReplace(contextDirAbs) {
       if (e.isDirectory()) {
         walkRm(full);
         try {
-          fs58.rmdirSync(full);
+          fs59.rmdirSync(full);
         } catch {
         }
       } else if (e.isFile()) {
@@ -27110,7 +27412,7 @@ function clearContextDirectoryForCloudReplace(contextDirAbs) {
           continue;
         }
         try {
-          fs58.unlinkSync(abs);
+          fs59.unlinkSync(abs);
           filesRemoved += 1;
         } catch {
         }
@@ -27189,15 +27491,15 @@ async function runDownloadPipeline(opts) {
       failed.push({ id, name, message: "Unsafe or invalid name for local path." });
       continue;
     }
-    fs58.mkdirSync(path55.dirname(outAbs), { recursive: true });
-    const exists = fs58.existsSync(outAbs);
+    fs59.mkdirSync(path55.dirname(outAbs), { recursive: true });
+    const exists = fs59.existsSync(outAbs);
     if (exists && !opts.force && !opts.replaceFromCloud) {
       skipped += 1;
       log?.(`[pipeline:download] skip existing ${name} (use --force to overwrite).`);
       continue;
     }
     try {
-      fs58.writeFileSync(outAbs, bodyText, "utf8");
+      fs59.writeFileSync(outAbs, bodyText, "utf8");
       downloaded += 1;
       succeededIds[outAbs] = id;
     } catch (e) {
@@ -27368,7 +27670,7 @@ function createAuthenticatedRequestJson(deps) {
 }
 
 // src/cli/cliSession.ts
-var fs59 = __toESM(require("node:fs"));
+var fs60 = __toESM(require("node:fs"));
 var os6 = __toESM(require("node:os"));
 var path56 = __toESM(require("node:path"));
 function defaultSessionPath() {
@@ -27413,10 +27715,10 @@ function effectiveCliSessionPath() {
 function readCliSession() {
   const p = effectiveCliSessionPath();
   try {
-    if (!fs59.existsSync(p)) {
+    if (!fs60.existsSync(p)) {
       return void 0;
     }
-    const j = JSON.parse(fs59.readFileSync(p, "utf8"));
+    const j = JSON.parse(fs60.readFileSync(p, "utf8"));
     const apiBaseUrl = typeof j.apiBaseUrl === "string" ? j.apiBaseUrl.trim() : "";
     const accessToken = typeof j.accessToken === "string" ? j.accessToken : "";
     const refreshToken = typeof j.refreshToken === "string" ? j.refreshToken : "";
@@ -27430,20 +27732,20 @@ function readCliSession() {
 }
 function writeCliSession(s) {
   const p = effectiveCliSessionPath();
-  fs59.mkdirSync(path56.dirname(p), { recursive: true });
-  fs59.writeFileSync(p, `${JSON.stringify(s, null, 2)}
+  fs60.mkdirSync(path56.dirname(p), { recursive: true });
+  fs60.writeFileSync(p, `${JSON.stringify(s, null, 2)}
 `, "utf8");
 }
 function clearCliSession() {
   const p = effectiveCliSessionPath();
   try {
-    fs59.unlinkSync(p);
+    fs60.unlinkSync(p);
   } catch {
   }
 }
 
 // src/analysis/acePendingTraces.ts
-var fs60 = __toESM(require("fs"));
+var fs61 = __toESM(require("fs"));
 var path57 = __toESM(require("path"));
 function normalizeAceTraceRelativePath(rel) {
   return rel.split(/[/\\]/).join("/");
@@ -27451,12 +27753,12 @@ function normalizeAceTraceRelativePath(rel) {
 function readCompletedTraceRelativePaths(contextDir2) {
   const set = /* @__PURE__ */ new Set();
   const jsonlPath = aceConsolidatedSessionsJsonlPath(contextDir2);
-  if (!fs60.existsSync(jsonlPath)) {
+  if (!fs61.existsSync(jsonlPath)) {
     return set;
   }
   let raw;
   try {
-    raw = fs60.readFileSync(jsonlPath, "utf8");
+    raw = fs61.readFileSync(jsonlPath, "utf8");
   } catch {
     return set;
   }
@@ -27487,7 +27789,7 @@ function readCompletedTraceRelativePaths(contextDir2) {
 }
 function listPendingAceTraceFiles(contextDir2, worktreeRoot) {
   const traceSchema = opencodeAceSchemaPath(worktreeRoot, ACE_SCHEMA_TRACE);
-  if (!fs60.existsSync(traceSchema)) {
+  if (!fs61.existsSync(traceSchema)) {
     return [];
   }
   const completed = readCompletedTraceRelativePaths(contextDir2);
@@ -27791,7 +28093,9 @@ var TAG_SGR = {
   "zero-ref": "\x1B[91m",
   ace: "\x1B[95m",
   cli: "\x1B[90m",
-  EasySpecs: "\x1B[93m"
+  EasySpecs: "\x1B[93m",
+  "host-pool": "\x1B[36m",
+  "host-pool-rec": "\x1B[90m"
 };
 function tagOpenSgr(tag) {
   const direct = TAG_SGR[tag];
@@ -27832,7 +28136,7 @@ function phaseFamilyForTag(tag) {
   if (tag.startsWith("pipeline:")) {
     return "meta";
   }
-  if (tag === "pool" || tag === "queue" || tag === "worktree" || tag === "context") {
+  if (tag === "pool" || tag === "queue" || tag === "worktree" || tag === "context" || tag === "host-pool" || tag === "host-pool-rec") {
     return "orch";
   }
   if (Object.prototype.hasOwnProperty.call(TAG_SGR, tag)) {
@@ -28091,7 +28395,7 @@ function formatCliStderrLine(line, useAnsi) {
 }
 
 // src/cli/main.ts
-var PKG_VERSION = "0.0.26";
+var PKG_VERSION = "0.0.28";
 function isNonEmptyFactoryFailureArray(x) {
   if (!Array.isArray(x) || x.length === 0) {
     return false;
@@ -28223,7 +28527,7 @@ function resolveAnalysisRoot(repoRoot, rootKind, worktreePath) {
     return repoRoot;
   }
   const wt = worktreePath?.trim();
-  if (wt && fs61.existsSync(path59.join(wt, ".git"))) {
+  if (wt && fs62.existsSync(path59.join(wt, ".git"))) {
     return path59.resolve(wt);
   }
   throw new Error("worktree mode requires --worktree <path> to an existing analysis checkout.");
@@ -28232,14 +28536,14 @@ function resolveAdHocCheckoutRoot(_repoRoot, storage, worktreeFlag) {
   const w = worktreeFlag?.trim();
   if (w) {
     const abs = path59.resolve(w);
-    if (fs61.existsSync(path59.join(abs, ".git"))) {
+    if (fs62.existsSync(path59.join(abs, ".git"))) {
       return abs;
     }
     throw new Error(`Invalid --worktree (not a git checkout): ${abs}`);
   }
   const snap = readAnalysisWorkspaceSnapshot(storage);
   const p = snap?.adHocWorktreePath?.trim();
-  if (p && fs61.existsSync(path59.join(p, ".git"))) {
+  if (p && fs62.existsSync(path59.join(p, ".git"))) {
     return p;
   }
   throw new Error("No analysis checkout: run `easyspecs-cli run synthesis` first or pass `--worktree <path>`.");
@@ -28562,7 +28866,7 @@ async function main() {
         process.exit(ExitCode.usage);
       }
       const agentsDir = resolveOpenCodeAgentsDir(repoRoot, repoConfig);
-      const agentsOk = fs61.existsSync(agentsDir);
+      const agentsOk = fs62.existsSync(agentsDir);
       const oc = getOpenCodeReadiness({
         executable: merged.openCodeExecutable,
         skipCredentialsCheck: merged.openCodeSkipCredentialsCheck,
@@ -29078,7 +29382,7 @@ async function main() {
         const wt = snap?.adHocWorktreePath?.trim();
         if (wt) {
           const sourceCtx = path59.join(wt, ".gluecharm", "context");
-          if (fs61.existsSync(sourceCtx)) {
+          if (fs62.existsSync(sourceCtx)) {
             const n = promoteContextDirectoryToWorkspaceFs(sourceCtx, repoRoot);
             logErr(flags, `[pipeline:analysis] promoted ${String(n.filesCopied)} file(s) \u2192 ${repoRoot}`);
           } else {
@@ -29248,12 +29552,12 @@ async function main() {
       if (pos[1] === "republish") {
         const fromCfg = repoConfig.easyspecs?.upload?.contextDirectory?.trim();
         const resolvedOverride = fromCfg && fromCfg.length > 0 ? path59.isAbsolute(fromCfg) ? path59.normalize(fromCfg) : path59.resolve(repoRoot, fromCfg) : "";
-        if (resolvedOverride && fs61.existsSync(path59.join(resolvedOverride, ".."))) {
+        if (resolvedOverride && fs62.existsSync(path59.join(resolvedOverride, ".."))) {
           ctxDir = resolvedOverride;
         } else {
           const storage = createFileBackedWorkspaceState(repoRoot);
           const snap = readAnalysisWorkspaceSnapshot(storage);
-          const wt = snap?.adHocWorktreePath && fs61.existsSync(path59.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path59.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
+          const wt = snap?.adHocWorktreePath && fs62.existsSync(path59.join(snap.adHocWorktreePath, ".gluecharm", "context")) ? path59.join(snap.adHocWorktreePath, ".gluecharm", "context") : "";
           if (!wt) {
             finish(ExitCode.misconfiguration, {
               ok: false,
@@ -29371,16 +29675,16 @@ async function main() {
     }
     if (pos[0] === "ace" && pos[1] === "clear") {
       const learnings = path59.join(repoRoot, ".gluecharm", "context", "learnings");
-      if (!fs61.existsSync(learnings)) {
+      if (!fs62.existsSync(learnings)) {
         finish(ExitCode.ok, { ok: true, message: "nothing to clear" });
       }
-      fs61.rmSync(learnings, { recursive: true, force: true });
+      fs62.rmSync(learnings, { recursive: true, force: true });
       finish(ExitCode.ok, { ok: true, message: `cleared ${learnings}` });
     }
     if (pos[0] === "ace" && pos[1] === "learn") {
       requireOpenCode(merged, flags);
       const { worktree } = parseWorktreeFlag(pos.slice(2));
-      const root = worktree && fs61.existsSync(path59.join(worktree, ".opencode", "schemas", "ace")) ? worktree : repoRoot;
+      const root = worktree && fs62.existsSync(path59.join(worktree, ".opencode", "schemas", "ace")) ? worktree : repoRoot;
       const contextDir2 = path59.join(root, ".gluecharm", "context");
       const traces = listAceTraceFiles(contextDir2);
       if (traces.length === 0) {
@@ -29405,7 +29709,7 @@ async function main() {
     if (pos[0] === "ace" && pos[1] === "auto-learn") {
       requireOpenCode(merged, flags);
       const { worktree } = parseWorktreeFlag(pos.slice(2));
-      const root = worktree && fs61.existsSync(path59.join(worktree, ".git")) ? worktree : repoRoot;
+      const root = worktree && fs62.existsSync(path59.join(worktree, ".git")) ? worktree : repoRoot;
       const contextDir2 = path59.join(root, ".gluecharm", "context");
       const pending = listPendingAceTraceFiles(contextDir2, root);
       if (pending.length === 0) {