backlog-mcp 0.31.0 → 0.32.0

package/dist/events/event-bus.d.mts

@@ -0,0 +1,27 @@
+//#region src/events/event-bus.d.ts
+/**
+ * EventBus interface and event types for real-time viewer updates.
+ *
+ * The interface is designed to be pluggable: start with in-process
+ * EventEmitter (LocalEventBus), swap to Redis Pub/Sub or NATS
+ * for cloud deployment without changing consumers.
+ */
+type BacklogEventType = 'task_changed' | 'task_created' | 'task_deleted' | 'resource_changed';
+interface BacklogEvent {
+  seq: number;
+  type: BacklogEventType;
+  id: string;
+  tool: string;
+  actor: string;
+  ts: string;
+}
+type BacklogEventCallback = (event: BacklogEvent) => void;
+interface EventBus {
+  emit(event: Omit<BacklogEvent, 'seq'>): void;
+  subscribe(callback: BacklogEventCallback): void;
+  unsubscribe(callback: BacklogEventCallback): void;
+  replaySince(seq: number): BacklogEvent[];
+}
+//#endregion
+export { BacklogEvent, BacklogEventCallback, BacklogEventType, EventBus };
+//# sourceMappingURL=event-bus.d.mts.map

package/dist/events/event-bus.mjs

@@ -0,0 +1 @@
+export {  };

package/dist/events/index.d.mts

@@ -0,0 +1,9 @@
+import { BacklogEvent, BacklogEventCallback, BacklogEventType, EventBus } from "./event-bus.mjs";
+import { LocalEventBus } from "./local-event-bus.mjs";
+
+//#region src/events/index.d.ts
+/** Singleton event bus instance. Swap implementation for cloud deployment. */
+declare const eventBus: LocalEventBus;
+//#endregion
+export { type BacklogEvent, type BacklogEventCallback, type BacklogEventType, type EventBus, LocalEventBus, eventBus };
+//# sourceMappingURL=index.d.mts.map

package/dist/events/index.mjs

@@ -0,0 +1,9 @@
+import { LocalEventBus } from "./local-event-bus.mjs";
+
+//#region src/events/index.ts
+/** Singleton event bus instance. Swap implementation for cloud deployment. */
+const eventBus = new LocalEventBus();
+
+//#endregion
+export { LocalEventBus, eventBus };
+//# sourceMappingURL=index.mjs.map

package/dist/events/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/events/index.ts"],"sourcesContent":["export type { BacklogEvent, BacklogEventType, BacklogEventCallback, EventBus } from './event-bus.js';\nexport { LocalEventBus } from './local-event-bus.js';\n\nimport { LocalEventBus } from './local-event-bus.js';\n\n/** Singleton event bus instance. Swap implementation for cloud deployment. */\nexport const eventBus = new LocalEventBus();\n"],"mappings":";;;;AAMA,MAAa,WAAW,IAAI,eAAe"}

package/dist/events/local-event-bus.d.mts

@@ -0,0 +1,16 @@
+import { BacklogEvent, BacklogEventCallback, EventBus } from "./event-bus.mjs";
+
+//#region src/events/local-event-bus.d.ts
+declare class LocalEventBus implements EventBus {
+  private emitter;
+  private seq;
+  private buffer;
+  constructor();
+  emit(event: Omit<BacklogEvent, 'seq'>): void;
+  subscribe(callback: BacklogEventCallback): void;
+  unsubscribe(callback: BacklogEventCallback): void;
+  replaySince(seq: number): BacklogEvent[];
+}
+//#endregion
+export { LocalEventBus };
+//# sourceMappingURL=local-event-bus.d.mts.map

package/dist/events/local-event-bus.mjs

@@ -0,0 +1,39 @@
+import { EventEmitter } from "node:events";
+
+//#region src/events/local-event-bus.ts
+/**
+* In-process EventBus implementation using Node.js EventEmitter.
+* Maintains a ring buffer for replay on SSE reconnect.
+*/
+const RING_BUFFER_SIZE = 1e3;
+const EVENT_NAME = "backlog";
+var LocalEventBus = class {
+	emitter = new EventEmitter();
+	seq = 0;
+	buffer = [];
+	constructor() {
+		this.emitter.setMaxListeners(100);
+	}
+	emit(event) {
+		const full = {
+			...event,
+			seq: ++this.seq
+		};
+		if (this.buffer.length >= RING_BUFFER_SIZE) this.buffer.shift();
+		this.buffer.push(full);
+		this.emitter.emit(EVENT_NAME, full);
+	}
+	subscribe(callback) {
+		this.emitter.on(EVENT_NAME, callback);
+	}
+	unsubscribe(callback) {
+		this.emitter.off(EVENT_NAME, callback);
+	}
+	replaySince(seq) {
+		return this.buffer.filter((e) => e.seq > seq);
+	}
+};
+
+//#endregion
+export { LocalEventBus };
+//# sourceMappingURL=local-event-bus.mjs.map

package/dist/events/local-event-bus.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-event-bus.mjs","names":[],"sources":["../../src/events/local-event-bus.ts"],"sourcesContent":["/**\n * In-process EventBus implementation using Node.js EventEmitter.\n * Maintains a ring buffer for replay on SSE reconnect.\n */\n\nimport { EventEmitter } from 'node:events';\nimport type { BacklogEvent, BacklogEventCallback, EventBus } from './event-bus.js';\n\nconst RING_BUFFER_SIZE = 1000;\nconst EVENT_NAME = 'backlog';\n\nexport class LocalEventBus implements EventBus {\n  private emitter = new EventEmitter();\n  private seq = 0;\n  private buffer: BacklogEvent[] = [];\n\n  constructor() {\n    this.emitter.setMaxListeners(100);\n  }\n\n  emit(event: Omit<BacklogEvent, 'seq'>): void {\n    const full: BacklogEvent = { ...event, seq: ++this.seq };\n\n    // Ring buffer: drop oldest when full\n    if (this.buffer.length >= RING_BUFFER_SIZE) {\n      this.buffer.shift();\n    }\n    this.buffer.push(full);\n\n    this.emitter.emit(EVENT_NAME, full);\n  }\n\n  subscribe(callback: BacklogEventCallback): void {\n    this.emitter.on(EVENT_NAME, callback);\n  }\n\n  unsubscribe(callback: BacklogEventCallback): void {\n    this.emitter.off(EVENT_NAME, callback);\n  }\n\n  replaySince(seq: number): BacklogEvent[] {\n    return this.buffer.filter(e => e.seq > seq);\n  }\n}\n"],"mappings":";;;;;;;AAQA,MAAM,mBAAmB;AACzB,MAAM,aAAa;AAEnB,IAAa,gBAAb,MAA+C;CAC7C,AAAQ,UAAU,IAAI,cAAc;CACpC,AAAQ,MAAM;CACd,AAAQ,SAAyB,EAAE;CAEnC,cAAc;AACZ,OAAK,QAAQ,gBAAgB,IAAI;;CAGnC,KAAK,OAAwC;EAC3C,MAAM,OAAqB;GAAE,GAAG;GAAO,KAAK,EAAE,KAAK;GAAK;AAGxD,MAAI,KAAK,OAAO,UAAU,iBACxB,MAAK,OAAO,OAAO;AAErB,OAAK,OAAO,KAAK,KAAK;AAEtB,OAAK,QAAQ,KAAK,YAAY,KAAK;;CAGrC,UAAU,UAAsC;AAC9C,OAAK,QAAQ,GAAG,YAAY,SAAS;;CAGvC,YAAY,UAAsC;AAChD,OAAK,QAAQ,IAAI,YAAY,SAAS;;CAGxC,YAAY,KAA6B;AACvC,SAAO,KAAK,OAAO,QAAO,MAAK,EAAE,MAAM,IAAI"}

package/dist/operations/middleware.d.mts

@@ -2,7 +2,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/operations/middleware.d.ts
 /**
- * Wrap an MCP server to log tool operations.
+ * Wrap an MCP server to log tool operations and emit real-time events.
  * Returns a proxy that intercepts registerTool calls.
  */
 declare function withOperationLogging(server: McpServer): McpServer;

package/dist/operations/middleware.mjs

@@ -1,8 +1,21 @@
+import { extractResourceId } from "./resource-id.mjs";
+import { WRITE_TOOLS } from "./types.mjs";
 import { operationLogger } from "./logger.mjs";
+import { eventBus } from "../events/index.mjs";
 
 //#region src/operations/middleware.ts
+/** Declarative mapping from write tool to event type. */
+const TOOL_EVENT_MAP = {
+	backlog_create: "task_created",
+	backlog_update: "task_changed",
+	backlog_delete: "task_deleted",
+	write_resource: "resource_changed"
+};
+function isWriteTool(name) {
+	return WRITE_TOOLS.includes(name);
+}
 /**
-* Wrap an MCP server to log tool operations.
+* Wrap an MCP server to log tool operations and emit real-time events.
 * Returns a proxy that intercepts registerTool calls.
 */
 function withOperationLogging(server) {
@@ -10,7 +23,15 @@ function withOperationLogging(server) {
 	server.registerTool = function(name, config, callback) {
 		const wrappedCallback = async (...args) => {
 			const result = await callback(...args);
-			operationLogger.log(name, args[0] || {}, result);
+			const params = args[0] || {};
+			operationLogger.log(name, params, result);
+			if (isWriteTool(name)) eventBus.emit({
+				type: TOOL_EVENT_MAP[name],
+				id: extractResourceId(name, params, result) || "",
+				tool: name,
+				actor: process.env.BACKLOG_ACTOR_NAME || process.env.USER || "unknown",
+				ts: (/* @__PURE__ */ new Date()).toISOString()
+			});
 			return result;
 		};
 		return originalRegisterTool(name, config, wrappedCallback);

package/dist/operations/middleware.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.mjs","names":[],"sources":["../../src/operations/middleware.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { operationLogger } from './logger.js';\n\n/**\n * Wrap an MCP server to log tool operations.\n * Returns a proxy that intercepts registerTool calls.\n */\nexport function withOperationLogging(server: McpServer): McpServer {\n  const originalRegisterTool = server.registerTool.bind(server);\n\n  // Override registerTool to wrap callbacks with logging\n  (server as any).registerTool = function(\n    name: string,\n    config: any,\n    callback: (...args: any[]) => any\n  ) {\n    const wrappedCallback = async (...args: any[]) => {\n      const result = await callback(...args);\n      // args[0] is the params object for tool callbacks\n      operationLogger.log(name, args[0] || {}, result);\n      return result;\n    };\n\n    return originalRegisterTool(name, config, wrappedCallback as any);\n  };\n\n  return server;\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,qBAAqB,QAA8B;CACjE,MAAM,uBAAuB,OAAO,aAAa,KAAK,OAAO;AAG7D,CAAC,OAAe,eAAe,SAC7B,MACA,QACA,UACA;EACA,MAAM,kBAAkB,OAAO,GAAG,SAAgB;GAChD,MAAM,SAAS,MAAM,SAAS,GAAG,KAAK;AAEtC,mBAAgB,IAAI,MAAM,KAAK,MAAM,EAAE,EAAE,OAAO;AAChD,UAAO;;AAGT,SAAO,qBAAqB,MAAM,QAAQ,gBAAuB;;AAGnE,QAAO"}
+{"version":3,"file":"middleware.mjs","names":[],"sources":["../../src/operations/middleware.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { operationLogger } from './logger.js';\nimport { eventBus } from '../events/index.js';\nimport type { BacklogEventType } from '../events/index.js';\nimport { extractResourceId } from './resource-id.js';\nimport { WRITE_TOOLS, type ToolName } from './types.js';\n\n/** Declarative mapping from write tool to event type. */\nconst TOOL_EVENT_MAP: Record<ToolName, BacklogEventType> = {\n  backlog_create: 'task_created',\n  backlog_update: 'task_changed',\n  backlog_delete: 'task_deleted',\n  write_resource: 'resource_changed',\n};\n\nfunction isWriteTool(name: string): name is ToolName {\n  return WRITE_TOOLS.includes(name as ToolName);\n}\n\n/**\n * Wrap an MCP server to log tool operations and emit real-time events.\n * Returns a proxy that intercepts registerTool calls.\n */\nexport function withOperationLogging(server: McpServer): McpServer {\n  const originalRegisterTool = server.registerTool.bind(server);\n\n  // Override registerTool to wrap callbacks with logging\n  (server as any).registerTool = function(\n    name: string,\n    config: any,\n    callback: (...args: any[]) => any\n  ) {\n    const wrappedCallback = async (...args: any[]) => {\n      const result = await callback(...args);\n      const params = args[0] || {};\n\n      // Log operation to disk\n      operationLogger.log(name, params, result);\n\n      // Emit real-time event for SSE consumers\n      if (isWriteTool(name)) {\n        eventBus.emit({\n          type: TOOL_EVENT_MAP[name],\n          id: extractResourceId(name, params, result) || '',\n          tool: name,\n          actor: process.env.BACKLOG_ACTOR_NAME || process.env.USER || 'unknown',\n          ts: new Date().toISOString(),\n        });\n      }\n\n      return result;\n    };\n\n    return originalRegisterTool(name, config, wrappedCallback as any);\n  };\n\n  return server;\n}\n"],"mappings":";;;;;;;AAQA,MAAM,iBAAqD;CACzD,gBAAgB;CAChB,gBAAgB;CAChB,gBAAgB;CAChB,gBAAgB;CACjB;AAED,SAAS,YAAY,MAAgC;AACnD,QAAO,YAAY,SAAS,KAAiB;;;;;;AAO/C,SAAgB,qBAAqB,QAA8B;CACjE,MAAM,uBAAuB,OAAO,aAAa,KAAK,OAAO;AAG7D,CAAC,OAAe,eAAe,SAC7B,MACA,QACA,UACA;EACA,MAAM,kBAAkB,OAAO,GAAG,SAAgB;GAChD,MAAM,SAAS,MAAM,SAAS,GAAG,KAAK;GACtC,MAAM,SAAS,KAAK,MAAM,EAAE;AAG5B,mBAAgB,IAAI,MAAM,QAAQ,OAAO;AAGzC,OAAI,YAAY,KAAK,CACnB,UAAS,KAAK;IACZ,MAAM,eAAe;IACrB,IAAI,kBAAkB,MAAM,QAAQ,OAAO,IAAI;IAC/C,MAAM;IACN,OAAO,QAAQ,IAAI,sBAAsB,QAAQ,IAAI,QAAQ;IAC7D,qBAAI,IAAI,MAAM,EAAC,aAAa;IAC7B,CAAC;AAGJ,UAAO;;AAGT,SAAO,qBAAqB,MAAM,QAAQ,gBAAuB;;AAGnE,QAAO"}

package/dist/server/viewer-routes.mjs

@@ -2,6 +2,7 @@ import { paths } from "../utils/paths.mjs";
 import { resourceManager } from "../resources/manager.mjs";
 import { storage } from "../storage/backlog-service.mjs";
 import { operationLogger } from "../operations/logger.mjs";
+import { eventBus } from "../events/index.mjs";
 import "../operations/index.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import matter from "gray-matter";
@@ -9,6 +10,7 @@ import fastifyStatic from "@fastify/static";
 import { exec } from "node:child_process";
 
 //#region src/server/viewer-routes.ts
+const SSE_HEARTBEAT_MS = 3e4;
 function registerViewerRoutes(app) {
 	app.register(fastifyStatic, {
 		root: paths.viewerDist,
@@ -182,6 +184,36 @@ function registerViewerRoutes(app) {
 		const { taskId } = request.params;
 		return { count: operationLogger.countForTask(taskId) };
 	});
+	app.get("/events", (request, reply) => {
+		const lastEventId = request.headers["last-event-id"];
+		reply.hijack();
+		const raw = reply.raw;
+		raw.writeHead(200, {
+			"Content-Type": "text/event-stream",
+			"Cache-Control": "no-cache",
+			"Connection": "keep-alive",
+			"X-Accel-Buffering": "no"
+		});
+		if (lastEventId) {
+			const seq = parseInt(lastEventId, 10);
+			if (!isNaN(seq)) {
+				const missed = eventBus.replaySince(seq);
+				for (const event of missed) raw.write(`id: ${event.seq}\ndata: ${JSON.stringify(event)}\n\n`);
+			}
+		}
+		raw.write(`: connected\n\n`);
+		const onEvent = (event) => {
+			raw.write(`id: ${event.seq}\ndata: ${JSON.stringify(event)}\n\n`);
+		};
+		eventBus.subscribe(onEvent);
+		const heartbeat = setInterval(() => {
+			raw.write(`: heartbeat\n\n`);
+		}, SSE_HEARTBEAT_MS);
+		request.raw.on("close", () => {
+			clearInterval(heartbeat);
+			eventBus.unsubscribe(onEvent);
+		});
+	});
 }
 
 //#endregion

package/dist/server/viewer-routes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-routes.mjs","names":[],"sources":["../../src/server/viewer-routes.ts"],"sourcesContent":["import type { FastifyInstance } from 'fastify';\nimport fastifyStatic from '@fastify/static';\nimport { exec } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport matter from 'gray-matter';\nimport { storage } from '../storage/backlog-service.js';\nimport { resourceManager } from '../resources/manager.js';\nimport { paths } from '../utils/paths.js';\nimport { operationLogger } from '../operations/index.js';\n\nexport function registerViewerRoutes(app: FastifyInstance) {\n  // Static files - serve from dist/viewer (built assets)\n  app.register(fastifyStatic, {\n    root: paths.viewerDist,\n    prefix: '/',\n  });\n\n  // List tasks\n  app.get('/tasks', async (request) => {\n    const { filter, limit, q } = request.query as { filter?: string; limit?: string; q?: string };\n    \n    const statusMap: Record<string, any> = {\n      active: { status: ['open', 'in_progress', 'blocked'] },\n      completed: { status: ['done', 'cancelled'] },\n      all: {},\n    };\n    \n    const filterConfig = statusMap[filter || 'active'] || statusMap.active;\n    const tasks = await storage.list({ \n      ...filterConfig, \n      query: q || undefined,\n      limit: limit ? parseInt(limit) : 10000 \n    });\n    \n    return tasks;\n  });\n\n  // Unified search API - returns proper SearchResult[] with item, score, type\n  app.get('/search', async (request, reply) => {\n    const { q, types, limit, sort } = request.query as { q?: string; types?: string; limit?: string; sort?: string };\n    \n    if (!q) {\n      return reply.code(400).send({ error: 'Missing required query parameter: q' });\n    }\n    \n    const typeFilter = types \n      ? types.split(',').filter((t): t is 'task' | 'epic' | 'resource' => \n          t === 'task' || t === 'epic' || t === 'resource')\n      : undefined;\n    \n    const sortMode = sort === 'recent' ? 'recent' : 'relevant';\n    \n    const results = await storage.searchUnified(q, {\n      types: typeFilter?.length ? typeFilter : undefined,\n      limit: limit ? parseInt(limit) : 20,\n      sort: sortMode,\n    });\n    \n    return results;\n  });\n\n  // Get single task\n  app.get('/tasks/:id', async (request, reply) => {\n    const { id } = request.params as { id: string };\n    const task = storage.get(id);\n    \n    if (!task) {\n      return reply.code(404).send({ error: 'Task not found' });\n    }\n    \n    // Include raw markdown for copy button\n    const raw = storage.getMarkdown(id);\n    \n    return { ...task, raw };\n  });\n\n  // System status\n  app.get('/api/status', async () => {\n    const tasks = await storage.list({ limit: 10000 });\n    const address = app.server.address();\n    const port = typeof address === 'object' && address ? address.port : 3030;\n    \n    return {\n      version: paths.getVersion(),\n      port,\n      dataDir: paths.backlogDataDir,\n      taskCount: tasks.length,\n      uptime: Math.floor(process.uptime())\n    };\n  });\n\n  // Open task in editor\n  app.get('/open/:id', async (request, reply) => {\n    const { id } = request.params as { id: string };\n    const filePath = storage.getFilePath(id);\n    \n    if (!filePath) {\n      return reply.code(404).send({ error: 'Task not found' });\n    }\n    \n    exec(`open \"${filePath}\"`);\n    return { status: 'Opening...' };\n  });\n\n  // Resource proxy\n  app.get('/resource', async (request, reply) => {\n    const { path: filePath } = request.query as { path?: string };\n    \n    if (!filePath) {\n      return reply.code(400).send({ error: 'Missing path parameter' });\n    }\n    \n    if (!existsSync(filePath)) {\n      return reply.code(404).send({ error: 'File not found', path: filePath });\n    }\n    \n    try {\n      const content = readFileSync(filePath, 'utf-8');\n      const ext = filePath.split('.').pop()?.toLowerCase() || 'txt';\n      const mimeMap: Record<string, string> = {\n        md: 'text/markdown',\n        ts: 'text/typescript',\n        js: 'text/javascript',\n        json: 'application/json',\n        txt: 'text/plain',\n      };\n      \n      let frontmatter = {};\n      let bodyContent = content;\n      \n      // Parse frontmatter for markdown files\n      if (ext === 'md') {\n        const parsed = matter(content);\n        frontmatter = parsed.data;\n        bodyContent = parsed.content;\n      }\n      \n      return {\n        content: bodyContent,\n        frontmatter,\n        type: mimeMap[ext] || 'text/plain',\n        path: filePath,\n        fileUri: `file://${filePath}`,\n        mcpUri: resourceManager.toUri(filePath),\n        ext\n      };\n    } catch (error: any) {\n      return reply.code(500).send({ error: 'Failed to read file', message: error.message });\n    }\n  });\n\n  // MCP resource proxy\n  app.get('/mcp/resource', async (request, reply) => {\n    const { uri } = request.query as { uri?: string };\n    \n    if (!uri || !uri.startsWith('mcp://backlog/')) {\n      return reply.code(400).send({ error: 'Invalid MCP URI' });\n    }\n    \n    try {\n      const resource = resourceManager.read(uri);\n      const filePath = resourceManager.resolve(uri);\n      const ext = filePath.split('.').pop()?.toLowerCase() || 'txt';\n      \n      return {\n        content: resource.content,\n        frontmatter: resource.frontmatter || {},\n        type: resource.mimeType,\n        path: filePath,\n        fileUri: `file://${filePath}`,\n        mcpUri: uri,\n        ext\n      };\n    } catch (error: any) {\n      return reply.code(404).send({ error: 'Resource not found', uri, message: error.message });\n    }\n  });\n\n  // Open resource in viewer\n  app.get('/open', async (request, reply) => {\n    const { uri } = request.query as { uri?: string };\n    \n    if (!uri) {\n      return reply.code(400).send({ error: 'Missing uri parameter' });\n    }\n    \n    return reply.redirect(`/?resource=${encodeURIComponent(uri)}`);\n  });\n\n  // Operations API - recent activity (enriched with task titles and epic info)\n  app.get('/operations', async (request) => {\n    const { limit, task, date } = request.query as { limit?: string; task?: string; date?: string };\n    \n    const operations = operationLogger.read({\n      limit: limit ? parseInt(limit) : (date ? 1000 : 50), // Higher limit when filtering by date\n      taskId: task || undefined,\n      date: date || undefined,\n    });\n    \n    // Enrich operations with task titles and epic info\n    // Use in-request cache to avoid duplicate storage lookups\n    const taskCache = new Map<string, { title?: string; epicId?: string }>();\n    const epicCache = new Map<string, string | undefined>();\n    \n    const enriched = operations.map(op => {\n      if (op.resourceId) {\n        if (!taskCache.has(op.resourceId)) {\n          const taskData = storage.get(op.resourceId);\n          taskCache.set(op.resourceId, {\n            title: taskData?.title,\n            epicId: taskData?.epic_id,\n          });\n        }\n        const cached = taskCache.get(op.resourceId)!;\n        \n        // Resolve epic title if task has an epic\n        let epicTitle: string | undefined;\n        if (cached.epicId) {\n          if (!epicCache.has(cached.epicId)) {\n            const epicData = storage.get(cached.epicId);\n            epicCache.set(cached.epicId, epicData?.title);\n          }\n          epicTitle = epicCache.get(cached.epicId);\n        }\n        \n        return { ...op, resourceTitle: cached.title, epicId: cached.epicId, epicTitle };\n      }\n      return op;\n    });\n    \n    return enriched;\n  });\n\n  // Operation count for a specific task (for badge)\n  app.get('/operations/count/:taskId', async (request) => {\n    const { taskId } = request.params as { taskId: string };\n    return { count: operationLogger.countForTask(taskId) };\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"viewer-routes.mjs","names":[],"sources":["../../src/server/viewer-routes.ts"],"sourcesContent":["import type { FastifyInstance } from 'fastify';\nimport fastifyStatic from '@fastify/static';\nimport { exec } from 'node:child_process';\nimport { existsSync, readFileSync } from 'node:fs';\nimport matter from 'gray-matter';\nimport { storage } from '../storage/backlog-service.js';\nimport { resourceManager } from '../resources/manager.js';\nimport { paths } from '../utils/paths.js';\nimport { operationLogger } from '../operations/index.js';\nimport { eventBus } from '../events/index.js';\nimport type { BacklogEvent } from '../events/index.js';\n\nconst SSE_HEARTBEAT_MS = 30_000;\n\nexport function registerViewerRoutes(app: FastifyInstance) {\n  // Static files - serve from dist/viewer (built assets)\n  app.register(fastifyStatic, {\n    root: paths.viewerDist,\n    prefix: '/',\n  });\n\n  // List tasks\n  app.get('/tasks', async (request) => {\n    const { filter, limit, q } = request.query as { filter?: string; limit?: string; q?: string };\n    \n    const statusMap: Record<string, any> = {\n      active: { status: ['open', 'in_progress', 'blocked'] },\n      completed: { status: ['done', 'cancelled'] },\n      all: {},\n    };\n    \n    const filterConfig = statusMap[filter || 'active'] || statusMap.active;\n    const tasks = await storage.list({ \n      ...filterConfig, \n      query: q || undefined,\n      limit: limit ? parseInt(limit) : 10000 \n    });\n    \n    return tasks;\n  });\n\n  // Unified search API - returns proper SearchResult[] with item, score, type\n  app.get('/search', async (request, reply) => {\n    const { q, types, limit, sort } = request.query as { q?: string; types?: string; limit?: string; sort?: string };\n    \n    if (!q) {\n      return reply.code(400).send({ error: 'Missing required query parameter: q' });\n    }\n    \n    const typeFilter = types \n      ? types.split(',').filter((t): t is 'task' | 'epic' | 'resource' => \n          t === 'task' || t === 'epic' || t === 'resource')\n      : undefined;\n    \n    const sortMode = sort === 'recent' ? 'recent' : 'relevant';\n    \n    const results = await storage.searchUnified(q, {\n      types: typeFilter?.length ? typeFilter : undefined,\n      limit: limit ? parseInt(limit) : 20,\n      sort: sortMode,\n    });\n    \n    return results;\n  });\n\n  // Get single task\n  app.get('/tasks/:id', async (request, reply) => {\n    const { id } = request.params as { id: string };\n    const task = storage.get(id);\n    \n    if (!task) {\n      return reply.code(404).send({ error: 'Task not found' });\n    }\n    \n    // Include raw markdown for copy button\n    const raw = storage.getMarkdown(id);\n    \n    return { ...task, raw };\n  });\n\n  // System status\n  app.get('/api/status', async () => {\n    const tasks = await storage.list({ limit: 10000 });\n    const address = app.server.address();\n    const port = typeof address === 'object' && address ? address.port : 3030;\n    \n    return {\n      version: paths.getVersion(),\n      port,\n      dataDir: paths.backlogDataDir,\n      taskCount: tasks.length,\n      uptime: Math.floor(process.uptime())\n    };\n  });\n\n  // Open task in editor\n  app.get('/open/:id', async (request, reply) => {\n    const { id } = request.params as { id: string };\n    const filePath = storage.getFilePath(id);\n    \n    if (!filePath) {\n      return reply.code(404).send({ error: 'Task not found' });\n    }\n    \n    exec(`open \"${filePath}\"`);\n    return { status: 'Opening...' };\n  });\n\n  // Resource proxy\n  app.get('/resource', async (request, reply) => {\n    const { path: filePath } = request.query as { path?: string };\n    \n    if (!filePath) {\n      return reply.code(400).send({ error: 'Missing path parameter' });\n    }\n    \n    if (!existsSync(filePath)) {\n      return reply.code(404).send({ error: 'File not found', path: filePath });\n    }\n    \n    try {\n      const content = readFileSync(filePath, 'utf-8');\n      const ext = filePath.split('.').pop()?.toLowerCase() || 'txt';\n      const mimeMap: Record<string, string> = {\n        md: 'text/markdown',\n        ts: 'text/typescript',\n        js: 'text/javascript',\n        json: 'application/json',\n        txt: 'text/plain',\n      };\n      \n      let frontmatter = {};\n      let bodyContent = content;\n      \n      // Parse frontmatter for markdown files\n      if (ext === 'md') {\n        const parsed = matter(content);\n        frontmatter = parsed.data;\n        bodyContent = parsed.content;\n      }\n      \n      return {\n        content: bodyContent,\n        frontmatter,\n        type: mimeMap[ext] || 'text/plain',\n        path: filePath,\n        fileUri: `file://${filePath}`,\n        mcpUri: resourceManager.toUri(filePath),\n        ext\n      };\n    } catch (error: any) {\n      return reply.code(500).send({ error: 'Failed to read file', message: error.message });\n    }\n  });\n\n  // MCP resource proxy\n  app.get('/mcp/resource', async (request, reply) => {\n    const { uri } = request.query as { uri?: string };\n    \n    if (!uri || !uri.startsWith('mcp://backlog/')) {\n      return reply.code(400).send({ error: 'Invalid MCP URI' });\n    }\n    \n    try {\n      const resource = resourceManager.read(uri);\n      const filePath = resourceManager.resolve(uri);\n      const ext = filePath.split('.').pop()?.toLowerCase() || 'txt';\n      \n      return {\n        content: resource.content,\n        frontmatter: resource.frontmatter || {},\n        type: resource.mimeType,\n        path: filePath,\n        fileUri: `file://${filePath}`,\n        mcpUri: uri,\n        ext\n      };\n    } catch (error: any) {\n      return reply.code(404).send({ error: 'Resource not found', uri, message: error.message });\n    }\n  });\n\n  // Open resource in viewer\n  app.get('/open', async (request, reply) => {\n    const { uri } = request.query as { uri?: string };\n    \n    if (!uri) {\n      return reply.code(400).send({ error: 'Missing uri parameter' });\n    }\n    \n    return reply.redirect(`/?resource=${encodeURIComponent(uri)}`);\n  });\n\n  // Operations API - recent activity (enriched with task titles and epic info)\n  app.get('/operations', async (request) => {\n    const { limit, task, date } = request.query as { limit?: string; task?: string; date?: string };\n    \n    const operations = operationLogger.read({\n      limit: limit ? parseInt(limit) : (date ? 1000 : 50), // Higher limit when filtering by date\n      taskId: task || undefined,\n      date: date || undefined,\n    });\n    \n    // Enrich operations with task titles and epic info\n    // Use in-request cache to avoid duplicate storage lookups\n    const taskCache = new Map<string, { title?: string; epicId?: string }>();\n    const epicCache = new Map<string, string | undefined>();\n    \n    const enriched = operations.map(op => {\n      if (op.resourceId) {\n        if (!taskCache.has(op.resourceId)) {\n          const taskData = storage.get(op.resourceId);\n          taskCache.set(op.resourceId, {\n            title: taskData?.title,\n            epicId: taskData?.epic_id,\n          });\n        }\n        const cached = taskCache.get(op.resourceId)!;\n        \n        // Resolve epic title if task has an epic\n        let epicTitle: string | undefined;\n        if (cached.epicId) {\n          if (!epicCache.has(cached.epicId)) {\n            const epicData = storage.get(cached.epicId);\n            epicCache.set(cached.epicId, epicData?.title);\n          }\n          epicTitle = epicCache.get(cached.epicId);\n        }\n        \n        return { ...op, resourceTitle: cached.title, epicId: cached.epicId, epicTitle };\n      }\n      return op;\n    });\n    \n    return enriched;\n  });\n\n  // Operation count for a specific task (for badge)\n  app.get('/operations/count/:taskId', async (request) => {\n    const { taskId } = request.params as { taskId: string };\n    return { count: operationLogger.countForTask(taskId) };\n  });\n\n  // SSE endpoint for real-time viewer updates\n  app.get('/events', (request, reply) => {\n    const lastEventId = request.headers['last-event-id'] as string | undefined;\n\n    reply.hijack();\n    const raw = reply.raw;\n\n    raw.writeHead(200, {\n      'Content-Type': 'text/event-stream',\n      'Cache-Control': 'no-cache',\n      'Connection': 'keep-alive',\n      'X-Accel-Buffering': 'no', // Disable nginx buffering\n    });\n\n    // Replay missed events if client reconnected with Last-Event-ID\n    if (lastEventId) {\n      const seq = parseInt(lastEventId, 10);\n      if (!isNaN(seq)) {\n        const missed = eventBus.replaySince(seq);\n        for (const event of missed) {\n          raw.write(`id: ${event.seq}\\ndata: ${JSON.stringify(event)}\\n\\n`);\n        }\n      }\n    }\n\n    // Send initial connected event\n    raw.write(`: connected\\n\\n`);\n\n    // Subscribe to new events\n    const onEvent = (event: BacklogEvent) => {\n      raw.write(`id: ${event.seq}\\ndata: ${JSON.stringify(event)}\\n\\n`);\n    };\n    eventBus.subscribe(onEvent);\n\n    // Heartbeat to keep connection alive through proxies\n    const heartbeat = setInterval(() => {\n      raw.write(`: heartbeat\\n\\n`);\n    }, SSE_HEARTBEAT_MS);\n\n    // Cleanup on disconnect\n    request.raw.on('close', () => {\n      clearInterval(heartbeat);\n      eventBus.unsubscribe(onEvent);\n    });\n  });\n}\n"],"mappings":"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"}

package/dist/viewer/main.js

@@ -3168,6 +3168,39 @@ async function fetchOperationCount(taskId) {
   return data.count || 0;
 }
 
+// viewer/services/event-source-client.ts
+var BacklogEvents = class {
+  source = null;
+  listeners = /* @__PURE__ */ new Set();
+  /** Start listening for server events. Call once on app init. */
+  connect() {
+    if (this.source) return;
+    this.source = new EventSource(`${API_URL}/events`);
+    this.source.onmessage = (e) => {
+      try {
+        const event = JSON.parse(e.data);
+        for (const cb of this.listeners) {
+          cb(event);
+        }
+      } catch {
+      }
+    };
+  }
+  /** Subscribe to all backlog change events. */
+  onChange(callback) {
+    this.listeners.add(callback);
+  }
+  /** Unsubscribe from change events. */
+  offChange(callback) {
+    this.listeners.delete(callback);
+  }
+  disconnect() {
+    this.source?.close();
+    this.source = null;
+  }
+};
+var backlogEvents = new BacklogEvents();
+
 // viewer/components/breadcrumb.ts
 var Breadcrumb = class extends HTMLElement {
   currentEpicId = null;
@@ -3260,7 +3293,11 @@ var TaskList = class extends HTMLElement {
       this.currentSort = savedSort;
     }
     this.loadTasks();
-    setInterval(() => this.loadTasks(), 5e3);
+    backlogEvents.onChange((event) => {
+      if (event.type === "task_changed" || event.type === "task_created" || event.type === "task_deleted") {
+        this.loadTasks();
+      }
+    });
     document.addEventListener("filter-change", ((e) => {
       this.currentFilter = e.detail.filter;
       this.currentType = e.detail.type ?? "all";
@@ -3360,7 +3397,7 @@ var TaskList = class extends HTMLElement {
       const childCount = (task.type ?? "task") === "epic" ? this.allTasks.filter((t) => t.epic_id === task.id).length : 0;
       const isCurrentEpic = this.currentEpicId === task.id;
       return `
-            <task-item 
+            <task-item
               data-id="${task.id}"
               data-title="${escapeAttr(task.title)}"
               data-status="${task.status}"
@@ -3448,8 +3485,14 @@ function linkify(input) {
   return `<a href="${input.url}" target="_blank" rel="noopener">${input.title || input.url}</a>`;
 }
 var TaskDetail = class extends HTMLElement {
+  currentTaskId = null;
   connectedCallback() {
     this.showEmpty();
+    backlogEvents.onChange((event) => {
+      if (this.currentTaskId && event.type === "task_changed" && event.id === this.currentTaskId) {
+        this.loadTask(this.currentTaskId);
+      }
+    });
   }
   showEmpty() {
     this.innerHTML = `
@@ -3460,6 +3503,7 @@ var TaskDetail = class extends HTMLElement {
     `;
   }
   async loadTask(taskId) {
+    this.currentTaskId = taskId;
     try {
       const task = await fetchTask(taskId);
       this.updatePaneHeader(task);
@@ -7002,7 +7046,6 @@ function getToolIcon(tool) {
 function createUnifiedDiff(oldStr, newStr, filename = "file") {
   return createTwoFilesPatch(filename, filename, oldStr, newStr, "", "", { context: 5 });
 }
-var POLL_INTERVAL = 3e4;
 var MODE_STORAGE_KEY = "backlog:activity-mode";
 var DEFAULT_VISIBLE_ITEMS = 2;
 var ActivityPanel = class extends HTMLElement {
@@ -7010,11 +7053,10 @@ var ActivityPanel = class extends HTMLElement {
   operations = [];
   expandedIndex = null;
   // Changed to timestamp-based ID
-  pollTimer = null;
-  visibilityHandler = null;
   mode = "timeline";
   selectedDate = getTodayKey();
   expandedTaskGroups = /* @__PURE__ */ new Set();
+  changeHandler = () => this.loadOperations();
   connectedCallback() {
     this.className = "activity-panel";
     const savedMode = localStorage.getItem(MODE_STORAGE_KEY);
@@ -7022,33 +7064,10 @@ var ActivityPanel = class extends HTMLElement {
       this.mode = savedMode;
     }
     this.render();
-    this.startPolling();
+    backlogEvents.onChange(this.changeHandler);
   }
   disconnectedCallback() {
-    this.stopPolling();
-  }
-  startPolling() {
-    this.pollTimer = window.setInterval(() => {
-      if (document.visibilityState === "visible") {
-        this.loadOperations();
-      }
-    }, POLL_INTERVAL);
-    this.visibilityHandler = () => {
-      if (document.visibilityState === "visible") {
-        this.loadOperations();
-      }
-    };
-    document.addEventListener("visibilitychange", this.visibilityHandler);
-  }
-  stopPolling() {
-    if (this.pollTimer !== null) {
-      clearInterval(this.pollTimer);
-      this.pollTimer = null;
-    }
-    if (this.visibilityHandler) {
-      document.removeEventListener("visibilitychange", this.visibilityHandler);
-      this.visibilityHandler = null;
-    }
+    backlogEvents.offChange(this.changeHandler);
   }
   setTaskId(taskId) {
     this.taskId = taskId;
@@ -7851,6 +7870,7 @@ var BacklogApp = class extends HTMLElement {
 customElements.define("backlog-app", BacklogApp);
 
 // viewer/main.ts
+backlogEvents.connect();
 document.addEventListener("filter-change", ((e) => {
   urlState.set({ filter: e.detail.filter, type: e.detail.type });
 }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backlog-mcp",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Minimal task backlog MCP server for Claude and AI agents",
   "keywords": [
     "mcp",

package/viewer/components/activity-panel.ts

@@ -23,6 +23,7 @@ import {
   type JournalEntry,
   type EpicGroup,
 } from './activity-utils.js';
+import { backlogEvents, type ChangeCallback } from '../services/event-source-client.js';
 
 type ViewMode = 'timeline' | 'journal';
 
@@ -30,7 +31,6 @@ function createUnifiedDiff(oldStr: string, newStr: string, filename: string = 'f
   return createTwoFilesPatch(filename, filename, oldStr, newStr, '', '', { context: 5 });
 }
 
-const POLL_INTERVAL = 30000;
 const MODE_STORAGE_KEY = 'backlog:activity-mode';
 const DEFAULT_VISIBLE_ITEMS = 2;
 
@@ -38,11 +38,10 @@ export class ActivityPanel extends HTMLElement {
   private taskId: string | null = null;
   private operations: OperationEntry[] = [];
   private expandedIndex: string | null = null; // Changed to timestamp-based ID
-  private pollTimer: number | null = null;
-  private visibilityHandler: (() => void) | null = null;
   private mode: ViewMode = 'timeline';
   private selectedDate: string = getTodayKey();
   private expandedTaskGroups = new Set<string>();
+  private changeHandler: ChangeCallback = () => this.loadOperations();
 
   connectedCallback() {
     this.className = 'activity-panel';
@@ -52,37 +51,11 @@ export class ActivityPanel extends HTMLElement {
       this.mode = savedMode;
     }
     this.render();
-    this.startPolling();
+    backlogEvents.onChange(this.changeHandler);
   }
 
   disconnectedCallback() {
-    this.stopPolling();
-  }
-
-  private startPolling() {
-    this.pollTimer = window.setInterval(() => {
-      if (document.visibilityState === 'visible') {
-        this.loadOperations();
-      }
-    }, POLL_INTERVAL);
-
-    this.visibilityHandler = () => {
-      if (document.visibilityState === 'visible') {
-        this.loadOperations();
-      }
-    };
-    document.addEventListener('visibilitychange', this.visibilityHandler);
-  }
-
-  private stopPolling() {
-    if (this.pollTimer !== null) {
-      clearInterval(this.pollTimer);
-      this.pollTimer = null;
-    }
-    if (this.visibilityHandler) {
-      document.removeEventListener('visibilitychange', this.visibilityHandler);
-      this.visibilityHandler = null;
-    }
+    backlogEvents.offChange(this.changeHandler);
   }
 
   setTaskId(taskId: string | null) {

package/viewer/components/task-detail.ts

@@ -1,6 +1,7 @@
 import { fetchTask, fetchOperationCount } from '../utils/api.js';
 import type { Reference } from '../utils/api.js';
 import { copyIcon, activityIcon } from '../icons/index.js';
+import { backlogEvents } from '../services/event-source-client.js';
 
 function linkify(input: string | Reference): string {
   if (typeof input === 'string') {
@@ -11,10 +12,19 @@ function linkify(input: string | Reference): string {
 }
 
 export class TaskDetail extends HTMLElement {
+  private currentTaskId: string | null = null;
+
   connectedCallback() {
     this.showEmpty();
+
+    // Re-fetch displayed task when it changes via SSE
+    backlogEvents.onChange((event) => {
+      if (this.currentTaskId && event.type === 'task_changed' && event.id === this.currentTaskId) {
+        this.loadTask(this.currentTaskId);
+      }
+    });
   }
-  
+
   showEmpty() {
     this.innerHTML = `
       <div class="empty-state">
@@ -25,6 +35,7 @@ export class TaskDetail extends HTMLElement {
   }
   
   async loadTask(taskId: string) {
+    this.currentTaskId = taskId;
     try {
       const task = await fetchTask(taskId);
       

package/viewer/components/task-list.ts

@@ -1,4 +1,5 @@
 import { fetchTasks, type Task } from '../utils/api.js';
+import { backlogEvents } from '../services/event-source-client.js';
 import './breadcrumb.js';
 import { ringIcon } from '../icons/index.js';
 
@@ -17,42 +18,48 @@ export class TaskList extends HTMLElement {
   private selectedTaskId: string | null = null;
   private currentQuery: string | null = null;
   private allTasks: Task[] = [];
-  
+
   connectedCallback() {
     const params = new URLSearchParams(window.location.search);
     this.selectedTaskId = params.get('task');
     this.currentEpicId = params.get('epic');
     this.currentQuery = params.get('q');
-    
+
     // Restore sort from localStorage
     const savedSort = localStorage.getItem(SORT_STORAGE_KEY);
     if (savedSort) {
       this.currentSort = savedSort;
     }
-    
+
     this.loadTasks();
-    setInterval(() => this.loadTasks(), 5000);
-    
+
+    // Real-time updates via centralized event service
+    backlogEvents.onChange((event) => {
+      if (event.type === 'task_changed' || event.type === 'task_created' || event.type === 'task_deleted') {
+        this.loadTasks();
+      }
+    });
+
     document.addEventListener('filter-change', ((e: CustomEvent) => {
       this.currentFilter = e.detail.filter;
       this.currentType = e.detail.type ?? 'all';
       this.loadTasks();
     }) as EventListener);
-    
+
     document.addEventListener('sort-change', ((e: CustomEvent) => {
       this.currentSort = e.detail.sort;
       this.loadTasks();
     }) as EventListener);
-    
+
     document.addEventListener('search-change', ((e: CustomEvent) => {
       this.currentQuery = e.detail.query || null;
       this.loadTasks();
     }) as EventListener);
-    
+
     document.addEventListener('task-selected', ((e: CustomEvent) => {
       this.setSelected(e.detail.taskId);
     }) as EventListener);
-    
+
     document.addEventListener('epic-navigate', ((e: CustomEvent) => {
       this.currentEpicId = e.detail.epicId;
       if (e.detail.epicId) {
@@ -61,7 +68,7 @@ export class TaskList extends HTMLElement {
       this.loadTasks();
     }) as EventListener);
   }
-  
+
   setState(filter: string, type: string, epicId: string | null, taskId: string | null, query: string | null) {
     this.currentFilter = filter;
     this.currentType = type;
@@ -70,7 +77,7 @@ export class TaskList extends HTMLElement {
     this.currentQuery = query;
     this.loadTasks();
   }
-  
+
   private sortTasks(tasks: Task[]): Task[] {
     const sorted = [...tasks];
     switch (this.currentSort) {
@@ -83,20 +90,20 @@ export class TaskList extends HTMLElement {
         return sorted.sort((a, b) => new Date(b.updated_at).getTime() - new Date(a.updated_at).getTime());
     }
   }
-  
+
   async loadTasks() {
     try {
       let tasks = await fetchTasks(this.currentFilter as any, this.currentQuery || undefined);
       this.allTasks = tasks;
-      
+
       // Type filter
       if (this.currentType !== 'all') {
         tasks = tasks.filter(t => (t.type ?? 'task') === this.currentType);
       }
-      
+
       // Apply sort
       tasks = this.sortTasks(tasks);
-      
+
       // Epic navigation filter
       if (this.currentEpicId) {
         const currentEpic = tasks.find(t => t.id === this.currentEpicId);
@@ -108,9 +115,9 @@ export class TaskList extends HTMLElement {
         const orphanTasks = tasks.filter(t => (t.type ?? 'task') === 'task' && !t.epic_id);
         tasks = [...rootEpics, ...orphanTasks];
       }
-      
+
       this.render(tasks);
-      
+
       const breadcrumb = this.querySelector('epic-breadcrumb');
       if (breadcrumb) {
         (breadcrumb as any).setData(this.currentEpicId, this.allTasks);
@@ -119,13 +126,13 @@ export class TaskList extends HTMLElement {
       this.innerHTML = `<div class="error">Failed to load tasks: ${(error as Error).message}</div>`;
     }
   }
-  
+
   render(tasks: Task[]) {
     const isEmpty = tasks.length === 0;
     const isInsideEpic = !!this.currentEpicId;
     const currentEpic = isInsideEpic ? tasks.find(t => t.id === this.currentEpicId) : null;
     const hasOnlyEpic = isInsideEpic && tasks.length === 1 && currentEpic;
-    
+
     if (isEmpty) {
       this.innerHTML = `
         <epic-breadcrumb></epic-breadcrumb>
@@ -140,22 +147,22 @@ export class TaskList extends HTMLElement {
       }
       return;
     }
-    
+
     // Group: epics first, then tasks
     const epics = tasks.filter(t => (t.type ?? 'task') === 'epic');
     const regularTasks = tasks.filter(t => (t.type ?? 'task') === 'task');
     const grouped = [...epics, ...regularTasks];
-    
+
     this.innerHTML = `
       <epic-breadcrumb></epic-breadcrumb>
       <div class="task-list">
         ${grouped.map((task, index) => {
-          const childCount = (task.type ?? 'task') === 'epic' 
-            ? this.allTasks.filter(t => t.epic_id === task.id).length 
+          const childCount = (task.type ?? 'task') === 'epic'
+            ? this.allTasks.filter(t => t.epic_id === task.id).length
             : 0;
           const isCurrentEpic = this.currentEpicId === task.id;
           return `
-            <task-item 
+            <task-item
               data-id="${task.id}"
               data-title="${escapeAttr(task.title)}"
               data-status="${task.status}"
@@ -170,13 +177,13 @@ export class TaskList extends HTMLElement {
         ${hasOnlyEpic ? '<div class="empty-state-inline"><div class="empty-state-icon">—</div><div>No tasks in this epic</div></div>' : ''}
       </div>
     `;
-    
+
     const breadcrumb = this.querySelector('epic-breadcrumb');
     if (breadcrumb) {
       (breadcrumb as any).setData(this.currentEpicId, this.allTasks);
     }
   }
-  
+
   setSelected(taskId: string) {
     this.selectedTaskId = taskId;
   }

package/viewer/main.ts

@@ -16,6 +16,10 @@ import './components/activity-panel.js';
 import './components/backlog-app.js';
 import { urlState } from './utils/url-state.js';
 import { splitPane } from './utils/split-pane.js';
+import { backlogEvents } from './services/event-source-client.js';
+
+// Connect to SSE for real-time updates
+backlogEvents.connect();
 
 // Component events -> URL updates
 document.addEventListener('filter-change', ((e: CustomEvent) => {

package/viewer/services/event-source-client.ts

@@ -0,0 +1,62 @@
+/**
+ * Centralized real-time update service for the viewer.
+ *
+ * Owns the SSE connection and provides a simple subscribe/unsubscribe
+ * API for components. Components have zero knowledge of SSE, EventSource,
+ * or transport details — they just register callbacks.
+ */
+
+import { API_URL } from '../utils/api.js';
+
+export type BacklogEventType = 'task_changed' | 'task_created' | 'task_deleted' | 'resource_changed';
+
+export interface BacklogEvent {
+  seq: number;
+  type: BacklogEventType;
+  id: string;
+  tool: string;
+  actor: string;
+  ts: string;
+}
+
+export type ChangeCallback = (event: BacklogEvent) => void;
+
+class BacklogEvents {
+  private source: EventSource | null = null;
+  private listeners = new Set<ChangeCallback>();
+
+  /** Start listening for server events. Call once on app init. */
+  connect(): void {
+    if (this.source) return;
+
+    this.source = new EventSource(`${API_URL}/events`);
+
+    this.source.onmessage = (e) => {
+      try {
+        const event: BacklogEvent = JSON.parse(e.data);
+        for (const cb of this.listeners) {
+          cb(event);
+        }
+      } catch {
+        // Ignore malformed messages
+      }
+    };
+  }
+
+  /** Subscribe to all backlog change events. */
+  onChange(callback: ChangeCallback): void {
+    this.listeners.add(callback);
+  }
+
+  /** Unsubscribe from change events. */
+  offChange(callback: ChangeCallback): void {
+    this.listeners.delete(callback);
+  }
+
+  disconnect(): void {
+    this.source?.close();
+    this.source = null;
+  }
+}
+
+export const backlogEvents = new BacklogEvents();