@milehimikey/em 1.7.2 → 1.8.1

package/dist/util/markers.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: MIT
+// Shared marker-delimited region patcher: `<!-- GENERATED:<name>:start -->...
+// <!-- GENERATED:<name>:end -->`. Originally scripts/generate-skill-docs.ts's own local helper
+// (MIL-92, docs-generation only); extracted here so a real runtime command — `em slice index`
+// (MIL-98) — can reuse the exact same marker convention instead of re-deriving its own regex.
+// Pure string in, string (or null) out — no fs access, so both a dev script and a CLI command
+// can layer their own file-reading and error reporting on top.
+/** Captures the exact start/end marker lines separately from whatever sits between them, so
+ *  replacement never depends on how much whitespace happened to separate them before — matters
+ *  for a freshly-added, still-empty marker pair (start line immediately followed by end line,
+ *  nothing in between to non-greedily match a leading "\n" against). */
+export function markerRegex(name) {
+    const start = `<!-- GENERATED:${name}:start[^\\n]*-->`;
+    const end = `<!-- GENERATED:${name}:end -->`;
+    return new RegExp(`(${start})([\\s\\S]*?)(${end})`);
+}
+/**
+ * Replace the body between the named marker pair in `content` with `newBody`, preserving the
+ * marker lines themselves verbatim. Returns `null` (never throws) when the marker pair isn't
+ * found in `content` — callers decide how to report that: a dev-tooling throw
+ * (scripts/generate-skill-docs.ts), or a user-facing CLI error suggesting how to add the
+ * markers (`em slice index`, src/cli/sliceIndex.ts).
+ */
+export function applyMarker(content, markerName, newBody) {
+    const re = markerRegex(markerName);
+    if (!re.test(content))
+        return null;
+    return content.replace(re, (_m, open, _old, close) => `${open}\n${newBody}\n${close}`);
+}
+//# sourceMappingURL=markers.js.map

package/dist/util/markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.js","sourceRoot":"","sources":["../../src/util/markers.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,8EAA8E;AAC9E,+FAA+F;AAC/F,8FAA8F;AAC9F,8FAA8F;AAC9F,8FAA8F;AAC9F,+DAA+D;AAE/D;;;wEAGwE;AACxE,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,kBAAkB,IAAI,kBAAkB,CAAC;IACvD,MAAM,GAAG,GAAG,kBAAkB,IAAI,UAAU,CAAC;IAC7C,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,GAAG,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,UAAkB,EAAE,OAAe;IAC9E,MAAM,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC;AACzF,CAAC"}

package/dist/util/walkDir.d.ts

@@ -1,4 +1,13 @@
+export interface WalkDirOptions {
+    /** When given, called with each directory entry's bare name before descending into it; a
+     *  `true` return prunes the whole subtree (never read via `readdirSync`, never descended) —
+     *  cheaper and safer than walking everything and filtering the flat result list afterward
+     *  (skips permission errors / huge trees under a pruned dir too, e.g. `node_modules`). Omitted
+     *  entirely by every existing caller (skillSync.ts/skillCheck.ts), which still walk the whole
+     *  tree with no behavior change. */
+    skipDir?: (name: string) => boolean;
+}
 /** Every regular file under `dir`, recursively, as paths relative to `dir` — sorted, POSIX
  *  forward slashes regardless of platform (so hashes/change-reports are stable and testable
  *  across OSes). Symlinks and other non-file/non-directory entries are skipped. */
-export declare function walkDir(dir: string): string[];
+export declare function walkDir(dir: string, opts?: WalkDirOptions): string[];

package/dist/util/walkDir.js

@@ -2,7 +2,7 @@
 // Recursive file-tree listing shared by `em skill sync`/`em skill check` (src/cli/skillSync.ts,
 // src/cli/skillCheck.ts) to enumerate every file in the bundled skill directory — not just the
 // `.md` subset test/skillExamples.test.ts's skillFiles() walks for doctesting, which deliberately
-// skips non-`.md` files like templates/live.html. Sync/check must cover the whole tree.
+// skips any non-`.md` file the skill may bundle. Sync/check must cover the whole tree.
 //
 // Manual walk rather than `readdirSync(dir, { recursive: true })` — that overload is Node
 // 20.1+ only; package.json declares `"engines": { "node": ">=18" }`.
@@ -11,15 +11,19 @@ import { join, relative, sep } from "node:path";
 /** Every regular file under `dir`, recursively, as paths relative to `dir` — sorted, POSIX
  *  forward slashes regardless of platform (so hashes/change-reports are stable and testable
  *  across OSes). Symlinks and other non-file/non-directory entries are skipped. */
-export function walkDir(dir) {
+export function walkDir(dir, opts) {
     const out = [];
+    const skipDir = opts?.skipDir;
     function recurse(current) {
         for (const entry of readdirSync(current, { withFileTypes: true })) {
-            const full = join(current, entry.name);
-            if (entry.isDirectory())
-                recurse(full);
-            else if (entry.isFile())
-                out.push(relative(dir, full).split(sep).join("/"));
+            if (entry.isDirectory()) {
+                if (skipDir?.(entry.name))
+                    continue;
+                recurse(join(current, entry.name));
+            }
+            else if (entry.isFile()) {
+                out.push(relative(dir, join(current, entry.name)).split(sep).join("/"));
+            }
         }
     }
     recurse(dir);

package/dist/util/walkDir.js.map

@@ -1 +1 @@
-{"version":3,"file":"walkDir.js","sourceRoot":"","sources":["../../src/util/walkDir.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,gGAAgG;AAChG,+FAA+F;AAC/F,kGAAkG;AAClG,wFAAwF;AACxF,EAAE;AACF,0FAA0F;AAC1F,qEAAqE;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhD;;mFAEmF;AACnF,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,SAAS,OAAO,CAAC,OAAe;QAC9B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;iBAClC,IAAI,KAAK,CAAC,MAAM,EAAE;gBAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}
+{"version":3,"file":"walkDir.js","sourceRoot":"","sources":["../../src/util/walkDir.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,gGAAgG;AAChG,+FAA+F;AAC/F,kGAAkG;AAClG,uFAAuF;AACvF,EAAE;AACF,0FAA0F;AAC1F,qEAAqE;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAYhD;;mFAEmF;AACnF,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAAqB;IACxD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC;IAE9B,SAAS,OAAO,CAAC,OAAe;QAC9B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAClE,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACpC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACrC,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@milehimikey/em",
-  "version": "1.7.2",
+  "version": "1.8.1",
   "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"
+    "em": "./dist/cli.js",
+    "em-mcp": "./dist/mcp/main.js"
   },
   "main": "./dist/cli.js",
   "files": [
@@ -21,6 +22,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "docs:generate": "tsx scripts/generate-skill-docs.ts",
+    "viewer:generate": "tsx scripts/generate-viewer-html.ts",
+    "viewer:check": "tsx scripts/generate-viewer-html.ts --check",
     "docs:check": "tsx scripts/generate-skill-docs.ts --check",
     "check:skill-version": "tsx scripts/check-skill-version-stamp.ts",
     "prepublishOnly": "npm run build && npm run typecheck && npm test"
@@ -53,13 +56,19 @@
   },
   "dependencies": {
     "@hpcc-js/wasm-graphviz": "^1.22.0",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "@resvg/resvg-js": "^2.6.2",
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
-    "marked": "^18.0.0"
+    "marked": "^18.0.0",
+    "pdfkit": "^0.19.1",
+    "svg-to-pdfkit": "^0.1.8",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "@types/pdfkit": "^0.17.6",
+    "jsdom": "^26.1.0",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0",
     "vitest": "^4.1.10"

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

@@ -1,117 +0,0 @@
-<!doctype html>
-<!--
-  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.
-
-  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.
--->
-<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; }
-    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"></span>
-    <span>Event Model — live (auto-refresh)</span>
-    <span class="stamp" id="stamp">—</span>
-  </header>
-  <div id="stage">
-    <object id="svg" type="image/svg+xml"></object>
-  </div>
-  <script>
-    // 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");
-    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
-      }
-    }
-
-    // Double-buffer: load into a hidden <object>, swap on load, so the shared screen
-    // never flashes white during a reload. The buffer must be attached to the document
-    // BEFORE data is set — a detached <object> never starts fetching its resource, so
-    // its load event would never fire and the swap would never happen.
-    let pending = null; // the in-flight buffer <object>, if a swap is loading
-    function swap() {
-      if (pending) pending.remove(); // superseded by this newer swap
-      const next = document.createElement("object");
-      next.type = "image/svg+xml";
-      next.style.cssText = current.style.cssText;
-      next.style.position = "absolute"; // out of flow + invisible while loading
-      next.style.visibility = "hidden";
-      next.addEventListener("load", () => {
-        if (pending !== next) return; // a newer swap already replaced this one
-        pending = null;
-        next.style.position = "";
-        next.style.visibility = "";
-        stage.removeChild(current);
-        current = next;
-        stamp.textContent = new Date().toLocaleTimeString();
-      }, { once: true });
-      stage.appendChild(next);
-      pending = next;
-      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>