@bolloon/bolloon-agent 0.4.4 → 0.4.6

package/dist/orbitdb/agent-tools.js

@@ -24,6 +24,138 @@ async function uiStore() {
     return getUICidStore();
 }
 const fmt = (o) => JSON.stringify(o, null, 2).slice(0, 3000);
+/** 2026-08-12 (Task5): Kanban 看板工具 (Hermes kanban_db → OrbitDB). 见 kanban-store.ts. */
+async function kanbanBoard(boardId) {
+    const { openKanbanBoard } = await import('./kanban-store.js');
+    return openKanbanBoard(boardId);
+}
+const fmtRows = (tasks) => tasks.length === 0 ? '📭 无任务' : tasks.map(t => `  [${t.status}] ${t.id} ${t.title}${t.assignee ? ` (${t.assignee})` : ''}`).join('\n');
+export function registerKanbanTools(ctx) {
+    ctx.tools.set('kanban_create', {
+        name: 'kanban_create',
+        description: '在看板上创建任务 (OrbitDB 持久化, 跨设备同步). 状态从 triage 开始.',
+        parameters: { boardId: '看板 id (必填, 默认用 agentId)', title: '任务标题 (必填)', body: '任务详情 (可选)', parentIds: '父任务 id 数组 (可选, 全部 done 才可执行)', createdBy: '创建者 (可选)', dueAt: '计划时间戳 (可选)' },
+        execute: async (args) => {
+            try {
+                const boardId = String(args.boardId || args.agentId || '').trim() || 'default';
+                const title = String(args.title || '').trim();
+                if (!title)
+                    return { success: false, error: 'title 必填' };
+                const parentIds = Array.isArray(args.parentIds) ? args.parentIds.map(String) : [];
+                const dueAt = typeof args.dueAt === 'number' ? args.dueAt : null;
+                const task = await (await kanbanBoard(boardId)).createTask({ boardId, title, body: String(args.body || '').trim(), parentIds, createdBy: String(args.createdBy || '').trim() || undefined, dueAt });
+                return { success: true, output: `📌 已创建任务 (${boardId}):\n  id: ${task.id}\n  状态: ${task.status}\n  推进: kanban_claim(id="${task.id}") → kanban_complete(...)` };
+            }
+            catch (e) {
+                return { success: false, error: `kanban_create 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('kanban_list', {
+        name: 'kanban_list',
+        description: '列出看板任务 (可按状态过滤). 状态: triage/todo/scheduled/ready/running/blocked/review/done/archived.',
+        parameters: { boardId: '看板 id (必填)', status: '可选: 按状态过滤' },
+        execute: async (args) => {
+            try {
+                const boardId = String(args.boardId || '').trim() || 'default';
+                const status = String(args.status || '').trim() || undefined;
+                const tasks = await (await kanbanBoard(boardId)).listTasks(status);
+                return { success: true, output: `🗂 ${boardId} ${status ? `[${status}]` : '全部'} ${tasks.length} 个任务:\n${fmtRows(tasks)}` };
+            }
+            catch (e) {
+                return { success: false, error: `kanban_list 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('kanban_get', {
+        name: 'kanban_get',
+        description: '查看单个任务详情 (含 parentIds/认领人/失败计数/createdRefs).',
+        parameters: { boardId: '看板 id (必填)', id: '任务 id (必填)' },
+        execute: async (args) => {
+            try {
+                const boardId = String(args.boardId || '').trim() || 'default';
+                const id = String(args.id || '').trim();
+                if (!id)
+                    return { success: false, error: 'id 必填' };
+                const t = await (await kanbanBoard(boardId)).getTask(id);
+                if (!t)
+                    return { success: false, error: `任务不存在: ${id}` };
+                return { success: true, output: `📄 ${t.id} [${t.status}]\n  标题: ${t.title}\n  详情: ${t.body || '—'}\n  父任务: ${t.parentIds.length ? t.parentIds.join(', ') : '无'}\n  认领人: ${t.assignee || t.claimLock || '未认领'}\n  失败计数: ${t.consecutiveFailures}\n  引用: ${t.createdRefs.length ? t.createdRefs.join(', ') : '无'}\n  备注: ${t.reason || '—'}` };
+            }
+            catch (e) {
+                return { success: false, error: `kanban_get 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('kanban_claim', {
+        name: 'kanban_claim',
+        description: '原子认领一个 ready 任务 (CAS, 至多一个 worker 成功). 认领后状态 → running.',
+        parameters: { boardId: '看板 id (必填)', id: '任务 id (必填)', worker: '认领者标识 (默认当前 agentId)' },
+        execute: async (args) => {
+            try {
+                const boardId = String(args.boardId || '').trim() || 'default';
+                const id = String(args.id || '').trim();
+                const worker = String(args.worker || '').trim() || 'agent';
+                if (!id)
+                    return { success: false, error: 'id 必填' };
+                const r = await (await kanbanBoard(boardId)).claimTask(id, worker);
+                if (!r.ok)
+                    return { success: false, error: `认领失败: ${r.reason}` };
+                return { success: true, output: `✅ 已认领 ${id} (worker=${worker})\n  完成: kanban_complete(id="${id}", worker="${worker}")` };
+            }
+            catch (e) {
+                return { success: false, error: `kanban_claim 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('kanban_complete', {
+        name: 'kanban_complete',
+        description: '完成一个 running 任务 → done (自动释放认领锁, 父任务完成时自动解子任务). createdRefs 声称的引用会做防幻觉校验.',
+        parameters: { boardId: '看板 id (必填)', id: '任务 id (必填)', worker: '认领者 (默认当前 agentId)', createdRefs: '可选: 声称创建的任务/资源引用数组' },
+        execute: async (args) => {
+            try {
+                const boardId = String(args.boardId || '').trim() || 'default';
+                const id = String(args.id || '').trim();
+                const worker = String(args.worker || '').trim() || 'agent';
+                if (!id)
+                    return { success: false, error: 'id 必填' };
+                const refs = Array.isArray(args.createdRefs) ? args.createdRefs.map(String) : [];
+                const t = await (await kanbanBoard(boardId)).completeTask(id, worker, refs);
+                if (!t)
+                    return { success: false, error: `无法完成 ${id} (不存在 或 非本 worker 认领)` };
+                return { success: true, output: `🏁 已完成 ${id} [done]${t.reason ? `\n  提醒: ${t.reason}` : ''}` };
+            }
+            catch (e) {
+                return { success: false, error: `kanban_complete 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+    ctx.tools.set('kanban_status', {
+        name: 'kanban_status',
+        description: '手动推进任务状态 (review/done/blocked/archived/ready 等合法迁移). blocked 需带 reason; archived 为终态.',
+        parameters: { boardId: '看板 id (必填)', id: '任务 id (必填)', status: '目标状态 (必填)', reason: 'blocked/review 时必填备注' },
+        execute: async (args) => {
+            try {
+                const boardId = String(args.boardId || '').trim() || 'default';
+                const id = String(args.id || '').trim();
+                const status = String(args.status || '').trim();
+                if (!id || !status)
+                    return { success: false, error: 'id 和 status 必填' };
+                let t = null;
+                if (status === 'review')
+                    t = await (await kanbanBoard(boardId)).requestReview(id, String(args.reason || '').trim());
+                else
+                    t = await (await kanbanBoard(boardId)).setStatus(id, status, String(args.reason || '').trim());
+                if (!t)
+                    return { success: false, error: `状态迁移失败 (非法迁移或任务不存在): ${id} → ${status}` };
+                return { success: true, output: `↻ ${id} → [${t.status}]${t.reason ? ` (${t.reason})` : ''}` };
+            }
+            catch (e) {
+                return { success: false, error: `kanban_status 失败: ${String(e.message || e).slice(0, 200)}` };
+            }
+        }
+    });
+}
 export function registerOrbitdbTools(ctx) {
     ctx.tools.set('cid_save', {
         name: 'cid_save',
@@ -222,4 +354,11 @@ export function registerOrbitdbTools(ctx) {
             }
         }
     });
+    // 2026-08-12 (Task5): Kanban 看板工具 (Hermes kanban_db → OrbitDB)
+    try {
+        registerKanbanTools(ctx);
+    }
+    catch (odbErr) {
+        console.warn('[registerTools] Kanban 工具注册失败 (非致命):', odbErr);
+    }
 }

package/dist/orbitdb/kanban-store.js

@@ -0,0 +1,259 @@
+/**
+ * kanban-store.ts — Hermes kanban 的 OrbitDB 落地 (2026-08-12, Task5)
+ *
+ * 借鉴 hermes_cli/kanban_db.py 的 9 态任务看板 + 原子认领 (CAS), 存到 OrbitDB
+ * keyvalue store (去中心化, DID 复制可跨设备同步). 每个 board 一个 store:
+ *   bolloon-kanban-<boardId>
+ *
+ * 任务 9 态 (VALID_STATUSES):
+ *   triage → todo → (父全部 done) → ready → running → done / archived
+ *   - scheduled:  定时任务 (本次简化为状态 + dueAt, 到时可 promote)
+ *   - blocked:    主动 block (sticky, 需显式 unblock) 或父依赖未完成 (自动解)
+ *   - review:     request_review 挂起等人工审批, approve → done
+ *   - archived:   终态归档
+ *
+ * 原子认领 (CAS, 至多一个 worker 认领成功): claim_task 只在
+ *   status === 'ready' && claimLock 为空 时置 running + claimLock + claimExpires,
+ *   否则返回输家 (不重试, 无分布式锁).
+ *
+ * 安全:
+ *   - 依赖的 KV store (put/get/all) 可注入 → 单测用内存 map, 生产用 OrbitDB store.
+ *   - 任务字段全部有默认值 (dag-cbor 不支持 undefined).
+ */
+export const KANBAN_STATUSES = ['triage', 'todo', 'scheduled', 'ready', 'running', 'blocked', 'review', 'done', 'archived'];
+const now = () => Date.now();
+function fresh(id, boardId, title, base = {}) {
+    return {
+        id, boardId, title,
+        body: base.body ?? '',
+        status: base.status ?? 'triage',
+        parentIds: base.parentIds ?? [],
+        createdBy: base.createdBy ?? '',
+        assignee: base.assignee ?? '',
+        dueAt: base.dueAt ?? null,
+        claimLock: base.claimLock ?? '',
+        claimExpires: base.claimExpires ?? 0,
+        consecutiveFailures: base.consecutiveFailures ?? 0,
+        createdRefs: base.createdRefs ?? [],
+        reason: base.reason ?? '',
+        review: base.review ?? '',
+        createdAt: base.createdAt ?? now(),
+        updatedAt: base.updatedAt ?? now(),
+        completedAt: base.completedAt ?? null,
+        archivedAt: base.archivedAt ?? null,
+    };
+}
+export function taskKey(id) {
+    return `task:${id}`;
+}
+/**
+ * KanbanBoard — 绑定一个 KV store 的看板.
+ * 所有写都经 readTask→改→put 的 CAS 语义; claim 在内核判赢家.
+ */
+export class KanbanBoard {
+    kv;
+    constructor(kv) {
+        this.kv = kv;
+    }
+    st(s) {
+        return JSON.parse(JSON.stringify(s));
+    }
+    async createTask(input) {
+        const id = `t_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+        const task = fresh(id, input.boardId, input.title, {
+            body: input.body ?? '',
+            parentIds: input.parentIds ?? [],
+            createdBy: input.createdBy ?? '',
+            dueAt: input.dueAt ?? null,
+            status: 'triage',
+        });
+        await this.kv.put(taskKey(id), JSON.parse(JSON.stringify(task)));
+        return this.st(task);
+    }
+    async getTask(id) {
+        const v = await this.kv.get(taskKey(id));
+        return v || null;
+    }
+    async listTasks(status) {
+        const all = await this.kv.all();
+        const tasks = [];
+        for (const e of all) {
+            const t = e.value;
+            if (t && typeof t === 'object' && t.title !== undefined) {
+                if (!status || t.status === status)
+                    tasks.push(this.st(t));
+            }
+        }
+        return tasks.sort((a, b) => a.createdAt - b.createdAt);
+    }
+    /** 保存变更 (校验合法) */
+    async persist(task) {
+        task.updatedAt = now();
+        await this.kv.put(taskKey(task.id), JSON.parse(JSON.stringify(task)));
+        return this.st(task);
+    }
+    /**
+     * 状态推进 gate: 只允许合法迁移 (防乱跳). 返回 null 表示禁止.
+     */
+    trans(from, to) {
+        if (from === to)
+            return true;
+        if (from === 'done' || from === 'archived')
+            return false; // 终态不可再动
+        const allowed = {
+            triage: ['todo', 'scheduled', 'blocked', 'archived'],
+            todo: ['scheduled', 'ready', 'blocked', 'archived'],
+            scheduled: ['todo', 'ready', 'blocked', 'archived'],
+            ready: ['running', 'blocked', 'archived'],
+            running: ['review', 'done', 'blocked', 'ready'],
+            blocked: ['todo', 'ready', 'archived'],
+            review: ['done', 'blocked', 'todo'],
+        };
+        const ok = (allowed[from] || []).includes(to);
+        return ok;
+    }
+    /** checking parents status from KV */
+    async allParentsDone(task) {
+        if (!task.parentIds || task.parentIds.length === 0)
+            return true;
+        for (const pid of task.parentIds) {
+            const p = await this.getTask(pid);
+            if (p && p.status !== 'done' && p.status !== 'archived')
+                return false;
+        }
+        return true;
+    }
+    /** 把 todo/scheduled/blocked(父依赖未完成) 任务晋升为 ready (父依赖满足时) — recompute Ready */
+    async promoteReady(taskId) {
+        const t = await this.getTask(taskId);
+        if (!t)
+            return null;
+        // 自动可清 blocked = 因父依赖未完成; sticky blocked (用户主动) 不自动解
+        const autoClearable = t.status === 'blocked' && t.reason === 'parents_not_done';
+        if (!autoClearable && t.status !== 'todo' && t.status !== 'scheduled')
+            return null;
+        if (!(await this.allParentsDone(t))) {
+            if (t.status === 'blocked')
+                return this.st(t);
+            return { ...this.st(t), status: 'blocked', reason: 'parents_not_done' };
+        }
+        return this.persist({ ...t, status: 'ready', reason: '' });
+    }
+    /** 认领 (CAS): 只有 ready 且未被认领的才能成功 → running + claimLock */
+    async claimTask(taskId, worker, ttlMs = 15 * 60 * 1000) {
+        const t = await this.getTask(taskId);
+        if (!t)
+            return { ok: false, reason: `任务不存在: ${taskId}` };
+        if (t.claimLock)
+            return { ok: false, reason: '已被其他 worker 认领' };
+        if (t.status !== 'ready') {
+            // 父依赖不变式: 认领点再强校验一次 (任何写路径把任务置 ready 都可能被这里纠正)
+            if (!(await this.allParentsDone(t))) {
+                await this.persist({ ...t, status: 'blocked', reason: 'parents_not_done' });
+                return { ok: false, reason: '父任务未完成 (降级 blocked)' };
+            }
+            return { ok: false, reason: `状态为 ${t.status}, 只有 ready 可认领` };
+        }
+        const run = fresh(t.id, t.boardId, t.title, { ...t, status: 'running', claimLock: worker, claimExpires: now() + ttlMs, consecutiveFailures: 0 });
+        await this.kv.put(taskKey(taskId), JSON.parse(JSON.stringify(run)));
+        return { ok: true, task: this.st(run) };
+    }
+    /** 认领 TTL 过期释放 — 防崩溃锁泄漏 (重启后旧 claimLock 残留) */
+    async releaseStaleClaims(nowTs = now()) {
+        const tasks = await this.listTasks('running');
+        let freed = 0;
+        for (const t of tasks) {
+            if (t.claimLock && t.claimExpires < nowTs) {
+                await this.persist({ ...t, status: 'ready', claimLock: '', claimExpires: 0 });
+                freed++;
+            }
+        }
+        return freed;
+    }
+    /** 记一次失败 (熔断): 连续失败 > limit → blocked */
+    async registerFailure(taskId, failureLimit = 3) {
+        const t = await this.getTask(taskId);
+        if (!t)
+            return null;
+        let next = t.claimLock ? { ...t, status: 'ready', claimLock: '', claimExpires: 0 } : { ...t };
+        next.consecutiveFailures = (next.consecutiveFailures || 0) + 1;
+        if (next.consecutiveFailures >= failureLimit) {
+            next.status = 'blocked';
+            next.reason = `circuit_break (连续失败 ${next.consecutiveFailures})`;
+        }
+        return this.persist(next);
+    }
+    /** 完成: 校验声称创建的引用 (防幻觉 — 幽灵引用 advisory), 父任务完成则解子依赖 */
+    async completeTask(taskId, worker, createdRefs = []) {
+        const t = await this.getTask(taskId);
+        if (!t)
+            return null;
+        if (t.claimLock && t.claimLock !== worker)
+            return null;
+        // 防幻觉 (advisory): 声称创建的引用逐一验证存在 → 不存在记为 advisory (不阻塞, 但可审计)
+        const missing = [];
+        for (const ref of createdRefs) {
+            const existing = await this.getTask(ref.replace(/^task:/, ''));
+            if (!existing)
+                missing.push(ref);
+        }
+        const task = fresh(t.id, t.boardId, t.title, {
+            ...t, status: 'done', claimLock: '', claimExpires: 0,
+            createdRefs, reason: missing.length ? `advisory_missing_refs: ${missing.join(',')}` : t.reason,
+            completedAt: now(),
+        });
+        await this.kv.put(taskKey(taskId), JSON.parse(JSON.stringify(task)));
+        // 子任务受父完成影响 → 尝试晋升 ready
+        const all = await this.listTasks();
+        for (const c of all) {
+            if (c.parentIds.includes(taskId) && (c.status === 'todo' || c.status === 'blocked')) {
+                await this.promoteReady(c.id);
+            }
+        }
+        return this.st(task);
+    }
+    async requestReview(taskId, note) {
+        const t = await this.getTask(taskId);
+        if (!t || t.status !== 'running')
+            return null;
+        return this.persist({ ...t, status: 'review', claimLock: '', claimExpires: 0, review: note });
+    }
+    async approveReview(taskId) {
+        const t = await this.getTask(taskId);
+        if (!t || t.status !== 'review')
+            return null;
+        return this.persist({ ...t, status: 'done', reason: 'review_approved', completedAt: now() });
+    }
+    async rejectReview(taskId, reason) {
+        const t = await this.getTask(taskId);
+        if (!t || t.status !== 'review')
+            return null;
+        return this.persist({ ...t, status: 'blocked', review: '', reason: `review_rejected: ${reason}` });
+    }
+    async setStatus(taskId, to, reason = '') {
+        const t = await this.getTask(taskId);
+        if (!t || !this.trans(t.status, to))
+            return null;
+        if (to === 'blocked' && !reason && !t.reason)
+            return null; // blocked 需带 reason
+        const next = { ...t, status: to, reason: to === 'blocked' ? (reason || t.reason) : reason || t.reason };
+        if (to === 'archived')
+            next.archivedAt = now();
+        if (to === 'ready') {
+            if (!(await this.allParentsDone(next)))
+                return this.persist({ ...next, status: 'blocked', reason: 'parents_not_done' });
+        }
+        return this.persist(next);
+    }
+}
+/** 打开/缓存指定 board 的 OrbitDB KV store, 返回绑定的 KanbanBoard. 失败抛错. */
+const _boardCache = new Map();
+export async function openKanbanBoard(boardId) {
+    if (_boardCache.has(boardId))
+        return _boardCache.get(boardId);
+    const { getCIDDatabase } = await import('./cid-database.js');
+    const store = await (await getCIDDatabase()).openStore(`bolloon-kanban-${boardId}`, 'keyvalue');
+    const board = new KanbanBoard(store);
+    _boardCache.set(boardId, board);
+    return board;
+}

package/dist/orbitdb/task-store.js

@@ -0,0 +1,112 @@
+/**
+ * task-store.ts — Task 队列的 OrbitDB 主存储 (2026-08-12, Task6)
+ *
+ * 把 hermes kanban 用 OrbitDB 实现: 任务队列以 OrbitDB keyvalue store 为主存储,
+ * 支持跨设备/去中心化同步 (与 did-catalog-replication 同模式, 共享同一 helia 节点).
+ *
+ * 设计:
+ *   - store 名: `bolloon-tasks-<did短名>` (确定性, 跨设备同名 → 同一复制流)
+ *   - 存整个任务数组到单键 `tasks` (兼容 server-storage 现有 loadTaskQueue/saveTaskQueue)
+ *   - 懒初始化 + 幂等: 首次 warm 时打开 store; 失败静默 → 回退本地文件 (增强层, 不阻塞)
+ *   - 生产由 server 启动时 warmTaskOrbitStore() 预热; 测试环境 (临时 HOME) 不预热 → 走本地
+ *
+ * 失败静默: OrbitDB 不可用 (离线/首次/测试) 时任务照常走本地文件, 不阻塞主路径.
+ */
+import * as path from 'path';
+import * as os from 'os';
+import { getCIDDatabase } from './cid-database.js';
+const homeRoot = () => process.env.HOME || os.homedir() || '/tmp';
+export const TASK_ORBIT_STORE_KEY = 'tasks';
+/** store 名: 按 did 短名确定性命名 */
+export function taskStoreName(did) {
+    const short = String(did || 'local').replace(/[^a-zA-Z0-9-]/g, '_').slice(0, 40) || 'local';
+    return `bolloon-tasks-${short}`;
+}
+/** 真实实现 (OrbitDB). 单例: 同一进程共享 CID 数据库单例. */
+export class OrbitDBTaskStore {
+    did;
+    db;
+    _store = null;
+    ready = false;
+    storeName;
+    storeAddress = '';
+    constructor(did, db = getCIDDatabase()) {
+        this.did = did;
+        this.db = db;
+        this.storeName = taskStoreName(did);
+    }
+    async warm() {
+        if (this.ready && this._store)
+            return true;
+        try {
+            this._store = await this.db.openStore(this.storeName, 'keyvalue');
+            this.storeAddress = this._store.address;
+            this.ready = true;
+            return true;
+        }
+        catch (err) {
+            // OrbitDB 不可用 (离线/首次/测试环境) → 静默回退本地
+            try {
+                console.warn(`[task-store] OrbitDB 任务存储不可用, 回退本地: ${err?.message?.slice(0, 120)}`);
+            }
+            catch { /* 忽略 */ }
+            this.ready = false;
+            return false;
+        }
+    }
+    async loadTasks() {
+        if (!this.ready || !this._store)
+            return null;
+        try {
+            const v = await this._store.get(TASK_ORBIT_STORE_KEY);
+            if (v == null)
+                return null;
+            if (Array.isArray(v))
+                return v;
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async saveTasks(tasks) {
+        if (!this.ready || !this._store)
+            return false;
+        try {
+            await this._store.put(TASK_ORBIT_STORE_KEY, tasks);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async close() {
+        this._store = null;
+        this.ready = false;
+    }
+}
+let _instance = null;
+let _warmPromise = null;
+/** 获取任务 OrbitDB 存储单例 (首次调用时 warm). did 为 '' 时用 'local'. */
+export function getTaskOrbitStore(did = '') {
+    if (!_instance)
+        _instance = new OrbitDBTaskStore(did || 'local');
+    return _instance;
+}
+/** 预热任务 OrbitDB 存储 (server 启动时调用, 幂等). 返回是否就绪. */
+export function warmTaskOrbitStore(did = '') {
+    if (!_warmPromise) {
+        const store = getTaskOrbitStore(did);
+        _warmPromise = store.warm().then((ok) => ok).catch(() => false);
+    }
+    return _warmPromise;
+}
+/** 重置单例 (测试用) */
+export function resetTaskOrbitStore() {
+    _instance = null;
+    _warmPromise = null;
+}
+/** 用 did 短名构造 task store 名 (供 server 组装 store name 展示) */
+export function taskStorePath(did, home = homeRoot()) {
+    return path.join(home, '.bolloon', 'orbitdb', 'stores', taskStoreName(did));
+}

package/dist/pi-ecosystem-judgment/human-value-store.js

@@ -279,7 +279,7 @@ export async function findRecentSimilarDecisions(decision, withinMs, options) {
     for (const j of judgments) {
         if (statusFilter !== 'all' && (j.status ?? 'active') !== statusFilter)
             continue;
-        if (new Date(j.timestamp).getTime() < cutoff)
+        if (new Date(j.timestamp).getTime() <= cutoff)
             continue;
         if (wantChannel) {
             const jChannel = j.context?.domain;