backlog-mcp 0.8.0 → 0.9.0

package/dist/schema.d.ts

@@ -1,16 +1,25 @@
 export declare function isValidTaskId(id: unknown): id is string;
 export declare function parseTaskId(id: string): number | null;
-export declare function formatTaskId(num: number): string;
+export declare function formatTaskId(num: number, type?: 'task' | 'epic'): string;
 export declare function nextTaskId(existingTasks: ReadonlyArray<{
     id: string;
-}>): string;
+}>, type?: 'task' | 'epic'): string;
 export declare const STATUSES: readonly ["open", "in_progress", "blocked", "done", "cancelled"];
 export type Status = (typeof STATUSES)[number];
+export declare const TASK_TYPES: readonly ["task", "epic"];
+export type TaskType = (typeof TASK_TYPES)[number];
+export interface Reference {
+    url: string;
+    title?: string;
+}
 export interface Task {
     id: string;
     title: string;
     description?: string;
     status: Status;
+    type?: TaskType;
+    epic_id?: string;
+    references?: Reference[];
     created_at: string;
     updated_at: string;
     blocked_reason?: string;
@@ -20,6 +29,9 @@ export interface CreateTaskInput {
     id?: string;
     title: string;
     description?: string;
+    type?: TaskType;
+    epic_id?: string;
+    references?: Reference[];
 }
 export declare function createTask(input: CreateTaskInput, existingTasks?: ReadonlyArray<{
     id: string;

package/dist/schema.js

@@ -2,41 +2,55 @@
 // Task ID
 // ============================================================================
 const TASK_ID_PATTERN = /^TASK-(\d{4,})$/;
+const EPIC_ID_PATTERN = /^EPIC-(\d{4,})$/;
 export function isValidTaskId(id) {
-    return typeof id === 'string' && TASK_ID_PATTERN.test(id);
+    return typeof id === 'string' && (TASK_ID_PATTERN.test(id) || EPIC_ID_PATTERN.test(id));
 }
 export function parseTaskId(id) {
-    const match = TASK_ID_PATTERN.exec(id);
+    const match = TASK_ID_PATTERN.exec(id) || EPIC_ID_PATTERN.exec(id);
     if (!match?.[1])
         return null;
     return parseInt(match[1], 10);
 }
-export function formatTaskId(num) {
-    return `TASK-${num.toString().padStart(4, '0')}`;
+export function formatTaskId(num, type) {
+    const prefix = type === 'epic' ? 'EPIC' : 'TASK';
+    return `${prefix}-${num.toString().padStart(4, '0')}`;
 }
-export function nextTaskId(existingTasks) {
+export function nextTaskId(existingTasks, type) {
+    const pattern = type === 'epic' ? EPIC_ID_PATTERN : TASK_ID_PATTERN;
     let maxNum = 0;
     for (const task of existingTasks) {
-        const num = parseTaskId(task.id);
-        if (num !== null && num > maxNum) {
-            maxNum = num;
+        const match = pattern.exec(task.id);
+        if (match?.[1]) {
+            const num = parseInt(match[1], 10);
+            if (num > maxNum)
+                maxNum = num;
         }
     }
-    return formatTaskId(maxNum + 1);
+    return formatTaskId(maxNum + 1, type);
 }
 // ============================================================================
 // Status
 // ============================================================================
 export const STATUSES = ['open', 'in_progress', 'blocked', 'done', 'cancelled'];
+export const TASK_TYPES = ['task', 'epic'];
 export function createTask(input, existingTasks = []) {
     const now = new Date().toISOString();
-    return {
-        id: input.id ?? nextTaskId(existingTasks),
+    const task = {
+        id: input.id ?? nextTaskId(existingTasks, input.type),
         title: input.title,
-        description: input.description,
         status: 'open',
         created_at: now,
         updated_at: now,
     };
+    if (input.description)
+        task.description = input.description;
+    if (input.type)
+        task.type = input.type;
+    if (input.epic_id)
+        task.epic_id = input.epic_id;
+    if (input.references?.length)
+        task.references = input.references;
+    return task;
 }
 //# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAE1C,MAAM,UAAU,aAAa,CAAC,EAAW;IACvC,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,aAA4C;IACrE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,GAAG,MAAM,EAAE,CAAC;YACjC,MAAM,GAAG,GAAG,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAU,CAAC;AA4BzF,MAAM,UAAU,UAAU,CACxB,KAAsB,EACtB,gBAA+C,EAAE;IAEjD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,UAAU,CAAC,aAAa,CAAC;QACzC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,GAAG;KAChB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import 'dotenv/config';
+export {};

package/dist/server.js

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
-import 'dotenv/config';
+try {
+    await import('dotenv/config');
+}
+catch { }
 import { readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
-import { createTask, STATUSES } from './schema.js';
+import { createTask, STATUSES, TASK_TYPES } from './schema.js';
 import { storage } from './backlog.js';
 import { startViewer } from './viewer.js';
 // Read version from package.json
@@ -26,15 +29,21 @@ server.registerTool('backlog_list', {
     description: 'List tasks from backlog. Shows open/in_progress/blocked by default. Use status=["done"] to see completed tasks.',
     inputSchema: {
         status: z.array(z.enum(STATUSES)).optional().describe('Filter: open, in_progress, blocked, done, cancelled. Default: open, in_progress, blocked'),
+        type: z.enum(TASK_TYPES).optional().describe('Filter by type: task, epic, or omit for all'),
+        epic_id: z.string().optional().describe('Filter tasks belonging to a specific epic'),
         counts: z.boolean().optional().describe('Return counts per status instead of task list'),
         limit: z.number().optional().describe('Max tasks to return. Default: 20'),
     },
-}, async ({ status, counts, limit }) => {
-    const tasks = storage.list({ status, limit });
+}, async ({ status, type, epic_id, counts, limit }) => {
+    let tasks = storage.list({ status, limit });
+    if (type)
+        tasks = tasks.filter(t => (t.type ?? 'task') === type);
+    if (epic_id)
+        tasks = tasks.filter(t => t.epic_id === epic_id);
     if (counts) {
         return { content: [{ type: 'text', text: JSON.stringify(storage.counts(), null, 2) }] };
     }
-    const list = tasks.map((t) => ({ id: t.id, title: t.title, status: t.status }));
+    const list = tasks.map((t) => ({ id: t.id, title: t.title, status: t.status, type: t.type ?? 'task', epic_id: t.epic_id }));
     return { content: [{ type: 'text', text: JSON.stringify(list, null, 2) }] };
 });
 server.registerTool('backlog_get', {
@@ -55,9 +64,12 @@ server.registerTool('backlog_create', {
     inputSchema: {
         title: z.string().describe('Task title'),
         description: z.string().optional().describe('Task description in markdown'),
+        type: z.enum(TASK_TYPES).optional().describe('Type: task (default) or epic'),
+        epic_id: z.string().optional().describe('Parent epic ID to link this task to'),
+        references: z.array(z.object({ url: z.string(), title: z.string().optional() })).optional().describe('Reference links with optional titles'),
     },
-}, async ({ title, description }) => {
-    const task = createTask({ title, description }, storage.list());
+}, async ({ title, description, type, epic_id, references }) => {
+    const task = createTask({ title, description, type, epic_id, references }, storage.list());
     storage.add(task);
     return { content: [{ type: 'text', text: `Created ${task.id}` }] };
 });
@@ -68,20 +80,32 @@ server.registerTool('backlog_update', {
         title: z.string().optional().describe('New title'),
         description: z.string().optional().describe('New description'),
         status: z.enum(STATUSES).optional().describe('New status'),
+        epic_id: z.string().nullable().optional().describe('Parent epic ID (null to unlink)'),
+        references: z.array(z.object({ url: z.string(), title: z.string().optional() })).optional().describe('Reference links with optional titles'),
         blocked_reason: z.string().optional().describe('Reason if status is blocked'),
         evidence: z.array(z.string()).optional().describe('Proof of completion when marking done - links to PRs, docs, or notes'),
     },
-}, async ({ id, title, description, status, blocked_reason, evidence }) => {
+}, async ({ id, title, description, status, epic_id, references, blocked_reason, evidence }) => {
     const task = storage.get(id);
     if (!task) {
         return { content: [{ type: 'text', text: `Not found: ${id}` }], isError: true };
     }
-    const updates = { title, description, status, blocked_reason, evidence };
-    const updated = {
-        ...task,
-        ...Object.fromEntries(Object.entries(updates).filter(([_, v]) => v !== undefined)),
-        updated_at: new Date().toISOString(),
-    };
+    const updates = {};
+    if (title !== undefined)
+        updates.title = title;
+    if (description !== undefined)
+        updates.description = description;
+    if (status !== undefined)
+        updates.status = status;
+    if (epic_id !== undefined)
+        updates.epic_id = epic_id ?? undefined;
+    if (references !== undefined)
+        updates.references = references;
+    if (blocked_reason !== undefined)
+        updates.blocked_reason = blocked_reason;
+    if (evidence !== undefined)
+        updates.evidence = evidence;
+    const updated = { ...task, ...updates, updated_at: new Date().toISOString() };
     storage.save(updated);
     return { content: [{ type: 'text', text: `Updated ${id}` }] };
 });

package/dist/server.js.map

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

package/dist/viewer/components/task-badge.js

@@ -0,0 +1,20 @@
+import { epicIcon, taskIcon } from '../icons/index.js';
+export class TaskBadge extends HTMLElement {
+    connectedCallback() {
+        this.render();
+    }
+    static get observedAttributes() {
+        return ['task-id', 'type'];
+    }
+    attributeChangedCallback() {
+        this.render();
+    }
+    render() {
+        const id = this.getAttribute('task-id') || '';
+        const type = this.getAttribute('type') || 'task';
+        const icon = type === 'epic' ? epicIcon : taskIcon;
+        this.className = `task-badge type-${type}`;
+        this.innerHTML = `<span class="task-badge-icon">${icon}</span><span class="task-badge-id">${id}</span>`;
+    }
+}
+customElements.define('task-badge', TaskBadge);

package/dist/viewer/components/task-detail.js

@@ -21,7 +21,8 @@ export class TaskDetail extends HTMLElement {
             const task = await fetchTask(taskId);
             const headerHtml = `
         <div class="task-header-left">
-          <button class="btn-outline task-id-btn" onclick="navigator.clipboard.writeText('${task.id}')" title="Copy ID">${task.id} ${copyIcon}</button>
+          ${task.epic_id ? `<button class="btn-outline epic-id-btn" onclick="navigator.clipboard.writeText('${task.epic_id}')" title="Copy Epic ID"><task-badge task-id="${task.epic_id}" type="epic"></task-badge> ${copyIcon}</button>` : ''}
+          <button class="btn-outline task-id-btn" onclick="navigator.clipboard.writeText('${task.id}')" title="Copy ID"><task-badge task-id="${task.id}" type="${task.type || 'task'}"></task-badge> ${copyIcon}</button>
           <span class="status-badge status-${task.status || 'open'}">${(task.status || 'open').replace('_', ' ')}</span>
           ${task.filePath ? `
             <div class="task-meta-path">
@@ -38,10 +39,21 @@ export class TaskDetail extends HTMLElement {
             const metaHtml = `
         <div class="task-meta-card">
           <h1 class="task-meta-title">${task.title || ''}</h1>
-          <div class="task-meta-dates">
+          <div class="task-meta-row">
             <span>Created: ${task.created_at ? new Date(task.created_at).toLocaleDateString() : ''}</span>
             <span>Updated: ${task.updated_at ? new Date(task.updated_at).toLocaleDateString() : ''}</span>
+            ${task.epic_id ? `<span class="task-meta-epic"><span class="task-meta-epic-label">Epic:</span><a href="#" class="epic-link" data-epic-id="${task.epic_id}"><task-badge task-id="${task.epic_id}" type="epic"></task-badge></a>${task.epicTitle ? `<span class="epic-title">${task.epicTitle}</span>` : ''}</span>` : ''}
           </div>
+          ${task.references?.length ? `
+            <div class="task-meta-evidence">
+              <div class="task-meta-evidence-label">References:</div>
+              <ul>${task.references.map((r) => {
+                const url = typeof r === 'string' ? r : r.url;
+                const title = typeof r === 'string' ? r : (r.title || r.url);
+                return `<li><a href="${url}" target="_blank" rel="noopener">${title}</a></li>`;
+            }).join('')}</ul>
+            </div>
+          ` : ''}
           ${task.evidence?.length ? `
             <div class="task-meta-evidence">
               <div class="task-meta-evidence-label">Evidence:</div>
@@ -58,6 +70,18 @@ export class TaskDetail extends HTMLElement {
             article.appendChild(mdBlock);
             this.innerHTML = '';
             this.appendChild(article);
+            // Bind epic link click to navigate
+            const epicLink = this.querySelector('.epic-link');
+            if (epicLink) {
+                epicLink.addEventListener('click', (e) => {
+                    e.preventDefault();
+                    const epicId = epicLink.dataset.epicId;
+                    if (epicId) {
+                        this.loadTask(epicId);
+                        document.dispatchEvent(new CustomEvent('task-selected', { detail: { taskId: epicId } }));
+                    }
+                });
+            }
             // Bind copy raw button (in pane header)
             const copyRawBtn = paneHeader?.querySelector('.copy-raw');
             if (copyRawBtn && task.raw) {

package/dist/viewer/components/task-filter-bar.js

@@ -3,31 +3,57 @@ const FILTERS = [
     { key: 'completed', label: 'Completed' },
     { key: 'all', label: 'All' },
 ];
+const TYPE_FILTERS = [
+    { key: 'task', label: 'Tasks' },
+    { key: 'epic', label: 'Epics' },
+    { key: 'all', label: 'All' },
+];
 export class TaskFilterBar extends HTMLElement {
     currentFilter = 'active';
+    currentType = 'all';
     connectedCallback() {
         this.render();
         this.attachListeners();
     }
     render() {
-        const buttons = FILTERS.map(f => `<button class="filter-btn ${this.currentFilter === f.key ? 'active' : ''}" data-filter="${f.key}">${f.label}</button>`).join('');
-        this.innerHTML = `<div class="filter-bar">${buttons}</div>`;
+        const statusButtons = FILTERS.map(f => `<button class="filter-btn ${this.currentFilter === f.key ? 'active' : ''}" data-filter="${f.key}">${f.label}</button>`).join('');
+        const typeButtons = TYPE_FILTERS.map(f => `<button class="filter-btn ${this.currentType === f.key ? 'active' : ''}" data-type="${f.key}">${f.label}</button>`).join('');
+        this.innerHTML = `
+      <div class="filter-bar"><span class="filter-label">Status</span>${statusButtons}</div>
+      <div class="filter-bar type-filter"><span class="filter-label">Type</span>${typeButtons}</div>
+    `;
     }
     attachListeners() {
-        this.querySelectorAll('.filter-btn').forEach(btn => {
+        this.querySelectorAll('[data-filter]').forEach(btn => {
             btn.addEventListener('click', (e) => {
                 const filter = e.target.dataset.filter;
                 if (filter)
                     this.setFilter(filter);
             });
         });
+        this.querySelectorAll('[data-type]').forEach(btn => {
+            btn.addEventListener('click', (e) => {
+                const type = e.target.dataset.type;
+                if (type)
+                    this.setType(type);
+            });
+        });
     }
     setFilter(filter) {
+        document.dispatchEvent(new CustomEvent('filter-change', { detail: { filter, type: this.currentType } }));
+    }
+    setType(type) {
+        document.dispatchEvent(new CustomEvent('filter-change', { detail: { filter: this.currentFilter, type } }));
+    }
+    setState(filter, type) {
         this.currentFilter = filter;
-        this.querySelectorAll('.filter-btn').forEach(btn => {
+        this.currentType = type;
+        this.querySelectorAll('[data-filter]').forEach(btn => {
             btn.classList.toggle('active', btn.dataset.filter === filter);
         });
-        document.dispatchEvent(new CustomEvent('filter-change', { detail: { filter } }));
+        this.querySelectorAll('[data-type]').forEach(btn => {
+            btn.classList.toggle('active', btn.dataset.type === type);
+        });
     }
 }
 customElements.define('task-filter-bar', TaskFilterBar);

package/dist/viewer/components/task-item.js

@@ -1,3 +1,4 @@
+import { pinIcon } from '../icons/index.js';
 export class TaskItem extends HTMLElement {
     connectedCallback() {
         this.render();
@@ -7,39 +8,50 @@ export class TaskItem extends HTMLElement {
         const id = this.dataset.id || '';
         const title = this.dataset.title || '';
         const status = this.dataset.status || 'open';
+        const type = this.dataset.type || 'task';
+        const isChild = this.dataset.child === 'true';
+        const isPinned = this.hasAttribute('pinned');
         const isSelected = this.hasAttribute('selected');
-        this.className = `task-item ${isSelected ? 'selected' : ''}`;
+        this.className = `task-item-wrapper ${isPinned ? 'pinned' : ''} ${isChild ? 'child' : ''}`;
         this.innerHTML = `
-      <div class="task-item-header">
-        <span class="task-id">${id}</span>
+      <div class="task-item ${isSelected ? 'selected' : ''} type-${type}">
+        <task-badge task-id="${id}" type="${type}"></task-badge>
         <span class="task-title">${title}</span>
         <span class="status-badge status-${status}">${status.replace('_', ' ')}</span>
       </div>
+      ${type === 'epic' ? `<button class="pin-btn ${isPinned ? 'pinned' : ''}" title="${isPinned ? 'Unpin' : 'Pin to filter'}">${pinIcon}</button>` : ''}
     `;
     }
     attachListeners() {
-        this.addEventListener('click', () => {
+        const taskItem = this.querySelector('.task-item');
+        taskItem?.addEventListener('click', () => {
             const taskId = this.dataset.id;
             if (!taskId)
                 return;
-            // Update selection in list
-            document.querySelectorAll('task-item').forEach(item => {
-                const htmlItem = item;
-                item.classList.toggle('selected', htmlItem.dataset.id === taskId);
+            document.querySelectorAll('task-item .task-item').forEach(item => {
+                item.classList.toggle('selected', item.closest('task-item')?.dataset.id === taskId);
             });
-            // Notify detail pane
             const detailPane = document.querySelector('task-detail');
             if (detailPane) {
                 detailPane.loadTask(taskId);
             }
-            // Emit event for URL state
             document.dispatchEvent(new CustomEvent('task-selected', { detail: { taskId } }));
-            // Update task list's selected state
             const taskList = document.querySelector('task-list');
             if (taskList) {
                 taskList.setSelected(taskId);
             }
         });
+        const pinBtn = this.querySelector('.pin-btn');
+        if (pinBtn) {
+            pinBtn.addEventListener('click', (e) => {
+                e.stopPropagation();
+                const epicId = this.dataset.id;
+                if (!epicId)
+                    return;
+                const isPinned = this.hasAttribute('pinned');
+                document.dispatchEvent(new CustomEvent('epic-pin', { detail: { epicId: isPinned ? null : epicId } }));
+            });
+        }
     }
 }
 customElements.define('task-item', TaskItem);

package/dist/viewer/components/task-list.js

@@ -4,26 +4,48 @@ function escapeAttr(text) {
 }
 export class TaskList extends HTMLElement {
     currentFilter = 'active';
+    currentType = 'all';
+    pinnedEpicId = null;
     selectedTaskId = null;
     connectedCallback() {
-        // Get initial selection from URL
         const params = new URLSearchParams(window.location.search);
         this.selectedTaskId = params.get('task');
+        this.pinnedEpicId = params.get('epic');
         this.loadTasks();
         setInterval(() => this.loadTasks(), 5000);
-        // Listen for filter changes
         document.addEventListener('filter-change', ((e) => {
             this.currentFilter = e.detail.filter;
+            this.currentType = e.detail.type ?? 'all';
             this.loadTasks();
         }));
-        // Listen for task selection
         document.addEventListener('task-selected', ((e) => {
             this.setSelected(e.detail.taskId);
         }));
+        document.addEventListener('epic-pin', ((e) => {
+            this.pinnedEpicId = e.detail.epicId;
+            this.loadTasks();
+        }));
+    }
+    setState(filter, type, epicId, taskId) {
+        this.currentFilter = filter;
+        this.currentType = type;
+        this.pinnedEpicId = epicId;
+        this.selectedTaskId = taskId;
+        this.loadTasks();
     }
     async loadTasks() {
         try {
-            const tasks = await fetchTasks(this.currentFilter);
+            let tasks = await fetchTasks(this.currentFilter);
+            // Type filter
+            if (this.currentType !== 'all') {
+                tasks = tasks.filter(t => (t.type ?? 'task') === this.currentType);
+            }
+            // Epic pin filter
+            if (this.pinnedEpicId) {
+                const pinnedEpic = tasks.find(t => t.id === this.pinnedEpicId);
+                const children = tasks.filter(t => t.epic_id === this.pinnedEpicId);
+                tasks = pinnedEpic ? [pinnedEpic, ...children] : children;
+            }
             this.render(tasks);
         }
         catch (error) {
@@ -40,14 +62,29 @@ export class TaskList extends HTMLElement {
       `;
             return;
         }
+        // Group: epics first with their children, then orphan tasks
+        const epics = tasks.filter(t => (t.type ?? 'task') === 'epic');
+        const childTasks = tasks.filter(t => t.epic_id && epics.some(e => e.id === t.epic_id));
+        const orphanTasks = tasks.filter(t => (t.type ?? 'task') === 'task' && !childTasks.includes(t));
+        const grouped = [];
+        for (const epic of epics) {
+            grouped.push(epic);
+            for (const child of childTasks.filter(t => t.epic_id === epic.id)) {
+                grouped.push({ ...child, isChild: true });
+            }
+        }
+        grouped.push(...orphanTasks);
         this.innerHTML = `
       <div class="task-list">
-        ${tasks.map(task => `
+        ${grouped.map(task => `
           <task-item 
             data-id="${task.id}"
             data-title="${escapeAttr(task.title)}"
             data-status="${task.status}"
+            data-type="${task.type ?? 'task'}"
+            ${task.isChild ? 'data-child="true"' : ''}
             ${this.selectedTaskId === task.id ? 'selected' : ''}
+            ${this.pinnedEpicId === task.id ? 'pinned' : ''}
           ></task-item>
         `).join('')}
       </div>

package/dist/viewer/icons/index.js

@@ -1 +1,4 @@
 export const copyIcon = `<svg viewBox="0 0 16 16" width="14" height="14" fill="currentColor"><path d="M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 010 1.5h-1.5a.25.25 0 00-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 00.25-.25v-1.5a.75.75 0 011.5 0v1.5A1.75 1.75 0 019.25 16h-7.5A1.75 1.75 0 010 14.25v-7.5z"/><path d="M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0114.25 11h-7.5A1.75 1.75 0 015 9.25v-7.5zm1.75-.25a.25.25 0 00-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 00.25-.25v-7.5a.25.25 0 00-.25-.25h-7.5z"/></svg>`;
+export const pinIcon = `<svg viewBox="0 0 16 16" width="14" height="14" fill="currentColor"><path d="M4.456.734a1.75 1.75 0 012.826.504l.613 1.327a3.08 3.08 0 002.084 1.707l2.454.584c1.332.317 1.8 1.972.832 2.94L11.06 10l3.72 3.72a.75.75 0 11-1.06 1.06L10 11.06l-2.204 2.205c-.968.968-2.623.5-2.94-.832l-.584-2.454a3.08 3.08 0 00-1.707-2.084l-1.327-.613a1.75 1.75 0 01-.504-2.826L4.456.734z"/></svg>`;
+export const epicIcon = `<svg viewBox="0 0 16 16" width="14" height="14" fill="none" xmlns="http://www.w3.org/2000/svg"><defs><linearGradient id="epicGrad" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" stop-color="#f0b429"/><stop offset="100%" stop-color="#ff6b2d"/></linearGradient></defs><polygon points="8,1 14,4.5 14,11.5 8,15 2,11.5 2,4.5" stroke="url(#epicGrad)" stroke-width="1.5" fill="none"/><circle cx="8" cy="8" r="2" fill="url(#epicGrad)"/></svg>`;
+export const taskIcon = `<svg viewBox="0 0 16 16" width="14" height="14" fill="none" xmlns="http://www.w3.org/2000/svg"><defs><linearGradient id="taskGrad" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" stop-color="#00d4ff"/><stop offset="100%" stop-color="#7b2dff"/></linearGradient></defs><polygon points="8,1 15,8 8,15 1,8" stroke="url(#taskGrad)" stroke-width="1.5" fill="none"/></svg>`;

package/dist/viewer/main.js

@@ -2,30 +2,28 @@ import './components/task-filter-bar.js';
 import './components/task-list.js';
 import './components/task-item.js';
 import './components/task-detail.js';
-// URL state management
-const params = new URLSearchParams(window.location.search);
-const initialFilter = params.get('filter') || 'active';
-const initialTask = params.get('task');
-// Set initial filter
-document.addEventListener('DOMContentLoaded', () => {
+import './components/task-badge.js';
+import { urlState } from './utils/url-state.js';
+// Subscribe components to URL state changes - single source of truth
+urlState.subscribe((state) => {
     const filterBar = document.querySelector('task-filter-bar');
-    if (filterBar?.setFilter)
-        filterBar.setFilter(initialFilter);
-    if (initialTask) {
+    filterBar?.setState?.(state.filter, state.type);
+    const taskList = document.querySelector('task-list');
+    taskList?.setState?.(state.filter, state.type, state.epic, state.task);
+    if (state.task) {
         const detail = document.querySelector('task-detail');
-        if (detail?.loadTask)
-            detail.loadTask(initialTask);
+        detail?.loadTask?.(state.task);
     }
 });
-// Update URL on filter change
+// Initialize on load
+document.addEventListener('DOMContentLoaded', () => urlState.init());
+// Component events -> URL updates
 document.addEventListener('filter-change', ((e) => {
-    const url = new URL(window.location.href);
-    url.searchParams.set('filter', e.detail.filter);
-    history.replaceState(null, '', url);
+    urlState.set({ filter: e.detail.filter, type: e.detail.type });
 }));
-// Update URL on task selection
 document.addEventListener('task-selected', ((e) => {
-    const url = new URL(window.location.href);
-    url.searchParams.set('task', e.detail.taskId);
-    history.replaceState(null, '', url);
+    urlState.set({ task: e.detail.taskId });
+}));
+document.addEventListener('epic-pin', ((e) => {
+    urlState.set({ epic: e.detail.epicId });
 }));

package/dist/viewer/utils/url-state.js

@@ -0,0 +1,42 @@
+class UrlState {
+    listeners = [];
+    pushing = false;
+    constructor() {
+        window.addEventListener('popstate', () => this.notify());
+    }
+    get() {
+        const params = new URLSearchParams(window.location.search);
+        return {
+            filter: params.get('filter') || 'active',
+            type: params.get('type') || 'all',
+            task: params.get('task'),
+            epic: params.get('epic'),
+        };
+    }
+    set(updates) {
+        if (this.pushing)
+            return;
+        this.pushing = true;
+        const url = new URL(window.location.href);
+        for (const [key, value] of Object.entries(updates)) {
+            if (value)
+                url.searchParams.set(key, value);
+            else
+                url.searchParams.delete(key);
+        }
+        history.pushState(null, '', url);
+        this.notify();
+        this.pushing = false;
+    }
+    subscribe(listener) {
+        this.listeners.push(listener);
+    }
+    notify() {
+        const state = this.get();
+        this.listeners.forEach(fn => fn(state));
+    }
+    init() {
+        this.notify();
+    }
+}
+export const urlState = new UrlState();

package/dist/viewer.js

@@ -87,8 +87,10 @@ export async function startViewer(port = 3030) {
             }
             const filePath = storage.getFilePath(taskId);
             const raw = storage.getMarkdown(taskId);
+            const epic = task.epic_id ? storage.get(task.epic_id) : null;
+            const epicTitle = epic?.title;
             res.writeHead(200, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ ...task, filePath, raw }));
+            res.end(JSON.stringify({ ...task, filePath, raw, epicTitle }));
             return;
         }
         // GET /open/:id - open file in default editor

package/dist/viewer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backlog-mcp",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Minimal task backlog MCP server for Claude and AI agents",
   "keywords": [
     "mcp",
@@ -44,7 +44,7 @@
     "start": "node dist/server.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "dev": "tsc -p viewer/tsconfig.json && concurrently \"tsx watch src/server.ts\" \"tsc -p viewer/tsconfig.json --watch --preserveWatchOutput\""
+    "dev": "lsof -ti:3030 | xargs kill -9 2>/dev/null; tsc -p viewer/tsconfig.json && concurrently \"tsx watch src/server.ts\" \"tsc -p viewer/tsconfig.json --watch --preserveWatchOutput\""
   },
   "engines": {
     "node": ">=18.0.0"

package/viewer/styles.css

@@ -72,10 +72,24 @@
     /* Filter Bar */
     .filter-bar {
       display: flex;
+      align-items: center;
       gap: 8px;
       flex-wrap: wrap;
     }
     
+    .filter-bar.type-filter {
+      margin-top: 8px;
+      padding-top: 8px;
+      border-top: 1px solid #3e3e42;
+    }
+    
+    .filter-label {
+      font-size: 11px;
+      color: #888;
+      text-transform: uppercase;
+      min-width: 40px;
+    }
+    
     .filter-btn {
       padding: 6px 12px;
       border: 1px solid #3e3e42;
@@ -101,16 +115,60 @@
     .task-list {
       display: flex;
       flex-direction: column;
-      gap: 8px;
+      gap: 6px;
+    }
+    
+    .task-item-wrapper {
+      display: flex;
+      align-items: stretch;
+      gap: 4px;
+      min-width: 0;
+    }
+    
+    .task-item-wrapper.child {
+      margin-left: 16px;
+      padding-left: 12px;
+      position: relative;
+    }
+    
+    .task-item-wrapper.child::before {
+      content: '';
+      position: absolute;
+      left: 0;
+      top: 50%;
+      width: 8px;
+      height: 1px;
+      background: #3e3e42;
+    }
+    
+    .task-item-wrapper.child::after {
+      content: '';
+      position: absolute;
+      left: 0;
+      top: -6px;
+      bottom: 50%;
+      width: 1px;
+      background: #3e3e42;
+    }
+    
+    .task-item-wrapper.pinned .task-item {
+      border-color: #f0b429;
+      background: #3d3522;
     }
     
     .task-item {
+      flex: 1;
+      display: flex;
+      align-items: center;
+      gap: 8px;
       background: #252526;
       border: 1px solid #3e3e42;
       border-radius: 6px;
       padding: 12px;
       cursor: pointer;
       transition: all 0.2s;
+      min-width: 0;
+      overflow: hidden;
     }
     
     .task-item:hover {
@@ -123,11 +181,28 @@
       border-color: #007acc;
     }
     
-    .task-item-header {
+    .task-item-wrapper > .pin-btn {
+      background: #252526;
+      border: 1px solid #3e3e42;
+      border-radius: 6px;
+      padding: 0 8px;
+      cursor: pointer;
+      color: #888;
       display: flex;
-      justify-content: space-between;
       align-items: center;
-      gap: 8px;
+      transition: all 0.2s;
+    }
+    
+    .task-item-wrapper > .pin-btn:hover {
+      background: #2d2d30;
+      border-color: #f0b429;
+      color: #f0b429;
+    }
+    
+    .task-item-wrapper > .pin-btn.pinned {
+      background: #3d3522;
+      border-color: #f0b429;
+      color: #f0b429;
     }
     
     .task-id {
@@ -139,6 +214,7 @@
     .task-title {
       font-size: 13px;
       flex: 1;
+      min-width: 0;
       white-space: nowrap;
       overflow: hidden;
       text-overflow: ellipsis;
@@ -150,6 +226,7 @@
       border-radius: 10px;
       font-weight: 500;
       text-transform: uppercase;
+      flex-shrink: 0;
     }
     
     .status-open { background: #1f6feb; color: white; }
@@ -158,6 +235,49 @@
     .status-done { background: #1a7f37; color: white; }
     .status-cancelled { background: #57606a; color: white; }
     
+    /* Task Badge */
+    .task-badge {
+      display: inline-flex;
+      align-items: center;
+      gap: 4px;
+      font-family: monospace;
+      font-size: inherit;
+      color: inherit;
+    }
+    
+    .task-badge-icon {
+      display: inline-flex;
+    }
+    
+    .task-badge-id {
+      font-weight: 600;
+    }
+    
+    .task-item .task-badge {
+      color: #888;
+    }
+    
+    .type-icon {
+      margin-right: 6px;
+      display: inline-flex;
+      vertical-align: middle;
+    }
+    
+    .type-icon.type-epic {
+      color: #f0b429;
+    }
+    
+    .type-icon.type-task {
+      color: #3b82f6;
+    }
+    
+    .epic-icon-inline {
+      display: inline-flex;
+      vertical-align: middle;
+      margin-right: 4px;
+      color: #f0b429;
+    }
+    
     /* Task Detail */
     .task-detail-header {
       margin-bottom: 20px;
@@ -310,11 +430,33 @@
   margin: 0 0 8px 0;
   font-weight: 600;
 }
-.task-meta-dates {
+.task-meta-row {
   font-size: 12px;
   color: #8b949e;
   display: flex;
+  align-items: center;
   gap: 16px;
+  flex-wrap: wrap;
+}
+.task-meta-epic {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+}
+.task-meta-epic-label {
+  margin-right: 0;
+}
+.epic-link {
+  color: #f0b429;
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+}
+.epic-link:hover {
+  text-decoration: underline;
+}
+.epic-title {
+  color: #d4d4d4;
 }
 .task-meta-path {
   display: flex;
@@ -430,7 +572,7 @@ task-detail .markdown-body {
 }
 
 
-.task-id-btn {
+.task-id-btn, .epic-id-btn {
   font-family: monospace;
   font-weight: 600;
 }