backlog-mcp 0.30.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/operations/storage.mjs

@@ -43,9 +43,10 @@ var OperationStorage = class {
 	* Query operations with optional filtering.
 	*/
 	query(filter = {}) {
-		const { taskId, limit = 50 } = filter;
+		const { taskId, date, limit = 50 } = filter;
 		let entries = this.readAll();
 		if (taskId) entries = entries.filter((e) => e.resourceId === taskId);
+		if (date) entries = entries.filter((e) => e.ts.startsWith(date));
 		return entries.reverse().slice(0, limit);
 	}
 	/**

package/dist/operations/storage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage.mjs","names":[],"sources":["../../src/operations/storage.ts"],"sourcesContent":["/**\n * JSONL storage for operation entries.\n * Single responsibility: read/write operations to disk.\n */\n\nimport { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { paths } from '@/utils/paths.js';\nimport type { OperationEntry, OperationFilter } from './types.js';\n\nexport class OperationStorage {\n  private logPath: string;\n\n  constructor() {\n    this.logPath = join(paths.backlogDataDir, '.internal', 'operations.jsonl');\n  }\n\n  /**\n   * Append an operation entry to the log file.\n   */\n  append(entry: OperationEntry): void {\n    try {\n      const dir = dirname(this.logPath);\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n      }\n      appendFileSync(this.logPath, JSON.stringify(entry) + '\\n', 'utf-8');\n    } catch {\n      // Fail silently - logging should not break tool execution\n    }\n  }\n\n  /**\n   * Read all operations from the log file.\n   */\n  readAll(): OperationEntry[] {\n    if (!existsSync(this.logPath)) return [];\n\n    try {\n      const content = readFileSync(this.logPath, 'utf-8');\n      const lines = content.trim().split('\\n').filter(Boolean);\n      \n      return lines\n        .map(line => {\n          try {\n            return JSON.parse(line) as OperationEntry;\n          } catch {\n            return null;\n          }\n        })\n        .filter((e): e is OperationEntry => e !== null);\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Query operations with optional filtering.\n   */\n  query(filter: OperationFilter = {}): OperationEntry[] {\n    const { taskId, limit = 50 } = filter;\n    \n    let entries = this.readAll();\n\n    if (taskId) {\n      entries = entries.filter(e => e.resourceId === taskId);\n    }\n\n    // Return most recent first, limited\n    return entries.reverse().slice(0, limit);\n  }\n\n  /**\n   * Count operations for a specific task.\n   */\n  countForTask(taskId: string): number {\n    return this.query({ taskId, limit: 1000 }).length;\n  }\n}\n"],"mappings":";;;;;;;;;AAUA,IAAa,mBAAb,MAA8B;CAC5B,AAAQ;CAER,cAAc;AACZ,OAAK,UAAU,KAAK,MAAM,gBAAgB,aAAa,mBAAmB;;;;;CAM5E,OAAO,OAA6B;AAClC,MAAI;GACF,MAAM,MAAM,QAAQ,KAAK,QAAQ;AACjC,OAAI,CAAC,WAAW,IAAI,CAClB,WAAU,KAAK,EAAE,WAAW,MAAM,CAAC;AAErC,kBAAe,KAAK,SAAS,KAAK,UAAU,MAAM,GAAG,MAAM,QAAQ;UAC7D;;;;;CAQV,UAA4B;AAC1B,MAAI,CAAC,WAAW,KAAK,QAAQ,CAAE,QAAO,EAAE;AAExC,MAAI;AAIF,UAHgB,aAAa,KAAK,SAAS,QAAQ,CAC7B,MAAM,CAAC,MAAM,KAAK,CAAC,OAAO,QAAQ,CAGrD,KAAI,SAAQ;AACX,QAAI;AACF,YAAO,KAAK,MAAM,KAAK;YACjB;AACN,YAAO;;KAET,CACD,QAAQ,MAA2B,MAAM,KAAK;UAC3C;AACN,UAAO,EAAE;;;;;;CAOb,MAAM,SAA0B,EAAE,EAAoB;EACpD,MAAM,EAAE,QAAQ,QAAQ,OAAO;EAE/B,IAAI,UAAU,KAAK,SAAS;AAE5B,MAAI,OACF,WAAU,QAAQ,QAAO,MAAK,EAAE,eAAe,OAAO;AAIxD,SAAO,QAAQ,SAAS,CAAC,MAAM,GAAG,MAAM;;;;;CAM1C,aAAa,QAAwB;AACnC,SAAO,KAAK,MAAM;GAAE;GAAQ,OAAO;GAAM,CAAC,CAAC"}
+{"version":3,"file":"storage.mjs","names":[],"sources":["../../src/operations/storage.ts"],"sourcesContent":["/**\n * JSONL storage for operation entries.\n * Single responsibility: read/write operations to disk.\n */\n\nimport { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { paths } from '@/utils/paths.js';\nimport type { OperationEntry, OperationFilter } from './types.js';\n\nexport class OperationStorage {\n  private logPath: string;\n\n  constructor() {\n    this.logPath = join(paths.backlogDataDir, '.internal', 'operations.jsonl');\n  }\n\n  /**\n   * Append an operation entry to the log file.\n   */\n  append(entry: OperationEntry): void {\n    try {\n      const dir = dirname(this.logPath);\n      if (!existsSync(dir)) {\n        mkdirSync(dir, { recursive: true });\n      }\n      appendFileSync(this.logPath, JSON.stringify(entry) + '\\n', 'utf-8');\n    } catch {\n      // Fail silently - logging should not break tool execution\n    }\n  }\n\n  /**\n   * Read all operations from the log file.\n   */\n  readAll(): OperationEntry[] {\n    if (!existsSync(this.logPath)) return [];\n\n    try {\n      const content = readFileSync(this.logPath, 'utf-8');\n      const lines = content.trim().split('\\n').filter(Boolean);\n      \n      return lines\n        .map(line => {\n          try {\n            return JSON.parse(line) as OperationEntry;\n          } catch {\n            return null;\n          }\n        })\n        .filter((e): e is OperationEntry => e !== null);\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Query operations with optional filtering.\n   */\n  query(filter: OperationFilter = {}): OperationEntry[] {\n    const { taskId, date, limit = 50 } = filter;\n    \n    let entries = this.readAll();\n\n    if (taskId) {\n      entries = entries.filter(e => e.resourceId === taskId);\n    }\n\n    if (date) {\n      // Filter by date (YYYY-MM-DD matches start of ISO timestamp)\n      entries = entries.filter(e => e.ts.startsWith(date));\n    }\n\n    // Return most recent first, limited\n    return entries.reverse().slice(0, limit);\n  }\n\n  /**\n   * Count operations for a specific task.\n   */\n  countForTask(taskId: string): number {\n    return this.query({ taskId, limit: 1000 }).length;\n  }\n}\n"],"mappings":";;;;;;;;;AAUA,IAAa,mBAAb,MAA8B;CAC5B,AAAQ;CAER,cAAc;AACZ,OAAK,UAAU,KAAK,MAAM,gBAAgB,aAAa,mBAAmB;;;;;CAM5E,OAAO,OAA6B;AAClC,MAAI;GACF,MAAM,MAAM,QAAQ,KAAK,QAAQ;AACjC,OAAI,CAAC,WAAW,IAAI,CAClB,WAAU,KAAK,EAAE,WAAW,MAAM,CAAC;AAErC,kBAAe,KAAK,SAAS,KAAK,UAAU,MAAM,GAAG,MAAM,QAAQ;UAC7D;;;;;CAQV,UAA4B;AAC1B,MAAI,CAAC,WAAW,KAAK,QAAQ,CAAE,QAAO,EAAE;AAExC,MAAI;AAIF,UAHgB,aAAa,KAAK,SAAS,QAAQ,CAC7B,MAAM,CAAC,MAAM,KAAK,CAAC,OAAO,QAAQ,CAGrD,KAAI,SAAQ;AACX,QAAI;AACF,YAAO,KAAK,MAAM,KAAK;YACjB;AACN,YAAO;;KAET,CACD,QAAQ,MAA2B,MAAM,KAAK;UAC3C;AACN,UAAO,EAAE;;;;;;CAOb,MAAM,SAA0B,EAAE,EAAoB;EACpD,MAAM,EAAE,QAAQ,MAAM,QAAQ,OAAO;EAErC,IAAI,UAAU,KAAK,SAAS;AAE5B,MAAI,OACF,WAAU,QAAQ,QAAO,MAAK,EAAE,eAAe,OAAO;AAGxD,MAAI,KAEF,WAAU,QAAQ,QAAO,MAAK,EAAE,GAAG,WAAW,KAAK,CAAC;AAItD,SAAO,QAAQ,SAAS,CAAC,MAAM,GAAG,MAAM;;;;;CAM1C,aAAa,QAAwB;AACnC,SAAO,KAAK,MAAM;GAAE;GAAQ,OAAO;GAAM,CAAC,CAAC"}

package/dist/operations/types.d.mts

@@ -19,6 +19,7 @@ interface OperationEntry {
 }
 interface OperationFilter {
   taskId?: string;
+  date?: string;
   limit?: number;
 }
 declare const WRITE_TOOLS: ToolName[];

package/dist/operations/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../src/operations/types.ts"],"sourcesContent":["/**\n * Types for operation logging.\n */\n\nexport interface Actor {\n  type: 'user' | 'agent';\n  name: string;\n  delegatedBy?: string;\n  taskContext?: string;\n}\n\nexport type ToolName = 'backlog_create' | 'backlog_update' | 'backlog_delete' | 'write_resource';\n\nexport interface OperationEntry {\n  ts: string;\n  tool: string;\n  params: Record<string, unknown>;\n  result: unknown;\n  resourceId?: string;\n  actor: Actor;\n}\n\nexport interface OperationFilter {\n  taskId?: string;\n  limit?: number;\n}\n\nexport const WRITE_TOOLS: ToolName[] = ['backlog_create', 'backlog_update', 'backlog_delete', 'write_resource'];\n"],"mappings":";AA2BA,MAAa,cAA0B;CAAC;CAAkB;CAAkB;CAAkB;CAAiB"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/operations/types.ts"],"sourcesContent":["/**\n * Types for operation logging.\n */\n\nexport interface Actor {\n  type: 'user' | 'agent';\n  name: string;\n  delegatedBy?: string;\n  taskContext?: string;\n}\n\nexport type ToolName = 'backlog_create' | 'backlog_update' | 'backlog_delete' | 'write_resource';\n\nexport interface OperationEntry {\n  ts: string;\n  tool: string;\n  params: Record<string, unknown>;\n  result: unknown;\n  resourceId?: string;\n  actor: Actor;\n}\n\nexport interface OperationFilter {\n  taskId?: string;\n  date?: string; // YYYY-MM-DD - filter by date\n  limit?: number;\n}\n\nexport const WRITE_TOOLS: ToolName[] = ['backlog_create', 'backlog_update', 'backlog_delete', 'write_resource'];\n"],"mappings":";AA4BA,MAAa,cAA0B;CAAC;CAAkB;CAAkB;CAAkB;CAAiB"}

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,
@@ -142,10 +144,11 @@ function registerViewerRoutes(app) {
 		return reply.redirect(`/?resource=${encodeURIComponent(uri)}`);
 	});
 	app.get("/operations", async (request) => {
-		const { limit, task } = request.query;
+		const { limit, task, date } = request.query;
 		const operations = operationLogger.read({
-			limit: limit ? parseInt(limit) : 50,
-			taskId: task || void 0
+			limit: limit ? parseInt(limit) : date ? 1e3 : 50,
+			taskId: task || void 0,
+			date: date || void 0
 		});
 		const taskCache = /* @__PURE__ */ new Map();
 		const epicCache = /* @__PURE__ */ new Map();
@@ -181,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 } = request.query as { limit?: string; task?: string };\n    \n    const operations = operationLogger.read({\n      limit: limit ? parseInt(limit) : 50,\n      taskId: task || 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.css

@@ -1409,6 +1409,15 @@ copy-button {
   color: #d4d4d4;
   flex-shrink: 0;
 }
+.activity-merged-badge {
+  font-size: 11px;
+  font-weight: 500;
+  color: #58a6ff;
+  background: rgba(88, 166, 255, 0.15);
+  padding: 2px 6px;
+  border-radius: 4px;
+  margin-left: 6px;
+}
 .activity-resource {
   flex: 1;
   color: #8b949e;
@@ -1562,22 +1571,37 @@ copy-button {
   border-radius: 6px;
   overflow: hidden;
   margin-top: 8px;
+  position: relative;
 }
 .activity-diff .d2h-file-header {
   display: none;
 }
 .activity-diff .d2h-file-wrapper {
   margin-bottom: 0;
+  border: none;
 }
 .activity-diff .d2h-diff-table {
   font-size: 12px;
 }
+.activity-diff .d2h-code-linenumber {
+  position: sticky;
+  left: 0;
+}
+.activity-diff-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.activity-diff-stack .activity-diff {
+  margin-top: 0;
+}
 .activity-day-separator {
   display: flex;
   align-items: center;
   gap: 8px;
-  padding: 12px 12px 10px;
-  margin-top: 16px;
+  padding: 12px 12px;
+  margin-top: 20px;
+  margin-bottom: 12px;
   position: sticky;
   top: 0;
   background: #252526;
@@ -1587,7 +1611,6 @@ copy-button {
 }
 .activity-day-separator:first-child {
   margin-top: 0;
-  padding-top: 12px;
 }
 .activity-day-label {
   font-weight: 700;
@@ -1757,19 +1780,23 @@ copy-button {
   flex: 1;
   overflow-y: auto;
   padding: 12px;
+  padding-bottom: 24px;
 }
 .activity-journal-section {
-  margin-bottom: 20px;
+  margin-bottom: 24px;
+  background: #1e1e1e;
+  border-radius: 8px;
+  padding: 12px;
 }
 .activity-journal-section:last-child {
-  margin-bottom: 0;
+  margin-bottom: 12px;
 }
 .activity-journal-section-title {
   font-weight: 600;
   color: #d4d4d4;
   font-size: 14px;
-  margin-bottom: 8px;
-  padding-bottom: 4px;
+  margin-bottom: 12px;
+  padding-bottom: 8px;
   border-bottom: 1px solid #30363d;
 }
 .activity-journal-list {
@@ -1781,7 +1808,16 @@ copy-button {
   display: flex;
   align-items: center;
   gap: 8px;
-  padding: 6px 0;
+  padding: 8px 0;
+  border-bottom: 1px solid #252525;
+  flex-wrap: nowrap;
+  min-width: 0;
+}
+.activity-journal-item:last-child {
+  border-bottom: none;
+}
+.activity-journal-item task-badge {
+  flex-shrink: 0;
 }
 .activity-journal-title {
   color: #8b949e;
@@ -1789,6 +1825,8 @@ copy-button {
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
+  flex: 1;
+  min-width: 0;
 }
 .activity-journal-epic-group {
   margin-bottom: 16px;
@@ -1801,11 +1839,18 @@ copy-button {
   align-items: center;
   gap: 8px;
   padding: 8px 0 4px 0;
+  flex-wrap: nowrap;
+}
+.activity-journal-epic-header task-badge {
+  flex-shrink: 0;
 }
 .activity-journal-epic-title {
   font-weight: 500;
   color: #d4d4d4;
   font-size: 13px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 .activity-journal-epic-group .activity-journal-list {
   padding-left: 12px;
@@ -1813,7 +1858,7 @@ copy-button {
   margin-left: 4px;
 }
 .activity-journal-epic-group .activity-journal-item {
-  padding: 4px 0;
+  padding: 6px 0;
 }
 
 /* viewer/github-markdown.css */