⚖️ Veritas Kanban v3.0.0 — Workflow Engine
VK is now a full-fledged AI orchestration platform. The workflow engine transforms VK from a task board into a production pipeline for multi-agent work.
🚀 What's New
Core Workflow Engine (Phase 1)
- YAML-based workflow definitions with visual execution
- 9 API endpoints for workflow CRUD + run management
- Zod validation, audit logging, RBAC authorization
Run State Management (Phase 2)
- Persistent run state (survives server restarts)
- Retry with exponential backoff
- Progress file tracking per step
- Session modes (fresh/reuse)
Frontend + Real-Time Updates (Phase 3)
- WorkflowsPage, WorkflowRunView, WorkflowRunList, WorkflowSection
- Full polling→WebSocket refactor: 13 hooks/components now WS-primary
- ~75% reduction in API calls when WebSocket connected
- Real-time counters, activity, metrics, agent status
Advanced Orchestration (Phase 4)
- Loop steps: Iterate with progress tracking (max 1,000 safety)
- Gate steps: Approval/condition/timeout with human escalation
- Parallel steps: Fan-out/fan-in (max 50 concurrent, Promise.allSettled)
- Enhanced acceptance criteria (regex, JSON path, substring)
Workflow Dashboard (#114)
- Summary cards, active runs, history, per-workflow health metrics
- WebSocket live updates
Role-Based Tool Policies (#110)
- 5 default roles: planner, developer, reviewer, tester, deployer
- Full CRUD API for custom roles
- Enforced during workflow step execution
Fresh Sessions Per Step (#111)
- Isolated sessions prevent context bleed
- Context modes: minimal, full, custom
- Cleanup modes: delete, keep
🔒 Security
- ReDoS protection (pattern length limits + execution timeouts)
- Expression injection prevention (tokenized evaluation)
- Parallel DoS limits (50 concurrent sub-steps)
- Gate approval validation (type-checked)
📊 By the Numbers
- 8 issues closed (#107-#114)
- ~22,500 lines of code + documentation
- 4 phases delivered in one session
- 37 commits reviewed
- Zero blocking issues at final review
- 10/10/10/10 across all review dimensions
📚 Documentation
- Workflow User Guide — 33KB comprehensive guide
- API Reference — 32KB complete endpoint docs
- Architecture Spec — Full technical design
Full Changelog: https://github.com/BradGroux/veritas-kanban/blob/main/CHANGELOG.md