@agentdeck/bridge 0.2.2 → 0.2.3

package/dist/ble-sync-spawn.js

@@ -0,0 +1,196 @@
+/**
+ * Shared spawn helper for the daemon-managed Python BLE sync clients
+ * (iDotMatrix `sync.py`, Timebox `sync_ble.py`).
+ *
+ * Both clients were previously spawned with `stdio: 'ignore'`, which keeps the
+ * child's verbose stdout from flooding the daemon log — but also discards the
+ * crash traceback on stderr. A missing `bleak`/`idotmatrix` dependency, a stale
+ * venv, or a bad BLE address then looks identical to a clean exit: the panel
+ * goes dark and the daemon logs only "respawning in Ns" with no cause. This
+ * helper pipes stdout/stderr into small ring buffers so the manager can log
+ * *why* the sync died without flooding the daemon log while it is running.
+ */
+import { spawn } from 'child_process';
+/**
+ * Spawn a Python sync child with stdout/stderr captured into bounded tail
+ * buffers. Output is not streamed live; callers read it only if the child exits.
+ */
+export function spawnPythonSync(venvPython, args, maxTailLines = 8) {
+    // [stdin ignored, stdout/stderr piped into small rings for diagnostics]
+    const proc = spawn(venvPython, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+    const stderrTail = [];
+    const outputTail = [];
+    let stderrPartial = '';
+    let stdoutPartial = '';
+    const capture = (label, chunk) => {
+        let partial = label === 'stderr' ? stderrPartial : stdoutPartial;
+        partial += chunk.toString();
+        const lines = partial.split('\n');
+        partial = lines.pop() ?? '';
+        for (const line of lines) {
+            const trimmed = line.trimEnd();
+            if (!trimmed)
+                continue;
+            const tagged = `${label}: ${trimmed}`;
+            outputTail.push(tagged);
+            if (outputTail.length > maxTailLines)
+                outputTail.shift();
+            if (label === 'stderr') {
+                stderrTail.push(trimmed);
+                if (stderrTail.length > maxTailLines)
+                    stderrTail.shift();
+            }
+        }
+        if (label === 'stderr')
+            stderrPartial = partial;
+        else
+            stdoutPartial = partial;
+    };
+    proc.stdout?.on('data', (chunk) => capture('stdout', chunk));
+    proc.stderr?.on('data', (chunk) => capture('stderr', chunk));
+    return {
+        proc,
+        stderrTail: () => {
+            const lines = stderrPartial.trim() ? [...stderrTail, stderrPartial.trim()] : stderrTail;
+            return lines.slice(-maxTailLines).join(' | ');
+        },
+        outputTail: () => {
+            const lines = [...outputTail];
+            if (stdoutPartial.trim())
+                lines.push(`stdout: ${stdoutPartial.trim()}`);
+            if (stderrPartial.trim())
+                lines.push(`stderr: ${stderrPartial.trim()}`);
+            return lines.slice(-maxTailLines).join(' | ');
+        },
+    };
+}
+/** Emit a repeated-cycle summary at most this often while suppressing. */
+const SQUELCH_SUMMARY_INTERVAL_MS = 60 * 60_000;
+/** A run this long means the previous respawn loop ended; the next exit logs fresh. */
+const SQUELCH_RESET_UPTIME_MS = 5 * 60_000;
+/**
+ * Collapse variable parts so consecutive exits from the same failure loop
+ * compare equal: timestamps/addresses/hashes are masked, and the ` | `-joined
+ * output tail is reduced to its set of distinct lines — the ring buffer
+ * captures 1 or 2 copies of the same retry error depending on timing, which
+ * must not read as a different cycle.
+ */
+function cycleSignature(code, signal, tail) {
+    const masked = tail.replace(/[0-9A-Fa-f]{4,}/g, '#').replace(/\d+/g, '#');
+    const segments = [...new Set(masked.split(' | ').map((s) => s.trim()))].sort();
+    return `${code}|${signal}|${segments.join(' | ')}`;
+}
+/**
+ * Log gate for the respawn loop of a managed BLE sync child.
+ *
+ * A powered-off or out-of-range panel makes the sync child exit the same way
+ * every backoff period, all night — thousands of identical start/exit pairs in
+ * the daemon log. The gate logs the first two occurrences of an exit cycle in
+ * full, then suppresses identical repeats (including their respawn start
+ * lines), emitting an hourly count summary instead. Any *different* exit —
+ * new error text, non-zero code, a crash after a long healthy run — flushes
+ * the summary and logs immediately, so novel failures are never hidden.
+ */
+export function createSyncCycleSquelch(log) {
+    let lastSignature = null;
+    let repeats = 0; // suppressed repeats of lastSignature (beyond the logged first occurrence)
+    let suppressedSinceSummary = 0;
+    let suppressedSince = 0;
+    let lastSummaryAt = 0;
+    let lastLine = '';
+    const flush = () => {
+        if (suppressedSinceSummary > 0) {
+            log(`suppressed ${suppressedSinceSummary} repeats of the same sync cycle since ` +
+                `${new Date(suppressedSince).toISOString()}; latest: ${lastLine}`);
+        }
+        lastSignature = null;
+        repeats = 0;
+        suppressedSinceSummary = 0;
+    };
+    return {
+        logStart(line) {
+            if (repeats > 0)
+                return; // inside a suppressed repeating cycle
+            log(line);
+        },
+        logExit(code, signal, uptimeMs, tail, line) {
+            // A long healthy run means the old loop ended; whatever exits next is a
+            // fresh incident even if the text matches the old one.
+            if (uptimeMs >= SQUELCH_RESET_UPTIME_MS)
+                flush();
+            const signature = cycleSignature(code, signal, tail);
+            if (signature !== lastSignature) {
+                flush();
+                lastSignature = signature;
+                log(line);
+                return;
+            }
+            repeats += 1;
+            suppressedSinceSummary += 1;
+            lastLine = line;
+            const now = Date.now();
+            if (repeats === 1) {
+                // Second identical cycle: log it once more, then go quiet.
+                suppressedSinceSummary = 0;
+                suppressedSince = now;
+                lastSummaryAt = now;
+                log(`${line} — repeating cycle; suppressing identical start/exit logs (hourly summary, a different exit logs immediately)`);
+                return;
+            }
+            if (now - lastSummaryAt >= SQUELCH_SUMMARY_INTERVAL_MS) {
+                log(`suppressed ${suppressedSinceSummary} repeats of the same sync cycle in the last ` +
+                    `${Math.round((now - lastSummaryAt) / 60_000)}m; latest: ${lastLine}`);
+                lastSummaryAt = now;
+                suppressedSinceSummary = 0;
+            }
+        },
+    };
+}
+/**
+ * SIGTERM a managed sync child and wait (bounded) for it to exit, so the child's
+ * OFFLINE / blank farewell frame finishes painting before the daemon process
+ * exits.
+ *
+ * The Python sync clients trap SIGTERM, break their loop, push a final OFFLINE
+ * (iDotMatrix) or black (Timebox) frame over BLE, then disconnect. That push
+ * takes ~1s. If we only fire SIGTERM and return immediately (the old behaviour),
+ * the daemon exits right away; when the daemon is a launchd job, launchd then
+ * tears the job down and SIGKILLs the orphaned child mid-farewell — leaving the
+ * stateful BLE panel frozen on its last dashboard frame instead of OFFLINE.
+ * Awaiting the child's exit here keeps the daemon alive just long enough for the
+ * farewell to land. Escalates to SIGKILL if the child overruns `timeoutMs`.
+ */
+export function terminateSyncChild(proc, timeoutMs = 3_000) {
+    return new Promise((resolve) => {
+        if (proc.exitCode !== null || proc.signalCode !== null) {
+            resolve();
+            return;
+        }
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            try {
+                proc.kill('SIGKILL');
+            }
+            catch {
+                /* already gone */
+            }
+            finish();
+        }, timeoutMs);
+        timer.unref?.();
+        proc.once('exit', finish);
+        try {
+            proc.kill('SIGTERM');
+        }
+        catch {
+            finish();
+        }
+    });
+}
+//# sourceMappingURL=ble-sync-spawn.js.map

package/dist/ble-sync-spawn.js.map

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

package/dist/bridge-core.d.ts

@@ -9,12 +9,28 @@ import { BridgeTimelineStore } from './timeline-store.js';
 import type { BridgeLogStream } from './log-stream.js';
 import { type ApiUsageData } from './usage-api.js';
 import type { ApmeModule } from './apme/index.js';
-import { type BridgeEvent, type StateSnapshot, type AgentType, type AgentCapabilities, type ModelCatalogEntry, type VoiceAssistantState } from './types.js';
+import { type BridgeEvent, type StateSnapshot, type AgentType, type AgentCapabilities, type ModelCatalogEntry, type VoiceAssistantState, type TimelineEntry } from './types.js';
+export declare const INITIAL_TIMELINE_HISTORY_MAX_BYTES: number;
+/** Attach host-local "HH:MM" to a timeline entry. Devices have no timezone
+ * (their NTP runs UTC), so rendering `ts` directly shows a 9-hour-off clock
+ * in KST. Stamped at the SOURCE (broadcast + history) so both the serial and
+ * WS transports carry it; native apps simply ignore the extra field. */
+export declare function stampLocalHm<T extends {
+    ts?: number;
+    localHm?: string;
+}>(entry: T): T;
+export declare function buildCappedTimelineHistory(entries: TimelineEntry[], maxBytes?: number, extraFields?: Record<string, unknown>): BridgeEvent | null;
 export interface BridgeCoreOptions {
     port: number;
     sessionId?: string;
     projectName: string;
     httpServer: Server;
+    /**
+     * True for the daemon hub. The hub aggregates many agents and has no single
+     * session model, so it must always expose the account-level Claude subscription
+     * quota in usage events rather than gating it on the (arbitrary) active model.
+     */
+    isDaemon?: boolean;
 }
 /**
  * Shared infrastructure extracted from index.ts and daemon-server.ts.
@@ -47,6 +63,7 @@ export declare class BridgeCore {
     cachedAntigravityStatus: import("./antigravity-local.js").AntigravityStatusInfo | null;
     cachedGatewayAvailable: boolean;
     cachedGatewayConnected: boolean;
+    cachedGatewayAuthStatus: 'gateway_not_found' | 'gateway_reachable' | 'gateway_token_missing' | 'pairing_required' | 'approval_pending' | 'connected' | 'auth_failed' | 'token_mismatch' | 'device_auth_invalid' | 'unsupported_protocol';
     cachedGatewayHasError: boolean;
     cachedModelCatalog: ModelCatalogEntry[] | null;
     cachedVoiceAssistantState: VoiceAssistantState;
@@ -55,6 +72,7 @@ export declare class BridgeCore {
     private intervals;
     private timeouts;
     private lastSessionsListBroadcast;
+    private lastSessionsListEvent;
     private shutdownInProgress;
     private shutdownCallbacks;
     private sseBroadcast?;
@@ -69,6 +87,8 @@ export declare class BridgeCore {
     private apmeAgentType;
     private apmeCwd;
     private static readonly USAGE_STALE_TTL;
+    /** True when this core backs the daemon hub (see BridgeCoreOptions.isDaemon). */
+    readonly isDaemon: boolean;
     constructor(opts: BridgeCoreOptions);
     /** Set optional SSE broadcast callback (for HookServer-based sessions) */
     setSseBroadcast(cb: (evt: BridgeEvent) => void): void;
@@ -132,6 +152,9 @@ export declare class BridgeCore {
     private hasClients;
     /** Broadcast enriched sessions list (debounced 2s from state_changed) */
     broadcastSessionsList(): Promise<void>;
+    /** The most recent sessions_list event, for the ESP32 serial heartbeat
+     *  re-sync. Null until the first broadcast. */
+    getLastSessionsListEvent(): BridgeEvent | null;
     /** Debounced sessions list broadcast (for state_changed handler) */
     maybeBroadcastSessionsList(): void;
     /**

package/dist/bridge-core.d.ts.map

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

package/dist/bridge-core.js

@@ -8,16 +8,65 @@ import { BridgeTimelineStore } from './timeline-store.js';
 import { readAntigravityLocalStatus } from './antigravity-local.js';
 import { buildSubscriptions, buildUsageEvent } from './usage-event.js';
 import { readCodexAuthStatus } from './codex-auth.js';
+import { readCodexRateLimits } from './codex-rate-limits.js';
 import { fetchMlxModels } from './mlx-probe.js';
+import { buildDisplayStateEvent } from './display-dim.js';
 import { loadMlxSettings } from '@agentdeck/shared';
 import { probeGateway, checkGatewayHealth } from './gateway-probe.js';
 import { fetchUsageFromApi, hasOAuthToken, getTokenStatus } from './usage-api.js';
 import { buildEnrichedSessionsList } from './session-aggregator.js';
+import { activityFor } from './session-activity.js';
 import { register as registerSession, deregister as deregisterSession, } from './session-registry.js';
 import { getOrCreateToken, getWsUrl } from './auth.js';
 import { log, logError, debug } from './logger.js';
-import { invalidateMdnsInstance } from './mdns.js';
+import { invalidateMdnsInstance, isNonFatalMdnsError } from './mdns.js';
 import { State, } from './types.js';
+// log(), logError(), debug() imported from logger.ts
+// - log(): suppressed in PTY mode (after setPtyMode(true))
+// - logError(): always shown (critical errors requiring user action)
+// - debug(): file-only (when --debug enabled)
+// links2004/WebSockets, used by the ESP32-C3 e-ink firmware, closes inbound
+// frames above 15KB with 1009 before the firmware parser can see them. Keep the
+// initial replay comfortably below that library cap; Detail views can request a
+// scoped session replay later via query_session_timeline.
+export const INITIAL_TIMELINE_HISTORY_MAX_BYTES = 12 * 1024;
+/** Attach host-local "HH:MM" to a timeline entry. Devices have no timezone
+ * (their NTP runs UTC), so rendering `ts` directly shows a 9-hour-off clock
+ * in KST. Stamped at the SOURCE (broadcast + history) so both the serial and
+ * WS transports carry it; native apps simply ignore the extra field. */
+export function stampLocalHm(entry) {
+    if (!entry || !Number.isFinite(entry.ts) || entry.localHm)
+        return entry;
+    const d = new Date(entry.ts);
+    return {
+        ...entry,
+        localHm: `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`,
+    };
+}
+export function buildCappedTimelineHistory(entries, maxBytes = INITIAL_TIMELINE_HISTORY_MAX_BYTES, extraFields = {}) {
+    const stamped = entries.map((e) => stampLocalHm(e));
+    const kept = [];
+    for (let i = stamped.length - 1; i >= 0; i--) {
+        const candidate = [stamped[i], ...kept];
+        const event = { type: 'timeline_history', ...extraFields, entries: candidate };
+        if (Buffer.byteLength(JSON.stringify(event), 'utf8') <= maxBytes) {
+            kept.unshift(stamped[i]);
+        }
+    }
+    return kept.length > 0 ? { type: 'timeline_history', ...extraFields, entries: kept } : null;
+}
+function exitProcessNow(code = 0) {
+    if (code === 0) {
+        try {
+            process.kill(process.pid, 'SIGKILL');
+            return;
+        }
+        catch {
+            // fall through
+        }
+    }
+    process.exit(code);
+}
 // ===== BridgeCore =====
 /**
  * Shared infrastructure extracted from index.ts and daemon-server.ts.
@@ -53,6 +102,7 @@ export class BridgeCore {
     cachedAntigravityStatus = readAntigravityLocalStatus() ?? null;
     cachedGatewayAvailable = false;
     cachedGatewayConnected = false;
+    cachedGatewayAuthStatus = 'gateway_not_found';
     cachedGatewayHasError = false;
     cachedModelCatalog = null;
     // Voice assistant state (for piggybacking on state_update)
@@ -63,6 +113,7 @@ export class BridgeCore {
     intervals = [];
     timeouts = [];
     lastSessionsListBroadcast = 0;
+    lastSessionsListEvent = null;
     shutdownInProgress = false;
     shutdownCallbacks = [];
     sseBroadcast;
@@ -77,10 +128,13 @@ export class BridgeCore {
     apmeAgentType = null;
     apmeCwd;
     static USAGE_STALE_TTL = 10 * 60 * 1000; // 10 minutes
+    /** True when this core backs the daemon hub (see BridgeCoreOptions.isDaemon). */
+    isDaemon;
     constructor(opts) {
         this.port = opts.port;
         this.sessionId = opts.sessionId ?? randomUUID();
         this.projectName = opts.projectName;
+        this.isDaemon = opts.isDaemon ?? false;
         // Core components
         this.usageTracker = new UsageTracker();
         this.stateMachine = new StateMachine(this.usageTracker);
@@ -105,13 +159,50 @@ export class BridgeCore {
     }
     // ===== Timeline wiring =====
     wireTimeline(logStream) {
+        // Attribute every entry to this session at *storage time* so history
+        // replay (`timeline_history`) carries the same task/run/session metadata
+        // as live `timeline_event` broadcasts. taskId/runId pull from live APME
+        // state — turn rows inherit the active task header without each emitter
+        // having to thread the task id through.
+        //
+        // Idempotent: caller-set fields take precedence. This means relayed
+        // entries (e.g. timeline_event from session bridges into the daemon)
+        // keep their original sessionId/taskId; only entries emitted on this
+        // BridgeCore's own session get filled in.
+        this.bridgeTimeline.setAttributor((entry) => {
+            const apme = this.apme;
+            const sessionId = entry.sessionId ?? this.sessionId;
+            const taskId = entry.taskId ?? (apme ? apme.collector.getActiveTaskId(this.sessionId) ?? undefined : undefined);
+            const runId = entry.runId ?? (apme ? apme.collector.getRunId(this.sessionId) ?? undefined : undefined);
+            // agentType backfill — the single place every timeline row acquires its
+            // brand. Priority: caller-set → per-session collector run (authoritative
+            // for observed hook sessions, where this BridgeCore's own agentType is
+            // 'daemon') → this bridge's own session agent (managed session bridges
+            // whose collector run may not exist yet). 'daemon' is never stamped: it
+            // would mislabel every observed session's rows with the hub's identity.
+            const ownAgent = this.apmeAgentType && this.apmeAgentType !== 'daemon'
+                ? this.apmeAgentType : undefined;
+            const runAgent = apme ? apme.collector.getRunAgentType(sessionId) : null;
+            const agentType = entry.agentType ?? runAgent ?? ownAgent ?? undefined;
+            return {
+                ...entry,
+                projectName: entry.projectName ?? this.projectName,
+                sessionId,
+                ...(agentType ? { agentType } : {}),
+                ...(taskId ? { taskId } : {}),
+                ...(runId ? { runId } : {}),
+            };
+        });
         if (logStream) {
             logStream.on('entry', (entry) => {
                 this.bridgeTimeline.addEntry(entry);
             });
         }
         this.bridgeTimeline.onEntry((entry, upsert) => {
-            const evt = { type: 'timeline_event', entry, ...(upsert ? { upsert: true } : {}) };
+            // Entry is already attributed by the storage-time attributor above;
+            // forward as-is (plus the device-local HH:MM stamp). Doing the
+            // attribution here too would be redundant and risks divergence.
+            const evt = { type: 'timeline_event', entry: stampLocalHm(entry), ...(upsert ? { upsert: true } : {}) };
             this.broadcast(evt);
         });
     }
@@ -119,16 +210,16 @@ export class BridgeCore {
     _previousDisplayOn = true;
     _wakeHandler = null;
     wireDisplayMonitor() {
-        this.displayMonitor.start();
         this.displayMonitor.on('display_state_changed', (displayOn) => {
             // Detect wake transition (asleep → awake)
             if (displayOn && !this._previousDisplayOn) {
                 this._wakeHandler?.();
             }
             this._previousDisplayOn = displayOn;
-            const evt = { type: 'display_state', displayOn };
+            const evt = buildDisplayStateEvent(displayOn);
             this.broadcast(evt);
         });
+        this.displayMonitor.start();
         // Time-discontinuity safety net (python3 process may die during deep sleep)
         let lastTick = Date.now();
         setInterval(() => {
@@ -195,6 +286,7 @@ export class BridgeCore {
             antigravityStatus: this.cachedAntigravityStatus ?? undefined,
             gatewayAvailable: this.cachedGatewayAvailable,
             gatewayConnected: this.cachedGatewayConnected,
+            gatewayAuthStatus: this.cachedGatewayAuthStatus,
             gatewayHasError: this.cachedGatewayHasError,
             moduleHealth: this.moduleHealthProvider?.(),
             voiceAssistantState: this.cachedVoiceAssistantState !== 'disabled' ? this.cachedVoiceAssistantState : undefined,
@@ -213,7 +305,7 @@ export class BridgeCore {
     /** Build and return a usage event */
     buildUsage() {
         const snapshot = this.stateMachine.getSnapshot();
-        return buildUsageEvent(snapshot, this.cachedApiUsage, this.oauthConnected, this.cachedOllamaStatus, this.cachedMlxModels, this.apiUsageStale, readCodexAuthStatus(), snapshot.billingType, this.cachedModelCatalog, this.cachedAntigravityStatus, this.apiUsagePreAdjusted);
+        return buildUsageEvent(snapshot, this.cachedApiUsage, this.oauthConnected, this.cachedOllamaStatus, this.cachedMlxModels, this.apiUsageStale, readCodexAuthStatus(), snapshot.billingType, this.cachedModelCatalog, this.cachedAntigravityStatus, this.apiUsagePreAdjusted, this.isDaemon, readCodexRateLimits());
     }
     /** Broadcast current usage to all clients */
     broadcastUsage() {
@@ -331,6 +423,8 @@ export class BridgeCore {
             }
             else if (!status.available && wasAvailable) {
                 this.cachedGatewayConnected = false;
+                this.cachedGatewayAuthStatus = 'gateway_not_found';
+                this.cachedGatewayHasError = false;
                 onDisappeared?.();
             }
             if (status.available !== wasAvailable) {
@@ -424,7 +518,25 @@ export class BridgeCore {
         let sessions = await buildEnrichedSessionsList(this.sessionId, snapshot.state, snapshot.modelName ?? undefined, snapshot.effortLevel ?? undefined);
         if (this.sessionsEnricher)
             sessions = this.sessionsEnricher(sessions);
-        this.wsServer.broadcast({ type: 'sessions_list', sessions });
+        // Attach the shared per-session activity one-liner to the FINAL list (covers
+        // managed + observed sessions). Heuristic is immediate; a Foundation Models
+        // summary, when available, lands on a later periodic broadcast via the cache.
+        for (const s of sessions) {
+            const a = activityFor(s);
+            if (a)
+                s.activity = a;
+        }
+        const event = { type: 'sessions_list', sessions };
+        // Cache for the serial heartbeat re-sync (like display_state): a board that
+        // reconnects across a daemon handoff during a quiet window otherwise sits
+        // on an empty roster until the next unrelated session change broadcasts.
+        this.lastSessionsListEvent = event;
+        this.wsServer.broadcast(event);
+    }
+    /** The most recent sessions_list event, for the ESP32 serial heartbeat
+     *  re-sync. Null until the first broadcast. */
+    getLastSessionsListEvent() {
+        return this.lastSessionsListEvent;
     }
     /** Debounced sessions list broadcast (for state_changed handler) */
     maybeBroadcastSessionsList() {
@@ -457,15 +569,25 @@ export class BridgeCore {
             sessionId: this.sessionId,
         });
         // Display state
-        this.wsServer.sendTo(ws, {
-            type: 'display_state',
-            displayOn: this.displayMonitor.isDisplayOn(),
-        });
-        // Timeline history
-        const history = this.bridgeTimeline.getHistory();
-        if (history.length > 0) {
-            this.wsServer.sendTo(ws, { type: 'timeline_history', entries: history });
-        }
+        this.wsServer.sendTo(ws, buildDisplayStateEvent(this.displayMonitor.isDisplayOn()));
+        // Timeline history — entries were already attributed at storage time by
+        // the attributor installed in `wireTimeline`, so they ship with taskId /
+        // runId / sessionId / projectName intact. The `??` fallbacks below
+        // protect entries that landed before `wireTimeline` ran (e.g. very early
+        // boot logStream events) so we never broadcast bare entries.
+        const history = this.bridgeTimeline.getHistory().map((entry) => ({
+            ...entry,
+            projectName: entry.projectName ?? this.projectName,
+            sessionId: entry.sessionId ?? this.sessionId,
+        }));
+        // Always send a timeline_history on connect — an EMPTY one when the store
+        // is empty. Clients replace (not merge) their timeline on this event, so a
+        // freshly-restarted daemon must send `entries: []` to wipe the client's
+        // stale rows; suppressing it (the old `if (historyEvent)`) left old logs
+        // frozen on Android/ESP32 across a daemon restart.
+        const historyEvent = buildCappedTimelineHistory(history)
+            ?? { type: 'timeline_history', entries: [] };
+        this.wsServer.sendTo(ws, historyEvent);
         // Sessions list
         buildEnrichedSessionsList(this.sessionId, snapshot.state, snapshot.modelName ?? undefined, snapshot.effortLevel ?? undefined).then((sessions) => {
             const enriched = this.sessionsEnricher ? this.sessionsEnricher(sessions) : sessions;
@@ -551,11 +673,12 @@ export class BridgeCore {
             const msg = err?.message ?? '';
             const code = err?.code ?? '';
             // mDNS errors are non-critical — network interface changes (sleep/wake,
-            // WiFi reconnect, VPN toggle) cause transient multicast failures.
-            // Null out the mDNS instance so the recovery timer can re-publish.
-            if (msg.includes('already in use on the network') ||
-                (msg.includes('EADDRNOTAVAIL') && msg.includes('5353'))) {
-                debug('mDNS', `error (ignored): ${msg}`);
+            // WiFi reconnect, VPN toggle) and unroutable virtual interfaces (Windows
+            // WSL/Hyper-V — EHOSTUNREACH to 224.0.0.251:5353) cause transient
+            // multicast failures. Null out the mDNS instance so the recovery timer
+            // can re-publish.
+            if (isNonFatalMdnsError(msg, code)) {
+                debug('mDNS', `error (ignored): ${code || msg}`);
                 invalidateMdnsInstance();
                 return;
             }
@@ -602,10 +725,16 @@ export class BridgeCore {
     }
     /** Graceful shutdown */
     async shutdown() {
-        if (this.shutdownInProgress)
+        if (this.shutdownInProgress) {
+            exitProcessNow(0);
             return;
+        }
         this.shutdownInProgress = true;
         log('Shutting down...');
+        const hardExitTimer = setTimeout(() => {
+            logError('Shutdown timeout — forcing exit.');
+            exitProcessNow(0);
+        }, 7000);
         // Clear all timers
         for (const iv of this.intervals)
             clearInterval(iv);
@@ -615,13 +744,17 @@ export class BridgeCore {
         this.deregisterSession();
         // Stop display monitor
         this.displayMonitor.stop();
-        // Run shutdown callbacks (best-effort, 2s total budget)
+        // Run shutdown callbacks (best-effort, 5s total budget). Budget covers the
+        // BLE stateful-panel farewell: device modules (iDotMatrix/Timebox) await
+        // their Python sync child painting a final OFFLINE/blank frame over BLE
+        // (~1-3s) so the panel doesn't freeze on its last dashboard frame.
         const callbacksDone = Promise.all(this.shutdownCallbacks.map(cb => Promise.resolve().then(cb).catch(() => { })));
-        await Promise.race([callbacksDone, new Promise(r => { const t = setTimeout(r, 2000); t.unref(); })]);
+        await Promise.race([callbacksDone, new Promise(r => { const t = setTimeout(r, 5000); t.unref(); })]);
         // Close WS
         this.wsServer.close();
         // Exit immediately — all cleanup is done or timed out
-        process.exit(0);
+        clearTimeout(hardExitTimer);
+        exitProcessNow(0);
     }
 }
 //# sourceMappingURL=bridge-core.js.map