Skip to content

Commit 1b82b9c

Browse files
Nick Ficanoclaude
Nick Ficano
and
claude
committed
docs(diagrams): replace ASCII span trees with Graphviz
Adds paired light/dark .dot sources and rendered SVGs for the delegation span tree, observability delegation cascade, and per-job span hierarchy. Embedded via <picture> for prefers-color-scheme switching. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 0cfe8b9 commit 1b82b9c

15 files changed

Lines changed: 696 additions & 21 deletions

‎diagrams/delegation-span-tree-dark.dot‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
// ARCP delegation span tree (dark)
2+
digraph DelegationSpanTree {
3+
rankdir=TB; bgcolor="transparent"; compound=true; fontname="Helvetica";
4+
splines=ortho; nodesep=0.32; ranksep=0.45; pad="0.35,0.25";
5+
6+
node [shape=box, style="rounded,filled", fillcolor="#334155", color="#475569",
7+
fontname="Helvetica", fontsize=11, fontcolor="#F1F5F9",
8+
margin="0.22,0.11", penwidth=1.0];
9+
edge [fontname="Helvetica", fontsize=9, fontcolor="#94A3B8", color="#64748B",
10+
penwidth=1.1, arrowsize=0.75, arrowhead=vee];
11+
12+
Parent [
13+
label=<<FONT POINT-SIZE="12"><B>orchestrator</B></FONT><BR/><FONT POINT-SIZE="9" COLOR="#CBD5E1">parent span</FONT>>,
14+
fillcolor="#3B82F6", color="#2563EB", fontcolor="white", penwidth=1.4
15+
];
16+
17+
Pdf [label=<<FONT POINT-SIZE="11">pdf-renderer</FONT><BR/><FONT POINT-SIZE="9" COLOR="#94A3B8">child span</FONT>>];
18+
Sum [label=<<FONT POINT-SIZE="11">summarizer</FONT><BR/><FONT POINT-SIZE="9" COLOR="#94A3B8">child span</FONT>>];
19+
20+
edge [color="#94A3B8", penwidth=1.2];
21+
Parent -> Pdf;
22+
Parent -> Sum;
23+
24+
Pdf -> Sum [style=invis];
25+
{ rank=same; Pdf; Sum; }
26+
}

‎diagrams/delegation-span-tree-dark.svg‎

Lines changed: 46 additions & 0 deletions
Loading

‎diagrams/delegation-span-tree-light.dot‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
// ARCP delegation span tree (light)
2+
// orchestrator parent span with delegated child agent spans.
3+
digraph DelegationSpanTree {
4+
rankdir=TB; bgcolor="transparent"; compound=true; fontname="Helvetica";
5+
splines=ortho; nodesep=0.32; ranksep=0.45; pad="0.35,0.25";
6+
7+
node [shape=box, style="rounded,filled", fillcolor="white", color="#CBD5E1",
8+
fontname="Helvetica", fontsize=11, fontcolor="#1F2937",
9+
margin="0.22,0.11", penwidth=1.0];
10+
edge [fontname="Helvetica", fontsize=9, fontcolor="#64748B", color="#94A3B8",
11+
penwidth=1.1, arrowsize=0.75, arrowhead=vee];
12+
13+
Parent [
14+
label=<<FONT POINT-SIZE="12"><B>orchestrator</B></FONT><BR/><FONT POINT-SIZE="9" COLOR="#CBD5E1">parent span</FONT>>,
15+
fillcolor="#3B82F6", color="#2563EB", fontcolor="white", penwidth=1.4
16+
];
17+
18+
Pdf [label=<<FONT POINT-SIZE="11">pdf-renderer</FONT><BR/><FONT POINT-SIZE="9" COLOR="#94A3B8">child span</FONT>>];
19+
Sum [label=<<FONT POINT-SIZE="11">summarizer</FONT><BR/><FONT POINT-SIZE="9" COLOR="#94A3B8">child span</FONT>>];
20+
21+
edge [color="#64748B", penwidth=1.2];
22+
Parent -> Pdf;
23+
Parent -> Sum;
24+
25+
Pdf -> Sum [style=invis];
26+
{ rank=same; Pdf; Sum; }
27+
}

‎diagrams/delegation-span-tree-light.svg‎

Lines changed: 46 additions & 0 deletions
Loading

‎diagrams/observability-delegation-dark.dot‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
// ARCP observability — delegation cascade span tree (dark)
2+
digraph ObservabilityDelegation {
3+
rankdir=TB; bgcolor="transparent"; compound=true; fontname="Helvetica";
4+
splines=ortho; nodesep=0.32; ranksep=0.45; pad="0.35,0.25";
5+
6+
node [shape=box, style="rounded,filled", fillcolor="#334155", color="#475569",
7+
fontname="Helvetica", fontsize=11, fontcolor="#F1F5F9",
8+
margin="0.22,0.11", penwidth=1.0];
9+
edge [fontname="Helvetica", fontsize=9, fontcolor="#94A3B8", color="#64748B",
10+
penwidth=1.1, arrowsize=0.75, arrowhead=vee];
11+
12+
subgraph cluster_client {
13+
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>client</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
14+
style="rounded,filled";
15+
fillcolor="#0F172A"; color="#334155";
16+
fontname="Helvetica"; fontcolor="#94A3B8";
17+
margin=14; labeljust=l; penwidth=1.0;
18+
19+
Submit [
20+
label=<<FONT POINT-SIZE="12"><B>submit</B></FONT>>,
21+
fillcolor="#3B82F6", color="#2563EB", fontcolor="white", penwidth=1.4
22+
];
23+
}
24+
25+
subgraph cluster_runtime {
26+
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>runtime</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
27+
style="rounded,filled";
28+
fillcolor="#1E293B"; color="#334155";
29+
fontname="Helvetica"; fontcolor="#94A3B8";
30+
margin=14; labeljust=l; penwidth=1.0;
31+
32+
Orchestrator [
33+
label=<<FONT POINT-SIZE="12"><B>job.run orchestrator</B></FONT>>,
34+
fillcolor="#F59E0B", color="#D97706", fontcolor="white", penwidth=1.4
35+
];
36+
37+
Pdf [label="job.run pdf-renderer"];
38+
Sum [label="job.run summarizer"];
39+
40+
Pdf -> Sum [style=invis];
41+
{ rank=same; Pdf; Sum; }
42+
}
43+
44+
edge [color="#94A3B8", penwidth=1.2];
45+
Submit -> Orchestrator [label="trace_id"];
46+
Orchestrator -> Pdf;
47+
Orchestrator -> Sum;
48+
}

‎diagrams/observability-delegation-dark.svg‎

Lines changed: 66 additions & 0 deletions
Loading

‎diagrams/observability-delegation-light.dot‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
// ARCP observability — delegation cascade span tree (light)
2+
// Client "submit" span pairs with runtime orchestrator span, whose child spans
3+
// are the delegated agent jobs.
4+
digraph ObservabilityDelegation {
5+
rankdir=TB; bgcolor="transparent"; compound=true; fontname="Helvetica";
6+
splines=ortho; nodesep=0.32; ranksep=0.45; pad="0.35,0.25";
7+
8+
node [shape=box, style="rounded,filled", fillcolor="white", color="#CBD5E1",
9+
fontname="Helvetica", fontsize=11, fontcolor="#1F2937",
10+
margin="0.22,0.11", penwidth=1.0];
11+
edge [fontname="Helvetica", fontsize=9, fontcolor="#64748B", color="#94A3B8",
12+
penwidth=1.1, arrowsize=0.75, arrowhead=vee];
13+
14+
subgraph cluster_client {
15+
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>client</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
16+
style="rounded,filled";
17+
fillcolor="#F1F5F9"; color="#E2E8F0";
18+
fontname="Helvetica"; fontcolor="#475569";
19+
margin=14; labeljust=l; penwidth=1.0;
20+
21+
Submit [
22+
label=<<FONT POINT-SIZE="12"><B>submit</B></FONT>>,
23+
fillcolor="#3B82F6", color="#2563EB", fontcolor="white", penwidth=1.4
24+
];
25+
}
26+
27+
subgraph cluster_runtime {
28+
label=<<TABLE BORDER="0" CELLBORDER="0" CELLPADDING="0" CELLSPACING="0"><TR><TD COLSPAN="3" HEIGHT="8"></TD></TR><TR><TD WIDTH="8"></TD><TD><FONT POINT-SIZE="12"><B>runtime</B></FONT></TD><TD WIDTH="8"></TD></TR></TABLE>>;
29+
style="rounded,filled";
30+
fillcolor="#F8FAFC"; color="#E2E8F0";
31+
fontname="Helvetica"; fontcolor="#475569";
32+
margin=14; labeljust=l; penwidth=1.0;
33+
34+
Orchestrator [
35+
label=<<FONT POINT-SIZE="12"><B>job.run orchestrator</B></FONT>>,
36+
fillcolor="#F59E0B", color="#D97706", fontcolor="white", penwidth=1.4
37+
];
38+
39+
Pdf [label="job.run pdf-renderer"];
40+
Sum [label="job.run summarizer"];
41+
42+
Pdf -> Sum [style=invis];
43+
{ rank=same; Pdf; Sum; }
44+
}
45+
46+
edge [color="#64748B", penwidth=1.2];
47+
Submit -> Orchestrator [label="trace_id"];
48+
Orchestrator -> Pdf;
49+
Orchestrator -> Sum;
50+
}

0 commit comments

Comments
 (0)