bdtui 0.2.3 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.3.0] - 2026-05-15
+
+### Added
+
+- `e` shortcut: filter the list by epic via a modal picker; selecting an epic scopes the view to that epic and its children, with an option to clear the filter
+
 ## [0.2.3] - 2026-05-13
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bdtui",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Terminal UI for the bd beads issue tracker",
   "type": "module",
   "bin": {

package/src/app.js

@@ -3,9 +3,9 @@ import { execFile } from 'child_process';
 import { state, loadList, loadDetail, applyMutation, applyTypeFilter } from './state.js';
 import { createList, renderList } from './views/list.js';
 import { createDetail, renderDetail } from './views/detail.js';
-import { statusPicker, priorityPicker, textPrompt, depMenu, skillPicker } from './views/modals.js';
+import { statusPicker, priorityPicker, textPrompt, depMenu, skillPicker, epicPicker } from './views/modals.js';
 import { showHelp } from './keys.js';
-import { bdUpdate, bdClose, bdClaim, bdReopen, bdDepAdd, bdDepRemove } from './bd.js';
+import { bdUpdate, bdClose, bdClaim, bdReopen, bdDepAdd, bdDepRemove, bdEpics } from './bd.js';
 
 const FILTERS = ['blocked', 'ready', 'in_progress', 'closed', 'all'];
 const TYPE_FILTERS = ['all', 'epic', 'task'];
@@ -63,9 +63,12 @@ export async function run(cwd) {
     });
     const count = state.listOrder.length;
     const typeLabel = state.typeFilter === 'all' ? 'all' : `${state.typeFilter} only`;
-    const typeInfo = `  {gray-fg}│{/}  {yellow-fg}filter:{/} ${typeLabel}`;
+    const typeInfo = `  {gray-fg}│{/}  {yellow-fg}type:{/} ${typeLabel}`;
+    const epicInfo = state.epicFilter
+      ? `  {gray-fg}│{/}  {magenta-fg}epic:{/} ${state.epicFilter}`
+      : '';
     const info  = count > 0 ? `{gray-fg}  │  ${count} beads{/}` : '';
-    tabBar.setContent(tabs.join('{gray-fg}│{/}') + typeInfo + info);
+    tabBar.setContent(tabs.join('{gray-fg}│{/}') + typeInfo + epicInfo + info);
   }
 
   function setFocusBorder(focused) {
@@ -187,6 +190,49 @@ export async function run(cwd) {
   key(['S-tab'], () => cycleFilter(-1));
   key(['t'], cycleTypeFilter);
 
+  key(['e'], async () => {
+    if (screen.focused !== list) return;
+    setStatus('Loading epics…');
+    let epics;
+    try {
+      epics = await bdEpics(state.cwd);
+    } catch (err) {
+      setStatus(err.message, true, true);
+      return;
+    }
+    setStatus(defaultStatus());
+    let picked;
+    try {
+      picked = await epicPicker(screen, epics, state.epicFilter);
+    } catch {
+      list.focus();
+      return;
+    }
+    list.focus();
+    state.epicFilter = picked;
+    if (picked) {
+      state.filter = 'all';
+      setStatus(`Epic: ${picked} — loading…`);
+      try {
+        await loadList();
+      } catch (err) {
+        setStatus(err.message, true, true);
+        return;
+      }
+    } else {
+      applyTypeFilter();
+    }
+    state.selectedId = state.listOrder[0] || null;
+    if (state.selectedId) {
+      try { await loadDetail(state.selectedId); } catch (err) {
+        setStatus(err.message, true, true);
+        return;
+      }
+    }
+    render();
+    setStatus(picked ? `Epic: ${picked}` : 'Epic filter cleared', false, true);
+  });
+
   key(['?'], () => {
     modalOpen = true;
     showHelp(screen, () => {

package/src/bd.js

@@ -67,3 +67,8 @@ export const bdDepRemove = (child, parent, cwd) =>
 
 // Returns all children of an epic (all statuses — bd children includes closed by default)
 export const bdChildren = (id, cwd) => runBd(['children', id, '--json'], cwd);
+
+export const bdEpics = async (cwd) => {
+  const all = await runBd(['list', '--all', '--json'], cwd);
+  return Array.isArray(all) ? all.filter((b) => b.issue_type === 'epic') : [];
+};

package/src/keys.js

@@ -16,6 +16,7 @@ export const HELP_TEXT = [
   '  Tab         Next status filter (blocked/ready/in_progress/closed/all)',
   '  Shift+Tab   Previous status filter',
   '  t           Cycle type filter (all/epic/task)',
+  '  e           Filter by epic (modal picker; switches status to all)',
   '  r           Reload current filter from bd',
   '  /           In-memory title filter',
   '',

package/src/state.js

@@ -8,11 +8,33 @@ export const state = {
   selectedId: null,
   filter: 'ready',
   typeFilter: 'all',   // 'all' | 'epic' | 'task'
+  epicFilter: null,    // null or epic bead id — when set, list is scoped to that epic + its children
   cwd: process.cwd(),
 };
 
+function scopeToEpic(items, epicId) {
+  const out = [];
+  let inside = false;
+  for (const it of items) {
+    if (it.depth === 0) {
+      inside = it.id === epicId;
+      if (inside) out.push(it);
+    } else if (inside) {
+      out.push(it);
+    }
+  }
+  // Fix isLast on the last child after scoping (cheap, optional polish).
+  for (let i = out.length - 1; i >= 0; i--) {
+    if (out[i].depth > 0) { out[i] = { ...out[i], isLast: true }; break; }
+  }
+  return out;
+}
+
 export function applyTypeFilter() {
   let items = state.fullTreeItems;
+  if (state.epicFilter) {
+    items = scopeToEpic(items, state.epicFilter);
+  }
   if (state.typeFilter !== 'all') {
     items = items
       .filter((t) => state.beadsById.get(t.id)?.issue_type === state.typeFilter)

package/src/views/modals.js

@@ -87,6 +87,80 @@ export function textPrompt(screen, label, defaultVal = '') {
   });
 }
 
+const CLEAR_FILTER_TAG = '__clear__';
+
+export function epicPicker(screen, epics, currentEpicId = null) {
+  return new Promise((resolve, reject) => {
+    const sorted = [...epics].sort((a, b) => a.id.localeCompare(b.id));
+    const rows = [];
+    const ids = [];
+
+    if (currentEpicId) {
+      rows.push('{yellow-fg}✗ Clear epic filter{/}');
+      ids.push(CLEAR_FILTER_TAG);
+    }
+
+    for (const e of sorted) {
+      const marker = e.id === currentEpicId ? '{cyan-fg}●{/} ' : '  ';
+      const id = e.id.padEnd(12);
+      const title = (e.title || '').slice(0, 60);
+      rows.push(`${marker}{gray-fg}${id}{/} ${title}`);
+      ids.push(e.id);
+    }
+
+    if (rows.length === 0) {
+      rows.push('{gray-fg}(no epics found){/}');
+      ids.push(null);
+    }
+
+    const width = 72;
+    const height = Math.min(rows.length + 4, Math.max(8, screen.height - 4));
+
+    const picker = blessed.list({
+      parent: screen,
+      label: ' Filter by Epic ',
+      border: { type: 'line' },
+      top: 'center',
+      left: 'center',
+      width,
+      height,
+      items: rows,
+      keys: true,
+      vi: true,
+      tags: true,
+      scrollbar: { ch: ' ', track: { bg: 'black' }, style: { bg: 'magenta' } },
+      style: {
+        selected: { bg: 'blue', fg: 'white', bold: true },
+        border: { fg: 'magenta' },
+        label: { fg: 'magenta', bold: true },
+      },
+    });
+
+    // Select current epic by default if set
+    if (currentEpicId) {
+      const idx = ids.indexOf(currentEpicId);
+      if (idx >= 0) picker.select(idx);
+    }
+
+    picker.focus();
+    screen.render();
+
+    picker.once('select', (_item, index) => {
+      const picked = ids[index];
+      picker.destroy();
+      screen.render();
+      if (picked === null) return reject(new Error('cancelled'));
+      resolve(picked === CLEAR_FILTER_TAG ? null : picked);
+    });
+
+    picker.key(['escape', 'q'], () => {
+      picker.destroy();
+      screen.render();
+      reject(new Error('cancelled'));
+    });
+  });
+}
+
 export function skillPicker(screen, beadId) {
   const items = [
     `/executor-task ${beadId}`,