reflectt-node 0.1.14 → 0.1.16

package/dist/product-observation-source.js

@@ -0,0 +1,326 @@
+/**
+ * product-observation-source.ts
+ *
+ * ProductObservationSource — Phase 1 cheap HTTP health probes.
+ *
+ * Triggered by the continuity loop when an agent's queue empties after a
+ * recent ship. Runs lightweight health probes against the local node and
+ * emits findings as Reflection objects, which flow through the existing
+ * intake pipeline (reflection → insight → task).
+ *
+ * Phase 1 probes (this file):
+ *   - HealthProbe: GET /health — checks status + response time
+ *   - AgentsProbe: GET /health/agents — stale/unhealthy agent detection
+ *   - TasksProbe:  GET /tasks — detects stuck doing/validating tasks
+ *   - ChatProbe:   GET /chat/messages — checks message recency (team comms gap)
+ *
+ * Phase 2 (browser probe) is out-of-scope for this task — opt-in, policy flag.
+ *
+ * Integration: call runProductObservation(agent) from tickContinuityLoop()
+ * after insight promotion misses, gated on:
+ *   - queue below floor
+ *   - agent shipped something in last 4h
+ *   - cooldown not active (30m per agent)
+ */
+import { createReflection } from './reflections.js';
+import { ingestReflection } from './insights.js';
+import { getDb } from './db.js';
+// ── Config ─────────────────────────────────────────────────────────────────
+const NODE_BASE_URL = process.env.REFLECTT_NODE_URL || 'http://127.0.0.1:4445';
+const PROBE_TIMEOUT_MS = 5_000; // 5s max per probe
+const SLOW_THRESHOLD_MS = 2_000; // emit finding if response >2s
+const COOLDOWN_MS = 30 * 60 * 1000; // 30 min cooldown per agent
+const RECENT_SHIP_WINDOW_MS = 4 * 60 * 60 * 1000; // 4h ship recency window
+const KV_PREFIX = 'product_obs:'; // kv key prefix for cooldown tracking
+// ── KV helpers (reuse sqlite kv table already in db.ts) ───────────────────
+function kvGet(key) {
+    const db = getDb();
+    try {
+        const row = db.prepare('SELECT value FROM kv WHERE key = ?').get(key);
+        return row?.value ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function kvSet(key, value) {
+    const db = getDb();
+    try {
+        db.prepare(`INSERT INTO kv (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(key, value);
+    }
+    catch { /* kv table may not exist yet */ }
+}
+// ── Cooldown check ─────────────────────────────────────────────────────────
+function isCoolingDown(agent, now) {
+    const key = `${KV_PREFIX}last_run:${agent}`;
+    const lastRun = kvGet(key);
+    if (!lastRun)
+        return false;
+    return now - Number(lastRun) < COOLDOWN_MS;
+}
+function recordRun(agent, now) {
+    kvSet(`${KV_PREFIX}last_run:${agent}`, String(now));
+}
+// ── Recent ship check ──────────────────────────────────────────────────────
+async function agentShippedRecently(agent, now) {
+    try {
+        const ctrl = new AbortController();
+        const timeout = setTimeout(() => ctrl.abort(), PROBE_TIMEOUT_MS);
+        const res = await fetch(`${NODE_BASE_URL}/health/agents`, { signal: ctrl.signal });
+        clearTimeout(timeout);
+        if (!res.ok)
+            return false;
+        const data = await res.json();
+        const entry = data.agents?.find(a => a.agent === agent);
+        if (!entry?.last_shipped_at)
+            return false;
+        return now - entry.last_shipped_at < RECENT_SHIP_WINDOW_MS;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Probe implementations ──────────────────────────────────────────────────
+async function runHealthProbe() {
+    const start = Date.now();
+    try {
+        const ctrl = new AbortController();
+        const timeout = setTimeout(() => ctrl.abort(), PROBE_TIMEOUT_MS);
+        const res = await fetch(`${NODE_BASE_URL}/health`, { signal: ctrl.signal });
+        clearTimeout(timeout);
+        const latencyMs = Date.now() - start;
+        const data = await res.json();
+        const ok = res.ok && data?.status === 'ok';
+        const slow = latencyMs > SLOW_THRESHOLD_MS;
+        return {
+            probe: 'health',
+            ok: ok && !slow,
+            latencyMs,
+            finding: !ok
+                ? `Node health check failed: status=${data?.status ?? res.status}`
+                : slow ? `Node health endpoint slow: ${latencyMs}ms (threshold: ${SLOW_THRESHOLD_MS}ms)` : undefined,
+        };
+    }
+    catch (err) {
+        return {
+            probe: 'health',
+            ok: false,
+            latencyMs: Date.now() - start,
+            finding: `Health probe failed: ${err.message}`,
+        };
+    }
+}
+async function runAgentsProbe() {
+    const start = Date.now();
+    try {
+        const ctrl = new AbortController();
+        const timeout = setTimeout(() => ctrl.abort(), PROBE_TIMEOUT_MS);
+        const res = await fetch(`${NODE_BASE_URL}/health/agents`, { signal: ctrl.signal });
+        clearTimeout(timeout);
+        const latencyMs = Date.now() - start;
+        if (!res.ok) {
+            return { probe: 'agents', ok: false, latencyMs, finding: `/health/agents returned ${res.status}` };
+        }
+        const data = await res.json();
+        const agents = data.agents ?? [];
+        const unhealthy = agents.filter(a => a.state && a.state !== 'healthy');
+        if (unhealthy.length > 0) {
+            const names = unhealthy.map(a => `${a.agent}(${a.state})`).join(', ');
+            return {
+                probe: 'agents',
+                ok: false,
+                latencyMs,
+                finding: `${unhealthy.length} agent(s) not healthy: ${names}`,
+                detail: unhealthy.map(a => `${a.agent}: ${a.stale_reason ?? a.state}`).join('; '),
+            };
+        }
+        const slow = latencyMs > SLOW_THRESHOLD_MS;
+        return {
+            probe: 'agents',
+            ok: !slow,
+            latencyMs,
+            finding: slow ? `Agents endpoint slow: ${latencyMs}ms` : undefined,
+        };
+    }
+    catch (err) {
+        return {
+            probe: 'agents',
+            ok: false,
+            latencyMs: Date.now() - start,
+            finding: `Agents probe failed: ${err.message}`,
+        };
+    }
+}
+async function runTasksProbe() {
+    const start = Date.now();
+    try {
+        const ctrl = new AbortController();
+        const timeout = setTimeout(() => ctrl.abort(), PROBE_TIMEOUT_MS);
+        const res = await fetch(`${NODE_BASE_URL}/tasks?status=doing&compact=true`, { signal: ctrl.signal });
+        clearTimeout(timeout);
+        const latencyMs = Date.now() - start;
+        if (!res.ok) {
+            return { probe: 'tasks', ok: false, latencyMs, finding: `/tasks returned ${res.status}` };
+        }
+        const data = await res.json();
+        const doingTasks = data.tasks ?? [];
+        const now = Date.now();
+        // Flag tasks doing for >4h with no update
+        const stuck = doingTasks.filter(t => t.updatedAt && now - t.updatedAt > 4 * 60 * 60 * 1000);
+        if (stuck.length > 0) {
+            const summaries = stuck.map(t => `${t.id} (@${t.assignee ?? 'unknown'})`).join(', ');
+            return {
+                probe: 'tasks',
+                ok: false,
+                latencyMs,
+                finding: `${stuck.length} task(s) stuck in doing for >4h: ${summaries}`,
+            };
+        }
+        const slow = latencyMs > SLOW_THRESHOLD_MS;
+        return {
+            probe: 'tasks',
+            ok: !slow,
+            latencyMs,
+            finding: slow ? `Tasks endpoint slow: ${latencyMs}ms` : undefined,
+        };
+    }
+    catch (err) {
+        return {
+            probe: 'tasks',
+            ok: false,
+            latencyMs: Date.now() - start,
+            finding: `Tasks probe failed: ${err.message}`,
+        };
+    }
+}
+async function runChatProbe() {
+    const start = Date.now();
+    try {
+        const ctrl = new AbortController();
+        const timeout = setTimeout(() => ctrl.abort(), PROBE_TIMEOUT_MS);
+        const res = await fetch(`${NODE_BASE_URL}/chat/messages?limit=1&compact=true`, { signal: ctrl.signal });
+        clearTimeout(timeout);
+        const latencyMs = Date.now() - start;
+        if (!res.ok) {
+            return { probe: 'chat', ok: false, latencyMs, finding: `/chat/messages returned ${res.status}` };
+        }
+        const data = await res.json();
+        const msgs = data.messages ?? [];
+        const lastMsgTs = msgs[0]?.timestamp;
+        const now = Date.now();
+        const commsGapMs = lastMsgTs ? now - lastMsgTs : null;
+        // Flag team comms gap >6h as a finding
+        const COMMS_GAP_THRESHOLD_MS = 6 * 60 * 60 * 1000;
+        if (commsGapMs !== null && commsGapMs > COMMS_GAP_THRESHOLD_MS) {
+            const hoursAgo = Math.floor(commsGapMs / 3_600_000);
+            return {
+                probe: 'chat',
+                ok: false,
+                latencyMs,
+                finding: `Team comms gap: last message was ${hoursAgo}h ago`,
+                detail: `No chat activity in #general for ${hoursAgo}h — team may be siloed or blocked.`,
+            };
+        }
+        const slow = latencyMs > SLOW_THRESHOLD_MS;
+        return {
+            probe: 'chat',
+            ok: !slow,
+            latencyMs,
+            finding: slow ? `Chat endpoint slow: ${latencyMs}ms` : undefined,
+        };
+    }
+    catch (err) {
+        return {
+            probe: 'chat',
+            ok: false,
+            latencyMs: Date.now() - start,
+            finding: `Chat probe failed: ${err.message}`,
+        };
+    }
+}
+// ── Reflection injection ───────────────────────────────────────────────────
+function findingToReflection(finding, agent) {
+    const severity = finding.latencyMs > SLOW_THRESHOLD_MS && finding.ok === false ? 'high' : 'medium';
+    return {
+        pain: finding.finding ?? `Probe ${finding.probe} reported an issue`,
+        impact: `Detected automatically by product observation probe — ${finding.probe} check failed or degraded`,
+        evidence: [`probe:${finding.probe}:${finding.ok ? 'slow' : 'failed'}`, finding.detail ?? finding.finding ?? 'no detail'].filter(Boolean),
+        went_well: 'Automated monitoring caught this before a human needed to investigate',
+        suspected_why: `${finding.probe} endpoint is either degraded or a background condition is unresolved`,
+        proposed_fix: `Investigate ${finding.probe} endpoint and resolve the underlying condition`,
+        confidence: 6,
+        role_type: 'agent',
+        author: `product-observation:${agent}`,
+        severity,
+        tags: [`probe:${finding.probe}`, 'automated', 'product-observation'],
+        metadata: {
+            probe: finding.probe,
+            latency_ms: finding.latencyMs,
+            source: 'product-observation-source',
+            agent,
+        },
+    };
+}
+// ── Main entry point ───────────────────────────────────────────────────────
+/**
+ * Run product observation probes for an agent.
+ *
+ * Gating (all must be true to run):
+ *   1. Agent shipped something in the last 4h
+ *   2. Cooldown not active (30m since last run for this agent)
+ *
+ * Queue-empty check is the caller's responsibility (tickContinuityLoop).
+ */
+export async function runProductObservation(agent, opts) {
+    const now = Date.now();
+    // Cooldown gate
+    if (!opts?.skipCooldown && isCoolingDown(agent, now)) {
+        const key = `${KV_PREFIX}last_run:${agent}`;
+        const lastRun = Number(kvGet(key) ?? 0);
+        const waitMin = Math.ceil((COOLDOWN_MS - (now - lastRun)) / 60_000);
+        return { agent, probesRun: 0, findings: [], reflectionsCreated: 0, skipped: `cooldown active (${waitMin}m remaining)` };
+    }
+    // Recent ship gate
+    if (!opts?.skipShipCheck) {
+        const shipped = await agentShippedRecently(agent, now);
+        if (!shipped) {
+            return { agent, probesRun: 0, findings: [], reflectionsCreated: 0, skipped: 'no recent ship in last 4h' };
+        }
+    }
+    // Record this run for cooldown tracking
+    recordRun(agent, now);
+    // Run all Phase 1 probes in parallel
+    const results = await Promise.allSettled([
+        runHealthProbe(),
+        runAgentsProbe(),
+        runTasksProbe(),
+        runChatProbe(),
+    ]);
+    const probeResults = results.map((r, i) => {
+        if (r.status === 'fulfilled')
+            return r.value;
+        const names = ['health', 'agents', 'tasks', 'chat'];
+        return { probe: names[i] ?? String(i), ok: false, latencyMs: 0, finding: `Probe threw: ${r.reason.message}` };
+    });
+    // Only emit reflections for probes with findings (failed or slow)
+    const withFindings = probeResults.filter(p => p.finding);
+    let reflectionsCreated = 0;
+    for (const finding of withFindings) {
+        try {
+            const input = findingToReflection(finding, agent);
+            const reflection = createReflection(input);
+            await ingestReflection(reflection);
+            reflectionsCreated++;
+        }
+        catch (err) {
+            console.warn(`[product-observation] failed to ingest reflection for ${finding.probe}:`, err.message);
+        }
+    }
+    return {
+        agent,
+        probesRun: probeResults.length,
+        findings: withFindings,
+        reflectionsCreated,
+    };
+}
+//# sourceMappingURL=product-observation-source.js.map

package/dist/product-observation-source.js.map

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

package/dist/reflection-automation.d.ts

@@ -34,6 +34,28 @@ interface PendingNudge {
     doneAt: number;
     nudgeAt: number;
 }
+export type ReflectionTier = 'none' | 'digest' | 'mention' | 'escalate' | 'immediate';
+/**
+ * 4-tier reflection reminder decision per SIGNAL-ROUTING Change 2 spec.
+ *
+ * | Overdue    | Tier      | Channel |
+ * |------------|-----------|---------|
+ * | < 14h      | none      | —       |
+ * | 14h–24h    | digest    | #ops (batched, no @mention) |
+ * | 24h–48h    | mention   | #ops with @mention, once per 24h |
+ * | 48h+       | escalate  | #ops with @kai, once per 48h |
+ * | post-task  | immediate | #general direct to agent |
+ */
+export declare function getReflectionTier(agent: string, lastReflectionAt: number, justCompletedTask: boolean, nowMs?: number): ReflectionTier;
+/** Exposed for tests — reset dedup state between test runs */
+export declare function _resetTierDedupForTest(): void;
+/**
+ * Dispatch a reflection reminder based on the computed tier.
+ * digest → batchNag (existing batch-before-post gate, Change 4)
+ * mention/escalate → immediate routeMessage to #ops
+ * immediate → routeMessage to #general direct to agent
+ */
+export declare function dispatchReflectionTier(agent: string, tier: ReflectionTier, hoursSince: number, lastReflectionAt: number, config: ReflectionNudgeConfig): Promise<void>;
 export declare function ensureReflectionTrackingTable(): void;
 /**
  * Called when a task transitions to done. Queues a reflection nudge.
@@ -53,6 +75,9 @@ export declare function tickReflectionNudges(): Promise<{
     total: number;
 }>;
 export declare function getReflectionSLAs(): ReflectionSLA[];
+export declare function getBatchWindowMs(): number;
+export declare const _nagBatch: Map<string, string[]>;
+export declare function _flushNagBatch(): void;
 export declare function _clearReflectionTracking(): void;
 export declare function _getPendingNudges(): PendingNudge[];
 export {};

package/dist/reflection-automation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reflection-automation.d.ts","sourceRoot":"","sources":["../src/reflection-automation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAOtC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,CAAA;IACxB,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,4BAA4B,EAAE,MAAM,CAAA;IACpC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,CAAA;CACtC;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAgCD,wBAAgB,6BAA6B,IAAI,IAAI,CAWpD;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CA6B3C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAWzD;AAID;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IACpD,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd,CAAC,CAcD;AA8FD,wBAAgB,iBAAiB,IAAI,aAAa,EAAE,CA0DnD;AAwJD,wBAAgB,wBAAwB,IAAI,IAAI,CAO/C;AAED,wBAAgB,iBAAiB,IAAI,YAAY,EAAE,CAElD"}
+{"version":3,"file":"reflection-automation.d.ts","sourceRoot":"","sources":["../src/reflection-automation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAOtC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,CAAA;IACxB,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAA;IACnB,oDAAoD;IACpD,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,4BAA4B,EAAE,MAAM,CAAA;IACpC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,CAAA;CACtC;AAED,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAeD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;AAErF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,EACxB,iBAAiB,EAAE,OAAO,EAC1B,KAAK,SAAa,GACjB,cAAc,CAsBhB;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAkCf;AA2BD,wBAAgB,6BAA6B,IAAI,IAAI,CAWpD;AAID;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CA6B3C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAWzD;AAID;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IACpD,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd,CAAC,CAcD;AA2GD,wBAAgB,iBAAiB,IAAI,aAAa,EAAE,CA0DnD;AAYD,wBAAgB,gBAAgB,IAAI,MAAM,CAIzC;AAGD,eAAO,MAAM,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAa,CAAA;AAGzD,wBAAgB,cAAc,IAAI,IAAI,CAcrC;AAgJD,wBAAgB,wBAAwB,IAAI,IAAI,CAO/C;AAED,wBAAgB,iBAAiB,IAAI,YAAY,EAAE,CAElD"}

package/dist/reflection-automation.js

@@ -8,6 +8,91 @@ import { policyManager } from './policy.js';
 // ── State ──
 const pendingNudges = [];
 const lastNudgeAt = {};
+// Dedup guards for tiered escalation (SIGNAL-ROUTING Change 2)
+// mention fires at most once per 24h per agent; escalate at most once per 48h.
+// task-1773525631162-cjxch4mrz
+const mentionLastAt = {};
+const escalateLastAt = {};
+const MENTION_DEDUP_MS = 24 * 60 * 60 * 1000;
+const ESCALATE_DEDUP_MS = 48 * 60 * 60 * 1000;
+/**
+ * 4-tier reflection reminder decision per SIGNAL-ROUTING Change 2 spec.
+ *
+ * | Overdue    | Tier      | Channel |
+ * |------------|-----------|---------|
+ * | < 14h      | none      | —       |
+ * | 14h–24h    | digest    | #ops (batched, no @mention) |
+ * | 24h–48h    | mention   | #ops with @mention, once per 24h |
+ * | 48h+       | escalate  | #ops with @kai, once per 48h |
+ * | post-task  | immediate | #general direct to agent |
+ */
+export function getReflectionTier(agent, lastReflectionAt, justCompletedTask, nowMs = Date.now()) {
+    if (justCompletedTask)
+        return 'immediate';
+    const overdueMs = nowMs - lastReflectionAt;
+    const overdueHours = overdueMs / (1000 * 60 * 60);
+    if (overdueHours < 14)
+        return 'none';
+    if (overdueHours < 24)
+        return 'digest';
+    if (overdueHours < 48) {
+        // mention: dedup to once per 24h
+        const lastMention = mentionLastAt[agent] ?? 0;
+        if (nowMs - lastMention < MENTION_DEDUP_MS)
+            return 'none';
+        mentionLastAt[agent] = nowMs; // record on selection so dispatch doesn't double-set
+        return 'mention';
+    }
+    // escalate: dedup to once per 48h
+    const lastEscalate = escalateLastAt[agent] ?? 0;
+    if (nowMs - lastEscalate < ESCALATE_DEDUP_MS)
+        return 'none';
+    escalateLastAt[agent] = nowMs; // record on selection
+    return 'escalate';
+}
+/** Exposed for tests — reset dedup state between test runs */
+export function _resetTierDedupForTest() {
+    for (const k of Object.keys(mentionLastAt))
+        delete mentionLastAt[k];
+    for (const k of Object.keys(escalateLastAt))
+        delete escalateLastAt[k];
+}
+/**
+ * Dispatch a reflection reminder based on the computed tier.
+ * digest → batchNag (existing batch-before-post gate, Change 4)
+ * mention/escalate → immediate routeMessage to #ops
+ * immediate → routeMessage to #general direct to agent
+ */
+export async function dispatchReflectionTier(agent, tier, hoursSince, lastReflectionAt, config) {
+    const opsChannel = 'ops';
+    const now = Date.now();
+    switch (tier) {
+        case 'none':
+            return;
+        case 'digest':
+            // Add to ops batch — batchNag handles flush (Change 4)
+            batchNag(opsChannel, `@${agent}: reflection ${hoursSince}h overdue — submit when you can`);
+            return;
+        case 'mention': {
+            // mentionLastAt already set in getReflectionTier
+            const msg = `🪞 @${agent} reflection overdue ${hoursSince}h — submit when you have a moment. POST /reflections.`;
+            await routeMessage({ from: 'system', content: msg, category: 'watchdog-alert', severity: 'warning', forceChannel: opsChannel }).catch(() => { });
+            return;
+        }
+        case 'escalate': {
+            // escalateLastAt already set in getReflectionTier
+            const lastDate = lastReflectionAt > 0 ? new Date(lastReflectionAt).toISOString().slice(0, 10) : 'never';
+            const msg = `🚨 @kai @${agent} reflection overdue ${hoursSince}h. Last reflection: ${lastDate}. Needs attention.`;
+            await routeMessage({ from: 'system', content: msg, category: 'watchdog-alert', severity: 'critical', forceChannel: opsChannel }).catch(() => { });
+            return;
+        }
+        case 'immediate': {
+            const msg = `🪞 @${agent} task complete — good moment to reflect. POST /reflections.`;
+            batchNag('ops', msg);
+            return;
+        }
+    }
+}
 /** Running guard — prevents concurrent tick calls from firing duplicate nudges */
 let _tickRunning = false;
 /**
@@ -171,19 +256,32 @@ async function _doTick() {
             }
         }
         if (shouldNudge) {
-            await sendIdleNudge(agent, hoursSinceDisplay, tracking?.tasks_done_since_reflection || 0, config);
-            lastNudgeAt[agent] = now;
-            // Record nudge in DB
-            ensureReflectionTrackingTable();
-            const db = getDb();
-            db.prepare(`
-        INSERT INTO reflection_tracking (agent, last_nudge_at, tasks_done_since_reflection, updated_at)
-        VALUES (?, ?, 0, ?)
-        ON CONFLICT(agent) DO UPDATE SET
-          last_nudge_at = ?,
-          updated_at = ?
-      `).run(agent, now, now, now, now);
-            idleNudges++;
+            // Lane-aware suppression: skip nudge if agent has no unblocked todo tasks.
+            // Agents whose in-lane queue is genuinely empty cannot take new work —
+            // nudging them is a false positive (they're compliant, not idle).
+            const unblockedTodo = taskManager.listTasks({
+                status: 'todo',
+                assigneeIn: [agent],
+            }).filter(t => t.status === 'todo');
+            if (unblockedTodo.length === 0)
+                continue;
+            // 4-tier dispatch per SIGNAL-ROUTING Change 2
+            const tier = getReflectionTier(agent, lastReflection, false, now);
+            if (tier !== 'none') {
+                await dispatchReflectionTier(agent, tier, hoursSinceDisplay, lastReflection, config);
+                lastNudgeAt[agent] = now;
+                // Record nudge in DB
+                ensureReflectionTrackingTable();
+                const db = getDb();
+                db.prepare(`
+          INSERT INTO reflection_tracking (agent, last_nudge_at, tasks_done_since_reflection, updated_at)
+          VALUES (?, ?, 0, ?)
+          ON CONFLICT(agent) DO UPDATE SET
+            last_nudge_at = ?,
+            updated_at = ?
+        `).run(agent, now, now, now, now);
+                idleNudges++;
+            }
         }
     }
     return { postTaskNudges, idleNudges, total: postTaskNudges + idleNudges };
@@ -243,41 +341,64 @@ export function getReflectionSLAs() {
         return order[a.status] - order[b.status];
     });
 }
-// ── Nudge messages ──
-async function sendPostTaskNudge(agent, taskId, taskTitle, config, taskStatus) {
-    const isBlocked = taskStatus === 'blocked';
-    const msg = isBlocked
-        ? `🪞 Reflection nudge: @${agent}, "${taskTitle}" (${taskId}) is blocked. ` +
-            `Take 2 min to reflect — what's blocking you, what did you try, and what would unblock it? ` +
-            `Submit via POST /reflections with your observations.`
-        : `🪞 Reflection nudge: @${agent}, you just completed "${taskTitle}" (${taskId}). ` +
-            `Take 2 min to reflect — what went well, what was painful, and what would you change? ` +
-            `Submit via POST /reflections with your observations.`;
-    try {
-        await routeMessage({
+// ── Batch-before-post gate (SIGNAL-ROUTING Change 4) ─────────────────────────
+// All per-agent nags (reflection reminders, idle alerts) go through batchNag()
+// before any channel post. A 5-minute batch window accumulates messages; the
+// flush posts a single Noise Budget Digest instead of N individual posts.
+//
+// Window duration controlled by WATCHDOG_BATCH_WINDOW_MS env var (default 5min).
+// Tests can set WATCHDOG_BATCH_WINDOW_MS to a small value (e.g. 50ms).
+//
+// task-1773525646527-rgpsta72u
+export function getBatchWindowMs() {
+    const envVal = process.env.WATCHDOG_BATCH_WINDOW_MS;
+    if (envVal)
+        return Number(envVal);
+    return 5 * 60 * 1000; // 5 minutes (production default)
+}
+// Exported for testing — allows tests to flush the batch manually
+export const _nagBatch = new Map(); // channel → messages
+let _batchTimer = null;
+export function _flushNagBatch() {
+    for (const [channel, messages] of _nagBatch.entries()) {
+        if (messages.length === 0)
+            continue;
+        const content = `📋 **Reflection & Idle Digest** (${messages.length} reminder${messages.length !== 1 ? 's' : ''}):\n${messages.map(m => `• ${m}`).join('\n')}`;
+        routeMessage({
             from: 'system',
-            content: msg,
+            content,
             category: 'watchdog-alert',
             severity: 'info',
-            forceChannel: config.channel || 'general',
-        });
+            forceChannel: channel,
+        }).catch(() => { });
     }
-    catch { /* chat may not be available */ }
+    _nagBatch.clear();
+    _batchTimer = null;
 }
-async function sendIdleNudge(agent, hoursSince, tasksDone, config) {
-    const taskNote = tasksDone > 0 ? ` You've completed ${tasksDone} task(s) since your last reflection.` : '';
-    const msg = `🪞 Reflection due: @${agent}, it's been ${hoursSince}h since your last reflection.${taskNote} ` +
-        `Take a moment to capture what you've learned. Submit via POST /reflections.`;
-    try {
-        await routeMessage({
-            from: 'system',
-            content: msg,
-            category: 'watchdog-alert',
-            severity: 'warning',
-            forceChannel: config.channel || 'general',
-        });
+function batchNag(channel, message) {
+    const existing = _nagBatch.get(channel);
+    if (existing) {
+        existing.push(message);
     }
-    catch { /* chat may not be available */ }
+    else {
+        _nagBatch.set(channel, [message]);
+    }
+    if (!_batchTimer) {
+        _batchTimer = setTimeout(_flushNagBatch, getBatchWindowMs());
+    }
+}
+// ── Nudge messages ──
+async function sendPostTaskNudge(agent, taskId, taskTitle, config, taskStatus) {
+    const isBlocked = taskStatus === 'blocked';
+    const msg = isBlocked
+        ? `🪞 @${agent}: "${taskTitle}" (${taskId}) is blocked — reflect on what's blocking you`
+        : `🪞 @${agent}: completed "${taskTitle}" (${taskId}) — what went well, what was painful?`;
+    batchNag(config.channel || 'general', msg);
+}
+async function sendIdleNudge(agent, hoursSince, tasksDone, config) {
+    const taskNote = tasksDone > 0 ? ` (${tasksDone} task(s) done since last reflection)` : '';
+    const msg = `🪞 @${agent}: ${hoursSince}h since last reflection${taskNote} — capture what you've learned`;
+    batchNag(config.channel || 'general', msg);
 }
 // ── Helpers ──
 function getConfig() {