@milehimikey/em 1.1.1 → 1.2.0

package/.claude/skills/event-modeling/SKILL.md

@@ -5,8 +5,10 @@ description: >-
   the 7 steps of Event Modeling and the 4 patterns (State Change, State View, Automation,
   Translation), and produce implementation-ready slice design documents. Use when the user wants
   to event-model a business process or system, do event modeling / event storming, design slices,
-  build or edit an `.em` model, or run the em tool. Works in resumable phases via an argument:
-  `discover` (steps 1-4), `model` (steps 5-7), `slice` (deep slice specs), plus `watch` and
+  build or edit an `.em` model, run the em tool, or extract / reverse-engineer a current-state
+  event model from an existing system or codebase (event-driven or legacy/procedural). Works in
+  resumable phases via an argument: `discover` (steps 1-4, greenfield), `extract` (current-state
+  model of an existing system), `model` (steps 5-7), `slice` (deep slice specs), plus `watch` and
   `validate`. With no argument it resumes from the saved state file.
 ---
 
@@ -16,8 +18,8 @@ You are facilitating an Event Modeling session. Your job is to **extract an accu
 the user through Socratic questioning** — never to invent the domain. You drive the `em` CLI to
 render the model live, and you produce implementation-ready slice design docs.
 
-Read `reference/methodology.md` (the 7 steps + 4 patterns) and `reference/em-dsl.md` (DSL syntax
-+ validation rules) before doing real work — they are the source of truth. Templates live in
+Read `reference/methodology.md` (the 7 steps + 4 patterns) and `reference/em-dsl.md` (DSL syntax and
+validation rules) before doing real work — they are the source of truth. Templates live in
 `templates/`.
 
 ## Operating principles (every phase)
@@ -59,7 +61,8 @@ Read `reference/methodology.md` (the 7 steps + 4 patterns) and `reference/em-dsl
    directory (or a `models/` subfolder). If found, read the state file. If not, and the phase
    needs one, ask the user for the model name and where to create it.
 3. Parse the argument (`$ARGUMENTS`) to pick the phase below. With **no argument**, read the
-   state file and resume the recorded phase/step; if no model exists, propose starting `discover`.
+   state file and resume the recorded phase/step; if no model exists, propose starting `discover`
+   (greenfield) or `extract` (modeling an existing system).
 
 ## Project layout this skill creates
 
@@ -67,22 +70,24 @@ Read `reference/methodology.md` (the 7 steps + 4 patterns) and `reference/em-dsl
 <model-name>/
   <model-name>.em          # the model (slice docs linked via note "...")
   <model-name>.svg         # render target for em watch
-  live.html                # auto-refresh viewer (copy of templates/live.html, SVG_FILE set)
+  live.html                # file:// auto-refresh viewer (copy of templates/live.html, verbatim)
   README.md                # overview + slice index (from templates/model-readme.md)
   .event-modeling.md       # resumable state (from templates/state.md)
   slices/<slice-name>.md   # one rich slice doc per slice (from templates/slice.md)
 ```
 
-When creating a new model, scaffold the directory, copy the templates in (filling the
-placeholders), and set `SVG_FILE` in the copied `live.html` to `<model-name>.svg`. You may use
-`em init` for a starter `.em`, but usually you'll build it up from the discovery conversation
-instead. Fill template placeholders — never leave `{{...}}` in delivered files.
+When creating a new model, scaffold the directory and copy the templates in (filling the
+placeholders). Copy `live.html` **verbatim** — it takes the SVG name from its URL query
+(`live.html?svg=<model-name>.svg`), so there's nothing to edit. You may use `em init` for a
+starter `.em`, but usually you'll build it up from the discovery conversation instead. Fill
+template placeholders — never leave `{{...}}` in delivered files.
 
 ---
 
 ## Phase: `discover` — steps 1-4
 
 Goal: a draft model of events, storyboard, commands, and views. Loose is OK; structure comes next.
+**Existing system?** Use `extract` instead (next section) — discover is for greenfield modeling.
 
 1. **Brainstorm events (step 1).** Ask the user to name everything that happens, as past-tense
    facts. Probe for missed state changes. For each candidate, apply the **"is it an event?"
@@ -107,6 +112,27 @@ End of phase: write/refresh the `.em`, render it, update `.event-modeling.md` (s
 decisions, open questions, slice inventory). Tell the user they can stop here and resume with
 `/event-modeling model`.
 
+## Phase: `extract` — current-state model of an existing system
+
+Goal: a faithful **current-state** model extracted from an existing system — the as-is sibling
+of `discover` (it replaces discover; the model then proceeds to `model` as usual).
+
+**Read `reference/extract.md` before doing any extract work** — it carries a stance override
+that inverts methodology step 1 (capture how the system behaves *today*; never model desired
+state).
+
+- Two source modes, detected from the system itself and confirmed with the user:
+  **event-driven** (an event vocabulary already exists — schemas, topics, handlers) and
+  **procedural/monolith** (no event vocabulary — synthesize candidate events from behavior
+  and docs).
+- Converge via a ~7-round confirm-and-clarify loop (one concern per round; render from round 2,
+  validate from round 4 — see the playbook).
+- **Current-state-only:** park unknowns as `# TBD` comments in the `.em`, mirrored in the state
+  file's Open Questions — never guess intended design.
+
+End of phase: validated as-is model; state file updated (source mode, rounds, decisions, slice
+inventory); then chain to `/event-modeling model` (steps 5-7).
+
 ## Phase: `model` — steps 5-7
 
 Goal: a structurally complete, **validated** model with correct patterns and swimlanes.
@@ -151,18 +177,21 @@ For each slice:
 3. Wire it into the `.em`: add `note "slices/<slice-name>.md"` to the slice's primary element
    (the command for State Change, the view for State View, the processor for Automation, the
    translation for Translation).
-4. Update `README.md`'s slice index and the state file's slice inventory (`draft` → `ready`).
+4. Update `README.md`'s slice index and the state file's slice inventory (`draft` → `ready-to-implement`).
 5. Re-render and `em validate`.
 
 ## Phase: `watch` — live team view
 
-1. Ensure `live.html` exists in the model dir (copy from `templates/live.html`) with `SVG_FILE`
-   set to `<model-name>.svg`.
-2. Start the watcher in the background: `em watch <model-name>.em -o <model-name>.svg`
-   (run_in_background). It re-renders the SVG on every save.
-3. Tell the user to open `live.html` in a browser and share their screen — it auto-refreshes ~1s,
-   so the team sees the model evolve as you edit during the session. (`em` has no built-in server;
-   the HTML viewer provides the auto-reload.)
+**Recommended (instant push, no polling):** start the watcher with `--serve` in the background:
+`em watch <model-name>.em -o <model-name>.svg --serve` (run_in_background). It re-renders on every
+save and pushes an instant reload to the browser over Server-Sent Events. Tell the user to open the
+URL it prints (e.g. `http://localhost:5173/?svg=<model-name>.svg`) and share their screen — updates
+appear the moment you save, with no idle churn between edits.
+
+**No-server fallback (`file://`):** if the user prefers not to run a server, start the plain watcher
+`em watch <model-name>.em -o <model-name>.svg` (run_in_background) and have them open the copied
+`live.html?svg=<model-name>.svg` in a browser. It polls every ~2s and reloads without flicker. No
+editing of `live.html` is needed — the `?svg=` query picks the model.
 
 ## Phase: `validate`
 
@@ -186,6 +215,7 @@ em validate <name>.em                      # check rules; exit 0 if clean/warnin
 em render <name>.em -o <name>.svg          # render (svg/png/pdf by extension)
 em render <name>.em --emit-dot             # inspect generated Graphviz DOT
 em watch <name>.em -o <name>.svg           # re-render on save (run in background)
+em watch <name>.em -o <name>.svg --serve   # + live viewer with instant push-reload (--port N)
 ```
 
 Always finish a working session by: re-rendering, running `em validate`, and updating

package/.claude/skills/event-modeling/reference/em-dsl.md

@@ -1,3 +1,5 @@
+<!-- DSL behavior change? Update BOTH docs/dsl.md and .claude/skills/event-modeling/reference/em-dsl.md -->
+
 # `em` DSL Reference & Cheatsheet
 
 The `em` tool (`@milehimikey/em`) is a slice-first text DSL rendered to a strict Graphviz
@@ -13,7 +15,8 @@ em init [file]                 # scaffold a starter model.em (default: model.em)
 em render <file> -o out.svg    # render (extension picks format: svg, png, pdf)
 em render <file> --emit-dot    # print the Graphviz DOT instead of rendering
 em render <file> --keep-empty-lanes   # keep the API lane even when empty
-em watch  <file> -o out.svg    # re-render on every save (file-based; no HTTP server)
+em watch  <file> -o out.svg    # re-render on every save (file-based)
+em watch  <file> -o out.svg --serve   # + localhost live viewer, instant SSE push-reload (--port N)
 em validate <file>             # check event-modeling rules; exit 0 if only warnings/clean
 ```
 
@@ -34,6 +37,7 @@ slice "Name" {                   # one vertical time step (a column)
   ui   Free Text @Persona        # screen; @Persona picks its row (defaults to first/"User")
   command Free Text              # state-changing request (API band)
   view Free Text from "Event A", "Event B"   # read model fed by event(s)
+  view Free Text again from "Event C"        # later instance of an evolving read model (see Clauses)
   event Free Text @Context       # recorded fact; @Context picks its row (defaults to "Domain")
   processor Free Text from "View"   # automation; aliases: automation | saga | translation
 }
@@ -53,7 +57,16 @@ arrow From Element -> To Element    # explicit cross-slice edge (overrides infer
 ### Clauses
 - **Tags:** `@Persona` only on `ui`; `@Context` only on `event`. Undeclared tags auto-create a row.
 - **`from "X"`** on views/automations declares the source(s); names are quoted, comma-separated.
-  Matching is case-insensitive and whitespace-normalized.
+  Matching is case-insensitive and whitespace-normalized. A `from` may never point at an event or
+  view that first appears in a LATER slice (forward-only timeline — validation error).
+- **`again`** (views only): `view <Name> again [from "Event", …]` declares a later instance of an
+  already-declared read model — the forward-only device for a view that evolves as later events
+  land. Instances are ONE logical view: the first declaration owns the `note` binding; each
+  instance's `from` lists only the NEW events landing at that point (not cumulative); instances are
+  linked left-to-right with a continuity arrow; a reaction (`from "View"`) reads the nearest
+  instance at-or-before its own slice. `again` with no earlier declaration is a validation error.
+  Use `again` (not a plain repeated `view` name) whenever the view is referenced by a
+  `from`/`arrow` — plain repeats are only warning-free while unreferenced.
 - **`note "path.md"`** on ANY element links a markdown doc. Relative to the `.em` file. Renders as
   a clickable marker in SVG and a legend entry in PNG/PDF. **This is how slice docs attach.**
 - **Fields:** `command Place Order { orderId: UUID, items: LineItem[], customerId }` — inline or
@@ -141,7 +154,9 @@ slice "Read Quote — created"   { view Quote from "QuoteCreated"  translation S
   *referenced* duplicate, resolving to the first). **Wire each event to a read model exactly once:**
   a repeated instance's `from` lists only the **new** events since the previous instance (not
   cumulative), or the event draws a duplicate arrow to the same read model at every repeat. (An
-  event may still feed several *different* read models, once each.)
+  event may still feed several *different* read models, once each.) When a repeated view **must be
+  referenced** — e.g. a reaction reads it via `from` — declare its later instances with
+  `view X again` instead (see Clauses); instances resolve properly and draw continuity arrows.
 - **Keep arrows span-1: put each repeat right after its feeding event.** Place a read-model instance
   immediately after the event that updates it, sourcing only that single adjacent event. A read
   model far from its source events draws long arrows that cross the read-model row and read as
@@ -170,6 +185,11 @@ slice "Read Quote — created"   { view Quote from "QuoteCreated"  translation S
 2. **Unknown event source** — `view X from "Event"` where the event doesn't exist anywhere.
 3. **Unknown read-model source** — `processor X from "View"` where the view doesn't exist.
 4. **Arrow endpoint mismatch** — `arrow A -> B` where A or B matches no element name.
+5. **Backward timeline** ("time flows left to right") — an event feeding a view instance in an
+   EARLIER slice (fix: add a `view X again` instance where the event lands and move the source
+   there), a reaction reading a view before any instance of it exists, or an explicit backward
+   `arrow`.
+6. **`again` without an earlier declaration** — declare the view plainly the first time it appears.
 
 **Warnings (should fix):**
 1. **Automation/translation shares slice with its command** — both `automation`/`processor` and

package/.claude/skills/event-modeling/reference/extract.md

@@ -0,0 +1,123 @@
+# Extract Phase — Current-State Model of an Existing System
+
+Read this **before doing any extract work**. It governs the `extract` phase and **overrides
+`methodology.md` step 1's stance** for the duration of extraction: you are capturing how the
+system behaves **today**, not modeling what the business needs. Everything else in the
+methodology — the 4 patterns, the "is it an event?" test, the Socratic stance, the two-slice
+reaction split — still applies.
+
+## Stance override — current-state-only
+
+- Capture the system **as it is**, faithfully, warts included. Never invent future or desired
+  state. Improvement ideas that surface go to the state file's Open Questions or Decisions log
+  — never into the model.
+- Methodology step 1's caution ("model the process the business **needs**, not how the current
+  system happens to work — existing system behavior is a common source of fake events") is
+  **deliberately suspended**: here the existing system *is* the subject.
+- The **"is it an event?" filter still applies.** Derived values (totals, calculated fields)
+  and telemetry/activity (clicks, page views, logins) are still not events, even when the
+  current system stores or emits them as such. Park each rejection in the Decisions log with
+  why, so it isn't re-proposed.
+- **Never guess.** Unknown or ambiguous current behavior is parked (see TBD convention below),
+  not filled in with what the design "probably" intends.
+
+## Setup
+
+1. Run the SKILL.md preconditions (tool check, model location) and scaffold the standard
+   project layout if no model exists yet.
+2. **Agree the scope line first**: which system, which part, what's out of bounds. Write it to
+   the state file's Session inputs.
+3. Record in the state file: `Source mode` (after detection, below) and
+   `Existing system refs` — the repo paths, event-schema/topic locations, and docs you will
+   extract from.
+
+## Mode detection
+
+Inspect the system with your own tools (Grep/Read over the codebase and docs), then confirm
+the mode with the user:
+
+- **Event-driven** — the system already has an event vocabulary. Signals: event
+  schemas/classes, topics/streams/queues, message or CDC handlers, an event store, pub/sub
+  wiring. Extraction *lifts* the model from that vocabulary.
+- **Procedural / monolith** — no event vocabulary. Signals: transaction scripts, service
+  methods mutating rows, CRUD controllers, procedural runbooks/docs. Extraction *synthesizes*
+  candidate events from the state changes the behavior implies.
+
+Mixed systems happen: pick the dominant mode, note the exception areas in the state file.
+
+## Sourcing by mode
+
+- **Event-driven:** inventory the emitted/consumed event types; take past-tense business facts
+  directly; then filter — technical/infrastructure messages (retries, heartbeats, envelope
+  wrappers) and derived/telemetry types are dropped (log why). Keep the system's own names
+  where they are honest past-tense facts; propose a cleaner past-tense name only when the
+  original is technical (record the mapping in the Decisions log).
+- **Procedural:** for each significant operation, ask "what business fact has become true when
+  this completes?" — those are the candidate events. Screens and tables are *evidence* of
+  state changes, not events themselves; a table row's lifecycle (created/updated/closed) often
+  implies several events. Apply the event filter hard here — procedural systems are where
+  derived values and activity records masquerade as facts.
+
+## The confirm-and-clarify loop (~7 rounds)
+
+One concern per round. After every round: mirror what you extracted back to the user, update
+the `.em`, and (from R2) re-render so they see the model grow. Convergence beats coverage —
+it is fine to finish a round with `# TBD`s still parked.
+
+- **R1 — Candidate events.** Extract (event-driven) or synthesize (procedural) the past-tense
+  facts; apply the event test; user confirms/renames/rejects. Ambiguous candidates → `# TBD`.
+- **R2 — Timeline order.** Order the confirmed events into the as-is narrative. Identify the
+  *actual* actors/callers and the *real* UI or API surfaces (headless systems: no
+  `ui`/`persona` — use write/read translations per `em-dsl.md`). **First `em render` here.**
+- **R3 — Commands / inputs.** For each event, the request that actually produces it today
+  (imperative name). Unclear trigger → `# TBD`, not a plausible guess.
+- **R4 — Read models / outputs.** The projections/queries the system actually serves; wire
+  `from "Event"` (repeat read models span-1 per `em-dsl.md`). **Start running `em validate`**
+  each round from here.
+- **R5 — Boundaries & reactions.** Current automations and integrations as-is: schedulers,
+  listeners, outbound syncs, inbound webhooks. Model each as a reaction with the two-slice
+  `reaction → command → event` split and the slice-ordering rules in `em-dsl.md` — even when
+  the current code wires it as one procedural step (note the as-built shape in the slice's
+  `# TBD`/Decisions if it differs).
+- **R6 — Gap & TBD reconciliation.** Walk every parked `# TBD` with the user. Resolve only
+  what they can confirm **as a current-state fact**; everything else stays parked. Explicitly
+  refuse to resolve a TBD by inventing desired behavior.
+- **R7 — Convergence.** Final `em render` + `em validate` (fix errors and warnings; remember
+  the validator's blind spot — check the reaction split by hand). User confirms the model is a
+  faithful picture of today. Mark extraction complete in the state file and hand off.
+
+Seven rounds is the default shape, not a quota — collapse rounds for a small system, repeat
+one for a sprawling one. Record any deviation in the Decisions log.
+
+## TBD parking convention
+
+- Inline `.em` comment on its own line directly above (or trailing) the element it concerns:
+  `# TBD: <specific question about current behavior>`. Comments are native DSL syntax — they
+  render and validate cleanly.
+- Mirror every `# TBD` 1:1 as a checkbox in the state file's **Open questions / parking lot**,
+  and remove both together when resolved.
+- A `# TBD` is only ever resolved by a confirmed current-state fact — never replaced by a
+  guessed element.
+
+## Completion & handoff
+
+Extraction is complete when: the model renders; `em validate` is clean (or remaining warnings
+are consciously accepted in the Decisions log); every unknown is a parked `# TBD`; and the
+user has confirmed the model reflects today's behavior. Then:
+
+1. State file: set phase progress (extraction rounds checked), log the completion decision,
+   seed the **Slice inventory** (every slice, pattern, doc status `none`).
+2. The extracted model **replaces `discover`** — suggest `/event-modeling model` next
+   (steps 5-7: swimlanes, patterns, completeness). Desired-state changes belong *after* the
+   as-is model is agreed — as normal `model`/`slice` evolution, clearly separated from
+   extraction.
+
+## Anti-patterns
+
+- **Inventing desired state** — the cardinal sin of extraction; park it instead.
+- **Importing screens/tables as events** — they are evidence of state changes, not facts.
+- **Guessing an unclear trigger or reaction** instead of parking a `# TBD`.
+- **Cleaning up the domain while extracting** — renames and restructures beyond honest
+  past-tense naming are `model`-phase work, done with the user after the as-is picture exists.
+- **Skipping render/validate until the end** — the loop depends on the user seeing the model
+  grow round by round.

package/.claude/skills/event-modeling/reference/methodology.md

@@ -121,6 +121,9 @@ state change anyone can think of. No commands, no UI yet — just facts.
     User Clicked Button, User Viewed Page, User Logged In.
 - Model the process the business **needs**, not how the current system happens to work. Existing
   system behavior is a common source of fake events — screens and tables leaking in as facts.
+  (**Extract mode inverts this**: in the skill's `extract` phase the existing system *is* the
+  subject and this caution is deliberately suspended — see the "Extract" section below and
+  `reference/extract.md`. The derived-value and telemetry filters still apply there.)
 - Output: a flat list of candidate `event` names.
 
 ### Step 2 — The Plot / Storyboard  *(discover)*
@@ -178,6 +181,26 @@ Walk the whole model with stakeholders and check for loose ends:
 
 ---
 
+## Extract: current-state models of existing systems
+
+The `extract` phase derives a model from an **existing** system instead of a greenfield
+conversation. It is discover's as-is sibling: its confirm-and-clarify rounds converge the same
+step 1–4 outputs (events, timeline, commands, read models) — *derived from the system*, then
+confirmed with the user — after which the model enters `model` (steps 5–7) as usual.
+
+The stance inversion, stated authoritatively: **extraction captures how the system behaves
+today — faithfully, warts included — and never invents future or desired state.** Step 1's
+anti-current-system caution is suspended for the duration; the "is it an event?" filter is
+not — derived values and telemetry are still rejected even when the current system emits them.
+Unknown or ambiguous current behavior is parked (`# TBD` in the `.em`, mirrored in the state
+file's Open Questions), never guessed. Desired-state improvements belong to the `model` and
+`slice` phases, after the as-is picture is agreed.
+
+Procedure, source modes (event-driven vs. procedural synthesis), and the round-by-round loop:
+`reference/extract.md`.
+
+---
+
 ## Socratic stance (applies throughout)
 
 - Ask **one focused question at a time**; never assume a domain fact — extract it.

package/.claude/skills/event-modeling/templates/live.html

@@ -3,10 +3,22 @@
   Live viewer for an em event model. Auto-reloads the rendered SVG so a team on a shared
   screen sees updates from `em watch` without manual refresh.
 
-  Usage:
-    1) In one terminal:  em watch MODEL.em -o MODEL.svg
-    2) Set SVG_FILE below to the SVG filename (same folder as this file).
-    3) Open this file in a browser (open live.html) and share the screen.
+  Two ways to use it:
+
+    A) Push (recommended, instant, no polling):
+         em watch MODEL.em -o MODEL.svg --serve
+       then open the URL it prints (http://localhost:5173/?svg=MODEL.svg). You don't need
+       this file at all in that mode — the server serves its own push-based viewer.
+
+    B) This file, over file:// (no server):
+         1) In one terminal:  em watch MODEL.em -o MODEL.svg
+         2) Open this file with the SVG name in the query:
+              open "live.html?svg=MODEL.svg"      (macOS)
+            No editing required — the ?svg= param picks the model.
+
+  Under file:// the browser gives no reliable "did the file change?" signal (fetch/HEAD is
+  blocked), so this fallback polls and reloads on a gentle interval. It double-buffers the
+  swap so a shared screen never flashes. For zero idle work and instant updates, use --serve.
 
   The SVG is embedded via <object> so note "..." links inside it stay clickable.
 -->
@@ -37,17 +49,57 @@
     <object id="svg" type="image/svg+xml"></object>
   </div>
   <script>
-    // Change this to your model's SVG filename:
-    const SVG_FILE = "model.svg";
-    const obj = document.getElementById("svg");
+    // SVG filename from ?svg=<name>.svg (defaults to model.svg) — one file serves any model.
+    const SVG_FILE = new URLSearchParams(location.search).get("svg") || "model.svg";
+    // Poll cadence for the file:// fallback. Tune freely; --serve makes polling unnecessary.
+    const REFRESH_INTERVAL_MS = 2000;
+
+    const stage = document.getElementById("stage");
     const stamp = document.getElementById("stamp");
-    function reload() {
-      // cache-bust so the freshly written SVG is fetched each tick
-      obj.setAttribute("data", SVG_FILE + "?t=" + Date.now());
-      stamp.textContent = new Date().toLocaleTimeString();
+    let current = document.getElementById("svg");
+    let lastModified = null;
+
+    // Best-effort change check — only meaningful when served over http(s). Under file://
+    // fetch/HEAD is blocked, so this throws and we fall back to reloading every tick.
+    async function changed() {
+      if (!location.protocol.startsWith("http")) return true;
+      try {
+        const res = await fetch(SVG_FILE, { method: "HEAD", cache: "no-store" });
+        const tag = res.headers.get("last-modified") || res.headers.get("etag");
+        if (tag && tag === lastModified) return false;
+        lastModified = tag;
+        return true;
+      } catch {
+        return true; // can't tell — reload to be safe
+      }
     }
-    reload();
-    setInterval(reload, 1000);
+
+    // Double-buffer: load into a hidden <object>, swap on load, so the shared screen
+    // never flashes white during a reload.
+    function swap() {
+      const next = document.createElement("object");
+      next.type = "image/svg+xml";
+      next.style.cssText = current.style.cssText;
+      next.addEventListener("load", () => {
+        stage.replaceChild(next, current);
+        current = next;
+        stamp.textContent = new Date().toLocaleTimeString();
+      }, { once: true });
+      next.setAttribute("data", SVG_FILE + "?t=" + Date.now());
+    }
+
+    // Self-scheduling loop: schedule the next tick only after this one resolves, so a slow
+    // reload can never overlap the next tick.
+    async function tick() {
+      try {
+        if (await changed()) swap();
+      } finally {
+        setTimeout(tick, REFRESH_INTERVAL_MS);
+      }
+    }
+
+    swap();
+    setTimeout(tick, REFRESH_INTERVAL_MS);
   </script>
 </body>
 </html>

package/.claude/skills/event-modeling/templates/model-readme.md

@@ -6,10 +6,13 @@
 While modeling, run the live view so the team can watch the diagram update:
 
 ```bash
-em watch {{model-name}}.em -o {{model-name}}.svg   # re-renders on every save
-# then open live.html in a browser (auto-refreshes ~1s; share the screen)
+em watch {{model-name}}.em -o {{model-name}}.svg --serve   # re-render + instant push-reload
+# then open the URL it prints (http://localhost:5173/?svg={{model-name}}.svg) and share the screen
 ```
 
+No server? Run `em watch {{model-name}}.em -o {{model-name}}.svg` and open
+`live.html?svg={{model-name}}.svg` in a browser (polls ~2s; share the screen).
+
 Static render: `em render {{model-name}}.em -o {{model-name}}.svg`
 
 ## Patterns legend

package/.claude/skills/event-modeling/templates/state.md

@@ -7,14 +7,25 @@ Keep it current at the end of every working session.
 # Event Modeling Progress — {{Model Name}}
 
 - **Model file:** `{{model-name}}.em`
-- **Current phase:** {{discover | model | slice}}
-- **Current step:** {{1–7, see methodology}}
+- **Current phase:** {{extract | discover | model | slice}}
+- **Current step:** {{1–7, see methodology; or extraction round R1–R7}}
 - **Last updated:** {{YYYY-MM-DD}}
 
 ## Session inputs
 - **Scope line:** {{one-line description of what's in/out of bounds for this model}}
 - **PRD / spec reference:** {{path, link, or "none"}}
 - **Headless/API model:** {{yes | no}}
+- **Source mode:** {{greenfield | extract-event-driven | extract-procedural}}
+- **Existing system refs:** {{repo paths, event-schema/topic locations, docs — or "n/a"}}
+
+## Extraction progress (existing-system models only — delete for greenfield)
+- [ ] R1. Candidate events (extracted/synthesized, filtered, confirmed)
+- [ ] R2. Timeline order (as-is narrative, actors/callers, first render)
+- [ ] R3. Commands / inputs
+- [ ] R4. Read models / outputs (validate from here)
+- [ ] R5. Boundaries & reactions (two-slice splits)
+- [ ] R6. Gap & TBD reconciliation
+- [ ] R7. Convergence (render + validate clean, user confirmed as-is)
 
 ## Steps completed
 - [ ] 1. Brainstorm events
@@ -36,4 +47,4 @@ Keep it current at the end of every working session.
 ## Slice inventory
 | Slice | Pattern | Doc status |
 |-------|---------|------------|
-| {{Slice Name}} | {{State Change/View/Automation/Translation}} | {{none / draft / ready}} |
+| {{Slice Name}} | {{State Change/View/Automation/Translation}} | {{none / draft / reviewed / ready-to-implement}} |

package/README.md

@@ -1,187 +1,85 @@
-# em — AI friendly event modeling
+# em — event modeling in plain text
 
 `em` is a command-line tool for [Event Modeling](https://eventmodeling.org/). You write a
-model in a small, **plain-text, slice-first DSL** (`.em`) and `em` renders it to a clean,
-deterministic diagram (SVG by default, PNG on request). Because the source is just text —
-diff-able, reviewable, and unambiguous — it's as easy for an LLM to generate and edit as it
-is for a person to write by hand. Layout is a **strict grid**: swimlane rows and
-time-ordered slice columns stay perfectly aligned with no manual offsets.
+model in a small, slice-first DSL and `em` renders it as a clean, deterministic diagram.
+Because the source is plain text — diff-able, reviewable, unambiguous — it's as easy for an
+AI to write and edit as it is for a person, and `em validate` keeps either one honest.
 
-```
-examples/order-fulfillment.em  ->  em render  ->  order-fulfillment.svg
-```
+![An order-fulfillment event model rendered by em](https://raw.githubusercontent.com/milehimikey/em/main/examples/order-fulfillment.svg)
 
-Rendering is **self-contained** — Graphviz runs as bundled WebAssembly and PNG is
-rasterized in-process, so there's nothing to `apt`/`brew` install for SVG or PNG output.
+The source for that diagram is [about 70 lines of text](examples/order-fulfillment.em).
 
 ## Install
 
 ```bash
-npm install -g @milehimikey/em     # then `em` is on your PATH
+npm install -g @milehimikey/em
 ```
 
-Requires **Node ≥ 18**. SVG and PNG need no other tools. PDF (and other Graphviz raster
-formats) are optional and use a system `rsvg-convert` (librsvg) if one is installed.
-
-Run without installing:
-
-```bash
-npx @milehimikey/em init model.em
-npx @milehimikey/em render model.em
-```
+Requires Node ≥ 18. SVG and PNG rendering are fully self-contained (Graphviz runs as
+bundled WebAssembly); nothing else to install. PDF is optional — see
+[docs/dependencies.md](docs/dependencies.md).
 
 ## Quickstart
 
 ```bash
 em init model.em          # scaffold a starter model
 em render model.em        # -> model.svg  (open it in a browser)
-em watch model.em         # re-render on every save
+em watch model.em --serve # live browser view, re-renders on every save
 em validate model.em      # check event-modeling rules
 ```
 
-A `.em` model is a list of **slices** (vertical time steps), each holding elements that fall
-into swimlane rows:
+A model is a list of slices — vertical time steps, read left to right — whose elements land
+in swimlane rows:
 
-```
+```em
 model "Order Fulfillment"
 
-persona Customer           # UI swimlanes (top), one row per persona
-context Order              # event swimlanes (bottom), one row per context
-context Payment
-
-slice "Browse Catalog" {           # each slice is one column (time, left -> right)
-  ui Product Catalog @Customer     # @Persona places the screen in a persona row
-  command Place Order {            # a `{ … }` block declares the element's fields
-    customerId
-    total: Money                   # optional `: Type` annotation
-  }
-  event Order Placed @Order note "notes/order-placed.md" {   # note "…" links docs
-    orderId
-    total: Money
-  }
+persona Customer
+context Order
+
+slice "Browse Catalog" {
+  ui Product Catalog @Customer
+  command Place Order
+  event Order Placed @Order
 }
 
 slice "View Open Orders" {
-  view Open Orders from "Order Placed"   # from "<event>" wires the data flow
+  view Open Orders from "Order Placed"
   ui Order List @Customer
 }
 ```
 
-## The four patterns
-
-Event Modeling is built from four patterns, all expressible as slices:
-
-| Pattern | Flow | DSL elements |
-|---|---|---|
-| **Input** (state change) | UI → command → event | `ui`, `command`, `event` |
-| **Output** (state view) | event → read model → UI | `event`, `view from "…"`, `ui` |
-| **Automation** | read model (todo) → processor → command → event | `view from "…"` + `processor`, then `command` + `event` |
-| **Translation** | external read model → translation → command → event | `view from "…"` + `translation`, then `command` + `event` |
+The [tutorial](docs/tutorial.md) builds a complete model from an empty file in about twenty
+minutes.
 
-Automation/translation slices are **not** triggered by a command — they react to a read
-model (a "todo list") or a timer and *issue* a command when done. The automation slice
-contains **only** the read model it reads and the processor/translation; the command it
-triggers (and that command's event) is the **next** slice.
+## Model with AI
 
-## DSL reference
-
-### Element keywords → swimlane bands (top → bottom)
-
-0. *(header)* — each slice name is rendered as a title cell in the top row
-1. `automation` / `processor` / `saga` / `translation` — **Automation** band (only shown if used)
-2. `ui` — **persona** rows (one per `persona`)
-3. `command` + `view` — the **API** row (commands and read models share one lane)
-4. `event` — **context/concept** rows (one per `context`)
-
-Commands and read models share the **API** row, so a slice holds *either* a command *or* a
-read model. The empty API lane is dropped when a model has neither; pass `--keep-empty-lanes`
-to keep it.
-
-`@Persona` / `@Context` choose the row within a band (undeclared tags create a new row).
-`view <Name> again [from "Event", …]` declares a LATER INSTANCE of an already-declared read
-model — the Event Modeling device for keeping the timeline forward-only as a view evolves.
-Instances are one logical view: the first declaration owns the `note` doc; each instance lists
-the events that reach it there; instances are linked left-to-right with a continuity arrow, and
-reactions (`processor … from "View"`) read the nearest instance at-or-before their slice.
-
-`view … from "Event"[, "Event2"]` declares which events feed a read model and draws the
-data-flow arrow. Arrows within a slice are inferred from the pattern; use `arrow A -> B` for
-anything extra (e.g. a read model feeding a different screen).
-
-### Fields
-
-Any element can declare **data fields** in a `{ … }` block — the data it accepts (command),
-records (event), projects (read model), or shows (UI). Each field is `name` with an optional
-`: Type`; write one per line, or inline and comma-separated:
-
-```
-command Place Order {            # one per line
-  customerId
-  items: List<LineItem>
-  total: Money
-}
-
-event Payment Requested @Payment { orderId, amount: Money }   # inline
-```
-
-Fields render **in the box**, UML-style: the name, a divider rule, then the fields. The box
-grows to fit them (width stays fixed, so columns stay aligned), and arrows still anchor to
-the box edges so the lines stay stable. A field block coexists with `note`/`from` clauses on
-the same element. Fields are the foundation of the later event-modeling phases (the slicing /
-information-completeness process); field-level validation across slices is planned.
-
-### Notes
-
-Any element can carry `note "path.md"` (valid on every keyword). The prose lives in the
-markdown file — keeping the diagram uncluttered — and the box gets a small **numbered
-folded-corner marker** in its top-right corner. A **legend** is appended below the diagram
-mapping each number to its element and note file, so even a static export tells you which
-note belongs to which box.
-
-In **SVG** output the markers and legend rows are links; clicking one opens the markdown
-file. Links resolve relative to the **output SVG's location**, so they keep working whether
-the SVG is rendered beside the model or into another folder (as long as the notes travel
-with it). Open the SVG in a **web browser** to use the links — image viewers like macOS
-Preview/Quick Look show the markers but ignore SVG hyperlinks. Raster output (PNG/PDF) can't
-carry links — that's what the footnote numbers + legend are for.
-
-## Commands
+`em` ships a Claude Code skill that runs a facilitated Event Modeling session: the AI asks
+the questions, you supply the domain, and the model renders live as it grows.
 
 ```bash
-em init [file]                        # scaffold a starter model (default: model.em)
-em render <file> [-o out.svg]         # render (format from -o extension or -T)
-em render <file> -o out.png           # PNG (in-process, no system deps)
-em render <file> --emit-dot           # print the generated DOT instead of rendering
-em render <file> --keep-empty-lanes   # don't collapse the API lane when empty
-em watch <file> [-o out.svg]          # re-render on every save
-em validate <file>                    # check event-modeling rules (non-zero exit on errors)
+em skill install          # copy the skill into .claude/skills/event-modeling/
 ```
 
-## Validation rules (`em validate`)
-
-- two same-band elements in one slice (collision) → **error** (split into separate slices)
-- a read model whose `from "Event"` doesn't exist → **error**
-- **time flows left to right** (the Two Laws): an event feeding an EARLIER view instance,
-  a reaction reading a view that only exists later, or an explicit backward `arrow` → **error**
-  (fix: add `view X again` at the point on the timeline where the event lands)
-- `again` on a view with no earlier declaration → **error**; `again` on non-views → parse error
-- multi-event slices always render as a FAN from the command (never event→event); fanned
-  arrows route around the column gutter so they cannot read as a chain
-- an automation/translation whose `from "<read model>"` doesn't exist → **error**
-- an `arrow` endpoint that matches no element → **error**
-- an automation/translation slice that also holds the command it triggers → **warning**
-- a command that records no event → **warning**
-- a read model with no source event → **warning**
-- a name defined more than once and referenced → **warning** (resolves to first)
+Then run `/event-modeling` in Claude Code. See [docs/ai-workflow.md](docs/ai-workflow.md)
+for the phases and what a session produces, and the
+[em-with-ai repository](https://github.com/milehimikey/em-with-ai) for a ~50-slice model
+built this way.
 
 ## Documentation
 
-- [docs/timeline-model.md](docs/timeline-model.md) — the Two Laws of the Timeline (forward-only
-  validation, `view … again`)
-- [docs/why-dot-not-plantuml.md](docs/why-dot-not-plantuml.md) — why DOT + the strict-grid /
-  self-drawn-edges architecture
-- [docs/features.md](docs/features.md) — full feature list and roadmap
-- [docs/dependencies.md](docs/dependencies.md) — how rendering works with no system deps
+| Doc | What it answers |
+|---|---|
+| [docs/tutorial.md](docs/tutorial.md) | Learn the tool by building a model from scratch |
+| [docs/patterns.md](docs/patterns.md) | The four Event Modeling patterns and their DSL shapes |
+| [docs/dsl.md](docs/dsl.md) | Full DSL reference: keywords, `from`, `again`, fields, notes |
+| [docs/cli.md](docs/cli.md) | Every command and flag |
+| [docs/validation.md](docs/validation.md) | Every rule `em validate` checks, and the fixes |
+| [docs/timeline.md](docs/timeline.md) | The Two Laws of the Timeline |
+| [docs/ai-workflow.md](docs/ai-workflow.md) | The Claude Code skill: install, phases, artifacts |
+| [docs/dependencies.md](docs/dependencies.md) | What's bundled vs. what needs a system install |
+| [docs/architecture.md](docs/architecture.md) | How rendering works; why Graphviz, not PlantUML |
+| [docs/roadmap.md](docs/roadmap.md) | What's planned |
 
 ## Development
 
@@ -192,32 +90,6 @@ npm test               # vitest
 npx tsx src/cli.ts <command> ...   # run straight from source
 ```
 
-## AI Assistant (Claude Code)
-
-`em` ships a **Claude Code skill** that guides you and your team through Event Modeling using the 7-step process and 4 design patterns, producing implementation-ready slice specifications. The AI drives the model — asking focused questions, never guessing domain facts — while `em validate` keeps the diagram honest.
-
-**Install the skill into your project:**
-
-```bash
-em skill install          # copies the skill into .claude/skills/event-modeling/
-em skill install --force  # overwrite an existing installation
-```
-
-Then, in Claude Code, run:
-
-```
-/event-modeling           # start (or resume) a guided session
-/event-modeling discover  # steps 1–4: brainstorm events, timeline, commands, read models
-/event-modeling model     # steps 5–7: swimlanes, patterns, completeness check
-/event-modeling slice     # deep implementation specs, one per slice
-/event-modeling watch     # open a live browser view for team modeling sessions
-/event-modeling validate  # run em validate and resolve all diagnostics
-```
-
-Sessions are **resumable** — the skill checkpoints progress in `.event-modeling.md` so you can continue across conversations.
-
-For a complete worked example (a headless CPQ system with ~50 slices), see the [em-with-ai repository](https://github.com/milehimikey/em-with-ai).
-
 ## License
 
 [MIT](LICENSE) © milehimikey

package/dist/cli.js

@@ -9,13 +9,14 @@ import { compile } from "./pipeline.js";
 import { ParseError } from "./parser/parser.js";
 import { renderDot, formatFromPath } from "./render/render.js";
 import { watchFile } from "./render/watch.js";
+import { startLiveServer } from "./render/serve.js";
 import { formatDiagnostic, hasErrors } from "./model/validate.js";
 import { STARTER_EM } from "./templates.js";
 const program = new Command();
 program
     .name("em")
     .description("Event Modeling CLI — slice-first DSL rendered as a strict Graphviz grid")
-    .version("1.1.1");
+    .version("1.2.0");
 program
     .command("init")
     .description("scaffold a starter .em model")
@@ -69,9 +70,12 @@ program
     .option("-o, --out <path>", "output path (extension picks the format)")
     .option("-T, --format <fmt>", "output format (svg, png, pdf, ...)")
     .option("--keep-empty-lanes", "keep the API lane even when empty")
+    .option("--serve", "serve a live viewer with instant push-reload (no polling)")
+    .option("--port <n>", "port for --serve (default 5173)", (v) => parseInt(v, 10))
     .action(async (file, opts) => {
     const out = opts.out ?? defaultOut(file, opts.format ?? "svg");
     const fmt = opts.format ?? formatFromPath(out);
+    let server;
     const build = async () => {
         const started = Date.now();
         try {
@@ -86,12 +90,25 @@ program
             }
             await renderDot(dot, model, out, fmt, dirname(file));
             console.log(`rendered ${out} (${Date.now() - started}ms)`);
+            server?.notify();
         }
         catch (e) {
             reportError(e);
         }
     };
     await build();
+    if (opts.serve) {
+        try {
+            // Serve the directory the SVG is written to — that's what the browser
+            // fetches, and note "..." links inside the SVG resolve relative to it.
+            server = await startLiveServer({ dir: dirname(resolve(out)), port: opts.port });
+            console.log(`→ live view: ${server.url}/?svg=${encodeURIComponent(basename(out))}`);
+            console.log("  open it in a browser and share your screen");
+        }
+        catch (e) {
+            reportError(e);
+        }
+    }
     watchFile(file, build);
     console.log(`watching ${file} … (ctrl-c to stop)`);
 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/render/serve.d.ts

@@ -0,0 +1,20 @@
+export interface LiveServer {
+    /** Base URL the viewer is served at, e.g. http://localhost:5173 */
+    url: string;
+    /** The port actually bound (differs from the request if it was taken). */
+    port: number;
+    /** Push a reload to every connected browser (call after a successful render). */
+    notify: () => void;
+    /** Stop the server and drop all SSE connections. */
+    close: () => Promise<void>;
+}
+export interface StartOptions {
+    /** Directory to serve (the model dir); static files are resolved within it. */
+    dir: string;
+    /** Preferred port; falls forward to the next free one if taken. */
+    port?: number;
+}
+/**
+ * Start the live server for `dir`. Resolves once it is listening.
+ */
+export declare function startLiveServer(opts: StartOptions): Promise<LiveServer>;

package/dist/render/serve.js

@@ -0,0 +1,202 @@
+// SPDX-License-Identifier: MIT
+// Optional localhost dev server for `em watch --serve`.
+//
+// Serves the model directory over HTTP and pushes an instant reload to the
+// browser via Server-Sent Events (SSE) after each successful re-render. This
+// replaces the poll-and-cache-bust loop of the static live.html viewer: no
+// polling, instant updates, and zero idle work between edits.
+//
+// Uses only Node's built-in `http` — no extra dependencies. Binds to
+// 127.0.0.1 (loopback) so the model is never exposed off the machine.
+import { createServer } from "node:http";
+import { createReadStream } from "node:fs";
+import { stat } from "node:fs/promises";
+import { extname, join, relative, resolve, sep } from "node:path";
+const HOST = "127.0.0.1";
+const DEFAULT_PORT = 5173;
+// Number of sequential ports to try if the preferred one is taken.
+const PORT_TRIES = 10;
+// Keepalive comment cadence so proxies/browsers don't drop the idle SSE stream.
+const SSE_KEEPALIVE_MS = 15000;
+const CONTENT_TYPES = {
+    ".svg": "image/svg+xml; charset=utf-8",
+    ".png": "image/png",
+    ".html": "text/html; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".pdf": "application/pdf",
+};
+/**
+ * Start the live server for `dir`. Resolves once it is listening.
+ */
+export async function startLiveServer(opts) {
+    const root = resolve(opts.dir);
+    const clients = new Set();
+    const server = createServer((req, res) => handle(req, res, root, clients));
+    const port = await listen(server, opts.port ?? DEFAULT_PORT);
+    const keepalive = setInterval(() => {
+        for (const res of clients)
+            res.write(": keepalive\n\n");
+    }, SSE_KEEPALIVE_MS);
+    // Don't let the keepalive timer hold the process open on its own.
+    keepalive.unref?.();
+    return {
+        url: `http://localhost:${port}`,
+        port,
+        notify() {
+            for (const res of clients)
+                res.write("data: reload\n\n");
+        },
+        async close() {
+            clearInterval(keepalive);
+            for (const res of clients)
+                res.end();
+            clients.clear();
+            await new Promise((res) => server.close(() => res()));
+        },
+    };
+}
+/** Try to listen on `port`, falling forward a few times if it's in use. */
+function listen(server, port) {
+    return new Promise((resolvePort, reject) => {
+        let attempt = 0;
+        const tryPort = (p) => {
+            const onError = (err) => {
+                if (err.code === "EADDRINUSE" && attempt < PORT_TRIES - 1) {
+                    attempt += 1;
+                    tryPort(p + 1);
+                }
+                else {
+                    reject(err);
+                }
+            };
+            server.once("error", onError);
+            server.listen(p, HOST, () => {
+                server.removeListener("error", onError);
+                // With p === 0 the OS assigns a free port; read the real one back.
+                resolvePort(server.address().port);
+            });
+        };
+        tryPort(port);
+    });
+}
+function handle(req, res, root, clients) {
+    const url = new URL(req.url ?? "/", "http://localhost");
+    const pathname = decodeURIComponent(url.pathname);
+    if (pathname === "/__events") {
+        openEventStream(res, clients);
+        return;
+    }
+    if (pathname === "/") {
+        res.writeHead(200, {
+            "content-type": "text/html; charset=utf-8",
+            "cache-control": "no-store",
+        });
+        res.end(VIEWER_HTML);
+        return;
+    }
+    serveStatic(pathname, root, res);
+}
+function openEventStream(res, clients) {
+    res.writeHead(200, {
+        "content-type": "text/event-stream",
+        "cache-control": "no-store",
+        connection: "keep-alive",
+    });
+    res.write(": connected\n\n");
+    clients.add(res);
+    res.on("close", () => clients.delete(res));
+}
+async function serveStatic(pathname, root, res) {
+    // Resolve within root and reject anything that escapes it (path traversal).
+    const target = resolve(join(root, "." + pathname));
+    const rel = relative(root, target);
+    if (rel === ".." || rel.startsWith(".." + sep) || (rel === "" && pathname !== "/")) {
+        res.writeHead(403).end("forbidden");
+        return;
+    }
+    try {
+        const info = await stat(target);
+        if (!info.isFile()) {
+            res.writeHead(404).end("not found");
+            return;
+        }
+        res.writeHead(200, {
+            "content-type": CONTENT_TYPES[extname(target).toLowerCase()] ?? "application/octet-stream",
+            "cache-control": "no-store",
+        });
+        createReadStream(target).pipe(res);
+    }
+    catch {
+        res.writeHead(404).end("not found");
+    }
+}
+// Served viewer page. Same double-buffered, no-flicker swap as the static
+// live.html fallback, but driven by SSE push instead of a poll loop — the
+// browser reloads only when the server says the SVG actually changed.
+const VIEWER_HTML = `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <title>Event Model — Live</title>
+  <style>
+    :root { color-scheme: light dark; }
+    body { margin: 0; font-family: system-ui, sans-serif; background: #fafafa; }
+    header {
+      display: flex; align-items: center; gap: .75rem;
+      padding: .5rem .9rem; background: #1f2933; color: #fff; font-size: 14px;
+    }
+    header .dot { width: 9px; height: 9px; border-radius: 50%; background: #34c759; transition: background .3s; }
+    header .dot.stale { background: #f0a020; }
+    header .stamp { margin-left: auto; opacity: .7; font-variant-numeric: tabular-nums; }
+    #stage { padding: 1rem; }
+    object { width: 100%; height: calc(100vh - 60px); border: 0; }
+  </style>
+</head>
+<body>
+  <header>
+    <span class="dot" id="dot"></span>
+    <span>Event Model — live (push)</span>
+    <span class="stamp" id="stamp">connecting…</span>
+  </header>
+  <div id="stage">
+    <object id="svg" type="image/svg+xml"></object>
+  </div>
+  <script>
+    // The SVG filename comes from ?svg=<name>.svg (defaults to model.svg), so one
+    // server serves any model without editing this page.
+    const SVG_FILE = new URLSearchParams(location.search).get("svg") || "model.svg";
+    const stage = document.getElementById("stage");
+    const stamp = document.getElementById("stamp");
+    const dot = document.getElementById("dot");
+    let current = document.getElementById("svg");
+
+    // Double-buffer: load into a hidden <object>, swap on load, so the shared
+    // screen never flashes white during a reload. Keep <object> (not <img>) so
+    // note "..." links inside the SVG stay clickable.
+    function reload() {
+      dot.classList.add("stale");
+      const next = document.createElement("object");
+      next.type = "image/svg+xml";
+      next.style.cssText = current.style.cssText;
+      next.addEventListener("load", () => {
+        stage.replaceChild(next, current);
+        current = next;
+        stamp.textContent = new Date().toLocaleTimeString();
+        dot.classList.remove("stale");
+      }, { once: true });
+      next.setAttribute("data", SVG_FILE + "?t=" + Date.now());
+    }
+
+    reload();
+
+    const es = new EventSource("/__events");
+    es.onopen = () => { stamp.textContent = new Date().toLocaleTimeString(); };
+    es.onmessage = reload;
+    es.onerror = () => { dot.classList.add("stale"); };
+  </script>
+</body>
+</html>
+`;
+//# sourceMappingURL=serve.js.map

package/dist/render/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/render/serve.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,wDAAwD;AACxD,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,8DAA8D;AAC9D,EAAE;AACF,qEAAqE;AACrE,sEAAsE;AAEtE,OAAO,EAAE,YAAY,EAAmC,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAElE,MAAM,IAAI,GAAG,WAAW,CAAC;AACzB,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,mEAAmE;AACnE,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,gFAAgF;AAChF,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B,MAAM,aAAa,GAA2B;IAC5C,MAAM,EAAE,8BAA8B;IACtC,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,0BAA0B;IACnC,MAAM,EAAE,yBAAyB;IACjC,KAAK,EAAE,gCAAgC;IACvC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,iBAAiB;CAC1B,CAAC;AAoBF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAkB;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3E,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC,CAAC;IAE7D,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,KAAK,MAAM,GAAG,IAAI,OAAO;YAAE,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC1D,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACrB,kEAAkE;IAClE,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;IAEpB,OAAO;QACL,GAAG,EAAE,oBAAoB,IAAI,EAAE;QAC/B,IAAI;QACJ,MAAM;YACJ,KAAK,MAAM,GAAG,IAAI,OAAO;gBAAE,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC3D,CAAC;QACD,KAAK,CAAC,KAAK;YACT,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,KAAK,MAAM,GAAG,IAAI,OAAO;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAC;YACrC,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,OAAO,CAAO,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,SAAS,MAAM,CACb,MAAuC,EACvC,IAAY;IAEZ,OAAO,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE;QACzC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE;YAC5B,MAAM,OAAO,GAAG,CAAC,GAA0B,EAAE,EAAE;gBAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;oBAC1D,OAAO,IAAI,CAAC,CAAC;oBACb,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjB,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE;gBAC1B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACxC,mEAAmE;gBACnE,WAAW,CAAE,MAAM,CAAC,OAAO,EAAkB,CAAC,IAAI,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,MAAM,CACb,GAAoB,EACpB,GAAmB,EACnB,IAAY,EACZ,OAA4B;IAE5B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAElD,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QACrB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,0BAA0B;YAC1C,eAAe,EAAE,UAAU;SAC5B,CAAC,CAAC;QACH,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,eAAe,CAAC,GAAmB,EAAE,OAA4B;IACxE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,cAAc,EAAE,mBAAmB;QACnC,eAAe,EAAE,UAAU;QAC3B,UAAU,EAAE,YAAY;KACzB,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,QAAgB,EAChB,IAAY,EACZ,GAAmB;IAEnB,4EAA4E;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,IAAI,QAAQ,KAAK,GAAG,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACpC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,0BAA0B;YAC1F,eAAe,EAAE,UAAU;SAC5B,CAAC,CAAC;QACH,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,0EAA0E;AAC1E,sEAAsE;AACtE,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DnB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@milehimikey/em",
-  "version": "1.1.1",
-  "description": "AI-friendly Event Modeling \u2014 a slice-first text DSL rendered to a strict, self-contained Graphviz grid (SVG/PNG)",
+  "version": "1.2.0",
+  "description": "AI-friendly Event Modeling — a slice-first text DSL rendered to a strict, self-contained Graphviz grid (SVG/PNG)",
   "type": "module",
   "bin": {
     "em": "./dist/cli.js"
@@ -59,4 +59,4 @@
     "typescript": "^5.6.0",
     "vitest": "^2.1.0"
   }
-}
+}