@jterrats/open-orchestra 1.0.2 → 1.0.4

package/docs/diagrams/state-uml-recreated.drawio

@@ -0,0 +1,336 @@
+<mxfile host="Open Orchestra" modified="2026-05-16T09:35:00.000Z" agent="open-orchestra" version="1">
+  <diagram id="state-uml-recreated" name="State UML Recreated">
+    <mxGraphModel dx="1180" dy="1680" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1180" pageHeight="1680" math="0" shadow="0">
+      <root>
+        <mxCell id="0" />
+        <mxCell id="1" parent="0" />
+
+        <mxCell id="title-concurrent" value="Estado concurrente" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#1F2933;fontStyle=1;fontSize=24;align=left;verticalAlign=middle;" vertex="1" parent="1">
+          <mxGeometry x="40" y="20" width="300" height="32" as="geometry" />
+        </mxCell>
+        <mxCell id="concurrent-on" value="On" style="rounded=1;whiteSpace=wrap;html=1;arcSize=6;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;verticalAlign=top;spacingTop=4;" vertex="1" parent="1">
+          <mxGeometry x="180" y="76" width="500" height="360" as="geometry" />
+        </mxCell>
+        <mxCell id="concurrent-region-a" value="" style="line;strokeWidth=2;html=1;strokeColor=#222222;" vertex="1" parent="1">
+          <mxGeometry x="180" y="196" width="500" height="10" as="geometry" />
+        </mxCell>
+        <mxCell id="concurrent-region-b" value="" style="line;strokeWidth=2;dashed=1;dashPattern=8 5;html=1;strokeColor=#222222;" vertex="1" parent="1">
+          <mxGeometry x="180" y="266" width="500" height="10" as="geometry" />
+        </mxCell>
+        <mxCell id="display-current" value="Display Current&lt;br&gt;Time" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="260" y="164" width="150" height="62" as="geometry" />
+        </mxCell>
+        <mxCell id="display-alarm" value="Display Alarm&lt;br&gt;Time" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="440" y="164" width="150" height="62" as="geometry" />
+        </mxCell>
+        <mxCell id="playing-radio" value="Playing Radio" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="290" y="316" width="120" height="62" as="geometry" />
+        </mxCell>
+        <mxCell id="playing-cd" value="Playing CD" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="440" y="316" width="120" height="62" as="geometry" />
+        </mxCell>
+        <mxCell id="history-concurrent" value="H" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="204" y="333" width="28" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="off" value="Off" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=18;" vertex="1" parent="1">
+          <mxGeometry x="362" y="514" width="170" height="62" as="geometry" />
+        </mxCell>
+        <mxCell id="concurrent-time" value="time" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="180" y="196" as="sourcePoint" />
+            <mxPoint x="260" y="196" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="concurrent-alarm" value="alarm" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="680" y="196" as="sourcePoint" />
+            <mxPoint x="590" y="196" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="concurrent-h-radio" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="232" y="346" as="sourcePoint" />
+            <mxPoint x="290" y="346" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="off-radio" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="362" y="545" as="sourcePoint" />
+            <mxPoint x="350" y="378" as="targetPoint" />
+            <Array as="points">
+              <mxPoint x="350" y="545" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="label-radio" value="Radio" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#1F2933;fontSize=18;align=center;verticalAlign=middle;" vertex="1" parent="1">
+          <mxGeometry x="356" y="398" width="70" height="24" as="geometry" />
+        </mxCell>
+        <mxCell id="off-cd" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="462" y="514" as="sourcePoint" />
+            <mxPoint x="500" y="378" as="targetPoint" />
+            <Array as="points">
+              <mxPoint x="462" y="480" />
+              <mxPoint x="500" y="480" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="label-cd" value="CD" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#1F2933;fontSize=18;align=center;verticalAlign=middle;" vertex="1" parent="1">
+          <mxGeometry x="518" y="398" width="50" height="24" as="geometry" />
+        </mxCell>
+        <mxCell id="on-off" value="on" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="426" y="514" as="sourcePoint" />
+            <mxPoint x="426" y="436" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="off-on" value="off" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="532" y="436" as="sourcePoint" />
+            <mxPoint x="532" y="514" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+
+        <mxCell id="title-history" value="Shallow history state" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#1F2933;fontStyle=1;fontSize=24;align=left;" vertex="1" parent="1">
+          <mxGeometry x="40" y="650" width="340" height="32" as="geometry" />
+        </mxCell>
+        <mxCell id="command" value="Command" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="135" y="780" width="120" height="60" as="geometry" />
+        </mxCell>
+        <mxCell id="backup" value="BackingUp" style="rounded=1;whiteSpace=wrap;html=1;arcSize=6;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;verticalAlign=top;spacingTop=4;" vertex="1" parent="1">
+          <mxGeometry x="390" y="733" width="290" height="350" as="geometry" />
+        </mxCell>
+        <mxCell id="history-h" value="H" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="430" y="807" width="30" height="30" as="geometry" />
+        </mxCell>
+        <mxCell id="collecting" value="Collecting" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="515" y="780" width="120" height="60" as="geometry" />
+        </mxCell>
+        <mxCell id="copying" value="Copying" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="515" y="890" width="120" height="60" as="geometry" />
+        </mxCell>
+        <mxCell id="cleaning" value="Cleaning Up" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=15;" vertex="1" parent="1">
+          <mxGeometry x="515" y="1010" width="120" height="60" as="geometry" />
+        </mxCell>
+        <mxCell id="cmd-to-h" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="255" y="810" as="sourcePoint" />
+            <mxPoint x="430" y="822" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="h-to-collecting" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="460" y="807" as="sourcePoint" />
+            <mxPoint x="515" y="807" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="collecting-copying" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="575" y="840" as="sourcePoint" />
+            <mxPoint x="575" y="890" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="copying-cleaning" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="575" y="950" as="sourcePoint" />
+            <mxPoint x="575" y="1010" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="history-query" value="query" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="390" y="890" as="sourcePoint" />
+            <mxPoint x="210" y="840" as="targetPoint" />
+            <Array as="points">
+              <mxPoint x="210" y="890" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="history-clean-command" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="515" y="1040" as="sourcePoint" />
+            <mxPoint x="180" y="840" as="targetPoint" />
+            <Array as="points">
+              <mxPoint x="180" y="1040" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="annot-state" value="State" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="158" y="690" width="100" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-state-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="190" y="733" as="sourcePoint" />
+            <mxPoint x="190" y="777" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="annot-history" value="Shallow History State" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="305" y="673" width="250" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-history-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="425" y="707" as="sourcePoint" />
+            <mxPoint x="425" y="807" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="annot-transition-history" value="Transition" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="240" y="1080" width="140" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-transition-history-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="292" y="1080" as="sourcePoint" />
+            <mxPoint x="292" y="1007" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+
+        <mxCell id="title-actions" value="Acciones de entrada y salida" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#1F2933;fontStyle=1;fontSize=24;align=left;" vertex="1" parent="1">
+          <mxGeometry x="40" y="1130" width="430" height="32" as="geometry" />
+        </mxCell>
+        <mxCell id="initial-dot" value="" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#000000;strokeColor=#000000;" vertex="1" parent="1">
+          <mxGeometry x="473" y="1190" width="24" height="24" as="geometry" />
+        </mxCell>
+        <mxCell id="action-state-1" value="State&lt;br&gt;entry / Action 1_1&lt;br&gt;do / Action 1_2" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=13;" vertex="1" parent="1">
+          <mxGeometry x="405" y="1285" width="190" height="92" as="geometry" />
+        </mxCell>
+        <mxCell id="action-state-2" value="State2&lt;br&gt;entry / Action 2_1&lt;br&gt;Action 2_3 / defer&lt;br&gt;exit / Action 2_2" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=13;" vertex="1" parent="1">
+          <mxGeometry x="870" y="1285" width="190" height="98" as="geometry" />
+        </mxCell>
+        <mxCell id="action-state-3" value="State2&lt;br&gt;entry / Action 3_1" style="rounded=1;whiteSpace=wrap;html=1;arcSize=18;fillColor=#74C7ED;strokeColor=#222222;fontColor=#1F2933;fontSize=13;" vertex="1" parent="1">
+          <mxGeometry x="630" y="1455" width="190" height="88" as="geometry" />
+        </mxCell>
+        <mxCell id="decision" value="" style="rhombus;whiteSpace=wrap;html=1;fillColor=#74C7ED;strokeColor=#222222;" vertex="1" parent="1">
+          <mxGeometry x="472" y="1482" width="56" height="32" as="geometry" />
+        </mxCell>
+        <mxCell id="final-state" value="" style="ellipse;shape=doubleEllipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#000000;strokeColor=#000000;" vertex="1" parent="1">
+          <mxGeometry x="486" y="1584" width="28" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="initial-to-state" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="485" y="1214" as="sourcePoint" />
+            <mxPoint x="485" y="1285" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="state1-state2" value="event [Guard1] / ActionA" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;fontSize=13;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="595" y="1326" as="sourcePoint" />
+            <mxPoint x="870" y="1326" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="decision-state1" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;fontSize=13;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="500" y="1482" as="sourcePoint" />
+            <mxPoint x="500" y="1377" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="action-label-guard4" value="[Guard4]" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#1F2933;fontSize=13;align=left;verticalAlign=middle;" vertex="1" parent="1">
+          <mxGeometry x="525" y="1428" width="80" height="24" as="geometry" />
+        </mxCell>
+        <mxCell id="decision-final" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;fontSize=13;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="500" y="1514" as="sourcePoint" />
+            <mxPoint x="500" y="1584" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="action-label-else" value="[Else]" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#1F2933;fontSize=13;align=left;verticalAlign=middle;" vertex="1" parent="1">
+          <mxGeometry x="513" y="1536" width="60" height="24" as="geometry" />
+        </mxCell>
+        <mxCell id="state2-state3" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;fontSize=13;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="870" y="1335" as="sourcePoint" />
+            <mxPoint x="725" y="1455" as="targetPoint" />
+            <Array as="points">
+              <mxPoint x="725" y="1335" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="action-label-guard3" value="[Guard3] / ActionB" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#1F2933;fontSize=13;align=left;verticalAlign=middle;" vertex="1" parent="1">
+          <mxGeometry x="745" y="1430" width="130" height="24" as="geometry" />
+        </mxCell>
+        <mxCell id="state2-guard2-state3" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;fontSize=13;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="1060" y="1366" as="sourcePoint" />
+            <mxPoint x="820" y="1499" as="targetPoint" />
+            <Array as="points">
+              <mxPoint x="1060" y="1499" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="action-label-guard2" value="[Guard2]" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#1F2933;fontSize=13;align=left;verticalAlign=middle;" vertex="1" parent="1">
+          <mxGeometry x="945" y="1510" width="80" height="24" as="geometry" />
+        </mxCell>
+        <mxCell id="state3-decision" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#222222;fontColor=#1F2933;fontSize=13;edgeStyle=orthogonalEdgeStyle;jumpStyle=arc;jumpSize=8;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="630" y="1499" as="sourcePoint" />
+            <mxPoint x="528" y="1499" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+
+        <mxCell id="annot-initial" value="Initial Pseudo State" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="245" y="1188" width="230" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-entry" value="Entry action" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="73" y="1306" width="150" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-entry-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="243" y="1318" as="sourcePoint" />
+            <mxPoint x="405" y="1318" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="annot-action-state" value="Action in state" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="323" y="1408" width="180" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-action-state-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="447" y="1396" as="sourcePoint" />
+            <mxPoint x="447" y="1358" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="annot-decision" value="Decision" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="295" y="1500" width="120" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-decision-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="385" y="1503" as="sourcePoint" />
+            <mxPoint x="472" y="1503" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="annot-transition" value="Transition" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="665" y="1208" width="140" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-transition-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="715" y="1228" as="sourcePoint" />
+            <mxPoint x="715" y="1308" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="annot-triggered" value="Triggered Action" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="835" y="1200" width="220" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-triggered-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="960" y="1214" as="sourcePoint" />
+            <mxPoint x="960" y="1318" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="annot-exit" value="Exit action" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="1073" y="1384" width="130" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-exit-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="1069" y="1384" as="sourcePoint" />
+            <mxPoint x="1001" y="1366" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="annot-final" value="Final State" style="text;html=1;strokeColor=none;fillColor=none;fontColor=#E35C5C;fontStyle=1;fontSize=20;" vertex="1" parent="1">
+          <mxGeometry x="285" y="1590" width="130" height="28" as="geometry" />
+        </mxCell>
+        <mxCell id="annot-final-arrow" value="" style="endArrow=block;html=1;rounded=0;strokeColor=#E35C5C;strokeWidth=3;dashed=1;dashPattern=10 8;edgeStyle=orthogonalEdgeStyle;" edge="1" parent="1">
+          <mxGeometry relative="1" as="geometry">
+            <mxPoint x="405" y="1598" as="sourcePoint" />
+            <mxPoint x="486" y="1598" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>

package/docs/diagrams/state-uml-recreated.prompt.md

@@ -0,0 +1,114 @@
+# Master Prompt: UML State Diagram Recreation
+
+Recreate the diagrams from the latest downloaded Visual Paradigm UML state PDF
+as editable draw.io XML and rendered SVG.
+
+Use the most recent PDF in `~/Downloads` as source material. Convert the PDF
+pages to PNG, inspect the pages that contain diagrams, and recreate the visual
+content as closely as possible.
+
+When no source PDF, screenshot, or design reference exists, create a diagram
+contract before drawing: purpose, audience, diagram type, node inventory,
+container/group inventory, relationship inventory, labels, annotations, expected
+reading flow, and planned connector source/target/anchor points.
+
+Pay attention to:
+
+- element spacing and relative position.
+- container width and height after real text is placed.
+- connector routing, bend points, and post-render adjustment against the source
+  reference.
+- line avoidance so connectors do not run over important labels or containers.
+- arrows terminating at the intended connection edge, not deep inside shapes.
+- endpoint distance from source to target, so every connector visibly touches
+  both the origin and destination edges.
+- source-to-target distance validation: for each connector, confirm the line
+  starts at the visual boundary of the source element and ends at the visual
+  boundary of the intended target element.
+- connector intent validation: if a label such as `Radio`, `CD`, `on`, or `off`
+  implies a specific target state, the arrow must reach that state instead of
+  stopping at the parent container.
+- connector label avoidance: route arrows so they do not cover state labels or
+  transition labels unless the source diagram explicitly does so.
+- label boundary clearance: after rendering, verify that every label has visual
+  clearance from container borders, connector lines, and arrowheads. Labels must
+  not sit directly on a shape boundary.
+- annotation target clarity: every annotation arrow must have an explicit visual
+  target, and annotation text/arrows must not obscure the element, line, or label
+  they describe.
+- concrete visual regression checklist: convert observed diagram issues into
+  explicit examples under the existing endpoint, z-order, label-clearance,
+  annotation-target, and layout-simplification rules instead of duplicating the
+  concepts.
+- element ordering and z-index: draw containers and states before their
+  connectors, then draw connectors above the connected elements so arrowheads
+  and line endpoints remain visible at the target boundary. A connector must not
+  disappear behind the element it is intended to connect.
+- connection point aesthetics: choose source and target anchor points that
+  minimize unnecessary bends and line travel. Prefer side midpoints or the
+  nearest clean boundary point when that produces fewer orthogonal turns than
+  starting from the top or bottom edge.
+- orthogonal connector aesthetics: avoid diagonal connectors unless the source
+  diagram explicitly requires them. Prefer horizontal/vertical segments with
+  controlled bend points.
+- line crossing treatment: when two lines must cross, use a visible line jump or
+  bridge on the line that visually passes over the other line; in draw.io,
+  prefer arc-style jumps such as `jumpStyle=arc`.
+- layout simplification before bend acceptance: before accepting a connector
+  bend, evaluate whether moving the source or target element slightly can remove
+  the bend while preserving the diagram's semantic relationship and visual
+  balance.
+- editable/rendered equivalence: keep the draw.io XML source and rendered SVG
+  geometrically equivalent. Any moved element, connector, label, or annotation in
+  the SVG must have a corresponding editable cell or edge in the draw.io source.
+- source-free quality loop: when no reference exists, validate the first render
+  against the pre-declared diagram contract, not intuition.
+- text and shape rotation: preserve vertical, horizontal, or diagonal text
+  orientation from the source. In draw.io, use explicit degree-based rotation
+  styles such as `rotation=270` or `textRotation=-90` when the source resembles
+  Lucid-style positive or negative axis rotation.
+- fill, border, text, and annotation colors.
+- rounded corners, border weight, dashed lines, and region separators.
+- typography, label placement, and text wrapping.
+- final resizing and visual balance pass after the diagram is assembled and
+  rendered.
+
+Produce:
+
+- `docs/diagrams/state-uml-recreated.drawio`
+- `docs/diagrams/state-uml-recreated.svg`
+
+Validate:
+
+- XML validity for both draw.io and SVG artifacts.
+- SVG render through a browser screenshot.
+- Visual endpoint QA for every connector in the rendered screenshot.
+- Visual z-order QA for every connector; no arrowhead or connector endpoint may
+  be hidden behind the element it connects.
+- Visual anchor-point QA for every connector; source and target points should be
+  chosen for the shortest readable orthogonal route with the fewest bend points.
+- Visual diagonal/crossing QA; connectors should be orthogonal when practical
+  and unavoidable line crossings should have a visible jump/bridge.
+- Visual layout simplification QA; if a connector bends, check whether a modest
+  element repositioning can make the route straighter and clearer.
+- Editable-source QA; compare draw.io XML against the SVG so the source artifact
+  can reproduce the same geometry after editing.
+- Annotation QA; for every red annotation, verify the target element or line is
+  clear and the arrowhead visibly lands on it.
+- Checklist QA; for known difficult annotations such as Shallow History State,
+  Transition, Triggered Action, Exit action, Action in state, and guard labels,
+  verify the exact target, clearance, and connector route explicitly.
+- Source-free QA; when generated without a reference, verify every rendered node,
+  connector, label, annotation, anchor side, and bend count against the diagram
+  contract before delivery.
+- No whitespace errors in the repository diff.
+
+Current source PDF:
+
+- `/Users/polux/Downloads/Dominar los diagramas de estado en UML_ Una guía completa - Visual Paradigm Guides Spanish.pdf`
+
+Identified source pages:
+
+- Page 6: concurrent state diagram.
+- Page 7 top: shallow history state diagram.
+- Page 7 bottom: entry/exit action diagram.

package/docs/diagrams/state-uml-recreated.prompt.v10.md

@@ -0,0 +1,52 @@
+# Prompt Version 10: UML Concrete Visual Regression Checklist Delta
+
+Use this as a delta over `state-uml-recreated.prompt.md` after the ninth
+rendered SVG/draw.io pass.
+
+This version does not introduce a new conceptual rule. It turns the existing
+endpoint, z-order, label-clearance, annotation-target, and layout-simplification
+rules into concrete visual regression checks.
+
+## Append Lines
+
+- For every red annotation, explicitly identify the target before accepting the
+  diagram: state, pseudo-state, history marker, transition line, internal
+  action, guard label, exit action, or final state.
+- A red annotation arrow must not point vaguely toward a container when the
+  intended target is a specific child element or line.
+- `Shallow History State` must point to the `H` history marker or the specific
+  history notation being explained; the arrowhead must not disappear behind the
+  `BackingUp` container.
+- `Transition` in Shallow History must clearly point to the transition line it
+  describes and must use a bridge/jump if crossing another line.
+- `Triggered Action` must point to the triggered action text or the transition
+  action it explains without covering the `State2` title or state body text.
+- `Exit action` must point to the exit action row or the state exit notation
+  without invading unreadably into the `State2` body.
+- `Action in state` should use a direct vertical pointer when possible; move the
+  annotation text to create space before accepting a horizontal-then-vertical
+  bend.
+- `[Guard3] / ActionB` and similar guard labels must have clear spacing from the
+  connector they describe; the text should not sit behind or on top of the line.
+- After each correction, inspect the surrounding connectors and labels because a
+  fix for one annotation can create a regression in nearby state or transition
+  labels.
+
+## Modify Lines
+
+- Change `Annotation QA; for every red annotation, verify the target element or
+line is clear and the arrowhead visibly lands on it` to `Annotation QA; for
+every red annotation, name the exact target, verify the arrowhead visibly
+lands on it, and verify the annotation does not obscure that target`.
+- Change `Editable-source QA; compare draw.io XML against the SVG so the source
+artifact can reproduce the same geometry after editing` to `Editable-source
+QA; compare draw.io XML against the SVG so moved annotations, labels,
+connectors, and target points can be reproduced after editing`.
+
+## Validation Additions
+
+- Review the rendered diagram as a checklist, not only as a general visual scan.
+- For each concrete item above, record whether it is pass, fixed, or accepted as
+  approximation.
+- If a rule already exists but a concrete failure still appears, add the failure
+  as a checklist example rather than creating a duplicate conceptual rule.

package/docs/diagrams/state-uml-recreated.prompt.v11.md

@@ -0,0 +1,52 @@
+# Prompt Version 11: Source-Free Diagram Quality Loop Delta
+
+Use this as a delta over `state-uml-recreated.prompt.md` for diagrams created
+without a source PDF, screenshot, or design reference.
+
+This version does not depend on comparing against an external source. It makes
+quality explicit before drawing begins.
+
+## Append Lines
+
+- Before drawing, define a diagram contract: purpose, audience, diagram type,
+  node inventory, container/group inventory, relationship inventory, labels,
+  annotations, and expected reading flow.
+- Define the exact source and target for every connector before placing shapes.
+- Reserve label lanes before drawing connectors. Do not place labels where
+  connectors are expected to pass.
+- Place elements to minimize bends before routing connectors. Prefer moving an
+  element or anchor point before adding bends.
+- Choose connector anchors deliberately: source edge, target edge, midpoint
+  preference, expected bend count, and whether the route needs a jump/bridge.
+- Draw in layers: containers and groups first, nodes second, connectors third,
+  labels fourth, annotations last.
+- Prefer orthogonal connectors from the first draft. Diagonal connectors require
+  an explicit reason.
+- If a connector needs more than one bend, pause and re-evaluate the connected
+  element positions before accepting the route.
+- If an annotation arrow needs an awkward path, move the annotation label before
+  accepting the arrow route.
+- After first render, run a full visual QA pass: endpoint contact, z-order,
+  label clearance, annotation target clarity, line crossings, shape sizing,
+  whitespace balance, and editable/rendered equivalence when an editable source
+  exists.
+- Correct and re-render before delivery. A diagram is not ready after the first
+  valid render unless the visual QA checklist passes.
+
+## Modify Lines
+
+- Change `Use the most recent PDF in ~/Downloads as source material` to `When a
+source reference exists, use it as source material; when no source reference
+exists, create and validate a diagram contract before drawing`.
+- Change `Visual endpoint QA for every connector` to `Visual endpoint QA for
+every connector, backed by the pre-declared source/target inventory`.
+
+## Validation Additions
+
+- Attach or record the diagram contract when the diagram is generated without a
+  source reference.
+- Review the rendered diagram against the contract, not against intuition.
+- For every connector, record whether the final route matches the planned
+  source, target, anchor side, and expected bend count.
+- Record residual gaps when readability requires deviating from the initial
+  contract.

package/docs/diagrams/state-uml-recreated.prompt.v12.md

@@ -0,0 +1,50 @@
+# Prompt Version 12: Global Layout Reflow Delta
+
+Use this as a delta over `state-uml-recreated.prompt.md` and the later prompt
+versions. This version addresses the failure mode where elements are drawn once,
+then labels, subcards, chips, or connectors are added without recalculating the
+layout.
+
+## Append Lines
+
+- After placing real text, subcards, chips, icons, and internal connectors, run a
+  global layout reflow pass before accepting the render.
+- For every composite container, validate that all child bounds fit inside the
+  parent bounds with minimum padding. Child nodes include text labels, nested
+  boxes, badges, icons, internal connectors, annotation anchors, and metadata
+  chips.
+- If any child touches a parent edge, overflows, clips, crowds another child, or
+  reduces padding below the minimum, grow the parent container before trying to
+  shrink text.
+- If a parent container grows, recalculate neighboring element positions,
+  connector routes, connector labels, annotation labels, and page/canvas bounds.
+  A local container fix is incomplete until the whole canvas is valid again.
+- Reserve connector-label lanes after final element positions are known. Labels
+  must sit in intentional whitespace or on readable label backgrounds; they must
+  not touch connector strokes, arrowheads, container borders, or other labels.
+- If a connector label collides with a route, first evaluate moving the label,
+  then rerouting the connector, then moving one of the connected elements. Do not
+  accept a collision because the connector technically reaches its target.
+- If two connector routes become awkward after reflow, re-evaluate source and
+  target anchor points before adding more bends.
+- After every correction, re-run the full visual QA checklist across the entire
+  canvas: parent containment, child spacing, text fit, connector endpoints,
+  connector labels, z-order, arrowhead visibility, crossing count, and whitespace
+  balance.
+
+## Modify Lines
+
+- Change `Re-evaluate container width, height, text fit, spacing, and visual
+  balance after real labels are placed` to `Recalculate container width, height,
+  child positions, connector routes, label lanes, and neighboring positions after
+  real labels and child elements are placed`.
+- Change `Correct and re-render before delivery` to `Correct, reflow the global
+  layout, re-render, and re-check the full canvas before delivery`.
+
+## Validation Additions
+
+- Record whether each composite container passed child-bounds containment.
+- Record which elements moved after a parent container grew.
+- Record whether connector labels are clear of lines, arrowheads, and borders.
+- Record the final render pass number used for acceptance. The first render
+  should not be accepted unless the full global reflow checklist passes.