reflectt-node 0.1.7 → 0.1.11

package/dist/artifact-store.d.ts

@@ -0,0 +1,55 @@
+export interface Artifact {
+    id: string;
+    agentId: string;
+    teamId: string;
+    runId: string | null;
+    taskId: string | null;
+    name: string;
+    mimeType: string;
+    sizeBytes: number;
+    storagePath: string;
+    metadata: Record<string, unknown>;
+    createdAt: number;
+}
+/**
+ * Store an artifact (writes file to disk + row to DB).
+ */
+export declare function storeArtifact(opts: {
+    agentId: string;
+    teamId?: string;
+    runId?: string;
+    taskId?: string;
+    name: string;
+    mimeType?: string;
+    content: Buffer | string;
+    metadata?: Record<string, unknown>;
+}): Artifact;
+/**
+ * Get artifact metadata by ID.
+ */
+export declare function getArtifact(id: string): Artifact | null;
+/**
+ * Read artifact content from disk.
+ */
+export declare function readArtifactContent(id: string): Buffer | null;
+/**
+ * List artifacts for an agent, run, or task.
+ */
+export declare function listArtifacts(opts: {
+    agentId?: string;
+    runId?: string;
+    taskId?: string;
+    limit?: number;
+}): Artifact[];
+/**
+ * Delete artifact (removes file + DB row).
+ */
+export declare function deleteArtifact(id: string): boolean;
+/**
+ * Get total storage used by an agent.
+ */
+export declare function getStorageUsage(agentId: string): {
+    totalBytes: number;
+    count: number;
+};
+//# sourceMappingURL=artifact-store.d.ts.map

package/dist/artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../src/artifact-store.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;CAClB;AAwCD;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,GAAG,QAAQ,CAwBX;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAIvD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,QAAQ,EAAE,CAab;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAItF"}

package/dist/artifact-store.js

@@ -0,0 +1,128 @@
+// SPDX-License-Identifier: Apache-2.0
+// Host-native artifact store — run/task-linked file storage
+import { getDb } from './db.js';
+import { mkdirSync, writeFileSync, readFileSync, existsSync, unlinkSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+function rowToArtifact(row) {
+    return {
+        id: row.id,
+        agentId: row.agent_id,
+        teamId: row.team_id,
+        runId: row.run_id,
+        taskId: row.task_id,
+        name: row.name,
+        mimeType: row.mime_type,
+        sizeBytes: row.size_bytes,
+        storagePath: row.storage_path,
+        metadata: JSON.parse(row.metadata || '{}'),
+        createdAt: row.created_at,
+    };
+}
+function generateId() {
+    return `art-${Date.now()}-${Math.random().toString(36).slice(2, 13)}`;
+}
+function getStorageRoot() {
+    return join(homedir(), '.reflectt', 'artifacts');
+}
+/**
+ * Store an artifact (writes file to disk + row to DB).
+ */
+export function storeArtifact(opts) {
+    const db = getDb();
+    const id = generateId();
+    const now = Date.now();
+    const teamId = opts.teamId ?? 'default';
+    // Storage path: ~/.reflectt/artifacts/<agentId>/<YYYY-MM>/<id>-<name>
+    const datePrefix = new Date(now).toISOString().slice(0, 7); // YYYY-MM
+    const safeName = opts.name.replace(/[^a-zA-Z0-9._-]/g, '_');
+    const storagePath = join(getStorageRoot(), opts.agentId, datePrefix, `${id}-${safeName}`);
+    // Write file
+    mkdirSync(dirname(storagePath), { recursive: true });
+    const content = typeof opts.content === 'string' ? Buffer.from(opts.content) : opts.content;
+    writeFileSync(storagePath, content);
+    const mimeType = opts.mimeType ?? guessMimeType(opts.name);
+    db.prepare(`
+    INSERT INTO artifacts (id, agent_id, team_id, run_id, task_id, name, mime_type, size_bytes, storage_path, metadata, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, opts.agentId, teamId, opts.runId ?? null, opts.taskId ?? null, opts.name, mimeType, content.length, storagePath, JSON.stringify(opts.metadata ?? {}), now);
+    return { id, agentId: opts.agentId, teamId, runId: opts.runId ?? null, taskId: opts.taskId ?? null, name: opts.name, mimeType, sizeBytes: content.length, storagePath, metadata: opts.metadata ?? {}, createdAt: now };
+}
+/**
+ * Get artifact metadata by ID.
+ */
+export function getArtifact(id) {
+    const db = getDb();
+    const row = db.prepare('SELECT * FROM artifacts WHERE id = ?').get(id);
+    return row ? rowToArtifact(row) : null;
+}
+/**
+ * Read artifact content from disk.
+ */
+export function readArtifactContent(id) {
+    const art = getArtifact(id);
+    if (!art || !existsSync(art.storagePath))
+        return null;
+    return readFileSync(art.storagePath);
+}
+/**
+ * List artifacts for an agent, run, or task.
+ */
+export function listArtifacts(opts) {
+    const db = getDb();
+    const conditions = [];
+    const params = [];
+    if (opts.agentId) {
+        conditions.push('agent_id = ?');
+        params.push(opts.agentId);
+    }
+    if (opts.runId) {
+        conditions.push('run_id = ?');
+        params.push(opts.runId);
+    }
+    if (opts.taskId) {
+        conditions.push('task_id = ?');
+        params.push(opts.taskId);
+    }
+    if (conditions.length === 0)
+        conditions.push('1=1');
+    const limit = opts.limit ?? 50;
+    return db.prepare(`SELECT * FROM artifacts WHERE ${conditions.join(' AND ')} ORDER BY created_at DESC LIMIT ?`)
+        .all(...params, limit).map(rowToArtifact);
+}
+/**
+ * Delete artifact (removes file + DB row).
+ */
+export function deleteArtifact(id) {
+    const db = getDb();
+    const art = getArtifact(id);
+    if (!art)
+        return false;
+    try {
+        if (existsSync(art.storagePath))
+            unlinkSync(art.storagePath);
+    }
+    catch { /* best effort */ }
+    db.prepare('DELETE FROM artifacts WHERE id = ?').run(id);
+    return true;
+}
+/**
+ * Get total storage used by an agent.
+ */
+export function getStorageUsage(agentId) {
+    const db = getDb();
+    const row = db.prepare('SELECT COALESCE(SUM(size_bytes), 0) as totalBytes, COUNT(*) as count FROM artifacts WHERE agent_id = ?').get(agentId);
+    return row;
+}
+function guessMimeType(name) {
+    const ext = name.split('.').pop()?.toLowerCase();
+    const map = {
+        'json': 'application/json', 'md': 'text/markdown', 'txt': 'text/plain',
+        'html': 'text/html', 'css': 'text/css', 'js': 'application/javascript',
+        'ts': 'text/typescript', 'png': 'image/png', 'jpg': 'image/jpeg',
+        'jpeg': 'image/jpeg', 'gif': 'image/gif', 'svg': 'image/svg+xml',
+        'pdf': 'application/pdf', 'zip': 'application/zip',
+    };
+    return map[ext ?? ''] ?? 'application/octet-stream';
+}
+//# sourceMappingURL=artifact-store.js.map

package/dist/artifact-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.js","sourceRoot":"","sources":["../src/artifact-store.ts"],"names":[],"mappings":"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"}

package/dist/artifact-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=artifact-store.test.d.ts.map

package/dist/artifact-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.test.d.ts","sourceRoot":"","sources":["../src/artifact-store.test.ts"],"names":[],"mappings":""}

package/dist/artifact-store.test.js

@@ -0,0 +1,119 @@
+// SPDX-License-Identifier: Apache-2.0
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+class InMemoryArtifactStore {
+    artifacts = [];
+    counter = 0;
+    store(agentId, name, content, opts) {
+        const buf = typeof content === 'string' ? Buffer.from(content) : content;
+        const art = {
+            id: `art-${++this.counter}`,
+            agentId, name,
+            runId: opts?.runId ?? null,
+            taskId: opts?.taskId ?? null,
+            mimeType: opts?.mimeType ?? this.guessMime(name),
+            sizeBytes: buf.length,
+            content: buf,
+        };
+        this.artifacts.push(art);
+        return art;
+    }
+    get(id) { return this.artifacts.find(a => a.id === id) ?? null; }
+    read(id) { return this.get(id)?.content ?? null; }
+    list(opts) {
+        return this.artifacts.filter(a => {
+            if (opts.agentId && a.agentId !== opts.agentId)
+                return false;
+            if (opts.runId && a.runId !== opts.runId)
+                return false;
+            if (opts.taskId && a.taskId !== opts.taskId)
+                return false;
+            return true;
+        });
+    }
+    delete(id) {
+        const idx = this.artifacts.findIndex(a => a.id === id);
+        if (idx === -1)
+            return false;
+        this.artifacts.splice(idx, 1);
+        return true;
+    }
+    usage(agentId) {
+        const mine = this.artifacts.filter(a => a.agentId === agentId);
+        return { totalBytes: mine.reduce((sum, a) => sum + a.sizeBytes, 0), count: mine.length };
+    }
+    guessMime(name) {
+        const ext = name.split('.').pop()?.toLowerCase();
+        if (ext === 'json')
+            return 'application/json';
+        if (ext === 'md')
+            return 'text/markdown';
+        if (ext === 'png')
+            return 'image/png';
+        return 'application/octet-stream';
+    }
+    clear() { this.artifacts = []; this.counter = 0; }
+}
+describe('artifact store', () => {
+    let store;
+    beforeEach(() => { store = new InMemoryArtifactStore(); });
+    it('stores and retrieves artifact', () => {
+        const art = store.store('link', 'report.md', '# Report');
+        assert.ok(art.id.startsWith('art-'));
+        assert.equal(art.name, 'report.md');
+        assert.equal(art.mimeType, 'text/markdown');
+        assert.equal(art.sizeBytes, 8);
+    });
+    it('reads content back', () => {
+        const art = store.store('link', 'data.json', '{"key":"value"}');
+        const content = store.read(art.id);
+        assert.ok(content);
+        assert.equal(content.toString(), '{"key":"value"}');
+    });
+    it('returns null for missing artifact', () => {
+        assert.equal(store.get('nonexistent'), null);
+        assert.equal(store.read('nonexistent'), null);
+    });
+    it('links artifact to run', () => {
+        store.store('link', 'log.txt', 'run output', { runId: 'arun-123' });
+        const results = store.list({ runId: 'arun-123' });
+        assert.equal(results.length, 1);
+        assert.equal(results[0].runId, 'arun-123');
+    });
+    it('links artifact to task', () => {
+        store.store('link', 'screenshot.png', Buffer.alloc(100), { taskId: 'task-456' });
+        const results = store.list({ taskId: 'task-456' });
+        assert.equal(results.length, 1);
+    });
+    it('lists by agent', () => {
+        store.store('link', 'a.md', 'aaa');
+        store.store('kai', 'b.md', 'bbb');
+        store.store('link', 'c.md', 'ccc');
+        assert.equal(store.list({ agentId: 'link' }).length, 2);
+        assert.equal(store.list({ agentId: 'kai' }).length, 1);
+    });
+    it('deletes artifact', () => {
+        const art = store.store('link', 'temp.txt', 'temp');
+        assert.equal(store.delete(art.id), true);
+        assert.equal(store.get(art.id), null);
+        assert.equal(store.delete(art.id), false);
+    });
+    it('tracks storage usage', () => {
+        store.store('link', 'a.txt', 'hello'); // 5 bytes
+        store.store('link', 'b.txt', 'world!'); // 6 bytes
+        const usage = store.usage('link');
+        assert.equal(usage.count, 2);
+        assert.equal(usage.totalBytes, 11);
+    });
+    it('uses correct MIME types', () => {
+        assert.equal(store.store('link', 'file.json', '{}').mimeType, 'application/json');
+        assert.equal(store.store('link', 'file.md', '#').mimeType, 'text/markdown');
+        assert.equal(store.store('link', 'file.png', Buffer.alloc(1)).mimeType, 'image/png');
+        assert.equal(store.store('link', 'file.xyz', 'x').mimeType, 'application/octet-stream');
+    });
+    it('allows custom MIME type override', () => {
+        const art = store.store('link', 'data.bin', 'custom', { mimeType: 'application/x-custom' });
+        assert.equal(art.mimeType, 'application/x-custom');
+    });
+});
+//# sourceMappingURL=artifact-store.test.js.map

package/dist/artifact-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.test.js","sourceRoot":"","sources":["../src/artifact-store.test.ts"],"names":[],"mappings":"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"}

package/dist/boardHealthWorker.d.ts

@@ -48,7 +48,18 @@ export interface BoardHealthWorkerConfig {
     reviewSlaThresholdMin: number;
     /** Fallback reviewer when no active agent is available (default: 'ryan') */
     reviewEscalationTarget: string;
+    /**
+     * Post-restart quiet window in milliseconds (default: 5 min).
+     * Ready-queue alerts are suppressed for this duration after process start
+     * to give the continuity loop time to replenish queues before watchdog fires.
+     * Set to 0 in tests that need immediate breach detection.
+     */
+    restartQuietWindowMs: number;
 }
+/** Read persisted lastDigestAt from the kv table (survives process restarts). */
+export declare function readPersistedDigestAt(): number;
+/** Persist lastDigestAt so it survives process restarts. */
+export declare function writePersistedDigestAt(ts: number): void;
 export declare class BoardHealthWorker {
     private config;
     private auditLog;
@@ -59,6 +70,13 @@ export declare class BoardHealthWorker {
     constructor(config?: Partial<BoardHealthWorkerConfig>);
     start(): void;
     stop(): void;
+    /**
+     * Reset the quiet window — suppresses ready-queue alerts for
+     * `restartQuietWindowMs` from now. Call when a gateway restart or
+     * reconnection is detected so agents have time to re-establish presence
+     * before idle alerts fire.
+     */
+    resetQuietWindow(): void;
     updateConfig(patch: Partial<BoardHealthWorkerConfig>): void;
     getConfig(): BoardHealthWorkerConfig;
     tick(options?: {
@@ -80,6 +98,20 @@ export declare class BoardHealthWorker {
     private readyQueueLastState;
     /** Track when each agent's queue first went empty (for idle escalation) */
     private idleQueueSince;
+    /**
+     * Quiet-window anchor — used to enforce a post-restart quiet window.
+     * For the first `restartQuietWindowMs` after this timestamp, ready-queue
+     * alerts are suppressed so agents have time to reconnect and replenish queues.
+     *
+     * Initially set to process start (node restart). Also reset by
+     * `resetQuietWindow()` when an external event (e.g. gateway restart)
+     * warrants a fresh suppression window.
+     *
+     * Tests that need immediate breach detection should set restartQuietWindowMs: 0
+     * in the constructor config.
+     */
+    private readonly startedAt;
+    private lastQuietReset;
     private checkReadyQueueFloor;
     /** Track last replenish time per agent to enforce cooldown between auto-creates */
     private replenishLastAt;

package/dist/boardHealthWorker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boardHealthWorker.d.ts","sourceRoot":"","sources":["../src/boardHealthWorker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"boardHealthWorker.d.ts","sourceRoot":"","sources":["../src/boardHealthWorker.ts"],"names":[],"mappings":"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"}

package/dist/boardHealthWorker.js

@@ -19,6 +19,8 @@ import { presenceManager } from './presence.js';
 import { suggestReviewer, getAgentRoles } from './assignment.js';
 import { isTestHarnessTask } from './test-task-filter.js';
 import { recordSystemLoopTick } from './system-loop-state.js';
+import { isWaitingOnAuthor } from './review-state.js';
+import { getDb } from './db.js';
 const DEFAULT_CONFIG = {
     enabled: true,
     intervalMs: 5 * 60 * 1000, // 5 minutes
@@ -34,12 +36,34 @@ const DEFAULT_CONFIG = {
     inactiveAgentThresholdMin: 1440, // 24 hours
     reviewSlaThresholdMin: 480, // 8 hours
     reviewEscalationTarget: 'ryan',
+    restartQuietWindowMs: 5 * 60_000, // 5 minutes — suppress post-restart thundering herd
 };
 // ── Worker ─────────────────────────────────────────────────────────────────
+const KV_DIGEST_KEY = 'board_health_last_digest_at';
+/** Read persisted lastDigestAt from the kv table (survives process restarts). */
+export function readPersistedDigestAt() {
+    try {
+        const row = getDb().prepare('SELECT value FROM kv WHERE key = ?').get(KV_DIGEST_KEY);
+        const parsed = row ? parseInt(row.value, 10) : 0;
+        return isNaN(parsed) ? 0 : parsed;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Persist lastDigestAt so it survives process restarts. */
+export function writePersistedDigestAt(ts) {
+    try {
+        getDb().prepare('INSERT OR REPLACE INTO kv (key, value) VALUES (?, ?)').run(KV_DIGEST_KEY, String(ts));
+    }
+    catch {
+        // Non-fatal — fall back to in-memory only
+    }
+}
 export class BoardHealthWorker {
     config;
     auditLog = [];
-    lastDigestAt = 0;
+    lastDigestAt = readPersistedDigestAt();
     lastTickAt = 0;
     tickCount = 0;
     timer = null;
@@ -63,6 +87,15 @@ export class BoardHealthWorker {
             this.timer = null;
         }
     }
+    /**
+     * Reset the quiet window — suppresses ready-queue alerts for
+     * `restartQuietWindowMs` from now. Call when a gateway restart or
+     * reconnection is detected so agents have time to re-establish presence
+     * before idle alerts fire.
+     */
+    resetQuietWindow() {
+        this.lastQuietReset = Date.now();
+    }
     updateConfig(patch) {
         const wasEnabled = this.config.enabled;
         this.config = { ...this.config, ...patch };
@@ -178,11 +211,18 @@ export class BoardHealthWorker {
             catch { /* continuity loop may not be loaded */ }
         }
         // 4. Emit digest if interval elapsed
+        // Re-read persisted value each tick in case another process updated it.
+        if (!dryRun) {
+            const persisted = readPersistedDigestAt();
+            if (persisted > this.lastDigestAt)
+                this.lastDigestAt = persisted;
+        }
         let digest = null;
         if (force || now - this.lastDigestAt >= this.config.digestIntervalMs) {
             digest = await this.emitDigest(now, actions, dryRun);
             if (!dryRun) {
                 this.lastDigestAt = now;
+                writePersistedDigestAt(now);
             }
         }
         return { actions, digest, skipped: false };
@@ -323,6 +363,20 @@ export class BoardHealthWorker {
     readyQueueLastState = {};
     /** Track when each agent's queue first went empty (for idle escalation) */
     idleQueueSince = {};
+    /**
+     * Quiet-window anchor — used to enforce a post-restart quiet window.
+     * For the first `restartQuietWindowMs` after this timestamp, ready-queue
+     * alerts are suppressed so agents have time to reconnect and replenish queues.
+     *
+     * Initially set to process start (node restart). Also reset by
+     * `resetQuietWindow()` when an external event (e.g. gateway restart)
+     * warrants a fresh suppression window.
+     *
+     * Tests that need immediate breach detection should set restartQuietWindowMs: 0
+     * in the constructor config.
+     */
+    startedAt = Date.now();
+    lastQuietReset = Date.now();
     async checkReadyQueueFloor(now, dryRun) {
         const policy = policyManager.get();
         const rqf = policy.readyQueueFloor;
@@ -363,7 +417,15 @@ export class BoardHealthWorker {
             let lastAlert = this.readyQueueLastAlertAt[agent] || 0;
             const cooldownMs = (rqf.cooldownMin || 30) * 60_000;
             // Ready-queue floor check (breach vs info)
-            if (belowFloor && now - lastAlert > cooldownMs) {
+            // Post-restart quiet window: suppress alerts for restartQuietWindowMs after startup.
+            // Prevents thundering-herd — all agents with no prior alert record (lastAlertAt=0)
+            // would otherwise fire simultaneously on the first post-restart sweep.
+            // restartQuietWindowMs can be set to 0 in tests for immediate breach detection.
+            // Quiet window: suppress alerts shortly after any restart (node start OR gateway reconnect).
+            // Uses the most recent of startedAt and lastQuietReset as the anchor.
+            const quietAnchor = Math.max(this.startedAt, this.lastQuietReset);
+            const inStartupQuiet = lastAlert === 0 && (now - quietAnchor) < this.config.restartQuietWindowMs;
+            if (belowFloor && now - lastAlert > cooldownMs && !inStartupQuiet) {
                 const deficit = rqf.minReady - readyCount;
                 // State fingerprint: suppress if identical to last alert
                 const blockedTasks = todoTasks.filter(t => !unblockedTodo.includes(t));
@@ -568,6 +630,11 @@ export class BoardHealthWorker {
                 continue;
             // Check reviewer activity on this task using the review_last_activity_at metadata field
             const meta = (task.metadata || {});
+            // ── Skip tasks where reviewer has already acted ──
+            // Canonical precedence rule: reviewer_decision suppresses reviewer-facing
+            // SLA paging even when review_state was not populated.
+            if (isWaitingOnAuthor(meta))
+                continue;
             const reviewEnteredAt = normalizeEpochMs(meta.entered_validating_at) || (task.updatedAt ?? task.createdAt);
             const reviewLastActivityAt = normalizeEpochMs(meta.review_last_activity_at) || reviewEnteredAt;
             // Use the more recent of entered_validating and review_last_activity