bdtui 0.7.2 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/README.md +56 -37
- package/package.json +1 -1
- package/src/app.js +19 -1
- package/src/keys.js +2 -1
- package/src/views/detail.js +12 -0
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
|
|
|
4
4
|
|
|
5
5
|
## [Unreleased]
|
|
6
6
|
|
|
7
|
+
## [0.8.0] - 2026-07-02
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- The detail pane now shows a **Close Reason** section for closed beads. When a bead is closed with `c`, `bd` stores the text in its `close_reason` field; that resolution (with the close date) was already fetched but never displayed. It now renders above the dependencies, so you can see why/how a bead was closed without leaving the TUI.
|
|
12
|
+
- `m` toggles mouse capture so you can **select and copy detail-pane text**. blessed grabs the terminal mouse process-wide the moment any pane enables it, which blocks the terminal's own click-drag selection. Pressing `m` releases the mouse (drag to select, then copy with your terminal's copy); pressing it again restores wheel scrolling and click-to-select. The status bar shows the current mode.
|
|
13
|
+
- A **Deferred** status tab, added to the left of **Blocked** in the tab bar. It lists every bead whose stored status is `deferred` (`bd list --status deferred`) — beads you've explicitly parked — so they're reachable without scrolling the **All** tab. Like the other status tabs it builds the epic→child tree (a deferred bead nests under its parent epic) and cycles with `Tab` / `Shift+Tab`. The deferred status glyph/color and the `s` status picker already supported `deferred`; this surfaces it as a first-class view.
|
|
14
|
+
|
|
7
15
|
## [0.7.2] - 2026-06-29
|
|
8
16
|
|
|
9
17
|
### Added
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Fast blessed-based terminal UI for the [`bd`](https://github.com/gastownhall/beads) beads issue tracker.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
|
|
6
6
|
|
|
7
7
|
## Requirements
|
|
8
8
|
|
|
@@ -40,51 +40,70 @@ bdtui ~/www/myapp # explicit project path
|
|
|
40
40
|
|
|
41
41
|
## Layout
|
|
42
42
|
|
|
43
|
+
A top tab bar (the active status filter is highlighted — shown here as `[ready]` — followed by the live `type:` / `epic:` / `search:` and bead-count indicators), a two-pane body with the **Beads** list on the left and the **Detail** view on the right, and a bottom status bar:
|
|
44
|
+
|
|
43
45
|
```
|
|
44
|
-
|
|
45
|
-
│
|
|
46
|
-
|
|
47
|
-
│
|
|
48
|
-
│
|
|
49
|
-
│
|
|
50
|
-
|
|
51
|
-
│
|
|
52
|
-
|
|
46
|
+
┌──────────────────────────────────────────────────────────────────────────────────
|
|
47
|
+
│ deferred │ blocked │ [ready] │ in_progress │ closed │ all type: all · 27 beads
|
|
48
|
+
├──────────────────────────────────────────────────────────────────────────────────
|
|
49
|
+
│ Beads (27) │ Detail
|
|
50
|
+
│ be-12 P1 in_prog T Fix login │ be-12 — Fix login bug
|
|
51
|
+
│ be-13 P2 open T Retry │ ══════════════════════════════
|
|
52
|
+
│ be-10 P1 open E Auth epic │ Status: in_progress │ Priority: P1 High
|
|
53
|
+
│ be-11 P2 open T ├ OAuth │ Type: bug │ Owner: alice
|
|
54
|
+
│ be-14 P2 closed B └ CSRF │ Created: 2026-06-01 │ Updated: 2026-06-14
|
|
55
|
+
│ │
|
|
56
|
+
│ list · 40% │ detail · 60%
|
|
57
|
+
├───────────────────────────────────────────────────────────────────────────────────
|
|
58
|
+
│ ● Ready ? help · q quit
|
|
59
|
+
└───────────────────────────────────────────────────────────────────────────────────
|
|
53
60
|
```
|
|
54
61
|
|
|
55
|
-
|
|
62
|
+
Each list row reads `id · priority · status · type-badge · title`. The detail pane shows the selected bead's fields, its close reason (for closed beads), dependencies, and rendered description.
|
|
63
|
+
|
|
64
|
+
Beads with parent–child dependencies are shown as a tree inside the active filter — child rows nest under their epic with `├` / `└`:
|
|
56
65
|
|
|
57
66
|
```
|
|
58
|
-
be-10
|
|
59
|
-
be-11
|
|
60
|
-
be-12
|
|
67
|
+
be-10 P1 open E Auth epic
|
|
68
|
+
be-11 P2 open T ├ Add OAuth login
|
|
69
|
+
be-12 P2 open T └ Refresh tokens
|
|
61
70
|
```
|
|
62
71
|
|
|
63
72
|
## Keybindings
|
|
64
73
|
|
|
65
|
-
| Key
|
|
66
|
-
|
|
67
|
-
| `j` / `↓`
|
|
68
|
-
| `k` / `↑`
|
|
69
|
-
| `g` / `Shift+g`
|
|
70
|
-
| `Enter` / `l`
|
|
71
|
-
| `h` / `Esc`
|
|
72
|
-
| `Tab` / `Shift+Tab` | Next / previous status filter (blocked/ready/in_progress/closed/all)
|
|
73
|
-
| `t`
|
|
74
|
-
| `e`
|
|
75
|
-
| `/`
|
|
76
|
-
| `r`
|
|
77
|
-
| `Shift+r`
|
|
78
|
-
| `s`
|
|
79
|
-
| `c`
|
|
80
|
-
| `Shift+c`
|
|
81
|
-
| `o`
|
|
82
|
-
| `p`
|
|
83
|
-
| `h`
|
|
84
|
-
| `y`
|
|
85
|
-
| `w`
|
|
86
|
-
|
|
|
87
|
-
|
|
|
74
|
+
| Key | Action |
|
|
75
|
+
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
76
|
+
| `j` / `↓` | Move down |
|
|
77
|
+
| `k` / `↑` | Move up |
|
|
78
|
+
| `g` / `Shift+g` | Jump to top / bottom |
|
|
79
|
+
| `Enter` / `l` | Focus detail pane |
|
|
80
|
+
| `h` / `Esc` | Back to list (from detail) |
|
|
81
|
+
| `Tab` / `Shift+Tab` | Next / previous status filter (deferred/blocked/ready/in_progress/closed/all) |
|
|
82
|
+
| `t` | Cycle type filter (all/epic/task/chore/bug) |
|
|
83
|
+
| `e` | Filter by epic (modal picker; `x` clears) |
|
|
84
|
+
| `/` | In-memory title filter (empty submit clears it) |
|
|
85
|
+
| `r` | Reload (keeps active filters) |
|
|
86
|
+
| `Shift+r` | Reset all filters (title / epic / type) and reload |
|
|
87
|
+
| `s` | Change status |
|
|
88
|
+
| `c` | Close with reason |
|
|
89
|
+
| `Shift+c` | Claim (in_progress + assign self) |
|
|
90
|
+
| `o` | Reopen |
|
|
91
|
+
| `p` | Change priority |
|
|
92
|
+
| `h` | Change parent (epic / standalone) |
|
|
93
|
+
| `y` | Yank bead ID to clipboard |
|
|
94
|
+
| `w` | Pick a workflow command and copy it with the selected bead's ID. Tasks list the per-bead executors (`/executor-task`, `/executor-task-worktree`, `/executor-epic-task`, `/executor-epic-task-worktree`, `/executor-rework-in-place`); epics list `/executor-epic-sequential` and `/executor-epic-sequential-worktree`. See [Agent workflow](#agent-workflow). |
|
|
95
|
+
| `m` | Release mouse capture so you can drag-select & copy detail text with your terminal (toggle) |
|
|
96
|
+
| `?` | Help overlay |
|
|
97
|
+
| `q` / `Ctrl-C` | Quit |
|
|
98
|
+
|
|
99
|
+
## Agent workflow
|
|
100
|
+
|
|
101
|
+
Pressing `w` copies a slash-command for the selected bead, e.g. `/executor-task be-12`. Those `/executor-*` commands are [Claude Code](https://claude.com/claude-code) / Codex skills scaffolded by [`agent-workflow-beads`](https://www.npmjs.com/package/agent-workflow-beads) — a planner → executor workflow backed by the same beads database. Install it globally, then bootstrap your repo so the copied commands resolve:
|
|
102
|
+
|
|
103
|
+
```bash
|
|
104
|
+
npm install -g agent-workflow-beads
|
|
105
|
+
agent-workflow-beads bootstrap /path/to/your-repo myprefix
|
|
106
|
+
```
|
|
88
107
|
|
|
89
108
|
## Author
|
|
90
109
|
|
package/package.json
CHANGED
package/src/app.js
CHANGED
|
@@ -7,7 +7,7 @@ import { statusPicker, priorityPicker, textPrompt, parentPicker, skillPicker, ep
|
|
|
7
7
|
import { showHelp } from './keys.js';
|
|
8
8
|
import { bdUpdate, bdClose, bdClaim, bdReopen, bdDepAdd, bdDepRemove, bdDepListDown, bdEpics } from './bd.js';
|
|
9
9
|
|
|
10
|
-
const FILTERS = ['blocked', 'ready', 'in_progress', 'closed', 'all'];
|
|
10
|
+
const FILTERS = ['deferred', 'blocked', 'ready', 'in_progress', 'closed', 'all'];
|
|
11
11
|
const TYPE_FILTERS = ['all', 'epic', 'task', 'chore', 'bug'];
|
|
12
12
|
|
|
13
13
|
// Neutralize blessed tag markup in free text before it lands in a tags:true
|
|
@@ -567,6 +567,24 @@ export async function run(cwd) {
|
|
|
567
567
|
}
|
|
568
568
|
});
|
|
569
569
|
|
|
570
|
+
// Release blessed's mouse capture so the terminal can do native click-drag
|
|
571
|
+
// text selection (then copy with the terminal's own copy). blessed grabs the
|
|
572
|
+
// mouse process-wide the moment any element sets mouse:true, which blocks
|
|
573
|
+
// native selection; toggling it off hands the mouse back to the terminal.
|
|
574
|
+
// Re-enable via program.enableMouse() directly — screen.enableMouse() is a
|
|
575
|
+
// no-op here because blessed's _listenedMouse latch is already set.
|
|
576
|
+
let mouseCaptured = true;
|
|
577
|
+
key(['m'], () => {
|
|
578
|
+
mouseCaptured = !mouseCaptured;
|
|
579
|
+
if (mouseCaptured) {
|
|
580
|
+
screen.program.enableMouse();
|
|
581
|
+
setStatus('Mouse restored — wheel scroll & click active', false, true);
|
|
582
|
+
} else {
|
|
583
|
+
screen.program.disableMouse();
|
|
584
|
+
setStatus('Mouse released — drag to select text, copy with your terminal · press m to restore');
|
|
585
|
+
}
|
|
586
|
+
});
|
|
587
|
+
|
|
570
588
|
// ── Boot ───────────────────────────────────────────────────────────────────
|
|
571
589
|
|
|
572
590
|
setFocusBorder('list');
|
package/src/keys.js
CHANGED
|
@@ -13,7 +13,7 @@ export const HELP_TEXT = [
|
|
|
13
13
|
'',
|
|
14
14
|
' Filters & refresh',
|
|
15
15
|
' ──────────────────────────────────────',
|
|
16
|
-
' Tab Next status filter (blocked/ready/in_progress/closed/all)',
|
|
16
|
+
' Tab Next status filter (deferred/blocked/ready/in_progress/closed/all)',
|
|
17
17
|
' Shift+Tab Previous status filter',
|
|
18
18
|
' t Cycle type filter (all/epic/task/chore/bug)',
|
|
19
19
|
' e Filter by epic (modal picker; x clears; switches status to all)',
|
|
@@ -35,6 +35,7 @@ export const HELP_TEXT = [
|
|
|
35
35
|
' ──────────────────────────────────────',
|
|
36
36
|
' y Yank bead ID to clipboard',
|
|
37
37
|
' w Copy workflow command (tasks: executors; epics: epic-sequential)',
|
|
38
|
+
' m Release mouse to select/copy detail text (toggle)',
|
|
38
39
|
' ? Toggle this help',
|
|
39
40
|
' q / Ctrl-C Quit',
|
|
40
41
|
'',
|
package/src/views/detail.js
CHANGED
|
@@ -184,6 +184,18 @@ export function renderDetail(box) {
|
|
|
184
184
|
lines.push(field('Labels', b.labels.map((l) => t('blue', esc(l))).join(' ')));
|
|
185
185
|
}
|
|
186
186
|
|
|
187
|
+
// ── Close reason (closed beads) ─────────────────────────────────────────────
|
|
188
|
+
// bd stores the text from `bd close --reason` in `close_reason`; loadDetail
|
|
189
|
+
// already spreads the full `bd show` object onto the bead, so it's available
|
|
190
|
+
// here. Rendered high in the pane (before deps) so a closed bead's resolution
|
|
191
|
+
// is visible without scrolling. Truthy guard → open beads show nothing.
|
|
192
|
+
if (b.close_reason) {
|
|
193
|
+
const when = b.closed_at ? ` · ${fmtDate(b.closed_at)}` : '';
|
|
194
|
+
lines.push(sectionHeader(`Close Reason${when}`));
|
|
195
|
+
lines.push('');
|
|
196
|
+
renderDescription(lines, b.close_reason);
|
|
197
|
+
}
|
|
198
|
+
|
|
187
199
|
// ── Dependencies ───────────────────────────────────────────────────────────
|
|
188
200
|
if (b.depsDown?.length > 0) {
|
|
189
201
|
lines.push(sectionHeader(`Depends on (${b.depsDown.length})`));
|