@gavinc-cn/touchstone-dsh 0.1.1 → 0.3.0

package/backend/schema/fixtures/ancient.sql

@@ -0,0 +1,189 @@
+-- 由 tools/export_schema.py 从 db.py 生成，请勿手改。改 db.py 后重跑导出。
+-- 旧库夹具②：更老的年代
+
+CREATE TABLE users (
+    id INTEGER PRIMARY KEY,
+    username TEXT NOT NULL,
+    pass_hash TEXT NOT NULL,
+    salt TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    UNIQUE (username)
+);
+CREATE TABLE sessions (
+    token TEXT PRIMARY KEY,
+    user_id INTEGER NOT NULL,
+    created_at TEXT NOT NULL,
+    expires_at TEXT NOT NULL
+);
+CREATE TABLE projects (
+    id INTEGER PRIMARY KEY,
+    user_id INTEGER NOT NULL DEFAULT 0,
+    name TEXT NOT NULL,
+    project_dir TEXT NOT NULL,
+    agent_path TEXT NOT NULL DEFAULT '',
+    work_dir TEXT NOT NULL,
+    bug_dir TEXT NOT NULL,
+    guide_text TEXT NOT NULL DEFAULT '',
+    commit_spec TEXT NOT NULL DEFAULT '',
+    deploy_spec TEXT NOT NULL DEFAULT '',
+    env_label TEXT NOT NULL DEFAULT '',
+    created_at TEXT NOT NULL,
+    UNIQUE (name)
+);
+CREATE TABLE tasks (
+    id INTEGER PRIMARY KEY,
+    project_id INTEGER NOT NULL,
+    name TEXT NOT NULL,
+    auto_fix INTEGER NOT NULL DEFAULT 0,
+    retest TEXT NOT NULL DEFAULT '不复测',
+    stop_type TEXT NOT NULL DEFAULT 'rounds',
+    stop_value TEXT NOT NULL DEFAULT '1',
+    status TEXT NOT NULL DEFAULT 'queued',
+    session_id TEXT NOT NULL DEFAULT '',
+    current_round INTEGER NOT NULL DEFAULT 0,
+    new_bugs INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL,
+    started_at TEXT,
+    ended_at TEXT,
+    error TEXT NOT NULL DEFAULT ''
+);
+CREATE TABLE rounds (
+    id INTEGER PRIMARY KEY,
+    task_id INTEGER NOT NULL,
+    round_no INTEGER NOT NULL,
+    status TEXT NOT NULL DEFAULT 'running',
+    exit_code INTEGER,
+    log_path TEXT NOT NULL DEFAULT '',
+    started_at TEXT NOT NULL,
+    ended_at TEXT,
+    summary TEXT NOT NULL DEFAULT ''
+);
+CREATE TABLE board_cards (
+    id INTEGER PRIMARY KEY,
+    project_id INTEGER NOT NULL,
+    title TEXT NOT NULL,
+    description TEXT NOT NULL DEFAULT '',
+    column_key TEXT NOT NULL DEFAULT 'todo',
+    sort_order INTEGER NOT NULL DEFAULT 0,
+    session_id TEXT NOT NULL DEFAULT '',
+    sessions TEXT NOT NULL DEFAULT '[]',
+    block_kind TEXT,
+    block_text TEXT NOT NULL DEFAULT '',
+    parent_card_id INTEGER,
+    readonly INTEGER NOT NULL DEFAULT 0,
+    model TEXT NOT NULL DEFAULT '',
+    scheduled_at INTEGER,
+    jira_key TEXT NOT NULL DEFAULT '',
+    last_error TEXT NOT NULL DEFAULT '',
+    last_error_at INTEGER,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+);
+CREATE TABLE board_comments (
+    id INTEGER PRIMARY KEY,
+    card_id INTEGER NOT NULL,
+    text TEXT NOT NULL,
+    sent INTEGER NOT NULL DEFAULT 0,
+    session_id TEXT NOT NULL DEFAULT '',
+    sent_text TEXT NOT NULL DEFAULT '',
+    created_at TEXT NOT NULL
+);
+CREATE TABLE board_settings (
+    project_id INTEGER PRIMARY KEY,
+    json TEXT NOT NULL DEFAULT '{}'
+);
+CREATE TABLE app_settings (
+    key TEXT PRIMARY KEY,
+    json TEXT NOT NULL DEFAULT '{}'
+);
+CREATE TABLE user_prefs (
+    user_id INTEGER NOT NULL,
+    project_id INTEGER NOT NULL DEFAULT 0,
+    key TEXT NOT NULL,
+    value TEXT NOT NULL DEFAULT '{}',
+    updated_at TEXT NOT NULL,
+    PRIMARY KEY (user_id, project_id, key)
+);
+CREATE TABLE feishu_hooks (
+    project_id INTEGER PRIMARY KEY,
+    webhook_url TEXT NOT NULL DEFAULT '',
+    webhook_secret TEXT NOT NULL DEFAULT '',
+    events TEXT NOT NULL DEFAULT 'blocked_interaction,task_failed',
+    enabled INTEGER NOT NULL DEFAULT 1
+);
+CREATE TABLE feishu_outbox (
+    id INTEGER PRIMARY KEY,
+    target TEXT NOT NULL,
+    secret TEXT NOT NULL DEFAULT '',
+    payload TEXT NOT NULL,
+    status TEXT NOT NULL DEFAULT 'pending',
+    retries INTEGER NOT NULL DEFAULT 0,
+    next_at REAL NOT NULL DEFAULT 0,
+    dedup_key TEXT NOT NULL DEFAULT '',
+    last_error TEXT NOT NULL DEFAULT '',
+    created_at TEXT NOT NULL
+);
+CREATE TABLE feishu_user_cfgs (
+    user_id INTEGER PRIMARY KEY,
+    json TEXT NOT NULL DEFAULT '{}'
+);
+CREATE TABLE feishu_bindings (
+    open_id TEXT PRIMARY KEY,
+    user_id INTEGER NOT NULL,
+    default_project_id INTEGER NOT NULL DEFAULT 0,
+    bound_at TEXT NOT NULL DEFAULT (datetime('now', 'localtime')),
+    UNIQUE (user_id)
+);
+CREATE TABLE wait_items (
+    id INTEGER PRIMARY KEY,
+    project_id INTEGER NOT NULL,
+    kind TEXT NOT NULL,
+    target_id TEXT NOT NULL,
+    state TEXT NOT NULL DEFAULT 'waiting',
+    seq INTEGER NOT NULL,
+    created_at TEXT NOT NULL,
+    claimed_at TEXT,
+    claimed_by TEXT,
+    ended_at TEXT,
+    not_before REAL NOT NULL DEFAULT 0,
+    retries INTEGER NOT NULL DEFAULT 0,
+    meta TEXT NOT NULL DEFAULT '{}'
+);
+CREATE TABLE chat_msgs (
+    id TEXT PRIMARY KEY,
+    project_id INTEGER NOT NULL,
+    sid TEXT NOT NULL,
+    task_id INTEGER,
+    card_id INTEGER,
+    message TEXT NOT NULL,
+    state TEXT NOT NULL,
+    error TEXT NOT NULL DEFAULT '',
+    inject INTEGER NOT NULL DEFAULT 0,
+    created_at INTEGER NOT NULL,
+    started_at INTEGER,
+    ended_at INTEGER
+);
+CREATE TABLE leases (
+    id        INTEGER PRIMARY KEY AUTOINCREMENT,
+    kind      TEXT NOT NULL,
+    target_id TEXT NOT NULL,
+    acquired  REAL NOT NULL DEFAULT 0,
+    note      TEXT NOT NULL DEFAULT '{}'
+);
+CREATE INDEX idx_leases_project ON leases(target_id);
+CREATE INDEX idx_tasks_project ON tasks(project_id);
+CREATE INDEX idx_rounds_task ON rounds(task_id);
+CREATE INDEX idx_board_cards_project ON board_cards(project_id);
+CREATE INDEX idx_board_comments_card ON board_comments(card_id);
+CREATE UNIQUE INDEX idx_wait_active ON wait_items(kind, target_id) WHERE state IN ('waiting','claimed','running','finishing');
+CREATE INDEX idx_wait_pick ON wait_items(state, project_id, seq);
+CREATE INDEX idx_chat_msgs_sid ON chat_msgs(sid, created_at);
+
+-- 种子数据
+INSERT INTO users(id, username, pass_hash, salt, created_at) VALUES(1, 'admin', 'd41d8cd98f00b204e9800998ecf8427e', '', '2026-01-01 00:00:00');
+INSERT INTO projects(id, name, project_dir, work_dir, bug_dir, commit_spec, deploy_spec, created_at, user_id) VALUES(1, 'proj_one', '/tmp/ts-fixture/proj', '/tmp/ts-fixture/proj/free_style', '/tmp/ts-fixture/proj/free_style/bug_report', 'fix: 老规范', '部署：老说明', '2026-01-01 00:00:00', 0);
+INSERT INTO tasks(id, project_id, name, created_at) VALUES(1, 1, 't1', '2026-01-01 00:00:00');
+INSERT INTO board_cards(updated_at, id, project_id, title, created_at, column_key, block_kind, block_text, last_error) VALUES('x', 1, 1, 'legacy card', '2026-01-01 00:00:00', 'blocked', 'queue', '提交中：老机器文案', '阻塞让行提交失败 x');
+INSERT INTO wait_items(seq, created_at, kind, target_id, project_id, state) VALUES(0, 'x', 'card', 'c:1', 1, 'claimed');
+INSERT INTO leases(kind, target_id) VALUES('card', 'c:old');
+INSERT INTO app_settings(key, json) VALUES('feishu', '{"app_id": "cli_legacy", "app_secret": "sec_legacy", "base_url": "https://open.feishu.cn"}');

package/backend/schema/fixtures/pre_alter.sql

@@ -0,0 +1,177 @@
+-- 由 tools/export_schema.py 从 db.py 生成，请勿手改。改 db.py 后重跑导出。
+-- 旧库夹具①：缺 ALTER 补列
+
+CREATE TABLE users (
+    id INTEGER PRIMARY KEY,
+    username TEXT NOT NULL,
+    pass_hash TEXT NOT NULL,
+    salt TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    UNIQUE (username)
+);
+CREATE TABLE sessions (
+    token TEXT PRIMARY KEY,
+    user_id INTEGER NOT NULL,
+    created_at TEXT NOT NULL,
+    expires_at TEXT NOT NULL
+);
+CREATE TABLE projects (
+    id INTEGER PRIMARY KEY,
+    user_id INTEGER NOT NULL DEFAULT 0,
+    name TEXT NOT NULL,
+    project_dir TEXT NOT NULL,
+    agent_path TEXT NOT NULL DEFAULT '',
+    work_dir TEXT NOT NULL,
+    bug_dir TEXT NOT NULL,
+    guide_text TEXT NOT NULL DEFAULT '',
+    commit_spec TEXT NOT NULL DEFAULT '',
+    deploy_spec TEXT NOT NULL DEFAULT '',
+    env_label TEXT NOT NULL DEFAULT '',
+    created_at TEXT NOT NULL
+);
+CREATE TABLE tasks (
+    id INTEGER PRIMARY KEY,
+    project_id INTEGER NOT NULL,
+    name TEXT NOT NULL,
+    auto_fix INTEGER NOT NULL DEFAULT 0,
+    retest TEXT NOT NULL DEFAULT '不复测',
+    stop_type TEXT NOT NULL DEFAULT 'rounds',
+    stop_value TEXT NOT NULL DEFAULT '1',
+    status TEXT NOT NULL DEFAULT 'queued',
+    session_id TEXT NOT NULL DEFAULT '',
+    current_round INTEGER NOT NULL DEFAULT 0,
+    new_bugs INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL,
+    started_at TEXT,
+    ended_at TEXT,
+    error TEXT NOT NULL DEFAULT ''
+);
+CREATE TABLE rounds (
+    id INTEGER PRIMARY KEY,
+    task_id INTEGER NOT NULL,
+    round_no INTEGER NOT NULL,
+    status TEXT NOT NULL DEFAULT 'running',
+    exit_code INTEGER,
+    log_path TEXT NOT NULL DEFAULT '',
+    started_at TEXT NOT NULL,
+    ended_at TEXT,
+    summary TEXT NOT NULL DEFAULT ''
+);
+CREATE TABLE board_cards (
+    id INTEGER PRIMARY KEY,
+    project_id INTEGER NOT NULL,
+    title TEXT NOT NULL,
+    description TEXT NOT NULL DEFAULT '',
+    column_key TEXT NOT NULL DEFAULT 'todo',
+    sort_order INTEGER NOT NULL DEFAULT 0,
+    session_id TEXT NOT NULL DEFAULT '',
+    sessions TEXT NOT NULL DEFAULT '[]',
+    block_kind TEXT,
+    block_text TEXT NOT NULL DEFAULT '',
+    parent_card_id INTEGER,
+    readonly INTEGER NOT NULL DEFAULT 0,
+    model TEXT NOT NULL DEFAULT '',
+    scheduled_at INTEGER,
+    jira_key TEXT NOT NULL DEFAULT '',
+    last_error TEXT NOT NULL DEFAULT '',
+    last_error_at INTEGER,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+);
+CREATE TABLE board_comments (
+    id INTEGER PRIMARY KEY,
+    card_id INTEGER NOT NULL,
+    text TEXT NOT NULL,
+    sent INTEGER NOT NULL DEFAULT 0,
+    session_id TEXT NOT NULL DEFAULT '',
+    sent_text TEXT NOT NULL DEFAULT '',
+    created_at TEXT NOT NULL
+);
+CREATE TABLE board_settings (
+    project_id INTEGER PRIMARY KEY,
+    json TEXT NOT NULL DEFAULT '{}'
+);
+CREATE TABLE app_settings (
+    key TEXT PRIMARY KEY,
+    json TEXT NOT NULL DEFAULT '{}'
+);
+CREATE TABLE user_prefs (
+    user_id INTEGER NOT NULL,
+    project_id INTEGER NOT NULL DEFAULT 0,
+    key TEXT NOT NULL,
+    value TEXT NOT NULL DEFAULT '{}',
+    updated_at TEXT NOT NULL,
+    PRIMARY KEY (user_id, project_id, key)
+);
+CREATE TABLE feishu_hooks (
+    project_id INTEGER PRIMARY KEY,
+    webhook_url TEXT NOT NULL DEFAULT '',
+    webhook_secret TEXT NOT NULL DEFAULT '',
+    events TEXT NOT NULL DEFAULT 'blocked_interaction,task_failed',
+    enabled INTEGER NOT NULL DEFAULT 1
+);
+CREATE TABLE feishu_outbox (
+    id INTEGER PRIMARY KEY,
+    target TEXT NOT NULL,
+    secret TEXT NOT NULL DEFAULT '',
+    payload TEXT NOT NULL,
+    status TEXT NOT NULL DEFAULT 'pending',
+    retries INTEGER NOT NULL DEFAULT 0,
+    next_at REAL NOT NULL DEFAULT 0,
+    dedup_key TEXT NOT NULL DEFAULT '',
+    last_error TEXT NOT NULL DEFAULT '',
+    created_at TEXT NOT NULL
+);
+CREATE TABLE feishu_user_cfgs (
+    user_id INTEGER PRIMARY KEY,
+    json TEXT NOT NULL DEFAULT '{}'
+);
+CREATE TABLE feishu_bindings (
+    open_id TEXT PRIMARY KEY,
+    user_id INTEGER NOT NULL,
+    default_project_id INTEGER NOT NULL DEFAULT 0,
+    bound_at TEXT NOT NULL DEFAULT (datetime('now', 'localtime')),
+    UNIQUE (user_id)
+);
+CREATE TABLE wait_items (
+    id INTEGER PRIMARY KEY,
+    project_id INTEGER NOT NULL,
+    kind TEXT NOT NULL,
+    target_id TEXT NOT NULL,
+    state TEXT NOT NULL DEFAULT 'waiting',
+    seq INTEGER NOT NULL,
+    created_at TEXT NOT NULL,
+    claimed_at TEXT,
+    claimed_by TEXT,
+    ended_at TEXT,
+    not_before REAL NOT NULL DEFAULT 0,
+    retries INTEGER NOT NULL DEFAULT 0,
+    meta TEXT NOT NULL DEFAULT '{}'
+);
+CREATE TABLE chat_msgs (
+    id TEXT PRIMARY KEY,
+    project_id INTEGER NOT NULL,
+    sid TEXT NOT NULL,
+    task_id INTEGER,
+    card_id INTEGER,
+    message TEXT NOT NULL,
+    state TEXT NOT NULL,
+    error TEXT NOT NULL DEFAULT '',
+    inject INTEGER NOT NULL DEFAULT 0,
+    created_at INTEGER NOT NULL,
+    started_at INTEGER,
+    ended_at INTEGER
+);
+CREATE INDEX idx_tasks_project ON tasks(project_id);
+CREATE INDEX idx_rounds_task ON rounds(task_id);
+CREATE INDEX idx_board_cards_project ON board_cards(project_id);
+CREATE INDEX idx_board_comments_card ON board_comments(card_id);
+CREATE UNIQUE INDEX idx_wait_active ON wait_items(kind, target_id) WHERE state IN ('waiting','claimed','running','finishing');
+CREATE INDEX idx_wait_pick ON wait_items(state, project_id, seq);
+CREATE INDEX idx_chat_msgs_sid ON chat_msgs(sid, created_at);
+
+-- 种子数据
+INSERT INTO users(id, username, pass_hash, salt, created_at) VALUES(1, 'admin', 'd41d8cd98f00b204e9800998ecf8427e', '', '2026-01-01 00:00:00');
+INSERT INTO projects(id, name, project_dir, work_dir, bug_dir, commit_spec, deploy_spec, created_at, user_id) VALUES(1, 'proj_one', '/tmp/ts-fixture/proj', '/tmp/ts-fixture/proj', '', '', '', '2026-01-01 00:00:00', 1);
+INSERT INTO tasks(id, project_id, name, created_at) VALUES(1, 1, 't1', '2026-01-01 00:00:00');
+INSERT INTO board_cards(updated_at, id, project_id, title, created_at, column_key) VALUES('x', 1, 1, 'legacy card', '2026-01-01 00:00:00', 'todo');

package/backend/schema/migrations.json

@@ -0,0 +1,154 @@
+{
+  "format": 1,
+  "schemaVersion": 1,
+  "generatedBy": "tools/export_schema.py",
+  "note": "数据级/结构重建迁移：两版执行**同一份**清单。when=null 表示无条件执行（语句自身幂等）；kind=rows 的 sql 是只读 SELECT，返回 ≥1 行才执行；kind=index_origin_unique 表示表上存在 UNIQUE 约束索引才执行。handler 需宿主语言实现（未知 handler 必须报错退出，不得静默跳过）。",
+  "guards": {
+    "rows": "SELECT 返回 ≥1 行才执行该步",
+    "index_origin_unique": "PRAGMA index_list(表) 里存在 origin='u' 的索引才执行"
+  },
+  "handlers": {
+    "projects_guide_text_merge": "废弃列 commit_spec/deploy_spec 的内容并入 guide_text 后清空两列",
+    "projects_work_dir_from_legacy_cases_root": "工作目录化：旧 work_dir（案例库根）改存工作目录，bug_dir 列废弃置空",
+    "feishu_appsettings_bridge": "飞书配置用户级化：旧全局 app_settings['feishu'] 迁给 admin 的用户级配置"
+  },
+  "handlerImpl": {
+    "python": "db.py MIGRATION_HANDLERS",
+    "node": "backend/lib/db.js HANDLERS"
+  },
+  "steps": [
+    {
+      "id": "2026-09-04_projects_guide_text_merge",
+      "desc": "废弃列 commit_spec/deploy_spec 的内容并入 guide_text 后清空两列",
+      "when": {
+        "kind": "rows",
+        "sql": "SELECT 1 FROM projects WHERE trim(coalesce(commit_spec,'')) != '' OR trim(coalesce(deploy_spec,'')) != '' LIMIT 1"
+      },
+      "handler": "projects_guide_text_merge"
+    },
+    {
+      "id": "2026-09-04_projects_user_id_backfill",
+      "desc": "多用户隔离：存量项目（user_id=0）归 admin",
+      "when": {
+        "kind": "rows",
+        "sql": "SELECT 1 FROM projects WHERE user_id=0 LIMIT 1"
+      },
+      "sql": [
+        "UPDATE projects SET user_id= COALESCE((SELECT id FROM users WHERE username='admin'), 0) WHERE user_id=0"
+      ]
+    },
+    {
+      "id": "2026-09-13_board_cards_clear_commit_block_text",
+      "desc": "阻塞让行提交退场：清理存量卡片上的机器文案 block_text",
+      "when": {
+        "kind": "rows",
+        "sql": "SELECT 1 FROM board_cards WHERE block_text LIKE '提交中：%' OR block_text LIKE '提交失败：%' LIMIT 1"
+      },
+      "sql": [
+        "UPDATE board_cards SET block_text='' WHERE block_text LIKE '提交中：%' OR block_text LIKE '提交失败：%'"
+      ]
+    },
+    {
+      "id": "2026-09-13_board_cards_clear_commit_errors",
+      "desc": "阻塞让行提交退场：清理存量卡片上的提交失败 last_error",
+      "when": {
+        "kind": "rows",
+        "sql": "SELECT 1 FROM board_cards WHERE last_error LIKE '阻塞让行提交失败%' OR last_error LIKE '阻塞让行提交异常%' LIMIT 1"
+      },
+      "sql": [
+        "UPDATE board_cards SET last_error='', last_error_at=NULL WHERE last_error LIKE '阻塞让行提交失败%'    OR last_error LIKE '阻塞让行提交异常%'"
+      ]
+    },
+    {
+      "id": "2026-09-04_projects_drop_global_unique_name",
+      "desc": "旧库 projects.name 全局 UNIQUE → (user_id,name) 用户内唯一：重建表",
+      "when": {
+        "kind": "index_origin_unique",
+        "table": "projects"
+      },
+      "sql": [
+        "ALTER TABLE projects RENAME TO projects_old",
+        "CREATE TABLE projects (\n    id          INTEGER PRIMARY KEY AUTOINCREMENT,\n    user_id     INTEGER NOT NULL DEFAULT 0,\n    name        TEXT NOT NULL,\n    project_dir TEXT NOT NULL,\n    agent_path  TEXT NOT NULL DEFAULT '',\n    work_dir    TEXT NOT NULL,\n    bug_dir     TEXT NOT NULL,\n    guide_text  TEXT NOT NULL DEFAULT '',\n    commit_spec TEXT NOT NULL DEFAULT '',\n    deploy_spec TEXT NOT NULL DEFAULT '',\n    env_label   TEXT NOT NULL DEFAULT '',\n    created_at  TEXT NOT NULL\n)",
+        "INSERT INTO projects(id, user_id, name, project_dir, agent_path, work_dir, bug_dir,\n                     guide_text, commit_spec, deploy_spec, env_label, created_at)\nSELECT id, user_id, name, project_dir, agent_path, work_dir, bug_dir,\n       guide_text, commit_spec, deploy_spec, env_label, created_at\nFROM projects_old",
+        "DROP TABLE projects_old"
+      ]
+    },
+    {
+      "id": "2026-09-04_projects_user_name_unique_index",
+      "desc": "补建用户内唯一索引 idx_projects_user_name（重建之后执行）",
+      "when": null,
+      "sql": [
+        "CREATE UNIQUE INDEX IF NOT EXISTS idx_projects_user_name ON projects(user_id, name)"
+      ]
+    },
+    {
+      "id": "2026-08-30_projects_work_dir_from_legacy_cases_root",
+      "desc": "工作目录化：旧 work_dir（案例库根）改存工作目录，bug_dir 列废弃置空",
+      "when": {
+        "kind": "rows",
+        "sql": "SELECT 1 FROM projects WHERE bug_dir != '' LIMIT 1"
+      },
+      "handler": "projects_work_dir_from_legacy_cases_root"
+    },
+    {
+      "id": "2026-09-19_board_cards_queue_state_doing",
+      "desc": "P4 排队占位单态化：blocked+queue 归位 doing+queue",
+      "when": {
+        "kind": "rows",
+        "sql": "SELECT 1 FROM board_cards WHERE block_kind='queue' AND column_key='blocked' LIMIT 1"
+      },
+      "sql": [
+        "UPDATE board_cards SET column_key='doing' WHERE block_kind='queue' AND column_key='blocked'"
+      ]
+    },
+    {
+      "id": "2026-09-09_feishu_appsettings_bridge",
+      "desc": "飞书配置用户级化：旧全局 app_settings['feishu'] 迁给 admin 的用户级配置",
+      "when": {
+        "kind": "rows",
+        "sql": "SELECT 1 FROM app_settings WHERE key='feishu' LIMIT 1"
+      },
+      "handler": "feishu_appsettings_bridge"
+    },
+    {
+      "id": "2026-09-24_drop_leases",
+      "desc": "v3d 租约层删除：DROP 存量 leases 表与索引（幂等）",
+      "when": null,
+      "sql": [
+        "DROP TABLE IF EXISTS leases",
+        "DROP INDEX IF EXISTS idx_leases_project"
+      ]
+    },
+    {
+      "id": "2026-09-21_wait_items_claimed_to_starting",
+      "desc": "v2a 状态机扩七枚举：claimed 行归一 starting",
+      "when": {
+        "kind": "rows",
+        "sql": "SELECT 1 FROM wait_items WHERE state='claimed' LIMIT 1"
+      },
+      "sql": [
+        "UPDATE wait_items SET state='starting' WHERE state='claimed'"
+      ]
+    },
+    {
+      "id": "2026-09-21_wait_items_rebuild_active_index",
+      "desc": "活跃唯一索引口径扩到四活跃态（旧库 WHERE 仍含 claimed 时重建）",
+      "when": {
+        "kind": "rows",
+        "sql": "SELECT 1 FROM sqlite_master WHERE type='index' AND name='idx_wait_active' AND coalesce(sql,'') NOT LIKE '%''starting''%' LIMIT 1"
+      },
+      "sql": [
+        "DROP INDEX idx_wait_active",
+        "CREATE UNIQUE INDEX idx_wait_active ON wait_items(kind, target_id) WHERE state IN ('waiting','starting','running','finishing')"
+      ]
+    },
+    {
+      "id": "2026-10-11_schema_version_stamp",
+      "desc": "M1：把 schema 版本号写入 app_settings['schema_version']（两侧对拍前置断言）",
+      "when": null,
+      "sql": [
+        "INSERT INTO app_settings(key, json) VALUES('schema_version', '1') ON CONFLICT(key) DO UPDATE SET json=excluded.json"
+      ]
+    }
+  ]
+}