modboard 0.5.0 → 0.6.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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "modboard",
3
- "version": "0.5.0",
3
+ "version": "0.6.0",
4
4
  "description": "A task board several agents share: Claude tools, a live pane and lease heartbeats over an agent-neutral CLI",
5
5
  "author": {
6
6
  "name": "Magithar",
@@ -19,14 +19,14 @@
19
19
  "band": {
20
20
  "type": "string",
21
21
  "title": "Band blocks",
22
- "description": "Blocks on the one line above the prompt, in order, comma-separated: summary, usage, model, effort, clock, context, or your own from Your own blocks.",
23
- "default": "summary,usage,model,effort"
22
+ "description": "Blocks on the one line above the prompt, in order, comma-separated: summary, board (a button that opens the pane), usage, compact, model, effort, clock, context, or your own from Your own blocks.",
23
+ "default": "summary,model,effort,board"
24
24
  },
25
25
  "pane": {
26
26
  "type": "string",
27
27
  "title": "Pane blocks",
28
- "description": "Blocks in the /board pane, in order, comma-separated: tasks, usage, model, effort, clock, context, agents, or your own from Your own blocks.",
29
- "default": "tasks,usage"
28
+ "description": "Blocks in the /board pane, in order, comma-separated: tasks, taskfile (the project's task.md, behind a button), compact (context bar and a compact button), usage, model, effort, clock, context, agents, or your own from Your own blocks.",
29
+ "default": "tasks,taskfile,compact,usage"
30
30
  },
31
31
  "blocks": {
32
32
  "type": "string",
package/CHANGELOG.md ADDED
@@ -0,0 +1,222 @@
1
+ # Changelog
2
+
3
+ All notable changes to modboard. Versions follow [semantic versioning](https://semver.org/).
4
+ modboard was called agent-board until 0.5.0.
5
+
6
+ ## 0.6.0 — 2026-11-20
7
+
8
+ Sessions name themselves, the board shows your project's own task file with
9
+ its priorities, and the display is quieter and clickable: colour, marks and
10
+ words appear only where they tell you something.
11
+
12
+ ### Added
13
+
14
+ - **Sessions are named for you**, by what they run and when they joined:
15
+ `claude 1`, `claude 2`, `codex 1`. Nothing to set: a Claude session joins
16
+ when it starts, and a Codex thread when it first runs `board` (Codex marks
17
+ its shells with `CODEX_THREAD_ID`). A session keeps its name while it's
18
+ open; a new one takes the lowest free number. `BOARD_AGENT` still picks a
19
+ name of your own. New `board join` and `board whoami` commands.
20
+ - **Your task.md on the board.** When the project has a `task.md`,
21
+ `tasks.md` or `todo.md` (upper or lower case) at its root or in `docs/`,
22
+ the pane shows what's left in it under **To do**, read again on each
23
+ click. Checked-off items stay out. Nothing in it is claimed or written; to
24
+ work an item through the board, `board add` it.
25
+ - **Task file priorities.** P0–P9 are read from headings (`## P0 — …`,
26
+ `## Sync (P1)`), from items (`- [ ] P2 …`, which wins over its heading)
27
+ and from tables with a Priority column. A priority button beside To do
28
+ turns through the tiers the file has, `P0`, `P1`, …, `all`, the way the
29
+ effort button turns through levels. `all` lists every item with its
30
+ priority, unprioritised ones last, marked with a dash.
31
+ - **`board taskfile`** prints the task file's items; `--json` gives them as
32
+ data. It reads no board and writes nothing.
33
+ - **A `compact` block**: the context window as a bar, like the 5-hour
34
+ limit's, and a button that compacts the conversation, the call `/compact`
35
+ makes. It shows from the start: Claude Code's own estimate until the first
36
+ reply, then each reply's measurement.
37
+ - **A `modBOARD` button on the band**, bold in the logo's green, at the
38
+ line's right end. It opens the `/board` pane, and closes it when it's
39
+ open. On a short line, model and effort drop before it.
40
+ - **Collapsible groups.** In progress, Unfinished, Not started and Done are
41
+ each a heading you click to open or close, with a count: `▾ In progress ·
42
+ 3`. What needs you starts open; Not started and Done start closed.
43
+ - **A Done group** lists what's finished, latest first, and who finished it.
44
+ - **A Limits heading** over the context and 5-hour bars, which folds like
45
+ the groups. Folded, it keeps the figures: `▸ Limits · context 72% ·
46
+ 5-hour 64%`, each yellow or red as its bar would be.
47
+ - **A red line when the board stops answering**: `board not updating: …`
48
+ at the top of the pane, with the reason, until the `board` CLI answers
49
+ again.
50
+ - **A taller `/board` pane**, room for the whole board. Where the surface
51
+ gives less, the pane scrolls with the mouse wheel.
52
+ - **A tutorial**, [docs/TUTORIAL.md](docs/TUTORIAL.md): from install to two
53
+ agents sharing a board, reading the display, your task.md, other agents,
54
+ settings, and what to do when something looks wrong.
55
+ - **A roadmap**, [ROADMAP.md](ROADMAP.md), starting with `/board colours`.
56
+ - **A logo**, at the top of the README.
57
+
58
+ ### Changed
59
+
60
+ - **Default blocks.** The band is now `summary,model,effort,board`; the
61
+ 5-hour limit and the context moved to the pane, which is
62
+ `tasks,taskfile,compact,usage`.
63
+ - **A shorter band**: `2 waiting · 1 active [T-005] Sonnet 5.5 low`.
64
+ `active` is green, and the model and effort lose their labels.
65
+ - **Each unfinished task is a yellow box on the band**: `[T-005] [T-008]`,
66
+ up to three, then `+N`. A box is a button: it opens `/board` at
67
+ Unfinished, and pressed again folds the group. It replaces "T-005 stopped
68
+ partway, pick it up".
69
+ - **A claim gone idle leaves the band**, since its lease frees it on its
70
+ own; in the pane its row reads `codex 1 · idle`, in yellow.
71
+ - **"Needs picking up" is now "Unfinished"**, and its handoff shows under
72
+ each task as points, one per part the agent separated with a semicolon.
73
+ It replaces "see its note". Handoffs are now asked for as "done X; left Y;
74
+ see Z".
75
+ - **A quieter pane.** It opens with `modBOARD`, this session's name and the
76
+ counts. Rows lose their ◐/○ mark and name only who (`claude 2`, `you`),
77
+ since the heading says what. IDs are grey. A heading's name is a bold
78
+ button and its count grey beside it. Each open group has room around it,
79
+ and a grey rule parts the board, To do and the bars.
80
+ - **Colour only when something needs you**: yellow from 70%, red from 90%.
81
+ With room left, usage and context stay plain (usage used to be green).
82
+ - **The weekly limit is left off the board**; `/usage` has it.
83
+ - **The clock** in the pane is dimmed instead of bold.
84
+
85
+ ### Reading task files
86
+
87
+ - Tables are read when they have a task column and a priority or status
88
+ column; a status of done, complete or ✅ counts as checked off.
89
+ - Struck-through items (`~~old plan~~`) count as done.
90
+ - Once a file checks anything off, its plain bullets are notes, not tasks,
91
+ and are left out.
92
+ - Markdown marks (`**`, backticks, link syntax) and status emoji are taken
93
+ off item text and headings for display.
94
+ - A broken link named `task.md` reads as no task file, not an error.
95
+
96
+ ### Docs
97
+
98
+ - The README is reorganised: what it does, a demo, a three-step quick
99
+ start, everyday commands, what you see, settings, how it works, then
100
+ making your own blocks, with reference material folded away.
101
+ - Screenshots of the `/board` pane and the task file, and a sharper live
102
+ demo, re-recorded at retina resolution with the automatic names.
103
+ - The diagrams show the new names and groups, in the logo's green.
104
+
105
+ ## 0.5.1 — 2026-11-19
106
+
107
+ Docs and package details only. The code is the same as 0.5.0.
108
+
109
+ - npm keywords now match the GitHub topics, so npm search finds modboard
110
+ under `claude-code-plugin`, `llm-agents`, `coding-agents` and more.
111
+ - The package now includes `CHANGELOG.md`.
112
+ - The README links to the changelog and to a new contributing guide, and its
113
+ badges show the license, release, npm downloads and Claude Code version.
114
+ - The live recording in the README is re-recorded with the modboard name.
115
+
116
+ ## 0.5.0 — 2026-11-19
117
+
118
+ First release on npm: `npm install -g modboard`.
119
+
120
+ ### Renamed
121
+
122
+ - **agent-board is now modboard**, everywhere: the npm package, the Claude Code
123
+ plugin, the README and the GitHub repo
124
+ ([Magithar/modboard](https://github.com/Magithar/modboard); the old URL redirects).
125
+ npm refused `agent-board` as too close to an existing `agentboard`.
126
+ - The plugin's tools are now `mcp__modboard__board_*`, and the pane is titled
127
+ "modboard".
128
+ - New boards go in `.modboard/`. A board already in `.agent-board/` keeps
129
+ working where it is.
130
+ - Unchanged: the `board` command and the `BOARD_*` environment variables.
131
+
132
+ ### Added
133
+
134
+ - **Your own display blocks, no code.** The `blocks` setting maps a name to a
135
+ shell command; the block shows its first line of output, refreshed every
136
+ 30 seconds. It lives in your user config only, so a cloned repo can never
137
+ make your session run its commands.
138
+ - **Model and effort blocks** that switch when clicked, by running Claude
139
+ Code's own `/model` and `/effort`. The `models` and `efforts` settings list
140
+ what they step through.
141
+ - **Readable CLI output.** Every command answers in a line or two for a
142
+ person (`claimed T-001 … it's yours until 14:05`); `--json` prints the data
143
+ for scripts. `view` and `events` stay JSON.
144
+ - **Storage blocks from npm.** A block published as a package is found in the
145
+ `node_modules` of the project that holds the board, or any folder above it,
146
+ not only beside modboard. Conditional `exports` and `main` both work.
147
+ - **Publishable package**: exports for the contract tests, the engine and the
148
+ file block, so a storage block's own package can test itself with
149
+ `modboard/lib/contract.mjs`.
150
+ - **README guide to making your own block**: storage blocks (adapters) step
151
+ by step, with how the version check makes one claim win; display blocks
152
+ from a command or in code. Both code examples run.
153
+ - **Diagrams** of how the system fits together and how blocks work, each
154
+ rebuilt from plain text with `node docs/render.mjs`.
155
+ - **A live recording** in the README of three real Claude Code sessions
156
+ sharing one board.
157
+
158
+ ### Changed
159
+
160
+ - **Faster crash recovery.** A registered session that goes silent for
161
+ 3 minutes (`BOARD_PRESENCE_MS`) loses its claims, so a killed Claude process
162
+ frees its tasks in 3 minutes instead of 15. Claims and notes count as signs
163
+ of life. An agent that never registered keeps the 15-minute lease.
164
+ - **The display speaks plainly.** The band reads "2 tasks waiting · 1 in
165
+ progress", and its alert "T-005 was stopped partway, pick it up". Pane rows
166
+ say who has a task as a sentence ("backend is on it", "frontend stopped
167
+ partway · see its note"), and waiting work splits into "Needs picking up"
168
+ and "Not started". The CLI and tools keep the precise terms agents act on.
169
+ - **The band stays on one line at any width.** Blocks narrow, then drop from
170
+ the end, and the summary narrows last, its alert outlasting its counts. It
171
+ leaves room for Claude Code's own `[-]` control at the right end.
172
+ - **Usage is coloured by what is left**: green, yellow from 70%, red from 90%.
173
+ - **Effort shows the level a session will start on** before its first
174
+ request: `CLAUDE_CODE_EFFORT_LEVEL`, else the model's own `effortLevel` under
175
+ `modelSettings`, else the general `effortLevel`.
176
+
177
+ ### Fixed
178
+
179
+ - The effort block no longer sticks at `xhigh` (it matched "high" inside it).
180
+ - The band no longer runs under Claude Code's `[-]` control.
181
+ - A test of silent sessions no longer fails when the test suites run in
182
+ parallel.
183
+
184
+ ## 0.4.0 — 2026-10-12
185
+
186
+ - **Storage and display become plug-in blocks.** `config.json` names the
187
+ storage block: the built-in file block, a block file beside the board, or a
188
+ package. A block that won't load or is missing a method is refused by name.
189
+ The contract tests move to `lib/contract.mjs` so a block's author can run
190
+ them, and `examples/store-memory.mjs` is a whole block to copy from.
191
+ - Display blocks are one file each in `hooks/blocks/`: summary, tasks, usage,
192
+ clock, context and agents, chosen in the `band` and `pane` settings.
193
+ - **A calmer display.** A one-line band above the prompt shows only what needs
194
+ you, and disappears when nothing is open. The `/board` pane groups work in
195
+ progress above open work and folds done tasks into a count.
196
+
197
+ ## 0.3.0 — 2026-10-12
198
+
199
+ - **Session names.** `BOARD_AGENT` names a Claude session on the board. A
200
+ name another live session holds falls back to `name-2`, with a toast.
201
+ - **A storage socket.** The rules move into `lib/engine.mjs`, and storage sits
202
+ behind a Store contract: snapshots and all-or-none conditional commits, the
203
+ shape a database can honour in one transaction.
204
+ - **Pane blocks**: clock, usage, agents and tasks.
205
+
206
+ ## 0.2.0 — 2026-10-12
207
+
208
+ Closes three gaps found by testing with live sessions.
209
+
210
+ - Lost claims go into the ledger as `claim-rejected`, naming the holder.
211
+ - `done` needs a `--note` saying how the task was checked, and tasks can carry
212
+ `--accept` criteria.
213
+ - A Claude session that ends releases everything it holds, with a handoff.
214
+ The CLI gains `release-all`.
215
+
216
+ ## 0.1.0 — 2026-10-12
217
+
218
+ - A task board several agents share: one zero-dependency CLI owns the board,
219
+ and a Claude Code mod adds tools, a live pane and lease heartbeats.
220
+ - Tested with two live Claude sessions and a shell standing in for Codex: one
221
+ winner per claim, agents claim before editing, handoffs resume, and expired
222
+ leases free the task.