/** * @file Tests for the persisted run history (`server/lib/dashboard-runs.js`). * A run's id is its tmux pane name, which every Start in that pane reuses, so * a new run must ARCHIVE the previous row under its own id instead of * overwriting it; and a row is flagged dead only when its tmux session is * really gone — panes outlive a server restart. * @author Nguyễn Ngọc Trí Vĩ */ const { describe, it, before, 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 ROOT = fs.mkdtempSync(path.join(os.tmpdir(), "dashboard-runs-")); process.env.DASHBOARD_DB_PATH = path.join(ROOT, "t.db"); let runs; before(() => { runs = require("../lib/dashboard-runs"); }); after(() => fs.rmSync(ROOT, { recursive: true, force: true })); const start = (id, extra = {}) => runs.recordRun({ id, mode: "interactive", cwd: "/r", status: "running", laneId: 4, ...extra }); describe("dashboard-runs", () => { it("keeps the previous run of a pane as history when the pane starts again", () => { start("agenthub-lane-4", { startedAt: Date.parse("2026-10-01T10:00:00Z"), sessionId: "s-old" }); start("agenthub-lane-4", { startedAt: Date.parse("2026-10-02T10:00:00Z"), sessionId: "s-new" }); const current = runs.getRun("agenthub-lane-4"); assert.equal(current.session_id, "s-new"); const history = runs.listRuns({ laneId: 4 }); assert.equal(history.length, 2); const old = history.find((r) => r.session_id === "s-old"); assert.notEqual(old.id, "agenthub-lane-4"); assert.ok(old.id.startsWith("agenthub-lane-4@"), old.id); // A pane that is being replaced is not running any more. assert.equal(old.status, "abandoned"); assert.ok(old.ended_at); }); it("narrows a lane's history to one tool", () => { start("agenthub-lane-8", { laneId: 8, tool: "claude" }); start("agenthub-lane-8-1", { laneId: 8, tool: "shell" }); const shells = runs.listRuns({ laneId: 8, tool: "shell" }); assert.deepEqual( shells.map((r) => r.id), ["agenthub-lane-8-1"] ); assert.equal(runs.listRuns({ laneId: 8 }).length, 2); }); it("forgets a closed Terminal tab and nothing of another tool", () => { start("agenthub-lane-9", { laneId: 9, tool: "claude" }); start("agenthub-lane-9-1", { laneId: 9, tool: "shell" }); assert.equal(runs.forgetShellRun("agenthub-lane-9"), false); assert.ok(runs.getRun("agenthub-lane-9")); assert.equal(runs.forgetShellRun("agenthub-lane-9-1"), true); assert.equal(runs.getRun("agenthub-lane-9-1"), null); }); it("keeps only the newest closed Terminal tabs of a lane, live ones untouched", () => { for (let i = 1; i <= 5; i++) { start(`agenthub-lane-11-${i}`, { laneId: 11, tool: "shell", startedAt: Date.parse(`2026-10-0${i}T10:00:00Z`), }); } start("agenthub-lane-11", { laneId: 11, tool: "claude", startedAt: Date.parse("2026-09-01") }); // Pane 5 still runs; every other one has closed. runs.reconcileOrphans((id) => id === "agenthub-lane-11-5"); const shells = runs.listRuns({ laneId: 11, tool: "shell" }).map((r) => r.id); assert.deepEqual(shells, [ "agenthub-lane-11-5", "agenthub-lane-11-4", "agenthub-lane-11-3", "agenthub-lane-11-2", ]); assert.ok(runs.getRun("agenthub-lane-11"), "another tool's row stays"); }); it("flags as abandoned only the running rows whose pane is gone", () => { start("agenthub-lane-5", { laneId: 5 }); start("agenthub-lane-6", { laneId: 6 }); const n = runs.reconcileOrphans((id) => id !== "agenthub-lane-6"); assert.equal(n, 1); assert.equal(runs.getRun("agenthub-lane-5").status, "running"); assert.equal(runs.getRun("agenthub-lane-6").status, "abandoned"); }); it("gives a hookless tool's session the lane of the run it started in", () => { const { db } = require("../db"); start("agenthub-lane-7-1", { laneId: 7, cwd: "/w", tool: "antigravity", startedAt: Date.parse("2026-10-05T08:49:57.145Z"), }); runs.patchRun({ id: "agenthub-lane-7-1", status: "killed", endedAt: Date.parse("2026-10-05T08:50:10.740Z"), }); const add = db.prepare( "INSERT INTO sessions (id, name, status, cwd, started_at, tool) VALUES (?, 'x', 'completed', ?, ?, ?)" ); add.run("in", "/w", "2026-10-05T08:50:01Z", "antigravity"); add.run("before", "/w", "2026-10-05T08:40:00Z", "antigravity"); add.run("after", "/w", "2026-10-05T09:00:00Z", "antigravity"); add.run("elsewhere", "/x", "2026-10-05T08:50:01Z", "antigravity"); add.run("other-tool", "/w", "2026-10-05T08:50:01Z", "codex"); add.run("claude", "/w", "2026-10-05T08:50:01Z", "claude"); runs.claimToolSessions(); const lane = (id) => db.prepare("SELECT lane_id FROM sessions WHERE id = ?").get(id).lane_id; assert.equal(lane("in"), 7); for (const id of ["before", "after", "elsewhere", "other-tool", "claude"]) { assert.equal(lane(id), null, id); } // One session at a time also becomes its run's session. assert.equal(runs.getRun("agenthub-lane-7-1").session_id, null); runs.claimToolSessions("in"); assert.equal(runs.getRun("agenthub-lane-7-1").session_id, "in"); }); });