@milehimikey/em 1.17.0 → 1.18.0

package/dist/roster/roster.js

@@ -0,0 +1,298 @@
+// SPDX-License-Identifier: MIT
+// The optional ratifier roster (GH #259): `ratifiers.yaml` beside the model — a host-supplied list
+// of who may sign slice docs. File absent = em behaves exactly as before (any non-empty name);
+// file present = `em slice ratify --by` / `em slice review --by` refuse a name the roster does not
+// permit for the slice's context(s), and `em validate --slice-ready` reports a hand-edited
+// `ratifiedBy` that is not on it (`ratified-by-not-in-roster`).
+//
+// Placement follows `system.yaml`: the nearest `ratifiers.yaml` walking up from the model's
+// directory to the repo root, so one roster can serve several models; an explicit path overrides.
+// Pure parsing (`parseRoster`) is separate from filesystem discovery (`loadRoster`).
+import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { dirname, join, normalize, resolve, sep } from "node:path";
+import { LineCounter, parseDocument, isMap, isSeq, isScalar } from "yaml";
+import { normalizeName } from "../model/model.js";
+import { computeModelKey } from "../model/qualifiedRef.js";
+import { pushDiag } from "../model/rules.js";
+export const ROSTER_FILE = "ratifiers.yaml";
+export const ROSTER_SCHEMA_VERSION = "1.0";
+/** em's own migration marker (`em upgrade`'s `ratified-signoff`), not a signer: exempt from roster checks. */
+export const GRANDFATHERED_RATIFIER = "grandfathered (unsigned before em 1.14)";
+/** Exempt only the exact marker AND only on a doc with no `ratifiedHash` (the state `em upgrade`
+ *  leaves it in): a forged "grandfathered by X" or a marker on a hash-bearing doc is a signer and is checked. */
+export function isGrandfatheredSignoff(name, ratifiedHash) {
+    return !!name && name === GRANDFATHERED_RATIFIER && !ratifiedHash;
+}
+const TOP_KEYS = new Set(["rosterSchemaVersion", "ratifiers", "reviewers"]);
+const ENTRY_KEYS = new Set(["name", "contexts", "models"]);
+function scalarString(node) {
+    return isScalar(node) && typeof node.value === "string" ? node.value : undefined;
+}
+export function normalizeContext(c) {
+    return c.trim().replace(/^@/, "");
+}
+/** Parse and shape-check roster text. Every problem is a `roster-invalid` error (never a throw);
+ *  `ok: false` means the roster cannot be used, and callers refuse rather than fall back to open. */
+export function parseRoster(text) {
+    const diagnostics = [];
+    const lc = new LineCounter();
+    const doc = parseDocument(text, { lineCounter: lc, prettyErrors: false });
+    const lineOf = (n) => {
+        const range = n && "range" in n ? n.range : n && "key" in n ? n.key?.range : undefined;
+        return range ? lc.linePos(range[0]).line : undefined;
+    };
+    const invalid = (message, line) => pushDiag(diagnostics, "roster-invalid", { message, line });
+    if (doc.errors.length > 0) {
+        for (const e of doc.errors)
+            invalid(`YAML parse error: ${e.message.trim()}`, e.linePos?.[0]?.line);
+        return { ok: false, diagnostics };
+    }
+    const root = doc.contents;
+    if (!isMap(root)) {
+        invalid("roster must be a YAML mapping with `rosterSchemaVersion` and `ratifiers` and/or `reviewers`");
+        return { ok: false, diagnostics };
+    }
+    const versionNode = root.get("rosterSchemaVersion", true);
+    const version = scalarString(versionNode);
+    if (version === undefined) {
+        invalid(`missing or non-string \`rosterSchemaVersion\` — set \`rosterSchemaVersion: "${ROSTER_SCHEMA_VERSION}"\``, lineOf(versionNode));
+    }
+    else if (version !== ROSTER_SCHEMA_VERSION) {
+        invalid(`unsupported rosterSchemaVersion "${version}" — this em accepts "${ROSTER_SCHEMA_VERSION}"`, lineOf(versionNode));
+    }
+    for (const pair of root.items) {
+        const key = scalarString(pair.key);
+        if (key === undefined || !TOP_KEYS.has(key)) {
+            invalid(`unknown top-level key ${JSON.stringify(key ?? "?")} — expected one of: ${[...TOP_KEYS].join(", ")}`, lineOf(pair));
+        }
+    }
+    const readList = (key) => {
+        const node = root.get(key, true);
+        if (node === undefined)
+            return null;
+        if (!isSeq(node) || node.items.length === 0) {
+            invalid(`\`${key}\` must be a non-empty list of { name, contexts? } entries (omit the key to leave it unrestricted)`, lineOf(node));
+            return null;
+        }
+        const out = [];
+        for (const item of node.items) {
+            if (!isMap(item)) {
+                invalid(`\`${key}\` entries must be mappings with a \`name\` (and optional \`contexts\`)`, lineOf(item));
+                continue;
+            }
+            for (const p of item.items) {
+                const k = scalarString(p.key);
+                if (k === undefined || !ENTRY_KEYS.has(k))
+                    invalid(`${key}: unknown key ${JSON.stringify(k ?? "?")} — expected name, contexts, models`, lineOf(p));
+            }
+            const name = scalarString(item.get("name", true));
+            if (name === undefined || name.trim() === "") {
+                invalid(`${key}: every entry needs a non-empty string \`name\``, lineOf(item));
+                continue;
+            }
+            const ctxNode = item.get("contexts", true);
+            let contexts = null;
+            if (ctxNode !== undefined) {
+                const names = isSeq(ctxNode) ? ctxNode.items.map((i) => scalarString(i)) : [];
+                if (!isSeq(ctxNode) || names.length === 0 || names.some((n) => n === undefined || n.trim() === "")) {
+                    invalid(`${key}: "${name}": \`contexts\` must be a non-empty list of context names (omit it for the whole model)`, lineOf(ctxNode));
+                    continue;
+                }
+                contexts = names.map(normalizeContext);
+            }
+            const modelsNode = item.get("models", true);
+            let models = null;
+            if (modelsNode !== undefined) {
+                const keys = isSeq(modelsNode) ? modelsNode.items.map((i) => scalarString(i)) : [];
+                if (!isSeq(modelsNode) || keys.length === 0 || keys.some((n) => n === undefined || n.trim() === "")) {
+                    invalid(`${key}: "${name}": \`models\` must be a non-empty list of model keys (omit it to apply to every model)`, lineOf(modelsNode));
+                    continue;
+                }
+                models = keys.map((k) => k.trim());
+            }
+            out.push({ name: name.trim(), contexts, models });
+        }
+        return out;
+    };
+    const ratifiers = readList("ratifiers");
+    const reviewers = readList("reviewers");
+    if (root.get("ratifiers", true) === undefined && root.get("reviewers", true) === undefined) {
+        invalid("a roster needs `ratifiers:` and/or `reviewers:`");
+    }
+    if (diagnostics.length > 0)
+        return { ok: false, diagnostics };
+    return { ok: true, roster: { rosterSchemaVersion: version, ratifiers, reviewers } };
+}
+/** The nearest `ratifiers.yaml` walking up from `startDir`, stopping at the nearest directory that
+ *  holds `.git` (a directory or a file) or at the filesystem root. When no `.git` exists anywhere
+ *  above, only `startDir` itself is searched -- without a repo root there is no principled place
+ *  to stop, and a roster in some unrelated parent must not govern the model. */
+export function findRosterAbove(startDir) {
+    let hasGit = false;
+    for (let d = safeReal(resolve(startDir));;) {
+        if (existsSync(join(d, ".git"))) {
+            hasGit = true;
+            break;
+        }
+        const p = dirname(d);
+        if (p === d)
+            break;
+        d = p;
+    }
+    let dir = startDir;
+    let abs = safeReal(resolve(dir));
+    for (;;) {
+        const candidate = join(dir, ROSTER_FILE);
+        if (existsSync(candidate))
+            return normalize(candidate).split(sep).join("/");
+        if (!hasGit || existsSync(join(abs, ".git")))
+            return null;
+        const parent = dirname(abs);
+        if (parent === abs)
+            return null;
+        abs = parent;
+        dir = join(dir, "..");
+    }
+}
+function safeReal(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
+/** Discover (or take an explicit `override` path) and parse the roster for a model in `baseDir`.
+ *  An explicit path that does not exist is `invalid` — asking for a roster and not finding it must
+ *  not silently mean "no roster". */
+export function loadRoster(baseDir, override, modelCtx) {
+    let path;
+    if (override !== undefined) {
+        path = override;
+        if (!existsSync(path)) {
+            const diagnostics = [];
+            pushDiag(diagnostics, "roster-invalid", { message: `roster file ${path} does not exist` });
+            return { state: "invalid", path, diagnostics };
+        }
+    }
+    else {
+        path = findRosterAbove(baseDir);
+        if (path === null)
+            return { state: "absent" };
+    }
+    const parsed = parseRoster(readFileSync(path, "utf8"));
+    if (!parsed.ok)
+        return { state: "invalid", path, diagnostics: parsed.diagnostics };
+    if (modelCtx) {
+        const problems = validateRosterForModel(parsed.roster, modelCtx);
+        if (problems.length > 0)
+            return { state: "invalid", path, diagnostics: problems };
+    }
+    return { state: "present", path, roster: parsed.roster };
+}
+export function rosterModelContext(model, file, systemModelKeys) {
+    return { model, modelKey: computeModelKey(model, file), systemModelKeys };
+}
+/** `roster-invalid` for a `contexts:` entry the model does not declare (case-sensitive) -- checked
+ *  only for entries that apply to this model -- and for a `models:` key the enclosing system does
+ *  not have. */
+export function validateRosterForModel(roster, ctx) {
+    const diagnostics = [];
+    for (const role of ["ratifiers", "reviewers"]) {
+        for (const e of roster[role] ?? []) {
+            if (e.models && ctx.systemModelKeys) {
+                for (const k of e.models) {
+                    if (!ctx.systemModelKeys.includes(k)) {
+                        pushDiag(diagnostics, "roster-invalid", { message: `${role}: "${e.name}": \`models\` names "${k}", which is not a model of the system (${ctx.systemModelKeys.join(", ")})` });
+                    }
+                }
+            }
+            if (!appliesToModel(e, ctx.modelKey) || !e.contexts)
+                continue;
+            for (const c of e.contexts) {
+                if (!ctx.model.contexts.includes(c)) {
+                    pushDiag(diagnostics, "roster-invalid", {
+                        message: `${role}: "${e.name}": unknown context "${c}" for model "${ctx.modelKey}" (declared: ${ctx.model.contexts.join(", ")})`,
+                    });
+                }
+            }
+        }
+    }
+    return diagnostics;
+}
+function appliesToModel(e, modelKey) {
+    return e.models === null || modelKey === undefined || e.models.includes(modelKey);
+}
+/** The contexts of a slice: those of its events, plus those of the events ITS OWN views read (each
+ *  view instance's own `from`, not a union across the read model's instances - so adding a later
+ *  instance never changes an earlier slice's contexts). A continuation slice (only `again` views)
+ *  additionally takes the originating instance's own `from`. A slice with neither has none. */
+export function sliceContexts(model, sliceIndex) {
+    const out = [];
+    const add = (c) => {
+        if (c && !out.includes(c))
+            out.push(c);
+    };
+    const slice = model.slices[sliceIndex];
+    for (const el of slice?.elements ?? [])
+        if (el.kind === "event")
+            add(el.context);
+    const byName = new Map();
+    for (const s of model.slices) {
+        for (const el of s.elements) {
+            if (el.kind !== "event" || !el.context)
+                continue;
+            const k = normalizeName(el.name);
+            byName.set(k, [...(byName.get(k) ?? []), el.context]);
+        }
+    }
+    const addFrom = (from) => {
+        for (const f of from ?? [])
+            for (const c of byName.get(normalizeName(f)) ?? [])
+                add(c);
+    };
+    const elements = slice?.elements ?? [];
+    const nonUi = elements.filter((e) => e.kind !== "ui");
+    const isContinuation = nonUi.length > 0 && nonUi.every((e) => e.kind === "view" && e.again === true);
+    for (const el of elements) {
+        if (el.kind !== "view")
+            continue;
+        addFrom(el.from);
+        if (isContinuation)
+            addFrom(model.byId.get(el.logicalId)?.from);
+    }
+    return out;
+}
+/** An entry permits a slice when it applies to the model and either carries no `contexts` or lists
+ *  EVERY context of the slice. A slice with no context of its own is permitted only by entries
+ *  without `contexts`. */
+function permits(entry, contexts, modelKey) {
+    if (!appliesToModel(entry, modelKey))
+        return false;
+    if (entry.contexts === null)
+        return true;
+    return contexts.length > 0 && contexts.every((c) => entry.contexts.includes(normalizeContext(c)));
+}
+/** `null` = allowed (including: this role is unrestricted). Otherwise the refusal text. */
+export function rosterRefusal(roster, role, name, contexts, modelKey) {
+    const list = roster[role];
+    if (list === null)
+        return null;
+    const trimmed = name.trim();
+    if (list.some((e) => e.name === trimmed && permits(e, contexts, modelKey)))
+        return null;
+    const permitted = [...new Set(list.filter((e) => permits(e, contexts, modelKey)).map((e) => e.name))];
+    const where = contexts.length > 0 ? `context ${contexts.join(" + ")}` : "this slice";
+    const who = permitted.length > 0 ? `permitted: ${permitted.join(", ")}` : "nobody is permitted for it";
+    return `"${trimmed}" is not on the ${role} roster for ${where} (${who})`;
+}
+/** Resolve a roster check for a CLI/MCP write path: `null` = proceed, else the refusal message. */
+export function checkRosterForWrite(loaded, role, name, model, sliceIndex, modelKey) {
+    if (loaded.state === "absent")
+        return null;
+    if (loaded.state === "invalid")
+        return `roster ${loaded.path} is invalid — ${loaded.diagnostics.map((d) => d.message).join("; ")}`;
+    const msg = rosterRefusal(loaded.roster, role, name, sliceContexts(model, sliceIndex), modelKey);
+    return msg === null ? null : `${msg} — roster: ${loaded.path}`;
+}
+//# sourceMappingURL=roster.js.map

package/dist/roster/roster.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milehimikey/em",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "AI-friendly Event Modeling — a slice-first text DSL rendered to a strict, self-contained Graphviz grid (SVG/PNG)",
   "type": "module",
   "bin": {

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "em",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "description": "Event Modeling with em: discover, design, implement, conform, review and engagement skills over a slice-first text DSL, plus the em MCP server.",
   "author": {
     "name": "Mike Key"
@@ -10,7 +10,7 @@
       "command": "npx",
       "args": [
         "-y",
-        "@milehimikey/em@1.17.0",
+        "@milehimikey/em@1.18.0",
         "mcp"
       ]
     }