TemporalDashboard.WorkflowDiagramming.Roslyn 1.0.0.10

TemporalDashboard.WorkflowDiagramming.Roslyn

Roslyn-based extractor that builds Mermaid workflow diagrams from normal Temporal .NET workflow source — no diagramming attributes required.

This package sits beside TemporalDashboard.WorkflowDiagramming: the attribute path (DLL reflection) is unchanged. Both paths share WorkflowDiagramModel and MermaidDiagramRenderer.

Architecture

flowchart LR
  subgraph attributePath [Existing attribute path]
    Dll[Compiled DLL]
    AttrGen[WorkflowDiagramGenerator]
  end
  subgraph roslynPath [Roslyn path]
    Src[C# source / SyntaxTree]
    RoslynExt[RoslynWorkflowDiagramExtractor]
  end
  Model[WorkflowDiagramModel]
  Mermaid[MermaidDiagramRenderer]
  Out[Mermaid string]
  Dll --> AttrGen --> Model
  Src --> RoslynExt --> Model
  Model --> Mermaid --> Out

Extraction pipeline:

flowchart TD
  Start([Parse source]) --> FindWf[Find types with Workflow attribute]
  FindWf --> FindRun[Locate WorkflowRun method]
  FindRun --> Visit[Visit method body]
  Visit --> Acts[Activity / child / timer / wait calls]
  Visit --> Ctrl[if / switch decisions]
  Visit --> Par[Task.WhenAll / WhenAny]
  Acts --> Graph[Build WorkflowDiagramModel]
  Ctrl --> Graph
  Par --> Graph
  Graph --> Render[MermaidDiagramRenderer]
  Render --> Done([Mermaid flowchart])

Usage

dotnet add package TemporalDashboard.WorkflowDiagramming.Roslyn

using TemporalDashboard.WorkflowDiagramming.Roslyn;

var results = RoslynWorkflowDiagramExtractor.ExtractFromSource(csharpSource);

foreach (var result in results)
{
    Console.WriteLine(result.WorkflowTypeName);
    Console.WriteLine(result.Mermaid);
    foreach (var note in result.Diagnostics)
        Console.WriteLine($"  note: {note}");
}

Also available:

• ExtractFromSources(IEnumerable<(string path, string text)> sources)
• ExtractFromCompilation(Compilation compilation)

V1 patterns recognized

Limitations (v1)

• No cycles for loops (body is approximated sequentially)
• No deep cross-class helper expansion
• Dynamic activity names and attribute enrichment are out of scope
• Not wired into Api/Web upload yet — library + tests only

Relation to attributes

Use attributes when you need curated diagrams; use Roslyn when you want discovery from existing workflow methods.

Roadmap

• Optional attribute overrides merged onto a Roslyn skeleton
• Api/Web source upload path
• History overlay (runtime paths vs definition)

Build-time package

For automatic generation on dotnet build (no API calls), use TemporalDashboard.WorkflowDiagramming.Roslyn.Build:

dotnet add package TemporalDashboard.WorkflowDiagramming.Roslyn.Build
# or: ./scripts/install-workflow-diagramming-roslyn-build.sh

Tests

dotnet test tests/TemporalDashboard.WorkflowDiagramming.Roslyn.Tests/TemporalDashboard.WorkflowDiagramming.Roslyn.Tests.csproj