How johnreginald/donewhen works
DoneWhen is a self-hosted, multi-workspace tracker for work built by AI agents. People and agents create and update tickets; the server persists workspace-scoped work and enforces the done-when checklist gate before review or completion. Humans review tickets in the Inbox, approve or send them back, and can revisit the specs, documents, diagrams, and activity later. The product also provides boards, filters and saved views, MCP tools, Claude Code integration, live updates, and Web Push. Source excerpts show the server, persistence, event, and transport layers; some feature links rely on README documentation.
Main entry points: store.js Client state · server.go HTTP server · store.go Workspace persistence · service.go Domain service
Components 23
Browser application
- PWA interface
web/src/routes/+layout.svelte - Client state
web/src/lib/store.js - REST client
web/src/lib/api.js - Board and views
web/src/routes/board/+page.svelte - Ticket details
web/src/routes/issue/[key]/+page.svelte - Review inbox
web/src/routes/inbox/+page.svelte - Docs and diagrams
web/src/routes/artifacts/+page.svelte
HTTP and agent access
- Claude Code menu
plugin/hooks/register.tsx - HTTP server
internal/api/server.go - REST handlers
internal/api - Identity and access
internal/auth/middleware.go - MCP tools
internal/mcp/mcp.go
Workflow domain
- Domain service
internal/service/service.go - Done-when gate
internal/store/gate.go - Workflow features
internal/store
Persistence
- Workspace persistence
internal/store/store.go - PostgreSQL
Live notifications
- Event bus
internal/events/events.go - SSE stream
internal/sse/sse.go - Web Push
internal/push/push.go - Push service
Other components
- Human user
- AI agent
Connections 25
- Human user → PWA interface: uses
README.md - PWA interface → Client state: interacts
web/src/routes/+layout.svelte - Client state → REST client: calls
web/src/lib/store.js - Client state → Board and views: feeds
- Client state → Ticket details: feeds
- Client state → Review inbox: feeds
- Client state → Docs and diagrams: feeds
- AI agent → MCP tools: calls tools
README.md - AI agent → Claude Code menu: uses
README.md - Claude Code menu → HTTP server: calls REST
README.md - REST client → HTTP server: calls REST
- HTTP server → REST handlers: routes requests
internal/api/server.go - HTTP server → Identity and access: configures
internal/api/server.go - HTTP server → MCP tools: mounts endpoint
- REST handlers → Domain service: mutates issues
- MCP tools → Domain service: mutates issues
internal/mcp/mcp.go - Domain service → Workspace persistence: persists changes
internal/service/service.go - Domain service → Event bus: publishes events
internal/service/service.go - Workspace persistence → Done-when gate: checks moves
- Workspace persistence → PostgreSQL: reads and writes
internal/store/store.go - Workspace persistence → Workflow features: supports features
- Event bus → SSE stream: streams events
internal/sse/sse.go - Event bus → Web Push: notifies subscriber
internal/push/push.go - Web Push → Push service: sends notifications
internal/push/push.go - SSE stream → Client state: updates live state