modboard 0.0.0-stage → 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.
- package/.claude-plugin/plugin.json +50 -0
- package/CHANGELOG.md +123 -0
- package/LICENSE +21 -0
- package/README.md +549 -2
- package/bin/board.mjs +157 -0
- package/examples/store-memory.mjs +34 -0
- package/hooks/blocks/agents.tsx +8 -0
- package/hooks/blocks/attention.ts +14 -0
- package/hooks/blocks/clock.tsx +10 -0
- package/hooks/blocks/command.tsx +58 -0
- package/hooks/blocks/context.tsx +18 -0
- package/hooks/blocks/effort.tsx +30 -0
- package/hooks/blocks/index.ts +18 -0
- package/hooks/blocks/model.tsx +37 -0
- package/hooks/blocks/summary.tsx +46 -0
- package/hooks/blocks/tasks.tsx +77 -0
- package/hooks/blocks/types.tsx +38 -0
- package/hooks/blocks/usage.tsx +68 -0
- package/hooks/hooks.json +1 -0
- package/hooks/register.tsx +356 -0
- package/lib/contract.mjs +61 -0
- package/lib/engine.mjs +217 -0
- package/lib/load-store.mjs +66 -0
- package/lib/store-file.mjs +118 -0
- package/package.json +22 -4
- package/tsconfig.json +3 -0
- package/types/index.d.ts +23 -0
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "modboard",
|
|
3
|
+
"version": "0.5.1",
|
|
4
|
+
"description": "A task board several agents share: Claude tools, a live pane and lease heartbeats over an agent-neutral CLI",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Magithar",
|
|
7
|
+
"url": "https://github.com/Magithar"
|
|
8
|
+
},
|
|
9
|
+
"repository": "https://github.com/Magithar/modboard",
|
|
10
|
+
"license": "MIT",
|
|
11
|
+
"keywords": [
|
|
12
|
+
"multi-agent",
|
|
13
|
+
"task-board",
|
|
14
|
+
"coordination",
|
|
15
|
+
"codex"
|
|
16
|
+
],
|
|
17
|
+
"types": "./types/index.d.ts",
|
|
18
|
+
"userConfig": {
|
|
19
|
+
"band": {
|
|
20
|
+
"type": "string",
|
|
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"
|
|
24
|
+
},
|
|
25
|
+
"pane": {
|
|
26
|
+
"type": "string",
|
|
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"
|
|
30
|
+
},
|
|
31
|
+
"blocks": {
|
|
32
|
+
"type": "string",
|
|
33
|
+
"title": "Your own blocks",
|
|
34
|
+
"description": "Blocks that show a shell command's first line of output, refreshed every 30 seconds, as JSON: {\"ci\": \"gh run list -L1 --json conclusion -q '.[0].conclusion'\"}. Then name them in Band blocks or Pane blocks.",
|
|
35
|
+
"default": ""
|
|
36
|
+
},
|
|
37
|
+
"models": {
|
|
38
|
+
"type": "string",
|
|
39
|
+
"title": "Models to switch between",
|
|
40
|
+
"description": "The models the model block steps through, in order, as /model takes them.",
|
|
41
|
+
"default": "opus,sonnet,haiku"
|
|
42
|
+
},
|
|
43
|
+
"efforts": {
|
|
44
|
+
"type": "string",
|
|
45
|
+
"title": "Effort levels to switch between",
|
|
46
|
+
"description": "The levels the effort block steps through, in order, as /effort takes them.",
|
|
47
|
+
"default": "low,medium,high,xhigh,max"
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
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/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Magithar
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|