@hellcoder/companion 0.107.0 → 0.107.1-preview.20260719040931.f983b4d

package/server/routes/dashboard-routes.test.ts

@@ -0,0 +1,139 @@
+import { describe, expect, it, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { Hono } from "hono";
+import { registerDashboardRoutes } from "./dashboard-routes.js";
+import { DashboardStore } from "../dashboard-store.js";
+import { _resetForTest } from "../settings-manager.js";
+import { _resetDashboardRunStateForTest } from "../dashboard-summarizer.js";
+import type { DashboardRunMeta, DashboardSessionSummary } from "../dashboard-types.js";
+
+// Validates the dashboard REST surface: GET serves purely from the stored
+// nightly data (never live sessions), joins companion-managed sessions via
+// cliSessionId, and the manual run trigger requires the Claude Code CLI
+// (the summarizer authenticates via the CLI login, not an API key).
+
+const CLI_SESSION_ID = "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee";
+
+function makeSummary(overrides: Partial<DashboardSessionSummary> = {}): DashboardSessionSummary {
+  return {
+    sessionId: CLI_SESSION_ID,
+    cwd: "/root/projects/demo",
+    gitBranch: "main",
+    slug: "demo-task",
+    summary: "Work is underway.",
+    status: "in_progress",
+    openItems: ["finish tests"],
+    archivable: false,
+    transcriptMtimeMs: 1000,
+    lastActivityAt: 1000,
+    summarizedAt: 2000,
+    model: "claude-haiku-4-5",
+    ...overrides,
+  };
+}
+
+function buildApp(store: DashboardStore, cliAvailable: boolean): Hono {
+  const app = new Hono();
+  registerDashboardRoutes(app, {
+    store,
+    isCliAvailable: () => cliAvailable,
+    listCompanionSessions: () => [
+      {
+        sessionId: "companion-1",
+        cliSessionId: CLI_SESSION_ID,
+        name: "Fix login",
+        userName: "Moritz",
+        archived: false,
+      },
+    ],
+  });
+  return app;
+}
+
+describe("dashboard routes", () => {
+  let storeDir: string;
+  let store: DashboardStore;
+  let app: Hono;
+
+  beforeEach(() => {
+    storeDir = mkdtempSync(join(tmpdir(), "dashboard-routes-test-"));
+    store = new DashboardStore(storeDir);
+    _resetForTest(join(storeDir, "settings.json"));
+    _resetDashboardRunStateForTest();
+    app = buildApp(store, true);
+  });
+
+  afterEach(() => {
+    _resetForTest();
+    rmSync(storeDir, { recursive: true, force: true });
+  });
+
+  it("GET /dashboard returns stored summaries joined with companion sessions", async () => {
+    store.saveSummary(makeSummary());
+    const meta: DashboardRunMeta = {
+      lastRunAt: 1,
+      lastRunCompletedAt: 2,
+      lastRunStatus: "success",
+      trigger: "scheduled",
+      model: "claude-haiku-4-5",
+      sessionsProcessed: 1,
+      sessionsSkipped: 0,
+      sessionsFailed: 0,
+    };
+    store.saveRunMeta(meta);
+
+    const res = await app.request("/dashboard");
+    expect(res.status).toBe(200);
+    const data = await res.json();
+
+    expect(data.enabled).toBe(false); // opt-in defaults to off
+    expect(data.claudeCliAvailable).toBe(true);
+    expect(data.runMeta).toEqual(meta);
+    expect(data.progress.state).toBe("idle");
+    expect(data.sessions).toHaveLength(1);
+    expect(data.sessions[0].companionSessionId).toBe("companion-1");
+    expect(data.sessions[0].displayName).toBe("Fix login");
+    expect(data.sessions[0].userName).toBe("Moritz");
+  });
+
+  it("GET /dashboard leaves external (non-companion) sessions unlinked", async () => {
+    store.saveSummary(makeSummary({ sessionId: "11111111-2222-3333-4444-555555555555" }));
+    const res = await app.request("/dashboard");
+    const data = await res.json();
+    expect(data.sessions[0].companionSessionId).toBeUndefined();
+  });
+
+  it("POST /dashboard/run returns 400 when the Claude CLI is unavailable", async () => {
+    const noCliApp = buildApp(store, false);
+    const res = await noCliApp.request("/dashboard/run", { method: "POST" });
+    expect(res.status).toBe(400);
+    const data = await res.json();
+    expect(data.error).toContain("Claude Code CLI");
+  });
+
+  it("POST /dashboard/run starts a background run when the CLI is available", async () => {
+    // Point discovery at an empty dir so the background run finds no sessions
+    // (and therefore never actually invokes the CLI).
+    const emptyProjects = mkdtempSync(join(tmpdir(), "dashboard-empty-projects-"));
+    const prevProjectsDir = process.env.CLAUDE_PROJECTS_DIR;
+    process.env.CLAUDE_PROJECTS_DIR = emptyProjects;
+    try {
+      const res = await app.request("/dashboard/run", { method: "POST" });
+      expect(res.status).toBe(200);
+      expect((await res.json()).started).toBe(true);
+
+      // Wait for the fire-and-forget run to finish and write run meta.
+      await new Promise((resolve) => setTimeout(resolve, 50));
+      const status = await app.request("/dashboard/run/status");
+      const statusData = await status.json();
+      expect(statusData.progress.state).toBe("idle");
+      expect(statusData.runMeta?.trigger).toBe("manual");
+    } finally {
+      if (prevProjectsDir === undefined) delete process.env.CLAUDE_PROJECTS_DIR;
+      else process.env.CLAUDE_PROJECTS_DIR = prevProjectsDir;
+      rmSync(emptyProjects, { recursive: true, force: true });
+    }
+  });
+});

package/server/routes/dashboard-routes.ts

@@ -0,0 +1,101 @@
+import type { Hono } from "hono";
+import { getSettings } from "../settings-manager.js";
+import { isClaudeCliAvailable } from "../claude-cli-runner.js";
+import { getDashboardStore, type DashboardStore } from "../dashboard-store.js";
+import {
+  getDashboardRunProgress,
+  isDashboardRunActive,
+  runDashboardUpdate,
+} from "../dashboard-summarizer.js";
+import type { DashboardSessionSummary } from "../dashboard-types.js";
+
+/**
+ * Minimal slice of SdkSessionInfo needed to join companion-managed sessions
+ * onto discovered Claude transcripts (matched via cliSessionId).
+ */
+export interface CompanionSessionLink {
+  sessionId: string;
+  cliSessionId?: string;
+  name?: string;
+  userName?: string;
+  archived?: boolean;
+}
+
+export interface DashboardRouteDeps {
+  listCompanionSessions?: () => CompanionSessionLink[];
+  store?: DashboardStore;
+  /** Override the Claude CLI availability check (tests). */
+  isCliAvailable?: () => boolean;
+}
+
+export interface DashboardSessionEntry extends DashboardSessionSummary {
+  /** Companion session id when this transcript belongs to a companion-managed session. */
+  companionSessionId?: string;
+  companionArchived?: boolean;
+  displayName?: string;
+  userName?: string;
+}
+
+export function registerDashboardRoutes(api: Hono, deps: DashboardRouteDeps = {}): void {
+  const store = () => deps.store || getDashboardStore();
+  const cliAvailable = () => (deps.isCliAvailable ? deps.isCliAvailable() : isClaudeCliAvailable());
+
+  // Dashboard data — served purely from the nightly store, never from live sessions.
+  api.get("/dashboard", (c) => {
+    const settings = getSettings();
+    const summaries = store().loadAllSummaries();
+
+    const links = new Map<string, CompanionSessionLink>();
+    try {
+      for (const session of deps.listCompanionSessions?.() ?? []) {
+        if (session.cliSessionId) links.set(session.cliSessionId, session);
+      }
+    } catch (err) {
+      console.warn("[dashboard] Failed to enumerate companion sessions:", err);
+    }
+
+    const sessions: DashboardSessionEntry[] = summaries.map((summary) => {
+      const link = links.get(summary.sessionId);
+      return {
+        ...summary,
+        companionSessionId: link?.sessionId,
+        companionArchived: link?.archived === true ? true : undefined,
+        displayName: link?.name,
+        userName: link?.userName,
+      };
+    });
+
+    return c.json({
+      enabled: settings.dashboardEnabled,
+      model: settings.dashboardModel,
+      runHour: settings.dashboardRunHour,
+      claudeCliAvailable: cliAvailable(),
+      runMeta: store().loadRunMeta(),
+      progress: getDashboardRunProgress(),
+      sessions,
+    });
+  });
+
+  // Manual "Update now" trigger. Runs in the background; poll run/status for progress.
+  api.post("/dashboard/run", (c) => {
+    if (isDashboardRunActive()) {
+      return c.json({ error: "A dashboard update is already running", progress: getDashboardRunProgress() }, 409);
+    }
+    if (!cliAvailable()) {
+      return c.json({ error: "Claude Code CLI not found — the summarizer uses your Claude Code login" }, 400);
+    }
+
+    runDashboardUpdate({ trigger: "manual", store: deps.store }).catch((err) => {
+      console.warn("[dashboard] Manual update failed:", err);
+    });
+
+    return c.json({ started: true });
+  });
+
+  api.get("/dashboard/run/status", (c) => {
+    return c.json({
+      progress: getDashboardRunProgress(),
+      runMeta: store().loadRunMeta(),
+    });
+  });
+}

package/server/routes/settings-routes.ts

@@ -1,5 +1,5 @@
 import type { Hono } from "hono";
-import { DEFAULT_ANTHROPIC_MODEL, getSettings, updateSettings, type UpdateChannel, type CliBridgeMode } from "../settings-manager.js";
+import { DASHBOARD_MODEL_OPTIONS, DEFAULT_ANTHROPIC_MODEL, getSettings, updateSettings, type UpdateChannel, type CliBridgeMode } from "../settings-manager.js";
 import { linearCache } from "../linear-cache.js";
 import { listConnections } from "../linear-connections.js";
 import { hasContainerCodexAuth } from "../codex-container-auth.js";
@@ -26,6 +26,10 @@ export function registerSettingsRoutes(api: Hono): void {
       aiValidationEnabled: settings.aiValidationEnabled,
       aiValidationAutoApprove: settings.aiValidationAutoApprove,
       aiValidationAutoDeny: settings.aiValidationAutoDeny,
+      dashboardEnabled: settings.dashboardEnabled,
+      dashboardModel: settings.dashboardModel,
+      dashboardRunHour: settings.dashboardRunHour,
+      dashboardMaxSessionsPerRun: settings.dashboardMaxSessionsPerRun,
       publicUrl: settings.publicUrl,
       updateChannel: settings.updateChannel,
       dockerAutoUpdate: settings.dockerAutoUpdate,
@@ -72,6 +76,26 @@ export function registerSettingsRoutes(api: Hono): void {
     if (body.aiValidationAutoDeny !== undefined && typeof body.aiValidationAutoDeny !== "boolean") {
       return c.json({ error: "aiValidationAutoDeny must be a boolean" }, 400);
     }
+    if (body.dashboardEnabled !== undefined && typeof body.dashboardEnabled !== "boolean") {
+      return c.json({ error: "dashboardEnabled must be a boolean" }, 400);
+    }
+    if (body.dashboardModel !== undefined && !DASHBOARD_MODEL_OPTIONS.includes(body.dashboardModel)) {
+      return c.json({ error: `dashboardModel must be one of: ${DASHBOARD_MODEL_OPTIONS.join(", ")}` }, 400);
+    }
+    if (
+      body.dashboardRunHour !== undefined
+      && (typeof body.dashboardRunHour !== "number" || !Number.isInteger(body.dashboardRunHour)
+        || body.dashboardRunHour < 0 || body.dashboardRunHour > 23)
+    ) {
+      return c.json({ error: "dashboardRunHour must be an integer between 0 and 23" }, 400);
+    }
+    if (
+      body.dashboardMaxSessionsPerRun !== undefined
+      && (typeof body.dashboardMaxSessionsPerRun !== "number" || !Number.isInteger(body.dashboardMaxSessionsPerRun)
+        || body.dashboardMaxSessionsPerRun < 1 || body.dashboardMaxSessionsPerRun > 200)
+    ) {
+      return c.json({ error: "dashboardMaxSessionsPerRun must be an integer between 1 and 200" }, 400);
+    }
     if (body.publicUrl !== undefined) {
       if (typeof body.publicUrl !== "string") {
         return c.json({ error: "publicUrl must be a string" }, 400);
@@ -122,6 +146,8 @@ export function registerSettingsRoutes(api: Hono): void {
       || body.linearOAuthWebhookSecret !== undefined
       || body.aiValidationEnabled !== undefined || body.aiValidationAutoApprove !== undefined
       || body.aiValidationAutoDeny !== undefined
+      || body.dashboardEnabled !== undefined || body.dashboardModel !== undefined
+      || body.dashboardRunHour !== undefined || body.dashboardMaxSessionsPerRun !== undefined
       || body.publicUrl !== undefined
       || body.updateChannel !== undefined
       || body.dockerAutoUpdate !== undefined
@@ -208,6 +234,22 @@ export function registerSettingsRoutes(api: Hono): void {
         typeof body.aiValidationAutoDeny === "boolean"
           ? body.aiValidationAutoDeny
           : undefined,
+      dashboardEnabled:
+        typeof body.dashboardEnabled === "boolean"
+          ? body.dashboardEnabled
+          : undefined,
+      dashboardModel:
+        typeof body.dashboardModel === "string"
+          ? body.dashboardModel
+          : undefined,
+      dashboardRunHour:
+        typeof body.dashboardRunHour === "number"
+          ? body.dashboardRunHour
+          : undefined,
+      dashboardMaxSessionsPerRun:
+        typeof body.dashboardMaxSessionsPerRun === "number"
+          ? body.dashboardMaxSessionsPerRun
+          : undefined,
       publicUrl:
         typeof body.publicUrl === "string"
           ? body.publicUrl.trim().replace(/\/+$/, "")
@@ -249,6 +291,10 @@ export function registerSettingsRoutes(api: Hono): void {
       aiValidationEnabled: settings.aiValidationEnabled,
       aiValidationAutoApprove: settings.aiValidationAutoApprove,
       aiValidationAutoDeny: settings.aiValidationAutoDeny,
+      dashboardEnabled: settings.dashboardEnabled,
+      dashboardModel: settings.dashboardModel,
+      dashboardRunHour: settings.dashboardRunHour,
+      dashboardMaxSessionsPerRun: settings.dashboardMaxSessionsPerRun,
       publicUrl: settings.publicUrl,
       updateChannel: settings.updateChannel,
       dockerAutoUpdate: settings.dockerAutoUpdate,

package/server/routes.test.ts

@@ -102,6 +102,10 @@ vi.mock("./settings-manager.js", () => ({
     aiValidationEnabled: false,
     aiValidationAutoApprove: true,
     aiValidationAutoDeny: false,
+    dashboardEnabled: false,
+    dashboardModel: "claude-haiku-4-5",
+    dashboardRunHour: 3,
+    dashboardMaxSessionsPerRun: 30,
     publicUrl: "",
     updateChannel: "stable",
     dockerAutoUpdate: false,
@@ -1146,6 +1150,10 @@ describe("GET /api/sessions/:id/archive-info", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1517,6 +1525,10 @@ describe("GET /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1546,6 +1558,10 @@ describe("GET /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1575,6 +1591,10 @@ describe("GET /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1604,6 +1624,10 @@ describe("GET /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1634,6 +1658,10 @@ describe("GET /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "https://example.com",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1672,6 +1700,10 @@ describe("PUT /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1723,6 +1755,10 @@ describe("PUT /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1752,6 +1788,10 @@ describe("PUT /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1798,6 +1838,10 @@ describe("PUT /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -1895,6 +1939,10 @@ describe("PUT /api/settings", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "https://my-server.com",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2147,6 +2195,10 @@ describe("GET /api/linear/issues", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2183,6 +2235,10 @@ describe("GET /api/linear/issues", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2272,6 +2328,10 @@ describe("GET /api/linear/issues", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2368,6 +2428,10 @@ describe("GET /api/linear/issues", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2429,6 +2493,10 @@ describe("GET /api/linear/connection", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2465,6 +2533,10 @@ describe("GET /api/linear/connection", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2523,6 +2595,10 @@ describe("POST /api/linear/issues/:id/transition", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2563,6 +2639,10 @@ describe("POST /api/linear/issues/:id/transition", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2602,6 +2682,10 @@ describe("POST /api/linear/issues/:id/transition", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2643,6 +2727,10 @@ describe("POST /api/linear/issues/:id/transition", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2718,6 +2806,10 @@ describe("POST /api/linear/issues/:id/transition", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2772,6 +2864,10 @@ describe("GET /api/linear/projects", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2808,6 +2904,10 @@ describe("GET /api/linear/projects", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2874,6 +2974,10 @@ describe("GET /api/linear/project-issues", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2910,6 +3014,10 @@ describe("GET /api/linear/project-issues", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -2991,6 +3099,10 @@ describe("GET /api/linear/project-issues", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,

package/server/routes.ts

@@ -26,6 +26,7 @@ import { registerMetricsRoutes } from "./routes/metrics-routes.js";
 import { registerLinearAgentWebhookRoute, registerLinearAgentProtectedRoutes } from "./routes/linear-agent-routes.js";
 import { registerPromptRoutes } from "./routes/prompt-routes.js";
 import { registerSettingsRoutes } from "./routes/settings-routes.js";
+import { registerDashboardRoutes } from "./routes/dashboard-routes.js";
 import { registerTailscaleRoutes } from "./routes/tailscale-routes.js";
 import { registerGitRoutes } from "./routes/git-routes.js";
 import { registerSystemRoutes } from "./routes/system-routes.js";
@@ -1275,6 +1276,9 @@ export function createRoutes(
 
   registerPromptRoutes(api);
   registerSettingsRoutes(api);
+  registerDashboardRoutes(api, {
+    listCompanionSessions: () => launcher.listSessions(),
+  });
 
   // ─── Tailscale ──────────────────────────────────────────────────────
 

package/server/settings-manager.test.ts

@@ -45,6 +45,10 @@ describe("settings-manager", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -105,6 +109,10 @@ describe("settings-manager", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,
@@ -189,6 +197,10 @@ describe("settings-manager", () => {
       aiValidationEnabled: false,
       aiValidationAutoApprove: true,
       aiValidationAutoDeny: false,
+      dashboardEnabled: false,
+      dashboardModel: "claude-haiku-4-5",
+      dashboardRunHour: 3,
+      dashboardMaxSessionsPerRun: 30,
       publicUrl: "",
       updateChannel: "stable",
       dockerAutoUpdate: false,