Skip to content

v0.3.2 — Review Workflows, Search & Dashboard Upgrade

Latest
Latest

Choose a tag to compare

View all tags
@lludlow lludlow released this 12 Feb 00:26
v0.3.2
eb0b881
This commit was signed with the committer’s verified signature.
lludlow Larry Ludlow
SSH Key Fingerprint: U0KK80royeWcV1YGbODbesRVkLMeX8bTtd1xFEWJ6oA
Verified
Learn about vigilant mode.

Supersedes v0.3.1 which failed PyPI publish due to filename reuse. Content is identical plus docs updates.

What's New

CLI: Full Review Lifecycle

  • clawctl show <id> — Rich task detail view with message thread, blockers, and metadata all in one place
  • clawctl approve <id> — Approve tasks in review, moving them to done with an optional note
  • clawctl reject <id> — Reject tasks in review with a required reason, returning them to pending
  • clawctl reset <id> — Move done, cancelled, or blocked tasks back to pending (owner/creator guard, --force to override)
  • clawctl search <query> — Full-text search across task subjects, descriptions, and messages
  • clawctl legend — Quick reference for all status symbols and their meanings

CLI: Smarter List Output

  • Blocker IDs in list — Blocked tasks now show which task IDs are blocking them directly in clawctl list output
  • Auto-notify on review — When a task moves to review, the creator automatically receives a notification message

Dashboard: Matching Web UI

  • Approve & Reject buttons — Appear on the detail sheet for tasks in review status
  • Reset button — Appears for done, cancelled, and blocked tasks (amber accent)
  • Search bar — In the header with / keyboard shortcut; results overlay shows matching tasks and messages with clickable navigation
  • Activity feed panel — Slide-up panel with agent filtering (f to toggle)
  • Agent pills — Live fleet status in the header with active/idle/offline indicators
  • Status badges & time-in-status — Visual indicators on every card showing how long a task has been in its current state
  • Blocker links — Blocked task cards show clickable blocker IDs that open the blocking task's detail

Dashboard: UI Polish

  • Task ID spacing — Added proper margin between #N and task title on cards and detail view
  • Keyboard shortcuts — ESC closes search/detail, / focuses search, f toggles feed
  • SSE live updates — Board and feed auto-refresh when tasks change

Database & API

  • approve_task(), reject_task(), reset_task(), search() — New db functions with full activity logging
  • get_task_show() — Rich detail query returning task, messages, and blockers
  • get_board_api() — Now includes blocker_ids and tags fields
  • 4 new API endpoints: /api/task/<id>/approve, /api/task/<id>/reject, /api/task/<id>/reset, /api/search
  • /api/feed and /api/task/<id>/blockers endpoints

Docs: Updated for Agent Workflows

  • SKILL.md rewritten — Full review workflow section (worker vs coordinator roles), recovery patterns (reset instead of raw SQL), decision tree with all new commands, and 7 critical rules for agents (read inbox first, show before working, use review not done, relay messages)
  • README.md updated — New commands in reference table (show, approve, reject, reset, search, legend), dashboard features, review workflow in agent integration example
  • CLAUDE.md updated — Testing section reflects pytest setup (181 tests), server description updated for all mutating endpoints

Testing

  • 181 tests, 86% coverage (up from 112 tests at v0.2.1)
  • New test coverage for all 4 dashboard API endpoints, approve/reject/reset/search db functions, and CLI commands

Upgrade

pip install --upgrade clawctl
# or
uv pip install --upgrade clawctl

Re-running clawctl init is safe — schema uses CREATE TABLE IF NOT EXISTS.

Assets 2
Loading