opencode-beads_rust-stats-sidebar 1.0.0 → 1.1.0

package/README.md

@@ -2,19 +2,20 @@
 
 [Русская версия](https://github.com/melik/opencode-beads_rust-stats-sidebar/blob/main/README.ru.md)
 
-An OpenCode V2 plugin that displays [beads_rust](https://github.com/Dicklesworthstone/beads_rust) statistics and active tasks in the terminal UI sidebar.
+An OpenCode V2 plugin that displays [beads_rust](https://github.com/Dicklesworthstone/beads_rust) statistics and the current task, or the epic it belongs to, in the terminal UI sidebar.
 
 ## What it displays
 
 - The total number of tasks.
 - Counts of open, in-progress, blocked, and closed tasks.
 - A 10-character bar and percentage of the total for each category.
-- The ID and title of tasks with the `in_progress` status.
-- A `2 epics ready to close` line (or `2 эпика готовы к закрытию` for the Russian locale) when epics have all their child tasks closed. This line appears only when the count is positive, after the statistics and before the active tasks.
-- An expandable description when there is exactly one active task.
-- An `ID - title` list when there are multiple active tasks.
+- A `2 epics ready to close` line (or `2 эпика готовы к закрытию` for the Russian locale) when epics have all their child tasks closed. This line appears only when the count is positive, after the statistics.
+- Exactly one current-task block below the statistics. The current task is the most recently updated in-progress task, or, when nothing is in progress, the most recently closed task.
+- If the current task belongs to an open epic, the block shows that epic: a `▼ <epic-id> <percent>% (<done>/<total>)` summary line followed by its child tasks.
+- Otherwise the block shows the current task as a single row: `[✓] Title` for a closed task or `[◐] Title` for an in-progress task.
+- A status glyph before each task: `✓` closed, `◐` in progress, `○` ready, `●` blocked, `❄` deferred. Blocked is inferred for open epic children that are absent from `br ready --json`.
 
-Example with one active task:
+Example:
 
 ```text
 Beads
@@ -23,51 +24,52 @@ Open        ■■■■■■□□□□ 11 (61%)
 In progress ■□□□□□□□□□ 1 (6%)
 Blocked     ■■■■■■□□□□ 10 (56%)
 Closed      ■■■□□□□□□□ 6 (33%)
+2 epics ready to close
 
-opencode-mjf ▾
-Current task title
+▼ rtr-e6 45% (5/11)
+[✓] T56 — End-to-end authentication flow
+[○] T57 — Public access and revocation
+[◐] T58 — Comment moderation
+[●] T59 — Rate limits and concurrency
 ```
 
-Example with multiple active tasks:
+When the current task does not belong to an epic, the block is a single row:
 
 ```text
 Beads
-Total tasks: 4
-Open        ■■■□□□□□□□ 1 (25%)
-In progress ■■■■■□□□□□ 2 (50%)
-Blocked     ■■■□□□□□□□ 1 (25%)
-Closed      ■■■□□□□□□□ 1 (25%)
-
-opencode-bb7 - Temporary task 4
-opencode-mjf - Temporary task 2
-```
+Total tasks: 18
+Open        ■■■■■■□□□□ 11 (61%)
+In progress ■□□□□□□□□□ 1 (6%)
+Blocked     ■■■■■■□□□□ 10 (56%)
+Closed      ■■■□□□□□□□ 6 (33%)
+1 epic ready to close
 
-If there are no active tasks, the task list is not displayed. The line for epics ready to close is displayed independently of whether there are active tasks.
+[◐] T60 — Fix retry loop
+```
 
 ## How it works
 
-The server part of the plugin runs three commands in the current project directory:
+The server part of the plugin runs five read-only commands in the current project directory:
 
 ```sh
 br stats --json --no-activity
+br epic status --json
+br ready --json
 br list --status in_progress --json
-br epic status --eligible-only --json
+br list --status closed --json
 ```
 
-The total count and status statistics come from `stats`. The `in_progress` tasks come from `list`, sorted by `updated_at` from newest to oldest. The number of epics with all child tasks closed comes from `epic status --eligible-only`. All three commands run in parallel when the plugin loads, and again 5 seconds after each request completes.
+The total count and status statistics come from `stats`. The number of epics ready to close is derived from the `eligible_for_close` flags in `epic status --json`, so the epic list and the count share a single source. All five commands run in parallel when the plugin loads, and again 5 seconds after each request completes.
 
-The TUI part passes the current project's location to RPC, so statistics are not mixed with those of other open projects. The block is hidden until the first successful response. During subsequent updates, the last received data remains visible.
+The plugin then picks one current task: the most recently updated task from `br list --status in_progress --json`, or, when that list is empty, the most recently updated task from `br list --status closed --json`. An in-progress task always has priority. `.beads/last-touched` is no longer read.
 
-When there is exactly one active task, left-clicking its ID or title shows or hides its description:
+The plugin resolves the current task's parent with `br show <task-id> --json`, because `br list --json` does not include the `parent` field. If the resolved `parent` matches one of the open epics from `br epic status --json`, the plugin runs `br show <epic-id> --json` and renders that epic with its child tasks. For an epic, `done` counts closed children and `total` counts all parent-child children. Open children present in `br ready --json` are shown as ready, and open children absent from it are shown as blocked.
 
-- `▾`: description collapsed;
-- `▴`: description expanded.
+Otherwise the current task is rendered as a single row. When there is neither an in-progress nor a closed task, no task block is shown.
 
-The expanded state is preserved for the last expanded task while the plugin is loaded.
-
-When there are multiple active tasks, they are displayed as an `ID - title` list without arrows, descriptions, or click handlers.
+The TUI part passes the current project's location to RPC, so statistics are not mixed with those of other open projects. The block is hidden until the first successful response. During subsequent updates, the last received data remains visible.
 
-If Beads is not initialized, `br` is unavailable, or reading `stats` or `list` fails, the plugin hides the entire block. If `br epic status --eligible-only --json` is unavailable or returns an invalid response, the statistics and active tasks remain visible, but the epics line is hidden.
+If Beads is not initialized, `br` is unavailable, or reading `stats` fails, the plugin hides the entire block. If any command or response used for the current task or its epic fails or returns malformed data, the statistics and the epics line remain visible, and only the task block is omitted.
 
 ## Installation and updates
 
@@ -112,27 +114,26 @@ OpenCode reloads configuration and plugin file changes. A full restart is usuall
 
 A Russian system locale enables Russian labels. English is used for all other locales. The selection considers `LC_ALL`, `LC_MESSAGES`, `LANG`, and the `Intl` system locale.
 
-Task titles and descriptions are not translated. The `Beads` heading is bold and uses the theme's primary text color; the remaining lines use the muted text color.
+The `Beads` heading is bold and uses the theme's primary text color. All other lines, including the epic summary and task rows, use the muted text color. Task titles are not translated.
 
 ## Limitations
 
-- The description is available only when there is one active task; the list of multiple tasks does not support it.
-- The current task is selected by its status, not by a specific OpenCode session or assignee.
-- The plugin is read-only: creating, closing, and modifying tasks through the sidebar is not supported.
-- A mouse is required to expand the description of a single task; there is no dedicated keyboard command. Mouse support depends on the terminal.
+- The plugin is read-only: creating, closing, and modifying tasks through the sidebar is not supported, and there are no click handlers, dialogs, or slash commands.
+- The current task follows the most recently updated in-progress task, or the most recently closed task; it is not tied to a specific OpenCode session or assignee.
 - Updates use polling 5 seconds after the previous request completes, rather than a subscription to Beads events.
 - Git activity, average completion time, and additional `br stats` breakdowns are not displayed.
 - Bars and percentages are rounded to whole numbers. With a small number of tasks, one task can fill multiple characters.
 - Blocked tasks can also be counted under other statuses. Therefore, the rows and percentages are not mutually exclusive and can add up to more than 100%.
+- Blocked children in the epic block are inferred: Beads stores them as open, so any open child that is not in `br ready --json` is shown as blocked.
 - When the total task count is zero, the bars are empty and percentages are zero.
 
 ## Structure
 
 - `index.ts`: server RPC registration.
-- `beads.ts`: `br` execution, data validation, and transformation.
+- `beads.ts`: `br` execution, current-task selection, data validation, and transformation.
 - `rpc.ts`: the contract between the server and TUI.
-- `tui.tsx`: the sidebar block, updates, and description expansion.
-- `display.ts`: bars, numbers, and percentages.
+- `tui.tsx`: the sidebar block and updates.
+- `display.ts`: bars, numbers, percentages, and task glyphs.
 - `i18n.ts`: system locale and labels.
 
 ## Verification

package/README.ru.md

@@ -1,18 +1,19 @@
 # opencode-beads_rust-stats-sidebar
 
-Плагин для OpenCode V2, который показывает статистику [beads_rust](https://github.com/Dicklesworthstone/beads_rust) и активные задачи в боковой панели терминального интерфейса.
+Плагин для OpenCode V2, который показывает статистику [beads_rust](https://github.com/Dicklesworthstone/beads_rust) и текущую задачу, либо эпик, к которому она относится, в боковой панели терминального интерфейса.
 
 ## Что отображается
 
 - Общее количество задач.
 - Количество открытых задач, задач в работе, заблокированных и закрытых задач.
 - Полоска из 10 символов и процент от общего количества для каждой категории.
-- ID и название задачи со статусом `in_progress`.
-- Строка `2 epics ready to close` (для русской локали `2 эпика готовы к закрытию`), если есть эпики, у которых все дочерние задачи закрыты. Строка появляется только при положительном количестве таких эпиков и располагается после статистики и перед активными задачами.
-- Описание по запросу, если активная задача только одна.
-- Список `ID - название`, если активных задач несколько.
+- Строка `2 epics ready to close` (для русской локали `2 эпика готовы к закрытию`), если есть эпики, у которых все дочерние задачи закрыты. Строка появляется только при положительном количестве таких эпиков и располагается после статистики.
+- Ровно один блок текущей задачи ниже статистики. Текущая задача — самая свежая задача в работе, а если задач в работе нет — самая свежая закрытая задача.
+- Если текущая задача относится к открытому эпику, блок показывает этот эпик: строку сводки `▼ <id-эпика> <процент>% (<готово>/<всего>)` и его дочерние задачи.
+- Иначе текущая задача показывается одной строкой: `[✓] Название` для закрытой задачи или `[◐] Название` для задачи в работе.
+- Глиф статуса перед каждой задачей: `✓` закрыта, `◐` в работе, `○` готова, `●` заблокирована, `❄` отложена. Блокировка выводится косвенно: открытая дочерняя задача эпика, отсутствующая в `br ready --json`, считается заблокированной.
 
-Пример с одной активной задачей:
+Пример:
 
 ```text
 Beads
@@ -21,51 +22,52 @@ Beads
 В работе    ■□□□□□□□□□  1 (6%)
 Блокировано ■■■■■□□□□□ 10 (56%)
 Закрыто     ■■■□□□□□□□  6 (33%)
+2 эпика готовы к закрытию
 
-opencode-mjf ▾
-Название текущей задачи
+▼ rtr-e6 45% (5/11)
+[✓] T56 — Сквозной сценарий аутентификации
+[○] T57 — Публичный доступ и отзыв
+[◐] T58 — Модерация комментариев
+[●] T59 — Лимиты и конкурентные операции
 ```
 
-Пример с несколькими активными задачами:
+Если текущая задача не относится к эпику, блок состоит из одной строки:
 
 ```text
 Beads
-Всего задач: 4
-Открыто     ■■■□□□□□□□ 1 (25%)
-В работе    ■■■■■□□□□□ 2 (50%)
-Блокировано ■■■□□□□□□□ 1 (25%)
-Закрыто     ■■■□□□□□□□ 1 (25%)
-
-opencode-bb7 - Временная задача 4
-opencode-mjf - Временная задача 2
-```
+Всего задач: 18
+Открыто     ■■■■■■□□□□ 11 (61%)
+В работе    ■□□□□□□□□□  1 (6%)
+Блокировано ■■■■■□□□□□ 10 (56%)
+Закрыто     ■■■□□□□□□□  6 (33%)
+1 эпик готов к закрытию
 
-Если активных задач нет, список задач не отображается. Строка готовых к закрытию эпиков показывается независимо от наличия активных задач.
+[◐] T60 — Исправить цикл повторов
+```
 
 ## Как это работает
 
-Серверная часть плагина выполняет три команды в каталоге текущего проекта:
+Серверная часть плагина выполняет пять команд только для чтения в каталоге текущего проекта:
 
 ```sh
 br stats --json --no-activity
+br epic status --json
+br ready --json
 br list --status in_progress --json
-br epic status --eligible-only --json
+br list --status closed --json
 ```
 
-Из `stats` берутся общее количество и статистика статусов. Из `list` берутся задачи `in_progress`, отсортированные по `updated_at` от более новых к более старым. Из `epic status --eligible-only` берётся количество эпиков, у которых все дочерние задачи закрыты. Все три команды выполняются параллельно при загрузке плагина, затем через 5 секунд после завершения каждого запроса.
+Из `stats` берутся общее количество и статистика статусов. Количество эпиков, готовых к закрытию, вычисляется по флагам `eligible_for_close` из `epic status --json`, поэтому список эпиков и счётчик используют один источник. Все пять команд выполняются параллельно при загрузке плагина, затем через 5 секунд после завершения каждого запроса.
 
-TUI-часть передаёт в RPC location текущего проекта, поэтому статистика не смешивается с другими открытыми проектами. До первого успешного ответа блок скрыт. Во время последующих обновлений отображаются последние полученные данные.
+Затем плагин выбирает одну текущую задачу: самую свежую задачу из `br list --status in_progress --json` или, если этот список пуст, самую свежую задачу из `br list --status closed --json`. Задача в работе всегда имеет приоритет. Файл `.beads/last-touched` больше не читается.
 
-Если активная задача одна, клик левой кнопкой мыши по ID или названию раскрывает и скрывает описание:
+Родителя текущей задачи плагин определяет запросом `br show <id-задачи> --json`, поскольку `br list --json` не возвращает поле `parent`. Если полученный `parent` совпадает с одним из открытых эпиков из `br epic status --json`, плагин выполняет `br show <id-эпика> --json` и показывает этот эпик с дочерними задачами. Для эпика `done` считает закрытых детей, а `total` — всех детей с типом связи parent-child. Открытые дети, присутствующие в `br ready --json`, показываются как готовые, а отсутствующие в нём — как заблокированные.
 
-- `▾`: описание закрыто;
-- `▴`: описание открыто.
+Иначе текущая задача показывается одной строкой. Если нет ни задачи в работе, ни закрытой задачи, блок задач не отображается.
 
-Состояние раскрытия сохраняется для последней раскрытой задачи, пока плагин загружен.
-
-Если активных задач несколько, они выводятся списком `ID - название`. В этом случае стрелки, описания и обработчики клика отсутствуют.
+TUI-часть передаёт в RPC location текущего проекта, поэтому статистика не смешивается с другими открытыми проектами. До первого успешного ответа блок скрыт. Во время последующих обновлений отображаются последние полученные данные.
 
-Если Beads не инициализирован, `br` недоступен или чтение данных `stats`/`list` завершилось ошибкой, плагин скрывает весь блок. Если команда `br epic status --eligible-only --json` недоступна или вернула некорректный ответ, статистика и активные задачи сохраняются, а строка про эпики просто не показывается.
+Если Beads не инициализирован, `br` недоступен или чтение данных `stats` завершилось ошибкой, плагин скрывает весь блок. Если любая команда или ответ для текущей задачи или её эпика завершилась ошибкой или вернула некорректные данные, статистика и строка про эпики сохраняются, а блок задач просто не показывается.
 
 ## Установка и обновление
 
@@ -110,27 +112,26 @@ opencode plugin update opencode-beads_rust-stats-sidebar
 
 Русская системная локаль включает русские подписи. Для всех остальных локалей используется английский. Выбор учитывает `LC_ALL`, `LC_MESSAGES`, `LANG` и системную локаль `Intl`.
 
-Названия и описания задач не переводятся. Заголовок `Beads` выделен жирным основным цветом темы, остальные строки используют приглушённый цвет темы.
+Заголовок `Beads` выделен жирным основным цветом темы. Все остальные строки, включая сводку эпика и строки задач, используют приглушённый цвет темы. Названия задач не переводятся.
 
 ## Ограничения
 
-- Описание доступно только при одной активной задаче; список из нескольких задач его не поддерживает.
-- Поддерживается выбор текущей задачи через её статус; привязки к конкретной сессии OpenCode или исполнителю нет.
-- Плагин только читает данные: создание, закрытие и изменение задач через sidebar не поддерживаются.
-- Для описания одиночной задачи используется мышь; отдельной клавиатурной команды для его раскрытия нет. Поддержка мыши зависит от терминала.
+- Плагин только читает данные: создание, закрытие и изменение задач через sidebar не поддерживаются, обработчиков клика, диалогов и slash-команд нет.
+- Текущая задача следует за самой свежей задачей в работе или самой свежей закрытой задачей; привязки к конкретной сессии OpenCode или исполнителю нет.
 - Обновление выполняется опросом через 5 секунд после завершения предыдущего запроса, а не подпиской на события Beads.
 - Активность из Git, среднее время выполнения и дополнительные разбивки `br stats` не отображаются.
 - Полоски и проценты округляются до целых. При небольшом количестве задач одна задача может заполнить несколько символов.
 - Заблокированные задачи могут учитываться и в других статусах. Поэтому строки и проценты не являются взаимоисключающими и могут суммарно превышать 100%.
+- Блокировка дочерних задач в блоке эпика выводится косвенно: Beads хранит такие задачи как открытые, поэтому открытый ребёнок, отсутствующий в `br ready --json`, показывается как заблокированный.
 - При нулевом общем количестве задач полоски пустые, проценты равны нулю.
 
 ## Структура
 
 - `index.ts`: регистрация серверного RPC.
-- `beads.ts`: запуск `br`, проверка и преобразование данных.
+- `beads.ts`: запуск `br`, выбор текущей задачи, проверка и преобразование данных.
 - `rpc.ts`: схема обмена между сервером и TUI.
-- `tui.tsx`: блок sidebar, обновления и раскрытие описания.
-- `display.ts`: полоски, числа и проценты.
+- `tui.tsx`: блок sidebar и обновления.
+- `display.ts`: полоски, числа, проценты и глифы задач.
 - `i18n.ts`: системная локаль и подписи.
 
 ## Проверка

package/beads.ts

@@ -3,10 +3,22 @@ import { promisify } from "node:util"
 
 const execFileAsync = promisify(execFile)
 
-export type CurrentTask = {
+export type PlanTaskStatus = "closed" | "in_progress" | "ready" | "blocked" | "deferred"
+
+export type PlanTask = {
   id: string
   title: string
-  description: string | null
+  status: PlanTaskStatus
+}
+
+export type SnapshotPlan = {
+  kind: "epic" | "task"
+  epicId?: string
+  epicTitle?: string
+  done?: number
+  total?: number
+  percent?: number
+  tasks: PlanTask[]
 }
 
 export type Snapshot = {
@@ -17,14 +29,26 @@ export type Snapshot = {
   blocked: number
   closed: number
   epicsReady: number
-  tasks: CurrentTask[]
-  current: CurrentTask | null
+  plan?: SnapshotPlan
+}
+
+export type EpicStatus = {
+  id: string
+  title: string
+  status: string
+  eligibleForClose: boolean
+}
+
+export type InProgressTask = {
+  id: string
+  title: string
+  updatedAt: number
 }
 
 export type BrRunner = (directory: string, args: readonly string[], signal?: AbortSignal) => Promise<string>
 
 export function hiddenSnapshot(): Snapshot {
-  return { available: false, total: 0, open: 0, inProgress: 0, blocked: 0, closed: 0, epicsReady: 0, tasks: [], current: null }
+  return { available: false, total: 0, open: 0, inProgress: 0, blocked: 0, closed: 0, epicsReady: 0 }
 }
 
 const runBr: BrRunner = async (directory, args, signal) => {
@@ -53,42 +77,172 @@ function text(value: unknown): string {
   return value
 }
 
-function parseTask(value: unknown) {
-  const issue = record(value)
-  const description = issue.description
-  if (description !== null && description !== undefined && typeof description !== "string") {
-    throw new Error("Invalid br description")
-  }
-  const updatedAt = Date.parse(text(issue.updated_at))
-  if (!Number.isFinite(updatedAt)) throw new Error("Invalid br update time")
-  return {
-    id: text(issue.id),
-    title: text(issue.title),
-    description: description ?? null,
-    updatedAt,
-  }
+function optionalText(value: unknown): string | undefined {
+  if (value === undefined || value === null || value === "") return undefined
+  return text(value)
+}
+
+function parseParent(issueJson: string): string | undefined {
+  const shown = JSON.parse(issueJson)
+  if (!Array.isArray(shown) || shown.length === 0) throw new Error("Invalid br show")
+  return optionalText(record(shown[0]).parent)
+}
+
+export function parseEpicStatus(epicStatusJson: string): EpicStatus[] {
+  const epics = JSON.parse(epicStatusJson)
+  if (!Array.isArray(epics)) throw new Error("Invalid br epic status")
+  return epics.map((value) => {
+    const entry = record(value)
+    const epic = record(entry.epic)
+    return {
+      id: text(epic.id),
+      title: text(epic.title),
+      status: text(epic.status),
+      eligibleForClose: entry.eligible_for_close === true,
+    }
+  })
 }
 
 function parseEpicCount(epicStatusJson: string | undefined): number {
   if (epicStatusJson === undefined) return 0
   try {
-    const epics = JSON.parse(epicStatusJson)
-    if (!Array.isArray(epics)) throw new Error("Invalid br epic status")
-    return epics.length
+    return parseEpicStatus(epicStatusJson).filter((epic) => epic.eligibleForClose).length
   } catch {
     return 0
   }
 }
 
-export function parseSnapshot(statsJson: string, listJson: string, epicStatusJson?: string): Snapshot {
-  const summary = record(record(JSON.parse(statsJson)).summary)
+function parseIssueList(listJson: string): InProgressTask[] {
   const issues = record(JSON.parse(listJson)).issues
   if (!Array.isArray(issues)) throw new Error("Invalid br issue list")
+  return issues.map((value) => {
+    const issue = record(value)
+    const updatedAt = typeof issue.updated_at === "string" ? Date.parse(issue.updated_at) : Number.NaN
+    return {
+      id: text(issue.id),
+      title: text(issue.title),
+      updatedAt: Number.isFinite(updatedAt) ? updatedAt : 0,
+    }
+  })
+}
+
+function parseReadyTasks(readyJson: string): Array<{ id: string; title: string }> {
+  const issues = JSON.parse(readyJson)
+  if (!Array.isArray(issues)) throw new Error("Invalid br ready list")
+  return issues.map((value) => {
+    const issue = record(value)
+    return { id: text(issue.id), title: text(issue.title) }
+  })
+}
+
+function byUpdatedAtDescending(left: InProgressTask, right: InProgressTask): number {
+  return right.updatedAt - left.updatedAt
+}
+
+function parseRecentClosed(closedJson: string | null): InProgressTask | undefined {
+  if (closedJson === null) return undefined
+  try {
+    return parseIssueList(closedJson).sort(byUpdatedAtDescending)[0]
+  } catch {
+    return undefined
+  }
+}
+
+export function classifyTaskStatus(status: string, id: string, readyIds: ReadonlySet<string>): PlanTaskStatus {
+  switch (status) {
+    case "closed":
+      return "closed"
+    case "in_progress":
+      return "in_progress"
+    case "deferred":
+      return "deferred"
+    case "blocked":
+      return "blocked"
+    case "open":
+      return readyIds.has(id) ? "ready" : "blocked"
+    default:
+      return "blocked"
+  }
+}
+
+function parseEpicTasks(epicJson: string, readyIds: ReadonlySet<string>): PlanTask[] {
+  const shown = JSON.parse(epicJson)
+  if (!Array.isArray(shown) || shown.length === 0) throw new Error("Invalid br epic show")
+  const dependents = record(shown[0]).dependents
+  if (!Array.isArray(dependents)) throw new Error("Invalid br epic dependents")
+
+  return dependents.flatMap((value) => {
+    const dependent = record(value)
+    if (dependent.dependency_type !== "parent-child") return []
+    const id = text(dependent.id)
+    return [{
+      id,
+      title: text(dependent.title),
+      status: classifyTaskStatus(text(dependent.status), id, readyIds),
+    }]
+  })
+}
+
+function required(value: string | null): string {
+  if (value === null) throw new Error("Missing br data")
+  return value
+}
 
-  const tasks = issues.map(parseTask)
-    .sort((left, right) => right.updatedAt - left.updatedAt)
-    .map(({ id, title, description }) => ({ id, title, description }))
-  const current = tasks.length === 1 ? tasks[0] : null
+async function readPlan(
+  directory: string,
+  signal: AbortSignal | undefined,
+  run: BrRunner,
+  data: {
+    epicStatusJson: string | null
+    readyJson: string | null
+    inProgressJson: string | null
+    closedJson: string | null
+  },
+): Promise<SnapshotPlan | undefined> {
+  const epics = parseEpicStatus(required(data.epicStatusJson))
+  const ready = parseReadyTasks(required(data.readyJson))
+  const readyIds = new Set(ready.map((task) => task.id))
+  const inProgress = parseIssueList(required(data.inProgressJson))
+  const recentClosed = parseRecentClosed(data.closedJson)
+  const recentInProgress = [...inProgress].sort(byUpdatedAtDescending)[0]
+  const currentTask = recentInProgress ?? recentClosed
+  if (!currentTask) return undefined
+
+  let parentId: string | undefined
+  try {
+    parentId = parseParent(await run(directory, ["show", currentTask.id, "--json"], signal))
+  } catch {
+    parentId = undefined
+  }
+  const focus = parentId ? epics.find((epic) => epic.id === parentId) : undefined
+  if (!focus) {
+    return {
+      kind: "task",
+      tasks: [{
+        id: currentTask.id,
+        title: currentTask.title,
+        status: currentTask === recentClosed ? "closed" : "in_progress",
+      }],
+    }
+  }
+
+  const tasks = parseEpicTasks(await run(directory, ["show", focus.id, "--json"], signal), readyIds)
+  const done = tasks.filter((task) => task.status === "closed").length
+  const total = tasks.length
+
+  return {
+    kind: "epic",
+    epicId: focus.id,
+    epicTitle: focus.title,
+    done,
+    total,
+    percent: total === 0 ? 0 : Math.round(done / total * 100),
+    tasks,
+  }
+}
+
+export function parseSnapshot(statsJson: string, epicStatusJson?: string): Snapshot {
+  const summary = record(record(JSON.parse(statsJson)).summary)
 
   return {
     available: true,
@@ -98,19 +252,30 @@ export function parseSnapshot(statsJson: string, listJson: string, epicStatusJso
     blocked: count(summary.blocked_issues),
     closed: count(summary.closed_issues),
     epicsReady: parseEpicCount(epicStatusJson),
-    tasks,
-    current,
   }
 }
 
-export async function readSnapshot(directory: string, signal?: AbortSignal, run: BrRunner = runBr): Promise<Snapshot> {
+export async function readSnapshot(
+  directory: string,
+  signal?: AbortSignal,
+  run: BrRunner = runBr,
+): Promise<Snapshot> {
   try {
-    const [stats, list, epics] = await Promise.all([
+    const [stats, epics, ready, inProgress, closed] = await Promise.all([
       run(directory, ["stats", "--json", "--no-activity"], signal),
-      run(directory, ["list", "--status", "in_progress", "--json"], signal),
-      run(directory, ["epic", "status", "--eligible-only", "--json"], signal).catch(() => null),
+      run(directory, ["epic", "status", "--json"], signal).catch(() => null),
+      run(directory, ["ready", "--json"], signal).catch(() => null),
+      run(directory, ["list", "--status", "in_progress", "--json"], signal).catch(() => null),
+      run(directory, ["list", "--status", "closed", "--json"], signal).catch(() => null),
     ])
-    return parseSnapshot(stats, list, epics ?? undefined)
+    const snapshot = parseSnapshot(stats, epics ?? undefined)
+    try {
+      const plan = await readPlan(directory, signal, run, { epicStatusJson: epics, readyJson: ready, inProgressJson: inProgress, closedJson: closed })
+      if (plan) snapshot.plan = plan
+    } catch {
+      // Plan data is optional: keep the statistics visible when it cannot be built.
+    }
+    return snapshot
   } catch {
     return hiddenSnapshot()
   }

package/display.ts

@@ -1,3 +1,26 @@
+import type { PlanTaskStatus } from "./beads.js"
+
+const statusGlyphs: Record<PlanTaskStatus, string> = {
+  closed: "✓",
+  in_progress: "◐",
+  ready: "○",
+  blocked: "●",
+  deferred: "❄",
+}
+
+export function statusGlyph(status: PlanTaskStatus): string {
+  return statusGlyphs[status]
+}
+
+export function epicSummaryLine(epicId: string, done: number, total: number): string {
+  const percent = total === 0 ? 0 : Math.round(done / total * 100)
+  return `▼ ${epicId} ${percent}% (${done}/${total})`
+}
+
+export function taskLine(status: PlanTaskStatus, title: string): string {
+  return `[${statusGlyph(status)}] ${title}`
+}
+
 export function progressBar(value: number, total: number): string {
   if (total === 0) return "□".repeat(10)
   const filled = Math.max(0, Math.min(10, Math.round(value / total * 10)))

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-beads_rust-stats-sidebar",
-  "version": "1.0.0",
-  "description": "OpenCode V2 plugin that displays beads_rust (br) issue statistics, ready-to-close epics, and active in_progress tasks in the TUI sidebar.",
+  "version": "1.1.0",
+  "description": "OpenCode V2 plugin that displays beads_rust (br) issue statistics, a focused epic with its tasks, and ready-to-close epics in the TUI sidebar.",
   "keywords": [
     "opencode",
     "opencode-plugin",
@@ -35,10 +35,11 @@
     "beads.ts",
     "display.ts",
     "i18n.ts",
+    "tsconfig.json",
     "README.md"
   ],
   "scripts": {
-    "test": "node --test beads.test.ts display.test.ts i18n.test.ts",
+    "test": "node --test beads.test.ts display.test.ts i18n.test.ts package.test.ts",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm test && npm run typecheck"
   },

package/rpc.ts

@@ -18,23 +18,35 @@ export const BeadsCurrent = Rpc.define({
           blocked: { type: "integer", minimum: 0 },
           closed: { type: "integer", minimum: 0 },
           epicsReady: { type: "integer", minimum: 0 },
-          tasks: { type: "array", items: { $ref: "#/$defs/task" } },
-          current: { anyOf: [{ type: "null" }, { $ref: "#/$defs/task" }] },
-        },
-        required: ["available", "total", "open", "inProgress", "blocked", "closed", "epicsReady", "tasks", "current"],
-        additionalProperties: false,
-        $defs: {
-          task: {
+          plan: {
             type: "object",
             properties: {
-              id: { type: "string" },
-              title: { type: "string" },
-              description: { anyOf: [{ type: "string" }, { type: "null" }] },
+              kind: { type: "string", enum: ["epic", "task"] },
+              epicId: { type: "string" },
+              epicTitle: { type: "string" },
+              done: { type: "integer", minimum: 0 },
+              total: { type: "integer", minimum: 0 },
+              percent: { type: "integer", minimum: 0, maximum: 100 },
+              tasks: {
+                type: "array",
+                items: {
+                  type: "object",
+                  properties: {
+                    id: { type: "string" },
+                    title: { type: "string" },
+                    status: { type: "string", enum: ["closed", "in_progress", "ready", "blocked", "deferred"] },
+                  },
+                  required: ["id", "title", "status"],
+                  additionalProperties: false,
+                },
+              },
             },
-            required: ["id", "title", "description"],
+            required: ["kind", "tasks"],
             additionalProperties: false,
           },
         },
+        required: ["available", "total", "open", "inProgress", "blocked", "closed", "epicsReady"],
+        additionalProperties: false,
       },
       errors: {},
     },

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "preserve",
+    "jsxImportSource": "@opentui/solid",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["index.ts", "rpc.ts", "tui.tsx", "beads.ts", "display.ts", "i18n.ts"]
+}

package/tui.tsx

@@ -1,12 +1,11 @@
+/** @jsxImportSource @opentui/solid */
 import { Plugin } from "@opencode/plugin/tui"
 import { createSignal, For, Show } from "solid-js"
 import { hiddenSnapshot, type Snapshot } from "./beads.js"
-import { statisticLine } from "./display.js"
+import { epicSummaryLine, statisticLine, taskLine } from "./display.js"
 import { createI18n } from "./i18n.js"
 import { BeadsCurrent } from "./rpc.js"
 
-const hasDescription = (description: string | null | undefined) => Boolean(description?.trim())
-
 export default Plugin.define({
   id: "beads_rust-sidebar-tui",
   setup(ctx) {
@@ -14,7 +13,6 @@ export default Plugin.define({
     const labelWidth = Math.max(...i18n.statuses.map((label) => label.length))
     const location = ctx.location ?? ctx.data.location.default()
     const [snapshot, setSnapshot] = createSignal<Snapshot>(hiddenSnapshot())
-    const [expandedTaskID, setExpandedTaskID] = createSignal<string | null>(null)
     let disposed = false
     let sequence = 0
 
@@ -28,10 +26,6 @@ export default Plugin.define({
       }
     }
 
-    function toggleDescription(id: string) {
-      setExpandedTaskID(expandedTaskID() === id ? null : id)
-    }
-
     const remove = ctx.ui.slot({
       append: "sidebar.content",
       render: () => (
@@ -47,45 +41,21 @@ export default Plugin.define({
             <Show when={snapshot().epicsReady > 0}>
               <text fg={ctx.theme.text.muted}>{i18n.epicsReady(snapshot().epicsReady)}</text>
             </Show>
-            <Show when={snapshot().tasks.length > 0}>
-              <box flexDirection="column" paddingTop={1}>
-                <Show when={snapshot().current}>
-                  {(task) => (
-                    <>
-                  <text
-                    fg={ctx.theme.text.muted}
-                    selectable={false}
-                    onMouseDown={(event) => {
-                      if (event.button !== 0 || !hasDescription(task().description)) return
-                      event.stopPropagation()
-                      toggleDescription(task().id)
-                    }}
-                  >
-                    {hasDescription(task().description) ? `${task().id} ${expandedTaskID() === task().id ? "▴" : "▾"}` : task().id}
-                  </text>
-                  <text
-                    fg={ctx.theme.text.muted}
-                    selectable={false}
-                    onMouseDown={(event) => {
-                      if (event.button !== 0 || !hasDescription(task().description)) return
-                      event.stopPropagation()
-                      toggleDescription(task().id)
-                    }}
-                  >
-                    {task().title}
-                  </text>
-                      <Show when={expandedTaskID() === task().id && hasDescription(task().description) ? task().description : null}>
-                        {(description) => <text fg={ctx.theme.text.muted}>{description()}</text>}
-                      </Show>
-                    </>
-                  )}
-                </Show>
-                <Show when={snapshot().current === null}>
-                  <For each={snapshot().tasks}>
-                    {(task) => <text fg={ctx.theme.text.muted}>{task.id} - {task.title}</text>}
+            <Show when={snapshot().plan}>
+              {(plan) => (
+                <box flexDirection="column" paddingTop={1}>
+                  <Show when={plan().kind === "epic"}>
+                    <text fg={ctx.theme.text.muted}>{epicSummaryLine(plan().epicId ?? "", plan().done ?? 0, plan().total ?? 0)}</text>
+                  </Show>
+                  <For each={plan().tasks}>
+                    {(task) => (
+                      <text fg={ctx.theme.text.muted}>
+                        {taskLine(task.status, task.title)}
+                      </text>
+                    )}
                   </For>
-                </Show>
-              </box>
+                </box>
+              )}
             </Show>
           </box>
         </Show>