Repository navigation
v0.8.1 - feat: add JSON pad status and selective task-opener relay wakes
Summary
This release improves automation and multi-agent coordination:
- Adds machine-readable JSON output to
scratchpad pad get. - Wakes task dispatchers when work they opened changes.
- Keeps unrelated task traffic quiet.
Changes
JSON pad status
- Add
scratchpad pad get <ref> --json. - Return one structured JSON document containing:
- pad metadata and protection state
- authors and section count
- structured turn state
- optional author inbox
- body-free section table of contents
- Preserve the existing text output and protected-pad authorization behavior.
Selective relay wakes
- Add the
openedwake selector for task events on tasks created by the current agent. - Automatic relay registration now uses
me,mine,opened:me: relevant conversationmine: tasks assigned to the agentopened: tasks dispatched by the agent
- Ignore task traffic opened by unrelated coordinators.
- Fall back to
me,minewhen connecting to an older running relay, with guidance to restartscratchpad execto
enableopened. - Update CLI help, MCP schemas, design documentation, and bundled skill guidance.
Compatibility
- No breaking CLI changes.
- Text output remains the default.
- Omitting
wake_forretains the existinganybehavior. - New clients remain usable with older relay processes through selector fallback.
Validation
make check- Go vet and test suite passed.
- All 24 Web UI tests passed.
- Local zellij E2E test with three persistent agents on pad
default-r54gdq:- Relevant task traffic woke the dispatcher relay:
nudges 0 → 1. - Unrelated task traffic left the dispatcher unchanged:
nudges 1 → 1. - All test tasks completed successfully.
- Relevant task traffic woke the dispatcher relay:
- E2E limitation: one local pad, three agents, and one positive/negative control cycle.
Changelog
Features
- ec12c04 [main] feat(cli): add JSON output to pad get
- 3b9f05f [main] feat(relay): wake task openers selectively
Documentation
- 00a5c63 [main] docs(skill): use English trigger examples
Install (one-liner):
curl -fsSL https://madnh.github.io/scratchpad/install.sh | sh