skilldrop-cli 1.6.0 → 1.8.0

package/packs/event-planner/skills/run-of-show/evals/files/6/venue_rooms_and_crew.txt

@@ -0,0 +1,14 @@
+Kettleby Folk & Word Festival - Sat 6 March 2027 - The Kettleby Exchange
+Rooms / hours / changeovers (from the venue tech spec + my emails with them)
+
+MAIN HALL  - craft fair in there till 13:30, so first act on 14:00 at the earliest. Noise curfew 23:00 (last note by 23:00).
+             Changeover between acts: 30 min (band kit, line check).  Crew: stage manager Pat Rourke, sound Jules Amadi, lights Sacha Bell
+STUDIO     - available 11:30 to 22:00.  Changeover 15 min.  Crew: stage manager Freya Lund, sound Benedikt Roth
+LIBRARY ROOM - library is open to us 12:00-17:30 only (they lock up at half 5).  Changeover 10 min.  Crew: room host (volunteer) Anne Pickles
+COURTYARD STAGE - street-use permit 12:00-15:30 only.  Changeover 15 min.  Crew: stage manager Tom Garbutt, sound Ivo Mertens
+
+BSL interpreter: Ruth Penhaligon - one interpreter for the day. She's booked for the three sessions marked BSL
+(the Writing the Land talk, the poetry slam, Kit Harrow).
+
+Anyone in two places on the day (performers or Ruth) needs at least 15 minutes between finishing in one room and starting
+in another - the Exchange is a rabbit warren.

package/packs/event-planner/skills/run-of-show/evals/files/7/runsheet_draft_v4.csv

@@ -0,0 +1,25 @@
+Start,End,Room,Item,Speakers / talent,Crew needed,Notes
+08:00,09:30,Hall,Tech rehearsal,Imran Kestrel; Ana Ruiz; Gemma Thorne,"AV team x3, stage manager",
+09:00,10:00,Terrace,Arrival coffee,,Catering,
+10:00,10:40,Hall,Welcome & keynote,Imran Kestrel; Gemma Thorne,"AV team x3, stage manager, camera x2",embargo lifts 10:00
+10:30,10:50,Green Room,Press interview - Tech Weekly,Imran Kestrel,Press officer,
+10:40,17:30,Atrium,Demo zone (Lumio Fold 2 hands-on),,Demo crew x4,
+10:50,11:30,Hall,Product demo,Ana Ruiz,"AV team x3, stage manager, camera x2",
+10:55,11:15,Green Room,Press interview - Retail Insider,Owen Strand,Press officer,
+11:00,11:45,Studio B,Developer breakout,Tom Vickers; Hana Sato,AV x1,
+11:30,12:15,Studio B,Retail partners briefing,Owen Strand; Ines Duarte,AV x1,
+11:50,12:10,Green Room,Press interview - Gadget Desk,Ana Ruiz,Press officer,
+12:00,12:45,Hall,Customer stories panel,Gemma Thorne; Ifeoma Ndukwe; Lars Pettersen; Carys Bowen,"AV team x3, stage manager",
+12:15,12:35,Green Room,Press interview - DevWire,Tom Vickers,Press officer,
+12:45,13:40,Terrace,Lunch,,Catering,caterer can only do 12:45
+14:00,14:45,Studio B,Accessibility features deep-dive,Hana Sato,AV x1,
+14:00,15:00,Hall,Lumio Live (livestream),Imran Kestrel; Ana Ruiz; Gemma Thorne,"Pixelhaus broadcast crew, AV team x3, stage manager",FIXED - broadcast partner slot
+15:00,15:45,Studio B,Enterprise security briefing,Tom Vickers,AV x1,
+15:15,15:35,Green Room,Press interview - Business Daily,Imran Kestrel,Press officer,
+15:20,16:20,Hall,Partner panel,Gemma Thorne; Rohan Mehta; Ines Duarte,"AV team x3, stage manager",
+15:40,16:00,Green Room,Press interview - Mobile Matters,Ana Ruiz,Press officer,
+16:00,16:45,Studio B,Partner onboarding clinic,Owen Strand,AV x1,
+16:05,16:25,Green Room,Press interview - Access Today,Hana Sato,Press officer,
+16:40,17:25,Hall,Engineering Q&A,Tom Vickers; Ana Ruiz,"AV team x3, stage manager",
+17:45,18:45,Hall,Closing & customer awards,Imran Kestrel; Gemma Thorne,"AV team x3, stage manager, camera x2",6 awards
+18:00,18:45,Terrace,Drinks reception,,"Catering, bar",

package/packs/event-planner/skills/run-of-show/evals/files/7/venue_and_fixed_times.txt

@@ -0,0 +1,24 @@
+Lumio Fold 2 launch - Thu 21 Jan 2027 - The Granary Rooms
+(from the venue contract + our own fixed points)
+
+VENUE
+- Crew access from 08:00. Guests arrive 09:00.
+- The HALL must be completely clear by 18:00 - the venue has an evening booking getting in from 18:00. No flex, it's in the contract.
+- Studio B, Green Room and Atrium available until 18:30; Terrace until 19:00 (building closes 19:00).
+- Hall seats 300 (all guests). Studio B seats 80. Green Room is for press only (holds 6).
+
+TURNAROUND between sessions
+- Hall: 20 min stage reset between sessions (AV company's minimum)
+- Studio B: 10 min
+- Green Room: 5 min between interviews
+- Atrium/Terrace: n/a (catering + demo zone)
+
+PEOPLE
+- Speakers need at least 10 min to get from one room to another (and be mic'd).
+
+FIXED - CAN'T MOVE
+- Keynote at 10:00 (press embargo lifts 10:00, it's on the invite)
+- Hall tech rehearsal until 09:30
+- Lumio Live livestream in the Hall 14:00-15:00 (broadcast partner's slot)
+- Lunch on the Terrace 12:45-13:40 (caterer)
+- All Hall sessions are for the whole audience of 300, so they have to stay in the Hall

package/packs/event-planner/skills/run-of-show/examples/product-launch.md

@@ -0,0 +1,77 @@
+# Worked example: a product launch day
+
+Input → output oracle for `run-of-show`. Shows an agenda that reads fine and has four clashes:
+a keynote's stage setup colliding with doors in the same room, two handovers shorter than the
+room needs, and the CEO due in the demo lab the minute her keynote ends.
+
+## Input
+
+> Here's the launch day. Auditorium 8:00–18:00, needs 20 minutes to turn over between
+> sessions; the demo lab is 9:00–17:00, 10 minutes. It's a five-minute walk between them, and
+> we've told people we finish at 17:00.
+>
+> - 8:30–9:00 doors and coffee, auditorium
+> - 9:00–9:45 launch keynote, Mara (CEO); AV needs 30 minutes on stage before it
+> - 9:45–10:30 live demo of the setup flow, demo lab, Mara and Theo
+> - 10:00–11:00 customer panel, auditorium, Ines hosting; the stage takes 25 minutes to strike after
+> - 11:15–12:15 lunch, auditorium
+> - 13:00–15:30 hands-on lab, demo lab, Theo
+> - 16:45–17:15 closing remarks, Mara
+
+## The agenda as given, checked
+
+```
+FAIL Auditorium: 0 min between Doors and coffee (08:30) and Launch keynote (09:00), 30 min needed for Launch keynote's setup
+FAIL Auditorium: 15 min between Launch keynote (09:00) and Customer panel (10:00), 20 min needed for the room's turnaround
+FAIL Auditorium: 15 min between Customer panel (10:00) and Lunch (11:15), 25 min needed for Customer panel's changeover
+FAIL Mara Quinn (CEO) has 0 min to get from Auditorium to Demo lab between Launch keynote and Live demo: setup flow; the walk takes 5
+WARN Auditorium is empty for 270 min between Lunch and Closing remarks
+WARN Demo lab is empty for 150 min between Live demo: setup flow and Hands-on lab
+WARN Closing remarks ends at 17:15, 15 min after the published end of 17:00
+4 failure(s)
+```
+
+Each one has a small fix that moves as little as possible. Doors and coffee go to the foyer,
+so the stage crew has the auditorium from 8:30. The demo starts five minutes later, so Mara
+can walk over. The panel moves 5 minutes and lunch 15, so each handover gets the time the
+room needs. Closing starts 15 minutes earlier, to end on time.
+
+## The reply
+
+**No room or person is booked twice, and the day ends at 17:00 as published.** Five times
+moved from your agenda, each by 15 minutes or less.
+
+| Time | Room | Item | Who's needed |
+|---|---|---|---|
+| 08:30–09:00 | Foyer | Doors and coffee | Front of house |
+| 09:00–09:45 | Auditorium | Launch keynote | Mara, AV crew (on stage from 08:30) |
+| 09:50–10:35 | Demo lab | Live demo: setup flow | Mara, Theo |
+| 10:05–11:05 | Auditorium | Customer panel | Ines, AV crew |
+| 11:30–12:30 | Auditorium | Lunch | |
+| 13:00–15:30 | Demo lab | Hands-on lab | Theo |
+| 16:30–17:00 | Auditorium | Closing remarks | Mara |
+
+**What moved, and why:**
+- **Doors and coffee to the foyer.** The keynote stage needs 30 minutes and the room opened
+  for coffee at 8:30.
+- **Live demo to 09:50.** Mara's keynote ends at 09:45, and the lab is a five-minute walk.
+- **Panel to 10:05, lunch to 11:30.** The auditorium needs 20 minutes between sessions, and 25
+  after the panel to strike the stage.
+- **Closing remarks to 16:30.** They ended at 17:15, after the time you've published.
+
+**Assumption:** `[assumption]` the foyer is free from 08:00. If it isn't, the keynote moves to
+09:30 instead, and everything after it moves 30 minutes.
+
+The auditorium sits empty from 12:30 to 16:30 while the hands-on lab runs. That's fine if
+everyone is in the lab; if not, it's the obvious slot for a second session.
+
+The timeline, one lane per room, is in `run-of-show.svg`.
+
+## Why this is the oracle
+
+- **Setup, turnaround and changeover are checked as well as overlaps.** A plain read sees no
+  two sessions at the same time in one room, and calls the agenda clash-free.
+- **People are checked across rooms, with the walk.** The CEO's back-to-back across two rooms
+  is the clash crews find on the day.
+- **Each fix is the smallest move, and the reply lists them.** It doesn't silently re-time the
+  day or squeeze the stage strike to fit.

package/packs/event-planner/skills/run-of-show/examples/product-launch.svg

@@ -0,0 +1,58 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1280 316" width="1280" height="316" font-family="Helvetica, Arial, sans-serif">
+<rect width="1280" height="316" fill="#ffffff"/>
+<text x="20" y="28" font-size="16" font-weight="bold">Run of show</text>
+<line x1="150.0" y1="60" x2="150.0" y2="252" stroke="#cfd8dc"/>
+<text x="150.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">08:00</text>
+<line x1="205.0" y1="60" x2="205.0" y2="252" stroke="#eceff1"/>
+<line x1="260.0" y1="60" x2="260.0" y2="252" stroke="#cfd8dc"/>
+<text x="260.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">09:00</text>
+<line x1="315.0" y1="60" x2="315.0" y2="252" stroke="#eceff1"/>
+<line x1="370.0" y1="60" x2="370.0" y2="252" stroke="#cfd8dc"/>
+<text x="370.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">10:00</text>
+<line x1="425.0" y1="60" x2="425.0" y2="252" stroke="#eceff1"/>
+<line x1="480.0" y1="60" x2="480.0" y2="252" stroke="#cfd8dc"/>
+<text x="480.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">11:00</text>
+<line x1="535.0" y1="60" x2="535.0" y2="252" stroke="#eceff1"/>
+<line x1="590.0" y1="60" x2="590.0" y2="252" stroke="#cfd8dc"/>
+<text x="590.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">12:00</text>
+<line x1="645.0" y1="60" x2="645.0" y2="252" stroke="#eceff1"/>
+<line x1="700.0" y1="60" x2="700.0" y2="252" stroke="#cfd8dc"/>
+<text x="700.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">13:00</text>
+<line x1="755.0" y1="60" x2="755.0" y2="252" stroke="#eceff1"/>
+<line x1="810.0" y1="60" x2="810.0" y2="252" stroke="#cfd8dc"/>
+<text x="810.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">14:00</text>
+<line x1="865.0" y1="60" x2="865.0" y2="252" stroke="#eceff1"/>
+<line x1="920.0" y1="60" x2="920.0" y2="252" stroke="#cfd8dc"/>
+<text x="920.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">15:00</text>
+<line x1="975.0" y1="60" x2="975.0" y2="252" stroke="#eceff1"/>
+<line x1="1030.0" y1="60" x2="1030.0" y2="252" stroke="#cfd8dc"/>
+<text x="1030.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">16:00</text>
+<line x1="1085.0" y1="60" x2="1085.0" y2="252" stroke="#eceff1"/>
+<line x1="1140.0" y1="60" x2="1140.0" y2="252" stroke="#cfd8dc"/>
+<text x="1140.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">17:00</text>
+<line x1="1195.0" y1="60" x2="1195.0" y2="252" stroke="#eceff1"/>
+<line x1="1250.0" y1="60" x2="1250.0" y2="252" stroke="#cfd8dc"/>
+<text x="1250.0" y="57" font-size="10" text-anchor="middle" fill="#607d8b">18:00</text>
+<text x="20" y="96" font-size="12" fill="#263238">Auditorium</text><line x1="150" y1="124" x2="1250.0" y2="124" stroke="#b0bec5"/>
+<rect x="150.0" y="62" width="1100.0" height="60" fill="#f1f8e9" opacity="0.6"/>
+<rect x="205.0" y="68" width="55.0" height="48" fill="#fff8e1" stroke="#ffb300" stroke-dasharray="3,2"/>
+<rect x="260.0" y="66" width="82.5" height="52" rx="4" fill="#e3f2fd" stroke="#1565c0" stroke-width="1"/>
+<text x="264.0" y="84" font-size="10" fill="#0d47a1">Launch keyno…</text><text x="264.0" y="98" font-size="9" fill="#546e7a">09:00–09:45</text>
+<rect x="379.2" y="66" width="110.0" height="52" rx="4" fill="#e3f2fd" stroke="#1565c0" stroke-width="1"/>
+<text x="383.2" y="84" font-size="10" fill="#0d47a1">Customer panel</text><text x="383.2" y="98" font-size="9" fill="#546e7a">10:05–11:05</text>
+<rect x="535.0" y="66" width="110.0" height="52" rx="4" fill="#e3f2fd" stroke="#1565c0" stroke-width="1"/>
+<text x="539.0" y="84" font-size="10" fill="#0d47a1">Lunch</text><text x="539.0" y="98" font-size="9" fill="#546e7a">11:30–12:30</text>
+<rect x="1085.0" y="66" width="55.0" height="52" rx="4" fill="#e3f2fd" stroke="#1565c0" stroke-width="1"/>
+<text x="1089.0" y="84" font-size="10" fill="#0d47a1">Closing…</text><text x="1089.0" y="98" font-size="9" fill="#546e7a">16:30–17:00</text>
+<text x="20" y="160" font-size="12" fill="#263238">Demo lab</text><line x1="150" y1="188" x2="1250.0" y2="188" stroke="#b0bec5"/>
+<rect x="260.0" y="126" width="880.0" height="60" fill="#f1f8e9" opacity="0.6"/>
+<rect x="351.7" y="130" width="82.5" height="52" rx="4" fill="#e3f2fd" stroke="#1565c0" stroke-width="1"/>
+<text x="355.7" y="148" font-size="10" fill="#0d47a1">Live demo: s…</text><text x="355.7" y="162" font-size="9" fill="#546e7a">09:50–10:35</text>
+<rect x="700.0" y="130" width="275.0" height="52" rx="4" fill="#e3f2fd" stroke="#1565c0" stroke-width="1"/>
+<text x="704.0" y="148" font-size="10" fill="#0d47a1">Hands-on lab</text><text x="704.0" y="162" font-size="9" fill="#546e7a">13:00–15:30</text>
+<text x="20" y="224" font-size="12" fill="#263238">Foyer</text><line x1="150" y1="252" x2="1250.0" y2="252" stroke="#b0bec5"/>
+<rect x="150.0" y="190" width="1100.0" height="60" fill="#f1f8e9" opacity="0.6"/>
+<rect x="205.0" y="194" width="55.0" height="52" rx="4" fill="#e3f2fd" stroke="#1565c0" stroke-width="1"/>
+<text x="209.0" y="212" font-size="10" fill="#0d47a1">Doors a…</text><text x="209.0" y="226" font-size="9" fill="#546e7a">08:30–09:00</text>
+<text x="20" y="282" font-size="12" fill="#2e7d32">PASS: no clashes</text><text x="20" y="298" font-size="10" fill="#666">Dashed amber: setup before an item · green band: room open</text>
+</svg>

package/packs/event-planner/skills/run-of-show/manifest.json

@@ -0,0 +1,44 @@
+{
+  "name": "run-of-show",
+  "version": "0.1.2",
+  "description": "Turn an event's agenda into a timed run of show — every session, speaker, changeover and break with its start, end, room and who's needed — and check it with a script for two things in one room at once, a speaker booked in two places, changeovers shorter than the turnaround and anything outside venue hours, drawn as a timeline per room. Use when an organiser asks for \"a run of show\", \"a running order\", \"the minute-by-minute for the day\", \"check the agenda for clashes\", or has sessions, speakers and rooms for a conference, launch, festival or wedding day.",
+  "entrypoint": "SKILL.md",
+  "deps": {
+    "npm": [],
+    "pip": []
+  },
+  "env": {
+    "required": [],
+    "optional": []
+  },
+  "related": [
+    "seating-plan"
+  ],
+  "handoff": [
+    {
+      "to": "seating-plan",
+      "when": "the day includes a seated meal or dinner",
+      "purpose": "Seat the dinner guests so every together, apart and access request holds.",
+      "fallback": "If seating-plan is absent, list each table with its guests and check by hand that no table is over its count and every keep-apart pair is split."
+    }
+  ],
+  "tags": [
+    "events",
+    "run-of-show",
+    "agenda",
+    "schedule",
+    "conference",
+    "timeline",
+    "svg"
+  ],
+  "permissions": {
+    "network": [],
+    "commands": [],
+    "files": "named-paths",
+    "notes": "Reads the show.json it is given and writes the SVG to the path passed with --svg."
+  },
+  "model": {
+    "tier": "standard",
+    "rationale": "Ordering a day around rooms and people is bounded judgment; the script decides whether anything clashes."
+  }
+}

package/packs/event-planner/skills/run-of-show/scripts/show_check.py

@@ -0,0 +1,295 @@
+#!/usr/bin/env python3
+"""Check an event's run of show for clashes and draw it as a timeline. Stdlib only.
+
+Reads a show.json: the rooms (opening hours, turnaround between items), the items (title,
+room, start, end or duration, the people needed, setup minutes needed in the room before it
+starts, changeover minutes needed after it), the travel minutes between rooms, and the
+published end of the day. It fails a show where
+  - an item ends before it starts
+  - two items overlap in one room
+  - the gap between two items in a room is shorter than the turnaround, the next item's
+    setup or the last item's changeover
+  - an item, with its setup, runs outside its room's opening hours
+  - a person is needed in two places at once, or has less than the travel time between
+    rooms
+and warns where
+  - a person works more than --max-hours without a break of --break minutes
+  - a room sits empty for more than --max-gap minutes between items
+  - the last item ends after the published end
+Then it prints the running order, and with --svg draws one lane per room with each item as
+a block at its times, failures in red.
+
+Times are 24-hour "HH:MM". Items on several days carry a "day" (any label, such as
+"2026-06-12" or "Day 2"); each day is checked on its own.
+
+Usage:
+  python3 show_check.py show.json [--svg timeline.svg] [--json]
+                        [--max-hours 3] [--break 15] [--max-gap 45]
+Exit codes: 0 no failures, 1 a failure, 2 bad input.
+"""
+import argparse
+import json
+import math
+import re
+import sys
+
+TIME = re.compile(r"^([01]?\d|2[0-4]):([0-5]\d)$")
+
+
+class BadInput(ValueError):
+    pass
+
+
+def minutes(v, what):
+    """'09:30' -> 570. Raises BadInput."""
+    m = TIME.match(str(v).strip()) if v is not None else None
+    if not m or (int(m.group(1)) == 24 and m.group(2) != "00"):
+        raise BadInput(f"{what} must be a 24-hour time like 09:30, got {v!r}")
+    return int(m.group(1)) * 60 + int(m.group(2))
+
+
+def hhmm(n):
+    return f"{int(n) // 60:02d}:{int(n) % 60:02d}"
+
+
+def _mins(v, what):
+    if isinstance(v, bool) or not isinstance(v, (int, float)) or not math.isfinite(v) or v < 0:
+        raise BadInput(f"{what} must be a number of minutes, got {v!r}")
+    return float(v)
+
+
+def load(data):
+    if not isinstance(data, dict):
+        raise BadInput("the file must hold a JSON object")
+    default_turn = _mins(data.get("turnaround", 0), "turnaround")
+    rooms = {}
+    for i, r in enumerate(data.get("rooms") or []):
+        if not isinstance(r, dict) or not r.get("name"):
+            raise BadInput(f"room {i + 1} needs a name")
+        n = str(r["name"])
+        rooms[n] = {"name": n, "open": minutes(r["open"], f"room {n} open") if r.get("open") else None,
+                    "close": minutes(r["close"], f"room {n} close") if r.get("close") else None,
+                    "turnaround": _mins(r.get("turnaround", default_turn), f"room {n} turnaround")}
+    items = []
+    for i, it in enumerate(data.get("items") or []):
+        if not isinstance(it, dict) or not it.get("title"):
+            raise BadInput(f"item {i + 1} needs a title")
+        iid = str(it.get("id") or f"item {i + 1}")
+        room = str(it.get("room") or "")
+        if not room:
+            raise BadInput(f"{iid} ({it['title']}) needs a room")
+        if room not in rooms:
+            rooms[room] = {"name": room, "open": None, "close": None, "turnaround": default_turn}
+        start = minutes(it.get("start"), f"{iid} start")
+        if it.get("end") is not None:
+            end = minutes(it["end"], f"{iid} end")
+        elif it.get("duration") is not None:
+            end = start + _mins(it["duration"], f"{iid} duration")
+        else:
+            raise BadInput(f"{iid} ({it['title']}) needs an end or a duration")
+        people = it.get("people") or []
+        if isinstance(people, str):
+            people = [people]
+        items.append({"id": iid, "title": str(it["title"]), "room": room, "day": str(it.get("day") or ""),
+                      "start": start, "end": end, "people": [str(p) for p in people],
+                      "setup": _mins(it.get("setup", 0), f"{iid} setup"),
+                      "changeover": _mins(it.get("changeover", 0), f"{iid} changeover")})
+    if not items:
+        raise BadInput("no items")
+    travel = {}
+    for i, t in enumerate(data.get("travel") or []):
+        if not isinstance(t, dict) or not isinstance(t.get("between"), list) or len(t["between"]) != 2:
+            raise BadInput(f"travel {i + 1} must be {{\"between\": [room, room], \"minutes\": n}}")
+        a, b = (str(x) for x in t["between"])
+        travel[frozenset((a, b))] = _mins(t.get("minutes"), f"travel {i + 1} minutes")
+    end = minutes(data["published_end"], "published_end") if data.get("published_end") else None
+    return {"rooms": rooms, "items": items, "travel": travel, "published_end": end}
+
+
+def check(show, max_hours=3.0, brk=15.0, max_gap=45.0):
+    fails, warns, bad = [], [], set()
+    items = show["items"]
+    label = lambda it: f"{it['title']} ({hhmm(it['start'])}{', ' + it['day'] if it['day'] else ''})"
+    for it in items:
+        if it["end"] <= it["start"]:
+            fails.append(f"{label(it)} ends at {hhmm(it['end'])}, not after it starts")
+            bad.add(it["id"])
+    ok = [it for it in items if it["end"] > it["start"]]
+    groups = {}
+    for it in ok:
+        groups.setdefault((it["day"], it["room"]), []).append(it)
+    for (day, room), lane in groups.items():
+        r = show["rooms"][room]
+        lane.sort(key=lambda it: it["start"])
+        for it in lane:
+            if r["open"] is not None and it["start"] - it["setup"] < r["open"]:
+                need = f" with {it['setup']:.0f} min setup" if it["setup"] else ""
+                fails.append(f"{label(it)} starts{need} before {room} opens at {hhmm(r['open'])}")
+                bad.add(it["id"])
+            if r["close"] is not None and it["end"] > r["close"]:
+                fails.append(f"{label(it)} ends at {hhmm(it['end'])}, after {room} closes at {hhmm(r['close'])}")
+                bad.add(it["id"])
+        for a, b in zip(lane, lane[1:]):
+            gap = b["start"] - a["end"]
+            if gap < 0:
+                fails.append(f"{label(a)} and {label(b)} overlap in {room} by {-gap:.0f} min")
+                bad.update((a["id"], b["id"]))
+                continue
+            need = max(r["turnaround"], b["setup"], a["changeover"])
+            if gap < need:
+                why = ("the room's turnaround" if need == r["turnaround"] else
+                       f"{b['title']}'s setup" if need == b["setup"] else f"{a['title']}'s changeover")
+                fails.append(f"{room}: {gap:.0f} min between {label(a)} and {label(b)}, "
+                             f"{need:.0f} min needed for {why}")
+                bad.update((a["id"], b["id"]))
+            elif gap > max_gap:
+                warns.append(f"{room} is empty for {gap:.0f} min between {a['title']} and {b['title']}")
+    people = {}
+    for it in ok:
+        for p in it["people"]:
+            people.setdefault((it["day"], p), []).append(it)
+    for (day, p), mine in people.items():
+        mine.sort(key=lambda it: it["start"])
+        for a, b in zip(mine, mine[1:]):
+            gap = b["start"] - a["end"]
+            if gap < 0:
+                fails.append(f"{p} is needed at {label(a)} in {a['room']} and {label(b)} in {b['room']} at once")
+                bad.update((a["id"], b["id"]))
+            elif a["room"] != b["room"]:
+                t = show["travel"].get(frozenset((a["room"], b["room"])))
+                if t is not None and gap < t:
+                    fails.append(f"{p} has {gap:.0f} min to get from {a['room']} to {b['room']} "
+                                 f"between {a['title']} and {b['title']}; the walk takes {t:.0f}")
+                    bad.update((a["id"], b["id"]))
+        run_start, last_end = None, None
+        for it in mine:
+            if last_end is None or it["start"] - last_end >= brk:
+                run_start = it["start"]
+            last_end = max(last_end or it["end"], it["end"])
+            if last_end - run_start > max_hours * 60:
+                warns.append(f"{p} works from {hhmm(run_start)} to {hhmm(last_end)}"
+                             f"{' on ' + day if day else ''} without a {brk:.0f}-minute break")
+                run_start = math.inf  # one warning per stretch
+        # an inf run_start makes the difference negative until the next break resets it
+    if show["published_end"] is not None:
+        for day in sorted({it["day"] for it in ok}):
+            last = max((it for it in ok if it["day"] == day), key=lambda it: it["end"])
+            if last["end"] > show["published_end"]:
+                warns.append(f"{last['title']} ends at {hhmm(last['end'])}{', ' + day if day else ''}, "
+                             f"{last['end'] - show['published_end']:.0f} min after the published end "
+                             f"of {hhmm(show['published_end'])}")
+    return {"fails": fails, "warns": warns, "bad": sorted(bad)}
+
+
+def order(show):
+    return sorted(show["items"], key=lambda it: (it["day"], it["start"], it["room"]))
+
+
+def report(show, r):
+    out, day = [], None
+    for it in order(show):
+        if it["day"] != day and it["day"]:
+            out.append(it["day"])
+        day = it["day"]
+        who = f" — {', '.join(it['people'])}" if it["people"] else ""
+        out.append(f"  {hhmm(it['start'])}–{hhmm(it['end'])}  {it['room']}: {it['title']}{who}")
+    out += [f"FAIL {f}" for f in r["fails"]] + [f"WARN {w}" for w in r["warns"]]
+    out.append("PASS" if not r["fails"] else f"{len(r['fails'])} failure(s)")
+    return "\n".join(out) + "\n"
+
+
+def esc(t):
+    return str(t).replace("&", "&amp;").replace("<", "&lt;").replace(">", "&gt;").replace('"', "&quot;")
+
+
+def svg(show, r, px=3.0, lane=64):
+    """One panel per day: a lane per room, a block per item, a tick every 30 minutes."""
+    days = sorted({it["day"] for it in show["items"]})
+    rooms = list(show["rooms"])
+    out_body, y = [], 50
+    width = 0
+    for day in days:
+        its = [it for it in show["items"] if it["day"] == day]
+        t0 = min(min(it["start"] for it in its), *(show["rooms"][it["room"]]["open"] or it["start"] for it in its))
+        t1 = max(max(it["end"] for it in its), *(show["rooms"][it["room"]]["close"] or it["end"] for it in its))
+        t0, t1 = 30 * math.floor(t0 / 30), 30 * math.ceil(t1 / 30)
+        scale = min(px, 1100.0 / max(t1 - t0, 30))  # a long day still fits a page
+        X = lambda t, t0=t0, scale=scale: 150 + (t - t0) * scale
+        width = max(width, X(t1) + 30)
+        if day:
+            out_body.append(f'<text x="20" y="{y:.0f}" font-size="14" font-weight="bold">{esc(day)}</text>')
+            y += 14
+        top = y + 10
+        for t in range(int(t0), int(t1) + 1, 30):
+            major = t % 60 == 0
+            out_body.append(f'<line x1="{X(t):.1f}" y1="{top:.0f}" x2="{X(t):.1f}" y2="{top + lane * len(rooms):.0f}" '
+                            f'stroke="{"#cfd8dc" if major else "#eceff1"}"/>')
+            if major:
+                out_body.append(f'<text x="{X(t):.1f}" y="{top - 3:.0f}" font-size="10" text-anchor="middle" fill="#607d8b">{hhmm(t)}</text>')
+        for k, room in enumerate(rooms):
+            ly = top + k * lane
+            rm = show["rooms"][room]
+            out_body.append(f'<text x="20" y="{ly + lane / 2 + 4:.0f}" font-size="12" fill="#263238">{esc(room)}</text>'
+                            f'<line x1="150" y1="{ly + lane:.0f}" x2="{X(t1):.1f}" y2="{ly + lane:.0f}" stroke="#b0bec5"/>')
+            if rm["open"] is not None and rm["close"] is not None:
+                out_body.append(f'<rect x="{X(rm["open"]):.1f}" y="{ly + 2:.0f}" width="{(rm["close"] - rm["open"]) * scale:.1f}" '
+                                f'height="{lane - 4}" fill="#f1f8e9" opacity="0.6"/>')
+            for it in its:
+                if it["room"] != room:
+                    continue
+                bad = it["id"] in r["bad"]
+                x0, w = X(it["start"]), max((it["end"] - it["start"]) * scale, 2)
+                if it["setup"]:
+                    out_body.append(f'<rect x="{x0 - it["setup"] * scale:.1f}" y="{ly + 8:.0f}" width="{it["setup"] * scale:.1f}" '
+                                    f'height="{lane - 16}" fill="#fff8e1" stroke="#ffb300" stroke-dasharray="3,2"/>')
+                out_body.append(f'<rect x="{x0:.1f}" y="{ly + 6:.0f}" width="{w:.1f}" height="{lane - 12}" rx="4" '
+                                f'fill="{"#ffebee" if bad else "#e3f2fd"}" stroke="{"#c62828" if bad else "#1565c0"}" '
+                                f'stroke-width="{2.5 if bad else 1}"/>')
+                title = it["title"] if len(it["title"]) * 6 < w - 6 else it["title"][: max(int((w - 10) / 6), 1)] + "…"
+                out_body.append(f'<text x="{x0 + 4:.1f}" y="{ly + 24:.0f}" font-size="10" fill="#0d47a1">{esc(title)}</text>'
+                                f'<text x="{x0 + 4:.1f}" y="{ly + 38:.0f}" font-size="9" fill="#546e7a">'
+                                f'{hhmm(it["start"])}–{hhmm(it["end"])}{" ✗" if bad else ""}</text>')
+        y = top + lane * len(rooms) + 30
+    status = "PASS: no clashes" if not r["fails"] else f"{len(r['fails'])} clash(es): items marked ✗ in red"
+    out_body.append(f'<text x="20" y="{y:.0f}" font-size="12" fill="{"#2e7d32" if not r["fails"] else "#c62828"}">{esc(status)}</text>'
+                    f'<text x="20" y="{y + 16:.0f}" font-size="10" fill="#666">Dashed amber: setup before an item · '
+                    f'green band: room open</text>')
+    H, W = y + 34, max(width, 520)
+    head = [f'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 {W:.0f} {H:.0f}" width="{W:.0f}" height="{H:.0f}" '
+            'font-family="Helvetica, Arial, sans-serif">', f'<rect width="{W:.0f}" height="{H:.0f}" fill="#ffffff"/>',
+            '<text x="20" y="28" font-size="16" font-weight="bold">Run of show</text>']
+    return "\n".join(head + out_body + ["</svg>"]) + "\n"
+
+
+def main(argv=None):
+    ap = argparse.ArgumentParser(description="Check a run of show for clashes and draw it as a timeline.")
+    ap.add_argument("show")
+    ap.add_argument("--svg", help="write the timeline here")
+    ap.add_argument("--json", action="store_true", help="print the result as JSON")
+    ap.add_argument("--max-hours", type=float, default=3.0, help="hours a person may work without a break (default 3)")
+    ap.add_argument("--break", dest="brk", type=float, default=15.0, help="minutes that count as a break (default 15)")
+    ap.add_argument("--max-gap", type=float, default=45.0, help="minutes a room may sit empty between items (default 45)")
+    args = ap.parse_args(argv)
+    try:
+        with open(args.show, encoding="utf-8") as fh:
+            show = load(json.load(fh))
+    except (OSError, ValueError) as e:
+        print(f"FAIL cannot read {args.show}: {e}")
+        return 2
+    r = check(show, args.max_hours, args.brk, args.max_gap)
+    if args.json:
+        print(json.dumps({"pass": not r["fails"], "fails": r["fails"], "warns": r["warns"],
+                          "items": [dict(it, start=hhmm(it["start"]), end=hhmm(it["end"])) for it in order(show)]},
+                         indent=1))
+    else:
+        print(report(show, r), end="")
+    if args.svg:
+        with open(args.svg, "w", encoding="utf-8") as fh:
+            fh.write(svg(show, r))
+        if not args.json:
+            print(f"\nWrote {args.svg}")
+    return 1 if r["fails"] else 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/packs/event-planner/skills/run-of-show/templates/show.json

@@ -0,0 +1,15 @@
+{
+  "published_end": "17:30",
+  "turnaround": 10,
+  "rooms": [
+    {"name": "Main hall", "open": "08:00", "close": "18:00", "turnaround": 15},
+    {"name": "Studio B", "open": "09:00", "close": "17:30"}
+  ],
+  "travel": [{"between": ["Main hall", "Studio B"], "minutes": 5}],
+  "items": [
+    {"id": "doors", "title": "Doors and registration", "room": "Main hall", "start": "08:30", "end": "09:00", "people": ["Front of house"]},
+    {"id": "key", "title": "Opening keynote", "room": "Main hall", "start": "09:15", "duration": 45, "people": ["Ana Ruiz", "AV crew"], "setup": 15},
+    {"id": "ws1", "title": "Workshop: pricing", "room": "Studio B", "start": "10:10", "end": "11:00", "people": ["Ana Ruiz"]},
+    {"id": "panel", "title": "Customer panel", "room": "Main hall", "start": "10:15", "end": "11:15", "people": ["Joe Park", "AV crew"], "changeover": 20}
+  ]
+}