beads-ui 0.1.2 → 0.2.0

package/CHANGES.md

@@ -1,12 +1,34 @@
 # Changes
 
+## 0.2.0
+
+- 🍏 Add "Blocked" column to board
+- 🍏 Support `design` in issue details
+- 🍏 Add filter to closed column and improve sorting
+- 🍏 Unblock issue description editing
+- 🍏 CLI: require --open to launch browser, also on restart
+- 🍏 Up/down/left/right keyboard navigation on board
+- 🍏 Up/down keyboard navigation on issues list
+- 🍏 CLI: require --open to launch browser
+- 🍏 Make issue notes editable
+- 🍏 Show toast on disconnect/reconnect
+- 🍏 Support creating a new issue via "New" dialog
+- 🍏 Copy issue IDs to clipboard
+- 🍏 Open issue details in dialog
+- 🐛 Remove --limit 10 when fetching closed issues
+- ✨ Events: coalesce issues-changed to avoid redundant full refresh
+- ✨ Update issues
+- ✨ Align callback function naming
+- 📚 Improve README
+- 📚 Add package description, homepage and repo
+
 ## 0.1.2
 
-- 📦 Specify files to package (Maximilian Antoni)
+- 📦 Specify files to package
 
 ## 0.1.1
 
-- 📚 Make screenshot src absolute and add license (Maximilian Antoni)
+- 📚 Make screenshot src absolute and add license
 
 ## 0.1.0
 

package/README.md

@@ -1,64 +1,63 @@
-# beads-ui
+<h1 align="center">
+  Beads UI
+</h1>
+<p align="center">
+  <b>Local‑first UI for the <code>bd</code> CLI – <a href="https://github.com/steveyegge/beads">Beads</a></b>
+</p>
+<div align="center">
+  <a href="https://www.npmjs.com/package/beads-ui"><img src="https://img.shields.io/npm/v/beads-ui.svg" alt="npm Version"></a>
+  <a href="https://semver.org"><img src="https://img.shields.io/:semver-%E2%9C%93-blue.svg" alt="SemVer"></a>
+  <a href="https://github.com/mantoni/beads-ui/actions/worflows/ci.yml"><img src="https://github.com/mantoni/eslint_d.js/actions/workflows/ci.yml/badge.svg" alt="Build Status"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/npm/l/eslint_d.svg" alt="MIT License"></a>
+  <br>
+  <br>
+</div>
 
-Local‑first UI for the `bd` CLI (beads) — a fast, dependency‑aware issue
-tracker.
+## Features
 
-beads-ui complements the upstream beads project by providing a single‑page web
-app served from a local Node.js server. It talks to `bd` over a local WebSocket
-to list issues, show details, and apply edits. All changes happen by executing
-`bd` commands, and live updates flow in as the database changes on disk.
+- ✨ **Zero setup** – just run `bdui start`
+- 🎨 **Beautiful design** – Responsive and dark mode support
+- ⌨️ **Keyboard navigation** – Navigate and edit without touching the mouse
+- ⚡ **Live updates** – Monitors the beads database for changes
+- 🔎 **Issues view** – Filter and search issues, edit inline
+- ⛰️ **Epics view** – Show progress per epic, expand rows, edit inline
+- 🏂 **Board view** – Open / Blocked / Ready / In progress / Closed columns
 
-Upstream beads (CLI and docs): https://github.com/steveyegge/beads
+## Setup
 
-## Features
+```sh
+npm i -g beads-ui
+bdui start --open
+```
 
-- Issues list with inline edits, quick filters, and keyboard navigation
-- Epics view grouped by epic (from `bd epic status --json`) with expandable rows
-- Board view with Ready / In progress / Closed columns
-- Deep links for navigation; state persists across reloads
-- Live updates via FS watch + WebSocket; optimistic UI with rollbacks on error
-- Dark theme toggle, saved per user
-- Local CLI helper `bdui` to daemonize the server and open your browser
+See `bdui --help` for options.
 
 ## Screenshots
 
-Issues
+**Issues**
 
 ![Issues view](https://github.com/mantoni/beads-ui/raw/main/media/bdui-issues.png)
 
-Epics
+**Epics**
 
 ![Epics view](https://github.com/mantoni/beads-ui/raw/main/media/bdui-epics.png)
 
-Board
+**Board**
 
 ![Board view](https://github.com/mantoni/beads-ui/raw/main/media/bdui-board.png)
 
-## Quickstart
-
-Prerequisites:
-
-- Node.js >= 22
-- `bd` CLI on your PATH (or set `BD_BIN=/path/to/bd`)
-
-Install and start:
-
-```sh
-npm install -g beads-ui
-bdui start
-```
-
-See `bdui --help` for options.
-
-Environment variables:
+## Environment variables
 
+- `BD_BIN`: path to the `bd` binary.
 - `BDUI_RUNTIME_DIR`: override runtime directory for PID/logs. Defaults to
   `$XDG_RUNTIME_DIR/beads-ui` or the system temp dir.
-- `BDUI_NO_OPEN=1`: disable opening the default browser on `start`.
+- `BDUI_NO_OPEN=1`: disable opening the default browser on `start`. Note:
+  Opening the browser is disabled by default; use `--open` to explicitly launch
+  the browser, which overrides this env var.
 - `PORT`: overrides the listen port (default `3000`). The server binds to
   `127.0.0.1`.
 
-Platform notes:
+## Platform notes
 
 - macOS/Linux are fully supported. On Windows, the CLI uses `cmd /c start` to
   open URLs and relies on Node’s `process.kill` semantics for stopping the
@@ -66,13 +65,8 @@ Platform notes:
 
 ## Developer Workflow
 
-- Type check: `npm run typecheck`
-- Tests: `npm test`
-- Lint: `npm run lint`
-- Format: `npm run format`
-
-See `docs/quickstart.md` for details and `docs/architecture.md` for the protocol
-and component overview.
+- 📦 Make sure you have `beads-mcp` installed.
+- 🤖 Ask your agent of choice. It will know.
 
 ## License
 

package/app/data/providers.js

@@ -1,18 +1,22 @@
+/**
+ * @import { MessageType } from '../protocol.js'
+ */
 /**
  * Data layer: typed wrappers around the ws transport for bd-backed queries.
- * @param {(type: import('../protocol.js').MessageType, payload?: unknown) => Promise<unknown>} transport - Request/response function.
- * @param {(type: import('../protocol.js').MessageType, handler: (payload: unknown) => void) => void} [on_event] - Optional event subscription (used to invalidate caches on push updates).
- * @returns {{ getEpicStatus: () => Promise<unknown[]>, getReady: () => Promise<unknown[]>, getOpen: () => Promise<unknown[]>, getInProgress: () => Promise<unknown[]>, getClosed: (limit?: number) => Promise<unknown[]>, getIssue: (id: string) => Promise<unknown>, updateIssue: (input: { id: string, title?: string, acceptance?: string, status?: 'open'|'in_progress'|'closed', priority?: number, assignee?: string }) => Promise<unknown> }}
+ * @param {(type: MessageType, payload?: unknown) => Promise<unknown>} transport - Request/response function.
+ * @param {(type: MessageType, handler: (payload: unknown) => void) => void} [onEvent] - Optional event subscription (used to invalidate caches on push updates).
+ * @returns {{ getEpicStatus: () => Promise<unknown[]>, getReady: () => Promise<unknown[]>, getBlocked: () => Promise<unknown[]>, getOpen: () => Promise<unknown[]>, getInProgress: () => Promise<unknown[]>, getClosed: (limit?: number) => Promise<unknown[]>, getIssue: (id: string) => Promise<unknown>, updateIssue: (input: { id: string, title?: string, acceptance?: string, notes?: string, design?: string, status?: 'open'|'in_progress'|'closed', priority?: number, assignee?: string }) => Promise<unknown> }}
  */
-export function createDataLayer(transport, on_event) {
-  /** @type {{ list_ready?: unknown, list_open?: unknown, list_in_progress?: unknown, list_closed_10?: unknown, epic_status?: unknown }} */
+export function createDataLayer(transport, onEvent) {
+  /** @type {{ list_ready?: unknown, list_blocked?: unknown, list_open?: unknown, list_in_progress?: unknown, list_closed_10?: unknown, epic_status?: unknown }} */
   const cache = {};
 
   // Invalidate caches on server push updates when available
-  if (on_event) {
+  if (onEvent) {
     try {
-      on_event('issues-changed', () => {
+      onEvent('issues-changed', () => {
         cache.list_ready = undefined;
+        cache.list_blocked = undefined;
         cache.list_open = undefined;
         cache.list_in_progress = undefined;
         cache.list_closed_10 = undefined;
@@ -29,9 +33,8 @@ export function createDataLayer(transport, on_event) {
    */
   async function getEpicStatus() {
     if (Array.isArray(cache.epic_status)) {
-      return /** @type {unknown[]} */ (cache.epic_status);
+      return cache.epic_status;
     }
-    /** @type {unknown} */
     const res = await transport('epic-status');
     const arr = Array.isArray(res) ? res : [];
     cache.epic_status = arr;
@@ -45,7 +48,7 @@ export function createDataLayer(transport, on_event) {
    */
   async function getReady() {
     if (Array.isArray(cache.list_ready)) {
-      return /** @type {unknown[]} */ (cache.list_ready);
+      return cache.list_ready;
     }
     /** @type {unknown} */
     const res = await transport('list-issues', { filters: { ready: true } });
@@ -54,15 +57,30 @@ export function createDataLayer(transport, on_event) {
     return arr;
   }
 
+  /**
+   * Blocked issues: `bd blocked --json`.
+   * Sort by priority then updated_at on the UI; transport returns raw list.
+   * @returns {Promise<unknown[]>}
+   */
+  async function getBlocked() {
+    if (Array.isArray(cache.list_blocked)) {
+      return cache.list_blocked;
+    }
+    /** @type {unknown} */
+    const res = await transport('list-issues', { filters: { blocked: true } });
+    const arr = Array.isArray(res) ? res : [];
+    cache.list_blocked = arr;
+    return arr;
+  }
+
   /**
    * Open issues: `bd list -s open --json`.
    * @returns {Promise<unknown[]>}
    */
   async function getOpen() {
     if (Array.isArray(cache.list_open)) {
-      return /** @type {unknown[]} */ (cache.list_open);
+      return cache.list_open;
     }
-    /** @type {unknown} */
     const res = await transport('list-issues', {
       filters: { status: 'open' }
     });
@@ -77,9 +95,8 @@ export function createDataLayer(transport, on_event) {
    */
   async function getInProgress() {
     if (Array.isArray(cache.list_in_progress)) {
-      return /** @type {unknown[]} */ (cache.list_in_progress);
+      return cache.list_in_progress;
     }
-    /** @type {unknown} */
     const res = await transport('list-issues', {
       filters: { status: 'in_progress' }
     });
@@ -89,22 +106,21 @@ export function createDataLayer(transport, on_event) {
   }
 
   /**
-   * Closed issues: `bd list -s closed -l 10 --json`.
-   * @param {number} [limit] - Optional limit (defaults to 10).
+   * Closed issues: `bd list --status closed --json`.
+   * Note: Do not send a `limit` for closed. The board applies a timeframe
+   * filter (today/3/7 days) client-side and needs the full closed set.
    * @returns {Promise<unknown[]>}
    */
-  async function getClosed(limit = 10) {
-    if (limit === 10 && Array.isArray(cache.list_closed_10)) {
-      return /** @type {unknown[]} */ (cache.list_closed_10);
+  async function getClosed() {
+    if (Array.isArray(cache.list_closed_10)) {
+      // Reuse existing cache slot for closed list to avoid widening cache API
+      return cache.list_closed_10;
     }
-    /** @type {unknown} */
     const res = await transport('list-issues', {
-      filters: { status: 'closed', limit }
+      filters: { status: 'closed' }
     });
     const arr = Array.isArray(res) ? res : [];
-    if (limit === 10) {
-      cache.list_closed_10 = arr;
-    }
+    cache.list_closed_10 = arr;
     return arr;
   }
 
@@ -121,9 +137,9 @@ export function createDataLayer(transport, on_event) {
 
   /**
    * Update issue fields by dispatching specific mutations.
-   * Supported fields: title, acceptance, status, priority, assignee.
+   * Supported fields: title, acceptance, notes, design, status, priority, assignee.
    * Returns the updated issue on success.
-   * @param {{ id: string, title?: string, acceptance?: string, status?: 'open'|'in_progress'|'closed', priority?: number, assignee?: string }} input
+   * @param {{ id: string, title?: string, acceptance?: string, notes?: string, design?: string, status?: 'open'|'in_progress'|'closed', priority?: number, assignee?: string }} input
    * @returns {Promise<unknown>}
    */
   async function updateIssue(input) {
@@ -144,6 +160,20 @@ export function createDataLayer(transport, on_event) {
         value: input.acceptance
       });
     }
+    if (typeof input.notes === 'string') {
+      last = await transport('edit-text', {
+        id,
+        field: 'notes',
+        value: input.notes
+      });
+    }
+    if (typeof input.design === 'string') {
+      last = await transport('edit-text', {
+        id,
+        field: 'design',
+        value: input.design
+      });
+    }
     if (typeof input.status === 'string') {
       last = await transport('update-status', {
         id,
@@ -169,6 +199,7 @@ export function createDataLayer(transport, on_event) {
   return {
     getEpicStatus,
     getReady,
+    getBlocked,
     getOpen,
     getInProgress,
     getClosed,

package/app/index.html

@@ -21,6 +21,14 @@
             aria-label="Toggle dark mode"
           />
         </label>
+        <button
+          id="new-issue-btn"
+          type="button"
+          aria-haspopup="dialog"
+          title="Create a new issue (Ctrl/Cmd+N)"
+        >
+          New issue
+        </button>
       </div>
     </header>
     <main id="app" class="app-shell" aria-live="polite"></main>

package/app/main.js

@@ -1,12 +1,15 @@
 import { html, render } from 'lit-html';
 import { createDataLayer } from './data/providers.js';
-import { createHashRouter } from './router.js';
+import { createHashRouter, parseHash } from './router.js';
 import { createStore } from './state.js';
+import { showToast } from './utils/toast.js';
 import { createBoardView } from './views/board.js';
 import { createDetailView } from './views/detail.js';
 import { createEpicsView } from './views/epics.js';
+import { createIssueDialog } from './views/issue-dialog.js';
 import { createListView } from './views/list.js';
 import { createTopNav } from './views/nav.js';
+import { createNewIssueDialog } from './views/new-issue-dialog.js';
 import { createWsClient } from './ws.js';
 
 /**
@@ -40,6 +43,22 @@ export function bootstrap(root_element) {
   const detail_mount = document.getElementById('detail-panel');
   if (list_mount && issues_root && epics_root && board_root && detail_mount) {
     const client = createWsClient();
+    // Show toasts for WebSocket connectivity changes
+    /** @type {boolean} */
+    let had_disconnect = false;
+    if (typeof (/** @type {any} */ (client).onConnection) === 'function') {
+      /** @type {(s: 'connecting'|'open'|'closed'|'reconnecting') => void} */
+      const onConn = (s) => {
+        if (s === 'reconnecting' || s === 'closed') {
+          had_disconnect = true;
+          showToast('Connection lost. Reconnecting…', 'error', 4000);
+        } else if (s === 'open' && had_disconnect) {
+          had_disconnect = false;
+          showToast('Reconnected', 'success', 2200);
+        }
+      };
+      /** @type {any} */ (client).onConnection(onConn);
+    }
     // Load persisted filters (status/search/type) from localStorage
     /** @type {{ status: 'all'|'open'|'in_progress'|'closed'|'ready', search: string, type: string }} */
     let persistedFilters = { status: 'all', search: '', type: '' };
@@ -49,13 +68,11 @@ export function bootstrap(root_element) {
         const obj = JSON.parse(raw);
         if (obj && typeof obj === 'object') {
           const ALLOWED = ['bug', 'feature', 'task', 'epic', 'chore'];
-          /** @type {string} */
           let parsed_type = '';
           if (typeof obj.type === 'string' && ALLOWED.includes(obj.type)) {
             parsed_type = obj.type;
           } else if (Array.isArray(obj.types)) {
             // Backwards compatibility: pick first valid from previous array format
-            /** @type {string} */
             let first_valid = '';
             for (const it of obj.types) {
               if (ALLOWED.includes(String(it))) {
@@ -94,7 +111,29 @@ export function bootstrap(root_element) {
     } catch {
       // ignore
     }
-    const store = createStore({ filters: persistedFilters, view: last_view });
+    // Load board preferences
+    /** @type {{ closed_filter: 'today'|'3'|'7' }} */
+    let persistedBoard = { closed_filter: 'today' };
+    try {
+      const raw_board = window.localStorage.getItem('beads-ui.board');
+      if (raw_board) {
+        const obj = JSON.parse(raw_board);
+        if (obj && typeof obj === 'object') {
+          const cf = String(obj.closed_filter || 'today');
+          if (cf === 'today' || cf === '3' || cf === '7') {
+            persistedBoard.closed_filter = /** @type {any} */ (cf);
+          }
+        }
+      }
+    } catch {
+      // ignore parse errors
+    }
+
+    const store = createStore({
+      filters: persistedFilters,
+      view: last_view,
+      board: persistedBoard
+    });
     const router = createHashRouter(store);
     router.start();
     /**
@@ -113,11 +152,30 @@ export function bootstrap(root_element) {
       createTopNav(nav_mount, store, router);
     }
 
+    // Global New Issue dialog (UI-106) mounted at root so it is always visible
+    const new_issue_dialog = createNewIssueDialog(
+      root_element,
+      (type, payload) => client.send(/** @type {any} */ (type), payload),
+      router,
+      store
+    );
+    // Header button
+    try {
+      const btn_new = /** @type {HTMLButtonElement|null} */ (
+        document.getElementById('new-issue-btn')
+      );
+      if (btn_new) {
+        btn_new.addEventListener('click', () => new_issue_dialog.open());
+      }
+    } catch {
+      // ignore missing header
+    }
+
     const issues_view = createListView(
       list_mount,
       transport,
       (hash) => {
-        const id = hash.replace('#/issue/', '');
+        const id = parseHash(hash);
         if (id) {
           router.gotoIssue(id);
         }
@@ -137,44 +195,103 @@ export function bootstrap(root_element) {
         // ignore
       }
     });
+    // Persist board preferences
+    store.subscribe((s) => {
+      try {
+        window.localStorage.setItem(
+          'beads-ui.board',
+          JSON.stringify({ closed_filter: s.board.closed_filter })
+        );
+      } catch {
+        // ignore
+      }
+    });
     void issues_view.load();
-    const detail = createDetailView(detail_mount, transport, (hash) => {
-      const id = hash.replace('#/issue/', '');
+
+    // Dialog for issue details (UI-104)
+    const dialog = createIssueDialog(detail_mount, store, () => {
+      // Close: clear selection and return to current view
+      const s = store.getState();
+      store.setState({ selected_id: null });
+      try {
+        /** @type {'issues'|'epics'|'board'} */
+        const v = s.view || 'issues';
+        router.gotoView(v);
+      } catch {
+        // ignore
+      }
+    });
+
+    /** @type {ReturnType<typeof createDetailView> | null} */
+    let detail = null;
+    // Mount details into the dialog body only
+    detail = createDetailView(dialog.getMount(), transport, (hash) => {
+      const id = parseHash(hash);
       if (id) {
         router.gotoIssue(id);
       }
     });
 
-    // React to selectedId changes -> show detail page full-width
+    // If router already set a selected id (deep-link), open dialog now
+    const initial_id = store.getState().selected_id;
+    if (initial_id) {
+      detail_mount.hidden = false;
+      dialog.open(initial_id);
+      if (detail) {
+        void detail.load(initial_id);
+      }
+    }
+
+    // Open/close dialog based on selected_id (always dialog; no page variant)
     store.subscribe((s) => {
       const id = s.selected_id;
       if (id) {
-        void detail.load(id);
+        detail_mount.hidden = false;
+        dialog.open(id);
+        if (detail) {
+          void detail.load(id);
+        }
       } else {
-        detail.clear();
+        try {
+          dialog.close();
+        } catch {
+          // ignore
+        }
+        if (detail) {
+          detail.clear();
+        }
+        detail_mount.hidden = true;
       }
     });
 
-    // Initial deep-link: if router set a selectedId before subscription, load it now
-    const initialId = store.getState().selected_id;
-    if (initialId) {
-      void detail.load(initialId);
-    } else {
-      detail.clear();
-    }
-
     // Refresh views on push updates (target minimally and avoid flicker)
+    // UI-114: Coalesce near-simultaneous events. When an ID-scoped update
+    // arrives, suppress a trailing watcher-only full refresh for a short
+    // window to avoid duplicate work and flicker.
+    /** @type {number} */
+    let suppress_full_until = 0;
     client.on('issues-changed', (payload) => {
       const s = store.getState();
-      const hintIds =
+      const hint_ids =
         payload && payload.hint && Array.isArray(payload.hint.ids)
           ? /** @type {string[]} */ (payload.hint.ids)
           : null;
 
-      const showingDetail = Boolean(s.selected_id);
+      const now = Date.now();
+      if (!hint_ids || hint_ids.length === 0) {
+        if (now <= suppress_full_until) {
+          // Drop redundant full refresh that follows a targeted update.
+          return;
+        }
+      } else {
+        // Prefer ID-scoped updates for a brief window.
+        suppress_full_until = now + 500;
+      }
+
+      const showing_detail = Boolean(s.selected_id);
 
       // If a top-level view is visible (and not detail), refresh that view
-      if (!showingDetail) {
+      if (!showing_detail) {
         if (s.view === 'issues') {
           void issues_view.load();
         } else if (s.view === 'epics') {
@@ -185,9 +302,11 @@ export function bootstrap(root_element) {
       }
 
       // If a detail is visible, re-fetch it when relevant or when hints are absent
-      if (showingDetail && s.selected_id) {
-        if (!hintIds || hintIds.includes(s.selected_id)) {
-          void detail.load(s.selected_id);
+      if (showing_detail && s.selected_id) {
+        if (!hint_ids || hint_ids.includes(s.selected_id)) {
+          if (detail) {
+            void detail.load(s.selected_id);
+          }
         }
       }
     });
@@ -197,25 +316,28 @@ export function bootstrap(root_element) {
     const epics_view = createEpicsView(epics_root, data, (id) =>
       router.gotoIssue(id)
     );
-    const board_view = createBoardView(board_root, data, (id) =>
-      router.gotoIssue(id)
+    const board_view = createBoardView(
+      board_root,
+      data,
+      (id) => router.gotoIssue(id),
+      store
     );
     // Preload epics when switching to view
     /**
      * @param {{ selected_id: string | null, view: 'issues'|'epics'|'board', filters: any }} s
      */
     const onRouteChange = (s) => {
-      const showDetail = Boolean(s.selected_id);
       if (issues_root && epics_root && board_root && detail_mount) {
-        issues_root.hidden = showDetail || s.view !== 'issues';
-        epics_root.hidden = showDetail || s.view !== 'epics';
-        board_root.hidden = showDetail || s.view !== 'board';
-        detail_mount.hidden = !showDetail;
+        // Underlying route visibility is controlled only by selected view
+        issues_root.hidden = s.view !== 'issues';
+        epics_root.hidden = s.view !== 'epics';
+        board_root.hidden = s.view !== 'board';
+        // detail_mount visibility handled in subscription above
       }
-      if (!showDetail && s.view === 'epics') {
+      if (!s.selected_id && s.view === 'epics') {
         void epics_view.load();
       }
-      if (!showDetail && s.view === 'board') {
+      if (!s.selected_id && s.view === 'board') {
         void board_view.load();
       }
       try {
@@ -227,6 +349,30 @@ export function bootstrap(root_element) {
     store.subscribe(onRouteChange);
     // Ensure initial state is reflected (fixes reload on #/epics)
     onRouteChange(store.getState());
+
+    // Keyboard shortcuts: Ctrl/Cmd+N opens new issue; Ctrl/Cmd+Enter submits inside dialog
+    window.addEventListener('keydown', (ev) => {
+      const is_modifier = ev.ctrlKey || ev.metaKey;
+      const key = String(ev.key || '').toLowerCase();
+      /** @type {HTMLElement} */
+      const target = /** @type {any} */ (ev.target);
+      const tag =
+        target && target.tagName ? String(target.tagName).toLowerCase() : '';
+      const is_editable =
+        tag === 'input' ||
+        tag === 'textarea' ||
+        tag === 'select' ||
+        (target &&
+          typeof target.isContentEditable === 'boolean' &&
+          target.isContentEditable);
+      if (is_modifier && key === 'n') {
+        // Do not hijack when typing in inputs; common UX
+        if (!is_editable) {
+          ev.preventDefault();
+          new_issue_dialog.open();
+        }
+      }
+    });
   }
 }
 

package/app/protocol.md

@@ -23,8 +23,7 @@ ReplyEnvelope shape with `ok: true` and a generated `id`.
 - `update-status` payload:
   `{ id: string, status: 'open'|'in_progress'|'closed' }`
 - `edit-text` payload:
-  `{ id: string, field: 'title'|'description'|'acceptance', value: string }`
-  - Note: `description` edits are rejected by the server (unsupported by `bd`).
+  `{ id: string, field: 'title'|'description'|'acceptance'|'notes'|'design', value: string }`
 - `update-priority` payload: `{ id: string, priority: 0|1|2|3|4 }`
 - `create-issue` payload:
   `{ title: string, type?: 'bug'|'feature'|'task'|'epic'|'chore', priority?: 0|1|2|3|4, description?: string }`
@@ -44,8 +43,8 @@ ReplyEnvelope shape with `ok: true` and a generated `id`.
 - `list-issues` → `bd list --json [--status <s>] [--priority <n>]`
 - `show-issue` → `bd show <id> --json`
 - `update-status` → `bd update <id> --status <status>`
-- `edit-text` → `bd update <id> --title <t>` or `--acceptance-criteria <a>`
-  - `description` has no CLI flag; server responds with an error
+- `edit-text` → `bd update <id> --title <t>` or `--description <d>` or
+  `--acceptance-criteria <a>` or `--notes <n>` or `--design <z>`
 - `update-priority` → `bd update <id> --priority <n>`
 - `create-issue` → `bd create "title" -t <type> -p <prio> -d "desc"`
 - `list-ready` → `bd ready --json`