# Visual Workflow Editor (DAG-Based)

## Module
Web

## Status
VERIFIED

## Description
Visual DAG-based workflow editor for release workflows with a drag/drop step palette, editable step configuration panel, dependency wiring on canvas connectors, and a YAML-mode representation.

## Implementation Details
- **Feature directory**: `src/Web/StellaOps.Web/src/app/features/release-jobengine/workflows/`
- **Routes**:
  - `src/Web/StellaOps.Web/src/app/features/release-jobengine/workflows/workflows.routes.ts`
  - mounted from `src/Web/StellaOps.Web/src/app/features/release-jobengine/dashboard/dashboard.routes.ts`
- **Components**:
  - `workflow-list` (`src/Web/StellaOps.Web/src/app/features/release-jobengine/workflows/workflow-list/workflow-list.component.ts`)
  - `workflow-editor` (`src/Web/StellaOps.Web/src/app/features/release-jobengine/workflows/workflow-editor/workflow-editor.component.ts`)
- **Store/API models**:
  - `src/Web/StellaOps.Web/src/app/features/release-jobengine/workflows/workflow.store.ts`
  - `src/Web/StellaOps.Web/src/app/core/api/workflow.client.ts`
  - `src/Web/StellaOps.Web/src/app/core/api/workflow.models.ts`
- **Behavior coverage**:
  - `src/Web/StellaOps.Web/src/tests/release_jobengine/visual-workflow-editor.behavior.spec.ts`
- **Source**: `SPRINT_20260110_111_004_FE_workflow_editor`

## E2E Test Plan
- **Setup**:
  - [ ] Log in with a user that has appropriate permissions
  - [ ] Navigate to `/release-jobengine/workflows/:id`
  - [ ] Ensure workflow fixture data exists (mock or backend-provided)
- **Core verification**:
  - [ ] Verify palette/canvas/config-panel surfaces load
  - [ ] Verify YAML mode toggle renders workflow YAML representation
  - [ ] Verify dependency creation rejects self-links and cycle-producing links
  - [ ] Verify valid dependency additions persist and can be removed
- **Edge cases**:
  - [ ] Verify graceful handling when workflow API is unavailable (error state)
  - [ ] Verify responsive layout at different viewport sizes
  - [ ] Verify accessibility (keyboard navigation, labels, ARIA attributes)

## Verification
- Run ID: `docs/qa/feature-checks/runs/web/visual-workflow-editor/run-001/`
- Date (UTC): 2026-02-11
- Tier 0: PASS (active route/component/store paths verified; stale dossier reference corrected from `workflow-visualization` to `release-jobengine/workflows`).
- Tier 1: PASS (`npm run test` focused + release-orchestrator regression include suite passed; `npm run build` passed with baseline workspace warnings only).
- Tier 2: PASS (workflow editor behavior harness verified palette/canvas/config rendering, YAML mode interaction, dependency validation semantics, and deterministic step-id generation).