/** * @file Tests the `tmux` row of scripts/plugin-doctor.js — the check that tells * an install its browser run console cannot work, because every run the * dashboard starts is a tmux session (server/lib/tmux.js). The row must WARN * and never FAIL: sessions, analytics, lanes and the CLI all work without the * binary, so failing a doctor run over it would cry wolf. tmux is faked through * the module's own exec seam, so the test never depends on the host having it. * @author Nguyễn Ngọc Trí Vĩ */ const { describe, it, after } = require("node:test"); const assert = require("node:assert/strict"); const fs = require("node:fs"); const os = require("node:os"); const path = require("node:path"); const TMP_HOME = fs.mkdtempSync(path.join(os.tmpdir(), "agenthub-doctor-tmux-")); process.env.CLAUDE_HOME = TMP_HOME; const tmux = require("../lib/tmux"); const { diagnose } = require("../../scripts/plugin-doctor"); after(() => { tmux.__reset(); fs.rmSync(TMP_HOME, { recursive: true, force: true }); delete process.env.CLAUDE_HOME; }); /** Fake the tmux binary as present or absent, then read back the row. */ function rowWithTmux(present) { tmux.__setExecImpl(() => { if (!present) throw new Error("spawnSync tmux ENOENT"); return "tmux 3.4\n"; }); const row = diagnose().find((r) => r.label === "tmux"); assert.ok(row, "the doctor must always emit a tmux row"); return row; } describe("plugin-doctor: tmux row", () => { it("warns, never fails, when tmux is not on PATH", () => { const row = rowWithTmux(false); assert.equal(row.level, "warn", "a missing tmux must not fail the doctor run"); assert.match(row.detail, /lanes shell/, "the reader needs to know WHAT breaks"); assert.match(row.detail, /install/i, "and how to fix it"); }); it("passes when tmux is available", () => { const row = rowWithTmux(true); assert.equal(row.level, "ok", row.detail); }); });