circuschief 0.7.0 → 1.0.0

package/packages/server/src/schema.sql

@@ -1,4 +1,3 @@
--- Projects table
 CREATE TABLE IF NOT EXISTS projects (
   id TEXT PRIMARY KEY,
   name TEXT NOT NULL,
@@ -6,14 +5,14 @@ CREATE TABLE IF NOT EXISTS projects (
   system_prompt TEXT,
   on_session_created TEXT,
   on_session_deleted TEXT,
-  pr_poll_interval INTEGER NOT NULL DEFAULT 60000,  -- PR status poll interval in ms (default 1 minute)
-  repo_url TEXT,  -- GitHub repository URL for PR validation
+  pr_poll_interval INTEGER NOT NULL DEFAULT 60000,
+  repo_url TEXT,
+  worktree_path TEXT,
+  kanban_enabled INTEGER NOT NULL DEFAULT 1,
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Session templates (reusable prompts that can chain sessions)
--- Must be created before sessions due to foreign key reference
 CREATE TABLE IF NOT EXISTS session_templates (
   id TEXT PRIMARY KEY,
   project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
@@ -26,26 +25,57 @@ CREATE TABLE IF NOT EXISTS session_templates (
   model TEXT,
   mode TEXT DEFAULT 'yolo' CHECK(mode IN ('plan', 'standard', 'yolo')),
   effort_level TEXT CHECK(effort_level IN ('low', 'medium', 'high', 'max', 'auto')),
+  target_lane_id TEXT REFERENCES kanban_lanes(id) ON DELETE SET NULL,
+  show_in_quick_responses INTEGER NOT NULL DEFAULT 0,
+  quick_response_auto_submit INTEGER NOT NULL DEFAULT 0,
+  quick_response_sort_order INTEGER NOT NULL DEFAULT 0,
+  legacy_quick_response_id TEXT UNIQUE,
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Sessions table
+CREATE TABLE IF NOT EXISTS providers (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  base_url TEXT,
+  auth_token TEXT,
+  api_timeout_ms INTEGER,
+  additional_env_vars TEXT,
+  commit_attribution_override TEXT,
+  is_built_in INTEGER NOT NULL DEFAULT 0,
+  kind TEXT NOT NULL DEFAULT 'anthropic' CHECK(kind IN ('anthropic','openai')),
+  created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+  updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+);
+
+CREATE TABLE IF NOT EXISTS provider_models (
+  id TEXT PRIMARY KEY,
+  provider_id TEXT NOT NULL REFERENCES providers(id) ON DELETE CASCADE,
+  model_id TEXT NOT NULL,
+  display_name TEXT NOT NULL,
+  description TEXT,
+  tier TEXT CHECK(tier IN ('opus', 'sonnet', 'haiku', 'custom')),
+  created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+);
+
 CREATE TABLE IF NOT EXISTS sessions (
   id TEXT PRIMARY KEY,
   project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
   name TEXT NOT NULL,
   status TEXT NOT NULL DEFAULT 'starting' CHECK (status IN ('starting', 'running', 'waiting', 'stopped', 'completed', 'error', 'scheduled')),
-  mode TEXT NOT NULL DEFAULT 'standard' CHECK (mode IN ('plan', 'standard', 'yolo')),
-  thinking_enabled INTEGER NOT NULL DEFAULT 0,
+  mode TEXT NOT NULL DEFAULT 'yolo' CHECK (mode IN ('plan', 'standard', 'yolo')),
+  thinking_enabled INTEGER NOT NULL DEFAULT 1,
   archived INTEGER NOT NULL DEFAULT 0,
   git_branch TEXT,
   git_worktree TEXT,
   pr_url TEXT,
+  pr_url_auto_link_disabled INTEGER NOT NULL DEFAULT 0,
   error TEXT,
   effort_level TEXT CHECK(effort_level IN ('low', 'medium', 'high', 'max', 'auto')),
   cost_usd REAL DEFAULT 0,
   claude_session_id TEXT,
+  model TEXT,
+  provider_id TEXT REFERENCES providers(id),
   next_template_id TEXT REFERENCES session_templates(id) ON DELETE SET NULL,
   parent_session_id TEXT REFERENCES sessions(id) ON DELETE SET NULL,
   input_tokens INTEGER DEFAULT 0,
@@ -55,20 +85,36 @@ CREATE TABLE IF NOT EXISTS sessions (
   cache_creation_input_tokens INTEGER DEFAULT 0,
   web_search_requests INTEGER DEFAULT 0,
   context_window INTEGER DEFAULT 200000,
+  starred INTEGER NOT NULL DEFAULT 0,
+  manually_named INTEGER NOT NULL DEFAULT 0,
+  scheduled_at INTEGER DEFAULT NULL,
+  reschedule_delay_minutes INTEGER DEFAULT 60,
+  auto_reschedule_enabled INTEGER DEFAULT 0,
+  reschedule_on_token_limit INTEGER DEFAULT 1,
+  reschedule_on_service_error INTEGER DEFAULT 1,
+  max_reschedule_count INTEGER DEFAULT NULL,
+  max_total_tokens INTEGER DEFAULT NULL,
+  reschedule_count INTEGER DEFAULT 0,
+  reschedule_at_token_count INTEGER DEFAULT NULL,
+  pending_prompt TEXT,
+  slash_commands TEXT,
+  pending_model TEXT,
+  auto_send_pending_prompt INTEGER DEFAULT 0,
+  agent_type TEXT DEFAULT 'claude-code',
+  target_lane_id TEXT REFERENCES kanban_lanes(id) ON DELETE SET NULL,
+  lane_trigger_depth INTEGER NOT NULL DEFAULT 0,
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Conversations (multiple conversation threads per session)
 CREATE TABLE IF NOT EXISTS conversations (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-  name TEXT,                           -- Auto from first message or user-defined
-  summary TEXT,                        -- Per-conversation summary
-  summary_generated_at INTEGER,        -- When summary was last generated
-  is_active INTEGER NOT NULL DEFAULT 0, -- Currently selected conversation (1 = active)
-  claude_session_id TEXT,              -- Claude SDK session ID for this conversation's context
-  -- Token usage fields (per-conversation tracking)
+  name TEXT,
+  summary TEXT,
+  summary_generated_at INTEGER,
+  is_active INTEGER NOT NULL DEFAULT 0,
+  claude_session_id TEXT,
   input_tokens INTEGER DEFAULT 0,
   output_tokens INTEGER DEFAULT 0,
   thinking_tokens INTEGER DEFAULT 0,
@@ -76,48 +122,39 @@ CREATE TABLE IF NOT EXISTS conversations (
   cache_creation_input_tokens INTEGER DEFAULT 0,
   web_search_requests INTEGER DEFAULT 0,
   context_window INTEGER DEFAULT 200000,
+  model TEXT,
+  parent_conversation_id TEXT REFERENCES conversations(id) ON DELETE SET NULL,
+  branch_from_message_id TEXT REFERENCES conversation_messages(id) ON DELETE SET NULL,
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Conversation messages
 CREATE TABLE IF NOT EXISTS conversation_messages (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
   conversation_id TEXT REFERENCES conversations(id) ON DELETE CASCADE,
   role TEXT NOT NULL CHECK (role IN ('user', 'assistant', 'system')),
   content TEXT NOT NULL,
-  tool_use TEXT, -- JSON array of tool uses
-  model TEXT, -- Model that generated this message (for assistant messages)
+  tool_use TEXT,
+  model TEXT,
   timestamp INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Canvas items
 CREATE TABLE IF NOT EXISTS canvas_items (
   id TEXT PRIMARY KEY,
   session_id TEXT REFERENCES sessions(id) ON DELETE CASCADE,
   type TEXT NOT NULL CHECK (type IN ('image', 'markdown', 'text', 'json', 'pdf', 'code')),
-  content TEXT,           -- For markdown/text
-  data TEXT,              -- For json (stored as JSON string) or image (base64)
-  mime_type TEXT,         -- For images
+  content TEXT,
+  data TEXT,
+  mime_type TEXT,
   filename TEXT,
   width INTEGER,
   height INTEGER,
-  deleted_at INTEGER,     -- null = active, timestamp = soft deleted
-  created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
-  updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
-);
-
--- Session notes
-CREATE TABLE IF NOT EXISTS session_notes (
-  id TEXT PRIMARY KEY,
-  session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
-  content TEXT NOT NULL,
+  deleted_at INTEGER,
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
-  updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+  updated_at INTEGER
 );
 
--- Global tool templates
 CREATE TABLE IF NOT EXISTS global_tool_templates (
   id TEXT PRIMARY KEY,
   name TEXT NOT NULL,
@@ -127,7 +164,6 @@ CREATE TABLE IF NOT EXISTS global_tool_templates (
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Project tool templates
 CREATE TABLE IF NOT EXISTS project_tool_templates (
   id TEXT PRIMARY KEY,
   project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
@@ -138,50 +174,46 @@ CREATE TABLE IF NOT EXISTS project_tool_templates (
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Session todos (Claude's task list, scoped to conversations)
 CREATE TABLE IF NOT EXISTS session_todos (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
   conversation_id TEXT REFERENCES conversations(id) ON DELETE CASCADE,
   content TEXT NOT NULL,
-  status TEXT NOT NULL DEFAULT 'pending'
-    CHECK (status IN ('pending', 'in_progress', 'completed')),
+  status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'in_progress', 'completed')),
   position INTEGER NOT NULL,
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Work logs (thinking, command outputs, tool executions)
 CREATE TABLE IF NOT EXISTS work_logs (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
   message_id TEXT REFERENCES conversation_messages(id) ON DELETE CASCADE,
   type TEXT NOT NULL CHECK (type IN ('thinking', 'tool_input', 'tool_output')),
-  tool_name TEXT,                -- Tool name for tool_input/tool_output types
-  content TEXT NOT NULL,         -- The actual log content
+  tool_name TEXT,
+  content TEXT NOT NULL,
   timestamp INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Session summaries (AI-generated)
 CREATE TABLE IF NOT EXISTS session_summaries (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL UNIQUE REFERENCES sessions(id) ON DELETE CASCADE,
-  short_summary TEXT NOT NULL,      -- 1-2 sentence preview for list view (~100 chars)
-  full_summary TEXT NOT NULL,       -- Detailed summary with key points (~500 chars)
-  key_actions TEXT,                 -- JSON array of main actions taken
-  files_modified TEXT,              -- JSON array of files touched
-  outcome TEXT,                     -- 'completed' | 'partial' | 'failed' | 'ongoing'
-  message_count INTEGER,            -- Track what was summarized (staleness detection)
-  pr_merged INTEGER,                -- 0/1 boolean - whether PR is merged
-  pr_state TEXT,                    -- 'open' | 'closed' | 'merged' | 'draft'
-  has_merge_conflicts INTEGER,      -- 0/1 boolean - whether PR has merge conflicts
-  ci_status TEXT,                   -- 'success' | 'failure' | 'pending' | null
-  ci_failures TEXT,                 -- JSON array of failed check names
+  short_summary TEXT NOT NULL,
+  full_summary TEXT NOT NULL,
+  key_actions TEXT,
+  files_modified TEXT,
+  outcome TEXT,
+  message_count INTEGER,
+  pr_merged INTEGER,
+  pr_state TEXT,
+  has_merge_conflicts INTEGER,
+  ci_status TEXT,
+  ci_failures TEXT,
+  last_summarized_message_id TEXT,
   generated_at INTEGER NOT NULL,
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Message attachments (files attached to user messages)
 CREATE TABLE IF NOT EXISTS message_attachments (
   id TEXT PRIMARY KEY,
   message_id TEXT REFERENCES conversation_messages(id) ON DELETE CASCADE,
@@ -190,12 +222,11 @@ CREATE TABLE IF NOT EXISTS message_attachments (
   mime_type TEXT NOT NULL,
   size_bytes INTEGER NOT NULL,
   storage_type TEXT NOT NULL DEFAULT 'base64' CHECK (storage_type IN ('base64', 'file_path', 'project_file')),
-  content TEXT,  -- base64 data or file reference depending on storage_type
-  file_path TEXT,  -- absolute path to file on disk (for Claude's Read tool)
+  content TEXT,
+  file_path TEXT,
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Command buttons (configurable buttons per project)
 CREATE TABLE IF NOT EXISTS command_buttons (
   id TEXT PRIMARY KEY,
   project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
@@ -207,7 +238,6 @@ CREATE TABLE IF NOT EXISTS command_buttons (
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Command runs (execution history for command buttons)
 CREATE TABLE IF NOT EXISTS command_runs (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
@@ -219,7 +249,6 @@ CREATE TABLE IF NOT EXISTS command_runs (
   completed_at INTEGER
 );
 
--- Quick responses (reusable messages for conversation)
 CREATE TABLE IF NOT EXISTS quick_responses (
   id TEXT PRIMARY KEY,
   project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
@@ -232,102 +261,51 @@ CREATE TABLE IF NOT EXISTS quick_responses (
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Providers (custom API endpoints for Claude; replaces the old model_providers table)
-CREATE TABLE IF NOT EXISTS providers (
+CREATE TABLE IF NOT EXISTS project_session_defaults (
   id TEXT PRIMARY KEY,
-  name TEXT NOT NULL,
-  base_url TEXT,
-  auth_token TEXT,
-  api_timeout_ms INTEGER,
-  additional_env_vars TEXT,
-  is_built_in INTEGER NOT NULL DEFAULT 0,
-  kind TEXT NOT NULL DEFAULT 'anthropic' CHECK(kind IN ('anthropic','openai')),
-  created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
-  updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+  project_id TEXT NOT NULL UNIQUE,
+  mode TEXT CHECK(mode IN ('plan', 'standard', 'yolo')),
+  thinking_enabled INTEGER,
+  start_immediately INTEGER,
+  git_mode TEXT CHECK(git_mode IN ('branch', 'worktree', 'current')),
+  git_branch TEXT,
+  model TEXT,
+  provider_id TEXT REFERENCES providers(id),
+  effort_level TEXT CHECK(effort_level IN ('low', 'medium', 'high', 'max', 'auto')),
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
 );
 
--- Provider models (custom models available per provider)
-CREATE TABLE IF NOT EXISTS provider_models (
-  id TEXT PRIMARY KEY,
-  provider_id TEXT NOT NULL REFERENCES providers(id) ON DELETE CASCADE,
-  model_id TEXT NOT NULL,
-  display_name TEXT NOT NULL,
-  description TEXT,
-  tier TEXT CHECK(tier IN ('opus', 'sonnet', 'haiku', 'custom')),
-  created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+CREATE TABLE IF NOT EXISTS app_settings (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  updated_at INTEGER NOT NULL
 );
 
--- Indexes
-CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_id);
-CREATE INDEX IF NOT EXISTS idx_sessions_status ON sessions(status);
-CREATE INDEX IF NOT EXISTS idx_sessions_archived ON sessions(archived);
-CREATE INDEX IF NOT EXISTS idx_conversations_session ON conversations(session_id);
-CREATE INDEX IF NOT EXISTS idx_messages_session ON conversation_messages(session_id);
--- Note: idx_messages_conversation is created in migrations to handle existing databases
--- that may not have the conversation_id column yet
-CREATE INDEX IF NOT EXISTS idx_canvas_session ON canvas_items(session_id);
--- Note: idx_canvas_deleted is created in migrations to handle existing databases
--- that may not have the deleted_at column yet
-CREATE INDEX IF NOT EXISTS idx_notes_session ON session_notes(session_id);
-CREATE INDEX IF NOT EXISTS idx_project_tools ON project_tool_templates(project_id);
-CREATE INDEX IF NOT EXISTS idx_session_templates_project ON session_templates(project_id);
--- Note: idx_sessions_next_template and idx_sessions_parent are created in migrations
--- to handle existing databases that may not have these columns yet
-CREATE INDEX IF NOT EXISTS idx_todos_session ON session_todos(session_id);
--- Note: idx_todos_conversation is created in migrations to handle existing databases
--- that may not have the conversation_id column yet
-CREATE INDEX IF NOT EXISTS idx_work_logs_session ON work_logs(session_id);
-CREATE INDEX IF NOT EXISTS idx_work_logs_message ON work_logs(message_id);
-CREATE INDEX IF NOT EXISTS idx_summaries_session ON session_summaries(session_id);
-CREATE INDEX IF NOT EXISTS idx_attachments_message ON message_attachments(message_id);
-CREATE INDEX IF NOT EXISTS idx_attachments_session ON message_attachments(session_id);
-CREATE INDEX IF NOT EXISTS idx_command_buttons_project ON command_buttons(project_id);
-CREATE INDEX IF NOT EXISTS idx_command_runs_session ON command_runs(session_id);
-CREATE INDEX IF NOT EXISTS idx_command_runs_button ON command_runs(button_id);
-CREATE INDEX IF NOT EXISTS idx_command_runs_status ON command_runs(status);
-CREATE INDEX IF NOT EXISTS idx_quick_responses_project ON quick_responses(project_id);
-CREATE INDEX IF NOT EXISTS idx_quick_responses_sort ON quick_responses(project_id, sort_order);
-CREATE INDEX IF NOT EXISTS idx_provider_models_provider ON provider_models(provider_id);
-
--- Agent call logs (metrics and analytics for agent interactions)
 CREATE TABLE IF NOT EXISTS agent_call_logs (
   id TEXT PRIMARY KEY,
   session_id TEXT NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
   conversation_id TEXT,
   agent_type TEXT NOT NULL,
   model TEXT,
-
-  -- Request info
-  call_type TEXT NOT NULL,       -- 'runSession' | 'continueSession' | 'continueSessionWithExistingMessage'
+  call_type TEXT NOT NULL,
   prompt_length INTEGER,
-
-  -- Response token info (updated during streaming and finalized at result)
   input_tokens INTEGER DEFAULT 0,
   output_tokens INTEGER DEFAULT 0,
   thinking_tokens INTEGER DEFAULT 0,
   cache_read_tokens INTEGER DEFAULT 0,
   cache_write_tokens INTEGER DEFAULT 0,
   total_tokens INTEGER DEFAULT 0,
-
-  -- Timing
   started_at INTEGER NOT NULL,
   completed_at INTEGER,
   duration_ms INTEGER,
-
-  -- Status
   status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending', 'streaming', 'completed', 'error')),
   error_message TEXT,
-
-  -- Metadata (JSON blob for extensibility)
   metadata TEXT,
-
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
-CREATE INDEX IF NOT EXISTS idx_agent_call_logs_session ON agent_call_logs(session_id);
-CREATE INDEX IF NOT EXISTS idx_agent_call_logs_started ON agent_call_logs(started_at);
-
--- Kanban boards (one per project)
 CREATE TABLE IF NOT EXISTS kanban_boards (
   id TEXT PRIMARY KEY,
   project_id TEXT NOT NULL UNIQUE REFERENCES projects(id) ON DELETE CASCADE,
@@ -335,7 +313,6 @@ CREATE TABLE IF NOT EXISTS kanban_boards (
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Kanban lanes (columns on the board)
 CREATE TABLE IF NOT EXISTS kanban_lanes (
   id TEXT PRIMARY KEY,
   board_id TEXT NOT NULL REFERENCES kanban_boards(id) ON DELETE CASCADE,
@@ -343,11 +320,21 @@ CREATE TABLE IF NOT EXISTS kanban_lanes (
   sort_order INTEGER NOT NULL DEFAULT 0,
   on_enter_template_id TEXT REFERENCES session_templates(id) ON DELETE SET NULL,
   on_enter_prompt TEXT,
+  on_enter_mode TEXT,
+  on_enter_model TEXT,
+  on_enter_effort_level TEXT,
+  on_enter_thinking_enabled INTEGER,
+  on_enter_auto_reschedule_enabled INTEGER DEFAULT 0,
+  on_enter_reschedule_delay_minutes INTEGER DEFAULT 60,
+  on_enter_reschedule_on_token_limit INTEGER DEFAULT 1,
+  on_enter_reschedule_on_service_error INTEGER DEFAULT 1,
+  on_enter_max_reschedule_count INTEGER,
+  on_enter_max_total_tokens INTEGER,
+  on_enter_reschedule_at_token_count INTEGER,
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Kanban cards (entries on the board, separate from sessions for future flexibility)
 CREATE TABLE IF NOT EXISTS kanban_cards (
   id TEXT PRIMARY KEY,
   lane_id TEXT NOT NULL REFERENCES kanban_lanes(id) ON DELETE CASCADE,
@@ -356,7 +343,6 @@ CREATE TABLE IF NOT EXISTS kanban_cards (
   updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Kanban card sessions (links cards to sessions, currently 1:1 but allows future N:1)
 CREATE TABLE IF NOT EXISTS kanban_card_sessions (
   id TEXT PRIMARY KEY,
   card_id TEXT NOT NULL REFERENCES kanban_cards(id) ON DELETE CASCADE,
@@ -364,7 +350,42 @@ CREATE TABLE IF NOT EXISTS kanban_card_sessions (
   created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
 );
 
--- Kanban indexes
+CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_id);
+CREATE INDEX IF NOT EXISTS idx_sessions_status ON sessions(status);
+CREATE INDEX IF NOT EXISTS idx_sessions_archived ON sessions(archived);
+CREATE INDEX IF NOT EXISTS idx_sessions_starred ON sessions(archived, starred);
+CREATE INDEX IF NOT EXISTS idx_sessions_next_template ON sessions(next_template_id);
+CREATE INDEX IF NOT EXISTS idx_sessions_parent ON sessions(parent_session_id);
+CREATE INDEX IF NOT EXISTS idx_sessions_scheduled ON sessions(scheduled_at) WHERE scheduled_at IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_conversations_session ON conversations(session_id);
+CREATE INDEX IF NOT EXISTS idx_conversations_parent ON conversations(parent_conversation_id);
+CREATE INDEX IF NOT EXISTS idx_messages_session ON conversation_messages(session_id);
+CREATE INDEX IF NOT EXISTS idx_messages_conversation ON conversation_messages(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_canvas_session ON canvas_items(session_id);
+CREATE INDEX IF NOT EXISTS idx_canvas_deleted ON canvas_items(deleted_at);
+CREATE INDEX IF NOT EXISTS idx_project_tools ON project_tool_templates(project_id);
+CREATE INDEX IF NOT EXISTS idx_session_templates_project ON session_templates(project_id);
+CREATE INDEX IF NOT EXISTS idx_todos_session ON session_todos(session_id);
+CREATE INDEX IF NOT EXISTS idx_todos_conversation ON session_todos(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_work_logs_session ON work_logs(session_id);
+CREATE INDEX IF NOT EXISTS idx_work_logs_message ON work_logs(message_id);
+CREATE INDEX IF NOT EXISTS idx_summaries_session ON session_summaries(session_id);
+CREATE INDEX IF NOT EXISTS idx_attachments_message ON message_attachments(message_id);
+CREATE INDEX IF NOT EXISTS idx_attachments_session ON message_attachments(session_id);
+CREATE INDEX IF NOT EXISTS idx_command_buttons_project ON command_buttons(project_id);
+CREATE INDEX IF NOT EXISTS idx_command_runs_session ON command_runs(session_id);
+CREATE INDEX IF NOT EXISTS idx_command_runs_button ON command_runs(button_id);
+CREATE INDEX IF NOT EXISTS idx_command_runs_status ON command_runs(status);
+CREATE INDEX IF NOT EXISTS idx_quick_responses_project ON quick_responses(project_id);
+CREATE INDEX IF NOT EXISTS idx_quick_responses_sort ON quick_responses(project_id, sort_order);
+CREATE INDEX IF NOT EXISTS idx_provider_models_provider ON provider_models(provider_id);
+CREATE INDEX IF NOT EXISTS idx_project_defaults_projectId ON project_session_defaults(project_id);
+CREATE INDEX IF NOT EXISTS idx_agent_call_logs_session ON agent_call_logs(session_id);
+CREATE INDEX IF NOT EXISTS idx_agent_call_logs_started ON agent_call_logs(started_at);
+CREATE INDEX IF NOT EXISTS idx_agent_call_logs_agent_type ON agent_call_logs(agent_type);
+CREATE INDEX IF NOT EXISTS idx_agent_call_logs_call_type ON agent_call_logs(call_type);
+CREATE INDEX IF NOT EXISTS idx_agent_call_logs_status ON agent_call_logs(status);
+CREATE INDEX IF NOT EXISTS idx_agent_call_logs_model ON agent_call_logs(model);
 CREATE INDEX IF NOT EXISTS idx_kanban_boards_project ON kanban_boards(project_id);
 CREATE INDEX IF NOT EXISTS idx_kanban_lanes_board ON kanban_lanes(board_id, sort_order);
 CREATE INDEX IF NOT EXISTS idx_kanban_cards_lane ON kanban_cards(lane_id, sort_order);

package/packages/server/src/scripts/backupDatabase.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { copyDatabaseBackups } from './dbUtils.js';
+
+export function main() {
+  const result = copyDatabaseBackups();
+
+  if (result.copied.length === 0) {
+    console.log(`No database found at ${result.dbPath}; nothing to back up.`);
+    return 0;
+  }
+
+  console.log(`Database backup directory: ${result.backupDir}`);
+  for (const file of result.copied) {
+    console.log(`${file.source} -> ${file.target}`);
+  }
+  return 0;
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  process.exit(main());
+}

package/packages/server/src/scripts/dbUtils.js

@@ -0,0 +1,81 @@
+import { existsSync, mkdirSync, copyFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { homedir, tmpdir } from 'node:os';
+import { getDefaultDbPath } from '../config.js';
+import { DatabaseManager } from '../db/DatabaseManager.js';
+
+export function getActiveDbPath() {
+  return process.env.DB_PATH || getDefaultDbPath();
+}
+
+export function getSqliteSidecarPaths(dbPath) {
+  return [`${dbPath}-wal`, `${dbPath}-shm`];
+}
+
+export function getBackupDir() {
+  return join(homedir(), '.circuschief', 'backups');
+}
+
+export function copyDatabaseBackups(dbPath = getActiveDbPath(), timestamp = new Date()) {
+  if (!existsSync(dbPath)) {
+    return { dbPath, backupDir: getBackupDir(), copied: [], missing: [dbPath] };
+  }
+
+  const backupDir = getBackupDir();
+  mkdirSync(backupDir, { recursive: true });
+
+  const stamp = timestamp.toISOString().replace(/[:.]/g, '-');
+  const candidates = [dbPath, ...getSqliteSidecarPaths(dbPath)];
+  const copied = [];
+  const missing = [];
+
+  for (const source of candidates) {
+    if (!existsSync(source)) {
+      missing.push(source);
+      continue;
+    }
+    const target = join(backupDir, `${basename(source)}.${stamp}.bak`);
+    copyFileSync(source, target);
+    copied.push({ source, target });
+  }
+
+  return { dbPath, backupDir, copied, missing };
+}
+
+export function createFreshBaselineDb() {
+  const tempDir = mkdtempSync(join(tmpdir(), 'circuschief-baseline-'));
+  const dbPath = join(tempDir, 'baseline.db');
+  const manager = new DatabaseManager();
+  const db = manager.init(dbPath);
+
+  return {
+    db,
+    dbPath,
+    close() {
+      manager.close();
+      rmSync(tempDir, { recursive: true, force: true });
+    },
+  };
+}
+
+export function getSchemaObjects(db) {
+  return db.prepare(`
+    SELECT type, name, tbl_name, sql
+    FROM sqlite_master
+    WHERE type IN ('table', 'index', 'trigger', 'view')
+      AND name NOT LIKE 'sqlite_%'
+    ORDER BY type, name
+  `).all();
+}
+
+export function getTableColumns(db, tableName) {
+  return db.prepare(`PRAGMA table_info(${tableName})`).all();
+}
+
+export function getIndexColumns(db, indexName) {
+  return db.prepare(`PRAGMA index_info(${indexName})`).all().map((row) => row.name);
+}
+
+export function normalizeSql(sql) {
+  return (sql || '').replace(/\s+/g, ' ').trim();
+}

package/packages/server/src/scripts/inspectDatabaseSchema.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import Database from 'better-sqlite3';
+import { existsSync } from 'node:fs';
+import {
+  createFreshBaselineDb,
+  getActiveDbPath,
+  getSchemaObjects,
+} from './dbUtils.js';
+
+const BASELINE_TABLES = [
+  'sessions',
+  'projects',
+  'project_session_defaults',
+  'session_templates',
+  'canvas_items',
+  'providers',
+  'provider_models',
+  'kanban_lanes',
+  'agent_call_logs',
+];
+
+function printDatabase(db, label) {
+  console.log(`# ${label}`);
+
+  for (const row of getSchemaObjects(db)) {
+    console.log(`\n-- ${row.type} ${row.name} (${row.tbl_name})`);
+    console.log(row.sql || '');
+  }
+
+  for (const table of BASELINE_TABLES) {
+    const exists = db.prepare(
+      "SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = ?"
+    ).get(table);
+    if (!exists) continue;
+
+    console.log(`\n-- PRAGMA table_info(${table})`);
+    console.table(db.prepare(`PRAGMA table_info(${table})`).all());
+    console.log(`-- PRAGMA foreign_key_list(${table})`);
+    console.table(db.prepare(`PRAGMA foreign_key_list(${table})`).all());
+    console.log(`-- PRAGMA index_list(${table})`);
+    const indexes = db.prepare(`PRAGMA index_list(${table})`).all();
+    console.table(indexes);
+
+    for (const index of indexes) {
+      console.log(`-- PRAGMA index_info(${index.name})`);
+      console.table(db.prepare(`PRAGMA index_info(${index.name})`).all());
+      console.log(`-- PRAGMA index_xinfo(${index.name})`);
+      console.table(db.prepare(`PRAGMA index_xinfo(${index.name})`).all());
+    }
+  }
+}
+
+export function main(argv = process.argv.slice(2)) {
+  if (argv.includes('--fresh')) {
+    const fresh = createFreshBaselineDb();
+    try {
+      printDatabase(fresh.db, `fresh baseline ${fresh.dbPath}`);
+    } finally {
+      fresh.close();
+    }
+    return 0;
+  }
+
+  const dbPath = getActiveDbPath();
+  if (!existsSync(dbPath)) {
+    console.log(`No database found at ${dbPath}; use --fresh to inspect a fresh baseline.`);
+    return 0;
+  }
+
+  const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+  try {
+    printDatabase(db, `active database ${dbPath}`);
+  } finally {
+    db.close();
+  }
+  return 0;
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  process.exit(main());
+}