@milehimikey/em 1.8.1 → 1.9.0

package/dist/util/markers.js

@@ -1,17 +1,22 @@
 // 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.
+// <!-- GENERATED:<name>:end -->` (or, for a file whose format doesn't support HTML comments,
+// `# 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. The `hash` style was added for `em ci init`
+// (MIL-166), whose generated files are YAML (no `<!-- -->` comment syntax).
 // 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 -->`;
+ *  nothing in between to non-greedily match a leading "\n" against). The `[^\n]*` tail on the
+ *  start line lets a caller append trailing prose after `:start` (e.g. em-dsl.md's "-- run `npm
+ *  run docs:generate` to refresh, do not hand-edit") without breaking the match. */
+export function markerRegex(name, style = "html") {
+    const start = style === "hash" ? `# GENERATED:${name}:start[^\\n]*` : `<!-- GENERATED:${name}:start[^\\n]*-->`;
+    const end = style === "hash" ? `# GENERATED:${name}:end` : `<!-- GENERATED:${name}:end -->`;
     return new RegExp(`(${start})([\\s\\S]*?)(${end})`);
 }
 /**
@@ -19,12 +24,20 @@ export function markerRegex(name) {
  * 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).
+ * markers (`em slice index`, src/cli/sliceIndex.ts; `em ci init`, src/cli/ciInit.ts).
  */
-export function applyMarker(content, markerName, newBody) {
-    const re = markerRegex(markerName);
+export function applyMarker(content, markerName, newBody, style = "html") {
+    const re = markerRegex(markerName, style);
     if (!re.test(content))
         return null;
     return content.replace(re, (_m, open, _old, close) => `${open}\n${newBody}\n${close}`);
 }
+/** The bare start/end marker lines for `markerName`, for a caller writing a fresh marker pair
+ *  from scratch (e.g. `em ci init` creating a brand-new file, or `em ci init --check` reporting
+ *  what a from-scratch file would contain). */
+export function markerPair(markerName, style = "html") {
+    return style === "hash"
+        ? { start: `# GENERATED:${markerName}:start`, end: `# GENERATED:${markerName}:end` }
+        : { start: `<!-- GENERATED:${markerName}:start -->`, end: `<!-- GENERATED:${markerName}:end -->` };
+}
 //# sourceMappingURL=markers.js.map

package/dist/util/markers.js.map

@@ -1 +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"}
+{"version":3,"file":"markers.js","sourceRoot":"","sources":["../../src/util/markers.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,8EAA8E;AAC9E,6FAA6F;AAC7F,uEAAuE;AACvE,8FAA8F;AAC9F,+FAA+F;AAC/F,+FAA+F;AAC/F,4EAA4E;AAC5E,8FAA8F;AAC9F,+DAA+D;AAM/D;;;;;oFAKoF;AACpF,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,QAAqB,MAAM;IACnE,MAAM,KAAK,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,IAAI,eAAe,CAAC,CAAC,CAAC,kBAAkB,IAAI,kBAAkB,CAAC;IAC/G,MAAM,GAAG,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,IAAI,MAAM,CAAC,CAAC,CAAC,kBAAkB,IAAI,UAAU,CAAC;IAC5F,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,EAAE,QAAqB,MAAM;IAC3G,MAAM,EAAE,GAAG,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC1C,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;AAED;;+CAE+C;AAC/C,MAAM,UAAU,UAAU,CAAC,UAAkB,EAAE,QAAqB,MAAM;IACxE,OAAO,KAAK,KAAK,MAAM;QACrB,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,UAAU,QAAQ,EAAE,GAAG,EAAE,eAAe,UAAU,MAAM,EAAE;QACpF,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,UAAU,YAAY,EAAE,GAAG,EAAE,kBAAkB,UAAU,UAAU,EAAE,CAAC;AACvG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milehimikey/em",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "description": "AI-friendly Event Modeling — a slice-first text DSL rendered to a strict, self-contained Graphviz grid (SVG/PNG)",
   "type": "module",
   "bin": {
@@ -68,6 +68,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/pdfkit": "^0.17.6",
+    "@typespec/compiler": "^1.15.0",
     "jsdom": "^26.1.0",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0",