opencode-beads_rust-stats-sidebar 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 melik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,144 @@
-# Temporary Holding Version
+# opencode-beads_rust-stats-sidebar
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[Русская версия](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.
+
+## 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.
+
+Example with one active task:
+
+```text
+Beads
+Total tasks: 18
+Open        ■■■■■■□□□□ 11 (61%)
+In progress ■□□□□□□□□□ 1 (6%)
+Blocked     ■■■■■■□□□□ 10 (56%)
+Closed      ■■■□□□□□□□ 6 (33%)
+
+opencode-mjf ▾
+Current task title
+```
+
+Example with multiple active tasks:
+
+```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
+```
+
+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.
+
+## How it works
+
+The server part of the plugin runs three commands in the current project directory:
+
+```sh
+br stats --json --no-activity
+br list --status in_progress --json
+br epic status --eligible-only --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 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.
+
+When there is exactly one active task, left-clicking its ID or title shows or hides its description:
+
+- `▾`: description collapsed;
+- `▴`: description expanded.
+
+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.
+
+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.
+
+## Installation and updates
+
+Requirements:
+
+- OpenCode V2 with support for `sidebar.content`;
+- the `br` command available in the OpenCode server process's `PATH`;
+- an initialized `.beads` directory in the project.
+
+Install the plugin globally using the OpenCode V2 CLI, either from npm or directly from GitHub:
+
+```sh
+opencode plugin add opencode-beads_rust-stats-sidebar
+```
+
+```sh
+opencode plugin add github:melik/opencode-beads_rust-stats-sidebar
+```
+
+Alternatively, configure it declaratively in `opencode.jsonc`: globally in `~/.config/opencode/opencode.jsonc`, or in the project in `opencode.jsonc` or `.opencode/opencode.jsonc`:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": ["opencode-beads_rust-stats-sidebar"]
+}
+```
+
+The plugin has server, TUI, and RPC parts, so one entry in `opencode.jsonc` automatically loads all of them. A separate `cli.json` configuration is not needed. Its sidebar heading is always the short `Beads` label.
+
+For a local installation, place the plugin directory in `~/.config/opencode/plugins/opencode-beads_rust-stats-sidebar` or `.opencode/plugins/opencode-beads_rust-stats-sidebar` for automatic loading, or specify the local directory path in the `plugins` array.
+
+Update the installed plugin:
+
+```sh
+opencode plugin update opencode-beads_rust-stats-sidebar
+```
+
+OpenCode reloads configuration and plugin file changes. A full restart is usually not required.
+
+## Localization and appearance
+
+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.
+
+## 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.
+- 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%.
+- 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.
+- `rpc.ts`: the contract between the server and TUI.
+- `tui.tsx`: the sidebar block, updates, and description expansion.
+- `display.ts`: bars, numbers, and percentages.
+- `i18n.ts`: system locale and labels.
+
+## Verification
+
+```sh
+npm ci
+npm test
+npm run typecheck
+```

package/README.ru.md

@@ -0,0 +1,142 @@
+# opencode-beads_rust-stats-sidebar
+
+Плагин для OpenCode V2, который показывает статистику [beads_rust](https://github.com/Dicklesworthstone/beads_rust) и активные задачи в боковой панели терминального интерфейса.
+
+## Что отображается
+
+- Общее количество задач.
+- Количество открытых задач, задач в работе, заблокированных и закрытых задач.
+- Полоска из 10 символов и процент от общего количества для каждой категории.
+- ID и название задачи со статусом `in_progress`.
+- Строка `2 epics ready to close` (для русской локали `2 эпика готовы к закрытию`), если есть эпики, у которых все дочерние задачи закрыты. Строка появляется только при положительном количестве таких эпиков и располагается после статистики и перед активными задачами.
+- Описание по запросу, если активная задача только одна.
+- Список `ID - название`, если активных задач несколько.
+
+Пример с одной активной задачей:
+
+```text
+Beads
+Всего задач: 18
+Открыто     ■■■■■■□□□□ 11 (61%)
+В работе    ■□□□□□□□□□  1 (6%)
+Блокировано ■■■■■□□□□□ 10 (56%)
+Закрыто     ■■■□□□□□□□  6 (33%)
+
+opencode-mjf ▾
+Название текущей задачи
+```
+
+Пример с несколькими активными задачами:
+
+```text
+Beads
+Всего задач: 4
+Открыто     ■■■□□□□□□□ 1 (25%)
+В работе    ■■■■■□□□□□ 2 (50%)
+Блокировано ■■■□□□□□□□ 1 (25%)
+Закрыто     ■■■□□□□□□□ 1 (25%)
+
+opencode-bb7 - Временная задача 4
+opencode-mjf - Временная задача 2
+```
+
+Если активных задач нет, список задач не отображается. Строка готовых к закрытию эпиков показывается независимо от наличия активных задач.
+
+## Как это работает
+
+Серверная часть плагина выполняет три команды в каталоге текущего проекта:
+
+```sh
+br stats --json --no-activity
+br list --status in_progress --json
+br epic status --eligible-only --json
+```
+
+Из `stats` берутся общее количество и статистика статусов. Из `list` берутся задачи `in_progress`, отсортированные по `updated_at` от более новых к более старым. Из `epic status --eligible-only` берётся количество эпиков, у которых все дочерние задачи закрыты. Все три команды выполняются параллельно при загрузке плагина, затем через 5 секунд после завершения каждого запроса.
+
+TUI-часть передаёт в RPC location текущего проекта, поэтому статистика не смешивается с другими открытыми проектами. До первого успешного ответа блок скрыт. Во время последующих обновлений отображаются последние полученные данные.
+
+Если активная задача одна, клик левой кнопкой мыши по ID или названию раскрывает и скрывает описание:
+
+- `▾`: описание закрыто;
+- `▴`: описание открыто.
+
+Состояние раскрытия сохраняется для последней раскрытой задачи, пока плагин загружен.
+
+Если активных задач несколько, они выводятся списком `ID - название`. В этом случае стрелки, описания и обработчики клика отсутствуют.
+
+Если Beads не инициализирован, `br` недоступен или чтение данных `stats`/`list` завершилось ошибкой, плагин скрывает весь блок. Если команда `br epic status --eligible-only --json` недоступна или вернула некорректный ответ, статистика и активные задачи сохраняются, а строка про эпики просто не показывается.
+
+## Установка и обновление
+
+Для работы нужны:
+
+- OpenCode V2 с поддержкой `sidebar.content`;
+- команда `br`, доступная в `PATH` серверного процесса OpenCode;
+- инициализированный каталог `.beads` в проекте.
+
+Установить плагин глобально через CLI OpenCode V2 можно из npm или напрямую из GitHub:
+
+```sh
+opencode plugin add opencode-beads_rust-stats-sidebar
+```
+
+```sh
+opencode plugin add github:melik/opencode-beads_rust-stats-sidebar
+```
+
+Либо подключить его декларативно в `opencode.jsonc` (глобально в `~/.config/opencode/opencode.jsonc`, либо в проекте в `opencode.jsonc` или `.opencode/opencode.jsonc`):
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": ["opencode-beads_rust-stats-sidebar"]
+}
+```
+
+Плагин состоит из серверной, TUI и RPC частей, поэтому одной записи в `opencode.jsonc` достаточно для автоматической загрузки всех частей (отдельная настройка `cli.json` не нужна). В sidebar он всегда сохраняет короткий заголовок `Beads`.
+
+Для локальной установки поместите каталог плагина в `~/.config/opencode/plugins/opencode-beads_rust-stats-sidebar` или `.opencode/plugins/opencode-beads_rust-stats-sidebar` (он загрузится автоматически), либо укажите локальный путь к каталогу в массиве `plugins`.
+
+Обновление установленного плагина:
+
+```sh
+opencode plugin update opencode-beads_rust-stats-sidebar
+```
+
+Изменения конфигурации и файлов плагина подхватываются OpenCode через механизм перезагрузки. Полного перезапуска обычно не требуется.
+
+## Локализация и оформление
+
+Русская системная локаль включает русские подписи. Для всех остальных локалей используется английский. Выбор учитывает `LC_ALL`, `LC_MESSAGES`, `LANG` и системную локаль `Intl`.
+
+Названия и описания задач не переводятся. Заголовок `Beads` выделен жирным основным цветом темы, остальные строки используют приглушённый цвет темы.
+
+## Ограничения
+
+- Описание доступно только при одной активной задаче; список из нескольких задач его не поддерживает.
+- Поддерживается выбор текущей задачи через её статус; привязки к конкретной сессии OpenCode или исполнителю нет.
+- Плагин только читает данные: создание, закрытие и изменение задач через sidebar не поддерживаются.
+- Для описания одиночной задачи используется мышь; отдельной клавиатурной команды для его раскрытия нет. Поддержка мыши зависит от терминала.
+- Обновление выполняется опросом через 5 секунд после завершения предыдущего запроса, а не подпиской на события Beads.
+- Активность из Git, среднее время выполнения и дополнительные разбивки `br stats` не отображаются.
+- Полоски и проценты округляются до целых. При небольшом количестве задач одна задача может заполнить несколько символов.
+- Заблокированные задачи могут учитываться и в других статусах. Поэтому строки и проценты не являются взаимоисключающими и могут суммарно превышать 100%.
+- При нулевом общем количестве задач полоски пустые, проценты равны нулю.
+
+## Структура
+
+- `index.ts`: регистрация серверного RPC.
+- `beads.ts`: запуск `br`, проверка и преобразование данных.
+- `rpc.ts`: схема обмена между сервером и TUI.
+- `tui.tsx`: блок sidebar, обновления и раскрытие описания.
+- `display.ts`: полоски, числа и проценты.
+- `i18n.ts`: системная локаль и подписи.
+
+## Проверка
+
+```sh
+npm ci
+npm test
+npm run typecheck
+```

package/beads.ts

@@ -0,0 +1,117 @@
+import { execFile } from "node:child_process"
+import { promisify } from "node:util"
+
+const execFileAsync = promisify(execFile)
+
+export type CurrentTask = {
+  id: string
+  title: string
+  description: string | null
+}
+
+export type Snapshot = {
+  available: boolean
+  total: number
+  open: number
+  inProgress: number
+  blocked: number
+  closed: number
+  epicsReady: number
+  tasks: CurrentTask[]
+  current: CurrentTask | null
+}
+
+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 }
+}
+
+const runBr: BrRunner = async (directory, args, signal) => {
+  const result = await execFileAsync("br", [...args], {
+    cwd: directory,
+    encoding: "utf8",
+    signal,
+    timeout: 5000,
+    maxBuffer: 4 * 1024 * 1024,
+  })
+  return result.stdout
+}
+
+function record(value: unknown): Record<string, unknown> {
+  if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Invalid br response")
+  return value as Record<string, unknown>
+}
+
+function count(value: unknown): number {
+  if (typeof value !== "number" || !Number.isInteger(value) || value < 0) throw new Error("Invalid br count")
+  return value
+}
+
+function text(value: unknown): string {
+  if (typeof value !== "string") throw new Error("Invalid br text")
+  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 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
+  } catch {
+    return 0
+  }
+}
+
+export function parseSnapshot(statsJson: string, listJson: string, epicStatusJson?: string): Snapshot {
+  const summary = record(record(JSON.parse(statsJson)).summary)
+  const issues = record(JSON.parse(listJson)).issues
+  if (!Array.isArray(issues)) throw new Error("Invalid br issue list")
+
+  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
+
+  return {
+    available: true,
+    total: count(summary.total_issues),
+    open: count(summary.open_issues),
+    inProgress: count(summary.in_progress_issues),
+    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> {
+  try {
+    const [stats, list, epics] = 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),
+    ])
+    return parseSnapshot(stats, list, epics ?? undefined)
+  } catch {
+    return hiddenSnapshot()
+  }
+}

package/display.ts

@@ -0,0 +1,10 @@
+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)))
+  return "■".repeat(filled) + "□".repeat(10 - filled)
+}
+
+export function statisticLine(label: string, value: number, total: number, labelWidth: number): string {
+  const percent = total === 0 ? 0 : Math.round(value / total * 100)
+  return `${label.padEnd(labelWidth)} ${progressBar(value, total)} ${value} (${percent}%)`
+}

package/i18n.ts

@@ -0,0 +1,38 @@
+type Language = "ru" | "en"
+
+const ruEpicsReady = (count: number) => {
+  const mod100 = count % 100
+  const mod10 = count % 10
+  const form = mod10 === 1 && mod100 !== 11
+    ? "эпик"
+    : mod10 >= 2 && mod10 <= 4 && (mod100 < 12 || mod100 > 14)
+      ? "эпика"
+      : "эпиков"
+  return `${count} ${form} ${form === "эпик" ? "готов" : "готовы"} к закрытию`
+}
+
+const translations = {
+  ru: {
+    total: (count: number) => `Всего задач: ${count}`,
+    statuses: ["Открыто", "В работе", "Блокировано", "Закрыто"],
+    epicsReady: ruEpicsReady,
+  },
+  en: {
+    total: (count: number) => `Total tasks: ${count}`,
+    statuses: ["Open", "In progress", "Blocked", "Closed"],
+    epicsReady: (count: number) => `${count} ${count === 1 ? "epic" : "epics"} ready to close`,
+  },
+}
+
+export function resolveLanguage(locale: string): Language {
+  return /^ru(?:[-_.@]|$)/i.test(locale) ? "ru" : "en"
+}
+
+export function systemLocale(env: { LC_ALL?: string; LC_MESSAGES?: string; LANG?: string } = process.env) {
+  return env.LC_ALL || env.LC_MESSAGES || env.LANG || Intl.DateTimeFormat().resolvedOptions().locale
+}
+
+export function createI18n(locale = systemLocale()) {
+  const language = resolveLanguage(locale)
+  return { language, ...translations[language] }
+}

package/index.ts

@@ -0,0 +1,13 @@
+import { Plugin } from "@opencode/plugin"
+import { readSnapshot } from "./beads.js"
+import { BeadsCurrent } from "./rpc.js"
+
+export default Plugin.define({
+  id: "beads_rust-sidebar",
+  async setup(ctx) {
+    const registration = await ctx.rpc.register(BeadsCurrent, {
+      get: async (_input, context) => readSnapshot(ctx.location.directory, context.signal),
+    })
+    return () => registration.dispose()
+  },
+})

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "opencode-beads_rust-stats-sidebar",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "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.",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "beads",
+    "beads-rust",
+    "tui",
+    "solidjs",
+    "typescript"
+  ],
+  "homepage": "https://github.com/melik/opencode-beads_rust-stats-sidebar#readme",
+  "bugs": {
+    "url": "https://github.com/melik/opencode-beads_rust-stats-sidebar/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/melik/opencode-beads_rust-stats-sidebar.git"
+  },
+  "license": "MIT",
+  "author": "Alexey M (https://github.com/melik)",
+  "type": "module",
+  "exports": {
+    ".": "./index.ts",
+    "./tui": "./tui.tsx",
+    "./rpc": "./rpc.ts"
+  },
+  "main": "index.js",
+  "files": [
+    "index.ts",
+    "tui.tsx",
+    "rpc.ts",
+    "beads.ts",
+    "display.ts",
+    "i18n.ts",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test beads.test.ts display.test.ts i18n.test.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm test && npm run typecheck"
+  },
+  "dependencies": {
+    "@opencode/plugin": "latest"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "peerDependencies": {
+    "@opentui/core": ">=0.6.6",
+    "@opentui/solid": ">=0.6.6",
+    "solid-js": ">=1.9.0"
+  },
+  "engines": {
+    "node": ">=22.6.0"
+  }
+}

package/rpc.ts

@@ -0,0 +1,43 @@
+import { Rpc } from "@opencode/plugin/rpc"
+
+export const BeadsCurrent = Rpc.define({
+  id: "beads_rust-sidebar",
+  methods: {
+    get: {
+      input: {
+        type: "object",
+        additionalProperties: false,
+      },
+      output: {
+        type: "object",
+        properties: {
+          available: { type: "boolean" },
+          total: { type: "integer", minimum: 0 },
+          open: { type: "integer", minimum: 0 },
+          inProgress: { type: "integer", minimum: 0 },
+          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: {
+            type: "object",
+            properties: {
+              id: { type: "string" },
+              title: { type: "string" },
+              description: { anyOf: [{ type: "string" }, { type: "null" }] },
+            },
+            required: ["id", "title", "description"],
+            additionalProperties: false,
+          },
+        },
+      },
+      errors: {},
+    },
+  },
+  events: {},
+})

package/tui.tsx

@@ -0,0 +1,108 @@
+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 { 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) {
+    const i18n = createI18n()
+    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
+
+    async function refresh() {
+      const request = ++sequence
+      try {
+        const next = await ctx.client.rpc(BeadsCurrent).get({}, { location }) as Snapshot
+        if (!disposed && request === sequence) setSnapshot(next)
+      } catch {
+        if (!disposed && request === sequence) setSnapshot(hiddenSnapshot())
+      }
+    }
+
+    function toggleDescription(id: string) {
+      setExpandedTaskID(expandedTaskID() === id ? null : id)
+    }
+
+    const remove = ctx.ui.slot({
+      append: "sidebar.content",
+      render: () => (
+        <Show when={snapshot().available}>
+          <box flexDirection="column" paddingTop={1}>
+            <text fg={ctx.theme.text.base}><b>Beads</b></text>
+            <text fg={ctx.theme.text.muted}>{i18n.total(snapshot().total)}</text>
+            {i18n.statuses.map((label, index) => (
+              <text fg={ctx.theme.text.muted}>
+                {statisticLine(label, [snapshot().open, snapshot().inProgress, snapshot().blocked, snapshot().closed][index], snapshot().total, labelWidth)}
+              </text>
+            ))}
+            <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>}
+                  </For>
+                </Show>
+              </box>
+            </Show>
+          </box>
+        </Show>
+      ),
+    })
+
+    let timer: ReturnType<typeof setTimeout> | undefined
+    async function poll() {
+      await refresh()
+      if (!disposed) timer = setTimeout(() => void poll(), 5000)
+    }
+    void poll()
+    return () => {
+      disposed = true
+      sequence++
+      if (timer) clearTimeout(timer)
+      remove()
+    }
+  },
+})