modboard 0.5.0 → 0.5.1

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.5.1",
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",
package/CHANGELOG.md ADDED
@@ -0,0 +1,123 @@
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.5.1 — 2026-11-19
7
+
8
+ Docs and package details only. The code is the same as 0.5.0.
9
+
10
+ - npm keywords now match the GitHub topics, so npm search finds modboard
11
+ under `claude-code-plugin`, `llm-agents`, `coding-agents` and more.
12
+ - The package now includes `CHANGELOG.md`.
13
+ - The README links to the changelog and to a new contributing guide, and its
14
+ badges show the license, release, npm downloads and Claude Code version.
15
+ - The live recording in the README is re-recorded with the modboard name.
16
+
17
+ ## 0.5.0 — 2026-11-19
18
+
19
+ First release on npm: `npm install -g modboard`.
20
+
21
+ ### Renamed
22
+
23
+ - **agent-board is now modboard**, everywhere: the npm package, the Claude Code
24
+ plugin, the README and the GitHub repo
25
+ ([Magithar/modboard](https://github.com/Magithar/modboard); the old URL redirects).
26
+ npm refused `agent-board` as too close to an existing `agentboard`.
27
+ - The plugin's tools are now `mcp__modboard__board_*`, and the pane is titled
28
+ "modboard".
29
+ - New boards go in `.modboard/`. A board already in `.agent-board/` keeps
30
+ working where it is.
31
+ - Unchanged: the `board` command and the `BOARD_*` environment variables.
32
+
33
+ ### Added
34
+
35
+ - **Your own display blocks, no code.** The `blocks` setting maps a name to a
36
+ shell command; the block shows its first line of output, refreshed every
37
+ 30 seconds. It lives in your user config only, so a cloned repo can never
38
+ make your session run its commands.
39
+ - **Model and effort blocks** that switch when clicked, by running Claude
40
+ Code's own `/model` and `/effort`. The `models` and `efforts` settings list
41
+ what they step through.
42
+ - **Readable CLI output.** Every command answers in a line or two for a
43
+ person (`claimed T-001 … it's yours until 14:05`); `--json` prints the data
44
+ for scripts. `view` and `events` stay JSON.
45
+ - **Storage blocks from npm.** A block published as a package is found in the
46
+ `node_modules` of the project that holds the board, or any folder above it,
47
+ not only beside modboard. Conditional `exports` and `main` both work.
48
+ - **Publishable package**: exports for the contract tests, the engine and the
49
+ file block, so a storage block's own package can test itself with
50
+ `modboard/lib/contract.mjs`.
51
+ - **README guide to making your own block**: storage blocks (adapters) step
52
+ by step, with how the version check makes one claim win; display blocks
53
+ from a command or in code. Both code examples run.
54
+ - **Diagrams** of how the system fits together and how blocks work, each
55
+ rebuilt from plain text with `node docs/render.mjs`.
56
+ - **A live recording** in the README of three real Claude Code sessions
57
+ sharing one board.
58
+
59
+ ### Changed
60
+
61
+ - **Faster crash recovery.** A registered session that goes silent for
62
+ 3 minutes (`BOARD_PRESENCE_MS`) loses its claims, so a killed Claude process
63
+ frees its tasks in 3 minutes instead of 15. Claims and notes count as signs
64
+ of life. An agent that never registered keeps the 15-minute lease.
65
+ - **The display speaks plainly.** The band reads "2 tasks waiting · 1 in
66
+ progress", and its alert "T-005 was stopped partway, pick it up". Pane rows
67
+ say who has a task as a sentence ("backend is on it", "frontend stopped
68
+ partway · see its note"), and waiting work splits into "Needs picking up"
69
+ and "Not started". The CLI and tools keep the precise terms agents act on.
70
+ - **The band stays on one line at any width.** Blocks narrow, then drop from
71
+ the end, and the summary narrows last, its alert outlasting its counts. It
72
+ leaves room for Claude Code's own `[-]` control at the right end.
73
+ - **Usage is coloured by what is left**: green, yellow from 70%, red from 90%.
74
+ - **Effort shows the level a session will start on** before its first
75
+ request: `CLAUDE_CODE_EFFORT_LEVEL`, else the model's own `effortLevel` under
76
+ `modelSettings`, else the general `effortLevel`.
77
+
78
+ ### Fixed
79
+
80
+ - The effort block no longer sticks at `xhigh` (it matched "high" inside it).
81
+ - The band no longer runs under Claude Code's `[-]` control.
82
+ - A test of silent sessions no longer fails when the test suites run in
83
+ parallel.
84
+
85
+ ## 0.4.0 — 2026-10-12
86
+
87
+ - **Storage and display become plug-in blocks.** `config.json` names the
88
+ storage block: the built-in file block, a block file beside the board, or a
89
+ package. A block that won't load or is missing a method is refused by name.
90
+ The contract tests move to `lib/contract.mjs` so a block's author can run
91
+ them, and `examples/store-memory.mjs` is a whole block to copy from.
92
+ - Display blocks are one file each in `hooks/blocks/`: summary, tasks, usage,
93
+ clock, context and agents, chosen in the `band` and `pane` settings.
94
+ - **A calmer display.** A one-line band above the prompt shows only what needs
95
+ you, and disappears when nothing is open. The `/board` pane groups work in
96
+ progress above open work and folds done tasks into a count.
97
+
98
+ ## 0.3.0 — 2026-10-12
99
+
100
+ - **Session names.** `BOARD_AGENT` names a Claude session on the board. A
101
+ name another live session holds falls back to `name-2`, with a toast.
102
+ - **A storage socket.** The rules move into `lib/engine.mjs`, and storage sits
103
+ behind a Store contract: snapshots and all-or-none conditional commits, the
104
+ shape a database can honour in one transaction.
105
+ - **Pane blocks**: clock, usage, agents and tasks.
106
+
107
+ ## 0.2.0 — 2026-10-12
108
+
109
+ Closes three gaps found by testing with live sessions.
110
+
111
+ - Lost claims go into the ledger as `claim-rejected`, naming the holder.
112
+ - `done` needs a `--note` saying how the task was checked, and tasks can carry
113
+ `--accept` criteria.
114
+ - A Claude session that ends releases everything it holds, with a handoff.
115
+ The CLI gains `release-all`.
116
+
117
+ ## 0.1.0 — 2026-10-12
118
+
119
+ - A task board several agents share: one zero-dependency CLI owns the board,
120
+ and a Claude Code mod adds tools, a live pane and lease heartbeats.
121
+ - Tested with two live Claude sessions and a shell standing in for Codex: one
122
+ winner per claim, agents claim before editing, handoffs resume, and expired
123
+ leases free the task.
package/README.md CHANGED
@@ -2,9 +2,8 @@
2
2
 
3
3
  <p align="center">
4
4
  <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"/>
5
- <img src="https://img.shields.io/github/package-json/v/Magithar/modboard?label=version" alt="Version"/>
6
- <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg" alt="Node 18 or newer"/>
7
- <img src="https://img.shields.io/badge/dependencies-0-brightgreen.svg" alt="No dependencies"/>
5
+ <img src="https://img.shields.io/github/v/release/Magithar/modboard?include_prereleases&label=release" alt="Release"/>
6
+ <a href="https://www.npmjs.com/package/modboard"><img src="https://img.shields.io/npm/dt/modboard" alt="npm downloads"/></a>
8
7
  <img src="https://img.shields.io/badge/Claude_Code-2.1.295%2B-d97757.svg" alt="Claude Code 2.1.295 or newer"/>
9
8
  </p>
10
9
 
@@ -25,9 +24,9 @@
25
24
 
26
25
  ![Three live Claude Code sessions share one board: frontend and backend race for T-001, frontend hands T-003 off partway, backend picks it up, and the viewer's /board pane follows along](docs/board-live.gif)
27
26
 
28
- Three real Claude Code sessions, recorded live at real speed. Two idle
29
- stretches are cut: the wait before the sessions start, and four seconds while
30
- one session wrapped up.
27
+ Three real Claude Code sessions, recorded live at real speed. Only idle
28
+ stretches are cut: the wait before the sessions start, and two short pauses
29
+ while they wrote their final summaries.
31
30
  `frontend` and `backend` are each told to work the board, and `viewer` has
32
31
  `/board` open. Both go for T-001. `frontend` wins, and `backend` is refused
33
32
  and takes T-002. `frontend` writes part of T-003, then hands it off. The band
@@ -500,11 +499,13 @@ modboard/
500
499
  │ └── plugin.json # the mod's manifest and settings
501
500
  ├── test/ # CLI and store contract tests (npm test)
502
501
  ├── tests/ # mod tests (claude plugin test .)
503
- └── docs/
504
- ├── system.txt .png # how it fits together
505
- ├── blocks.txt .png # how blocks work
506
- ├── board-live.gif # a live recording of three Claude sessions
507
- └── render.mjs # rebuilds every image from its .txt
502
+ ├── docs/
503
+ │ ├── system.txt .png # how it fits together
504
+ │ ├── blocks.txt .png # how blocks work
505
+ │ ├── board-live.gif # a live recording of three Claude sessions
506
+ │ └── render.mjs # rebuilds every image from its .txt
507
+ ├── CHANGELOG.md # what changed in each version
508
+ └── CONTRIBUTING.md # how to contribute
508
509
  ```
509
510
 
510
511
  Each diagram's source is plain text. After editing a `.txt`,
@@ -538,6 +539,9 @@ claude plugin validate . # the mod's manifest and hooks
538
539
 
539
540
  Changing what the board shows? Run both test suites. Adding a storage block
540
541
  or a display block? Start at [Make your own block](#make-your-own-block).
542
+ [CONTRIBUTING.md](CONTRIBUTING.md) has the full checklist, where each kind of
543
+ change goes, and the style the project keeps. [CHANGELOG.md](CHANGELOG.md)
544
+ lists what changed in each version.
541
545
 
542
546
  ---
543
547
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "modboard",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
4
4
  "description": "A task board several coding agents share, through one CLI",
5
5
  "type": "module",
6
6
  "bin": { "board": "bin/board.mjs" },
@@ -11,13 +11,13 @@
11
11
  "./examples/store-memory.mjs": "./examples/store-memory.mjs",
12
12
  "./package.json": "./package.json"
13
13
  },
14
- "files": ["bin/", "lib/", "examples/", "hooks/", "types/", ".claude-plugin/plugin.json", "tsconfig.json", "README.md", "LICENSE"],
14
+ "files": ["bin/", "lib/", "examples/", "hooks/", "types/", ".claude-plugin/plugin.json", "tsconfig.json", "README.md", "CHANGELOG.md", "LICENSE"],
15
15
  "scripts": {
16
16
  "test": "node --test test/*.test.mjs",
17
17
  "test:mod": "claude plugin test .",
18
18
  "prepublishOnly": "npm test"
19
19
  },
20
- "keywords": ["multi-agent", "task-board", "coordination", "claude-code", "codex"],
20
+ "keywords": ["modboard", "claude", "claude-code", "claude-code-plugin", "codex", "opencode", "llm-agents", "coding-agents", "multi-agent", "agent-coordination", "task-board", "kanban", "cli"],
21
21
  "repository": { "type": "git", "url": "git+https://github.com/Magithar/modboard.git" },
22
22
  "engines": { "node": ">=18" },
23
23
  "license": "MIT"