Skip to content

Pivot to workflow management platform#398

Open
Brad-Edwards wants to merge 2 commits intomainfrom
claude/workflow-management-platform-1t1D2
Open

Pivot to workflow management platform#398
Brad-Edwards wants to merge 2 commits intomainfrom
claude/workflow-management-platform-1t1D2

Conversation

@Brad-Edwards
Copy link
Copy Markdown
Contributor

Summary

Complete domain pivot from requirements/traceability management to a full workflow orchestration platform (ADR-019), replacing all requirements domain code with workflow management primitives while preserving the architectural bones.

  • New domain model: Workspace, Workflow, WorkflowNode, WorkflowEdge, Execution, TaskExecution, Trigger, Credential, Variable (9 entities, 4 enums, 9 repositories, 6 services)
  • Execution engine: Shell, HTTP, Docker task executors with DAG topological traversal, event-driven async execution, cron scheduler, webhook triggers
  • Full REST API: 50+ endpoints covering workflows, nodes, edges, executions, triggers, credentials, variables, and incoming webhooks
  • Frontend rewrite: React workflow builder with Cytoscape DAG visualization, execution monitoring with live refresh, settings management (triggers/credentials/variables)
  • MCP server: 30+ workflow management tools replacing requirements tools
  • V017 migration: Drops old requirements schema, creates workflow tables, renames project→workspace

Architecture preserved

  • Clean layers: api/ → domain/ ← infrastructure/ (ArchUnit enforced)
  • PostgreSQL + Apache AGE graph database
  • Spring Boot 3.4 / Java 21 / React 19 / Vite 6 / TypeScript 5
  • Flyway migrations, JML state machine contracts
  • Docker Compose local deployment

Key design decisions

  • Event-driven execution: Domain publishes ExecutionRequestedEvent, infrastructure engine listens and runs async — maintains clean architecture boundary
  • DAG-first: Workflows are validated DAGs (Kahn's algorithm cycle detection) before publishing
  • Triple interface: Every operation available via REST API, MCP tools, and GUI
  • Simple by default: No enterprise RBAC, no complex multi-tenancy — just workspaces

Test plan

  • make check passes (compilation + unit tests + static analysis)
  • make integration passes with Testcontainers PostgreSQL
  • V017 migration applies cleanly on fresh and existing databases
  • Workflow CRUD via API (create workspace → create workflow → add nodes → add edges → validate → publish)
  • Execution lifecycle (execute workflow → monitor tasks → verify completion)
  • Webhook trigger fires execution
  • Frontend loads and renders workflow list, detail, and execution pages
  • MCP tools work from Claude Code

https://claude.ai/code/session_0191KSxW9gLHZPWyKJE6DsvH

claude added 2 commits March 24, 2026 07:48
…ent platform

Complete domain pivot from requirements/traceability management to a full workflow
orchestration platform (ADR-019). Replaces all requirements domain code with workflow
management primitives while preserving the architectural bones.

Backend:
- New domain model: Workspace, Workflow, WorkflowNode, WorkflowEdge, Execution,
  TaskExecution, Trigger, Credential, Variable
- State machines: WorkflowStatus (DRAFT→ACTIVE→PAUSED→ARCHIVED),
  ExecutionStatus (PENDING→QUEUED→RUNNING→SUCCESS/FAILED/CANCELLED/TIMED_OUT)
- Execution engine: Shell, HTTP, Docker task executors with DAG traversal
- Event-driven execution: domain publishes ExecutionRequestedEvent,
  infrastructure listens and runs async
- Cron scheduler and webhook trigger support
- V017 Flyway migration: drops old schema, creates workflow tables
- Full REST API: workflows, nodes, edges, executions, triggers,
  credentials, variables, webhooks
- ArchUnit compliance maintained (api→domain←infrastructure)

Frontend:
- Complete React UI rewrite: workflow list, visual DAG editor (Cytoscape),
  execution monitoring with live refresh, settings page (triggers/credentials/variables)
- Workspace context replaces project context
- New hooks: useWorkflows, useExecutions, useWorkspaces

MCP:
- 30+ workflow management tools replacing requirements tools
- Covers full CRUD for all entities plus execute/cancel/retry

Docs:
- ADR-019 documenting the pivot decision
- Updated README, API.md, ARCHITECTURE.md, CLAUDE.md, CHANGELOG.md

https://claude.ai/code/session_0191KSxW9gLHZPWyKJE6DsvH
Refinements to all frontend pages from the workflow platform rewrite:
- Dashboard: better stats display with workflow/execution counts
- Workflow detail: improved graph visualization and node/edge management
- Execution detail: better log display and action buttons
- Settings: enhanced credentials and variables management
- Layout: cleaner navigation and workspace context handling

https://claude.ai/code/session_0191KSxW9gLHZPWyKJE6DsvH
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants