@milehimikey/em 0.2.0 → 1.0.0

package/dist/migrate/migrate.js

@@ -0,0 +1,276 @@
+// SPDX-License-Identifier: MIT
+// `em migrate` — one-time upgrade from the pre-1.0 fixed-template format to
+// the frontmatter standard (docs/1.0.0-spec.md §7). planMigration() is pure;
+// applyMigration() is the only thing that writes, so --dry-run is just
+// "compute the plan, don't call apply."
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+import { normalize } from "../model/model.js";
+import { parse } from "../parser/parser.js";
+import { buildDocIdByElementId, deriveGeneratedFields } from "../model/deriveSliceFields.js";
+import { frontmatterFromData, parseFrontmatter, stringifyFrontmatter } from "../model/frontmatter.js";
+import { loadSliceDocs } from "../model/sliceDoc.js";
+import { CURRENT_SCHEMA_VERSION } from "../model/validateSliceDocs.js";
+import { findModelFile } from "../util/findModel.js";
+import { dedupe, kebabSlug } from "../util/slug.js";
+const PATTERN_FROM_PROSE = {
+    "state change": "state-change",
+    "state view": "state-view",
+    automation: "automation",
+    translation: "translation",
+};
+const STATUS_FROM_PROSE = {
+    draft: "draft",
+    reviewed: "reviewed",
+    "ready-to-implement": "ready-to-implement",
+};
+export function planMigration(dir, opts = {}) {
+    const modelPath = findModelFile(dir, opts.modelPath);
+    const model = normalize(parse(readFileSync(modelPath, "utf8")));
+    const docs = loadSliceDocs(dir);
+    const notes = [];
+    const usedIds = new Set();
+    for (const doc of docs) {
+        if (typeof doc.frontmatter?.id === "string")
+            usedIds.add(doc.frontmatter.id);
+    }
+    const drafts = [];
+    for (const doc of docs) {
+        if (typeof doc.frontmatter?.schemaVersion === "number")
+            continue; // already migrated
+        const heading = doc.raw.match(/^#\s*Slice:\s*(.+)$/m);
+        const title = heading ? heading[1].trim() : doc.file.replace(/\.md$/, "");
+        const linkedElement = model.elements.find((el) => el.note && resolve(dirname(modelPath), el.note) === resolve(doc.path));
+        let pattern;
+        let sliceElementId;
+        if (linkedElement) {
+            sliceElementId = linkedElement.id;
+            pattern = patternFromElementKind(linkedElement.kind);
+        }
+        else {
+            const proseMatch = doc.raw.match(/\*\*Pattern:\*\*\s*([A-Za-z ]+)/);
+            const key = proseMatch?.[1].trim().toLowerCase();
+            const resolved = key ? PATTERN_FROM_PROSE[key] : undefined;
+            pattern = resolved ?? "state-change";
+            notes.push({
+                file: doc.path,
+                message: resolved
+                    ? "no .em element links to this doc (orphan); pattern inferred from prose only — please wire a `note` and re-sync"
+                    : "no .em element links to this doc and its pattern couldn't be inferred from prose; defaulted to state-change — please review",
+            });
+        }
+        const statusMatch = doc.raw.match(/\*\*Status:\*\*\s*([A-Za-z- ]+)/);
+        const statusKey = statusMatch?.[1].trim().toLowerCase();
+        const resolvedStatus = statusKey ? STATUS_FROM_PROSE[statusKey] : undefined;
+        const status = resolvedStatus ?? "draft";
+        if (!resolvedStatus) {
+            notes.push({
+                file: doc.path,
+                message: "status couldn't be confidently inferred from prose; defaulted to draft",
+            });
+        }
+        const id = dedupe(kebabSlug(title), usedIds, "-");
+        const upstreamMatch = doc.raw.match(/\*\*Upstream events this slice relies on:\*\*\s*(.+)/);
+        const upstreamEvents = upstreamMatch
+            ? upstreamMatch[1]
+                .split(",")
+                .map((s) => s.trim().replace(/^["']|["']$/g, ""))
+                .filter((s) => s.length > 0 && !/^\{\{.*\}\}$/.test(s))
+            : [];
+        if (upstreamMatch && upstreamEvents.length === 0) {
+            notes.push({ file: doc.path, message: "upstream events line found but unparseable; left empty" });
+        }
+        drafts.push({ doc, id, title, pattern, status, sliceElementId, upstreamEvents });
+    }
+    // Cross-doc id index (already-migrated docs + newly planned drafts) so
+    // triggers/triggeredBy resolve even between two docs migrated in the same run.
+    const docIdByElementId = buildDocIdByElementId(model, docs);
+    for (const d of drafts) {
+        if (d.sliceElementId)
+            docIdByElementId.set(d.sliceElementId, d.id);
+    }
+    const docPlans = docs.map((doc) => {
+        const draft = drafts.find((d) => d.doc === doc);
+        if (!draft)
+            return { path: doc.path, file: doc.file, alreadyMigrated: true };
+        const today = new Date().toISOString().slice(0, 10);
+        const data = {
+            schemaVersion: CURRENT_SCHEMA_VERSION,
+            id: draft.id,
+            title: draft.title,
+            pattern: draft.pattern,
+            status: draft.status,
+            version: 1,
+            model: relative(dirname(doc.path), modelPath),
+            created: today,
+            updated: today,
+        };
+        if (draft.sliceElementId) {
+            data.sliceElement = draft.sliceElementId;
+            const derived = deriveGeneratedFields(model, draft.sliceElementId, docIdByElementId);
+            if (derived) {
+                data.commands = derived.commands;
+                data.events = derived.events;
+                data.readModels = derived.readModels;
+                data.contexts = derived.contexts;
+                data.personas = derived.personas;
+                if (derived.triggers)
+                    data.triggers = derived.triggers;
+                if (derived.triggeredBy)
+                    data.triggeredBy = derived.triggeredBy;
+            }
+        }
+        if (draft.upstreamEvents.length > 0)
+            data.upstreamEvents = draft.upstreamEvents;
+        const content = stringifyFrontmatter(frontmatterFromData(data), stripLegacyBullets(doc.body));
+        return { path: doc.path, file: doc.file, alreadyMigrated: false, content };
+    });
+    // Every slice's final (id, pattern, status, version) — migrated-this-run or already-migrated —
+    // used to regenerate the state file's Slice inventory table below.
+    const summaries = docs.map((doc) => {
+        const draft = drafts.find((d) => d.doc === doc);
+        if (draft)
+            return { title: draft.title, id: draft.id, pattern: draft.pattern, status: draft.status, version: 1 };
+        // Already-migrated doc: its frontmatter is whatever's on disk, which may be
+        // malformed. Fall back rather than rendering `undefined` into the table —
+        // `em validate` is what reports the malformed field.
+        const fm = doc.frontmatter;
+        return {
+            title: typeof fm.title === "string" ? fm.title : String(fm.id),
+            id: String(fm.id),
+            pattern: typeof fm.pattern === "string" ? fm.pattern : "state-change",
+            status: typeof fm.status === "string" ? fm.status : "draft",
+            version: typeof fm.version === "number" ? fm.version : 1,
+        };
+    });
+    const stateFile = planStateFile(dir, modelPath, summaries, notes);
+    return { dir, modelPath, docs: docPlans, stateFile, notes };
+}
+function planStateFile(dir, modelPath, summaries, notes) {
+    const stateFilePath = join(dir, ".event-modeling.md");
+    if (!existsSync(stateFilePath))
+        return undefined;
+    const raw = readFileSync(stateFilePath, "utf8");
+    const { data, body } = parseFrontmatter(raw);
+    if (data && typeof data.schemaVersion === "number") {
+        return { path: stateFilePath, file: ".event-modeling.md", alreadyMigrated: true };
+    }
+    const fmData = { schemaVersion: CURRENT_SCHEMA_VERSION, model: relative(dir, modelPath) };
+    const { content: newBody, matchedAny, unmatchedRows } = regenerateSliceInventory(body, summaries);
+    if (summaries.length > 0 && !matchedAny) {
+        notes.push({
+            file: stateFilePath,
+            message: "Slice inventory table couldn't be matched to any migrated doc by name; review manually",
+        });
+    }
+    else if (unmatchedRows > 0) {
+        notes.push({
+            file: stateFilePath,
+            message: `${unmatchedRows} Slice inventory row(s) couldn't be matched to a migrated doc by name; review manually`,
+        });
+    }
+    const content = stringifyFrontmatter(frontmatterFromData(fmData), newBody);
+    return { path: stateFilePath, file: ".event-modeling.md", alreadyMigrated: false, content };
+}
+/**
+ * Rewrite the "| Slice | Pattern | Doc status |" table to "| Slice | Id | Pattern | Doc status |",
+ * matching each row to a migrated slice by title (or by kebab-slugging the row's slice name) and
+ * filling in id/pattern/status/version. Rows that can't be matched (e.g. a still-unfilled
+ * `{{Slice Name}}` template row) are left untouched — never guessed.
+ */
+function regenerateSliceInventory(content, summaries) {
+    const lines = content.split("\n");
+    const headerIdx = lines.findIndex((l) => /^\|\s*Slice\s*\|/i.test(l.trim()));
+    const separatorOk = headerIdx !== -1 && /^\|[\s\-:|]+\|$/.test((lines[headerIdx + 1] ?? "").trim());
+    if (!separatorOk)
+        return { content, matchedAny: false, unmatchedRows: 0 };
+    const byTitle = new Map(summaries.map((s) => [s.title.toLowerCase(), s]));
+    const bySlug = new Map(summaries.map((s) => [kebabSlug(s.title), s]));
+    let rowEnd = headerIdx + 2;
+    while (rowEnd < lines.length && lines[rowEnd].trim().startsWith("|"))
+        rowEnd++;
+    let matchedAny = false;
+    let unmatchedRows = 0;
+    const newRows = [];
+    for (let i = headerIdx + 2; i < rowEnd; i++) {
+        const cells = lines[i].split("|").slice(1, -1).map((c) => c.trim());
+        const sliceName = cells[0] ?? "";
+        const summary = byTitle.get(sliceName.toLowerCase()) ?? bySlug.get(kebabSlug(sliceName));
+        if (summary) {
+            matchedAny = true;
+            newRows.push(`| ${summary.title} | ${summary.id} | ${summary.pattern} | ${summary.status} (v${summary.version}) |`);
+        }
+        else {
+            unmatchedRows++;
+            newRows.push(lines[i]);
+        }
+    }
+    if (!matchedAny)
+        return { content, matchedAny: false, unmatchedRows };
+    const rewritten = [
+        ...lines.slice(0, headerIdx),
+        "| Slice | Id | Pattern | Doc status |",
+        "|-------|-----|---------|------------|",
+        ...newRows,
+        ...lines.slice(rowEnd),
+    ];
+    return { content: rewritten.join("\n"), matchedAny: true, unmatchedRows };
+}
+function patternFromElementKind(kind) {
+    if (kind === "command")
+        return "state-change";
+    if (kind === "translation")
+        return "translation";
+    if (kind === "processor" || kind === "automation" || kind === "saga")
+        return "automation";
+    return "state-view";
+}
+function stripLegacyBullets(body) {
+    return body
+        .split("\n")
+        .filter((line) => !/^-\s*\*\*(Pattern|Status):\*\*/.test(line.trim()))
+        .join("\n");
+}
+export function applyMigration(plan) {
+    for (const doc of plan.docs) {
+        if (!doc.alreadyMigrated && doc.content !== undefined)
+            writeFileSync(doc.path, doc.content);
+    }
+    if (plan.stateFile && !plan.stateFile.alreadyMigrated && plan.stateFile.content !== undefined) {
+        writeFileSync(plan.stateFile.path, plan.stateFile.content);
+    }
+}
+export function formatMigrationReport(plan) {
+    const changed = plan.docs.filter((d) => !d.alreadyMigrated);
+    const skipped = plan.docs.filter((d) => d.alreadyMigrated);
+    const lines = [`# em migrate report — ${plan.dir}`, "", `Model: ${plan.modelPath}`, ""];
+    lines.push(`## Migrated (${changed.length})`);
+    lines.push(...(changed.length ? changed.map((d) => `- ${d.file}`) : ["(none)"]));
+    lines.push("", `## Already migrated, skipped (${skipped.length})`);
+    lines.push(...(skipped.length ? skipped.map((d) => `- ${d.file}`) : ["(none)"]));
+    if (plan.stateFile) {
+        lines.push("", `## State file: ${plan.stateFile.alreadyMigrated ? "already migrated, skipped" : "migrated"}`);
+    }
+    lines.push("", `## Flagged for review (${plan.notes.length})`);
+    lines.push(...(plan.notes.length ? plan.notes.map((n) => `- ${n.file}: ${n.message}`) : ["(none)"]));
+    return lines.join("\n") + "\n";
+}
+/** Throws unless `dir` is a clean git working tree (or `force` is set). Git is the undo mechanism. */
+export function assertCleanWorkingTree(dir, force) {
+    if (force)
+        return;
+    let output;
+    try {
+        output = execFileSync("git", ["-C", dir, "status", "--porcelain", "."], { encoding: "utf8" });
+    }
+    catch {
+        throw new Error(`${dir} doesn't look like it's inside a git repository — em migrate rewrites files in ` +
+            `place and relies on git as the undo mechanism; pass --force to proceed anyway`);
+    }
+    if (output.trim().length > 0) {
+        throw new Error(`${dir} has uncommitted changes — commit or stash them first (git is em migrate's undo ` +
+            `mechanism), or pass --force to proceed anyway`);
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate/migrate.js.map

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

package/dist/model/deriveSliceFields.d.ts

@@ -0,0 +1,21 @@
+import { NormalizedModel } from "./model.js";
+import { SliceDoc } from "./sliceDoc.js";
+export interface DerivedSliceFields {
+    commands: string[];
+    events: string[];
+    readModels: string[];
+    contexts: string[];
+    personas: string[];
+    triggers?: string;
+    triggeredBy?: string;
+}
+/**
+ * Derive the generated fields for the slice that `sliceElementId` belongs to.
+ * `docIdByElementId` maps every *other* slice doc's linked element id to that
+ * doc's frontmatter `id`, so `triggers`/`triggeredBy` (the automation/translation
+ * two-slice split) can be resolved without a second .em pass per doc. Returns
+ * null if `sliceElementId` doesn't resolve to a real element.
+ */
+export declare function deriveGeneratedFields(model: NormalizedModel, sliceElementId: string, docIdByElementId: ReadonlyMap<string, string>): DerivedSliceFields | null;
+/** Map every doc's linked .em element id -> that doc's frontmatter `id`, skipping unusable docs. */
+export declare function buildDocIdByElementId(model: NormalizedModel, docs: readonly SliceDoc[]): Map<string, string>;

package/dist/model/deriveSliceFields.js

@@ -0,0 +1,60 @@
+// SPDX-License-Identifier: MIT
+// Computes the "generated" slice-doc frontmatter fields (docs/1.0.0-spec.md §2.2)
+// from the .em model. Shared by validateSliceDocs.ts (drift detection) and the
+// future `em slice sync` (Phase C) so there's exactly one definition of
+// "what these fields should be" — never duplicated between check and write.
+import { AUTOMATION_KINDS } from "../parser/ast.js";
+/**
+ * Derive the generated fields for the slice that `sliceElementId` belongs to.
+ * `docIdByElementId` maps every *other* slice doc's linked element id to that
+ * doc's frontmatter `id`, so `triggers`/`triggeredBy` (the automation/translation
+ * two-slice split) can be resolved without a second .em pass per doc. Returns
+ * null if `sliceElementId` doesn't resolve to a real element.
+ */
+export function deriveGeneratedFields(model, sliceElementId, docIdByElementId) {
+    const element = model.byId.get(sliceElementId);
+    if (!element)
+        return null;
+    const slice = model.slices[element.sliceIndex];
+    const commands = slice.elements.filter((e) => e.kind === "command").map((e) => e.name);
+    const events = slice.elements.filter((e) => e.kind === "event").map((e) => e.name);
+    const readModels = slice.elements.filter((e) => e.kind === "view").map((e) => e.name);
+    const contexts = dedupe(slice.elements.filter((e) => e.kind === "event" && e.context).map((e) => e.context));
+    const personas = dedupe(slice.elements.filter((e) => e.kind === "ui" && e.persona).map((e) => e.persona));
+    const fields = { commands, events, readModels, contexts, personas };
+    const isReaction = slice.elements.some((e) => AUTOMATION_KINDS.has(e.kind));
+    if (isReaction) {
+        const nextSlice = model.slices[slice.index + 1];
+        const triggeredCommand = nextSlice?.elements.find((e) => e.kind === "command");
+        const triggeredDocId = triggeredCommand && docIdByElementId.get(triggeredCommand.id);
+        if (triggeredDocId)
+            fields.triggers = triggeredDocId;
+    }
+    else if (commands.length > 0) {
+        const prevSlice = model.slices[slice.index - 1];
+        const reaction = prevSlice?.elements.find((e) => AUTOMATION_KINDS.has(e.kind));
+        const triggeringDocId = reaction && docIdByElementId.get(reaction.id);
+        if (triggeringDocId)
+            fields.triggeredBy = triggeringDocId;
+    }
+    return fields;
+}
+function dedupe(values) {
+    return Array.from(new Set(values));
+}
+/** Map every doc's linked .em element id -> that doc's frontmatter `id`, skipping unusable docs. */
+export function buildDocIdByElementId(model, docs) {
+    const index = new Map();
+    for (const doc of docs) {
+        const data = doc.frontmatter;
+        if (!data)
+            continue;
+        const id = data.id;
+        const sliceElement = data.sliceElement;
+        if (typeof id === "string" && typeof sliceElement === "string" && model.byId.has(sliceElement)) {
+            index.set(sliceElement, id);
+        }
+    }
+    return index;
+}
+//# sourceMappingURL=deriveSliceFields.js.map

package/dist/model/deriveSliceFields.js.map

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

package/dist/model/frontmatter.d.ts

@@ -0,0 +1,21 @@
+import { Document } from "yaml";
+export interface ParsedFrontmatter {
+    /** Parsed YAML data, or null if the file has no frontmatter block. */
+    data: Record<string, unknown> | null;
+    /** The YAML Document, kept around so writes can preserve comments/formatting. Null if no block. */
+    document: Document | null;
+    /** Everything after the closing `---`. Equal to the whole input when there's no frontmatter block. */
+    body: string;
+}
+/** Parse a slice doc's leading frontmatter block, if it has one. */
+export declare function parseFrontmatter(raw: string): ParsedFrontmatter;
+/** Reassemble a `---\n...\n---\n<body>` string from a Document and body text. */
+export declare function stringifyFrontmatter(document: Document, body: string): string;
+/** Build a fresh Document from a plain object (used when creating a new slice doc). */
+export declare function frontmatterFromData(data: Record<string, unknown>): Document;
+/**
+ * Shallow-merge `patch` into `document` in place, preserving every other key
+ * (including ones `em` doesn't know about) and existing comments. Returns the
+ * same Document instance for convenience.
+ */
+export declare function mergeFrontmatter(document: Document, patch: Record<string, unknown>): Document;

package/dist/model/frontmatter.js

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: MIT
+// Split/parse/stringify a `---\n...\n---\n` YAML frontmatter block. Backed by
+// the `yaml` package's Document API so incremental writes (slice sync/update,
+// migrate) preserve comments and fields the CLI doesn't know about — external
+// tools may own fields in this same block (see docs/1.0.0-spec.md §8).
+import { Document, parseDocument } from "yaml";
+const DELIMITER = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+/** Parse a slice doc's leading frontmatter block, if it has one. */
+export function parseFrontmatter(raw) {
+    const match = raw.match(DELIMITER);
+    if (!match)
+        return { data: null, document: null, body: raw };
+    const [, yamlText, body] = match;
+    const document = parseDocument(yamlText);
+    const data = (document.toJS() ?? {});
+    return { data, document, body };
+}
+/** Reassemble a `---\n...\n---\n<body>` string from a Document and body text. */
+export function stringifyFrontmatter(document, body) {
+    const yamlText = document.toString().replace(/\n+$/, "");
+    return `---\n${yamlText}\n---\n${body}`;
+}
+/** Build a fresh Document from a plain object (used when creating a new slice doc). */
+export function frontmatterFromData(data) {
+    return new Document(data);
+}
+/**
+ * Shallow-merge `patch` into `document` in place, preserving every other key
+ * (including ones `em` doesn't know about) and existing comments. Returns the
+ * same Document instance for convenience.
+ */
+export function mergeFrontmatter(document, patch) {
+    for (const [key, value] of Object.entries(patch)) {
+        document.set(key, value);
+    }
+    return document;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/model/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/model/frontmatter.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,uEAAuE;AAEvE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE/C,MAAM,SAAS,GAAG,6CAA6C,CAAC;AAWhE,oEAAoE;AACpE,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAE7D,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IACjC,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAA4B,CAAC;IAChE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,oBAAoB,CAAC,QAAkB,EAAE,IAAY;IACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzD,OAAO,QAAQ,QAAQ,UAAU,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,IAA6B;IAC/D,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB,EAAE,KAA8B;IACjF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/model/model.js

@@ -2,19 +2,12 @@
 // Normalizes a parsed AST into a resolved model: stable ids, resolved
 // persona/context lanes, and lookup indexes used by layout and validation.
 import { AUTOMATION_KINDS } from "../parser/ast.js";
+import { dedupe, slug } from "../util/slug.js";
 export const DEFAULT_PERSONA = "User";
 export const DEFAULT_CONTEXT = "Domain";
 export function normalizeName(name) {
     return name.trim().toLowerCase().replace(/\s+/g, " ");
 }
-function slug(name) {
-    const s = name
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "_")
-        .replace(/^_+|_+$/g, "");
-    return s || "n";
-}
 export function normalize(ast) {
     const personas = [...ast.personas];
     const contexts = [...ast.contexts];
@@ -24,15 +17,7 @@ export function normalize(ast) {
     const byName = new Map();
     const usedIds = new Set();
     let hasAutomation = false;
-    const makeId = (name) => {
-        const base = slug(name);
-        let id = base;
-        let n = 2;
-        while (usedIds.has(id))
-            id = `${base}_${n++}`;
-        usedIds.add(id);
-        return id;
-    };
+    const makeId = (name) => dedupe(slug(name), usedIds, "_");
     ast.slices.forEach((sliceNode, sliceIndex) => {
         const slice = {
             name: sliceNode.name,

package/dist/model/model.js.map

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

package/dist/model/sliceDoc.d.ts

@@ -0,0 +1,56 @@
+import { Document } from "yaml";
+export type SlicePattern = "state-change" | "state-view" | "automation" | "translation";
+export type SliceStatus = "draft" | "reviewed" | "ready-to-implement" | "in-progress" | "implemented" | "deprecated" | "superseded";
+/**
+ * The frontmatter schema from docs/1.0.0-spec.md §2. This is the *expected*
+ * shape for a valid doc — loadSliceDocs() does not enforce it (a doc on disk
+ * may be missing fields, mistyped, or have no frontmatter at all; that's what
+ * validateSliceDocs() reports). Unknown/external fields always round-trip
+ * through SliceDoc.document even though they aren't listed here.
+ */
+export interface SliceFrontmatter {
+    schemaVersion: number;
+    id: string;
+    title: string;
+    pattern: SlicePattern;
+    status: SliceStatus;
+    version: number;
+    model: string;
+    sliceElement: string;
+    commands?: string[];
+    events?: string[];
+    readModels?: string[];
+    contexts?: string[];
+    personas?: string[];
+    triggers?: string;
+    triggeredBy?: string;
+    swimlane?: {
+        persona?: string;
+        context?: string;
+    };
+    upstreamEvents?: string[];
+    relatedSlices?: string[];
+    tags?: string[];
+    owner?: string;
+    created?: string;
+    updated?: string;
+    contentHash?: string;
+    supersededBy?: string;
+    implementedRef?: string;
+}
+export interface SliceDoc {
+    /** Absolute path to the doc. */
+    path: string;
+    /** Filename without directory, e.g. "place-order.md". */
+    file: string;
+    /** Parsed frontmatter, or null if the doc has no `---` block at all. Not validated. */
+    frontmatter: Record<string, unknown> | null;
+    /** The YAML Document backing `frontmatter`, for round-trip-safe writes. Null alongside frontmatter. */
+    document: Document | null;
+    /** Everything after the closing `---` (or the whole file, if there's no frontmatter block). */
+    body: string;
+    /** Full file contents, as read from disk. */
+    raw: string;
+}
+/** Load every `slices/*.md` doc in a model directory. Returns [] if `slices/` doesn't exist. */
+export declare function loadSliceDocs(modelDir: string): SliceDoc[];

package/dist/model/sliceDoc.js

@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: MIT
+// Loads slice design docs (slices/*.md) and their frontmatter. Parsing only —
+// no validation here (see validateSliceDocs.ts) and no writing (see
+// src/slice/*.ts). Kept separate so "what's on disk" stays cheap and pure.
+import { readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseFrontmatter } from "./frontmatter.js";
+/** Load every `slices/*.md` doc in a model directory. Returns [] if `slices/` doesn't exist. */
+export function loadSliceDocs(modelDir) {
+    const slicesDir = join(modelDir, "slices");
+    let entries;
+    try {
+        entries = readdirSync(slicesDir);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((f) => f.endsWith(".md"))
+        .sort()
+        .map((file) => {
+        const path = join(slicesDir, file);
+        const raw = readFileSync(path, "utf8");
+        const { data, document, body } = parseFrontmatter(raw);
+        return { path, file, frontmatter: data, document, body, raw };
+    });
+}
+//# sourceMappingURL=sliceDoc.js.map

package/dist/model/sliceDoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sliceDoc.js","sourceRoot":"","sources":["../../src/model/sliceDoc.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,8EAA8E;AAC9E,oEAAoE;AACpE,2EAA2E;AAE3E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAmEpD,gGAAgG;AAChG,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3C,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAChC,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAChE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/model/validate.d.ts

@@ -5,6 +5,8 @@ export interface Diagnostic {
     severity: Severity;
     message: string;
     line?: number;
+    /** Slice-doc path, for diagnostics that point at a Markdown doc rather than a .em line. */
+    file?: string;
 }
 export declare function validate(model: NormalizedModel, grid: Grid): Diagnostic[];
 export declare function hasErrors(diags: Diagnostic[]): boolean;

package/dist/model/validate.js

@@ -120,7 +120,7 @@ export function hasErrors(diags) {
 }
 /** Pretty one-line diagnostic for terminal output. */
 export function formatDiagnostic(d) {
-    const where = d.line ? `:${d.line}` : "";
+    const where = d.file ? ` ${d.file}` : d.line ? `:${d.line}` : "";
     const tag = d.severity === "error" ? "error" : "warn ";
     return `  ${tag}${where} ${d.message}`;
 }