@konglx/rotom 2.21.0

package/dist/master/db/ask-bridges.js

@@ -0,0 +1,157 @@
+/**
+ * ask_bridges —— Agent A 提问 B 后的「等回复 + 超时兜底」bridge 记录。
+ *
+ * 生命周期:pending → answered(B @ A 被检测) / timed_out(5min 到点创建 Issue
+ * 给 A) / cancelled(A 主动撤销)。
+ *
+ * scheduler 每 30s tick 扫 pending 行:先查 B 是否 @ 过 A(json_each 解析
+ * mentions JSON 数组),命中则 answered;否则若 expires_at < now,查 B 是否有
+ * 非 @ 回复,scheduler 据此创建复述 Issue 或升级 Issue,mark timed_out。
+ *
+ * 详细设计见 docs/AGENT_ASK_REPLY_TIMER.md 方案 C。
+ */
+export const askBridgeMethods = {
+    createAskBridge(input) {
+        const now = Date.now();
+        this.db.prepare(`
+      INSERT INTO ask_bridges
+        (id, group_id, asker, target, question_msg_id, escalate_to,
+         timeout_ms, created_at, expires_at, status)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'pending')
+    `).run(input.id, input.groupId, input.asker, input.target, input.questionMsgId, input.escalateTo, input.timeoutMs, now, now + input.timeoutMs);
+        return this.db.prepare("SELECT * FROM ask_bridges WHERE id = ?")
+            .get(input.id);
+    },
+    getAskBridge(id) {
+        return this.db.prepare("SELECT * FROM ask_bridges WHERE id = ?")
+            .get(id);
+    },
+    listAskBridges(filter) {
+        const where = [];
+        const params = [];
+        if (filter?.groupId) {
+            where.push("group_id = ?");
+            params.push(filter.groupId);
+        }
+        if (filter?.asker) {
+            where.push("asker = ?");
+            params.push(filter.asker);
+        }
+        if (filter?.status) {
+            where.push("status = ?");
+            params.push(filter.status);
+        }
+        const sql = `SELECT * FROM ask_bridges ${where.length ? "WHERE " + where.join(" AND ") : ""} ORDER BY created_at DESC`;
+        return this.db.prepare(sql).all(...params);
+    },
+    /** scheduler tick 用:返回所有 pending bridge(不论是否到期,都要先查 @ 回复)。 */
+    getPendingAskBridges() {
+        return this.db.prepare("SELECT * FROM ask_bridges WHERE status = 'pending' ORDER BY expires_at ASC").all();
+    },
+    /**
+     * 查 B 是否在 question_msg_id 之后 @ 过 A。
+     * mentions 是 JSON 数组字符串,用 json_each 精确匹配(避免子串误命中)。
+     * 返回最早一条 @ 回复(scheduler 据此 mark answered)。
+     */
+    findAtReplyForBridge(bridge) {
+        return this.db.prepare(`
+      SELECT m.id, m.group_id, m.sender, m.content, m.mentions, m.created_at, m.cancelled_at
+      FROM group_messages m, json_each(m.mentions)
+      WHERE m.group_id = ?
+        AND m.id > ?
+        AND m.sender = ?
+        AND json_each.value = ?
+      ORDER BY m.id ASC
+      LIMIT 1
+    `).get(bridge.group_id, bridge.question_msg_id, bridge.target, bridge.asker);
+    },
+    /**
+     * 查 B 在 question_msg_id 之后的最新一条非 @ 回复(超时复述用)。
+     * 不过滤 mentions——@ 的也包含,因为 @ 的回复若 timer 还没 tick 到,A 的 worker
+     * 已被 master 正常 dispatch 触发处理;若 timer tick 到了还没 mark answered,
+     * 说明 @ 检测没命中(理论上不应发生,但兜底),仍取最新一条作复述。
+     */
+    findLatestReplyForBridge(bridge) {
+        return this.db.prepare(`
+      SELECT m.id, m.group_id, m.sender, m.content, m.mentions, m.created_at, m.cancelled_at
+      FROM group_messages m
+      WHERE m.group_id = ?
+        AND m.id > ?
+        AND m.sender = ?
+        AND m.content != ''
+        AND m.cancelled_at IS NULL
+      ORDER BY m.id DESC
+      LIMIT 1
+    `).get(bridge.group_id, bridge.question_msg_id, bridge.target);
+    },
+    markBridgeAnswered(id, replyMsgId) {
+        this.db.prepare(`
+      UPDATE ask_bridges
+      SET status = 'answered', reply_msg_id = ?, resolved_at = ?
+      WHERE id = ? AND status = 'pending'
+    `).run(replyMsgId, Date.now(), id);
+    },
+    markBridgeTimedOut(id, issueId, replyMsgId) {
+        this.db.prepare(`
+      UPDATE ask_bridges
+      SET status = 'timed_out', issue_id = ?, reply_msg_id = ?, resolved_at = ?
+      WHERE id = ? AND status = 'pending'
+    `).run(issueId, replyMsgId, Date.now(), id);
+    },
+    cancelBridge(id) {
+        const result = this.db.prepare(`
+      UPDATE ask_bridges
+      SET status = 'cancelled', resolved_at = ?
+      WHERE id = ? AND status = 'pending'
+    `).run(Date.now(), id);
+        return result.changes > 0;
+    },
+    /** 取 group_messages.content;scheduler 创建超时 Issue 时复述原问题用。 */
+    getGroupMessageContent(msgId) {
+        const row = this.db.prepare("SELECT content FROM group_messages WHERE id = ?")
+            .get(msgId);
+        return row?.content;
+    },
+    /**
+     * 事件式检测:给定一条新群消息(sender, mentions),返回这条消息"答中"的 pending bridge。
+     * 答中条件:bridge.target = sender AND bridge.asker ∈ mentions AND status=pending。
+     * ws-hub 在 addGroupMessage 后调这个,命中即 markBridgeAnswered + disable 对应 schedule。
+     * 返回 bridge 列表(理论上最多 1 条,因为同 target 同时只该有 1 个 pending;但
+     * 万一有并发,全部返回让上层处理)。
+     */
+    findBridgesAnsweredByMessage(groupId, sender, mentions) {
+        if (mentions.length === 0)
+            return [];
+        // 用 json_each 反查不太合适(我们要的是 bridge.asker ∈ mentions,不是 mentions ∈ bridge)
+        // 直接 SELECT pending bridges where target=sender,然后内存里过滤 asker ∈ mentions
+        const placeholders = mentions.map(() => "?").join(",");
+        return this.db.prepare(`
+      SELECT * FROM ask_bridges
+      WHERE group_id = ?
+        AND target = ?
+        AND status = 'pending'
+        AND asker IN (${placeholders})
+    `).all(groupId, sender, ...mentions);
+    },
+    /**
+     * 按 name 查 scheduled_tasks(legacy,仍保留给历史 task name 兜底)。
+     * 新代码请用 findAskBridgeScheduledTask —— name 已改成"星期五 · …"友好文案,
+     * 不再适合做 lookup key。
+     */
+    findScheduledTaskByName(name) {
+        return this.db.prepare("SELECT id, enabled FROM scheduled_tasks WHERE name = ? ORDER BY id DESC LIMIT 1")
+            .get(name);
+    },
+    /**
+     * 按 bridgeId 查对应的 ask-bridge scheduled_task(handler_key='ask-bridge-check'
+     * 且 handler_payload 里含该 bridgeId)。name 改成"星期五 · 等待 X 回复"友好文案后,
+     * 这是 cancel 路径的权威查找方式。bridgeId 是 UUID,LIKE 不会误匹配。
+     */
+    findAskBridgeScheduledTask(bridgeId) {
+        return this.db.prepare("SELECT id, enabled FROM scheduled_tasks WHERE handler_key = 'ask-bridge-check' AND handler_payload LIKE ? ORDER BY id DESC LIMIT 1").get(`%"bridgeId":"${bridgeId}"%`);
+    },
+    /** 查是否有 pending bridge where asker+target 匹配(用于 autoCreate 防重 + 区分提问/回复)。 */
+    findPendingBridge(groupId, asker, target) {
+        return this.db.prepare("SELECT * FROM ask_bridges WHERE group_id = ? AND asker = ? AND target = ? AND status = 'pending' ORDER BY created_at DESC LIMIT 1").get(groupId, asker, target);
+    },
+};

package/dist/master/db/build-update.js

@@ -0,0 +1,59 @@
+/**
+ * Dynamic `UPDATE ... SET` builder.
+ *
+ * Replaces the 8+ scattered `const sets = []; if (field !== undefined) { ... }`
+ * patterns in db/issues.ts, db/memory.ts, db/skills.ts, db/agents.ts,
+ * db/domains.ts, db/guidance-templates.ts, db/schedules.ts,
+ * db/schedule-patterns.ts, db/notes.ts.
+ *
+ * Returns `null` when there are no set clauses (caller can short-circuit
+ * without running a no-op UPDATE). Otherwise returns the SQL string and the
+ * ordered bind params (set params first, then where params).
+ *
+ * `updatedAt` controls the auto-pushed `updated_at` column shape so each
+ * table sticks to its existing convention:
+ *   - "beijing"      → `?` bound to `nowBeijing()` (Beijing "YYYY-MM-DD HH:MM:SS.mmm")
+ *   - "datetime-now" → `datetime('now')` (SQLite UTC, no param)
+ *   - "epoch"        → `?` bound to `Date.now()` (epoch ms)
+ *   - false / undefined → no auto-pushed updated_at
+ */
+import { nowBeijing } from "../../shared/time.js";
+export function buildUpdate(opts) {
+    const setClauses = [];
+    const setParams = [];
+    for (const [column, value] of Object.entries(opts.sets)) {
+        if (value === undefined)
+            continue;
+        setClauses.push(`${column} = ?`);
+        setParams.push(value);
+    }
+    if (opts.extraSets) {
+        for (const ex of opts.extraSets) {
+            if ("sql" in ex) {
+                setClauses.push(ex.sql);
+                if (ex.params)
+                    setParams.push(...ex.params);
+            }
+            else {
+                setClauses.push(`${ex.column} = ?`);
+                setParams.push(ex.value);
+            }
+        }
+    }
+    const mode = opts.updatedAt ?? false;
+    if (mode === "beijing") {
+        setClauses.push("updated_at = ?");
+        setParams.push(nowBeijing());
+    }
+    else if (mode === "epoch") {
+        setClauses.push("updated_at = ?");
+        setParams.push(Date.now());
+    }
+    else if (mode === "datetime-now") {
+        setClauses.push("updated_at = datetime('now')");
+    }
+    if (setClauses.length === 0)
+        return null;
+    const sql = `UPDATE ${opts.table} SET ${setClauses.join(", ")} WHERE ${opts.where}`;
+    return { sql, params: [...setParams, ...opts.whereParams] };
+}

package/dist/master/db/core.js

@@ -0,0 +1,82 @@
+/**
+ * MeshDbCore — constructor, schema migration, lifecycle hooks.
+ *
+ * Domain modules (./agents.ts, ./issues.ts, ...) attach their methods to the
+ * `MeshDb` class via `Object.assign(this, ...)` in the subclass constructor.
+ * They type their methods against this interface so cross-domain calls
+ * (e.g. messages.enqueueOffline → agents.getAgentById) type-check.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// better-sqlite3 is optionalDependency (only needed for Master).
+// Dynamic import keeps dashboard builds from pulling it in.
+let Database;
+try {
+    Database = (await import("better-sqlite3")).default;
+}
+catch {
+    // Will remain undefined — MeshDb constructor will throw a clear error.
+}
+export class MeshDbCore {
+    db;
+    /** Hook fired when an issue transitions to a terminal state. */
+    _onIssueTerminal;
+    constructor(dbPath) {
+        if (!Database) {
+            throw new Error("better-sqlite3 is required for Master mode but not installed.\n" +
+                "Run: pnpm install better-sqlite3   (or npm install better-sqlite3)");
+        }
+        fs.mkdirSync(path.dirname(dbPath), { recursive: true });
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("synchronous = NORMAL");
+        this.db.pragma("foreign_keys = ON");
+        this.migrate();
+    }
+    /**
+     * Migration with version tracking.
+     *
+     * Walks ./migrations/ at the project root, applies any *.sql files whose
+     * numeric prefix is not yet recorded in schema_version. Falls back to
+     * ../migrations if the file was moved (kept for the build artifacts layout
+     * where dist/master/db/internal.js resolves one level deeper).
+     */
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS schema_version (
+        version INTEGER PRIMARY KEY,
+        applied_at TEXT DEFAULT (datetime('now'))
+      )
+    `);
+        const applied = new Set(this.db.prepare("SELECT version FROM schema_version").all()
+            .map(r => r.version));
+        let migDir = path.resolve(__dirname, "../../../../migrations");
+        if (!fs.existsSync(migDir)) {
+            migDir = path.resolve(__dirname, "../../../migrations");
+        }
+        const files = fs.readdirSync(migDir).filter(f => f.endsWith(".sql")).sort();
+        for (const file of files) {
+            const match = file.match(/^(\d+)/);
+            if (!match)
+                continue;
+            const version = parseInt(match[1], 10);
+            if (applied.has(version))
+                continue;
+            const sql = fs.readFileSync(path.join(migDir, file), "utf-8");
+            this.db.exec(sql);
+            this.db.prepare("INSERT INTO schema_version (version) VALUES (?)").run(version);
+        }
+        // Inline migration: add endpoint column if missing (safe to re-run).
+        try {
+            this.db.exec("ALTER TABLE agents ADD COLUMN endpoint TEXT");
+        }
+        catch {
+            // Column already exists — ignore.
+        }
+    }
+    close() {
+        this.db.close();
+    }
+}

package/dist/master/db/domains.js

@@ -0,0 +1,80 @@
+/**
+ * Domains — department CRUD + cross-domain routing rules.
+ *
+ * Methods attach to a `MeshDb` instance via `Object.assign`. Cross-module
+ * mutation: `renameDomainInAgents` writes the agents table (owned by
+ * ./agents.ts) — that's just a SQL write, no method call, so no cross-domain
+ * coupling beyond the SQL schema.
+ */
+import { buildUpdate } from "./build-update.js";
+export const domainMethods = {
+    listDomains() {
+        return this.db.prepare("SELECT * FROM domains ORDER BY name").all();
+    },
+    getDomainByName(name) {
+        return this.db.prepare("SELECT * FROM domains WHERE name = ?").get(name);
+    },
+    getDomainById(id) {
+        return this.db.prepare("SELECT * FROM domains WHERE id = ?").get(id);
+    },
+    insertDomain(id, name, description) {
+        this.db.prepare("INSERT INTO domains (id, name, description) VALUES (?, ?, ?)").run(id, name, description || null);
+    },
+    updateDomain(id, meta) {
+        const built = buildUpdate({
+            table: "domains",
+            sets: { name: meta.name, description: meta.description },
+            where: "id = ?",
+            whereParams: [id],
+            updatedAt: false,
+        });
+        if (built)
+            this.db.prepare(built.sql).run(...built.params);
+    },
+    deleteDomain(id) {
+        this.db.prepare("DELETE FROM domains WHERE id = ?").run(id);
+    },
+    /** Rename domain in all agents (used when domain name changes). */
+    renameDomainInAgents(oldName, newName) {
+        this.db.prepare("UPDATE agents SET domain = ?, updated_at = datetime('now') WHERE domain = ?").run(newName, oldName);
+        // Also update cross_domain_rules
+        this.db.prepare("UPDATE cross_domain_rules SET from_domain = ? WHERE from_domain = ?").run(newName, oldName);
+        this.db.prepare("UPDATE cross_domain_rules SET to_domain = ? WHERE to_domain = ?").run(newName, oldName);
+    },
+    /** Count agents belonging to a domain (by domain name). */
+    countAgentsByDomain(domainName) {
+        const row = this.db.prepare("SELECT COUNT(*) as c FROM agents WHERE domain = ?").get(domainName);
+        return row.c;
+    },
+    canCrossDomain(from, to) {
+        // No domain set → no isolation
+        if (!from || !to)
+            return true;
+        // Same domain → always OK
+        if (from === to)
+            return true;
+        // Check explicit rule
+        return !!this.db.prepare("SELECT 1 FROM cross_domain_rules WHERE from_domain = ? AND to_domain = ?").get(from, to);
+    },
+    /** Add cross-domain rule. Set bidirectional=true to create both A→B and B→A. */
+    addCrossDomainRule(from, to, bidirectional = false) {
+        this.db.prepare("INSERT OR IGNORE INTO cross_domain_rules (from_domain, to_domain) VALUES (?, ?)").run(from, to);
+        if (bidirectional) {
+            this.db.prepare("INSERT OR IGNORE INTO cross_domain_rules (from_domain, to_domain) VALUES (?, ?)").run(to, from);
+        }
+    },
+    /** List all cross-domain rules. */
+    listCrossDomainRules() {
+        return this.db.prepare("SELECT from_domain, to_domain FROM cross_domain_rules ORDER BY from_domain, to_domain").all();
+    },
+    /** Count cross-domain rules referencing a domain (as source or target). */
+    countCrossDomainRulesByDomain(domainName) {
+        const row = this.db.prepare("SELECT COUNT(*) as c FROM cross_domain_rules WHERE from_domain = ? OR to_domain = ?").get(domainName, domainName);
+        return row.c;
+    },
+    /** Delete a cross-domain rule. */
+    deleteCrossDomainRule(from, to) {
+        const result = this.db.prepare("DELETE FROM cross_domain_rules WHERE from_domain = ? AND to_domain = ?").run(from, to);
+        return result.changes > 0;
+    },
+};