@milehimikey/em 1.9.1 → 1.10.0

package/dist/system/manifest.js

@@ -0,0 +1,178 @@
+// SPDX-License-Identifier: MIT
+// Parses a seam manifest (`system.yaml`, MIL-194) into a plain, validated shape — the declared
+// list of models in a system plus the seams binding one model's `public` event/view to another
+// model's reaction. This is the one place the manifest's own schema is enforced; everything
+// downstream (src/system/verify.ts) trusts the returned `SystemManifest`.
+//
+// YAML because the manifest is human-authored (and JSON is a YAML subset, so a `.json` manifest
+// parses here unchanged). Pure: text in, manifest + diagnostics out — the caller (src/cli/
+// systemInputs.ts) owns reading the file and resolving each model's `source` path, so this
+// module never touches the filesystem. Line numbers come from the YAML parser's own
+// `LineCounter`, so a shape error points at the offending entry, not just "the manifest".
+import { LineCounter, parseDocument, isMap, isSeq, isScalar } from "yaml";
+import { pushDiag } from "../model/rules.js";
+/** The only manifest schema version accepted (`systemSchemaVersion`). Bumped, with a range
+ *  check here, the day the manifest's shape changes incompatibly. */
+export const SYSTEM_MANIFEST_SCHEMA_VERSION = "1.0";
+const TOP_KEYS = new Set(["systemSchemaVersion", "name", "models", "seams"]);
+const MODEL_KEYS = new Set(["source", "owner"]);
+const SEAM_KEYS = new Set(["from", "to", "description"]);
+/** Parse and shape-check manifest text. Every problem is a `system-manifest-invalid` error
+ *  diagnostic (never a throw), and `ok: false` means the manifest can't be used at all — the
+ *  caller refuses rather than verifying a partial system. Unknown keys are errors, not ignored:
+ *  a misspelled `seam:` silently declaring zero seams would defeat the whole check. */
+export function parseManifest(text) {
+    const diagnostics = [];
+    const lineCounter = new LineCounter();
+    const doc = parseDocument(text, { lineCounter, prettyErrors: false });
+    const lineOf = (node) => {
+        const range = node && "range" in node ? node.range : isPairLike(node) ? node.key?.range : undefined;
+        return range ? lineCounter.linePos(range[0]).line : undefined;
+    };
+    const invalid = (message, line) => pushDiag(diagnostics, "system-manifest-invalid", { message, line });
+    if (doc.errors.length > 0) {
+        for (const e of doc.errors) {
+            const line = e.linePos?.[0]?.line;
+            invalid(`YAML parse error: ${e.message.trim()}`, line);
+        }
+        return { ok: false, diagnostics };
+    }
+    const root = doc.contents;
+    if (!isMap(root)) {
+        invalid("manifest must be a YAML mapping with `systemSchemaVersion`, `models`, and optionally `name`/`seams`");
+        return { ok: false, diagnostics };
+    }
+    for (const pair of root.items) {
+        const key = scalarString(pair.key);
+        if (key === undefined || !TOP_KEYS.has(key)) {
+            invalid(`unknown top-level key ${describeKey(pair.key)} — expected one of: ${[...TOP_KEYS].join(", ")}`, lineOf(pair));
+        }
+    }
+    // systemSchemaVersion — required, and exactly the one version this em understands.
+    const versionNode = root.get("systemSchemaVersion", true);
+    const version = scalarString(versionNode);
+    if (version === undefined) {
+        invalid(`missing or non-string \`systemSchemaVersion\` — set \`systemSchemaVersion: "${SYSTEM_MANIFEST_SCHEMA_VERSION}"\``, lineOf(versionNode));
+    }
+    else if (version !== SYSTEM_MANIFEST_SCHEMA_VERSION) {
+        invalid(`unsupported systemSchemaVersion "${version}" — this em accepts "${SYSTEM_MANIFEST_SCHEMA_VERSION}"`, lineOf(versionNode));
+    }
+    // name — optional string.
+    const nameNode = root.get("name", true);
+    let name = null;
+    if (nameNode !== undefined) {
+        const n = scalarString(nameNode);
+        if (n === undefined)
+            invalid("`name` must be a string", lineOf(nameNode));
+        else
+            name = n;
+    }
+    // models — required mapping, ≥ 1 entry, each `{ source, owner? }`.
+    const models = [];
+    const modelsNode = root.get("models", true);
+    if (!isMap(modelsNode)) {
+        invalid("`models` must be a mapping of model key -> { source, owner? } with at least one entry", lineOf(modelsNode ?? root));
+    }
+    else if (modelsNode.items.length === 0) {
+        invalid("`models` must declare at least one model", lineOf(modelsNode));
+    }
+    else {
+        for (const pair of modelsNode.items) {
+            const key = scalarString(pair.key);
+            const line = lineOf(pair) ?? lineOf(modelsNode);
+            if (key === undefined || key.trim() === "") {
+                invalid(`model key ${describeKey(pair.key)} must be a non-empty string`, line);
+                continue;
+            }
+            const entry = pair.value;
+            if (!isMap(entry)) {
+                invalid(`model "${key}" must be a mapping with a \`source\` (a .em file or an \`em export --json\` document)`, line);
+                continue;
+            }
+            for (const p of entry.items) {
+                const k = scalarString(p.key);
+                if (k === undefined || !MODEL_KEYS.has(k))
+                    invalid(`model "${key}": unknown key ${describeKey(p.key)} — expected source, owner`, lineOf(p));
+            }
+            const source = scalarString(entry.get("source", true));
+            if (source === undefined || source.trim() === "") {
+                invalid(`model "${key}": \`source\` must be a non-empty path string`, line);
+                continue;
+            }
+            const ownerNode = entry.get("owner", true);
+            let owner = null;
+            if (ownerNode !== undefined) {
+                const o = scalarString(ownerNode);
+                if (o === undefined)
+                    invalid(`model "${key}": \`owner\` must be a string`, lineOf(ownerNode));
+                else
+                    owner = o;
+            }
+            models.push({ key, source, owner, line: line ?? 1 });
+        }
+    }
+    // seams — optional sequence of `{ from, to, description? }`.
+    const seams = [];
+    const seamsNode = root.get("seams", true);
+    if (seamsNode !== undefined && !(isScalar(seamsNode) && seamsNode.value === null)) {
+        if (!isSeq(seamsNode)) {
+            invalid("`seams` must be a list of { from, to, description? } entries", lineOf(seamsNode));
+        }
+        else {
+            seamsNode.items.forEach((item, i) => {
+                const line = lineOf(item) ?? lineOf(seamsNode);
+                if (!isMap(item)) {
+                    invalid(`seams[${i}] must be a mapping with \`from\` and \`to\``, line);
+                    return;
+                }
+                for (const p of item.items) {
+                    const k = scalarString(p.key);
+                    if (k === undefined || !SEAM_KEYS.has(k))
+                        invalid(`seams[${i}]: unknown key ${describeKey(p.key)} — expected from, to, description`, lineOf(p));
+                }
+                const from = scalarString(item.get("from", true));
+                const to = scalarString(item.get("to", true));
+                if (from === undefined || from.trim() === "")
+                    invalid(`seams[${i}]: \`from\` must be a qualified ref string (<modelKey>:<sliceKey>/<kind>.<slug>)`, line);
+                if (to === undefined || to.trim() === "")
+                    invalid(`seams[${i}]: \`to\` must be a qualified ref string (<modelKey>:<sliceKey>/<kind>.<slug>, or <modelKey>:<sliceKey>)`, line);
+                const descNode = item.get("description", true);
+                let description = null;
+                if (descNode !== undefined && !(isScalar(descNode) && descNode.value === null)) {
+                    const d = scalarString(descNode);
+                    if (d === undefined)
+                        invalid(`seams[${i}]: \`description\` must be a string`, lineOf(descNode));
+                    else
+                        description = d;
+                }
+                if (from !== undefined && from.trim() !== "" && to !== undefined && to.trim() !== "") {
+                    seams.push({ from: from.trim(), to: to.trim(), description, line: line ?? 1 });
+                }
+            });
+        }
+    }
+    if (diagnostics.length > 0)
+        return { ok: false, diagnostics };
+    return {
+        ok: true,
+        manifest: { systemSchemaVersion: version, name, models, seams },
+        diagnostics,
+    };
+}
+function isPairLike(node) {
+    return typeof node === "object" && node !== null && "key" in node && "value" in node && !("range" in node);
+}
+/** A scalar node's value as a string — `undefined` for a missing node, a non-scalar, or a
+ *  non-string scalar (numbers/booleans/null are never accepted where a string is required, so
+ *  `systemSchemaVersion: 1.0` — a YAML float — is rejected, not silently coerced). */
+function scalarString(node) {
+    if (!isScalar(node))
+        return undefined;
+    return typeof node.value === "string" ? node.value : undefined;
+}
+function describeKey(node) {
+    if (isScalar(node))
+        return `"${String(node.value)}"`;
+    return "(non-scalar key)";
+}
+//# sourceMappingURL=manifest.js.map

package/dist/system/manifest.js.map

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

package/dist/system/verify.d.ts

@@ -0,0 +1,88 @@
+import { ElementKind } from "../parser/ast.js";
+import type { Diagnostic } from "../model/validate.js";
+import type { SystemManifest } from "./manifest.js";
+/** The subset of one `em export --json` document `verifySystem` reads. */
+export interface SystemExportElement {
+    ref: string;
+    kind: ElementKind;
+    name: string;
+    line: number;
+    public: boolean;
+}
+export interface SystemExportSlice {
+    key: string;
+    name: string;
+    elements: SystemExportElement[];
+}
+export interface SystemExportDoc {
+    schemaVersion: string;
+    model: {
+        key: string;
+        name: string | null;
+        slices: SystemExportSlice[];
+        edges: {
+            from: string;
+            to: string;
+        }[];
+    };
+}
+export type SystemSourceKind = "em" | "export";
+/** One model, loaded by the caller: the manifest's entry plus its export document and the
+ *  path diagnostics about it should point at (the `.em` file, or the export `.json`). */
+export interface SystemModelInput {
+    key: string;
+    source: string;
+    sourceKind: SystemSourceKind;
+    owner: string | null;
+    /** Path diagnostics about this model's elements point at — resolved, as the CLI prints it. */
+    file: string;
+    doc: SystemExportDoc;
+}
+/** A diagnostic plus the file it concerns — `em status --json`'s multi-model convention. */
+export interface SystemDiagnostic extends Diagnostic {
+    file: string;
+}
+export interface SystemModelReport {
+    key: string;
+    name: string | null;
+    source: string;
+    sourceKind: SystemSourceKind;
+    owner: string | null;
+    /** Unqualified (`<sliceKey>/<kind>.<slug>`) refs of every `public` element, export order. */
+    publicSurface: string[];
+}
+export interface SystemSeamReport {
+    /** Resolved, element-level qualified ref when the endpoint resolved; else the ref as written. */
+    from: string;
+    to: string;
+    fromSlice: string | null;
+    toSlice: string | null;
+    description: string | null;
+    status: "verified" | "error";
+    /** Codes of every diagnostic raised on this seam (errors and warnings), in raise order. */
+    diagnostics: string[];
+}
+export interface ContextMap {
+    nodes: {
+        key: string;
+        name: string | null;
+        owner: string | null;
+    }[];
+    /** One edge per ordered model pair with at least one declared seam (verified or not), sorted
+     *  by (from, to); `seams` counts the declarations. */
+    edges: {
+        from: string;
+        to: string;
+        seams: number;
+    }[];
+}
+export interface SystemReport {
+    name: string | null;
+    models: SystemModelReport[];
+    seams: SystemSeamReport[];
+    contextMap: ContextMap;
+    diagnostics: SystemDiagnostic[];
+}
+/** Verify `manifest` against the loaded `models` (one per manifest entry, same order).
+ *  `manifestFile` is the path manifest-level diagnostics point at. */
+export declare function verifySystem(manifest: SystemManifest, models: SystemModelInput[], manifestFile: string): SystemReport;

package/dist/system/verify.js

@@ -0,0 +1,263 @@
+// SPDX-License-Identifier: MIT
+// Verifies a seam manifest against the models' export documents (MIL-194) — the cross-model
+// half of the bedrock "both ends of a flow" rule. A seam is a `public` event/view on one side
+// bound to a reaction (translation/automation-kind element) on the other; `em` already has both
+// ends of every seam, it just never had them as data. This module makes the binding explicit and
+// checks it: both endpoints resolve, the source really is `public`, the consumer really is a
+// reaction, nothing published goes unread, nothing externally fed goes unclaimed, and the old
+// portal name-matching heuristic is demoted to a lint (`undeclared-seam-candidate`).
+//
+// It reads EXPORT DOCUMENTS ONLY — the `SystemExportDoc` shape below is the slice of `em
+// export --json` (schema >= 1.10: `model.key`, `model.edges`) this check needs, and nothing here
+// touches a NormalizedModel. That's the constraint the ticket sets ("models still compile
+// independently — no compile-time coupling"): a `.em` source is compiled into the same export
+// document by the caller (src/cli/systemInputs.ts), so this verifier can't tell a co-located
+// repo from a CI job aggregating exports from ten repos. Pure: no fs, no clock; output order
+// is manifest order for models/seams and stable derivation order for everything else.
+import { AUTOMATION_KINDS } from "../parser/ast.js";
+import { normalizeName } from "../model/model.js";
+import { formatQualifiedRef, parseQualifiedRef } from "../model/qualifiedRef.js";
+import { pushDiag } from "../model/rules.js";
+const SEAM_ERROR_CODES = new Set([
+    "system-manifest-invalid",
+    "seam-endpoint-unresolved",
+    "seam-source-not-public",
+    "seam-consumer-not-reaction",
+]);
+/** Verify `manifest` against the loaded `models` (one per manifest entry, same order).
+ *  `manifestFile` is the path manifest-level diagnostics point at. */
+export function verifySystem(manifest, models, manifestFile) {
+    const diagnostics = [];
+    const raise = (file, code, extra) => {
+        const bucket = [];
+        pushDiag(bucket, code, extra);
+        diagnostics.push({ ...bucket[0], file });
+    };
+    const qualify = formatQualifiedRef;
+    // Models are addressed by their MANIFEST key throughout — even on a mismatch, so a seam
+    // written against the manifest's own vocabulary still verifies and the one error tells the
+    // author exactly which key to change.
+    const byKey = new Map();
+    for (const m of models) {
+        byKey.set(m.key, m);
+        if (m.doc.model.key !== m.key) {
+            const entry = manifest.models.find((e) => e.key === m.key);
+            const modelLabel = m.doc.model.name === null ? "(unnamed model)" : `model "${m.doc.model.name}"`;
+            raise(manifestFile, "system-model-key-mismatch", {
+                message: `manifest key "${m.key}" does not match the computed key "${m.doc.model.key}" of ${modelLabel} ` +
+                    `(${m.source}) — rename the manifest entry to "${m.doc.model.key}"`,
+                line: entry?.line,
+            });
+        }
+    }
+    const isReaction = (el) => AUTOMATION_KINDS.has(el.kind);
+    const isSurface = (el) => el.public === true && (el.kind === "event" || el.kind === "view");
+    const findElement = (model, ref) => {
+        for (const slice of model.doc.model.slices) {
+            for (const element of slice.elements)
+                if (element.ref === ref)
+                    return { slice, element };
+        }
+        return undefined;
+    };
+    // ---- Seams: resolve both endpoints, then check what each one is. ----
+    const consumedSurface = new Set(); // qualified refs named as a resolved `from`
+    const boundReactions = new Set(); // qualified refs named as a resolved `to`
+    const declaredPairs = new Map(); // fromQualified -> set of toQualified
+    const seenPairs = new Set();
+    const seamsByModelPair = new Map();
+    const seams = manifest.seams.map((seam, i) => {
+        const codes = [];
+        const seamRaise = (code, message, refs) => {
+            codes.push(code);
+            raise(manifestFile, code, { message: `seams[${i}] (${seam.from} -> ${seam.to}): ${message}`, line: seam.line, refs });
+        };
+        const resolveModel = (raw, side) => {
+            const parsed = parseQualifiedRef(raw);
+            if (parsed.modelKey === null) {
+                seamRaise("system-manifest-invalid", `\`${side}\` must be a model-qualified ref (<modelKey>:<sliceKey>/<kind>.<slug>), got "${raw}"`);
+                return undefined;
+            }
+            const model = byKey.get(parsed.modelKey);
+            if (!model) {
+                seamRaise("system-manifest-invalid", `\`${side}\` names unknown model key "${parsed.modelKey}" — declared models are: ${manifest.models.map((m) => m.key).join(", ")}`);
+                return undefined;
+            }
+            return { modelKey: parsed.modelKey, ref: parsed.ref, model };
+        };
+        // `from`: an element ref that must be a `public` event/view.
+        let from;
+        const fromModel = resolveModel(seam.from, "from");
+        if (fromModel) {
+            const hit = findElement(fromModel.model, fromModel.ref);
+            if (!hit) {
+                seamRaise("seam-endpoint-unresolved", `no element "${fromModel.ref}" in model "${fromModel.modelKey}" — check \`em export\`'s refs, or re-declare the seam after a rename`);
+            }
+            else {
+                from = { modelKey: fromModel.modelKey, model: fromModel.model, ...hit };
+                if (!isSurface(hit.element)) {
+                    const why = hit.element.kind === "event" || hit.element.kind === "view"
+                        ? "is not marked `public`"
+                        : `is a ${hit.element.kind}, not a \`public\` event or view`;
+                    seamRaise("seam-source-not-public", `${hit.element.kind} "${hit.element.name}" ${why}`, [qualify(from.modelKey, hit.element.ref)]);
+                }
+            }
+        }
+        // `to`: an element ref to a reaction, or a bare slice ref containing exactly one reaction.
+        let to;
+        const toModel = resolveModel(seam.to, "to");
+        if (toModel) {
+            if (toModel.ref.includes("/")) {
+                const hit = findElement(toModel.model, toModel.ref);
+                if (!hit) {
+                    seamRaise("seam-endpoint-unresolved", `no element "${toModel.ref}" in model "${toModel.modelKey}" — check \`em export\`'s refs, or re-declare the seam after a rename`);
+                }
+                else {
+                    to = { modelKey: toModel.modelKey, model: toModel.model, ...hit };
+                    if (!isReaction(hit.element)) {
+                        seamRaise("seam-consumer-not-reaction", `${hit.element.kind} "${hit.element.name}" is not a reaction — \`to\` must name a translation/automation/processor/saga element`, [qualify(to.modelKey, hit.element.ref)]);
+                    }
+                }
+            }
+            else {
+                const slice = toModel.model.doc.model.slices.find((s) => s.key === toModel.ref);
+                if (!slice) {
+                    seamRaise("seam-endpoint-unresolved", `no slice "${toModel.ref}" in model "${toModel.modelKey}"`);
+                }
+                else {
+                    const reactions = slice.elements.filter(isReaction);
+                    if (reactions.length === 1) {
+                        to = { modelKey: toModel.modelKey, model: toModel.model, slice, element: reactions[0] };
+                    }
+                    else {
+                        seamRaise("seam-consumer-not-reaction", reactions.length === 0
+                            ? `slice "${slice.name}" has no reaction element — \`to\` must name (or contain exactly one) translation/automation element`
+                            : `slice "${slice.name}" has ${reactions.length} reaction elements (${reactions.map((r) => r.ref).join(", ")}) — name one explicitly`, [qualify(toModel.modelKey, slice.key)]);
+                    }
+                }
+            }
+        }
+        const fromQualified = from ? qualify(from.modelKey, from.element.ref) : seam.from;
+        const toQualified = to ? qualify(to.modelKey, to.element.ref) : seam.to;
+        // Duplicate: same resolved (from, to) pair declared twice (a bare-slice `to` and its
+        // element-level spelling are the same seam). Warned on the second occurrence.
+        const pairKey = `${fromQualified} -> ${toQualified}`;
+        if (seenPairs.has(pairKey)) {
+            seamRaise("seam-duplicate", "already declared earlier in the manifest");
+        }
+        seenPairs.add(pairKey);
+        // A half-resolved seam still claims the endpoint it did resolve, so a typo on one side
+        // doesn't ALSO report the other side as dangling/unbound on top of the resolution error.
+        if (from)
+            consumedSurface.add(fromQualified);
+        if (to)
+            boundReactions.add(toQualified);
+        if (from && to) {
+            if (!declaredPairs.has(fromQualified))
+                declaredPairs.set(fromQualified, new Set());
+            declaredPairs.get(fromQualified).add(toQualified);
+        }
+        if (fromModel && toModel) {
+            const k = `${fromModel.modelKey} ${toModel.modelKey}`;
+            seamsByModelPair.set(k, (seamsByModelPair.get(k) ?? 0) + 1);
+        }
+        const hasError = codes.some((c) => SEAM_ERROR_CODES.has(c));
+        return {
+            from: fromQualified,
+            to: toQualified,
+            fromSlice: from ? qualify(from.modelKey, from.slice.key) : null,
+            toSlice: to ? qualify(to.modelKey, to.slice.key) : null,
+            description: seam.description,
+            status: hasError ? "error" : "verified",
+            diagnostics: codes,
+        };
+    });
+    // ---- Per-model surface + the two "other end missing" checks, manifest order. ----
+    const modelReports = models.map((m) => {
+        const publicSurface = [];
+        for (const slice of m.doc.model.slices) {
+            for (const el of slice.elements) {
+                if (!isSurface(el))
+                    continue;
+                publicSurface.push(el.ref);
+                const q = qualify(m.key, el.ref);
+                if (!consumedSurface.has(q)) {
+                    raise(m.file, "dangling-public-event", {
+                        message: `public ${el.kind} "${el.name}" (${q}) is consumed by no declared seam — declare its reader, or drop \`public\``,
+                        line: el.line,
+                        refs: [q],
+                    });
+                }
+            }
+        }
+        return { key: m.key, name: m.doc.model.name, source: m.source, sourceKind: m.sourceKind, owner: m.owner, publicSurface };
+    });
+    // "Externally fed" is computed from the export's own edge list, never re-derived: a reaction
+    // with no incoming edge in `model.edges` (no `from` view feeds it — pattern, `from`, or arrow)
+    // is fed from outside its model by construction. With no seam claiming it, nobody in the
+    // system says what feeds it.
+    for (const m of models) {
+        const fedInside = new Set(m.doc.model.edges.map((e) => e.to));
+        for (const slice of m.doc.model.slices) {
+            for (const el of slice.elements) {
+                if (!isReaction(el) || fedInside.has(el.ref))
+                    continue;
+                const q = qualify(m.key, el.ref);
+                if (boundReactions.has(q))
+                    continue;
+                raise(m.file, "unbound-translation", {
+                    message: `${el.kind} "${el.name}" (${q}) has no in-model source and no seam feeds it — declare the seam whose \`to\` is this reaction, or add a \`from\``,
+                    line: el.line,
+                    refs: [q],
+                });
+            }
+        }
+    }
+    // The old portal heuristic, demoted: a public element in model A sharing its normalized
+    // name with a reaction or event in model B (B != A), with no seam between them.
+    for (const a of models) {
+        for (const aSlice of a.doc.model.slices) {
+            for (const el of aSlice.elements) {
+                if (!isSurface(el))
+                    continue;
+                const aq = qualify(a.key, el.ref);
+                const wanted = normalizeName(el.name);
+                for (const b of models) {
+                    if (b === a)
+                        continue;
+                    for (const bSlice of b.doc.model.slices) {
+                        for (const other of bSlice.elements) {
+                            const matchKind = isReaction(other) ? "reaction" : other.kind === "event" ? "event" : undefined;
+                            if (!matchKind || normalizeName(other.name) !== wanted)
+                                continue;
+                            const bq = qualify(b.key, other.ref);
+                            const declared = declaredPairs.get(aq);
+                            const connected = matchKind === "reaction"
+                                ? declared?.has(bq) === true
+                                : [...(declared ?? [])].some((t) => t.startsWith(`${b.key}:`));
+                            if (connected)
+                                continue;
+                            raise(a.file, "undeclared-seam-candidate", {
+                                message: `public ${el.kind} "${el.name}" (${aq}) and ${other.kind} "${other.name}" (${bq}) look connected by name, ` +
+                                    "but no seam declares it — declare the seam or rename",
+                                line: el.line,
+                                refs: [aq, bq],
+                            });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    const contextMap = {
+        nodes: modelReports.map((m) => ({ key: m.key, name: m.name, owner: m.owner })),
+        edges: [...seamsByModelPair.entries()]
+            .map(([k, count]) => {
+            const [from, to] = k.split(" ");
+            return { from, to, seams: count };
+        })
+            .sort((x, y) => x.from.localeCompare(y.from) || x.to.localeCompare(y.to)),
+    };
+    return { name: manifest.name, models: modelReports, seams, contextMap, diagnostics };
+}
+//# sourceMappingURL=verify.js.map

package/dist/system/verify.js.map

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

package/dist/util/slug.js

@@ -5,21 +5,27 @@
 //    filenames (matches the skill's existing "kebab-case the slice name"
 //    convention). These are distinct namespaces — do not conflate them.
 export function slug(name) {
-    const s = name
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "_")
-        .replace(/^_+|_+$/g, "");
+    const s = trimChar(name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_"), "_");
     return s || "n";
 }
 export function kebabSlug(name) {
-    const s = name
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "");
+    const s = trimChar(name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-"), "-");
     return s || "n";
 }
+/** Strip leading/trailing runs of `ch` — a linear scan rather than `/^-+|-+$/`, which CodeQL
+ *  flags as polynomial (js/polynomial-redos) now that MIL-193's `@milehimikey/em/refs` subpath
+ *  export makes `kebabSlug()` reachable from library input. (The preceding collapse leaves at
+ *  most one separator per run, so it was never slow in practice; the scan is simply provably
+ *  linear.) */
+function trimChar(s, ch) {
+    let start = 0;
+    let end = s.length;
+    while (start < end && s[start] === ch)
+        start++;
+    while (end > start && s[end - 1] === ch)
+        end--;
+    return s.slice(start, end);
+}
 /** Append a numeric suffix (`${sep}2`, `${sep}3`, ...) until `id` isn't in `used`. Adds the result to `used`. */
 export function dedupe(id, used, sep) {
     let candidate = id;

package/dist/util/slug.js.map

@@ -1 +1 @@
-{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/util/slug.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,qEAAqE;AACrE,wEAAwE;AACxE,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;AAExE,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,MAAM,CAAC,GAAG,IAAI;SACX,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,GAAG,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,CAAC,GAAG,IAAI;SACX,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,GAAG,CAAC;AAClB,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,MAAM,CAAC,EAAU,EAAE,IAAiB,EAAE,GAAW;IAC/D,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,SAAS,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC;IAC5D,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpB,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/util/slug.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,qEAAqE;AACrE,wEAAwE;AACxE,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;AAExE,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/E,OAAO,CAAC,IAAI,GAAG,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/E,OAAO,CAAC,IAAI,GAAG,CAAC;AAClB,CAAC;AAED;;;;eAIe;AACf,SAAS,QAAQ,CAAC,CAAS,EAAE,EAAU;IACrC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,OAAO,KAAK,GAAG,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,CAAC;IAC/C,OAAO,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,CAAC;IAC/C,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,MAAM,CAAC,EAAU,EAAE,IAAiB,EAAE,GAAW;IAC/D,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,SAAS,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC;IAC5D,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milehimikey/em",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "AI-friendly Event Modeling — a slice-first text DSL rendered to a strict, self-contained Graphviz grid (SVG/PNG)",
   "type": "module",
   "bin": {
@@ -8,6 +8,14 @@
     "em-mcp": "./dist/mcp/main.js"
   },
   "main": "./dist/cli.js",
+  "exports": {
+    ".": "./dist/cli.js",
+    "./refs": {
+      "types": "./dist/model/qualifiedRef.d.ts",
+      "default": "./dist/model/qualifiedRef.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "dist",
     "README.md",
@@ -63,6 +71,7 @@
     "marked": "^18.0.0",
     "pdfkit": "^0.19.1",
     "svg-to-pdfkit": "^0.1.8",
+    "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {