How earendil-works/absurd works
Absurd is a PostgreSQL-backed durable workflow system, with language SDKs for defining and running tasks and Habitat as an operations dashboard. The documented workflow is task dispatch to a queue, worker execution of checkpointed steps, and persistence of state for retries, suspension, and event waits. Habitat’s Go service exposes database-backed APIs and serves a browser UI for tasks, runs, queues, events, and metrics. The SQL implementation and several frontend/API modules are not in the supplied tree or excerpts, so those internals are not expanded here.
Main entry points: App.tsx UI router and layout · server.go HTTP server and routes · main.go Habitat entrypoint · handlers.go Dashboard API
Components 20
Workflow SDKs
- TypeScript SDK
sdks/typescript/src/index.ts - Python SDK
sdks/python/src/absurd_sdk/__init__.py - Go SDK
sdks/go/absurd - Go worker
sdks/go/absurd/worker.go
Habitat service
- Habitat entrypoint
habitat/cmd/habitat/main.go - Runtime configuration
habitat/internal/config/config.go - HTTP server and routes
habitat/internal/server/server.go - Dashboard API
habitat/internal/server/handlers.go - Static asset serving
habitat/internal/web/static.go
Habitat UI
- UI router and layout
habitat/ui/src/App.tsx - Overview view
habitat/ui/src/views/Overview.tsx - Task runs view
habitat/ui/src/views/Tasks.tsx - Task history view
habitat/ui/src/views/TaskRuns.tsx - Queues view
habitat/ui/src/views/Queues.tsx - Event log view
habitat/ui/src/views/EventLog.tsx - API client
habitat/ui/src/lib/api.ts
Other components
- Application developer
- PostgreSQL
- Dashboard user
- Browser UI
Connections 21
- Application developer → TypeScript SDK: defines workflows
README.md - Application developer → Python SDK: installs SDK
README.md - Application developer → Go SDK: installs SDK
README.md - TypeScript SDK → PostgreSQL: queries workflow state
sdks/typescript/src/index.ts - Go worker → PostgreSQL: claims task runs
sdks/go/absurd/worker.go - Go SDK → Go worker: runs workers
- Habitat entrypoint → Runtime configuration: loads arguments
habitat/cmd/habitat/main.go - Habitat entrypoint → HTTP server and routes: starts service
habitat/cmd/habitat/main.go - Habitat entrypoint → PostgreSQL: opens connection
habitat/cmd/habitat/main.go - HTTP server and routes → Dashboard API: routes API requests
habitat/internal/server/server.go - HTTP server and routes → Static asset serving: serves static files
habitat/internal/server/server.go - Dashboard API → PostgreSQL: queries dashboard data
habitat/internal/server/handlers.go - Browser UI → HTTP server and routes: requests dashboard
habitat/internal/server/server.go - Browser UI → UI router and layout: loads interface
README.md - UI router and layout → Overview view: routes to
habitat/ui/src/App.tsx - UI router and layout → Task runs view: routes to
habitat/ui/src/App.tsx - UI router and layout → Task history view: routes to
habitat/ui/src/App.tsx - UI router and layout → Queues view: routes to
habitat/ui/src/App.tsx - UI router and layout → Event log view: routes to
habitat/ui/src/App.tsx - Task runs view → API client: fetches task details
habitat/ui/src/views/Tasks.tsx - API client → Dashboard API: calls dashboard API