feat: Claude Code Monitor — lanes, pipelines and a merged workspace

Internal SmartGift build of a Claude Code monitoring dashboard.

Lanes: a durable unit of parallel agent work, one per working directory,
tracked across session restarts. Managed lanes are git worktrees the
dashboard provisions and can reset or remove behind a three-check destroy
guard and a counted preflight; adopted lanes are directories you already
own and are never destroyable.

Pipelines: a lane moves through pipeline stages. A stage the agent declares
with evidence renders green; a stage inferred from the tool-event stream
renders dashed amber and never counts as done. Detection is forward-only
within a 30-minute window, and never writes the declared stage.

Workspace: one page at /run with a lane grid, the selected lane's pipeline,
and a full Claude console behind a disclosure.

mcp/__tests__/tool-result.test.ts

@@ -0,0 +1,69 @@
+/**
+ * @file tool-result.test.ts
+ * @description Unit tests for the tool result formatting functions, which are responsible for converting tool outputs and errors into a standardized format that can be rendered in the MCP dashboard. The tests cover the behavior of the jsonResult function, ensuring that it correctly wraps payloads as text content with appropriate titles, and the errorResult function, verifying that it handles different types of errors (ApiError, generic Error, and non-Error values) and formats them into a consistent error result structure. The tests use Node's built-in test runner and assert module for assertions.
+ * @author Nguyễn Ngọc Trí Vĩ <vinnt@smartgift.vn>
+ */
+
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { jsonResult, errorResult } from "../src/core/tool-result.js";
+import { ApiError } from "../src/clients/dashboard-api-client.js";
+
+describe("jsonResult", () => {
+  it("wraps payload as text content with title", () => {
+    const result = jsonResult("my_tool", { status: "ok" });
+    assert.equal(result.content.length, 1);
+    assert.equal(result.content[0].type, "text");
+    assert.ok(result.content[0].type === "text" && result.content[0].text.includes("my_tool"));
+    assert.ok(
+      result.content[0].type === "text" && result.content[0].text.includes('"status": "ok"')
+    );
+  });
+
+  it("handles null payload", () => {
+    const result = jsonResult("null_tool", null);
+    assert.equal(result.content.length, 1);
+    assert.ok(result.content[0].type === "text" && result.content[0].text.includes("null"));
+  });
+
+  it("handles array payload", () => {
+    const result = jsonResult("arr_tool", [1, 2, 3]);
+    assert.equal(result.content.length, 1);
+    assert.ok(result.content[0].type === "text" && result.content[0].text.includes("["));
+  });
+});
+
+describe("errorResult", () => {
+  it("handles ApiError with status and details", () => {
+    const apiErr = new ApiError("Not found", {
+      status: 404,
+      code: "NOT_FOUND",
+      details: { path: "/api/sessions/x" },
+    });
+    const result = errorResult(apiErr);
+    assert.equal(result.isError, true);
+    assert.equal(result.content.length, 1);
+    const text = result.content[0].type === "text" ? result.content[0].text : "";
+    const parsed = JSON.parse(text);
+    assert.equal(parsed.error, "Not found");
+    assert.equal(parsed.status, 404);
+    assert.equal(parsed.code, "NOT_FOUND");
+  });
+
+  it("handles generic Error", () => {
+    const result = errorResult(new Error("Something broke"));
+    assert.equal(result.isError, true);
+    const text = result.content[0].type === "text" ? result.content[0].text : "";
+    const parsed = JSON.parse(text);
+    assert.equal(parsed.error, "Something broke");
+    assert.equal(parsed.code, "INTERNAL_ERROR");
+  });
+
+  it("handles non-Error thrown value", () => {
+    const result = errorResult("string error");
+    assert.equal(result.isError, true);
+    const text = result.content[0].type === "text" ? result.content[0].text : "";
+    const parsed = JSON.parse(text);
+    assert.equal(parsed.error, "Unknown error");
+  });
+});