circuschief 0.8.0 → 1.1.0

package/packages/server/src/db/migrations/index.js

@@ -1,3 +1,44 @@
+/**
+ * Central registry of all database migrations in execution order.
+ *
+ * Each migration is idempotent (checks before acting), so the exact ordering
+ * only matters where there are hard dependencies (e.g. a table must exist
+ * before a column references it via FK).
+ *
+ * The ordering below mirrors the original #runMigrations() top-to-bottom flow
+ * as closely as possible.
+ */
+import { sessionsMigrations } from './sessionsMigrations.js';
+import { projectsMigrations } from './projectsMigrations.js';
+import { conversationsMigrations } from './conversationsMigrations.js';
+import { canvasItemsMigrations } from './canvasItemsMigrations.js';
+import { miscMigrations } from './miscMigrations.js';
+import { kanbanMigrations } from './kanbanMigrations.js';
+import { providerMigrations } from './providerMigrations.js';
+import { providerCommitAttributionMigrations } from './providerCommitAttributionMigrations.js';
+
+/**
+ * Build a lookup map from a migrations array keyed by migration name.
+ * @param {Array<{name: string, up: Function}>} migrations
+ * @returns {Map<string, {name: string, up: Function}>}
+ */
+function toLookup(migrations) {
+  const map = new Map();
+  for (const m of migrations) {
+    map.set(m.name, m);
+  }
+  return map;
+}
+
+const s = toLookup(sessionsMigrations);
+const p = toLookup(projectsMigrations);
+const c = toLookup(conversationsMigrations);
+const ci = toLookup(canvasItemsMigrations);
+const m = toLookup(miscMigrations);
+const k = toLookup(kanbanMigrations);
+const pr = toLookup(providerMigrations);
+const pca = toLookup(providerCommitAttributionMigrations);
+
 /**
  * Repair sessions whose parent link was lost during schema consolidation.
  *
@@ -32,13 +73,200 @@ export const repairMissingSessionParentsFromWorktree = {
 };
 
 /**
- * Post-baseline database migrations.
- *
- * Pre-release migration history was consolidated into schema.sql. Future
- * shipped schema changes should be added here as explicit migrations.
+ * Flat, ordered list of every migration, matching the original execution order
+ * from DatabaseManager.#runMigrations().
  *
  * @type {Array<{name: string, up: (db: import('better-sqlite3').Database) => void}>}
  */
-export const allMigrations = [
+// Validate that all migrations are properly defined
+function validateMigrations(migrationsArray) {
+  for (const migration of migrationsArray) {
+    if (!migration || typeof migration.up !== 'function') {
+      const name = migration?.name || 'unknown';
+      throw new Error(`Migration "${name}" is undefined or missing an up() function`);
+    }
+  }
+  return migrationsArray;
+}
+
+export const allMigrations = validateMigrations([
+  // --- Sessions initial columns ---
+  s.get('sessions-add-cost_usd'),
+  s.get('sessions-add-claude_session_id'),
+  s.get('sessions-add-model'),
+  s.get('sessions-add-provider_id-early'),
+  s.get('sessions-add-effort_level'),
+
+  // --- Projects columns ---
+  p.get('projects-add-system_prompt'),
+  p.get('projects-add-on_session_created'),
+  p.get('projects-add-on_session_deleted'),
+  p.get('projects-add-repo_url'),
+  p.get('projects-add-worktree_path'),
+  p.get('projects-drop-summary-columns'),
+
+  // --- Sessions scheduling columns ---
+  s.get('sessions-add-scheduled_at'),
+  s.get('sessions-add-reschedule_delay_minutes'),
+  s.get('sessions-add-auto_reschedule_enabled'),
+  s.get('sessions-add-reschedule_on_token_limit'),
+  s.get('sessions-add-reschedule_on_service_error'),
+  s.get('sessions-add-max_reschedule_count'),
+  s.get('sessions-add-max_total_tokens'),
+  s.get('sessions-add-reschedule_count'),
+  s.get('sessions-add-reschedule_at_token_count'),
+
+  // --- Sessions status constraint migration (table recreation) ---
+  s.get('sessions-migrate-status-constraint'),
+
+  // --- Session summaries PR columns ---
+  c.get('session_summaries-add-pr_merged'),
+  c.get('session_summaries-add-pr_state'),
+  c.get('session_summaries-add-has_merge_conflicts'),
+  c.get('session_summaries-add-ci_status'),
+  c.get('session_summaries-add-ci_failures'),
+  c.get('session_summaries-add-last_summarized_message_id'),
+
+  // --- Sessions template chaining ---
+  s.get('sessions-add-next_template_id'),
+  s.get('sessions-add-parent_session_id'),
+  s.get('sessions-template-chaining-indexes'),
+
+  // --- Message attachments ---
+  c.get('message_attachments-add-file_path'),
+
+  // --- Conversation messages: conversation_id ---
+  c.get('conversation_messages-add-conversation_id'),
+
+  // --- Migrate existing sessions to conversations ---
+  c.get('conversations-migrate-existing-sessions'),
+
+  // --- Canvas items ---
+  ci.get('canvas_items-migrate-type-constraint'),
+  ci.get('canvas_items-add-deleted_at'),
+  ci.get('canvas_items-drop-label'),
+  ci.get('canvas_items-add-updated_at'),
+
+  // --- Conversations: claude_session_id + token usage ---
+  c.get('conversations-add-claude_session_id'),
+  c.get('conversations-add-input_tokens'),
+  c.get('conversations-add-output_tokens'),
+  c.get('conversations-add-thinking_tokens'),
+  c.get('conversations-add-cache_read_input_tokens'),
+  c.get('conversations-add-cache_creation_input_tokens'),
+  c.get('conversations-add-web_search_requests'),
+  c.get('conversations-add-context_window'),
+  c.get('conversations-add-model'),
+
+  // --- Sessions token usage ---
+  s.get('sessions-add-input_tokens'),
+  s.get('sessions-add-output_tokens'),
+  s.get('sessions-add-thinking_tokens'),
+  s.get('sessions-add-cache_read_input_tokens'),
+  s.get('sessions-add-cache_creation_input_tokens'),
+  s.get('sessions-add-web_search_requests'),
+  s.get('sessions-add-context_window'),
+
+  // --- Sessions archived / starred / manually_named ---
+  s.get('sessions-add-archived'),
+  s.get('sessions-add-starred'),
+  s.get('sessions-add-manually_named'),
+  s.get('sessions-add-pr_url_auto_link_disabled'),
+
+  // --- Project session defaults table ---
+  p.get('project_session_defaults-create-table'),
+
+  // --- Command buttons ---
+  m.get('command_buttons-add-show_on_list'),
+
+  // --- Session todos ---
+  c.get('session_todos-add-conversation_id'),
+
+  // --- Conversation branching ---
+  c.get('conversations-add-parent_conversation_id'),
+  c.get('conversations-add-branch_from_message_id'),
+
+  // --- Sessions pending prompt / slash commands / pending model / auto send ---
+  s.get('sessions-add-pending_prompt'),
+  s.get('sessions-add-slash_commands'),
+  s.get('sessions-add-pending_model'),
+  s.get('sessions-add-auto_send_pending_prompt'),
+
+  // --- Session templates ---
+  m.get('session_templates-add-model'),
+  m.get('session_templates-add-mode'),
+  m.get('session_templates-add-effort_level'),
+  m.get('session_templates-add-quick-response-fields'),
+
+  // --- Conversation messages model ---
+  c.get('conversation_messages-add-model'),
+
+  // --- App settings table ---
+  m.get('app_settings-create-table'),
+
+  // --- Legacy model_providers cleanup ---
+  pr.get('model_providers-cleanup-legacy'),
+
+  // --- Providers + provider_models tables + seed ---
+  pr.get('providers-create-tables'),
+  pr.get('providers-add-kind'),
+  pr.get('providers-add-commit_attribution_override'),
+  pca.get('providers-normalize-commit_attribution_override'),
+  pr.get('providers-seed-built-in'),
+  pr.get('providers-seed-built-in-openai'),
+
+  // --- Sessions provider_id (from providers FK) ---
+  s.get('sessions-add-provider_id-from-providers'),
+
+  // --- Project session defaults provider_id / effort_level ---
+  p.get('project_session_defaults-add-provider_id'),
+  p.get('project_session_defaults-add-effort_level'),
+
+  // --- Update built-in models ---
+  pr.get('providers-update-built-in-models'),
+
+  // --- Sessions agent_type ---
+  s.get('sessions-add-agent_type'),
+
+  // --- Agent call logs table ---
+  m.get('agent_call_logs-create-table'),
+
+  // --- Kanban feature ---
+  k.get('projects-add-kanban_enabled'),
+  k.get('kanban-create-tables'),
+  k.get('sessions-add-target_lane_id'),
+  k.get('sessions-add-lane_trigger_depth'),
+  k.get('session_templates-add-target_lane_id'),
+  k.get('kanban_lanes-add-on_enter_prompt'),
+  k.get('kanban_lanes-add-agent-settings'),
+
+  // --- Sessions default mode / thinking defaults (table recreation) ---
+  s.get('sessions-migrate-default-mode-thinking'),
+
+  // --- Seed default global quick responses ---
+  m.get('quick_responses-seed-defaults'),
+
+  // --- Convert legacy quick responses into template-backed quick responses ---
+  m.get('session_templates-convert-quick-responses'),
+
+  // --- Seed default global session templates ---
+  m.get('session_templates-seed-defaults'),
+
+  // --- Update built-in Opus model to 4.7 ---
+  pr.get('providers-update-built-in-opus-4-7'),
+
+  // --- Widen providers kind CHECK constraint to include 'google' ---
+  pr.get('providers-widen-kind-check-google'),
+
+  // --- Seed built-in Google provider + Gemini models ---
+  pr.get('providers-seed-built-in-google'),
+
+  // --- Update expired Gemini Flash Lite preview model to stable GA ---
+  pr.get('providers-update-gemini-flash-lite-model'),
+
+  // --- Project session defaults: add 'current' git mode ---
+  p.get('project_session_defaults-git_mode-add-current'),
+
+  // --- Repair missing session parent links from worktree paths ---
   repairMissingSessionParentsFromWorktree,
-];
+]);

package/packages/server/src/db/migrations/kanbanMigrations.js

@@ -0,0 +1,99 @@
+/**
+ * Migrations for Kanban board feature: kanban_boards, kanban_lanes,
+ * kanban_cards, kanban_card_sessions tables, and related columns on
+ * projects, sessions, and session_templates.
+ */
+import { addColumnIfMissing } from './migrationUtils.js';
+
+export const kanbanMigrations = [
+  {
+    name: 'projects-add-kanban_enabled',
+    up(db) {
+      addColumnIfMissing(db, 'projects', 'kanban_enabled', 'INTEGER NOT NULL DEFAULT 1');
+    },
+  },
+  {
+    name: 'kanban-create-tables',
+    up(db) {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS kanban_boards (
+          id TEXT PRIMARY KEY,
+          project_id TEXT NOT NULL UNIQUE REFERENCES projects(id) ON DELETE CASCADE,
+          created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+          updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+        );
+
+        CREATE TABLE IF NOT EXISTS kanban_lanes (
+          id TEXT PRIMARY KEY,
+          board_id TEXT NOT NULL REFERENCES kanban_boards(id) ON DELETE CASCADE,
+          name TEXT NOT NULL,
+          sort_order INTEGER NOT NULL DEFAULT 0,
+          on_enter_template_id TEXT REFERENCES session_templates(id) ON DELETE SET NULL,
+          created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+          updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+        );
+
+        CREATE TABLE IF NOT EXISTS kanban_cards (
+          id TEXT PRIMARY KEY,
+          lane_id TEXT NOT NULL REFERENCES kanban_lanes(id) ON DELETE CASCADE,
+          sort_order INTEGER NOT NULL DEFAULT 0,
+          created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000),
+          updated_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+        );
+
+        CREATE TABLE IF NOT EXISTS kanban_card_sessions (
+          id TEXT PRIMARY KEY,
+          card_id TEXT NOT NULL REFERENCES kanban_cards(id) ON DELETE CASCADE,
+          session_id TEXT NOT NULL UNIQUE REFERENCES sessions(id) ON DELETE CASCADE,
+          created_at INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
+        );
+
+        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);
+        CREATE INDEX IF NOT EXISTS idx_kanban_card_sessions_session ON kanban_card_sessions(session_id);
+        CREATE INDEX IF NOT EXISTS idx_kanban_card_sessions_card ON kanban_card_sessions(card_id);
+      `);
+    },
+  },
+  {
+    name: 'sessions-add-target_lane_id',
+    up(db) {
+      addColumnIfMissing(db, 'sessions', 'target_lane_id', 'TEXT REFERENCES kanban_lanes(id) ON DELETE SET NULL');
+    },
+  },
+  {
+    name: 'sessions-add-lane_trigger_depth',
+    up(db) {
+      addColumnIfMissing(db, 'sessions', 'lane_trigger_depth', 'INTEGER NOT NULL DEFAULT 0');
+    },
+  },
+  {
+    name: 'session_templates-add-target_lane_id',
+    up(db) {
+      addColumnIfMissing(db, 'session_templates', 'target_lane_id', 'TEXT REFERENCES kanban_lanes(id) ON DELETE SET NULL');
+    },
+  },
+  {
+    name: 'kanban_lanes-add-on_enter_prompt',
+    up(db) {
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_prompt', 'TEXT');
+    },
+  },
+  {
+    name: 'kanban_lanes-add-agent-settings',
+    up(db) {
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_mode', 'TEXT');
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_model', 'TEXT');
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_effort_level', 'TEXT');
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_thinking_enabled', 'INTEGER');
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_auto_reschedule_enabled', 'INTEGER DEFAULT 0');
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_reschedule_delay_minutes', 'INTEGER DEFAULT 60'); // keep in sync with DEFAULT_RESCHEDULE_DELAY_MINUTES
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_reschedule_on_token_limit', 'INTEGER DEFAULT 1');
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_reschedule_on_service_error', 'INTEGER DEFAULT 1');
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_max_reschedule_count', 'INTEGER');
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_max_total_tokens', 'INTEGER');
+      addColumnIfMissing(db, 'kanban_lanes', 'on_enter_reschedule_at_token_count', 'INTEGER');
+    },
+  },
+];

package/packages/server/src/db/migrations/miscMigrations.js

@@ -0,0 +1,244 @@
+/**
+ * Migrations for miscellaneous tables: command_buttons, session_templates,
+ * app_settings, providers, provider_models, agent_call_logs.
+ * Each export is an array of { name, up(db) } migration objects.
+ */
+import { randomUUID } from 'node:crypto';
+import { addColumnIfMissing } from './migrationUtils.js';
+
+/**
+ * Prompt strings for the default global session templates.
+ * Exported so tests can assert verbatim equality.
+ */
+export const DEFAULT_SESSION_TEMPLATE_PROMPTS = {
+  REVIEW: `Review the plan on the canvas. If there's more than one plan then review the most recently updated plan. if there are no plans on the canvas then look for the most recently updated plan on the root session canvas.
+
+Make sure there are tests explicitly called out for all changes. Make sure that all context necessary to hand off the task is included in the plan.
+
+Are there any gaps in the plan? Is test coverage spelled out explicitly? Does the code match the assumptions in the plan?
+
+Update the plan according to your review recommendations.`,
+  IMPLEMENT: `Implement the plan on the canvas. If there's more than one plan on the canvas then use the most recently updated plan. If you don't see a plan on the canvas then look at the parent session's canvas.`,
+  PR: `Ensure all relevant changes are committed and pushed. Then determine the session's goals. You can typically find details about the goals of the session by looking at the most recently modified markdown documents on the root session's canvas - these are typically plans that were implemented during the session. You can also look at the root session's summary, but don't trigger a new summary to be created if the summary is missing.
+
+Create a draft pr and ensure all changes are committed and pushed.`,
+};
+
+/**
+ * Seed default global session templates when no global template exists.
+ * Idempotent: if any global session template already exists, does nothing.
+ */
+function seedDefaultSessionTemplates(db) {
+  const count = db.prepare(
+    `SELECT COUNT(*) AS cnt
+     FROM session_templates
+     WHERE project_id IS NULL
+       AND legacy_quick_response_id IS NULL`
+  ).get().cnt;
+  if (count > 0) return;
+
+  const defaults = [
+    { name: 'Review the plan', prompt: DEFAULT_SESSION_TEMPLATE_PROMPTS.REVIEW },
+    { name: 'Implement the plan on the canvas', prompt: DEFAULT_SESSION_TEMPLATE_PROMPTS.IMPLEMENT },
+    { name: 'Create/update PR', prompt: DEFAULT_SESSION_TEMPLATE_PROMPTS.PR },
+  ];
+
+  const stmt = db.prepare(`
+    INSERT INTO session_templates (
+      id, project_id, name, prompt,
+      next_template_id, thinking_enabled,
+      git_branch, git_mode, model, mode, effort_level, target_lane_id,
+      show_in_quick_responses, quick_response_auto_submit,
+      quick_response_sort_order, legacy_quick_response_id,
+      created_at, updated_at
+    ) VALUES (?, NULL, ?, ?, NULL, 1, NULL, NULL, NULL, 'yolo', NULL, NULL, 0, 0, 0, NULL, ?, ?)
+  `);
+
+  const now = Date.now();
+  for (const item of defaults) {
+    stmt.run(randomUUID(), item.name, item.prompt, now, now);
+  }
+}
+
+/**
+ * Seed default global quick responses when the table is empty.
+ */
+function seedDefaultQuickResponses(db) {
+  const count = db.prepare('SELECT COUNT(*) AS cnt FROM quick_responses').get().cnt;
+  if (count > 0) return;
+
+  const defaults = [
+    { label: 'Put a plan on the canvas', content: 'Put a plan on the canvas to get this done', autoSubmit: false, sortOrder: 0 },
+    { label: 'Yes', content: 'Yes', autoSubmit: true, sortOrder: 1 },
+    { label: 'Review the plan', content: `Review the plan on the canvas. Are there any issues that you can find? Is test coverage specified explicitly enough? Does the current code match the assumptions in the plan?\n\nList the issues that you find and then update the plan on the canvas to address any issues that you find. Don't talk about issues with the original plan in the plan itself. Just tell me what the issues are, and update the plan so that the plan doesn't have the issues.`, autoSubmit: true, sortOrder: 2 },
+    { label: 'Implement the plan on the canvas', content: 'Implement the plan on the canvas', autoSubmit: true, sortOrder: 3 },
+    { label: 'Create / Update PR', content: `Ensure all relevant changes are committed and pushed. Then look at the session's summary and create a draft PR if no PR already exists.`, autoSubmit: true, sortOrder: 4 },
+    { label: 'Review PR', content: 'Look at the PR related to the root session. Review the PR. Are there any issues? Are best practices adhered to? Does the PR accomplish the goal? Are all changes covered by tests?', autoSubmit: true, sortOrder: 5 },
+    { label: 'Add tests', content: 'Inspect the changes on our branch. For each change, ensure we have tests that assert the change is working in the expected way. Implement the tests.', autoSubmit: true, sortOrder: 6 },
+    { label: 'Merge in main', content: 'Merge in the latest main branch', autoSubmit: true, sortOrder: 7 },
+    { label: 'Add tests to the plan', content: 'Call out specific test cases in the plan, we should have an assertion for each change called for in the plan', autoSubmit: true, sortOrder: 8 },
+    { label: 'Tests are failing', content: 'Tests are failing. Look at the canvas for details', autoSubmit: true, sortOrder: 9 },
+    { label: 'Continue', content: 'Continue', autoSubmit: true, sortOrder: 10 },
+  ];
+
+  const stmt = db.prepare(
+    `INSERT INTO quick_responses
+     (id, project_id, label, content, auto_submit, category, sort_order, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
+  );
+
+  const now = Date.now();
+  for (const item of defaults) {
+    stmt.run(randomUUID(), null, item.label, item.content, item.autoSubmit ? 1 : 0, null, item.sortOrder, now, now);
+  }
+}
+
+function convertQuickResponsesToTemplates(db) {
+  const rows = db.prepare('SELECT * FROM quick_responses ORDER BY sort_order ASC, created_at ASC').all();
+  const exists = db.prepare(
+    'SELECT 1 FROM session_templates WHERE legacy_quick_response_id = ? LIMIT 1'
+  );
+  const insert = db.prepare(`
+    INSERT INTO session_templates (
+      id, project_id, name, prompt,
+      next_template_id, thinking_enabled,
+      git_branch, git_mode, model, mode, effort_level, target_lane_id,
+      show_in_quick_responses, quick_response_auto_submit,
+      quick_response_sort_order, legacy_quick_response_id,
+      created_at, updated_at
+    ) VALUES (?, ?, ?, ?, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, 1, ?, ?, ?, ?, ?)
+  `);
+
+  for (const row of rows) {
+    if (exists.get(row.id)) continue;
+    insert.run(
+      randomUUID(),
+      row.project_id || null,
+      row.label,
+      row.content,
+      row.auto_submit ? 1 : 0,
+      row.sort_order ?? 0,
+      row.id,
+      row.created_at,
+      row.updated_at
+    );
+  }
+}
+
+/** @type {Array<{name: string, up: (db: import('better-sqlite3').Database) => void}>} */
+export const miscMigrations = [
+  // --- Command buttons ---
+  {
+    name: 'command_buttons-add-show_on_list',
+    up(db) {
+      addColumnIfMissing(db, 'command_buttons', 'show_on_list', 'INTEGER NOT NULL DEFAULT 0');
+    },
+  },
+
+  // --- Session templates ---
+  {
+    name: 'session_templates-add-model',
+    up(db) { addColumnIfMissing(db, 'session_templates', 'model', 'TEXT'); },
+  },
+  {
+    name: 'session_templates-add-mode',
+    up(db) {
+      addColumnIfMissing(
+        db, 'session_templates', 'mode',
+        "TEXT DEFAULT 'yolo' CHECK(mode IN ('plan', 'standard', 'yolo'))"
+      );
+    },
+  },
+  {
+    name: 'session_templates-add-effort_level',
+    up(db) {
+      addColumnIfMissing(
+        db, 'session_templates', 'effort_level',
+        "TEXT CHECK(effort_level IN ('low', 'medium', 'high', 'max', 'auto'))"
+      );
+    },
+  },
+  {
+    name: 'session_templates-add-quick-response-fields',
+    up(db) {
+      addColumnIfMissing(db, 'session_templates', 'show_in_quick_responses', 'INTEGER NOT NULL DEFAULT 0');
+      addColumnIfMissing(db, 'session_templates', 'quick_response_auto_submit', 'INTEGER NOT NULL DEFAULT 0');
+      addColumnIfMissing(db, 'session_templates', 'quick_response_sort_order', 'INTEGER NOT NULL DEFAULT 0');
+      addColumnIfMissing(db, 'session_templates', 'legacy_quick_response_id', 'TEXT');
+      db.exec(`
+        CREATE UNIQUE INDEX IF NOT EXISTS idx_session_templates_legacy_quick_response_id
+        ON session_templates(legacy_quick_response_id)
+        WHERE legacy_quick_response_id IS NOT NULL
+      `);
+    },
+  },
+
+  // --- App settings table ---
+  {
+    name: 'app_settings-create-table',
+    up(db) {
+      db.exec(`
+        CREATE TABLE IF NOT EXISTS app_settings (
+          key TEXT PRIMARY KEY,
+          value TEXT NOT NULL,
+          updated_at INTEGER NOT NULL
+        )
+      `);
+    },
+  },
+
+  // --- Agent call logs table ---
+  {
+    name: 'agent_call_logs-create-table',
+    up(db) {
+      db.exec(`
+        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,
+          call_type TEXT NOT NULL,
+          prompt_length INTEGER,
+          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,
+          started_at INTEGER NOT NULL,
+          completed_at INTEGER,
+          duration_ms INTEGER,
+          status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending', 'streaming', 'completed', 'error')),
+          error_message TEXT,
+          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);
+        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);
+      `);
+    },
+  },
+
+  // --- Seed default global quick responses ---
+  {
+    name: 'quick_responses-seed-defaults',
+    up(db) { seedDefaultQuickResponses(db); },
+  },
+
+  {
+    name: 'session_templates-convert-quick-responses',
+    up(db) { convertQuickResponsesToTemplates(db); },
+  },
+
+  // --- Seed default global session templates ---
+  {
+    name: 'session_templates-seed-defaults',
+    up(db) { seedDefaultSessionTemplates(db); },
+  },
+
+];