@konglx/rotom 2.21.0

package/dist/master/db/groups.js

@@ -0,0 +1,316 @@
+import { nowBeijing, shiftBeijing } from "../../shared/time.js";
+// 内部 helper:执行 SELECT 群消息 + LEFT JOIN chat_message_prompts,
+// 拼装成 GroupMessageRow[](剥掉 layers/final/generated_at/prompt_version
+// 四个字符串列,组装成 composed_prompt 对象)。whereClause 由调用方提供,
+// 绑定参数顺序为 groupId,然后再是 LIMIT 值(如果有的话)。
+//
+// module-level 而非 groupMethods 上的方法,因为只有 getGroupMessages 在用,
+// 放在 self 上反而需要扩展 MeshDbSelf interface。
+function fetchGroupMessageRows(db, whereClause, groupId, ...bindParams) {
+    const sql = `SELECT m.id, m.sender, m.content, m.mentions, m.created_at, m.cancelled_at,
+                 p.layers, p.final, p.generated_at, p.prompt_version
+          FROM group_messages m
+          LEFT JOIN chat_message_prompts p ON p.group_message_id = m.id
+          ${whereClause}`;
+    const rows = db.prepare(sql).all(groupId, ...bindParams);
+    return rows.map((r) => {
+        let composed_prompt = null;
+        if (r.layers && r.final && r.generated_at && r.prompt_version) {
+            composed_prompt = {
+                layers: JSON.parse(r.layers),
+                final: r.final,
+                generated_at: r.generated_at,
+                prompt_version: r.prompt_version,
+            };
+        }
+        return {
+            id: r.id, sender: r.sender, content: r.content, mentions: r.mentions, created_at: r.created_at,
+            cancelled_at: r.cancelled_at,
+            composed_prompt,
+        };
+    });
+}
+export const groupMethods = {
+    createGroup(id, name, createdBy, workingDir) {
+        this.db.prepare("INSERT INTO groups (id, name, created_by, working_dir) VALUES (?, ?, ?, ?)").run(id, name, createdBy || null, workingDir || null);
+    },
+    updateGroupWorkingDir(id, workingDir) {
+        this.db.prepare("UPDATE groups SET working_dir = ? WHERE id = ?")
+            .run(workingDir, id);
+    },
+    updateGroupName(id, name) {
+        this.db.prepare("UPDATE groups SET name = ? WHERE id = ?")
+            .run(name, id);
+    },
+    /**
+     * Toggle (or set explicitly) the per-group pinned_at timestamp.
+     * Passing `null` unpins; passing a value pins to "now" (UTC string).
+     */
+    updateGroupPinned(id, pinned) {
+        const next = pinned ? nowBeijing() : null;
+        this.db.prepare("UPDATE groups SET pinned_at = ? WHERE id = ?")
+            .run(next, id);
+        return next;
+    },
+    /**
+     * Archive or unarchive a group. Archived groups are read-only: no new messages,
+     * issues. Passing `true` sets archived_at to "now";
+     * passing `false` clears it.
+     */
+    updateGroupArchived(id, archived) {
+        const next = archived ? nowBeijing() : null;
+        this.db.prepare("UPDATE groups SET archived_at = ? WHERE id = ?")
+            .run(next, id);
+        return next;
+    },
+    /**
+     * Returns the archived_at value of a group, or null if not archived.
+     */
+    isGroupArchived(id) {
+        const row = this.db.prepare("SELECT archived_at FROM groups WHERE id = ?").get(id);
+        return row?.archived_at ?? null;
+    },
+    /**
+     * Toggle (or set explicitly) the per-group starred_at timestamp.
+     * Starred groups are "重要少用":可读可写,只是侧栏分层展示。
+     * Passing `null` unstars; passing a value stars to "now" (北京时间字符串)。
+     */
+    updateGroupStarred(id, starred) {
+        const next = starred ? nowBeijing() : null;
+        this.db.prepare("UPDATE groups SET starred_at = ? WHERE id = ?")
+            .run(next, id);
+        return next;
+    },
+    /**
+     * Returns the starred_at value of a group, or null if not starred.
+     */
+    isGroupStarred(id) {
+        const row = this.db.prepare("SELECT starred_at FROM groups WHERE id = ?").get(id);
+        return row?.starred_at ?? null;
+    },
+    /**
+     * Backfill working_dir on legacy groups (NULL or empty). Caller supplies the
+     * `compute` fn — kept out of db.ts so this module stays free of filesystem
+     * conventions (homedir, ARTIFACTS_ROOT, etc.). Returns the list of (id, path)
+     * pairs that were written, so the caller can mkdir each one.
+     */
+    backfillGroupDefaultWorkingDir(compute) {
+        const rows = this.db.prepare("SELECT id FROM groups WHERE working_dir IS NULL OR working_dir = ''").all();
+        if (rows.length === 0)
+            return [];
+        const update = this.db.prepare("UPDATE groups SET working_dir = ? WHERE id = ?");
+        const filled = [];
+        const tx = this.db.transaction((items) => {
+            for (const { id } of items) {
+                const wd = compute(id);
+                update.run(wd, id);
+                filled.push({ id, workingDir: wd });
+            }
+        });
+        tx(rows);
+        return filled;
+    },
+    listGroups() {
+        return this.db.prepare(`
+      SELECT g.*, COUNT(gm.agent_name) as member_count,
+             (SELECT MAX(m.created_at) FROM group_messages m WHERE m.group_id = g.id) AS last_message_at
+      FROM groups g
+      LEFT JOIN group_members gm ON g.id = gm.group_id
+      GROUP BY g.id
+      ORDER BY g.created_at DESC
+    `).all();
+    },
+    listGroupsWithMembers() {
+        const groups = this.listGroups();
+        const rows = this.db.prepare(`
+      SELECT gm.group_id, gm.agent_name, gm.joined_at, gms.working_dir, gms.profile
+      FROM group_members gm
+      LEFT JOIN group_member_settings gms
+        ON gms.group_id = gm.group_id AND gms.agent_name = gm.agent_name
+      ORDER BY gm.joined_at
+    `).all();
+        const byGroup = new Map();
+        for (const r of rows) {
+            let list = byGroup.get(r.group_id);
+            if (!list) {
+                list = [];
+                byGroup.set(r.group_id, list);
+            }
+            list.push({ agent_name: r.agent_name, joined_at: r.joined_at, working_dir: r.working_dir, profile: r.profile });
+        }
+        return groups.map((g) => ({ ...g, members: byGroup.get(g.id) ?? [] }));
+    },
+    getGroupById(id) {
+        return this.db.prepare("SELECT * FROM groups WHERE id = ?").get(id);
+    },
+    deleteGroup(id) {
+        this.db.prepare("DELETE FROM group_messages WHERE group_id = ?").run(id);
+        this.db.prepare("DELETE FROM group_member_settings WHERE group_id = ?").run(id);
+        this.db.prepare("DELETE FROM group_members WHERE group_id = ?").run(id);
+        this.db.prepare("DELETE FROM groups WHERE id = ?").run(id);
+    },
+    /** Create group with type and metadata (for e2ed integration) */
+    createGroupTyped(opts) {
+        this.db.prepare("INSERT INTO groups (id, name, created_by, working_dir, type, metadata) VALUES (?, ?, ?, ?, ?, ?)").run(opts.id, opts.name, opts.createdBy || null, opts.workingDir || null, opts.type, opts.metadata || '{}');
+    },
+    /** Get group by id including type and metadata columns */
+    getGroupByIdFull(id) {
+        return this.db.prepare("SELECT * FROM groups WHERE id = ?").get(id);
+    },
+    /** List groups filtered by type */
+    listGroupsByType(type) {
+        return this.db.prepare("SELECT id, name, created_by, created_at, working_dir, type, metadata FROM groups WHERE type = ? ORDER BY created_at DESC").all(type);
+    },
+    /** Update group metadata JSON */
+    updateGroupMetadata(id, metadata) {
+        this.db.prepare("UPDATE groups SET metadata = ? WHERE id = ?").run(metadata, id);
+    },
+    /** 群级别指导 prompt;传 null/空串清空。 */
+    updateGroupGuidancePrompt(id, prompt) {
+        const v = prompt && prompt.trim() ? prompt : null;
+        this.db.prepare("UPDATE groups SET guidance_prompt = ? WHERE id = ?").run(v, id);
+    },
+    /**
+     * 更新群的内置 repo 配置(migration 051)。
+     *
+     * - repoUrl 为空串/null:清空 repo_url,该 group 回退现状(无 worktree)
+     * - extraReposJson 为空串/null:清空 extra_repos
+     * - 三列独立更新,避免一次只想改 defaultBranch 时把 url 也清掉
+     */
+    updateGroupRepo(id, repoUrl, repoDefaultBranch, extraReposJson, worktreeMode) {
+        const mode = worktreeMode === "issue" ? "issue" : "group";
+        this.db.prepare("UPDATE groups SET repo_url = ?, repo_default_branch = ?, extra_repos = ?, worktree_mode = ? WHERE id = ?").run(repoUrl || null, repoDefaultBranch || null, extraReposJson || null, mode, id);
+    },
+    addGroupMembers(groupId, agentNames) {
+        const stmt = this.db.prepare("INSERT OR IGNORE INTO group_members (group_id, agent_name) VALUES (?, ?)");
+        for (const name of agentNames) {
+            stmt.run(groupId, name);
+        }
+    },
+    removeGroupMembers(groupId, agentNames) {
+        const tx = this.db.transaction((names) => {
+            const m = this.db.prepare("DELETE FROM group_members WHERE group_id = ? AND agent_name = ?");
+            const s = this.db.prepare("DELETE FROM group_member_settings WHERE group_id = ? AND agent_name = ?");
+            for (const name of names) {
+                m.run(groupId, name);
+                s.run(groupId, name);
+            }
+        });
+        tx(agentNames);
+    },
+    getGroupMembers(groupId) {
+        return this.db.prepare(`
+      SELECT gm.agent_name, gm.joined_at, gms.working_dir, gms.profile
+      FROM group_members gm
+      LEFT JOIN group_member_settings gms
+        ON gms.group_id = gm.group_id AND gms.agent_name = gm.agent_name
+      WHERE gm.group_id = ?
+      ORDER BY gm.joined_at
+    `).all(groupId);
+    },
+    getGroupMemberSetting(groupId, agentName) {
+        const row = this.db.prepare("SELECT working_dir FROM group_member_settings WHERE group_id = ? AND agent_name = ?").get(groupId, agentName);
+        // working_dir 列是 NOT NULL(migration 020);空串表示"只设了 profile,没有
+        // working_dir 覆盖",归一化为 null 让上层 falsy 判断正常工作。
+        const v = row?.working_dir;
+        return v && v.length > 0 ? v : null;
+    },
+    listGroupMemberSettings(groupId) {
+        return this.db.prepare("SELECT agent_name, working_dir, updated_at, profile FROM group_member_settings WHERE group_id = ? ORDER BY agent_name").all(groupId);
+    },
+    getGroupMemberProfile(groupId, agentName) {
+        const row = this.db.prepare("SELECT profile FROM group_member_settings WHERE group_id = ? AND agent_name = ?").get(groupId, agentName);
+        return row?.profile ?? null;
+    },
+    upsertGroupMemberProfile(groupId, agentName, profileJson) {
+        // 群级别 profile 覆盖单独存一列。若该 (group, agent) 还没有 settings 行,
+        // INSERT 一行 working_dir=''(NOT NULL 兜底,getGroupMemberSetting 归一化为
+        // null 表示无覆盖)再写 profile; 若已有行, UPDATE profile 列(不动 working_dir)。
+        this.db.prepare(`
+      INSERT INTO group_member_settings (group_id, agent_name, working_dir, profile, updated_at)
+      VALUES (?, ?, '', ?, ?)
+      ON CONFLICT(group_id, agent_name) DO UPDATE SET
+        profile     = excluded.profile,
+        updated_at  = excluded.updated_at
+    `).run(groupId, agentName, profileJson, nowBeijing());
+    },
+    upsertGroupMemberSetting(groupId, agentName, workingDir) {
+        this.db.prepare(`
+      INSERT INTO group_member_settings (group_id, agent_name, working_dir, updated_at)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT(group_id, agent_name) DO UPDATE SET
+        working_dir = excluded.working_dir,
+        updated_at  = excluded.updated_at
+    `).run(groupId, agentName, workingDir, nowBeijing());
+    },
+    clearGroupMemberSetting(groupId, agentName) {
+        const result = this.db.prepare("DELETE FROM group_member_settings WHERE group_id = ? AND agent_name = ?").run(groupId, agentName);
+        return result.changes > 0;
+    },
+    addGroupMessage(groupId, sender, content, mentions = [], options) {
+        const result = this.db.prepare("INSERT INTO group_messages (group_id, sender, content, mentions, cancelled_at) VALUES (?, ?, ?, ?, ?)").run(groupId, sender, content, JSON.stringify(mentions), options?.cancelledAt ?? null);
+        return Number(result.lastInsertRowid);
+    },
+    /**
+     * 把 worker 算出的 ComposedPrompt 持久化到 chat_message_prompts,keyed by
+     * group_messages.id。Dashboard 点击消息时读这张表渲染分层组成。
+     */
+    addChatMessagePrompt(groupMessageId, layersJson, final, generatedAt, promptVersion) {
+        this.db.prepare(`INSERT INTO chat_message_prompts (group_message_id, layers, final, generated_at, prompt_version)
+       VALUES (?, ?, ?, ?, ?)`).run(groupMessageId, layersJson, final, generatedAt, promptVersion);
+    },
+    getChatMessagePrompt(groupMessageId) {
+        const row = this.db.prepare(`SELECT layers, final, generated_at, prompt_version
+       FROM chat_message_prompts WHERE group_message_id = ?`).get(groupMessageId);
+        if (!row)
+            return null;
+        return {
+            layers: JSON.parse(row.layers),
+            final: row.final,
+            generated_at: row.generated_at,
+            prompt_version: row.prompt_version,
+        };
+    },
+    // 内部 helper:执行 SELECT 群消息 + LEFT JOIN chat_message_prompts,
+    // 拼装成 GroupMessageRow[](剥掉 layers/final/generated_at/prompt_version
+    // 四个字符串列,组装成 composed_prompt 对象)。whereClause 由调用方提供,
+    // 绑定参数顺序为 groupId,然后再是 LIMIT 值(如果有的话)。
+    // 拉取群消息。和 getIssueEvents 同款 head+tail+marker 思路:
+    //   - 总数 <= headKeep+tailKeep:全拿(ASC)。
+    //   - 总数超过:head(最早 headKeep 条) + tail(最新 tailKeep 条) + 中间合成一条
+    //     truncated marker,sender='__truncated',前端渲染成「已省略 N 条」chip。
+    // 旧实现 ORDER BY created_at ASC LIMIT N 会把最新消息截掉,群里消息累积
+    // 超过 N 条后新消息永远拉不到——参见群 f080e51e 的复现。
+    getGroupMessages(groupId, headKeep = 5, tailKeep = 295) {
+        const totalCount = this.db.prepare("SELECT COUNT(*) AS c FROM group_messages WHERE group_id = ?").get(groupId);
+        const total = totalCount.c;
+        if (total <= headKeep + tailKeep) {
+            return fetchGroupMessageRows(this.db, `WHERE m.group_id = ? ORDER BY m.created_at ASC, m.id ASC`, groupId);
+        }
+        const head = fetchGroupMessageRows(this.db, `WHERE m.group_id = ? ORDER BY m.created_at ASC, m.id ASC LIMIT ?`, groupId, headKeep);
+        const tail = fetchGroupMessageRows(this.db, `WHERE m.group_id = ? ORDER BY m.created_at DESC, m.id DESC LIMIT ?`, groupId, tailKeep);
+        tail.reverse();
+        const omitted = total - head.length - tail.length;
+        // marker 的 created_at 取 head 末尾 +1ms,落在 head 和 tail 之间,
+        // 前端按 timestamp 排序时位置正确。
+        const markerTime = head.length > 0
+            ? shiftBeijing(head[head.length - 1].created_at, 1)
+            : (tail[0]?.created_at ?? nowBeijing());
+        const marker = {
+            id: -1,
+            sender: "__truncated",
+            content: "",
+            mentions: "[]",
+            created_at: markerTime,
+            cancelled_at: null,
+            composed_prompt: null,
+            truncated: { omitted },
+        };
+        return [...head, marker, ...tail];
+    },
+    /** 按 since 时间过滤群消息(UTC ISO 或北京时间字符串都行,字符串字典序比较)。
+     *  不走 head/tail 截断——轮询用,只看新增量。返回 ASC 排序。 */
+    getGroupMessagesSince(groupId, sinceIso) {
+        return fetchGroupMessageRows(this.db, `WHERE m.group_id = ? AND m.created_at > ? ORDER BY m.created_at ASC, m.id ASC`, groupId, sinceIso);
+    },
+};

package/dist/master/db/guidance-templates.js

@@ -0,0 +1,58 @@
+/**
+ * Guidance templates — 群指导 prompt 模板库。
+ *
+ * 每条模板包含 prompt_text 和可选的 schedule_config(JSON 字符串)。选模板时
+ * 前端把 prompt_text 填进 groups.guidance_prompt；若 schedule_config 存在,
+ * 同时调 schedules.createScheduledTask 建定时任务。prompt_text 和
+ * schedule_config 都支持 {{teacher}}/{{student}}/{{topic}} 占位符,在前端解析。
+ *
+ * 种子模板 is_default=1,deleteGuidanceTemplate 拒绝删除,API 也兜底返回 400。
+ */
+import { buildUpdate } from "./build-update.js";
+export const guidanceTemplateMethods = {
+    listGuidanceTemplates() {
+        return this.db.prepare("SELECT * FROM guidance_templates ORDER BY sort_order ASC, id ASC").all();
+    },
+    getGuidanceTemplate(id) {
+        return this.db.prepare("SELECT * FROM guidance_templates WHERE id = ?")
+            .get(id);
+    },
+    createGuidanceTemplate(input) {
+        const now = Date.now();
+        const info = this.db.prepare(`
+      INSERT INTO guidance_templates (
+        name, description, prompt_text, schedule_config, sort_order, is_default, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, 0, ?, ?)
+    `).run(input.name, input.description ?? "", input.prompt_text, input.schedule_config ?? null, input.sort_order ?? 0, now, now);
+        return this.getGuidanceTemplate(Number(info.lastInsertRowid));
+    },
+    updateGuidanceTemplate(id, patch) {
+        const built = buildUpdate({
+            table: "guidance_templates",
+            sets: {
+                name: patch.name,
+                description: patch.description,
+                prompt_text: patch.prompt_text,
+                schedule_config: patch.schedule_config,
+                sort_order: patch.sort_order,
+            },
+            where: "id = ?",
+            whereParams: [id],
+            updatedAt: "epoch",
+        });
+        if (!built)
+            return this.getGuidanceTemplate(id);
+        this.db.prepare(built.sql).run(...built.params);
+        return this.getGuidanceTemplate(id);
+    },
+    /** 删除模板;种子模板(is_default=1)拒绝删除,返回 false。 */
+    deleteGuidanceTemplate(id) {
+        const row = this.getGuidanceTemplate(id);
+        if (!row)
+            return false;
+        if (row.is_default === 1)
+            return false;
+        this.db.prepare("DELETE FROM guidance_templates WHERE id = ?").run(id);
+        return true;
+    },
+};

package/dist/master/db/index.js

@@ -0,0 +1,12 @@
+/**
+ * MeshDb facade.
+ *
+ * Public re-export so existing callers (`from "../db.js"`) keep working
+ * without modification. The actual `MeshDb` class still lives in
+ * `./internal.ts` while method-by-method extraction lands in follow-up PRs.
+ *
+ * Once extraction is complete this file can become the composition root —
+ * each domain module (agents / groups / issues / ...) contributes its
+ * methods to a single `MeshDb` instance.
+ */
+export { MeshDb } from "./internal.js";

package/dist/master/db/internal.js

@@ -0,0 +1,45 @@
+/**
+ * MeshDb — composition root that wires each domain module's methods onto a
+ * single instance. Public API surface (the method names) is unchanged from
+ * the pre-split monolithic version, so the 27 call sites across
+ * `src/master/*.ts` and `tests/*.ts` need no edits.
+ *
+ * Each domain module exports a method bag whose `this` is typed as
+ * `MeshDbSelf` (see ./core.ts) — a structural shape with the `db` handle
+ * plus the cross-module method signatures they reference (e.g.
+ * messages.enqueueOffline → agents.getAgentById).
+ *
+ * Type-wise, the MeshDb interface merges `MeshDbCore` with the intersection
+ * of every domain method bag — declaration merging puts the bag methods on
+ * the class instance type without 200+ lines of `declare` boilerplate. The
+ * runtime instance is built via `Object.assign(this, …bags)` in the
+ * constructor; implementations live in the domain modules.
+ */
+import { MeshDbCore } from "./core.js";
+import { agentMethods } from "./agents.js";
+import { messageMethods } from "./messages.js";
+import { domainMethods } from "./domains.js";
+import { groupMethods } from "./groups.js";
+import { issueMethods } from "./issues.js";
+import { noteMethods } from "./notes.js";
+import { memoryMethods } from "./memory.js";
+import { skillMethods } from "./skills.js";
+import { scheduleMethods } from "./schedules.js";
+import { askBridgeMethods } from "./ask-bridges.js";
+import { guidanceTemplateMethods } from "./guidance-templates.js";
+import { schedulePatternMethods } from "./schedule-patterns.js";
+import { agentSessionMethods } from "./agent-sessions.js";
+import { issuePatrolMethods } from "./issues-patrol.js";
+import { linkMethods } from "./links.js";
+import { masterNodeMethods } from "./master-node.js";
+import { teamMethods } from "./team.js";
+import { agentVisibilityMethods } from "./agent-visibility.js";
+export class MeshDb extends MeshDbCore {
+    constructor(dbPath) {
+        super(dbPath);
+        // Each method bag's `this` resolves to this instance at call time.
+        // The `MethodBags` intersection on the interface above ensures
+        // TypeScript sees the assigned methods as members of MeshDb.
+        Object.assign(this, agentMethods, messageMethods, domainMethods, groupMethods, issueMethods, noteMethods, memoryMethods, skillMethods, scheduleMethods, askBridgeMethods, guidanceTemplateMethods, schedulePatternMethods, agentSessionMethods, issuePatrolMethods, linkMethods, masterNodeMethods, teamMethods, agentVisibilityMethods);
+    }
+}

package/dist/master/db/issues-patrol.js

@@ -0,0 +1,81 @@
+import { nowBeijing } from "../../shared/time.js";
+import { buildUpdate } from "./build-update.js";
+export const issuePatrolMethods = {
+    createPatrolRun(input) {
+        const now = input.startedAt ?? nowBeijing();
+        this.db.prepare(`
+      INSERT INTO issue_patrol_runs
+        (run_id, patrol_group_id, patrol_issue_id, started_at, in_progress_count, candidates_scanned, candidates_ready, status, note)
+      VALUES (?, ?, ?, ?, ?, 0, 0, ?, NULL)
+    `).run(input.runId, input.patrolGroupId, input.patrolIssueId ?? null, now, input.inProgressCount, input.status ?? "dispatched");
+    },
+    /** 标记本轮结束。scanned/ready/note 不传则保留原值。 */
+    finishPatrolRun(runId, status, opts) {
+        const built = buildUpdate({
+            table: "issue_patrol_runs",
+            sets: {
+                candidates_scanned: opts?.scanned,
+                candidates_ready: opts?.ready,
+                note: opts?.note,
+            },
+            where: "run_id = ?",
+            whereParams: [runId],
+            updatedAt: false,
+            extraSets: [
+                { column: "finished_at", value: nowBeijing() },
+                { column: "status", value: status },
+            ],
+        });
+        if (built)
+            this.db.prepare(built.sql).run(...built.params);
+    },
+    getPatrolRunByIssueId(patrolIssueId) {
+        return this.db.prepare("SELECT * FROM issue_patrol_runs WHERE patrol_issue_id = ? ORDER BY started_at DESC LIMIT 1").get(patrolIssueId);
+    },
+    getPatrolRun(runId) {
+        return this.db.prepare("SELECT * FROM issue_patrol_runs WHERE run_id = ?").get(runId);
+    },
+    listPatrolRuns(opts) {
+        const limit = Math.min(opts?.limit ?? 50, 500);
+        const where = [];
+        const params = [];
+        if (opts?.patrolGroupId) {
+            where.push("patrol_group_id = ?");
+            params.push(opts.patrolGroupId);
+        }
+        const whereClause = where.length ? `WHERE ${where.join(" AND ")}` : "";
+        params.push(limit);
+        return this.db.prepare(`SELECT * FROM issue_patrol_runs ${whereClause} ORDER BY started_at DESC LIMIT ?`).all(...params);
+    },
+    insertPatrolLog(input) {
+        const now = nowBeijing();
+        this.db.prepare(`
+      INSERT INTO issue_patrol_logs
+        (id, run_id, patrol_group_id, issue_id, candidate_group_id, verdict, rule_matched, rationale, raw, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(input.id, input.runId, input.patrolGroupId, input.issueId ?? null, input.candidateGroupId ?? null, input.verdict, input.ruleMatched ?? null, input.rationale ?? null, input.raw ?? null, now);
+    },
+    listPatrolLogsForRun(runId) {
+        return this.db.prepare("SELECT * FROM issue_patrol_logs WHERE run_id = ? ORDER BY created_at ASC").all(runId);
+    },
+    listPatrolLogs(opts) {
+        const limit = Math.min(opts?.limit ?? 200, 1000);
+        const where = [];
+        const params = [];
+        if (opts?.patrolGroupId) {
+            where.push("patrol_group_id = ?");
+            params.push(opts.patrolGroupId);
+        }
+        if (opts?.verdict) {
+            where.push("verdict = ?");
+            params.push(opts.verdict);
+        }
+        if (opts?.candidateGroupId) {
+            where.push("candidate_group_id = ?");
+            params.push(opts.candidateGroupId);
+        }
+        const whereClause = where.length ? `WHERE ${where.join(" AND ")}` : "";
+        params.push(limit);
+        return this.db.prepare(`SELECT * FROM issue_patrol_logs ${whereClause} ORDER BY created_at DESC LIMIT ?`).all(...params);
+    },
+};