@milehimikey/em 1.13.0 → 1.14.0

package/dist/catalog/sliceReadyValidate.js

@@ -27,14 +27,37 @@
 import { makeDiag, pushDiag } from "../model/rules.js";
 import { resolveSliceDocJoin } from "./docJoin.js";
 import { readSliceDoc } from "./readSliceDoc.js";
+import { findStructuredSectionProblems } from "./sliceSections.js";
+import { contractStatus, slicePublicTouching } from "./apiFirst.js";
+/** MIL-238 (briefing R10): the API-first gate's diagnostic for one slice, or null when the slice
+ *  touches no public element or its model's contract is current. Independent of the slice doc —
+ *  the contract belongs to the model — so it is appended on every path past the unknown-key check. */
+function contractStaleDiagnostic(model, refs, sliceIndex, sliceKey, contract) {
+    const slice = model.slices[sliceIndex];
+    if (!slicePublicTouching(slice))
+        return null;
+    const { state, contractPath } = contractStatus(model, refs, contract);
+    if (state === "current")
+        return null;
+    return makeDiag("slice-ready-contract-stale", {
+        message: `slice "${sliceKey}" touches the public surface but the contract ${contractPath} is ${state} — ` +
+            `run: em api generate ${contract.file}`,
+        line: slice.line,
+        refs: [sliceKey],
+    });
+}
 /**
  * Readiness gate for one slice, named by its export key (`refs.sliceKeys`). `baseDir` is the
  * `.em` file's directory, same convention every other doc/note path in em uses. Always warning-
  * severity (fits validate's existing warning-producer shape) except for a bad `sliceKey` itself,
  * which is an error — a CLI-argument mistake, not a model-quality finding. The `--slice-ready`
  * flag in src/cli.ts is what decides whether these warnings gate the exit code.
+ *
+ * MIL-238: `contract` (the `.em` path as given, its source and compile diagnostics) feeds the
+ * API-first gate — a public-touching slice whose model contract is missing or stale gets a
+ * `slice-ready-contract-stale` error on every path past the unknown-key check.
  */
-export function validateSliceReady(model, refs, baseDir, sliceKey) {
+export function validateSliceReady(model, refs, baseDir, sliceKey, contract) {
     const sliceIndex = refs.sliceKeys.indexOf(sliceKey);
     if (sliceIndex === -1) {
         return [
@@ -45,20 +68,22 @@ export function validateSliceReady(model, refs, baseDir, sliceKey) {
         ];
     }
     const slice = model.slices[sliceIndex];
+    const contractDiag = contractStaleDiagnostic(model, refs, sliceIndex, sliceKey, contract);
+    const withContract = (diags) => (contractDiag ? [...diags, contractDiag] : diags);
     const { doc, diagnostics: joinDiagnostics } = resolveSliceDocJoin(model, refs, slice, sliceKey, baseDir, (id) => refs.refById.get(id));
     if (doc.reason === "no-doc-bound") {
-        return [
+        return withContract([
             makeDiag("slice-ready-no-doc-bound", {
                 message: `slice "${sliceKey}" has no doc bound via \`note "slices/${sliceKey}.md"\` — bind a slice doc before it can be ready-to-implement`,
                 line: slice.line,
                 refs: [sliceKey],
             }),
-        ];
+        ]);
     }
     if (doc.reason === "binding-missing-file" || doc.reason === "frontmatter-invalid") {
         // Reuse docJoin's own diagnostics verbatim — don't re-code binding-missing-file/
         // frontmatter-invalid a second time under a slice-ready-specific code.
-        return joinDiagnostics;
+        return withContract(joinDiagnostics);
     }
     // doc.reason === null: found, usable frontmatter.
     const diags = [];
@@ -69,6 +94,18 @@ export function validateSliceReady(model, refs, baseDir, sliceKey) {
             refs: [sliceKey],
         });
     }
+    // MIL-259: a ready-to-implement doc must carry a recorded sign-off. `em slice reratify`
+    // clears `ratifiedBy` and bumps `version`, leaving `status: ready-to-implement` in place until
+    // someone re-signs — without this check that unsigned state read as ready. Only checked when
+    // the status IS ready-to-implement: any other status already blocks via the diagnostic above,
+    // and a second "not ratified" finding there would just be noise.
+    if (doc.status === "ready-to-implement" && !doc.ratifiedBy) {
+        pushDiag(diags, "slice-ready-not-ratified", {
+            message: `slice "${sliceKey}" is ready-to-implement but carries no ratifiedBy — record the sign-off with \`em slice ratify --by <name>\``,
+            line: slice.line,
+            refs: [sliceKey],
+        });
+    }
     // resolveSliceDocJoin's SliceDocExport deliberately never carries Open Questions counts (same
     // hard boundary that keeps doc.html/doc.raw out of it) — re-read via readSliceDoc for the
     // full SliceDoc. Non-null: doc.reason === null already implies the file exists and parses.
@@ -85,18 +122,31 @@ export function validateSliceReady(model, refs, baseDir, sliceKey) {
             refs: [sliceKey],
         });
     }
-    return diags;
+    // MIL-266: the `--slice-ready` twin of `slice-doc/structured-section-malformed` — a generated
+    // region whose markers don't balance or whose table header drifted from the template, or a
+    // `### Scenario:` block missing Given/When/Then, is not a spec an implementer can read
+    // mechanically. Diagnostic-only blocker: `gates` gains no boolean (the scoped diagnostics are
+    // what drive `ready`). Silent on a doc with no markers and no `### Scenario:` heading.
+    for (const problem of findStructuredSectionProblems(parsed.body)) {
+        pushDiag(diags, "slice-ready-structured-section-malformed", {
+            message: `slice "${sliceKey}"'s doc ${doc.path}: ${problem}`,
+            line: slice.line,
+            refs: [sliceKey],
+        });
+    }
+    return withContract(diags);
 }
-export function computeSliceReadyGates(model, refs, baseDir, sliceKey) {
+export function computeSliceReadyGates(model, refs, baseDir, sliceKey, contract) {
     const sliceIndex = refs.sliceKeys.indexOf(sliceKey);
     if (sliceIndex === -1)
         return null;
     const slice = model.slices[sliceIndex];
+    const contractCurrent = !slicePublicTouching(slice) || contractStatus(model, refs, contract).state === "current";
     const { doc, continuationOf } = resolveSliceDocJoin(model, refs, slice, sliceKey, baseDir, (id) => refs.refById.get(id));
     const docBound = doc.reason !== "no-doc-bound";
     const frontmatterUsable = doc.reason === null;
     if (!frontmatterUsable) {
-        return { gates: { docBound, frontmatterUsable, statusReady: false, noUncheckedOpenQuestions: false }, continuationOf };
+        return { gates: { docBound, frontmatterUsable, statusReady: false, noUncheckedOpenQuestions: false, ratified: false, contractCurrent }, continuationOf };
     }
     const statusReady = doc.status === "ready-to-implement";
     // Same re-derivation of the bound key from doc.path as validateSliceReady above — see its
@@ -104,6 +154,14 @@ export function computeSliceReadyGates(model, refs, baseDir, sliceKey) {
     const boundKey = doc.path.replace(/^slices\//, "").replace(/\.md$/, "");
     const parsed = readSliceDoc(baseDir, boundKey);
     const noUncheckedOpenQuestions = parsed.openQuestionsUnchecked === 0;
-    return { gates: { docBound, frontmatterUsable, statusReady, noUncheckedOpenQuestions }, continuationOf };
+    const ratified = !!doc.ratifiedBy;
+    return { gates: { docBound, frontmatterUsable, statusReady, noUncheckedOpenQuestions, ratified, contractCurrent }, continuationOf };
+}
+export function computeSliceReadiness(model, refs, baseDir, sliceKey, contract, allDiagnostics) {
+    const readyDiagnostics = validateSliceReady(model, refs, baseDir, sliceKey, contract);
+    const combined = [...allDiagnostics, ...readyDiagnostics];
+    const scoped = combined.filter((d) => d.refs?.some((r) => r === sliceKey || r.startsWith(`${sliceKey}/`)));
+    const result = computeSliceReadyGates(model, refs, baseDir, sliceKey, contract);
+    return { scoped, ready: scoped.length === 0, result };
 }
 //# sourceMappingURL=sliceReadyValidate.js.map

package/dist/catalog/sliceReadyValidate.js.map

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

package/dist/catalog/sliceSections.d.ts

@@ -0,0 +1,55 @@
+import { NormalizedModel } from "../model/model.js";
+export declare const SLICE_REGION_PREFIX = "em-slice-";
+export type RegionKind = "command" | "event" | "view" | "invariants";
+/** The template's table header for each element kind's generated field table — the exact
+ *  header `slice-doc/structured-section-malformed` compares a region's table against. */
+export declare const REGION_TABLE_HEADERS: Record<"command" | "event" | "view", readonly string[]>;
+/** Trailing prose on every region's start marker line — preserved verbatim by `em slice sync`. */
+export declare const REGION_START_NOTE = "generated from the model by `em slice sync`; do not hand-edit";
+/** The comment `em slice new` and the template put right after the Invariants region. */
+export declare const INVARIANTS_ELABORATE_COMMENT = "<!-- elaborate below this list; IDs are declared in the model -->";
+export interface GeneratedRegion {
+    name: string;
+    kind: RegionKind;
+    /** Body lines, without the marker lines and without EOLs. */
+    body: string[];
+}
+export declare function regionStartLine(name: string): string;
+export declare function regionEndLine(name: string): string;
+/** The region kind a region name belongs to, or null for a name outside the vocabulary. */
+export declare function regionKindOf(name: string): RegionKind | null;
+/**
+ * The generated regions a doc bound to `sliceIndices` (one slice, or the union a MIL-121
+ * cross-covered doc / a MIL-208 continuation resolves to) should carry, in template order:
+ * commands, events, views, invariants. Elements are taken in slice order then declaration
+ * order; a repeated view (`again`) contributes only its first instance, and two elements of one
+ * kind with the same slug only the first.
+ */
+export declare function buildSliceRegions(model: NormalizedModel, sliceIndices: number[]): GeneratedRegion[];
+/** The template's placeholder regions — what `em slice new` writes when it has no model to fill
+ *  them from (no `--wire`). `em slice sync` fills them once the doc is bound. */
+export declare function placeholderRegions(): GeneratedRegion[];
+export interface RegionSpan {
+    name: string;
+    /** Offset of the first byte AFTER the start marker line's text (its EOL starts here). */
+    innerStart: number;
+    /** Offset of the first byte of the end marker line. */
+    innerEnd: number;
+    /** The text between the two marker lines, without the EOL that ends the start line and the
+     *  EOL before the end line — the region's body. */
+    body: string;
+}
+export interface RegionScan {
+    regions: RegionSpan[];
+    /** Balance problems; when non-empty, `regions` must not be rewritten. */
+    problems: string[];
+}
+/** Find every `em-slice-*` region in `text` (a whole doc or its body), checking that markers are
+ *  balanced: every start has its end, no region opens inside another, and no name repeats. */
+export declare function scanSliceRegions(text: string): RegionScan;
+/**
+ * Every structural problem in a slice doc's generated regions and authored scenarios — the facts
+ * behind `slice-doc/structured-section-malformed` and its `--slice-ready` twin. Empty for a doc
+ * with no `em-slice-*` markers and no `### Scenario:` blocks (every 1.13-style doc).
+ */
+export declare function findStructuredSectionProblems(body: string): string[];

package/dist/catalog/sliceSections.js

@@ -0,0 +1,317 @@
+// SPDX-License-Identifier: MIT
+// Generated regions of a slice doc (MIL-266): the parts of `slices/<key>.md` that restate the
+// model — each command's field table, each event's payload table, each read model's field table,
+// and the slice's model-declared invariants — become marker-delimited regions whose bodies `em`
+// writes from the `.em` and keeps in step (`em slice new` fills them, `em slice sync` refreshes
+// them in place). Every other section stays authored and is never touched.
+//
+//   <!-- GENERATED:em-slice-command:start — … -->
+//   **Command:** `Submit Order`
+//
+//   | Field | Type | Required | Rules / Validation |
+//   …
+//   <!-- GENERATED:em-slice-command:end -->
+//
+// Region names: `em-slice-command`, `em-slice-event`, `em-slice-view`, `em-slice-invariants`.
+// When a slice (or the union of slices a doc is bound to) has several elements of one kind, each
+// gets its own region, suffixed with the element's kebab slug (`em-slice-event-order-placed`).
+// A kind with no element still gets its one un-suffixed region, holding a one-line "none" note,
+// so adding the first element to the model later is a plain `em slice sync`.
+//
+// The `**Command:**` / `**Event:**` / `- **View:**` marker lines sit INSIDE the regions, so
+// catalog/docModelConsistencyValidate.ts keeps reading them exactly as before.
+//
+// Pure: model in, region bodies (as line arrays, EOL-free) out; doc text in, regions/problems
+// out. The CLI (`em slice new`, cli/sliceSync.ts) owns every read and write.
+import { normalizeName } from "../model/model.js";
+import { kebabSlug } from "../util/slug.js";
+import { parseScenarios } from "./scenarios.js";
+export const SLICE_REGION_PREFIX = "em-slice-";
+/** The template's table header for each element kind's generated field table — the exact
+ *  header `slice-doc/structured-section-malformed` compares a region's table against. */
+export const REGION_TABLE_HEADERS = {
+    command: ["Field", "Type", "Required", "Rules / Validation"],
+    event: ["Field", "Type", "Immutable Fact?", "Source / Notes"],
+    view: ["Field", "Type", "Source / Notes"],
+};
+/** Trailing prose on every region's start marker line — preserved verbatim by `em slice sync`. */
+export const REGION_START_NOTE = "generated from the model by `em slice sync`; do not hand-edit";
+/** The comment `em slice new` and the template put right after the Invariants region. */
+export const INVARIANTS_ELABORATE_COMMENT = "<!-- elaborate below this list; IDs are declared in the model -->";
+export function regionStartLine(name) {
+    return `<!-- GENERATED:${name}:start — ${REGION_START_NOTE} -->`;
+}
+export function regionEndLine(name) {
+    return `<!-- GENERATED:${name}:end -->`;
+}
+/** The region kind a region name belongs to, or null for a name outside the vocabulary. */
+export function regionKindOf(name) {
+    const m = /^em-slice-(command|event|view|invariants)(?:-[a-z0-9]+(?:-[a-z0-9]+)*)?$/.exec(name);
+    if (!m)
+        return null;
+    if (m[1] === "invariants" && name !== "em-slice-invariants")
+        return null;
+    return m[1];
+}
+function cell(text) {
+    return text.replace(/\|/g, "\\|");
+}
+function tableHeader(kind) {
+    const cols = REGION_TABLE_HEADERS[kind];
+    return [`| ${cols.join(" | ")} |`, `|${cols.map((c) => "-".repeat(c.length + 2)).join("|")}|`];
+}
+const NO_FIELDS = "_No fields declared in the model._";
+function commandBody(_model, el) {
+    const out = [`**Command:** \`${el.name}\``, ""];
+    if (!el.fields || el.fields.length === 0)
+        return [...out, NO_FIELDS];
+    out.push(...tableHeader("command"));
+    for (const f of el.fields) {
+        const notes = [];
+        if (f.renamedFrom && f.renamedFrom.length > 0)
+            notes.push(`renamed from ${f.renamedFrom.map((n) => `"${n}"`).join(", ")}`);
+        out.push(`| ${cell(f.name)} | ${cell(f.type ?? "—")} | ${f.optional === true ? "no" : "yes"} | ${cell(notes.join("; ") || "—")} |`);
+    }
+    return out;
+}
+function eventBody(model, el) {
+    const head = el.context ? `**Event:** \`${el.name}\` → context \`${el.context}\`` : `**Event:** \`${el.name}\``;
+    const out = [head, ""];
+    if (!el.fields || el.fields.length === 0)
+        return [...out, NO_FIELDS];
+    out.push(...tableHeader("event"));
+    const commands = model.slices[el.sliceIndex].elements.filter((e) => e.kind === "command");
+    for (const f of el.fields) {
+        const notes = [];
+        if (f.assigned === true) {
+            notes.push("assigned (set by the handler)");
+        }
+        else {
+            const src = commands.find((c) => (c.fields ?? []).some((cf) => normalizeName(cf.name) === normalizeName(f.name)));
+            notes.push(src ? `from command \`${src.name}\`` : "{{ }}");
+        }
+        if (f.tag === true)
+            notes.push("identity tag");
+        if (f.optional === true)
+            notes.push("optional");
+        if (f.renamedFrom && f.renamedFrom.length > 0)
+            notes.push(`renamed from ${f.renamedFrom.map((n) => `"${n}"`).join(", ")}`);
+        out.push(`| ${cell(f.name)} | ${cell(f.type ?? "—")} | yes | ${cell(notes.join("; "))} |`);
+    }
+    return out;
+}
+function viewBody(model, el) {
+    const sources = el.from ?? [];
+    const built = sources.length > 0 ? sources.map((s) => `"${s}"`).join(", ") : "—";
+    const out = [`- **View:** \`${el.name}\` built from events: ${built}`, ""];
+    if (!el.fields || el.fields.length === 0)
+        return [...out, NO_FIELDS];
+    out.push(...tableHeader("view"));
+    const sourceEvents = [];
+    for (const s of sources) {
+        const ev = (model.byName.get(normalizeName(s)) ?? []).find((e) => e.kind === "event");
+        if (ev)
+            sourceEvents.push(ev);
+    }
+    for (const f of el.fields) {
+        let note;
+        if (f.derived === true) {
+            note = f.derivedFrom && f.derivedFrom.length > 0 ? `Derived from ${f.derivedFrom.map((n) => `"${n}"`).join(", ")}` : "Derived";
+        }
+        else {
+            const src = sourceEvents.find((ev) => (ev.fields ?? []).some((ef) => normalizeName(ef.name) === normalizeName(f.name)));
+            note = src ? `from event \`${src.name}\`` : "{{ }}";
+        }
+        out.push(`| ${cell(f.name)} | ${cell(f.type ?? "—")} | ${cell(note)} |`);
+    }
+    return out;
+}
+function noneBody(kind) {
+    const word = kind === "view" ? "read model" : kind;
+    return [`_This slice has no ${word} in the model._`];
+}
+/**
+ * The generated regions a doc bound to `sliceIndices` (one slice, or the union a MIL-121
+ * cross-covered doc / a MIL-208 continuation resolves to) should carry, in template order:
+ * commands, events, views, invariants. Elements are taken in slice order then declaration
+ * order; a repeated view (`again`) contributes only its first instance, and two elements of one
+ * kind with the same slug only the first.
+ */
+export function buildSliceRegions(model, sliceIndices) {
+    const ordered = [...sliceIndices].sort((a, b) => a - b);
+    const elements = [];
+    for (const i of ordered)
+        elements.push(...model.slices[i].elements);
+    const regions = [];
+    for (const kind of ["command", "event", "view"]) {
+        const seenLogical = new Set();
+        const seenSlug = new Set();
+        const els = [];
+        for (const el of elements) {
+            if (el.kind !== kind)
+                continue;
+            if (seenLogical.has(el.logicalId))
+                continue;
+            seenLogical.add(el.logicalId);
+            const s = kebabSlug(el.name);
+            if (seenSlug.has(s))
+                continue;
+            seenSlug.add(s);
+            els.push(el);
+        }
+        const build = kind === "command" ? commandBody : kind === "event" ? eventBody : viewBody;
+        if (els.length === 0) {
+            regions.push({ name: `${SLICE_REGION_PREFIX}${kind}`, kind, body: noneBody(kind) });
+        }
+        else if (els.length === 1) {
+            regions.push({ name: `${SLICE_REGION_PREFIX}${kind}`, kind, body: build(model, els[0]) });
+        }
+        else {
+            for (const el of els)
+                regions.push({ name: `${SLICE_REGION_PREFIX}${kind}-${kebabSlug(el.name)}`, kind, body: build(model, el) });
+        }
+    }
+    const invLines = [];
+    for (const el of elements) {
+        if (el.kind !== "command" && el.kind !== "event")
+            continue;
+        for (const inv of el.invariants ?? []) {
+            // `**INV-X**` + an em-dash — deliberately NOT the `**INV-X:**` declaring label
+            // (invariants/declared-in-both): the model declares the ID, this list only restates it.
+            invLines.push(inv.rule ? `- **${inv.id}** — ${inv.rule}` : `- **${inv.id}**`);
+        }
+    }
+    regions.push({
+        name: `${SLICE_REGION_PREFIX}invariants`,
+        kind: "invariants",
+        body: invLines.length > 0 ? invLines : ["_No invariants declared in the model._"],
+    });
+    return regions;
+}
+/** The template's placeholder regions — what `em slice new` writes when it has no model to fill
+ *  them from (no `--wire`). `em slice sync` fills them once the doc is bound. */
+export function placeholderRegions() {
+    return [
+        {
+            name: "em-slice-command",
+            kind: "command",
+            body: [
+                "**Command:** `{{Command Name}}`",
+                "",
+                ...tableHeader("command"),
+                "| {{field}} | {{Type}} | {{yes/no}} | {{constraints, formats, ranges}} |",
+            ],
+        },
+        {
+            name: "em-slice-event",
+            kind: "event",
+            body: [
+                "**Event:** `{{Event Name}}` → context `{{Context}}`",
+                "",
+                ...tableHeader("event"),
+                "| {{field}} | {{Type}} | {{yes/no}} | {{where the value comes from}} |",
+            ],
+        },
+        {
+            name: "em-slice-view",
+            kind: "view",
+            body: [
+                '- **View:** `{{View Name}}` built from events: {{"Event A", "Event B"}}',
+                "",
+                ...tableHeader("view"),
+                "| {{field}} | {{Type}} | {{which event field it's copied from, or `Derived: <rule>`}} |",
+            ],
+        },
+        {
+            name: "em-slice-invariants",
+            kind: "invariants",
+            body: ['- **INV-{{MNEMONIC}}-1** — {{rule, as declared by `invariant INV-{{MNEMONIC}}-1 "rule"` in the model}}'],
+        },
+    ];
+}
+const MARKER_LINE_RE = /^<!-- GENERATED:(em-slice-[A-Za-z0-9-]+):(start|end)\b[^\r\n]*$/gm;
+/** Find every `em-slice-*` region in `text` (a whole doc or its body), checking that markers are
+ *  balanced: every start has its end, no region opens inside another, and no name repeats. */
+export function scanSliceRegions(text) {
+    const regions = [];
+    const problems = [];
+    const seen = new Set();
+    let open = null;
+    for (const m of text.matchAll(MARKER_LINE_RE)) {
+        const name = m[1];
+        const which = m[2];
+        const lineStart = m.index;
+        if (which === "start") {
+            if (open) {
+                problems.push(`region "${name}" starts inside region "${open.name}" (no end marker for "${open.name}" before it)`);
+                open = null;
+            }
+            if (seen.has(name))
+                problems.push(`region "${name}" appears more than once`);
+            seen.add(name);
+            if (regionKindOf(name) === null)
+                problems.push(`region "${name}" is not a known generated region (em-slice-command|event|view[-<slug>], em-slice-invariants)`);
+            open = { name, innerStart: lineStart + m[0].length };
+        }
+        else {
+            if (!open) {
+                problems.push(`end marker for region "${name}" has no start marker`);
+                continue;
+            }
+            if (open.name !== name) {
+                problems.push(`region "${open.name}" is closed by the end marker of "${name}"`);
+                open = null;
+                continue;
+            }
+            const raw = text.slice(open.innerStart, lineStart);
+            const body = raw.replace(/^\r?\n/, "").replace(/\r?\n$/, "");
+            regions.push({ name, innerStart: open.innerStart, innerEnd: lineStart, body });
+            open = null;
+        }
+    }
+    if (open)
+        problems.push(`region "${open.name}" has no end marker`);
+    return { regions, problems };
+}
+function splitCells(line) {
+    return line.trim().replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => c.trim());
+}
+/** A field-table region's header problem, or null when its first table's header matches the
+ *  template's (or the region holds no table at all — an element with no fields). */
+function tableHeaderProblem(region) {
+    const kind = regionKindOf(region.name);
+    if (kind === null || kind === "invariants")
+        return null;
+    const lines = region.body.split(/\r?\n/);
+    for (let i = 0; i < lines.length - 1; i++) {
+        if (!/^\s*\|/.test(lines[i]) || !/^\s*\|/.test(lines[i + 1]))
+            continue;
+        if (!splitCells(lines[i + 1]).every((c) => /^:?-+:?$/.test(c)))
+            continue;
+        const got = splitCells(lines[i]);
+        const want = REGION_TABLE_HEADERS[kind];
+        if (got.length === want.length && got.every((c, j) => c === want[j]))
+            return null;
+        return `region "${region.name}"'s table header is "| ${got.join(" | ")} |" — expected "| ${want.join(" | ")} |"`;
+    }
+    return null;
+}
+/**
+ * Every structural problem in a slice doc's generated regions and authored scenarios — the facts
+ * behind `slice-doc/structured-section-malformed` and its `--slice-ready` twin. Empty for a doc
+ * with no `em-slice-*` markers and no `### Scenario:` blocks (every 1.13-style doc).
+ */
+export function findStructuredSectionProblems(body) {
+    const scan = scanSliceRegions(body);
+    const problems = [...scan.problems];
+    if (scan.problems.length === 0) {
+        for (const region of scan.regions) {
+            const p = tableHeaderProblem(region);
+            if (p)
+                problems.push(p);
+        }
+    }
+    problems.push(...parseScenarios(body).problems);
+    return problems;
+}
+//# sourceMappingURL=sliceSections.js.map

package/dist/catalog/sliceSections.js.map

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

package/dist/cli/agentsMd.js

@@ -46,7 +46,13 @@ agent — Claude Code or otherwise — should follow this contract:
 - **MCP alternative**: \`em-mcp\` starts a stateless stdio MCP server exposing the contract,
   gate, and read path above (plus full validate/export) as tools instead of shell commands —
   every tool mirrors a CLI \`--json\` surface byte-for-byte. Handshake and full tool list:
-  [docs/mcp.md](https://github.com/milehimikey/em/blob/main/docs/mcp.md).`;
+  [docs/mcp.md](https://github.com/milehimikey/em/blob/main/docs/mcp.md).
+- **Skills (Claude Code)**: the em plugin provides \`/em:event-modeling\` (router),
+  \`/em:discover\`, \`/em:design\`, \`/em:implement\`, \`/em:conform\`, and \`/em:review\`. It is pinned
+  in \`.claude/settings.json\`; register it once per machine with
+  \`claude plugin marketplace add milehimikey/em@v<version> --scope project\` then
+  \`claude plugin install em@em-<version-with-dashes> --scope project\` (\`<version>\` is the em
+  release pinned in \`.claude/settings.json\`, e.g. \`1.14.0\` and \`em-1-14-0\`).`;
 function markerBlock() {
     return `<!-- GENERATED:${AGENTS_MD_MARKER}:start -->\n${SECTION_BODY}\n<!-- GENERATED:${AGENTS_MD_MARKER}:end -->`;
 }

package/dist/cli/agentsMd.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentsMd.js","sourceRoot":"","sources":["../../src/cli/agentsMd.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,yFAAyF;AACzF,2FAA2F;AAC3F,gGAAgG;AAChG,uFAAuF;AACvF,+FAA+F;AAC/F,4FAA4F;AAC5F,+FAA+F;AAC/F,kGAAkG;AAClG,gGAAgG;AAChG,4FAA4F;AAC5F,iGAAiG;AACjG,EAAE;AACF,2FAA2F;AAC3F,gGAAgG;AAChG,6FAA6F;AAC7F,8FAA8F;AAC9F,+FAA+F;AAC/F,4FAA4F;AAC5F,8FAA8F;AAC9F,6FAA6F;AAC7F,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;+CAC+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEjD,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;0EAoBqD,CAAC;AAE3E,SAAS,WAAW;IAClB,OAAO,kBAAkB,gBAAgB,eAAe,YAAY,oBAAoB,gBAAgB,UAAU,CAAC;AACrH,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAEtE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,KAAK,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACxE,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED,uFAAuF;IACvF,0FAA0F;IAC1F,yFAAyF;IACzF,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3F,aAAa,CAAC,IAAI,EAAE,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACzE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"agentsMd.js","sourceRoot":"","sources":["../../src/cli/agentsMd.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,yFAAyF;AACzF,2FAA2F;AAC3F,gGAAgG;AAChG,uFAAuF;AACvF,+FAA+F;AAC/F,4FAA4F;AAC5F,+FAA+F;AAC/F,kGAAkG;AAClG,gGAAgG;AAChG,4FAA4F;AAC5F,iGAAiG;AACjG,EAAE;AACF,2FAA2F;AAC3F,gGAAgG;AAChG,6FAA6F;AAC7F,8FAA8F;AAC9F,+FAA+F;AAC/F,4FAA4F;AAC5F,8FAA8F;AAC9F,6FAA6F;AAC7F,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;+CAC+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEjD,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;mFA0B8D,CAAC;AAEpF,SAAS,WAAW;IAClB,OAAO,kBAAkB,gBAAgB,eAAe,YAAY,oBAAoB,gBAAgB,UAAU,CAAC;AACrH,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAEtE,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,IAAI,OAAO,KAAK,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACxE,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC/C,CAAC;IAED,uFAAuF;IACvF,0FAA0F;IAC1F,yFAAyF;IACzF,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3F,aAAa,CAAC,IAAI,EAAE,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACzE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC"}