@konglx/rotom 2.21.0

package/dist/master/api/links-patrol.js

@@ -0,0 +1,168 @@
+/**
+ * Link 智能分类 REST —— 工具箱 Link 分类 tab 用。
+ *
+ * - GET  /api/links-patrol/state           — 当前 patrol-link 群 + scheduled_task 配置
+ * - PATCH /api/links-patrol/config         — 改 enabled / intervalSec / scanBatch
+ * - GET  /api/links-patrol/runs            — 最近 runs
+ * - GET  /api/links-patrol/runs/:runId/logs — 单轮日志
+ * - GET  /api/links-patrol/stats           — 采集 / 分类统计(总链接数 / 未分类数 / 分类 host 数)
+ *
+ * 仿 src/master/api/issues-patrol.ts(issue 巡检)的同名端点。type=patrol-link 群由建群时
+ * 自动建,这里只读 + 改 schedule config + 看历史。
+ */
+import { createLogger } from "../../shared/logger.js";
+const log = createLogger("mesh-api-links-patrol");
+function parsePayload(raw) {
+    if (!raw)
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function findLinkPatrolGroup(db) {
+    const groups = db.listGroupsByType("patrol-link").filter((g) => g.archived_at == null);
+    if (groups.length === 0)
+        return null;
+    const group = groups[0];
+    const task = db.listScheduledTasks({ groupId: group.id }).find((t) => t.handler_key === "link-patrol");
+    const agentName = task?.agent_name ?? "";
+    return { groupId: group.id, groupName: group.name, agentName };
+}
+export function registerLinkPatrolRoutes(apiRouter, db) {
+    // ── state ────────────────────────────────────────────────────────────────
+    apiRouter.get("/links-patrol/state", (_req, res) => {
+        const patrol = findLinkPatrolGroup(db);
+        if (!patrol) {
+            res.json({ enabled: false, hasPatrolGroup: false });
+            return;
+        }
+        const task = db.listScheduledTasks({ groupId: patrol.groupId }).find((t) => t.handler_key === "link-patrol");
+        if (!task) {
+            res.json({
+                hasPatrolGroup: true,
+                patrolGroupId: patrol.groupId,
+                patrolGroupName: patrol.groupName,
+                patrolAgentName: patrol.agentName,
+                enabled: false,
+            });
+            return;
+        }
+        const payload = parsePayload(task.handler_payload);
+        res.json({
+            hasPatrolGroup: true,
+            patrolGroupId: patrol.groupId,
+            patrolGroupName: patrol.groupName,
+            patrolAgentName: patrol.agentName,
+            taskId: task.id,
+            enabled: task.enabled === 1,
+            intervalSec: task.interval_sec,
+            nextRunAt: task.next_run_at,
+            lastRunAt: task.last_run_at,
+            lastStatus: task.last_status,
+            lastError: task.last_error,
+            scanBatch: payload.scanBatch ?? 20,
+        });
+    });
+    // ── config ────────────────────────────────────────────────────────────────
+    apiRouter.patch("/links-patrol/config", (req, res) => {
+        const patrol = findLinkPatrolGroup(db);
+        if (!patrol) {
+            res.status(400).json({ error: "未创建链接分类巡检群,请先建一个 type=patrol-link 的群" });
+            return;
+        }
+        const task = db.listScheduledTasks({ groupId: patrol.groupId }).find((t) => t.handler_key === "link-patrol");
+        if (!task) {
+            res.status(404).json({ error: "链接分类定时任务不存在" });
+            return;
+        }
+        const body = req.body ?? {};
+        const patch = {};
+        const payload = parsePayload(task.handler_payload);
+        if (typeof body.enabled === "boolean") {
+            patch.enabled = body.enabled;
+        }
+        if (typeof body.intervalSec === "number") {
+            if (body.intervalSec < 60) {
+                res.status(400).json({ error: "intervalSec 必须 >= 60" });
+                return;
+            }
+            patch.intervalSec = Math.floor(body.intervalSec);
+            patch.scheduleKind = "interval";
+        }
+        if (typeof body.scanBatch === "number") {
+            if (body.scanBatch < 1 || body.scanBatch > 100) {
+                res.status(400).json({ error: "scanBatch 取值 1-100" });
+                return;
+            }
+            payload.scanBatch = Math.floor(body.scanBatch);
+        }
+        payload.patrolGroupId = payload.patrolGroupId ?? patrol.groupId;
+        payload.patrolAgentName = payload.patrolAgentName ?? patrol.agentName;
+        patch.handlerPayload = JSON.stringify(payload);
+        const updated = db.updateScheduledTask(task.id, patch);
+        if (!updated) {
+            res.status(500).json({ error: "更新失败" });
+            return;
+        }
+        log.info(`Link-patrol config updated (task #${task.id}): ${JSON.stringify(patch)}`);
+        res.json({
+            ok: true,
+            enabled: updated.enabled === 1,
+            intervalSec: updated.interval_sec,
+            scanBatch: payload.scanBatch,
+            nextRunAt: updated.next_run_at,
+        });
+    });
+    // ── runs ──────────────────────────────────────────────────────────────────
+    apiRouter.get("/links-patrol/runs", (req, res) => {
+        const limit = parseLimit(req.query.limit, 50);
+        const patrol = findLinkPatrolGroup(db);
+        const runs = db.listLinkPatrolRuns({
+            patrolGroupId: patrol?.groupId,
+            limit,
+        });
+        res.json({ runs });
+    });
+    apiRouter.get("/links-patrol/runs/:runId/logs", (req, res) => {
+        const logs = db.listLinkPatrolLogsForRun(req.params.runId);
+        res.json({ logs });
+    });
+    // ── stats ─────────────────────────────────────────────────────────────────
+    apiRouter.get("/links-patrol/stats", (_req, res) => {
+        const totalRow = db.db.prepare("SELECT COUNT(*) as n FROM links").get();
+        const unclassRow = db.db.prepare("SELECT COUNT(*) as n FROM links WHERE category IS NULL").get();
+        const occRow = db.db.prepare("SELECT COUNT(*) as n FROM link_occurrences").get();
+        const hostRow = db.db.prepare("SELECT COUNT(DISTINCT host) as n FROM links WHERE category IS NOT NULL").get();
+        const patrol = findLinkPatrolGroup(db);
+        const runs = patrol
+            ? db.listLinkPatrolRuns({ patrolGroupId: patrol.groupId, limit: 1 })
+            : [];
+        const lastRun = runs[0] ?? null;
+        res.json({
+            totalLinks: totalRow.n,
+            unclassified: unclassRow.n,
+            totalOccurrences: occRow.n,
+            classifiedHosts: hostRow.n,
+            lastRun: lastRun
+                ? {
+                    run_id: lastRun.run_id,
+                    started_at: lastRun.started_at,
+                    finished_at: lastRun.finished_at,
+                    status: lastRun.status,
+                    candidates_scanned: lastRun.candidates_scanned,
+                    candidates_classified: lastRun.candidates_classified,
+                    note: lastRun.note,
+                }
+                : null,
+        });
+    });
+}
+function parseLimit(v, fallback) {
+    const n = typeof v === "string" ? parseInt(v, 10) : Number(v);
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return Math.min(n, 1000);
+}

package/dist/master/api/links.js

@@ -0,0 +1,114 @@
+import { createLogger } from "../../shared/logger.js";
+import { extractUrls, normalizeUrl } from "../../shared/url-extractor.js";
+const log = createLogger("mesh-api-links");
+/**
+ * PATCH /api/links/:id 时,若改了 category/tags,要顺手在 memory 强化一条
+ * link_rule:<host> 规则(放在 link 出现过的 source_group,不放 global namespace)。
+ * global memory 必须走人工 promote(POST /api/memory/:id/promote),不能由 link override 直接写。
+ */
+function overrideMemoryForLink(db, linkId, fields) {
+    const link = db.getLink(linkId);
+    if (!link)
+        return;
+    if (fields.category === undefined && fields.tags === undefined)
+        return;
+    const sourceGroups = db.listSourceGroupsForLink(linkId);
+    if (sourceGroups.length === 0) {
+        log.info(`Link ${linkId} override: no source_group, skip memory reinforce`);
+        return;
+    }
+    // 多群共享的 host 规则:取最近出现群(按 source_groups 写入顺序等价于发现顺序)
+    const groupId = sourceGroups[0];
+    const category = fields.category ?? "other";
+    const tags = Array.isArray(fields.tags) ? fields.tags : [];
+    const key = `link_rule:${link.host}`;
+    const value = `[人工 override] host=${link.host} 默认分类 ${category}; tags=[${tags.join(", ")}]`;
+    const summary = `${link.host} → ${category} (override)`;
+    const existing = db.db.prepare(`SELECT id FROM agent_memory WHERE key = ? AND group_id = ? AND active = 1 LIMIT 1`).get(key, groupId);
+    if (existing) {
+        db.updateMemory(existing.id, { value, summary, tags: ["link_classification", ...tags, "manual"], category: "convention" });
+    }
+    else {
+        const memId = `mem_link_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+        db.addMemory({
+            id: memId,
+            scope: "group",
+            groupId,
+            category: "convention",
+            sourceType: "manual",
+            key,
+            value,
+            summary,
+            tags: ["link_classification", ...tags, "manual"],
+            visibility: "group",
+            agentVisible: true,
+            createdBy: "dashboard:link-override",
+        });
+    }
+    log.info(`Link ${linkId} override → memory ${key} written in group ${groupId}`);
+}
+export function registerLinkRoutes(apiRouter, db) {
+    /** POST /api/links/extract — 从文本抽 URL,返回 [{raw, norm, host}]。供调试 + 单测用。 */
+    apiRouter.post("/links/extract", (req, res) => {
+        const { text } = req.body ?? {};
+        if (typeof text !== "string") {
+            res.status(400).json({ error: "text (string) is required" });
+            return;
+        }
+        const items = extractUrls(text);
+        const urls = items.map((it) => {
+            const n = normalizeUrl(it.raw);
+            return n ? { raw: n.raw, norm: n.norm, host: n.host } : { raw: it.raw, norm: null, host: null };
+        }).filter((u) => u.norm !== null);
+        res.json({ urls });
+    });
+    /** GET /api/links — 列表 + 过滤(category / tag / search / group_id / host)。 */
+    apiRouter.get("/links", (req, res) => {
+        const category = typeof req.query.category === "string" ? req.query.category : undefined;
+        const tag = typeof req.query.tag === "string" ? req.query.tag : undefined;
+        const search = typeof req.query.search === "string" ? req.query.search : undefined;
+        const groupId = typeof req.query.group_id === "string" ? req.query.group_id : undefined;
+        const host = typeof req.query.host === "string" ? req.query.host : undefined;
+        const limit = Math.min(parseInt(req.query.limit) || 50, 500);
+        const offset = Math.max(parseInt(req.query.offset) || 0, 0);
+        const items = db.listLinks({ category, tag, search, groupId, host, limit, offset });
+        const total = db.countLinks({ category, tag, search, groupId, host });
+        res.json({ items, total, limit, offset });
+    });
+    /** GET /api/links/:id — 链接详情 + tags + occurrences + source_groups */
+    apiRouter.get("/links/:id", (req, res) => {
+        const link = db.getLink(req.params.id);
+        if (!link) {
+            res.status(404).json({ error: "Link not found" });
+            return;
+        }
+        const tags = db.listTagsForLink(link.id);
+        const occurrences = db.listOccurrencesForLink(link.id, 50);
+        const sourceGroups = db.listSourceGroupsForLink(link.id);
+        res.json({ ...link, tags, occurrences, source_groups: sourceGroups });
+    });
+    /** PATCH /api/links/:id — 人工 override(category/tags/title/summary)+ memory 强化。 */
+    apiRouter.patch("/links/:id", (req, res) => {
+        const link = db.getLink(req.params.id);
+        if (!link) {
+            res.status(404).json({ error: "Link not found" });
+            return;
+        }
+        const { category, tags, title, summary } = req.body ?? {};
+        const fields = {};
+        if (typeof category === "string")
+            fields.category = category;
+        if (Array.isArray(tags)) {
+            fields.tags = tags.filter((t) => typeof t === "string" && t.trim()).map((t) => t.trim());
+        }
+        if (typeof title === "string")
+            fields.title = title;
+        if (typeof summary === "string")
+            fields.summary = summary;
+        db.updateLinkClassification(link.id, fields);
+        overrideMemoryForLink(db, link.id, fields);
+        log.info(`Link ${link.id} patched: ${JSON.stringify(fields)}`);
+        const updated = db.getLink(link.id);
+        res.json({ ok: true, link: updated });
+    });
+}

package/dist/master/api/memory.js

@@ -0,0 +1,259 @@
+/**
+ * Memory REST API —— agent_memory 表的 CRUD + search + 审核 + 统计。
+ *
+ * Dashboard 端点开放(无登录),与 notes 一致。agent-token 端点走 Bearer header。
+ * 旧 /groups/:id/notes 路由保留在 notes.ts,作为兼容层。
+ */
+import { randomUUID } from "node:crypto";
+import { createLogger } from "../../shared/logger.js";
+const log = createLogger("mesh-api");
+const CATEGORIES = ["fact", "decision", "convention", "pitfall", "todo", "playbook", "note"];
+function isCategory(v) {
+    return typeof v === "string" && CATEGORIES.includes(v);
+}
+export function registerMemoryRoutes(apiRouter, db) {
+    // ── 列表(支持 type=note|memory|all)─────────────────────────────────
+    apiRouter.get("/groups/:groupId/memory", (req, res) => {
+        const group = db.getGroupById(req.params.groupId);
+        if (!group) {
+            res.status(404).json({ error: "Group not found" });
+            return;
+        }
+        const { category, key, tags, includePending, type } = req.query;
+        const tagArr = typeof tags === "string" ? tags.split(",").map(t => t.trim()).filter(Boolean) : undefined;
+        let agentVisible;
+        if (type === "note")
+            agentVisible = 0;
+        else if (type === "memory")
+            agentVisible = 1;
+        // type=all 或未指定 → undefined(两者都查)
+        res.json(db.listMemory({
+            scope: "group",
+            groupId: req.params.groupId,
+            category: isCategory(category) ? category : undefined,
+            key: typeof key === "string" ? key : undefined,
+            tags: tagArr,
+            includePending: includePending === "true" || includePending === "1",
+            agentVisible,
+        }));
+    });
+    // ── 全局记忆列表 ─────────────────────────────────────────────────────
+    apiRouter.get("/memory/global", (req, res) => {
+        const { category, key, tags, includePending, type } = req.query;
+        const tagArr = typeof tags === "string" ? tags.split(",").map(t => t.trim()).filter(Boolean) : undefined;
+        let agentVisible;
+        if (type === "note")
+            agentVisible = 0;
+        else if (type === "memory")
+            agentVisible = 1;
+        res.json(db.listMemory({
+            scope: "global",
+            category: isCategory(category) ? category : undefined,
+            key: typeof key === "string" ? key : undefined,
+            tags: tagArr,
+            includePending: includePending === "true" || includePending === "1",
+            agentVisible,
+        }));
+    });
+    // ── 关键词搜索(强制 agent_visible=1)──────────────────────────────────
+    apiRouter.get("/groups/:groupId/memory/search", (req, res) => {
+        const group = db.getGroupById(req.params.groupId);
+        if (!group) {
+            res.status(404).json({ error: "Group not found" });
+            return;
+        }
+        const q = typeof req.query.q === "string" ? req.query.q.trim() : "";
+        if (!q) {
+            res.status(400).json({ error: "q (keyword) is required" });
+            return;
+        }
+        const { category } = req.query;
+        // 群内 + 全局都搜
+        const groupHits = db.searchMemory(q, { scope: "group", groupId: req.params.groupId, category: isCategory(category) ? category : undefined });
+        const globalHits = db.searchMemory(q, { scope: "global", category: isCategory(category) ? category : undefined });
+        res.json({ group: groupHits, global: globalHits });
+    });
+    apiRouter.get("/memory/search", (req, res) => {
+        const q = typeof req.query.q === "string" ? req.query.q.trim() : "";
+        if (!q) {
+            res.status(400).json({ error: "q (keyword) is required" });
+            return;
+        }
+        const { category, scope, groupId } = req.query;
+        res.json(db.searchMemory(q, {
+            scope: scope === "global" || scope === "group" ? scope : undefined,
+            groupId: typeof groupId === "string" ? groupId : undefined,
+            category: isCategory(category) ? category : undefined,
+        }));
+    });
+    // ── 详情(memory 读时计 view_count;note 不计)────────────────────────
+    apiRouter.get("/memory/:id", (req, res) => {
+        const row = db.getMemory(req.params.id);
+        if (!row) {
+            res.status(404).json({ error: "Memory not found" });
+            return;
+        }
+        res.json(row);
+    });
+    // ── 新建(支持 agent_visible,默认 true=memory)───────────────────────
+    apiRouter.post("/groups/:groupId/memory", (req, res) => {
+        const group = db.getGroupById(req.params.groupId);
+        if (!group) {
+            res.status(404).json({ error: "Group not found" });
+            return;
+        }
+        if (group.archived_at) {
+            res.status(403).json({ error: "Group is archived" });
+            return;
+        }
+        const { key, value, summary, tags, category, visibility, agentVisible, createdBy, expiresAt, pendingReview } = req.body;
+        if (!key || !value || !createdBy) {
+            res.status(400).json({ error: "key, value, createdBy are required" });
+            return;
+        }
+        if (!isCategory(category)) {
+            res.status(400).json({ error: `category must be one of: ${CATEGORIES.join(",")}` });
+            return;
+        }
+        const id = randomUUID();
+        db.addMemory({
+            id, scope: "group", groupId: req.params.groupId,
+            category, key: String(key).trim(), value: String(value),
+            summary: summary == null ? undefined : String(summary),
+            tags: Array.isArray(tags) ? tags.map(String) : [],
+            visibility: visibility === "private" || visibility === "global" ? visibility : "group",
+            agentVisible: agentVisible === false ? false : true,
+            createdBy,
+            expiresAt: expiresAt == null ? null : String(expiresAt),
+            pendingReview: pendingReview === true,
+        });
+        log.info(`Memory created: "${key}" (${id}) cat=${category} pending=${pendingReview === true} in group ${req.params.groupId}`);
+        res.status(201).json({ id });
+    });
+    apiRouter.post("/memory/global", (req, res) => {
+        const { key, value, summary, tags, category, visibility, createdBy, expiresAt } = req.body;
+        if (!key || !value || !createdBy) {
+            res.status(400).json({ error: "key, value, createdBy are required" });
+            return;
+        }
+        if (!isCategory(category)) {
+            res.status(400).json({ error: `category must be one of: ${CATEGORIES.join(",")}` });
+            return;
+        }
+        // 全局 memory 强制走审核:agent_visible=0 + pending_review=1,等人工 approve。
+        // 已有 memory 想升级到 global,走 PATCH /memory/:id body { visibility: "global" }(走 promoteMemoryVisibility 路径)。
+        // 原因:全局 memory 直接对所有 agent 可见影响面大,必须有真人拍板。
+        const id = randomUUID();
+        db.addMemory({
+            id, scope: "global", groupId: null,
+            category, key: String(key).trim(), value: String(value),
+            summary: summary == null ? undefined : String(summary),
+            tags: Array.isArray(tags) ? tags.map(String) : [],
+            visibility: visibility === "private" || visibility === "group" ? visibility : "global",
+            agentVisible: false, // 强制:global memory 创建时对 agent 不可见
+            createdBy,
+            expiresAt: expiresAt == null ? null : String(expiresAt),
+            pendingReview: true, // 强制:必须等人工 approve
+        });
+        log.info(`Global memory created (pending review): "${key}" (${id}) cat=${category}`);
+        res.status(201).json({ id, pendingReview: true });
+    });
+    // ── 更新(可切换 agent_visible:note↔memory)───────────────────────────
+    apiRouter.patch("/memory/:id", (req, res) => {
+        const row = db.getMemory(req.params.id);
+        if (!row) {
+            res.status(404).json({ error: "Memory not found" });
+            return;
+        }
+        const { value, summary, tags, category, visibility, agentVisible, expiresAt } = req.body;
+        const fields = {};
+        if (value !== undefined)
+            fields.value = String(value);
+        if (summary !== undefined)
+            fields.summary = String(summary);
+        if (tags !== undefined)
+            fields.tags = Array.isArray(tags) ? tags.map(String) : [];
+        if (isCategory(category))
+            fields.category = category;
+        if (visibility === "private" || visibility === "group" || visibility === "global")
+            fields.visibility = visibility;
+        if (agentVisible !== undefined)
+            fields.agentVisible = !!agentVisible;
+        if (expiresAt !== undefined)
+            fields.expiresAt = expiresAt == null ? null : String(expiresAt);
+        db.updateMemory(req.params.id, fields);
+        res.json({ ok: true });
+    });
+    apiRouter.delete("/memory/:id", (req, res) => {
+        const row = db.getMemory(req.params.id);
+        if (!row) {
+            res.status(404).json({ error: "Memory not found" });
+            return;
+        }
+        db.deactivateMemory(req.params.id);
+        res.json({ ok: true });
+    });
+    apiRouter.post("/memory/:id/promote", (req, res) => {
+        const row = db.getMemory(req.params.id);
+        if (!row) {
+            res.status(404).json({ error: "Memory not found" });
+            return;
+        }
+        const target = req.body?.visibility === "global" ? "global" : req.body?.visibility === "private" ? "private" : "global";
+        db.promoteMemoryVisibility(req.params.id, target);
+        res.json({ ok: true });
+    });
+    apiRouter.post("/memory/:id/expire", (req, res) => {
+        const row = db.getMemory(req.params.id);
+        if (!row) {
+            res.status(404).json({ error: "Memory not found" });
+            return;
+        }
+        db.expireMemory(req.params.id);
+        res.json({ ok: true });
+    });
+    // ── 审核 ──────────────────────────────────────────────────────────────
+    apiRouter.get("/groups/:groupId/memory/pending", (req, res) => {
+        res.json(db.listPendingMemory("group", req.params.groupId));
+    });
+    apiRouter.get("/memory/pending", (req, res) => {
+        const { scope } = req.query;
+        res.json(db.listPendingMemory(scope === "global" || scope === "group" ? scope : undefined));
+    });
+    apiRouter.post("/memory/:id/approve", (req, res) => {
+        if (!db.getMemory(req.params.id)) {
+            res.status(404).json({ error: "Memory not found" });
+            return;
+        }
+        db.approveMemory(req.params.id);
+        res.json({ ok: true });
+    });
+    apiRouter.post("/memory/:id/reject", (req, res) => {
+        if (!db.getMemory(req.params.id)) {
+            res.status(404).json({ error: "Memory not found" });
+            return;
+        }
+        db.rejectMemory(req.params.id);
+        res.json({ ok: true });
+    });
+    // ── 统计 ──────────────────────────────────────────────────────────────
+    apiRouter.get("/groups/:groupId/memory/stats", (req, res) => {
+        res.json(db.memoryStats("group", req.params.groupId));
+    });
+    apiRouter.get("/memory/stats", (req, res) => {
+        const { scope } = req.query;
+        res.json(db.memoryStats(scope === "global" || scope === "group" ? scope : undefined));
+    });
+    // ── count(供 prompt 注入,轻量)──────────────────────────────────────
+    apiRouter.get("/groups/:groupId/memory/count", (req, res) => {
+        const group = db.getGroupById(req.params.groupId);
+        if (!group) {
+            res.status(404).json({ error: "Group not found" });
+            return;
+        }
+        res.json({
+            group: db.countMemory("group", req.params.groupId),
+            global: db.countMemory("global"),
+        });
+    });
+}