<mxfile host="app.diagrams.net" modified="2026-08-28T00:00:00.000Z" agent="Codex" version="24.7.17" type="device">
  <diagram id="vtune-architecture" name="vTune Architecture">
    <mxGraphModel dx="1800" dy="1100" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1920" pageHeight="1080" math="0" shadow="0">
      <root>
        <mxCell id="0"/>
        <mxCell id="1" parent="0"/>

        <mxCell id="title" value="vTune Architecture" style="text;html=1;align=center;verticalAlign=middle;fontSize=28;fontStyle=1;fontColor=#172B4D;" vertex="1" parent="1">
          <mxGeometry x="640" y="20" width="640" height="50" as="geometry"/>
        </mxCell>
        <mxCell id="subtitle" value="Managers coordinate workflows · Workers perform focused operations · Adapters isolate external tools" style="text;html=1;align=center;verticalAlign=middle;fontSize=15;fontColor=#5E6C84;" vertex="1" parent="1">
          <mxGeometry x="450" y="65" width="1020" height="35" as="geometry"/>
        </mxCell>

        <mxCell id="config" value="User configuration&#xa;config.yaml" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E3F2FD;strokeColor=#1976D2;strokeWidth=2;fontSize=16;fontStyle=1;" vertex="1" parent="1">
          <mxGeometry x="820" y="115" width="280" height="70" as="geometry"/>
        </mxCell>
        <mxCell id="parser" value="Parser + Validator&#xa;produces typed, resolved config" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E8EAF6;strokeColor=#3F51B5;strokeWidth=2;fontSize=15;" vertex="1" parent="1">
          <mxGeometry x="805" y="220" width="310" height="70" as="geometry"/>
        </mxCell>
        <mxCell id="builder" value="Application Builder&#xa;selects and connects managers, workers, and adapters" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E8EAF6;strokeColor=#3F51B5;strokeWidth=2;fontSize=15;" vertex="1" parent="1">
          <mxGeometry x="760" y="325" width="400" height="80" as="geometry"/>
        </mxCell>
        <mxCell id="orchestrator" value="Main Run Orchestrator&#xa;owns the run loop and retry decisions" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#DDEBFF;strokeColor=#0D47A1;strokeWidth=3;fontSize=18;fontStyle=1;" vertex="1" parent="1">
          <mxGeometry x="735" y="455" width="450" height="90" as="geometry"/>
        </mxCell>

        <mxCell id="searchManager" value="Search Manager&#xa;Grid · Random · TPE&#xa;suggests configurations" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#DDEBFF;strokeColor=#0D47A1;strokeWidth=2;fontSize=15;fontStyle=1;" vertex="1" parent="1">
          <mxGeometry x="175" y="475" width="280" height="100" as="geometry"/>
        </mxCell>
        <mxCell id="scheduler" value="Trial Scheduler&#xa;queues trials and starts TrialManagers&#xa;concurrency: 1 now, N later" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#DDEBFF;strokeColor=#0D47A1;strokeWidth=2;fontSize=15;fontStyle=1;" vertex="1" parent="1">
          <mxGeometry x="535" y="600" width="340" height="105" as="geometry"/>
        </mxCell>
        <mxCell id="resultsManager" value="Results Manager&#xa;persists · scores · ranks · compares" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#DDEBFF;strokeColor=#0D47A1;strokeWidth=2;fontSize=15;fontStyle=1;" vertex="1" parent="1">
          <mxGeometry x="1465" y="475" width="290" height="100" as="geometry"/>
        </mxCell>

        <mxCell id="trialContainer" value="TrialManager  (one per active attempt)&#xa;Coordinates the full trial lifecycle, state transitions, timeouts, and cleanup" style="swimlane;html=1;rounded=1;startSize=62;horizontal=1;fillColor=#FFF7E6;swimlaneFillColor=#FFF7E6;strokeColor=#EF6C00;strokeWidth=3;fontSize=17;fontStyle=1;align=center;" vertex="1" parent="1">
          <mxGeometry x="235" y="755" width="1335" height="250" as="geometry"/>
        </mxCell>

        <mxCell id="configWorker" value="Configuration Builder&#xa;Worker" style="rounded=1;whiteSpace=wrap;html=1;dashed=1;dashPattern=6 4;fillColor=#FFF3E0;strokeColor=#EF6C00;strokeWidth=2;fontSize=14;fontStyle=1;" vertex="1" parent="trialContainer">
          <mxGeometry x="35" y="90" width="190" height="72" as="geometry"/>
        </mxCell>
        <mxCell id="vllmWorker" value="vLLM Runner&#xa;Worker" style="rounded=1;whiteSpace=wrap;html=1;dashed=1;dashPattern=6 4;fillColor=#FFF3E0;strokeColor=#EF6C00;strokeWidth=2;fontSize=14;fontStyle=1;" vertex="1" parent="trialContainer">
          <mxGeometry x="280" y="90" width="180" height="72" as="geometry"/>
        </mxCell>
        <mxCell id="readinessWorker" value="Readiness&#xa;Worker" style="rounded=1;whiteSpace=wrap;html=1;dashed=1;dashPattern=6 4;fillColor=#FFF3E0;strokeColor=#EF6C00;strokeWidth=2;fontSize=14;fontStyle=1;" vertex="1" parent="trialContainer">
          <mxGeometry x="515" y="90" width="165" height="72" as="geometry"/>
        </mxCell>
        <mxCell id="benchmarkWorker" value="Benchmark Runner&#xa;Worker" style="rounded=1;whiteSpace=wrap;html=1;dashed=1;dashPattern=6 4;fillColor=#FFF3E0;strokeColor=#EF6C00;strokeWidth=2;fontSize=14;fontStyle=1;" vertex="1" parent="trialContainer">
          <mxGeometry x="735" y="90" width="190" height="72" as="geometry"/>
        </mxCell>
        <mxCell id="verificationWorker" value="Result Verification&#xa;Worker" style="rounded=1;whiteSpace=wrap;html=1;dashed=1;dashPattern=6 4;fillColor=#FFF3E0;strokeColor=#EF6C00;strokeWidth=2;fontSize=14;fontStyle=1;" vertex="1" parent="trialContainer">
          <mxGeometry x="980" y="90" width="185" height="72" as="geometry"/>
        </mxCell>
        <mxCell id="resultWorker" value="Result Collector&#xa;Worker" style="rounded=1;whiteSpace=wrap;html=1;dashed=1;dashPattern=6 4;fillColor=#FFF3E0;strokeColor=#EF6C00;strokeWidth=2;fontSize=14;fontStyle=1;" vertex="1" parent="trialContainer">
          <mxGeometry x="1195" y="90" width="105" height="72" as="geometry"/>
        </mxCell>

        <mxCell id="vllmAdapter" value="Local vLLM adapter&#xa;owned subprocess + health endpoint" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ECEFF1;strokeColor=#546E7A;strokeWidth=2;fontSize=13;" vertex="1" parent="1">
          <mxGeometry x="465" y="1045" width="250" height="70" as="geometry"/>
        </mxCell>
        <mxCell id="benchmarkAdapter" value="Benchmark adapters&#xa;GuideLLM · vLLM Bench Serve" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#ECEFF1;strokeColor=#546E7A;strokeWidth=2;fontSize=13;" vertex="1" parent="1">
          <mxGeometry x="940" y="1045" width="270" height="70" as="geometry"/>
        </mxCell>
        <mxCell id="storage" value="SQLite + artifacts&#xa;single authoritative result path" style="rounded=1;whiteSpace=wrap;html=1;shape=cylinder3;boundedLbl=1;backgroundOutline=1;size=15;fillColor=#E8F5E9;strokeColor=#2E7D32;strokeWidth=2;fontSize=14;fontStyle=1;" vertex="1" parent="1">
          <mxGeometry x="1625" y="650" width="220" height="90" as="geometry"/>
        </mxCell>
        <mxCell id="reports" value="Scores · rankings&#xa;comparisons · reports" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#E8F5E9;strokeColor=#2E7D32;strokeWidth=2;fontSize=14;fontStyle=1;" vertex="1" parent="1">
          <mxGeometry x="1625" y="800" width="220" height="80" as="geometry"/>
        </mxCell>

        <mxCell id="stateNote" value="Every worker reports one outcome:  completed · failed · interrupted" style="rounded=1;whiteSpace=wrap;html=1;fillColor=#F4F5F7;strokeColor=#97A0AF;dashed=1;fontSize=13;fontColor=#42526E;" vertex="1" parent="1">
          <mxGeometry x="660" y="1145" width="600" height="52" as="geometry"/>
        </mxCell>

        <mxCell id="e_config_parser" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#3F51B5;strokeWidth=2;" edge="1" parent="1" source="config" target="parser">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_parser_builder" value="resolved configuration" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#3F51B5;strokeWidth=2;fontSize=12;" edge="1" parent="1" source="parser" target="builder">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_builder_orchestrator" value="builds application" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#0D47A1;strokeWidth=2;fontSize=12;" edge="1" parent="1" source="builder" target="orchestrator">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>

        <mxCell id="e_orchestrator_search" value="suggest / record" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;startArrow=block;startFill=1;endArrow=block;endFill=1;strokeColor=#0D47A1;strokeWidth=2;fontSize=12;" edge="1" parent="1" source="searchManager" target="orchestrator">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_orchestrator_scheduler" value="schedule / retry attempt" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#0D47A1;strokeWidth=2;fontSize=12;" edge="1" parent="1" source="orchestrator" target="scheduler">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_scheduler_trial" value="starts 1..N managers" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#0D47A1;strokeWidth=2;fontSize=12;" edge="1" parent="1" source="scheduler" target="trialContainer">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_orchestrator_results" value="run policy" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#0D47A1;strokeWidth=2;fontSize=12;" edge="1" parent="1" source="orchestrator" target="resultsManager">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_trial_results" value="TrialOutcome" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#EF6C00;strokeWidth=2;fontSize=12;" edge="1" parent="1" source="trialContainer" target="resultsManager">
          <mxGeometry relative="1" as="geometry">
            <Array as="points">
              <mxPoint x="1535" y="720"/>
              <mxPoint x="1535" y="610"/>
            </Array>
          </mxGeometry>
        </mxCell>
        <mxCell id="e_results_orchestrator" value="score + outcome" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#2E7D32;strokeWidth=2;fontSize=12;dashed=1;" edge="1" parent="1" source="resultsManager" target="orchestrator">
          <mxGeometry relative="1" as="geometry">
            <Array as="points">
              <mxPoint x="1390" y="525"/>
              <mxPoint x="1390" y="435"/>
              <mxPoint x="1140" y="435"/>
            </Array>
          </mxGeometry>
        </mxCell>

        <mxCell id="e_w1_w2" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#EF6C00;strokeWidth=2;" edge="1" parent="trialContainer" source="configWorker" target="vllmWorker">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_w2_w3" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#EF6C00;strokeWidth=2;" edge="1" parent="trialContainer" source="vllmWorker" target="readinessWorker">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_w3_w4" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#EF6C00;strokeWidth=2;" edge="1" parent="trialContainer" source="readinessWorker" target="benchmarkWorker">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_w4_w5" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#EF6C00;strokeWidth=2;" edge="1" parent="trialContainer" source="benchmarkWorker" target="verificationWorker">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_w5_w6" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#EF6C00;strokeWidth=2;" edge="1" parent="trialContainer" source="verificationWorker" target="resultWorker">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>

        <mxCell id="e_vllm_adapter" value="uses" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#546E7A;strokeWidth=2;fontSize=12;dashed=1;" edge="1" parent="1" source="vllmWorker" target="vllmAdapter">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_bench_adapter" value="uses" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#546E7A;strokeWidth=2;fontSize=12;dashed=1;" edge="1" parent="1" source="benchmarkWorker" target="benchmarkAdapter">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_results_storage" value="single writer" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#2E7D32;strokeWidth=2;fontSize=12;" edge="1" parent="1" source="resultsManager" target="storage">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
        <mxCell id="e_results_reports" value="produces" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;endArrow=block;endFill=1;strokeColor=#2E7D32;strokeWidth=2;fontSize=12;" edge="1" parent="1" source="resultsManager" target="reports">
          <mxGeometry relative="1" as="geometry"/>
        </mxCell>
      </root>
    </mxGraphModel>
  </diagram>
</mxfile>
