Back to index

State Machine

Diagram kind
Editorial Release LifecycleInitial StateStateFinal Statesubmit / freezedecide [checks-pass] / approvedecide [policy-block] / blockdecide [else] / reviseredraftpublish / releaseretire / archive[Initial State]DraftAuthoring and revisionremain open.[State]In ReviewEditorial and policychecks are running.[State]ApprovedAll required checkspassed.[State]RejectedA blocking issuerequires a new draft.[State]PublishedThe approved article ispublicly available.[Final State]RetiredThe release lifecycleis complete.

Examples: state-editorial-release

Take it with you

Copy and paste, or save a file and hand it over. For a machine with no network, one “Everything” file is enough.

Everything

diagram-state-everything.md

Everything in this panel, including the contents behind each URL, in one Markdown file

Prompt

2.3 KB
I need a "State Machine" diagram. It is published as text and vectors, so taking the published one and editing it beats redrawing it.
## What this diagram says
Lays out the states a thing can be in, and the events that move it between them.
## When it fits
- Checking that no state is unreachable between the initial and final ones.
- Making the event, guard and action triple explicit.
## When it does not
- Nested states: this profile handles a flat state machine only.
- When the handover between people is the subject — use BPMN-lite.
## What this kind validates
- Validates the initial state, reachability of every state, final states, events, guards and actions, and branch coverage.
## What it does not
- Does not check that the implementation obeys this machine.
## What you can take
- https://design-vault.pages.dev/designs/diagram-state/samples/state-editorial-release/diagram-spec.json
- https://design-vault.pages.dev/designs/diagram-state/samples/state-editorial-release/layout.json
- https://design-vault.pages.dev/designs/diagram-state/samples/state-editorial-release/state.drawio
- https://design-vault.pages.dev/designs/diagram-state/samples/state-editorial-release/state.png
- https://design-vault.pages.dev/designs/diagram-state/samples/state-editorial-release/state.svg
- https://design-vault.pages.dev/ai/assets/diagram-state.json
## What you can edit
The published `.drawio` is uncompressed XML. Open it in draw.io and edit it, or diff it as text.

Operations this kind accepts through the engine: alignNodes, distributeNodes, moveNode, resizeNode

This kind accepts only geometry operations — it has none that change meaning.
## Writing a new one
A `diagram-spec.json` can be written against the schema below.

- https://design-vault.pages.dev/schemas/diagram-spec.schema.json
- https://design-vault.pages.dev/schemas/layout.schema.json
## What cannot be done here
**A spec you write cannot be validated here, and `layout.json` cannot be computed here.** The generator that does both is not published; what is published is the artifacts, the inputs and the schemas. Place the geometry yourself, or hand the spec to someone who has the engine.
## Licence
The diagram and its inputs are CC BY 4.0 — carry the credit when you use them.

> "State Machine" by zawa, licensed under CC BY 4.0. https://creativecommons.org/licenses/by/4.0/

The schemas are MIT.

Files

state-editorial-release/diagram-spec.json

2.9 KB

/designs/diagram-state/samples/state-editorial-release/diagram-spec.json

Show contents
{
    "$schema": "../../../../schemas/diagram-spec.schema.json",
    "schemaVersion": "2.0",
    "diagramKind": "state",
    "id": "editorial-release-state",
    "title": "Editorial Release Lifecycle",
    "description": "A reachable editorial lifecycle with explicit guarded review outcomes.",
    "language": "en",
    "initialStateId": "draft",
    "nodes": [
        {
            "id": "draft",
            "type": "state",
            "title": "Draft",
            "description": "Authoring and revision remain open."
        },
        {
            "id": "in-review",
            "type": "state",
            "title": "In Review",
            "description": "Editorial and policy checks are running."
        },
        {
            "id": "approved",
            "type": "state",
            "title": "Approved",
            "description": "All required checks passed."
        },
        {
            "id": "rejected",
            "type": "state",
            "title": "Rejected",
            "description": "A blocking issue requires a new draft."
        },
        {
            "id": "published",
            "type": "state",
            "title": "Published",
            "description": "The approved article is publicly available."
        },
        {
            "id": "retired",
            "type": "final-state",
            "title": "Retired",
            "description": "The release lifecycle is complete."
        }
    ],
    "edges": [
        {
            "id": "submit",
            "type": "transition",
            "from": "draft",
            "to": "in-review",
            "event": "submit",
            "action": "freeze"
        },
        {
            "id": "approve",
            "type": "transition",
            "from": "in-review",
            "to": "approved",
            "event": "decide",
            "guard": "checks-pass",
            "action": "approve"
        },
        {
            "id": "reject",
            "type": "transition",
            "from": "in-review",
            "to": "rejected",
            "event": "decide",
            "guard": "policy-block",
            "action": "block"
        },
        {
            "id": "revise",
            "type": "transition",
            "from": "in-review",
            "to": "draft",
            "event": "decide",
            "guard": "else",
            "action": "revise"
        },
        {
            "id": "redraft",
            "type": "transition",
            "from": "rejected",
            "to": "draft",
            "event": "redraft"
        },
        {
            "id": "publish",
            "type": "transition",
            "from": "approved",
            "to": "published",
            "event": "publish",
            "action": "release"
        },
        {
            "id": "retire",
            "type": "transition",
            "from": "published",
            "to": "retired",
            "event": "retire",
            "action": "archive"
        }
    ]
}

state-editorial-release/layout.json

3.5 KB

/designs/diagram-state/samples/state-editorial-release/layout.json

Show contents
{
    "$schema": "../../../../schemas/layout.schema.json",
    "schemaVersion": "1.0",
    "canvas": {
        "width": 1800,
        "height": 940
    },
    "nodes": {
        "draft": {
            "x": 70,
            "y": 400,
            "width": 210,
            "height": 120
        },
        "in-review": {
            "x": 400,
            "y": 400,
            "width": 220,
            "height": 120
        },
        "approved": {
            "x": 850,
            "y": 160,
            "width": 210,
            "height": 120
        },
        "rejected": {
            "x": 850,
            "y": 650,
            "width": 210,
            "height": 120
        },
        "published": {
            "x": 1230,
            "y": 160,
            "width": 220,
            "height": 120
        },
        "retired": {
            "x": 1600,
            "y": 160,
            "width": 150,
            "height": 120
        }
    },
    "edges": {
        "submit": {
            "source": {
                "side": "right",
                "offset": 0.5
            },
            "target": {
                "side": "left",
                "offset": 0.5
            },
            "label": {
                "x": 340,
                "y": 370
            }
        },
        "approve": {
            "source": {
                "side": "right",
                "offset": 0.2
            },
            "target": {
                "side": "left",
                "offset": 0.5
            },
            "label": {
                "x": 735,
                "y": 320
            }
        },
        "reject": {
            "source": {
                "side": "right",
                "offset": 0.8
            },
            "target": {
                "side": "left",
                "offset": 0.5
            },
            "label": {
                "x": 735,
                "y": 600
            }
        },
        "revise": {
            "source": {
                "side": "left",
                "offset": 0.75
            },
            "target": {
                "side": "right",
                "offset": 0.75
            },
            "label": {
                "x": 340,
                "y": 535
            }
        },
        "redraft": {
            "source": {
                "side": "left",
                "offset": 0.7
            },
            "target": {
                "side": "bottom",
                "offset": 0.4
            },
            "waypoints": [
                {
                    "x": 750,
                    "y": 734
                },
                {
                    "x": 750,
                    "y": 850
                },
                {
                    "x": 154,
                    "y": 850
                }
            ],
            "label": {
                "x": 610,
                "y": 870
            }
        },
        "publish": {
            "source": {
                "side": "right",
                "offset": 0.5
            },
            "target": {
                "side": "left",
                "offset": 0.5
            },
            "label": {
                "x": 1145,
                "y": 130
            }
        },
        "retire": {
            "source": {
                "side": "right",
                "offset": 0.5
            },
            "target": {
                "side": "left",
                "offset": 0.5
            },
            "label": {
                "x": 1525,
                "y": 130
            }
        }
    }
}

state-editorial-release/state.drawio

17.9 KB

/designs/diagram-state/samples/state-editorial-release/state.drawio

Show contents
<?xml version="1.0" encoding="UTF-8"?>
<mxfile host="app.diagrams.net" compressed="false">
<diagram id="editorial-release-state" name="State Machine" syncFormat="1.0" diagramKind="state" initialStateId="draft" inputHash="4332627ac6844ebba58958d00541ee189835b5780fe891ad5829aa6f659bbd27" generatorVersion="0.7.0">
<mxGraphModel dx="1200" dy="820" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="1800" pageHeight="940" math="0" shadow="0">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="diagram-title" value="Editorial Release Lifecycle" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=23;fontStyle=1;fontColor=#292E35;spacing=0;align=left;verticalAlign=middle;" vertex="1" parent="1"><mxGeometry x="32" y="22" width="720" height="42" as="geometry"/></mxCell>
<mxCell id="legend-0-mark" value="" style="ellipse;html=1;aspect=fixed;fillColor=#FFFFFF;strokeColor=#343A42;strokeWidth=1.6;" vertex="1" parent="1"><mxGeometry x="32" y="85" width="10" height="10" as="geometry"/></mxCell>
<mxCell id="legend-0-text" value="Initial State" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=13;fontStyle=0;fontColor=#292E35;spacing=0;align=left;verticalAlign=middle;" vertex="1" parent="1"><mxGeometry x="49" y="77" width="170" height="28" as="geometry"/></mxCell>
<mxCell id="legend-1-mark" value="" style="ellipse;html=1;aspect=fixed;fillColor=#FFFFFF;strokeColor=#59697D;strokeWidth=1.6;" vertex="1" parent="1"><mxGeometry x="254" y="85" width="10" height="10" as="geometry"/></mxCell>
<mxCell id="legend-1-text" value="State" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=13;fontStyle=0;fontColor=#292E35;spacing=0;align=left;verticalAlign=middle;" vertex="1" parent="1"><mxGeometry x="271" y="77" width="170" height="28" as="geometry"/></mxCell>
<mxCell id="legend-2-mark" value="" style="ellipse;html=1;aspect=fixed;fillColor=#FFFFFF;strokeColor=#B44343;strokeWidth=1.6;" vertex="1" parent="1"><mxGeometry x="476" y="85" width="10" height="10" as="geometry"/></mxCell>
<mxCell id="legend-2-text" value="Final State" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=13;fontStyle=0;fontColor=#292E35;spacing=0;align=left;verticalAlign=middle;" vertex="1" parent="1"><mxGeometry x="493" y="77" width="170" height="28" as="geometry"/></mxCell>
<object id="submit" label="" componentId="submit" stateType="edge" stateTransitionType="transition" variant="realtime" direction="forward" event="submit" action="freeze"><mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#343A42;strokeWidth=1.6;endArrow=open;endFill=0;endSize=8;startArrow=none;exitX=1;exitY=0.5;exitDx=0;exitDy=0;exitPerimeter=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;entryPerimeter=1;" edge="1" parent="1" source="draft" target="in-review"><mxGeometry relative="1" as="geometry"></mxGeometry></mxCell></object>
<mxCell id="submit--label" value="submit / freeze" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=1;fontColor=#292E35;spacing=0;labelBackgroundColor=#FFFFFF;" vertex="1" parent="1" syncRole="edge-label" ownerId="submit"><mxGeometry x="280.44" y="359" width="119.12" height="22" as="geometry"/></mxCell>
<object id="approve" label="" componentId="approve" stateType="edge" stateTransitionType="transition" variant="realtime" direction="forward" event="decide" guard="checks-pass" action="approve"><mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#343A42;strokeWidth=1.6;endArrow=open;endFill=0;endSize=8;startArrow=none;exitX=1;exitY=0.2;exitDx=0;exitDy=0;exitPerimeter=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;entryPerimeter=1;" edge="1" parent="1" source="in-review" target="approved"><mxGeometry relative="1" as="geometry"></mxGeometry></mxCell></object>
<mxCell id="approve--label" value="decide [checks-pass] / approve" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=1;fontColor=#292E35;spacing=0;labelBackgroundColor=#FFFFFF;" vertex="1" parent="1" syncRole="edge-label" ownerId="approve"><mxGeometry x="621.26" y="309" width="227.48" height="22" as="geometry"/></mxCell>
<object id="reject" label="" componentId="reject" stateType="edge" stateTransitionType="transition" variant="realtime" direction="forward" event="decide" guard="policy-block" action="block"><mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#343A42;strokeWidth=1.6;endArrow=open;endFill=0;endSize=8;startArrow=none;exitX=1;exitY=0.8;exitDx=0;exitDy=0;exitPerimeter=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;entryPerimeter=1;" edge="1" parent="1" source="in-review" target="rejected"><mxGeometry relative="1" as="geometry"></mxGeometry></mxCell></object>
<mxCell id="reject--label" value="decide [policy-block] / block" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=1;fontColor=#292E35;spacing=0;labelBackgroundColor=#FFFFFF;" vertex="1" parent="1" syncRole="edge-label" ownerId="reject"><mxGeometry x="624.98" y="589" width="220.04" height="22" as="geometry"/></mxCell>
<object id="revise" label="" componentId="revise" stateType="edge" stateTransitionType="transition" variant="realtime" direction="forward" event="decide" guard="else" action="revise"><mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#343A42;strokeWidth=1.6;endArrow=open;endFill=0;endSize=8;startArrow=none;exitX=0;exitY=0.75;exitDx=0;exitDy=0;exitPerimeter=1;entryX=1;entryY=0.75;entryDx=0;entryDy=0;entryPerimeter=1;" edge="1" parent="1" source="in-review" target="draft"><mxGeometry relative="1" as="geometry"></mxGeometry></mxCell></object>
<mxCell id="revise--label" value="decide [else] / revise" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=1;fontColor=#292E35;spacing=0;labelBackgroundColor=#FFFFFF;" vertex="1" parent="1" syncRole="edge-label" ownerId="revise"><mxGeometry x="256.02" y="524" width="167.96" height="22" as="geometry"/></mxCell>
<object id="redraft" label="" componentId="redraft" stateType="edge" stateTransitionType="transition" variant="realtime" direction="forward" event="redraft"><mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#343A42;strokeWidth=1.6;endArrow=open;endFill=0;endSize=8;startArrow=none;exitX=0;exitY=0.7;exitDx=0;exitDy=0;exitPerimeter=1;entryX=0.4;entryY=1;entryDx=0;entryDy=0;entryPerimeter=1;" edge="1" parent="1" source="rejected" target="draft"><mxGeometry relative="1" as="geometry"><Array as="points"><mxPoint x="750" y="734"/><mxPoint x="750" y="850"/><mxPoint x="154" y="850"/></Array></mxGeometry></mxCell></object>
<mxCell id="redraft--label" value="redraft" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=1;fontColor=#292E35;spacing=0;labelBackgroundColor=#FFFFFF;" vertex="1" parent="1" syncRole="edge-label" ownerId="redraft"><mxGeometry x="576.96" y="859" width="66.08" height="22" as="geometry"/></mxCell>
<object id="publish" label="" componentId="publish" stateType="edge" stateTransitionType="transition" variant="realtime" direction="forward" event="publish" action="release"><mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#343A42;strokeWidth=1.6;endArrow=open;endFill=0;endSize=8;startArrow=none;exitX=1;exitY=0.5;exitDx=0;exitDy=0;exitPerimeter=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;entryPerimeter=1;" edge="1" parent="1" source="approved" target="published"><mxGeometry relative="1" as="geometry"></mxGeometry></mxCell></object>
<mxCell id="publish--label" value="publish / release" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=1;fontColor=#292E35;spacing=0;labelBackgroundColor=#FFFFFF;" vertex="1" parent="1" syncRole="edge-label" ownerId="publish"><mxGeometry x="1078" y="119" width="134" height="22" as="geometry"/></mxCell>
<object id="retire" label="" componentId="retire" stateType="edge" stateTransitionType="transition" variant="realtime" direction="forward" event="retire" action="archive"><mxCell style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeColor=#343A42;strokeWidth=1.6;endArrow=open;endFill=0;endSize=8;startArrow=none;exitX=1;exitY=0.5;exitDx=0;exitDy=0;exitPerimeter=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;entryPerimeter=1;" edge="1" parent="1" source="published" target="retired"><mxGeometry relative="1" as="geometry"></mxGeometry></mxCell></object>
<mxCell id="retire--label" value="retire / archive" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=1;fontColor=#292E35;spacing=0;labelBackgroundColor=#FFFFFF;" vertex="1" parent="1" syncRole="edge-label" ownerId="retire"><mxGeometry x="1461.72" y="119" width="126.56" height="22" as="geometry"/></mxCell>
<object id="draft" label="" componentId="draft" stateType="state" variant="realtime"><mxCell style="rounded=1;arcSize=4;whiteSpace=wrap;html=1;fillColor=#FFFFFF;strokeColor=#343A42;strokeWidth=1.6;" vertex="1" parent="1"><mxGeometry x="70" y="400" width="210" height="120" as="geometry"/></mxCell></object>
<mxCell id="draft--stereotype" value="[Initial State]" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=10;fontStyle=1;fontColor=#58616C;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="draft" syncRole="stereotype" ownerId="draft"><mxGeometry x="10" y="9" width="190" height="18" as="geometry"/></mxCell>
<mxCell id="draft--title" value="Draft" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=15;fontStyle=1;fontColor=#292E35;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="draft" syncRole="title" ownerId="draft"><mxGeometry x="10" y="31" width="190" height="28" as="geometry"/></mxCell>
<mxCell id="draft--description" value="Authoring and revision remain open." style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=0;fontColor=#58616C;spacing=0;align=center;verticalAlign=top;" vertex="1" parent="draft" syncRole="description" ownerId="draft"><mxGeometry x="14" y="65" width="182" height="45" as="geometry"/></mxCell>
<object id="in-review" label="" componentId="in-review" stateType="state" variant="delegated"><mxCell style="rounded=1;arcSize=4;whiteSpace=wrap;html=1;fillColor=#EDF3FF;strokeColor=#59697D;strokeWidth=1.6;" vertex="1" parent="1"><mxGeometry x="400" y="400" width="220" height="120" as="geometry"/></mxCell></object>
<mxCell id="in-review--stereotype" value="[State]" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=10;fontStyle=1;fontColor=#58616C;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="in-review" syncRole="stereotype" ownerId="in-review"><mxGeometry x="10" y="9" width="200" height="18" as="geometry"/></mxCell>
<mxCell id="in-review--title" value="In Review" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=15;fontStyle=1;fontColor=#292E35;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="in-review" syncRole="title" ownerId="in-review"><mxGeometry x="10" y="31" width="200" height="28" as="geometry"/></mxCell>
<mxCell id="in-review--description" value="Editorial and policy checks are running." style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=0;fontColor=#58616C;spacing=0;align=center;verticalAlign=top;" vertex="1" parent="in-review" syncRole="description" ownerId="in-review"><mxGeometry x="14" y="65" width="192" height="45" as="geometry"/></mxCell>
<object id="approved" label="" componentId="approved" stateType="state" variant="delegated"><mxCell style="rounded=1;arcSize=4;whiteSpace=wrap;html=1;fillColor=#EDF3FF;strokeColor=#59697D;strokeWidth=1.6;" vertex="1" parent="1"><mxGeometry x="850" y="160" width="210" height="120" as="geometry"/></mxCell></object>
<mxCell id="approved--stereotype" value="[State]" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=10;fontStyle=1;fontColor=#58616C;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="approved" syncRole="stereotype" ownerId="approved"><mxGeometry x="10" y="9" width="190" height="18" as="geometry"/></mxCell>
<mxCell id="approved--title" value="Approved" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=15;fontStyle=1;fontColor=#292E35;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="approved" syncRole="title" ownerId="approved"><mxGeometry x="10" y="31" width="190" height="28" as="geometry"/></mxCell>
<mxCell id="approved--description" value="All required checks passed." style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=0;fontColor=#58616C;spacing=0;align=center;verticalAlign=top;" vertex="1" parent="approved" syncRole="description" ownerId="approved"><mxGeometry x="14" y="65" width="182" height="45" as="geometry"/></mxCell>
<object id="rejected" label="" componentId="rejected" stateType="state" variant="delegated"><mxCell style="rounded=1;arcSize=4;whiteSpace=wrap;html=1;fillColor=#EDF3FF;strokeColor=#59697D;strokeWidth=1.6;" vertex="1" parent="1"><mxGeometry x="850" y="650" width="210" height="120" as="geometry"/></mxCell></object>
<mxCell id="rejected--stereotype" value="[State]" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=10;fontStyle=1;fontColor=#58616C;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="rejected" syncRole="stereotype" ownerId="rejected"><mxGeometry x="10" y="9" width="190" height="18" as="geometry"/></mxCell>
<mxCell id="rejected--title" value="Rejected" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=15;fontStyle=1;fontColor=#292E35;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="rejected" syncRole="title" ownerId="rejected"><mxGeometry x="10" y="31" width="190" height="28" as="geometry"/></mxCell>
<mxCell id="rejected--description" value="A blocking issue requires a new draft." style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=0;fontColor=#58616C;spacing=0;align=center;verticalAlign=top;" vertex="1" parent="rejected" syncRole="description" ownerId="rejected"><mxGeometry x="14" y="65" width="182" height="45" as="geometry"/></mxCell>
<object id="published" label="" componentId="published" stateType="state" variant="delegated"><mxCell style="rounded=1;arcSize=4;whiteSpace=wrap;html=1;fillColor=#EDF3FF;strokeColor=#59697D;strokeWidth=1.6;" vertex="1" parent="1"><mxGeometry x="1230" y="160" width="220" height="120" as="geometry"/></mxCell></object>
<mxCell id="published--stereotype" value="[State]" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=10;fontStyle=1;fontColor=#58616C;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="published" syncRole="stereotype" ownerId="published"><mxGeometry x="10" y="9" width="200" height="18" as="geometry"/></mxCell>
<mxCell id="published--title" value="Published" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=15;fontStyle=1;fontColor=#292E35;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="published" syncRole="title" ownerId="published"><mxGeometry x="10" y="31" width="200" height="28" as="geometry"/></mxCell>
<mxCell id="published--description" value="The approved article is publicly available." style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=0;fontColor=#58616C;spacing=0;align=center;verticalAlign=top;" vertex="1" parent="published" syncRole="description" ownerId="published"><mxGeometry x="14" y="65" width="192" height="45" as="geometry"/></mxCell>
<object id="retired" label="" componentId="retired" stateType="final-state" variant="critical"><mxCell style="rounded=1;arcSize=4;whiteSpace=wrap;html=1;fillColor=#FFF0F0;strokeColor=#B44343;strokeWidth=1.6;" vertex="1" parent="1"><mxGeometry x="1600" y="160" width="150" height="120" as="geometry"/></mxCell></object>
<mxCell id="retired--stereotype" value="[Final State]" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=10;fontStyle=1;fontColor=#58616C;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="retired" syncRole="stereotype" ownerId="retired"><mxGeometry x="10" y="9" width="130" height="18" as="geometry"/></mxCell>
<mxCell id="retired--title" value="Retired" style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=15;fontStyle=1;fontColor=#292E35;spacing=0;align=center;verticalAlign=middle;" vertex="1" parent="retired" syncRole="title" ownerId="retired"><mxGeometry x="10" y="31" width="130" height="28" as="geometry"/></mxCell>
<mxCell id="retired--description" value="The release lifecycle is complete." style="text;html=1;strokeColor=none;fillColor=none;whiteSpace=wrap;rounded=0;fontFamily=Meiryo UI;fontSize=12;fontStyle=0;fontColor=#58616C;spacing=0;align=center;verticalAlign=top;" vertex="1" parent="retired" syncRole="description" ownerId="retired"><mxGeometry x="14" y="65" width="122" height="45" as="geometry"/></mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>

diagram-spec.schema.json

45.7 KB

/schemas/diagram-spec.schema.json — Large, so it goes as a file (copy is for 32 KB and under)

Show contents
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://example.local/schemas/diagram-spec.schema.json",
  "title": "Editorial diagram semantic specification",
  "oneOf": [
    { "$ref": "#/$defs/legacyArchitectureSpec" },
    { "$ref": "#/$defs/architectureSpec" },
    { "$ref": "#/$defs/c4SystemContextSpec" },
    { "$ref": "#/$defs/c4ContainerSpec" },
    { "$ref": "#/$defs/dataFlowSpec" },
    { "$ref": "#/$defs/deploymentSpec" },
    { "$ref": "#/$defs/bpmnLiteSpec" },
    { "$ref": "#/$defs/sequenceSpec" },
    { "$ref": "#/$defs/erSpec" },
    { "$ref": "#/$defs/stateSpec" },
    { "$ref": "#/$defs/decisionTreeSpec" },
    { "$ref": "#/$defs/timelineSpec" },
    { "$ref": "#/$defs/roadmapSpec" },
    { "$ref": "#/$defs/capabilityMapSpec" },
    { "$ref": "#/$defs/executiveViewSpec" }
  ],
  "$defs": {
    "baseSpec": {
      "type": "object",
      "required": ["schemaVersion", "id", "title", "language", "legend", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "type": "string" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "legend": {
          "type": "array",
          "maxItems": 8,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": ["label", "variant"],
            "properties": {
              "label": { "type": "string", "minLength": 1, "maxLength": 60 },
              "variant": { "$ref": "#/$defs/variant" }
            }
          }
        },
        "boundaries": {
          "type": "array",
          "maxItems": 50,
          "items": { "$ref": "#/$defs/boundary" }
        },
        "nodes": {
          "type": "array",
          "minItems": 1,
          "items": { "$ref": "#/$defs/node" }
        },
        "edges": {
          "type": "array",
          "items": { "$ref": "#/$defs/edge" }
        }
      }
    },
    "legacyArchitectureSpec": {
      "type": "object",
      "allOf": [
        { "$ref": "#/$defs/baseSpec" },
        {
          "type": "object",
          "properties": {
            "schemaVersion": { "const": "1.0" }
          }
        }
      ],
      "unevaluatedProperties": false
    },
    "architectureSpec": {
      "type": "object",
      "allOf": [
        { "$ref": "#/$defs/baseSpec" },
        {
          "type": "object",
          "required": ["diagramKind"],
          "properties": {
            "schemaVersion": { "const": "2.0" },
            "diagramKind": { "const": "architecture" }
          }
        }
      ],
      "unevaluatedProperties": false
    },
    "c4SystemContextSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "schemaVersion", "diagramKind", "id", "title", "language", "scopeSystemId",
        "scopeBoundaryId", "boundaries", "nodes", "edges"
      ],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "c4-system-context" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "scopeSystemId": { "$ref": "#/$defs/id" },
        "scopeBoundaryId": { "$ref": "#/$defs/id" },
        "boundaries": {
          "type": "array",
          "minItems": 1,
          "maxItems": 8,
          "items": { "$ref": "#/$defs/c4SystemBoundary" }
        },
        "nodes": {
          "type": "array",
          "minItems": 2,
          "maxItems": 50,
          "items": { "$ref": "#/$defs/c4Element" }
        },
        "edges": {
          "type": "array",
          "minItems": 1,
          "maxItems": 100,
          "items": { "$ref": "#/$defs/c4Relationship" }
        }
      }
    },
    "c4SystemBoundary": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "system-boundary" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "c4Element": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["person", "software-system", "external-system"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "c4Relationship": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "from", "to", "type", "description"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "type": { "const": "relationship" },
        "description": { "type": "string", "minLength": 3, "maxLength": 160 },
        "technology": { "type": "string", "minLength": 1, "maxLength": 64 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "c4ContainerSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "schemaVersion", "diagramKind", "id", "title", "language", "contextDiagramId",
        "scopeSystemId", "scopeBoundaryId", "boundaries", "nodes", "edges"
      ],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "c4-container" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "contextDiagramId": { "$ref": "#/$defs/id" },
        "scopeSystemId": { "$ref": "#/$defs/id" },
        "scopeBoundaryId": { "$ref": "#/$defs/id" },
        "boundaries": {
          "type": "array",
          "minItems": 1,
          "maxItems": 8,
          "items": { "$ref": "#/$defs/c4SystemBoundary" }
        },
        "nodes": {
          "type": "array",
          "minItems": 1,
          "maxItems": 80,
          "items": { "$ref": "#/$defs/c4ContainerElement" }
        },
        "edges": {
          "type": "array",
          "minItems": 1,
          "maxItems": 160,
          "items": { "$ref": "#/$defs/c4Relationship" }
        }
      }
    },
    "c4ContainerElement": {
      "oneOf": [
        { "$ref": "#/$defs/c4ContainerPrimary" },
        { "$ref": "#/$defs/c4ContainerSupportingElement" }
      ]
    },
    "c4ContainerPrimary": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "containerKind", "title", "description", "technology"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "container" },
        "containerKind": { "enum": ["application", "data-store"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "technology": { "type": "string", "minLength": 1, "maxLength": 80 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "c4ContainerSupportingElement": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["person", "external-system"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "bpmnLiteSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "pool", "lanes", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "bpmn-lite" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "pool": { "$ref": "#/$defs/bpmnPool" },
        "lanes": {
          "type": "array",
          "minItems": 2,
          "maxItems": 16,
          "items": { "$ref": "#/$defs/bpmnLane" }
        },
        "nodes": {
          "type": "array",
          "minItems": 4,
          "maxItems": 160,
          "items": { "$ref": "#/$defs/bpmnFlowNode" }
        },
        "edges": {
          "type": "array",
          "minItems": 3,
          "maxItems": 320,
          "items": { "$ref": "#/$defs/bpmnSequenceFlow" }
        }
      }
    },
    "bpmnPool": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "pool" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "bpmnLane": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "lane" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "bpmnFlowNode": {
      "oneOf": [
        { "$ref": "#/$defs/bpmnSimpleFlowNode" },
        { "$ref": "#/$defs/bpmnGateway" }
      ]
    },
    "bpmnSimpleFlowNode": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "laneId"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["start-event", "end-event", "task"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "laneId": { "$ref": "#/$defs/id" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "bpmnGateway": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "laneId", "gatewayRole"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["exclusive-gateway", "parallel-gateway"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "laneId": { "$ref": "#/$defs/id" },
        "gatewayRole": { "enum": ["split", "join"] },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "bpmnSequenceFlow": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "from", "to"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "sequence-flow" },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "condition": { "type": "string", "minLength": 1, "maxLength": 160 },
        "isDefault": { "type": "boolean" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "sequenceSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "nodes", "fragments", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "sequence" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "nodes": { "type": "array", "minItems": 2, "maxItems": 32, "items": { "$ref": "#/$defs/sequenceLifeline" } },
        "fragments": { "type": "array", "maxItems": 24, "items": { "$ref": "#/$defs/sequenceFragment" } },
        "edges": { "type": "array", "minItems": 1, "maxItems": 320, "items": { "$ref": "#/$defs/sequenceMessage" } }
      }
    },
    "sequenceLifeline": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "occurrenceIds"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "lifeline" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "occurrenceIds": { "type": "array", "minItems": 1, "maxItems": 320, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "sequenceFragment": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "operator", "title", "operands"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "combined-fragment" },
        "operator": { "enum": ["alt", "opt", "par"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "operands": { "type": "array", "minItems": 1, "maxItems": 8, "items": { "$ref": "#/$defs/sequenceOperand" } },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "sequenceOperand": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "occurrenceIds"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "guard": { "type": "string", "minLength": 1, "maxLength": 120 },
        "occurrenceIds": { "type": "array", "minItems": 1, "maxItems": 160, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }
      }
    },
    "sequenceMessage": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "from", "to", "title", "sendOccurrenceId", "receiveOccurrenceId"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["sync-message", "async-message", "return-message"] },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "sendOccurrenceId": { "$ref": "#/$defs/id" },
        "receiveOccurrenceId": { "$ref": "#/$defs/id" },
        "replyTo": { "$ref": "#/$defs/id" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "erSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "er" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "nodes": { "type": "array", "minItems": 2, "maxItems": 120, "items": { "$ref": "#/$defs/erEntity" } },
        "edges": { "type": "array", "maxItems": 240, "items": { "$ref": "#/$defs/erForeignKey" } }
      }
    },
    "erEntity": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description", "attributes", "primaryKey", "uniqueKeys"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "entity" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "attributes": { "type": "array", "minItems": 1, "maxItems": 80, "items": { "$ref": "#/$defs/erAttribute" } },
        "primaryKey": { "$ref": "#/$defs/erKey" },
        "uniqueKeys": { "type": "array", "maxItems": 24, "items": { "$ref": "#/$defs/erKey" } },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "erAttribute": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "name", "dataType", "nullable"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "name": { "type": "string", "minLength": 1, "maxLength": 80 },
        "dataType": { "type": "string", "minLength": 1, "maxLength": 80 },
        "nullable": { "type": "boolean" }
      }
    },
    "erKey": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "attributeIds"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "attributeIds": { "type": "array", "maxItems": 16, "items": { "$ref": "#/$defs/id" } }
      }
    },
    "erForeignKey": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "from", "to", "fromAttributeIds", "toAttributeIds", "fromCardinality", "toCardinality", "identifying"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "foreign-key" },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "fromAttributeIds": { "type": "array", "maxItems": 16, "items": { "$ref": "#/$defs/id" } },
        "toAttributeIds": { "type": "array", "maxItems": 16, "items": { "$ref": "#/$defs/id" } },
        "fromCardinality": { "$ref": "#/$defs/erCardinality" },
        "toCardinality": { "$ref": "#/$defs/erCardinality" },
        "identifying": { "type": "boolean" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "erCardinality": { "enum": ["zero-or-one", "one", "zero-or-many", "one-or-many"] },
    "stateSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "initialStateId", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "state" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "initialStateId": { "$ref": "#/$defs/id" },
        "nodes": { "type": "array", "minItems": 2, "maxItems": 120, "items": { "$ref": "#/$defs/stateNode" } },
        "edges": { "type": "array", "minItems": 1, "maxItems": 240, "items": { "$ref": "#/$defs/stateTransition" } }
      }
    },
    "stateNode": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["state", "final-state"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "stateTransition": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "from", "to", "event"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "transition" },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "event": { "type": "string", "minLength": 1, "maxLength": 120 },
        "guard": { "type": "string", "minLength": 1, "maxLength": 160 },
        "action": { "type": "string", "minLength": 1, "maxLength": 160 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "decisionTreeSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "rootNodeId", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "decision-tree" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "rootNodeId": { "$ref": "#/$defs/id" },
        "nodes": { "type": "array", "minItems": 3, "maxItems": 160, "items": { "$ref": "#/$defs/decisionTreeNode" } },
        "edges": { "type": "array", "minItems": 2, "maxItems": 320, "items": { "$ref": "#/$defs/decisionBranch" } }
      }
    },
    "decisionTreeNode": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["decision", "outcome"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "decisionBranch": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "from", "to", "isDefault"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "branch" },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "condition": { "type": "string", "minLength": 1, "maxLength": 160 },
        "isDefault": { "type": "boolean" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "timelineSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "windowStart", "windowEnd", "workstreams", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "timeline" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "windowStart": { "$ref": "#/$defs/isoDate" },
        "windowEnd": { "$ref": "#/$defs/isoDate" },
        "workstreams": { "type": "array", "minItems": 1, "maxItems": 6, "items": { "$ref": "#/$defs/timelineWorkstream" } },
        "nodes": { "type": "array", "minItems": 1, "maxItems": 40, "items": { "$ref": "#/$defs/timelineItem" } },
        "edges": { "type": "array", "maxItems": 80, "items": { "$ref": "#/$defs/timelineDependency" } }
      }
    },
    "timelineWorkstream": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "workstream" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "timelineItem": {
      "oneOf": [
        { "$ref": "#/$defs/timelineTask" },
        { "$ref": "#/$defs/timelineMilestone" }
      ]
    },
    "timelineTask": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description", "workstreamId", "startDate", "endDate", "status"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "task" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "workstreamId": { "$ref": "#/$defs/id" },
        "startDate": { "$ref": "#/$defs/isoDate" },
        "endDate": { "$ref": "#/$defs/isoDate" },
        "status": { "$ref": "#/$defs/timelineStatus" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "timelineMilestone": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description", "workstreamId", "date", "status"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "milestone" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "workstreamId": { "$ref": "#/$defs/id" },
        "date": { "$ref": "#/$defs/isoDate" },
        "status": { "$ref": "#/$defs/timelineStatus" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "timelineDependency": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "from", "to"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "finish-to-start" },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "timelineStatus": { "enum": ["planned", "active", "blocked", "done"] },
    "isoDate": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
    "roadmapSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "vision", "horizons", "themes", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "roadmap" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "vision": { "type": "string", "minLength": 8, "maxLength": 180 },
        "horizons": { "type": "array", "minItems": 3, "maxItems": 3, "items": { "$ref": "#/$defs/roadmapHorizon" } },
        "themes": { "type": "array", "minItems": 1, "maxItems": 5, "items": { "$ref": "#/$defs/roadmapTheme" } },
        "nodes": { "type": "array", "minItems": 1, "maxItems": 24, "items": { "$ref": "#/$defs/roadmapInitiative" } },
        "edges": { "type": "array", "maxItems": 0 }
      }
    },
    "roadmapHorizon": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "kind", "title", "description"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "kind": { "enum": ["now", "next", "later"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 40 },
        "description": { "type": "string", "minLength": 3, "maxLength": 120 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "roadmapTheme": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "theme" },
        "title": { "type": "string", "minLength": 1, "maxLength": 60 },
        "description": { "type": "string", "minLength": 3, "maxLength": 160 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "roadmapInitiative": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description", "outcome", "themeId", "horizonId", "status"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "initiative" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 200 },
        "outcome": { "type": "string", "minLength": 8, "maxLength": 220 },
        "themeId": { "$ref": "#/$defs/id" },
        "horizonId": { "$ref": "#/$defs/id" },
        "status": { "enum": ["exploring", "planned", "active", "delivered"] },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "capabilityMapSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "scope", "domains", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "capability-map" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "scope": { "type": "string", "minLength": 8, "maxLength": 220 },
        "domains": { "type": "array", "minItems": 2, "maxItems": 6, "items": { "$ref": "#/$defs/capabilityDomain" } },
        "nodes": { "type": "array", "minItems": 2, "maxItems": 30, "items": { "$ref": "#/$defs/capability" } },
        "edges": { "type": "array", "maxItems": 0 }
      }
    },
    "capabilityDomain": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "domain" },
        "title": { "type": "string", "minLength": 1, "maxLength": 60 },
        "description": { "type": "string", "minLength": 3, "maxLength": 160 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "capability": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description", "domainId", "strategicImportance"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "capability" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 200 },
        "domainId": { "$ref": "#/$defs/id" },
        "strategicImportance": { "enum": ["low", "medium", "high"] },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "executiveViewSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "asOfDate", "objective", "recommendation", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "executive-view" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "asOfDate": { "$ref": "#/$defs/isoDate" },
        "objective": { "type": "string", "minLength": 8, "maxLength": 220 },
        "recommendation": { "type": "string", "minLength": 8, "maxLength": 240 },
        "nodes": { "type": "array", "minItems": 4, "maxItems": 13, "items": { "$ref": "#/$defs/executiveItem" } },
        "edges": { "type": "array", "maxItems": 0 }
      }
    },
    "executiveItem": {
      "oneOf": [
        { "$ref": "#/$defs/executiveIndicator" },
        { "$ref": "#/$defs/executiveRisk" },
        { "$ref": "#/$defs/executiveDecision" }
      ]
    },
    "executiveIndicator": {
      "type": "object", "additionalProperties": false,
      "required": ["id", "type", "title", "description", "value", "target", "trend", "status"],
      "properties": {
        "id": { "$ref": "#/$defs/id" }, "type": { "const": "indicator" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 200 },
        "value": { "type": "string", "minLength": 1, "maxLength": 60 },
        "target": { "type": "string", "minLength": 1, "maxLength": 60 },
        "trend": { "enum": ["improving", "steady", "declining"] },
        "status": { "enum": ["on-track", "at-risk", "off-track"] },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "executiveRisk": {
      "type": "object", "additionalProperties": false,
      "required": ["id", "type", "title", "description", "impact", "response", "status"],
      "properties": {
        "id": { "$ref": "#/$defs/id" }, "type": { "const": "risk" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 200 },
        "impact": { "enum": ["low", "medium", "high"] },
        "response": { "type": "string", "minLength": 3, "maxLength": 220 },
        "status": { "enum": ["open", "watch", "mitigated"] },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "executiveDecision": {
      "type": "object", "additionalProperties": false,
      "required": ["id", "type", "title", "description", "recommendation", "status"],
      "properties": {
        "id": { "$ref": "#/$defs/id" }, "type": { "const": "decision" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 200 },
        "recommendation": { "type": "string", "minLength": 3, "maxLength": 220 },
        "status": { "enum": ["open", "approved", "deferred"] },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "dataFlowSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": ["schemaVersion", "diagramKind", "id", "title", "language", "boundaries", "nodes", "edges"],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "data-flow" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "boundaries": {
          "type": "array",
          "maxItems": 32,
          "items": { "$ref": "#/$defs/dataFlowTrustBoundary" }
        },
        "nodes": {
          "type": "array",
          "minItems": 2,
          "maxItems": 120,
          "items": { "$ref": "#/$defs/dataFlowNode" }
        },
        "edges": {
          "type": "array",
          "minItems": 1,
          "maxItems": 240,
          "items": { "$ref": "#/$defs/dataFlowEdge" }
        }
      }
    },
    "dataFlowTrustBoundary": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "trustLevel"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "trust-boundary" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "trustLevel": { "enum": ["external", "controlled", "restricted"] },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "dataFlowNode": {
      "oneOf": [
        { "$ref": "#/$defs/dataFlowSimpleNode" },
        { "$ref": "#/$defs/dataFlowProcess" },
        { "$ref": "#/$defs/dataFlowDataStore" }
      ]
    },
    "dataFlowSimpleNode": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["source", "sink", "external-system"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "dataFlowProcess": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description", "transformation"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "process" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "transformation": { "type": "string", "minLength": 3, "maxLength": 160 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "dataFlowDataStore": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description", "classification"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "data-store" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "classification": { "$ref": "#/$defs/dataClassification" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "dataFlowEdge": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "from", "to", "type", "dataName", "format", "frequency", "mode", "classification"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "type": { "const": "data-flow" },
        "dataName": { "type": "string", "minLength": 1, "maxLength": 100 },
        "format": { "type": "string", "minLength": 1, "maxLength": 80 },
        "frequency": { "type": "string", "minLength": 1, "maxLength": 80 },
        "mode": { "enum": ["batch", "streaming", "request-response"] },
        "classification": { "$ref": "#/$defs/dataClassification" },
        "trustBoundaryIds": {
          "type": "array",
          "maxItems": 32,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/id" }
        },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "dataClassification": { "enum": ["public", "internal", "confidential", "restricted"] },
    "deploymentSpec": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "schemaVersion", "diagramKind", "id", "title", "language", "environment",
        "entryNodeIds", "boundaries", "nodes", "edges"
      ],
      "properties": {
        "$schema": { "type": "string" },
        "schemaVersion": { "const": "2.0" },
        "diagramKind": { "const": "deployment" },
        "id": { "$ref": "#/$defs/id" },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 500 },
        "language": { "enum": ["en", "ja", "mixed"] },
        "metadata": { "$ref": "#/$defs/metadata" },
        "environment": { "type": "string", "minLength": 1, "maxLength": 80 },
        "entryNodeIds": {
          "type": "array",
          "minItems": 1,
          "maxItems": 32,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/id" }
        },
        "boundaries": {
          "type": "array",
          "minItems": 4,
          "maxItems": 64,
          "items": { "$ref": "#/$defs/deploymentBoundary" }
        },
        "nodes": {
          "type": "array",
          "minItems": 2,
          "maxItems": 160,
          "items": { "$ref": "#/$defs/deploymentNode" }
        },
        "edges": {
          "type": "array",
          "minItems": 1,
          "maxItems": 320,
          "items": { "$ref": "#/$defs/deploymentCommunication" }
        }
      }
    },
    "deploymentBoundary": {
      "oneOf": [
        { "$ref": "#/$defs/deploymentCloudProvider" },
        { "$ref": "#/$defs/deploymentRegion" },
        { "$ref": "#/$defs/deploymentNetworkBoundary" }
      ]
    },
    "deploymentCloudProvider": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "cloud-provider" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "deploymentRegion": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "parentId"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "region" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "parentId": { "$ref": "#/$defs/id" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "deploymentNetworkBoundary": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "parentId", "exposure"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["network", "subnet"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "parentId": { "$ref": "#/$defs/id" },
        "exposure": { "$ref": "#/$defs/networkExposure" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "deploymentNode": {
      "oneOf": [
        { "$ref": "#/$defs/deploymentExternalSystem" },
        { "$ref": "#/$defs/deploymentManagedNode" }
      ]
    },
    "deploymentExternalSystem": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description", "technology", "exposure"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "const": "external-system" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "technology": { "type": "string", "minLength": 1, "maxLength": 100 },
        "exposure": { "const": "public" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "deploymentManagedNode": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "description", "technology", "exposure", "boundaryId"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["gateway", "load-balancer", "firewall", "host", "service", "database"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "description": { "type": "string", "minLength": 3, "maxLength": 240 },
        "technology": { "type": "string", "minLength": 1, "maxLength": 100 },
        "exposure": { "$ref": "#/$defs/networkExposure" },
        "boundaryId": { "$ref": "#/$defs/id" },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "deploymentCommunication": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "from", "to", "type", "description", "protocol", "port"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "type": { "const": "communication" },
        "description": { "type": "string", "minLength": 3, "maxLength": 160 },
        "protocol": { "type": "string", "minLength": 1, "maxLength": 40 },
        "port": { "type": "integer", "minimum": 1, "maximum": 65535 },
        "boundaryIds": {
          "type": "array",
          "maxItems": 64,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/id" }
        },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "networkExposure": { "enum": ["public", "private", "restricted"] },
    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
    "variant": { "enum": ["realtime", "delegated", "external", "warning", "critical"] },
    "status": { "enum": ["planned", "experimental", "beta", "stable", "deprecated", "retired"] },
    "metadata": {
      "type": "object",
      "additionalProperties": { "type": "string", "maxLength": 200 }
    },
    "boundary": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "variant", "title"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": { "enum": ["system", "network", "trust", "organization", "runtime"] },
        "variant": { "$ref": "#/$defs/variant" },
        "title": { "type": "string", "minLength": 1, "maxLength": 80 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "node": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "variant", "status", "title"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "type": {
          "enum": [
            "actor", "client", "frontend", "backend", "api", "service", "model", "agent",
            "tool", "database", "cache", "queue", "event-bus", "storage", "batch-job",
            "external-service", "observability", "security", "network", "note"
          ]
        },
        "variant": { "$ref": "#/$defs/variant" },
        "status": { "$ref": "#/$defs/status" },
        "title": { "type": "string", "minLength": 1, "maxLength": 60 },
        "subtitle": { "type": "string", "maxLength": 100 },
        "icon": { "$ref": "#/$defs/id" },
        "controls": {
          "type": "array",
          "maxItems": 8,
          "items": { "type": "string", "minLength": 1, "maxLength": 32 }
        },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    },
    "edge": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "from", "to", "type", "variant", "direction"],
      "properties": {
        "id": { "$ref": "#/$defs/id" },
        "from": { "$ref": "#/$defs/id" },
        "to": { "$ref": "#/$defs/id" },
        "type": {
          "enum": [
            "sync-request", "async-request", "realtime-stream", "event", "batch", "data-read",
            "data-write", "control", "monitoring", "authentication"
          ]
        },
        "variant": { "$ref": "#/$defs/variant" },
        "label": { "type": "string", "maxLength": 80 },
        "direction": { "enum": ["forward", "bidirectional"] },
        "protocol": { "type": "string", "maxLength": 32 },
        "metadata": { "$ref": "#/$defs/metadata" }
      }
    }
  }
}

layout.schema.json

2.9 KB

/schemas/layout.schema.json

Show contents
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://example.local/schemas/layout.schema.json",
  "title": "Architecture diagram layout",
  "type": "object",
  "additionalProperties": false,
  "required": ["schemaVersion", "canvas", "nodes", "edges"],
  "properties": {
    "$schema": { "type": "string" },
    "schemaVersion": { "const": "1.0" },
    "canvas": {
      "type": "object",
      "additionalProperties": false,
      "required": ["width", "height"],
      "properties": {
        "width": { "type": "integer", "minimum": 320, "maximum": 10000 },
        "height": { "type": "integer", "minimum": 240, "maximum": 10000 }
      }
    },
    "boundaries": {
      "type": "object",
      "additionalProperties": { "$ref": "#/$defs/boundaryGeometry" }
    },
    "nodes": {
      "type": "object",
      "additionalProperties": { "$ref": "#/$defs/nodeGeometry" }
    },
    "edges": {
      "type": "object",
      "additionalProperties": { "$ref": "#/$defs/edgeGeometry" }
    }
  },
  "$defs": {
    "point": {
      "type": "object",
      "additionalProperties": false,
      "required": ["x", "y"],
      "properties": {
        "x": { "type": "number", "minimum": 0, "maximum": 10000 },
        "y": { "type": "number", "minimum": 0, "maximum": 10000 }
      }
    },
    "port": {
      "type": "object",
      "additionalProperties": false,
      "required": ["side", "offset"],
      "properties": {
        "side": { "enum": ["top", "right", "bottom", "left"] },
        "offset": { "type": "number", "minimum": 0, "maximum": 1 }
      }
    },
    "nodeGeometry": {
      "type": "object",
      "additionalProperties": false,
      "required": ["x", "y", "width", "height"],
      "properties": {
        "x": { "type": "number", "minimum": 0, "maximum": 10000 },
        "y": { "type": "number", "minimum": 0, "maximum": 10000 },
        "width": { "type": "number", "minimum": 40, "maximum": 3000 },
        "height": { "type": "number", "minimum": 30, "maximum": 3000 }
      }
    },
    "boundaryGeometry": {
      "type": "object",
      "additionalProperties": false,
      "required": ["x", "y", "width", "height"],
      "properties": {
        "x": { "type": "number", "minimum": 0, "maximum": 10000 },
        "y": { "type": "number", "minimum": 0, "maximum": 10000 },
        "width": { "type": "number", "minimum": 120, "maximum": 10000 },
        "height": { "type": "number", "minimum": 80, "maximum": 10000 }
      }
    },
    "edgeGeometry": {
      "type": "object",
      "additionalProperties": false,
      "required": ["source", "target"],
      "properties": {
        "source": { "$ref": "#/$defs/port" },
        "target": { "$ref": "#/$defs/port" },
        "waypoints": {
          "type": "array",
          "maxItems": 20,
          "items": { "$ref": "#/$defs/point" }
        },
        "label": { "$ref": "#/$defs/point" }
      }
    }
  }
}