Skip to content

v0.8.1 - feat: add JSON pad status and selective task-opener relay wakes

Choose a tag to compare

@github-actions github-actions released this 14 Aug 09:41
· 24 commits to main since this release

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 opened wake selector for task events on tasks created by the current agent.
  • Automatic relay registration now uses me,mine,opened:
    • me: relevant conversation
    • mine: tasks assigned to the agent
    • opened: tasks dispatched by the agent
  • Ignore task traffic opened by unrelated coordinators.
  • Fall back to me,mine when connecting to an older running relay, with guidance to restart scratchpad exec to
    enable opened.
  • Update CLI help, MCP schemas, design documentation, and bundled skill guidance.

Compatibility

  • No breaking CLI changes.
  • Text output remains the default.
  • Omitting wake_for retains the existing any behavior.
  • 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.
  • 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