@milehimikey/em 1.8.1 → 1.9.1

package/dist/emit/typespec.js

@@ -0,0 +1,356 @@
+// SPDX-License-Identifier: MIT
+// POC (MIL-159): generates a TypeSpec (https://typespec.io) contract surface — plain `model`/
+// `interface`/`op` declarations, core scalars only, no imports — for a model's commands,
+// public events, and public views. EXPERIMENTAL: see docs/cli.md's `em typespec` section for
+// the scoping/type-mapping decisions this POC makes and what it deliberately leaves out.
+//
+// Reuses `buildExportDoc` (emit/json.ts) rather than re-deriving typeRef/tags/renamedFrom/
+// assigned/public from the raw model a second time — same discipline `em export` itself
+// follows: one resolution pass, one place field metadata is computed, every consumer reads
+// the resolved shape. Deterministic and dependency-free: no LLM, no new runtime dependency —
+// this emits TypeSpec *source text* directly rather than building an AST through
+// `@typespec/compiler` (see test/typespec.test.ts for the optional, skip-if-absent
+// compile-verification test that checks the text this module emits is actually valid
+// TypeSpec, using `@typespec/compiler` as a devDependency only).
+import { dedupe } from "../util/slug.js";
+import { buildExportDoc } from "./json.js";
+// 1.0 (MIL-159, POC): initial shape. Not part of the `em export` schema-versioning lineage —
+// this is source text, not JSON, and the POC's own mapping/scoping decisions (see below) are
+// expected to change if/when this graduates past POC, so it gets its own independent version.
+export const TYPESPEC_SCHEMA_VERSION = "1.0";
+// ---- Type mapping strategy ---------------------------------------------------------------
+//
+// em field types are free text with no semantic checking (docs/dsl.md, "Fields"). TypeSpec
+// needs real scalar/model references, so this POC picks one explicit, documented strategy
+// (per the ticket's "needs an explicit mapping strategy" — not assumed) rather than passing
+// text through unchanged:
+//
+//  1. A field whose type names a declared `type` block (`FieldExport.typeRef`, already
+//     resolved by `buildExportDoc` — bare or `[]`-suffixed) references that type's generated
+//     `model` by name. This is the clean, low-risk case the ticket calls out — em already does
+//     all the resolution work.
+//  2. Otherwise, the *bare* type name (after stripping a `[]` suffix or a `List<...>`/
+//     `Array<...>`/`Set<...>` generic wrapper) is looked up case-insensitively in
+//     SCALAR_TYPE_MAP below. A hit maps to that TypeSpec core scalar.
+//  3. A field with no declared type at all (`type` was never written) maps to `unknown` —
+//     not a mapping failure, just an honest "this field's shape isn't declared here."
+//  4. Anything else — a declared type string that's neither a known scalar nor a resolvable
+//     `type` reference (`Money`, a typo, a domain-specific string nobody's mapped) — also
+//     becomes `unknown`, but is recorded in `TypeSpecResult.unmappedTypes` so the gap is
+//     visible instead of silently swallowed. `List<X>` around an unresolved `X` (including a
+//     declared type referenced through the generic-wrapper spelling rather than `X[]` — see
+//     docs/dsl.md's Named types section on why only the bare/`[]` forms resolve) still maps to
+//     `unknown[]`, not `unknown`, so the arity survives even when the element type doesn't.
+//
+// This table is intentionally small and unopinionated (nothing domain-specific like `Money` ->
+// a currency shape) — go/no-go note: a promoted, non-POC version would likely want this
+// user-configurable (a mapping file) rather than hardcoded.
+export const SCALAR_TYPE_MAP = Object.freeze({
+    string: "string",
+    str: "string",
+    text: "string",
+    uuid: "string",
+    guid: "string",
+    int: "int32",
+    integer: "int32",
+    int32: "int32",
+    int64: "int64",
+    long: "int64",
+    short: "int16",
+    int16: "int16",
+    byte: "int8",
+    int8: "int8",
+    uint: "uint32",
+    boolean: "boolean",
+    bool: "boolean",
+    float: "float32",
+    float32: "float32",
+    double: "float64",
+    float64: "float64",
+    decimal: "decimal",
+    money: "decimal",
+    currency: "decimal",
+    instant: "utcDateTime",
+    datetime: "utcDateTime",
+    timestamp: "utcDateTime",
+    utcdatetime: "utcDateTime",
+    date: "plainDate",
+    time: "plainTime",
+    duration: "duration",
+    url: "url",
+    uri: "url",
+    bytes: "bytes",
+    binary: "bytes",
+    object: "unknown",
+    any: "unknown",
+    void: "void",
+});
+function mapRawType(raw) {
+    let s = raw.trim();
+    let array = false;
+    const generic = s.match(/^(?:List|Array|Set)<(.+)>$/i);
+    if (generic) {
+        array = true;
+        s = generic[1].trim();
+    }
+    else if (s.endsWith("[]")) {
+        array = true;
+        s = s.slice(0, -2).trim();
+    }
+    const scalar = SCALAR_TYPE_MAP[s.toLowerCase()];
+    if (scalar)
+        return { tsType: array ? `${scalar}[]` : scalar, mapped: true };
+    return { tsType: array ? "unknown[]" : "unknown", mapped: false };
+}
+// ---- Identifier shaping -----------------------------------------------------------------
+/** em element/type names are free text ("Place Order", "Order Placed"). TypeSpec model/
+ *  operation names need a bare identifier — PascalCase, matching TypeSpec's own convention
+ *  for `model`/`interface` names. */
+function pascalCase(name) {
+    const words = name.match(/[A-Za-z0-9]+/g) ?? [];
+    const joined = words.map((w) => w[0].toUpperCase() + w.slice(1)).join("");
+    if (joined.length === 0)
+        return "Unnamed";
+    return /^[0-9]/.test(joined) ? `_${joined}` : joined;
+}
+function camelCase(pascal) {
+    return pascal.length > 0 ? pascal[0].toLowerCase() + pascal.slice(1) : pascal;
+}
+/** A field name that isn't a bare TypeSpec identifier (spaces, leading digit, ...) is quoted
+ *  with backticks — the same escape TypeSpec itself uses for a non-identifier member name. em
+ *  field names are conventionally already valid identifiers (see examples/*.em), so this is a
+ *  defensive fallback, not the expected path. */
+function fieldIdentifier(name) {
+    if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(name))
+        return name;
+    return "`" + name.replace(/\\/g, "\\\\").replace(/`/g, "\\`") + "`";
+}
+// ---- Doc-comment metadata -----------------------------------------------------------------
+//
+// `tag` (DCB), `renamed from`, and `assigned` are modeling/event-store concerns, not wire-
+// contract shape — decided (per the ticket's open question) to carry them forward as plain
+// `/** ... */` doc comments, never as decorators. A custom `@tag`/`@assigned`/`@renamedFrom`
+// decorator would need its own TypeSpec extension library (`extern dec` + a JS implementation)
+// to be anything but cosmetic, which is out of scope for a dependency-free POC; a doc comment
+// keeps the information visible in the generated contract without inventing new TypeSpec
+// vocabulary this POC can't back with real semantics.
+function fieldDocComment(f) {
+    const notes = [];
+    if (f.tag)
+        notes.push("DCB identity tag");
+    if (f.renamedFrom && f.renamedFrom.length > 0) {
+        notes.push(`renamed from ${f.renamedFrom.map((n) => JSON.stringify(n)).join(", ")}`);
+    }
+    if (f.assigned)
+        notes.push("system-assigned — not supplied by the triggering command");
+    return notes.length > 0 ? notes.join("; ") : null;
+}
+function elementDocComment(el) {
+    const notes = [];
+    if (el.renamedFrom && el.renamedFrom.length > 0) {
+        notes.push(`renamed from ${el.renamedFrom.map((n) => JSON.stringify(n)).join(", ")}`);
+    }
+    if (el.tags) {
+        for (const t of el.tags) {
+            if (t.kind === "composite")
+                notes.push(`DCB composite tag \`${t.key}\` from ${(t.fields ?? []).join(", ")}`);
+            else if (t.kind === "external")
+                notes.push(`DCB external tag \`${t.key}\`: ${t.description}`);
+            // identity tags are already surfaced per-field (fieldDocComment) — not repeated here.
+        }
+    }
+    return notes.length > 0 ? notes.join("; ") : null;
+}
+function indent(lines, depth) {
+    const pad = "  ".repeat(depth);
+    return lines.map((l) => (l.length > 0 ? pad + l : l));
+}
+/**
+ * Build the `em typespec <file>` document: TypeSpec source text for a model's contract
+ * surface. Mirrors `buildExport`'s parameter contract exactly (same four inputs, same
+ * "already-validated, error-free model" precondition — the caller, cli.ts, applies the same
+ * refuse-on-error gate `em export` uses before calling this).
+ */
+export function buildTypeSpec(model, refs, diagnostics, source, path) {
+    const { doc, diagnostics: allDiagnostics } = buildExportDoc(model, refs, diagnostics, source, path);
+    const unmappedNotes = [];
+    const recordUnmapped = (refLabel, field, rawType) => {
+        unmappedNotes.push(`${refLabel} field "${field}": type "${rawType}" has no scalar mapping — emitted as \`unknown\``);
+    };
+    const typesByRef = new Map(doc.model.types.map((t) => [t.ref, t]));
+    // ---- Scoping (per the ticket's own decision points) --------------------------------
+    //
+    // Events/views: exactly `public` (docs/dsl.md's Integration surface — the flag this
+    // generator was built for). Commands have no `public` flag of their own (dsl.md), so this
+    // POC's decision is: a command is included when its own slice declares at least one public
+    // event or view — the request contract for a slice that's already promoted its outcome
+    // (or its read model) to the integration surface belongs on the same contract. A slice with
+    // no public event/view contributes nothing, including its commands.
+    const slicePublic = new Map();
+    for (const slice of doc.model.slices) {
+        slicePublic.set(slice.key, slice.elements.some((el) => (el.kind === "event" || el.kind === "view") && el.public === true));
+    }
+    const publicEvents = [];
+    const publicViews = [];
+    const scopedCommands = [];
+    // A repeated view instance (`view X again`) shares one logical identity (docs/dsl.md,
+    // "view … again") — only the first instance is emitted as a `model`; later instances are
+    // folded into it rather than re-declared under the same name (which TypeSpec would reject
+    // as a duplicate). Left out of this POC: merging the *new* fields a later public instance
+    // adds — see buildTypeSpec's module comment / the PR's "left out of POC" notes.
+    const seenViewNames = new Set();
+    for (const slice of doc.model.slices) {
+        for (const el of slice.elements) {
+            if (el.kind === "event" && el.public)
+                publicEvents.push(el);
+            else if (el.kind === "view" && el.public) {
+                const key = el.name.trim().toLowerCase();
+                if (!seenViewNames.has(key)) {
+                    seenViewNames.add(key);
+                    publicViews.push(el);
+                }
+            }
+            else if (el.kind === "command" && slicePublic.get(slice.key)) {
+                scopedCommands.push(el);
+            }
+        }
+    }
+    // ---- Named types: only those reachable from an included element's fields, transitively
+    // (never every declared type — a type nobody in the public/command surface references
+    // would be dead weight in a *contract* artifact, unlike `em export`'s full-model dump). ----
+    const reachableTypeRefs = new Set();
+    const walkFields = (fields) => {
+        if (!fields)
+            return;
+        for (const f of fields) {
+            if (f.typeRef && !reachableTypeRefs.has(f.typeRef.ref)) {
+                reachableTypeRefs.add(f.typeRef.ref);
+                const t = typesByRef.get(f.typeRef.ref);
+                if (t)
+                    walkFields(t.fields);
+            }
+        }
+    };
+    for (const el of [...publicEvents, ...publicViews, ...scopedCommands])
+        walkFields(el.fields);
+    const usedNames = new Set();
+    const typeNameByRef = new Map();
+    const typeBlocks = [];
+    for (const t of doc.model.types) {
+        if (!reachableTypeRefs.has(t.ref))
+            continue;
+        const name = dedupe(pascalCase(t.name), usedNames, "_");
+        typeNameByRef.set(t.ref, name);
+    }
+    const resolveFieldType = (f, refLabel) => {
+        if (f.typeRef) {
+            const name = typeNameByRef.get(f.typeRef.ref) ?? pascalCase(f.typeRef.name);
+            return f.typeRef.array ? `${name}[]` : name;
+        }
+        if (f.type == null)
+            return "unknown";
+        const { tsType, mapped } = mapRawType(f.type);
+        if (!mapped)
+            recordUnmapped(refLabel, f.name, f.type);
+        return tsType;
+    };
+    const renderFieldLines = (fields, refLabel) => {
+        if (!fields || fields.length === 0)
+            return [];
+        const lines = [];
+        for (const f of fields) {
+            const fieldDoc = fieldDocComment(f);
+            if (fieldDoc)
+                lines.push(`/** ${fieldDoc} */`);
+            lines.push(`${fieldIdentifier(f.name)}: ${resolveFieldType(f, refLabel)};`);
+        }
+        return lines;
+    };
+    const renderModel = (name, fields, refLabel, docComment) => {
+        const lines = [];
+        if (docComment)
+            lines.push(`/** ${docComment} */`);
+        lines.push(`model ${name} {`);
+        lines.push(...indent(renderFieldLines(fields, refLabel), 1));
+        lines.push(`}`);
+        return lines.join("\n");
+    };
+    // Named types, in declaration order, filtered to what's reachable.
+    for (const t of doc.model.types) {
+        const name = typeNameByRef.get(t.ref);
+        if (!name)
+            continue;
+        typeBlocks.push(renderModel(name, t.fields, `types/${t.name}`));
+    }
+    // ---- Events (message payloads): plain `model` declarations, schema only ------------------
+    //
+    // Open question the ticket asks to research: how does TypeSpec represent an async/event
+    // contract, given core TypeSpec is HTTP/OpenAPI-shaped? This POC's answer is the option the
+    // ticket itself lists as viable without new tooling: a plain `model` for the payload shape,
+    // no protocol semantics attached. A promoted version could layer `@typespec/events` or an
+    // AsyncAPI emitter on top of these same models for channel/binding semantics — deliberately
+    // not attempted here (see "left out of POC", the PR description, and the go/no-go note in
+    // this module's header).
+    const eventNames = new Set(usedNames);
+    const eventBlocks = [];
+    for (const el of publicEvents) {
+        const name = dedupe(pascalCase(el.name), eventNames, "_");
+        eventBlocks.push(renderModel(name, el.fields, el.ref, elementDocComment(el)));
+    }
+    // ---- Views (read-model contracts): a `model` for the shape, plus a no-arg accessor `op` —
+    // covers both halves of the ticket's "Views -> TypeSpec models/operations". Deliberately no
+    // `@get`/`@route` (that's `@typespec/http` territory, a new dependency this POC doesn't
+    // need to prove the field-mapping question) — a bare, protocol-agnostic `op`. --------------
+    const viewNames = new Set(eventNames);
+    const viewBlocks = [];
+    const viewOps = [];
+    for (const el of publicViews) {
+        const name = dedupe(pascalCase(el.name), viewNames, "_");
+        viewBlocks.push(renderModel(name, el.fields, el.ref, elementDocComment(el)));
+        viewOps.push(`op get${name}(): ${name};`);
+    }
+    // ---- Commands (request contracts): an `op` per command, one parameter per field. ---------
+    const commandOpNames = new Set();
+    const commandOps = [];
+    for (const el of scopedCommands) {
+        const opName = dedupe(camelCase(pascalCase(el.name)), commandOpNames, "_");
+        const docComment = elementDocComment(el);
+        const params = (el.fields ?? []).map((f) => {
+            const fieldDoc = fieldDocComment(f);
+            const line = `${fieldIdentifier(f.name)}: ${resolveFieldType(f, el.ref)}`;
+            return fieldDoc ? `/** ${fieldDoc} */ ${line}` : line;
+        });
+        if (docComment)
+            commandOps.push(`/** ${docComment} */`);
+        commandOps.push(params.length > 0 ? `op ${opName}(${params.join(", ")}): void;` : `op ${opName}(): void;`);
+    }
+    // ---- Assemble ------------------------------------------------------------------------
+    const namespaceName = pascalCase(doc.model.name ?? "Model") || "Model";
+    const sections = [];
+    if (typeBlocks.length > 0)
+        sections.push(typeBlocks.join("\n\n"));
+    if (eventBlocks.length > 0)
+        sections.push(eventBlocks.join("\n\n"));
+    if (viewBlocks.length > 0) {
+        sections.push(viewBlocks.join("\n\n"));
+        sections.push(["interface Views {", ...indent(viewOps, 1), "}"].join("\n"));
+    }
+    if (commandOps.length > 0) {
+        sections.push(["interface Commands {", ...indent(commandOps, 1), "}"].join("\n"));
+    }
+    const header = [
+        `// GENERATED by \`em typespec\` (${TYPESPEC_SCHEMA_VERSION}) — EXPERIMENTAL / POC (MIL-159).`,
+        `// Source: ${doc.source.path} (sha256 ${doc.source.sha256})`,
+        `// Scope: \`public\` events/views (docs/dsl.md "Integration surface"), plus every command in`,
+        `// a slice that declares at least one of them. \`tag\`/\`renamed from\`/\`assigned\` are recorded`,
+        `// as doc comments only — see docs/cli.md's "em typespec" section for the full mapping.`,
+        `// Do not edit by hand — regenerate with \`em typespec ${doc.source.path}\`.`,
+    ];
+    const body = sections.length > 0 ? indent(sections.join("\n\n").split("\n"), 1) : [];
+    const namespaceLines = body.length > 0
+        ? [`namespace ${namespaceName} {`, ...body, `}`]
+        : [`namespace ${namespaceName} {}`];
+    const text = [...header, "", ...namespaceLines].join("\n");
+    return { text, diagnostics: allDiagnostics, unmappedTypes: unmappedNotes };
+}
+//# sourceMappingURL=typespec.js.map

package/dist/emit/typespec.js.map

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

package/dist/emit/usageReportJson.d.ts

@@ -0,0 +1,3 @@
+import { UsageReport } from "../cli/usageLog.js";
+export declare const USAGE_REPORT_SCHEMA_VERSION = "1.0";
+export declare function buildUsageReportJson(report: UsageReport): string;

package/dist/emit/usageReportJson.js

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: MIT
+// Builds the `em usage-report --json` document: a versioned envelope around `UsageReport` (see
+// ../cli/usageLog.ts). Follows every other command's convention (statusJson.ts/coverageJson.ts):
+// a schema field versioned independently of both the npm package and every other command's own
+// schema. Pretty-printed, no trailing newline, no timestamps — byte-identical for the same
+// input files.
+import { GENERATOR_NAME, GENERATOR_VERSION } from "./json.js";
+// 1.0 (MIL-161): initial shape.
+export const USAGE_REPORT_SCHEMA_VERSION = "1.0";
+export function buildUsageReportJson(report) {
+    const doc = {
+        usageReportSchemaVersion: USAGE_REPORT_SCHEMA_VERSION,
+        generator: { name: GENERATOR_NAME, version: GENERATOR_VERSION },
+        root: report.root,
+        files: report.files,
+        sessions: report.sessions,
+        phaseCounts: report.phaseCounts,
+        categoryCounts: report.categoryCounts,
+        unparseableLines: report.unparseableLines,
+    };
+    return JSON.stringify(doc, null, 2);
+}
+//# sourceMappingURL=usageReportJson.js.map

package/dist/emit/usageReportJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageReportJson.js","sourceRoot":"","sources":["../../src/emit/usageReportJson.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,+FAA+F;AAC/F,iGAAiG;AACjG,+FAA+F;AAC/F,2FAA2F;AAC3F,eAAe;AAGf,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9D,gCAAgC;AAChC,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAC;AAEjD,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,MAAM,GAAG,GAAG;QACV,wBAAwB,EAAE,2BAA2B;QACrD,SAAS,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE;QAC/D,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;KAC1C,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/mcp/server.d.ts

@@ -4,7 +4,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
  *  so `em --version`/`em export`'s `generator.version`/this server's version never drift apart. */
 export declare const SERVER_NAME = "em";
 export declare const SERVER_VERSION: string;
-/** Registers all seven MCP tools on a fresh McpServer instance and returns it, unconnected — the
+/** Registers all thirteen MCP tools on a fresh McpServer instance and returns it, unconnected — the
  *  caller (src/mcp/main.ts's stdio entry, or a test harness using an in-memory transport)
  *  decides how to connect it. Building the server is a pure, side-effect-free function so tests
  *  can exercise it directly with the SDK's in-memory transport, no child process required. */