@saadnvd1/agent-os 0.3.596 → 0.3.597

package/lib/db/migration-types.ts

@@ -0,0 +1,15 @@
+import type Database from "better-sqlite3";
+
+export interface LegacyMigration {
+  id: number;
+  key?: undefined;
+  name: string;
+  up: (db: Database.Database) => void;
+}
+export interface KeyedMigration {
+  key: string;
+  id?: undefined;
+  name?: undefined;
+  up: (db: Database.Database) => void;
+}
+export type Migration = LegacyMigration | KeyedMigration;

package/lib/db/migrations/0001_add_group_path_to_sessions.ts

@@ -0,0 +1,11 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 1,
+  name: "add_group_path_to_sessions",
+  up: (db) => {
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN group_path TEXT NOT NULL DEFAULT 'sessions'`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0002_add_agent_type_to_sessions.ts

@@ -0,0 +1,11 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 2,
+  name: "add_agent_type_to_sessions",
+  up: (db) => {
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN agent_type TEXT NOT NULL DEFAULT 'claude'`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0003_add_worktree_columns_to_sessions.ts

@@ -0,0 +1,12 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 3,
+  name: "add_worktree_columns_to_sessions",
+  up: (db) => {
+    db.exec(`ALTER TABLE sessions ADD COLUMN worktree_path TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN branch_name TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN base_branch TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN dev_server_port INTEGER`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0004_add_pr_tracking_to_sessions.ts

@@ -0,0 +1,11 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 4,
+  name: "add_pr_tracking_to_sessions",
+  up: (db) => {
+    db.exec(`ALTER TABLE sessions ADD COLUMN pr_url TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN pr_number INTEGER`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN pr_status TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0005_add_group_path_index.ts

@@ -0,0 +1,11 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 5,
+  name: "add_group_path_index",
+  up: (db) => {
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_sessions_group ON sessions(group_path)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0006_add_orchestration_columns_to_sessions.ts

@@ -0,0 +1,16 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 6,
+  name: "add_orchestration_columns_to_sessions",
+  up: (db) => {
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN conductor_session_id TEXT REFERENCES sessions(id)`
+    );
+    db.exec(`ALTER TABLE sessions ADD COLUMN worker_task TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN worker_status TEXT`);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_sessions_conductor ON sessions(conductor_session_id)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0007_add_auto_approve_to_sessions.ts

@@ -0,0 +1,11 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 7,
+  name: "add_auto_approve_to_sessions",
+  up: (db) => {
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN auto_approve INTEGER NOT NULL DEFAULT 0`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0008_add_dev_server_columns.ts

@@ -0,0 +1,19 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 8,
+  name: "add_dev_server_columns",
+  up: (db) => {
+    db.exec(
+      `ALTER TABLE dev_servers ADD COLUMN type TEXT NOT NULL DEFAULT 'node'`
+    );
+    db.exec(`ALTER TABLE dev_servers ADD COLUMN name TEXT NOT NULL DEFAULT ''`);
+    db.exec(
+      `ALTER TABLE dev_servers ADD COLUMN command TEXT NOT NULL DEFAULT ''`
+    );
+    db.exec(`ALTER TABLE dev_servers ADD COLUMN pid INTEGER`);
+    db.exec(
+      `ALTER TABLE dev_servers ADD COLUMN working_directory TEXT NOT NULL DEFAULT ''`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0009_add_project_id_to_sessions.ts

@@ -0,0 +1,17 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 9,
+  name: "add_project_id_to_sessions",
+  up: (db) => {
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN project_id TEXT REFERENCES projects(id)`
+    );
+    db.exec(
+      `UPDATE sessions SET project_id = 'uncategorized' WHERE project_id IS NULL`
+    );
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_id)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0010_add_project_id_to_dev_servers.ts

@@ -0,0 +1,36 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 10,
+  name: "add_project_id_to_dev_servers",
+  up: (db) => {
+    // Check if column exists first
+    const cols = db.prepare(`PRAGMA table_info(dev_servers)`).all() as {
+      name: string;
+    }[];
+    if (cols.some((c) => c.name === "project_id")) return;
+
+    db.exec(
+      `ALTER TABLE dev_servers ADD COLUMN project_id TEXT REFERENCES projects(id)`
+    );
+    // Migrate from session_id if it exists
+    const hasSessionId = cols.some((c) => c.name === "session_id");
+    if (hasSessionId) {
+      db.exec(`
+          UPDATE dev_servers
+          SET project_id = (
+            SELECT COALESCE(s.project_id, 'uncategorized')
+            FROM sessions s
+            WHERE s.id = dev_servers.session_id
+          )
+          WHERE project_id IS NULL
+        `);
+    }
+    db.exec(
+      `UPDATE dev_servers SET project_id = 'uncategorized' WHERE project_id IS NULL`
+    );
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_dev_servers_project ON dev_servers(project_id)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0011_add_tmux_name_to_sessions.ts

@@ -0,0 +1,13 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 11,
+  name: "add_tmux_name_to_sessions",
+  up: (db) => {
+    db.exec(`ALTER TABLE sessions ADD COLUMN tmux_name TEXT`);
+    // Backfill existing sessions with computed tmux name
+    db.exec(
+      `UPDATE sessions SET tmux_name = agent_type || '-' || id WHERE tmux_name IS NULL`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0012_add_initial_prompt_to_projects.ts

@@ -0,0 +1,9 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 12,
+  name: "add_initial_prompt_to_projects",
+  up: (db) => {
+    db.exec(`ALTER TABLE projects ADD COLUMN initial_prompt TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0013_add_project_repositories_table.ts

@@ -0,0 +1,22 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 13,
+  name: "add_project_repositories_table",
+  up: (db) => {
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS project_repositories (
+          id TEXT PRIMARY KEY,
+          project_id TEXT NOT NULL,
+          name TEXT NOT NULL,
+          path TEXT NOT NULL,
+          is_primary INTEGER NOT NULL DEFAULT 0,
+          sort_order INTEGER NOT NULL DEFAULT 0,
+          FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_project_repositories_project ON project_repositories(project_id)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0014_add_hosts.ts

@@ -0,0 +1,23 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 14,
+  name: "add_hosts",
+  up: (db) => {
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS hosts (
+          id TEXT PRIMARY KEY,
+          name TEXT NOT NULL,
+          ssh_target TEXT NOT NULL,
+          sort_order INTEGER NOT NULL DEFAULT 0,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(
+      `ALTER TABLE projects ADD COLUMN host_id TEXT NOT NULL DEFAULT 'local'`
+    );
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN host_id TEXT NOT NULL DEFAULT 'local'`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0015_add_workspaces.ts

@@ -0,0 +1,18 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 15,
+  name: "add_workspaces",
+  up: (db) => {
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS workspaces (
+          id TEXT PRIMARY KEY,
+          name TEXT NOT NULL,
+          sort_order INTEGER NOT NULL DEFAULT 0,
+          collapsed INTEGER NOT NULL DEFAULT 0,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(`ALTER TABLE projects ADD COLUMN workspace_id TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0016_add_task_columns_to_sessions.ts

@@ -0,0 +1,13 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 16,
+  name: "add_task_columns_to_sessions",
+  up: (db) => {
+    db.exec(`ALTER TABLE sessions ADD COLUMN task_prompt TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN task_status TEXT`);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_sessions_task_status ON sessions(task_status)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0017_add_bus_messages.ts

@@ -0,0 +1,24 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 17,
+  name: "add_bus_messages",
+  up: (db) => {
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS bus_messages (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          from_id TEXT,
+          from_name TEXT NOT NULL,
+          to_id TEXT NOT NULL,
+          to_name TEXT NOT NULL,
+          body TEXT NOT NULL,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          delivered_at TEXT,
+          read_at TEXT
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_bus_to ON bus_messages(to_id, read_at)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0018_add_chat.ts

@@ -0,0 +1,23 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 18,
+  name: "add_chat",
+  up: (db) => {
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN view TEXT NOT NULL DEFAULT 'terminal'`
+    );
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS chat_items (
+          session_id TEXT NOT NULL,
+          item_id TEXT NOT NULL,
+          seq INTEGER NOT NULL,
+          data TEXT NOT NULL,
+          PRIMARY KEY (session_id, item_id)
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_chat_items_seq ON chat_items(session_id, seq)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0019_add_lumifyhub.ts

@@ -0,0 +1,36 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 19,
+  name: "add_lumifyhub",
+  up: (db) => {
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS lumifyhub_connection (
+          id INTEGER PRIMARY KEY CHECK (id = 1),
+          base_url TEXT NOT NULL,
+          token TEXT NOT NULL,
+          user_id TEXT,
+          user_email TEXT,
+          user_name TEXT,
+          connected_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS lumifyhub_connect_attempts (
+          state TEXT PRIMARY KEY,
+          verifier TEXT NOT NULL,
+          redirect_uri TEXT NOT NULL,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(`ALTER TABLE workspaces ADD COLUMN lh_workspace_id TEXT`);
+    db.exec(`ALTER TABLE workspaces ADD COLUMN lh_workspace_slug TEXT`);
+    db.exec(`ALTER TABLE workspaces ADD COLUMN lh_workspace_name TEXT`);
+    db.exec(`ALTER TABLE projects ADD COLUMN lh_board_id TEXT`);
+    db.exec(`ALTER TABLE projects ADD COLUMN lh_board_name TEXT`);
+    db.exec(`ALTER TABLE projects ADD COLUMN lh_board_page_id TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN lh_card_id TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN lh_board_id TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN lh_card_list TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0020_add_lumifyhub_published_docs.ts

@@ -0,0 +1,18 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 20,
+  name: "add_lumifyhub_published_docs",
+  up: (db) => {
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS lumifyhub_published_docs (
+          project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+          repo_path TEXT NOT NULL,
+          page_id TEXT NOT NULL,
+          content_hash TEXT NOT NULL,
+          published_at TEXT NOT NULL DEFAULT (datetime('now')),
+          PRIMARY KEY (project_id, repo_path)
+        )
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0021_add_chat_access.ts

@@ -0,0 +1,14 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 21,
+  name: "add_chat_access",
+  up: (db) => {
+    // What a chat agent may do without asking; full is the old behavior.
+    db.exec(
+      `ALTER TABLE sessions ADD COLUMN chat_access TEXT NOT NULL DEFAULT 'full'`
+    );
+    // After an undo, where the next start resumes the conversation from.
+    db.exec(`ALTER TABLE sessions ADD COLUMN chat_resume_at TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0022_add_last_seen.ts

@@ -0,0 +1,10 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 22,
+  name: "add_last_seen",
+  up: (db) => {
+    // When the reader last looked, so "needs you" means something new.
+    db.exec(`ALTER TABLE sessions ADD COLUMN last_seen_at TEXT`);
+  },
+} satisfies Migration;

package/lib/db/migrations/0023_mark_existing_sessions_seen.ts

@@ -0,0 +1,12 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 23,
+  name: "mark_existing_sessions_seen",
+  up: (db) => {
+    // Start quiet: what finished before "needs you" meant news is old news.
+    db.exec(
+      `UPDATE sessions SET last_seen_at = datetime('now') WHERE last_seen_at IS NULL`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0024_add_stacks.ts

@@ -0,0 +1,49 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 24,
+  name: "add_stacks",
+  up: (db) => {
+    // A LumifyHub board's cards run as stacked tasks (lib/stacks).
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS stacks (
+          id TEXT PRIMARY KEY,
+          project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+          lh_board_id TEXT NOT NULL,
+          name TEXT NOT NULL,
+          status TEXT NOT NULL DEFAULT 'running',
+          max_parallel INTEGER NOT NULL DEFAULT 3,
+          progress TEXT,
+          error TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          landed_at TEXT
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS stack_items (
+          id TEXT PRIMARY KEY,
+          stack_id TEXT NOT NULL REFERENCES stacks(id) ON DELETE CASCADE,
+          position INTEGER NOT NULL,
+          lh_card_id TEXT NOT NULL,
+          ticket TEXT,
+          title TEXT NOT NULL,
+          parent_item_id TEXT,
+          also_item_ids TEXT NOT NULL DEFAULT '[]',
+          blocker_item_ids TEXT NOT NULL DEFAULT '[]',
+          status TEXT NOT NULL DEFAULT 'planned',
+          session_id TEXT,
+          base_branch TEXT,
+          base_tip TEXT,
+          pr_number INTEGER,
+          note TEXT,
+          error TEXT
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_stack_items_stack ON stack_items(stack_id, position)`
+    );
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_stack_items_session ON stack_items(session_id)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0025_add_stack_item_attempts.ts

@@ -0,0 +1,16 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 25,
+  name: "add_stack_item_attempts",
+  up: (db) => {
+    // Starts retried after a transient failure, and holds the plan made
+    // (an open blocker outside the stack) that a retry must not undo.
+    db.exec(
+      `ALTER TABLE stack_items ADD COLUMN attempts INTEGER NOT NULL DEFAULT 0`
+    );
+    db.exec(
+      `ALTER TABLE stack_items ADD COLUMN held_outside INTEGER NOT NULL DEFAULT 0`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0026_add_workspace_orchestrator.ts

@@ -0,0 +1,47 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 26,
+  name: "add_workspace_orchestrator",
+  up: (db) => {
+    // One standing orchestrator chat per workspace. Its events are kept
+    // by key: a key present means that event is known, delivered or
+    // queued. An event is sent once seen on two diffs in a row (hits);
+    // a passing one that cleared is remembered (cleared_at) so it can't
+    // fire again too soon. The log counts deliveries per subject.
+    db.exec(`ALTER TABLE sessions ADD COLUMN role TEXT`);
+    db.exec(`ALTER TABLE sessions ADD COLUMN workspace_id TEXT`);
+    db.exec(
+      `CREATE UNIQUE INDEX IF NOT EXISTS idx_sessions_orchestrator
+         ON sessions(workspace_id) WHERE role = 'orchestrator'`
+    );
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_events (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          key TEXT NOT NULL,
+          subject TEXT,
+          line TEXT NOT NULL,
+          sticky INTEGER NOT NULL DEFAULT 1,
+          low INTEGER NOT NULL DEFAULT 0,
+          hits INTEGER NOT NULL DEFAULT 1,
+          created_at TEXT NOT NULL,
+          delivered_at TEXT,
+          cleared_at TEXT,
+          UNIQUE (workspace_id, key)
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_event_log (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          subject TEXT,
+          delivered_at TEXT NOT NULL
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_orchestrator_event_log
+         ON orchestrator_event_log(workspace_id, delivered_at)`
+    );
+  },
+} satisfies Migration;

package/lib/db/migrations/0027_add_devices_and_settings.ts

@@ -0,0 +1,28 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 27,
+  name: "add_devices_and_settings",
+  up: (db) => {
+    // Paired phones, tablets and laptops. Only a hash of each token is kept.
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS devices (
+          id TEXT PRIMARY KEY,
+          name TEXT NOT NULL,
+          token_hash TEXT NOT NULL UNIQUE,
+          user_agent TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          last_seen_at TEXT,
+          last_address TEXT,
+          revoked_at TEXT
+        )
+      `);
+    // Small app-wide switches (Wi-Fi access, pairing on the tailnet).
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS settings (
+          key TEXT PRIMARY KEY,
+          value TEXT NOT NULL
+        )
+      `);
+  },
+} satisfies Migration;

package/lib/db/migrations/0028_add_orchestrator_acting.ts

@@ -0,0 +1,70 @@
+import type { Migration } from "../migration-types";
+
+export default {
+  id: 28,
+  name: "add_orchestrator_acting",
+  up: (db) => {
+    // The orchestrator's brakes (settings per workspace, and the brake in
+    // force so it's noted once), its starts, its decision log, the reviews
+    // and scope checks it ran per commit, and gate failures per task.
+    db.exec(
+      `ALTER TABLE workspaces ADD COLUMN orch_max_running INTEGER NOT NULL DEFAULT 4`
+    );
+    db.exec(
+      `ALTER TABLE workspaces ADD COLUMN orch_max_starts_per_hour INTEGER NOT NULL DEFAULT 6`
+    );
+    db.exec(`ALTER TABLE workspaces ADD COLUMN orch_brake TEXT`);
+    // The secret an orchestrator's worker sends with each tool call.
+    db.exec(`ALTER TABLE sessions ADD COLUMN orch_token TEXT`);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_starts (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          target TEXT,
+          created_at TEXT NOT NULL
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_orchestrator_starts
+         ON orchestrator_starts(workspace_id, created_at)`
+    );
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_notes (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          kind TEXT NOT NULL DEFAULT 'note',
+          text TEXT NOT NULL,
+          created_at TEXT NOT NULL DEFAULT (datetime('now'))
+        )
+      `);
+    db.exec(
+      `CREATE INDEX IF NOT EXISTS idx_orchestrator_notes
+         ON orchestrator_notes(workspace_id, id)`
+    );
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_checks (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          workspace_id TEXT NOT NULL,
+          session_id TEXT NOT NULL,
+          sha TEXT NOT NULL,
+          kind TEXT NOT NULL,
+          status TEXT NOT NULL,
+          detail TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          UNIQUE (session_id, sha, kind)
+        )
+      `);
+    db.exec(`
+        CREATE TABLE IF NOT EXISTS orchestrator_gate_failures (
+          session_id TEXT NOT NULL,
+          gate TEXT NOT NULL,
+          workspace_id TEXT NOT NULL,
+          count INTEGER NOT NULL DEFAULT 0,
+          last_reason TEXT,
+          escalated_at TEXT,
+          PRIMARY KEY (session_id, gate)
+        )
+      `);
+  },
+} satisfies Migration;