@atercates/claude-deck 0.2.1

package/lib/db/migrations.ts

@@ -0,0 +1,45 @@
+import type Database from "better-sqlite3";
+
+interface Migration {
+  id: number;
+  name: string;
+  up: (db: Database.Database) => void;
+}
+
+const migrations: Migration[] = [];
+
+export function runMigrations(db: Database.Database): void {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS _migrations (
+      id INTEGER PRIMARY KEY,
+      name TEXT NOT NULL,
+      applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+
+  const applied = new Set(
+    db
+      .prepare("SELECT id FROM _migrations")
+      .all()
+      .map((r) => (r as { id: number }).id)
+  );
+
+  for (const migration of migrations) {
+    if (applied.has(migration.id)) continue;
+
+    try {
+      migration.up(db);
+      db.prepare("INSERT INTO _migrations (id, name) VALUES (?, ?)").run(
+        migration.id,
+        migration.name
+      );
+      console.log(`Migration ${migration.id}: ${migration.name} applied`);
+    } catch (error) {
+      console.error(
+        `Migration ${migration.id}: ${migration.name} failed:`,
+        error
+      );
+      throw error;
+    }
+  }
+}

package/lib/db/queries.ts

@@ -0,0 +1,460 @@
+import { getDb } from "./index";
+import type {
+  Session,
+  Group,
+  Project,
+  ProjectDevServer,
+  ProjectRepository,
+  DevServer,
+} from "./types";
+
+function query<T>(sql: string, params: unknown[] = []): T[] {
+  return getDb()
+    .prepare(sql)
+    .all(...params) as T[];
+}
+
+function queryOne<T>(sql: string, params: unknown[] = []): T | null {
+  return (
+    (getDb()
+      .prepare(sql)
+      .get(...params) as T) ?? null
+  );
+}
+
+function execute(sql: string, params: unknown[] = []): void {
+  getDb()
+    .prepare(sql)
+    .run(...params);
+}
+
+export const queries = {
+  createSession: (
+    id: string,
+    name: string,
+    tmuxName: string | null,
+    workingDirectory: string,
+    parentSessionId: string | null,
+    model: string | null,
+    systemPrompt: string | null,
+    groupPath: string,
+    agentType: string,
+    autoApprove: boolean,
+    projectId: string | null
+  ) =>
+    execute(
+      `INSERT INTO sessions (id, name, tmux_name, working_directory, parent_session_id, model, system_prompt, group_path, agent_type, auto_approve, project_id)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        name,
+        tmuxName,
+        workingDirectory,
+        parentSessionId,
+        model,
+        systemPrompt,
+        groupPath,
+        agentType,
+        autoApprove ? 1 : 0,
+        projectId,
+      ]
+    ),
+
+  getSession: (id: string) =>
+    queryOne<Session>("SELECT * FROM sessions WHERE id = ?", [id]),
+
+  getAllSessions: () =>
+    query<Session>("SELECT * FROM sessions ORDER BY updated_at DESC"),
+
+  updateSessionStatus: (status: string, id: string) =>
+    execute(
+      "UPDATE sessions SET status = ?, updated_at = datetime('now') WHERE id = ?",
+      [status, id]
+    ),
+
+  updateSessionClaudeId: (claudeSessionId: string, id: string) =>
+    execute(
+      "UPDATE sessions SET claude_session_id = ?, updated_at = datetime('now') WHERE id = ?",
+      [claudeSessionId, id]
+    ),
+
+  updateSessionName: (name: string, tmuxName: string, id: string) =>
+    execute(
+      "UPDATE sessions SET name = ?, tmux_name = ?, updated_at = datetime('now') WHERE id = ?",
+      [name, tmuxName, id]
+    ),
+
+  deleteSession: (id: string) =>
+    execute("DELETE FROM sessions WHERE id = ?", [id]),
+
+  updateSessionWorktree: (
+    worktreePath: string | null,
+    branchName: string | null,
+    baseBranch: string | null,
+    port: number | null,
+    id: string
+  ) =>
+    execute(
+      "UPDATE sessions SET worktree_path = ?, branch_name = ?, base_branch = ?, dev_server_port = ?, updated_at = datetime('now') WHERE id = ?",
+      [worktreePath, branchName, baseBranch, port, id]
+    ),
+
+  updateSessionPR: (
+    prUrl: string | null,
+    prNumber: number | null,
+    prStatus: string | null,
+    id: string
+  ) =>
+    execute(
+      "UPDATE sessions SET pr_url = ?, pr_number = ?, pr_status = ?, updated_at = datetime('now') WHERE id = ?",
+      [prUrl, prNumber, prStatus, id]
+    ),
+
+  updateSessionGroup: (groupPath: string, id: string) =>
+    execute(
+      "UPDATE sessions SET group_path = ?, updated_at = datetime('now') WHERE id = ?",
+      [groupPath, id]
+    ),
+
+  getSessionsByGroup: (groupPath: string) =>
+    query<Session>(
+      "SELECT * FROM sessions WHERE group_path = ? ORDER BY updated_at DESC",
+      [groupPath]
+    ),
+
+  moveSessionsToGroup: (newGroupPath: string, oldGroupPath: string) =>
+    execute(
+      "UPDATE sessions SET group_path = ?, updated_at = datetime('now') WHERE group_path = ?",
+      [newGroupPath, oldGroupPath]
+    ),
+
+  updateSessionProject: (projectId: string, id: string) =>
+    execute(
+      "UPDATE sessions SET project_id = ?, updated_at = datetime('now') WHERE id = ?",
+      [projectId, id]
+    ),
+
+  getSessionsByProject: (projectId: string) =>
+    query<Session>(
+      "SELECT * FROM sessions WHERE project_id = ? ORDER BY updated_at DESC",
+      [projectId]
+    ),
+
+  getWorkersByConductor: (conductorId: string) =>
+    query<Session>(
+      "SELECT * FROM sessions WHERE conductor_session_id = ? ORDER BY created_at ASC",
+      [conductorId]
+    ),
+
+  updateWorkerStatus: (workerStatus: string, id: string) =>
+    execute(
+      "UPDATE sessions SET worker_status = ?, updated_at = datetime('now') WHERE id = ?",
+      [workerStatus, id]
+    ),
+
+  createWorkerSession: (
+    id: string,
+    name: string,
+    tmuxName: string,
+    workingDirectory: string,
+    conductorSessionId: string,
+    workerTask: string,
+    model: string | null,
+    groupPath: string,
+    agentType: string,
+    projectId: string | null
+  ) =>
+    execute(
+      `INSERT INTO sessions (id, name, tmux_name, working_directory, conductor_session_id, worker_task, worker_status, model, group_path, agent_type, project_id)
+       VALUES (?, ?, ?, ?, ?, ?, 'pending', ?, ?, ?, ?)`,
+      [
+        id,
+        name,
+        tmuxName,
+        workingDirectory,
+        conductorSessionId,
+        workerTask,
+        model,
+        groupPath,
+        agentType,
+        projectId,
+      ]
+    ),
+
+  getAllGroups: () =>
+    query<Group>("SELECT * FROM groups ORDER BY sort_order ASC, name ASC"),
+
+  getGroup: (path: string) =>
+    queryOne<Group>("SELECT * FROM groups WHERE path = ?", [path]),
+
+  createGroup: (path: string, name: string, sortOrder: number) =>
+    execute("INSERT INTO groups (path, name, sort_order) VALUES (?, ?, ?)", [
+      path,
+      name,
+      sortOrder,
+    ]),
+
+  updateGroupName: (name: string, path: string) =>
+    execute("UPDATE groups SET name = ? WHERE path = ?", [name, path]),
+
+  updateGroupExpanded: (expanded: boolean, path: string) =>
+    execute("UPDATE groups SET expanded = ? WHERE path = ?", [
+      expanded ? 1 : 0,
+      path,
+    ]),
+
+  updateGroupOrder: (sortOrder: number, path: string) =>
+    execute("UPDATE groups SET sort_order = ? WHERE path = ?", [
+      sortOrder,
+      path,
+    ]),
+
+  deleteGroup: (path: string) =>
+    execute("DELETE FROM groups WHERE path = ?", [path]),
+
+  createProject: (
+    id: string,
+    name: string,
+    workingDirectory: string,
+    agentType: string,
+    defaultModel: string,
+    initialPrompt: string | null,
+    sortOrder: number
+  ) =>
+    execute(
+      `INSERT INTO projects (id, name, working_directory, agent_type, default_model, initial_prompt, sort_order)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        name,
+        workingDirectory,
+        agentType,
+        defaultModel,
+        initialPrompt,
+        sortOrder,
+      ]
+    ),
+
+  getProject: (id: string) =>
+    queryOne<Project>("SELECT * FROM projects WHERE id = ?", [id]),
+
+  getAllProjects: () =>
+    query<Project>(
+      "SELECT * FROM projects ORDER BY is_uncategorized ASC, sort_order ASC, name ASC"
+    ),
+
+  updateProject: (
+    name: string,
+    workingDirectory: string,
+    agentType: string,
+    defaultModel: string,
+    initialPrompt: string | null,
+    id: string
+  ) =>
+    execute(
+      "UPDATE projects SET name = ?, working_directory = ?, agent_type = ?, default_model = ?, initial_prompt = ?, updated_at = datetime('now') WHERE id = ?",
+      [name, workingDirectory, agentType, defaultModel, initialPrompt, id]
+    ),
+
+  updateProjectExpanded: (expanded: boolean, id: string) =>
+    execute("UPDATE projects SET expanded = ? WHERE id = ?", [
+      expanded ? 1 : 0,
+      id,
+    ]),
+
+  updateProjectOrder: (sortOrder: number, id: string) =>
+    execute("UPDATE projects SET sort_order = ? WHERE id = ?", [sortOrder, id]),
+
+  deleteProject: (id: string) =>
+    execute("DELETE FROM projects WHERE id = ? AND is_uncategorized = 0", [id]),
+
+  createProjectDevServer: (
+    id: string,
+    projectId: string,
+    name: string,
+    type: string,
+    command: string,
+    port: number | null,
+    portEnvVar: string | null,
+    sortOrder: number
+  ) =>
+    execute(
+      `INSERT INTO project_dev_servers (id, project_id, name, type, command, port, port_env_var, sort_order)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+      [id, projectId, name, type, command, port, portEnvVar, sortOrder]
+    ),
+
+  getProjectDevServer: (id: string) =>
+    queryOne<ProjectDevServer>(
+      "SELECT * FROM project_dev_servers WHERE id = ?",
+      [id]
+    ),
+
+  getProjectDevServers: (projectId: string) =>
+    query<ProjectDevServer>(
+      "SELECT * FROM project_dev_servers WHERE project_id = ? ORDER BY sort_order ASC",
+      [projectId]
+    ),
+
+  updateProjectDevServer: (
+    name: string,
+    type: string,
+    command: string,
+    port: number | null,
+    portEnvVar: string | null,
+    sortOrder: number,
+    id: string
+  ) =>
+    execute(
+      "UPDATE project_dev_servers SET name = ?, type = ?, command = ?, port = ?, port_env_var = ?, sort_order = ? WHERE id = ?",
+      [name, type, command, port, portEnvVar, sortOrder, id]
+    ),
+
+  deleteProjectDevServer: (id: string) =>
+    execute("DELETE FROM project_dev_servers WHERE id = ?", [id]),
+
+  deleteProjectDevServers: (projectId: string) =>
+    execute("DELETE FROM project_dev_servers WHERE project_id = ?", [
+      projectId,
+    ]),
+
+  createProjectRepository: (
+    id: string,
+    projectId: string,
+    name: string,
+    path: string,
+    isPrimary: boolean,
+    sortOrder: number
+  ) =>
+    execute(
+      `INSERT INTO project_repositories (id, project_id, name, path, is_primary, sort_order)
+       VALUES (?, ?, ?, ?, ?, ?)`,
+      [id, projectId, name, path, isPrimary ? 1 : 0, sortOrder]
+    ),
+
+  getProjectRepository: (id: string) =>
+    queryOne<ProjectRepository>(
+      "SELECT * FROM project_repositories WHERE id = ?",
+      [id]
+    ),
+
+  getProjectRepositories: (projectId: string) =>
+    query<ProjectRepository>(
+      "SELECT * FROM project_repositories WHERE project_id = ? ORDER BY sort_order ASC",
+      [projectId]
+    ),
+
+  updateProjectRepository: (
+    name: string,
+    path: string,
+    isPrimary: boolean,
+    sortOrder: number,
+    id: string
+  ) =>
+    execute(
+      "UPDATE project_repositories SET name = ?, path = ?, is_primary = ?, sort_order = ? WHERE id = ?",
+      [name, path, isPrimary ? 1 : 0, sortOrder, id]
+    ),
+
+  deleteProjectRepository: (id: string) =>
+    execute("DELETE FROM project_repositories WHERE id = ?", [id]),
+
+  deleteProjectRepositories: (projectId: string) =>
+    execute("DELETE FROM project_repositories WHERE project_id = ?", [
+      projectId,
+    ]),
+
+  createDevServer: (
+    id: string,
+    projectId: string,
+    type: string,
+    name: string,
+    command: string,
+    status: string,
+    pid: number | null,
+    containerId: string | null,
+    ports: string,
+    workingDirectory: string
+  ) =>
+    execute(
+      `INSERT INTO dev_servers (id, project_id, type, name, command, status, pid, container_id, ports, working_directory)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      [
+        id,
+        projectId,
+        type,
+        name,
+        command,
+        status,
+        pid,
+        containerId,
+        ports,
+        workingDirectory,
+      ]
+    ),
+
+  getDevServer: (id: string) =>
+    queryOne<DevServer>("SELECT * FROM dev_servers WHERE id = ?", [id]),
+
+  getAllDevServers: () =>
+    query<DevServer>("SELECT * FROM dev_servers ORDER BY created_at DESC"),
+
+  getDevServersByProject: (projectId: string) =>
+    query<DevServer>(
+      "SELECT * FROM dev_servers WHERE project_id = ? ORDER BY created_at DESC",
+      [projectId]
+    ),
+
+  updateDevServerStatus: (status: string, id: string) =>
+    execute(
+      "UPDATE dev_servers SET status = ?, updated_at = datetime('now') WHERE id = ?",
+      [status, id]
+    ),
+
+  updateDevServerPid: (pid: number | null, status: string, id: string) =>
+    execute(
+      "UPDATE dev_servers SET pid = ?, status = ?, updated_at = datetime('now') WHERE id = ?",
+      [pid, status, id]
+    ),
+
+  updateDevServer: (
+    status: string,
+    pid: number | null,
+    containerId: string | null,
+    ports: string,
+    id: string
+  ) =>
+    execute(
+      "UPDATE dev_servers SET status = ?, pid = ?, container_id = ?, ports = ?, updated_at = datetime('now') WHERE id = ?",
+      [status, pid, containerId, ports, id]
+    ),
+
+  deleteDevServer: (id: string) =>
+    execute("DELETE FROM dev_servers WHERE id = ?", [id]),
+
+  deleteDevServersByProject: (projectId: string) =>
+    execute("DELETE FROM dev_servers WHERE project_id = ?", [projectId]),
+
+  getHiddenItems: (itemType: string) =>
+    query<{ item_id: string }>(
+      "SELECT item_id FROM hidden_items WHERE item_type = ?",
+      [itemType]
+    ),
+
+  getAllHiddenItems: () =>
+    query<{ item_type: string; item_id: string }>(
+      "SELECT item_type, item_id FROM hidden_items"
+    ),
+
+  hideItem: (itemType: string, itemId: string) =>
+    execute(
+      "INSERT OR IGNORE INTO hidden_items (item_type, item_id) VALUES (?, ?)",
+      [itemType, itemId]
+    ),
+
+  unhideItem: (itemType: string, itemId: string) =>
+    execute("DELETE FROM hidden_items WHERE item_type = ? AND item_id = ?", [
+      itemType,
+      itemId,
+    ]),
+};

package/lib/db/schema.ts

@@ -0,0 +1,114 @@
+import type Database from "better-sqlite3";
+
+export function createSchema(db: Database.Database): void {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS sessions (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      tmux_name TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+      status TEXT NOT NULL DEFAULT 'idle',
+      working_directory TEXT NOT NULL DEFAULT '~',
+      parent_session_id TEXT REFERENCES sessions(id),
+      claude_session_id TEXT,
+      model TEXT DEFAULT 'sonnet',
+      system_prompt TEXT,
+      group_path TEXT NOT NULL DEFAULT 'sessions',
+      project_id TEXT,
+      agent_type TEXT NOT NULL DEFAULT 'claude',
+      auto_approve INTEGER NOT NULL DEFAULT 0,
+      worktree_path TEXT,
+      branch_name TEXT,
+      base_branch TEXT,
+      dev_server_port INTEGER,
+      pr_url TEXT,
+      pr_number INTEGER,
+      pr_status TEXT,
+      conductor_session_id TEXT REFERENCES sessions(id),
+      worker_task TEXT,
+      worker_status TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS groups (
+      path TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      expanded INTEGER NOT NULL DEFAULT 1,
+      sort_order INTEGER NOT NULL DEFAULT 0,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    INSERT OR IGNORE INTO groups (path, name, sort_order)
+    VALUES ('sessions', 'Sessions', 0);
+
+    CREATE TABLE IF NOT EXISTS dev_servers (
+      id TEXT PRIMARY KEY,
+      project_id TEXT,
+      type TEXT NOT NULL DEFAULT 'node',
+      name TEXT NOT NULL DEFAULT '',
+      command TEXT NOT NULL DEFAULT '',
+      status TEXT NOT NULL DEFAULT 'stopped',
+      pid INTEGER,
+      container_id TEXT,
+      ports TEXT NOT NULL DEFAULT '[]',
+      working_directory TEXT NOT NULL DEFAULT '',
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS projects (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      working_directory TEXT NOT NULL,
+      agent_type TEXT NOT NULL DEFAULT 'claude',
+      default_model TEXT NOT NULL DEFAULT 'sonnet',
+      initial_prompt TEXT,
+      expanded INTEGER NOT NULL DEFAULT 1,
+      sort_order INTEGER NOT NULL DEFAULT 0,
+      is_uncategorized INTEGER NOT NULL DEFAULT 0,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS project_dev_servers (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      name TEXT NOT NULL,
+      type TEXT NOT NULL DEFAULT 'node',
+      command TEXT NOT NULL,
+      port INTEGER,
+      port_env_var TEXT,
+      sort_order INTEGER NOT NULL DEFAULT 0
+    );
+
+    CREATE TABLE IF NOT EXISTS project_repositories (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      name TEXT NOT NULL,
+      path TEXT NOT NULL,
+      is_primary INTEGER NOT NULL DEFAULT 0,
+      sort_order INTEGER NOT NULL DEFAULT 0
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_sessions_parent ON sessions(parent_session_id);
+    CREATE INDEX IF NOT EXISTS idx_sessions_group ON sessions(group_path);
+    CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_id);
+    CREATE INDEX IF NOT EXISTS idx_sessions_conductor ON sessions(conductor_session_id);
+    CREATE INDEX IF NOT EXISTS idx_project_dev_servers_project ON project_dev_servers(project_id);
+    CREATE INDEX IF NOT EXISTS idx_project_repositories_project ON project_repositories(project_id);
+    CREATE INDEX IF NOT EXISTS idx_dev_servers_project ON dev_servers(project_id);
+
+    CREATE TABLE IF NOT EXISTS hidden_items (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      item_type TEXT NOT NULL,
+      item_id TEXT NOT NULL,
+      hidden_at TEXT NOT NULL DEFAULT (datetime('now')),
+      UNIQUE(item_type, item_id)
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_hidden_items_type ON hidden_items(item_type);
+
+    INSERT OR IGNORE INTO projects (id, name, working_directory, is_uncategorized, sort_order)
+    VALUES ('uncategorized', 'Uncategorized', '~', 1, 999999);
+  `);
+}

package/lib/db/types.ts

@@ -0,0 +1,92 @@
+import type { AgentType } from "../providers";
+
+export interface Session {
+  id: string;
+  name: string;
+  tmux_name: string;
+  created_at: string;
+  updated_at: string;
+  status: "idle" | "running" | "waiting" | "error";
+  working_directory: string;
+  parent_session_id: string | null;
+  claude_session_id: string | null;
+  model: string;
+  system_prompt: string | null;
+  group_path: string; // Deprecated - use project_id
+  project_id: string | null;
+  agent_type: AgentType;
+  auto_approve: boolean;
+  // Worktree fields (optional)
+  worktree_path: string | null;
+  branch_name: string | null;
+  base_branch: string | null;
+  dev_server_port: number | null;
+  // PR tracking
+  pr_url: string | null;
+  pr_number: number | null;
+  pr_status: "open" | "merged" | "closed" | null;
+  // Orchestration fields
+  conductor_session_id: string | null;
+  worker_task: string | null;
+  worker_status: "pending" | "running" | "completed" | "failed" | null;
+}
+
+export interface Group {
+  path: string;
+  name: string;
+  expanded: boolean;
+  sort_order: number;
+  created_at: string;
+}
+
+export interface Project {
+  id: string;
+  name: string;
+  working_directory: string;
+  agent_type: AgentType;
+  default_model: string;
+  initial_prompt: string | null;
+  expanded: boolean;
+  sort_order: number;
+  is_uncategorized: boolean;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface ProjectDevServer {
+  id: string;
+  project_id: string;
+  name: string;
+  type: DevServerType;
+  command: string;
+  port: number | null;
+  port_env_var: string | null;
+  sort_order: number;
+}
+
+export interface ProjectRepository {
+  id: string;
+  project_id: string;
+  name: string;
+  path: string;
+  is_primary: boolean;
+  sort_order: number;
+}
+
+export type DevServerType = "node" | "docker";
+export type DevServerStatus = "stopped" | "starting" | "running" | "failed";
+
+export interface DevServer {
+  id: string;
+  project_id: string;
+  type: DevServerType;
+  name: string;
+  command: string;
+  status: DevServerStatus;
+  pid: number | null;
+  container_id: string | null;
+  ports: string; // JSON array of port numbers
+  working_directory: string;
+  created_at: string;
+  updated_at: string;
+}

package/lib/db.ts

@@ -0,0 +1,2 @@
+// Re-export everything from the new modular structure
+export * from "./db/index";