Volnux Visualization Roadmap (V1.0) - nshaibu/volnux GitHub Wiki

🗺️ Volnux Visualization Roadmap (V1.0)

Phase 1: Semantic Styling

The goal here is to make the graph "speak" through colors and shapes so the logic is obvious at a glance.

  • Edge Badging: Instead of raw numbers, wrap descriptors (0, 1, 2) in small "label" boxes.

  • Logic: Success (1) = Green, Failure (0) = Red, Custom (2+) = Blue/Orange.

  • Node Hierarchy: Use rankdir=TB (Top to Bottom) but ensure that parallel branches (|| operator) are aligned horizontally using Graphviz constraints=false.

  • Status Indicators: Prepare the system to change node colors based on runtime state (e.g., Light Gray = Pending, Yellow = Running, Green = Success, Red = Failed).

Phase 2: Grouping & Scope (The "Sub-graph" Update)

Pointy-Lang uses {} for grouped execution. The visualizer must reflect this.

  • Cluster Subgraphs: Use Graphviz subgraph cluster_n to draw boxes around events that are grouped.
  • Executor Labeling: Inside each cluster box, add a label indicating the Executor Type (e.g., "Cluster 1: ProcessPoolExecutor").
  • Namespace Branding: Add small icons or prefixes (e.g., a GitHub logo or gh::) to nodes that are pulled from external repositories.

Phase 3: The "Live" Dashboard (The Big Goal)

  • Export to DOT/JSON: Ensure the engine can export the graph state to a JSON format that a frontend (like React with react-flow) can consume.
  • Interactive Nodes: Allow users to click a node in the visualizer to see its Logs, Retries, and Execution Time.
  • Live Animation: Animate the edges to show data "flowing" from one node to another during execution.