@saadnvd1/agent-os 0.3.596 → 0.3.600

package/lib/db/migrations/0039_add_session_name_source.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 39,
+  name: "add_session_name_source",
+  up: (db) => {
+    // Who named a session: "user" (typed or given explicitly, never
+    // renamed for them), "generated" (a title picked from its prompt) or
+    // "default" ("Session 4", or a placeholder until a title arrives).
+    // One transaction, so a crash part-way leaves nothing to skip.
+    db.transaction(() => {
+      db.exec(
+        `ALTER TABLE sessions ADD COLUMN name_source TEXT NOT NULL DEFAULT 'default'`
+      );
+      // A session renamed by hand before this keeps its name.
+      db.exec(
+        `UPDATE sessions SET name_source = 'user' WHERE id IN (SELECT session_id FROM session_names)`
+      );
+    })();
+  },
+} satisfies Migration;

package/lib/db/migrations/0040_add_schedule_targets_and_phone_notify.ts

@@ -0,0 +1,41 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 40,
+  name: "add_schedule_targets_and_phone_notify",
+  // One transaction, so a crash part-way leaves nothing to skip as
+  // "duplicate column" on the next start.
+  up: (db) =>
+    db.transaction(() => {
+      // Where phone notifications go. One row; the bot token is never
+      // returned by any route or written to a log.
+      db.exec(`
+          CREATE TABLE IF NOT EXISTS notify_settings (
+            id INTEGER PRIMARY KEY CHECK (id = 1),
+            telegram_token TEXT,
+            telegram_chat_id TEXT,
+            updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+          )
+        `);
+      // Every phone notification, sent or waiting out its source's
+      // minute, so one held across a restart still goes.
+      db.exec(`
+          CREATE TABLE IF NOT EXISTS notify_outbox (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            source TEXT NOT NULL,
+            text TEXT NOT NULL,
+            created_at INTEGER NOT NULL,
+            send_after INTEGER NOT NULL,
+            sent_at INTEGER,
+            error TEXT
+          )
+        `);
+      db.exec(
+        `CREATE INDEX IF NOT EXISTS idx_notify_outbox_source ON notify_outbox(source, sent_at)`
+      );
+      // A "message" schedule's session, by id: names change, ids don't.
+      // And the agent session that made a schedule, when one did.
+      db.exec(`ALTER TABLE schedules ADD COLUMN target_session_id TEXT`);
+      db.exec(`ALTER TABLE schedules ADD COLUMN created_by_session_id TEXT`);
+    })(),
+} satisfies Migration;

package/lib/db/migrations/0041_add_task_setup.ts

@@ -0,0 +1,17 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 41,
+  name: "add_task_setup",
+  up: (db) => {
+    // How a task's worktree setup (deps, setup commands) went before its
+    // agent started: running, ok or failed, how long, and what failed;
+    // and the brief its launch needs, so a restart can resume it.
+    db.transaction(() => {
+      db.exec(`ALTER TABLE sessions ADD COLUMN setup_status TEXT`);
+      db.exec(`ALTER TABLE sessions ADD COLUMN setup_ms INTEGER`);
+      db.exec(`ALTER TABLE sessions ADD COLUMN setup_error TEXT`);
+      db.exec(`ALTER TABLE sessions ADD COLUMN task_brief TEXT`);
+    })();
+  },
+} satisfies Migration;

package/lib/db/migrations/0042_add_host_links_and_moved_tasks.ts

@@ -0,0 +1,29 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 42,
+  name: "add_host_links_and_moved_tasks",
+  up: (db) => {
+    // How this machine reaches another machine's own AgentOS: its URL and
+    // the device token it paired with. Apart from hosts so the token never
+    // rides along with a host row to the browser.
+    db.transaction(() => {
+      db.exec(`
+          CREATE TABLE IF NOT EXISTS host_links (
+            host_id TEXT PRIMARY KEY REFERENCES hosts(id) ON DELETE CASCADE,
+            url TEXT NOT NULL,
+            token TEXT NOT NULL,
+            linked_at TEXT NOT NULL DEFAULT (datetime('now'))
+          )
+        `);
+      // A task moved to another machine keeps its row, marked where it
+      // went; one that arrived names the session it came from, so the
+      // same move imported twice finds the first.
+      db.exec(`ALTER TABLE sessions ADD COLUMN moved_to TEXT`);
+      db.exec(`ALTER TABLE sessions ADD COLUMN moved_from TEXT`);
+      db.exec(
+        `CREATE INDEX IF NOT EXISTS idx_sessions_moved_from ON sessions(moved_from)`
+      );
+    })();
+  },
+} satisfies Migration;

package/lib/db/migrations/0043_scratch_project.ts

@@ -0,0 +1,14 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 43,
+  name: "scratch_project",
+  up: (db) => {
+    // Chats with no project work in a scratch folder rather than the home
+    // directory. Sessions already made keep their own folders.
+    db.prepare(
+      `UPDATE projects SET name = 'Scratch', working_directory = '~/.agent-os/scratch'
+         WHERE is_uncategorized = 1 AND name = 'Uncategorized' AND working_directory = '~'`
+    ).run();
+  },
+} satisfies Migration;

package/lib/db/migrations/0044_chat_item_kind.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 44,
+  name: "chat_item_kind",
+  up: (db) => {
+    // Items of one kind (a chat's background tasks, its sent messages)
+    // read from an index, not by parsing every row of a long conversation.
+    const columns = db.prepare(`PRAGMA table_xinfo(chat_items)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "kind"))
+      db.exec(
+        `ALTER TABLE chat_items ADD COLUMN kind TEXT
+             GENERATED ALWAYS AS (json_extract(data, '$.kind')) VIRTUAL`
+      );
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_chat_items_kind ON chat_items(session_id, kind, seq)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0045_change_versions.ts

@@ -0,0 +1,13 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_45 } from "../changes";
+
+export default {
+  id: 45,
+  name: "change_versions",
+  up: (db) => {
+    // What browsers show from these tables is pushed when they change
+    // (lib/db/changes.ts) instead of polled. A table added later gets its
+    // own migration.
+    installChangeTriggers(db, TABLES_WATCHED_45);
+  },
+} satisfies Migration;

package/lib/db/migrations/0046_session_port_slots.ts

@@ -0,0 +1,21 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 46,
+  name: "session_port_slots",
+  up: (db) => {
+    // A session's port slot and the ports agentos.json's bases resolve to
+    // with it (lib/ports.ts). The unique index is what keeps two parallel
+    // starts, in any process, off one slot.
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "port_slot"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN port_slot INTEGER`);
+    if (!columns.some((c) => c.name === "ports"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN ports TEXT`);
+    db.exec(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_sessions_port_slot ON sessions(port_slot) WHERE port_slot IS NOT NULL`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0047_pin_orchestrators.ts

@@ -0,0 +1,12 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 47,
+  name: "pin_orchestrators",
+  up: (db) => {
+    // A workspace's orchestrator starts pinned to the top of its list;
+    // unpinning it is then remembered on the session, which lives as
+    // long as its workspace.
+    db.exec(`UPDATE sessions SET pinned = 1 WHERE role = 'orchestrator'`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0048_session_database.ts

@@ -0,0 +1,15 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 48,
+  name: "session_database",
+  up: (db) => {
+    // The session's private Postgres copy, or why it has none, as JSON
+    // (lib/project-config/database.ts).
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "database"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN database TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0049_peer_mirror.ts

@@ -0,0 +1,14 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 49,
+  name: "peer_mirror",
+  up: (db) => {
+    // A row that only shows a linked machine's own session: actions on
+    // it go to that machine. Rows this machine started there over ssh
+    // are its own, and stay 0.
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN peer_mirror INTEGER NOT NULL DEFAULT 0`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0050_task_queue.ts

@@ -0,0 +1,44 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_50 } from "../changes";
+
+export default {
+  id: 50,
+  name: "task_queue",
+  up: (db) => {
+    // Tasks waiting to start (lib/tasks/queue.ts): over the workspace's
+    // limit on running tasks, or after another task. A row's id is the
+    // session id it starts as, so a restart never starts one twice.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS task_queue (
+          id TEXT PRIMARY KEY,
+          project_id TEXT NOT NULL,
+          prompt TEXT NOT NULL,
+          name TEXT,
+          model TEXT,
+          view TEXT,
+          base_branch TEXT,
+          host_id TEXT,
+          after_task TEXT,
+          after_any TEXT,
+          origin_workspace_id TEXT,
+          position INTEGER NOT NULL,
+          status TEXT NOT NULL DEFAULT 'queued',
+          note TEXT,
+          error TEXT,
+          attempts INTEGER NOT NULL DEFAULT 0,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          started_at TEXT
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_task_queue_status ON task_queue(status, position)`
+    );
+    const columns = db.prepare(`PRAGMA table_info(workspaces)`).all() as {
+      name: string;
+    }[];
+    // Null: no limit.
+    if (!columns.some((c) => c.name === "max_running_tasks"))
+      db.exec(`ALTER TABLE workspaces ADD COLUMN max_running_tasks INTEGER`);
+    installChangeTriggers(db, TABLES_WATCHED_50);
+  },
+} satisfies Migration;

package/lib/db/migrations/0051_chat_queue_sent_by.ts

@@ -0,0 +1,16 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  // 50 is taken by queued tasks, landing separately.
+  id: 51,
+  name: "chat_queue_sent_by",
+  up: (db) => {
+    // Who sent a queued message the reader didn't type (lib/chat/events
+    // SentBy, as JSON), so it still shows as theirs once it's sent.
+    const columns = db.prepare(`PRAGMA table_info(chat_queue)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "sent_by"))
+      db.exec(`ALTER TABLE chat_queue ADD COLUMN sent_by TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0052_sessions_chat_restarted.ts

@@ -0,0 +1,17 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 52,
+  name: "sessions_chat_restarted",
+  up: (db) => {
+    // Set by a chat worker that retired cleanly after a deploy; the next
+    // worker tells the agent so with its first message, then clears it.
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "chat_restarted"))
+      db.exec(
+        `ALTER TABLE sessions ADD COLUMN chat_restarted INTEGER NOT NULL DEFAULT 0`
+      );
+  },
+} satisfies Migration;

package/lib/db/migrations/0053_brief_amendments_failure_sha_ask_raised_by.ts

@@ -0,0 +1,37 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 53,
+  name: "brief_amendments_failure_sha_ask_raised_by",
+  up: (db) => {
+    // Scope changes the orchestrator records on a task after it started
+    // (send with scope_change); its review judges against them.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS brief_amendments (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          session_id TEXT NOT NULL,
+          workspace_id TEXT NOT NULL,
+          text TEXT NOT NULL,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        );
+        CREATE INDEX IF NOT EXISTS idx_brief_amendments_session
+          ON brief_amendments(session_id);
+      `);
+    // The commit a stored verdict's failure was counted for, so reading
+    // the same verdict again isn't a second failure.
+    const columns = db
+      .prepare(`PRAGMA table_info(orchestrator_gate_failures)`)
+      .all() as { name: string }[];
+    if (!columns.some((c) => c.name === "last_sha"))
+      db.exec(
+        `ALTER TABLE orchestrator_gate_failures ADD COLUMN last_sha TEXT`
+      );
+    // Who raised a merge ask: the orchestrator may refresh its own, never
+    // one the gates raised.
+    const asks = db.prepare(`PRAGMA table_info(orchestrator_asks)`).all() as {
+      name: string;
+    }[];
+    if (!asks.some((c) => c.name === "raised_by"))
+      db.exec(`ALTER TABLE orchestrator_asks ADD COLUMN raised_by TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0054_sessions_chat_tools_digest.ts

@@ -0,0 +1,15 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 54,
+  name: "sessions_chat_tools_digest",
+  up: (db) => {
+    // The tools a chat worker last gave the agent (an orchestrator's), so
+    // the next one says they changed only when they did.
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "chat_tools_digest"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN chat_tools_digest TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0055_sessions_merge_armed_and_rebase.ts

@@ -0,0 +1,25 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 55,
+  name: "sessions_merge_armed_and_rebase",
+  up: (db) => {
+    // merge_armed_at: AgentOS merges the task's PR once every gate
+    // passes (orchestrator/armed.ts); merge_armed_seen: the failure it
+    // last reported. rebased_from/to: the heads an automatic rebase onto
+    // the base moved the branch between, for the code-review gate.
+    // rebase_asked_head: the head the task was last asked to rebase.
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    for (const name of [
+      "merge_armed_at",
+      "merge_armed_seen",
+      "rebased_from",
+      "rebased_to",
+      "rebase_asked_head",
+    ])
+      if (!columns.some((c) => c.name === name))
+        db.exec(`ALTER TABLE sessions ADD COLUMN ${name} TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0056_orchestrator_rules.ts

@@ -0,0 +1,39 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_56 } from "../changes";
+
+export default {
+  id: 56,
+  name: "orchestrator_rules",
+  up: (db) => {
+    // Standing rules an orchestrator keeps across fresh starts
+    // (lib/orchestrator/rules.ts): written by it or by Saad, never
+    // deleted, only marked removed.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_rules (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          text TEXT NOT NULL,
+          added_by TEXT NOT NULL,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+          removed_at TEXT,
+          removed_by TEXT
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_orchestrator_rules
+         ON orchestrator_rules(workspace_id, removed_at, id)`
+    );
+    // Its last worker ended the conversation at the context threshold:
+    // the tokens it had reached (0 otherwise). The next one starts a new
+    // one and tells the agent so.
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "chat_refreshed"))
+      db.exec(
+        `ALTER TABLE sessions ADD COLUMN chat_refreshed INTEGER NOT NULL DEFAULT 0`
+      );
+    installChangeTriggers(db, TABLES_WATCHED_56);
+  },
+} satisfies Migration;

package/lib/db/migrations/0057_task_pr_wakes.ts

@@ -0,0 +1,34 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 57,
+  name: "task_pr_wakes",
+  up: (db) => {
+    // What a task's agent was told about its PR (orchestrator/pr-wake.ts),
+    // one row per failing head or review/comment id, claimed before the
+    // message goes. kind: check, review or comment (comments are capped).
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS task_pr_wakes (
+          session_id TEXT NOT NULL,
+          key TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          PRIMARY KEY (session_id, key)
+        );
+      `);
+    // pr_wake_since: reviews and comments older than this are taken as
+    // known when a task's PR is first watched.
+    const sessions = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!sessions.some((c) => c.name === "pr_wake_since"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN pr_wake_since TEXT`);
+    const workspaces = db.prepare(`PRAGMA table_info(workspaces)`).all() as {
+      name: string;
+    }[];
+    if (!workspaces.some((c) => c.name === "wake_tasks_on_pr"))
+      db.exec(
+        `ALTER TABLE workspaces ADD COLUMN wake_tasks_on_pr INTEGER NOT NULL DEFAULT 1`
+      );
+  },
+} satisfies Migration;

package/lib/db/migrations/0058_away_mode.ts

@@ -0,0 +1,71 @@
+import type { Migration } from "../migration-types";
+import { installChangeTriggers, TABLES_WATCHED_58 } from "../changes";
+
+export default {
+  id: 58,
+  name: "away_mode",
+  up: (db) => {
+    // Saad's Away mode (lib/away): one row per time he stepped away. The
+    // report is built from the database when it ends and kept here.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS away_periods (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          set_by TEXT NOT NULL,
+          started_at TEXT NOT NULL DEFAULT (datetime('now')),
+          expires_at TEXT,
+          ended_at TEXT,
+          ended_by TEXT,
+          last_sweep_at TEXT,
+          asks_notified_at TEXT,
+          report TEXT,
+          report_seen_at TEXT
+        )
+      `);
+    // What the away sweep did, once per key per period: a nudge, a
+    // request to commit, a review run again, a deploy checked.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS away_actions (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          away_id INTEGER NOT NULL,
+          workspace_id TEXT NOT NULL,
+          subject TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          key TEXT NOT NULL,
+          detail TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          UNIQUE (away_id, key)
+        )
+      `);
+    // When a task merged, whichever path merged it.
+    const columns = db.prepare(`PRAGMA table_info(sessions)`).all() as {
+      name: string;
+    }[];
+    if (!columns.some((c) => c.name === "merged_at"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN merged_at TEXT`);
+    // When a task ended without a merge (dropped, or done with no PR or
+    // its PR closed).
+    if (!columns.some((c) => c.name === "task_ended_at"))
+      db.exec(`ALTER TABLE sessions ADD COLUMN task_ended_at TEXT`);
+    db.exec(`
+        CREATE TRIGGER IF NOT EXISTS sessions_task_ended_at
+          AFTER UPDATE OF task_status ON sessions
+          WHEN NEW.task_status IN ('dropped', 'done')
+            AND OLD.task_status IS NOT NEW.task_status
+            AND NEW.task_ended_at IS OLD.task_ended_at
+        BEGIN
+          UPDATE sessions SET task_ended_at = datetime('now') WHERE id = NEW.id;
+        END
+      `);
+    db.exec(`
+        CREATE TRIGGER IF NOT EXISTS sessions_merged_at
+          AFTER UPDATE OF task_status ON sessions
+          WHEN NEW.task_status = 'merged' AND OLD.task_status IS NOT 'merged'
+            -- unless the same statement set it (an import keeps its own)
+            AND NEW.merged_at IS OLD.merged_at
+        BEGIN
+          UPDATE sessions SET merged_at = datetime('now') WHERE id = NEW.id;
+        END
+      `);
+    installChangeTriggers(db, TABLES_WATCHED_58);
+  },
+} satisfies Migration;

package/lib/db/migrations/0059_gate_failure_commits.ts

@@ -0,0 +1,33 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 59,
+  name: "gate_failure_commits",
+  up: (db) => {
+    // Each head a gate failed on, once: a gate's failure counts once per
+    // commit however many times that commit is judged (the armed watcher,
+    // CI finishing, sign_off, done, land), and the second commit it fails
+    // on goes to Saad. The key is what makes it once, across restarts and
+    // concurrent evaluations.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_gate_failure_commits (
+          session_id TEXT NOT NULL,
+          gate TEXT NOT NULL,
+          sha TEXT NOT NULL,
+          workspace_id TEXT NOT NULL,
+          reason TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          PRIMARY KEY (session_id, gate, sha)
+        );
+        INSERT OR IGNORE INTO orchestrator_gate_failure_commits (session_id, gate, sha, workspace_id, reason)
+          SELECT session_id, gate, last_sha, workspace_id, last_reason
+          FROM orchestrator_gate_failures WHERE last_sha IS NOT NULL;
+        CREATE TRIGGER IF NOT EXISTS gate_failures_clear_commits
+          AFTER DELETE ON orchestrator_gate_failures
+        BEGIN
+          DELETE FROM orchestrator_gate_failure_commits
+            WHERE session_id = OLD.session_id AND gate = OLD.gate;
+        END;
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0060_check_runs_and_compactions.ts

@@ -0,0 +1,44 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 60,
+  name: "check_runs_and_compactions",
+  up: (db) => {
+    // What each run of the independent reviewer and the scope check cost,
+    // from its claude -p result: it leaves no transcript, so this is the
+    // only record. And each compaction a chat's agent made, so tokens per
+    // task can be compared before and after the threshold moved.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS check_runs (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          session_id TEXT NOT NULL,
+          label TEXT NOT NULL,
+          pr_number INTEGER,
+          sha TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          model TEXT,
+          input_tokens INTEGER NOT NULL,
+          cache_write_tokens INTEGER NOT NULL,
+          cache_read_tokens INTEGER NOT NULL,
+          output_tokens INTEGER NOT NULL,
+          cost_usd REAL NOT NULL,
+          duration_ms INTEGER,
+          at INTEGER NOT NULL
+        );
+        CREATE INDEX IF NOT EXISTS idx_check_runs_at ON check_runs(at);
+        CREATE INDEX IF NOT EXISTS idx_check_runs_sha ON check_runs(session_id, sha, kind);
+        CREATE TABLE IF NOT EXISTS chat_compactions (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          session_id TEXT NOT NULL,
+          session_name TEXT NOT NULL,
+          workspace_id TEXT,
+          at INTEGER NOT NULL,
+          trigger TEXT NOT NULL,
+          before_tokens INTEGER,
+          after_tokens INTEGER
+        );
+        CREATE INDEX IF NOT EXISTS idx_chat_compactions_at ON chat_compactions(at);
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0061_model_routing.ts

@@ -0,0 +1,30 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 61,
+  name: "model_routing",
+  // One transaction, so a crash part-way leaves nothing to skip as
+  // "duplicate column" on the next start.
+  up: (db) =>
+    db.transaction(() => {
+      // What a session runs on beyond the model name: its provider (NULL is
+      // Anthropic), a task's own models by role (JSON), and a task's plan
+      // step (planning, then implementing). Each turn keeps the model,
+      // provider and role it ran as, how long it took, and the plan's 5-hour
+      // window when it ended, so spend compares by model. A check run keeps the
+      // provider its model came from.
+      for (const col of [
+        `ALTER TABLE sessions ADD COLUMN model_provider TEXT`,
+        `ALTER TABLE sessions ADD COLUMN model_overrides TEXT`,
+        `ALTER TABLE sessions ADD COLUMN plan_phase TEXT`,
+        `ALTER TABLE task_queue ADD COLUMN model_overrides TEXT`,
+        `ALTER TABLE chat_turns ADD COLUMN model TEXT`,
+        `ALTER TABLE chat_turns ADD COLUMN provider TEXT`,
+        `ALTER TABLE chat_turns ADD COLUMN role TEXT`,
+        `ALTER TABLE chat_turns ADD COLUMN duration_ms INTEGER`,
+        `ALTER TABLE chat_turns ADD COLUMN window_pct REAL`,
+        `ALTER TABLE check_runs ADD COLUMN provider TEXT`,
+      ])
+        db.exec(col);
+    })(),
+} satisfies Migration;