boundary.workflow.shell.http — org.boundary-app/boundary-workflow 1.0.0-beta-1

HTTP API routes and admin web UI handlers for workflow management.

API Endpoints (canonical): GET /api/v1/workflow/instances/:id — current state + metadata GET /api/v1/workflow/instances/:id/audit — full audit log POST /api/v1/workflow/instances — start a new workflow instance POST /api/v1/workflow/instances/:id/transition — execute a transition

Compatibility: /api/workflow/* redirects to /api/v1/workflow/* via versioning middleware.

Admin Web UI (mounted under /web/admin): GET /workflows — list all workflow instances GET /workflows/:id — instance detail with state viz + audit trail

All routes require authentication (actor extracted from ring request). Caller is responsible for mounting under an authenticated router.

handle-get-audit-log clj

(handle-get-audit-log engine request)

GET /api/v1/workflow/instances/:id/audit

handle-get-instance clj

(handle-get-instance engine request)

GET /api/v1/workflow/instances/:id

handle-get-instance-web clj

(handle-get-instance-web store registry request)

GET /workflows/:id — render the workflow instance detail page.

handle-list-instances-web clj

(handle-list-instances-web store request)

GET /workflows — render the workflow instances list page.

handle-start-workflow clj

(handle-start-workflow engine request)

POST /api/v1/workflow/instances

handle-transition clj

(handle-transition engine request)

POST /api/v1/workflow/instances/:id/transition

workflow-routes clj

(workflow-routes engine)

Return normalized route definitions for the workflow API.

Args: engine - WorkflowService (IWorkflowEngine)

Returns: Vector of normalized route maps (will be mounted under /api/v1 by versioning middleware)

workflow-web-routes clj

(workflow-web-routes store registry user-service)

Return normalized web route definitions for the workflow admin UI.

Routes are mounted under /web/admin by the HTTP handler: GET /web/admin/workflows — list all workflow instances GET /web/admin/workflows/:id — instance detail + audit trail

Args: store - IWorkflowStore registry - IWorkflowRegistry user-service - IUserService (for authentication middleware)

Returns: Vector of normalized route maps