@milehimikey/em 1.8.1 → 1.9.0

package/dist/cli/skillSync.d.ts

@@ -20,3 +20,13 @@ export declare function planSkillSync(packagedDir: string, vendoredDir: string):
  * with no changes is a no-op. Creates vendoredDir (and any needed subdirectories) as needed.
  */
 export declare function applySkillSync(plan: SkillSyncPlan, packagedDir: string, vendoredDir: string): void;
+export interface SkillSyncBundleDirPlan {
+    dirName: string;
+    plan: SkillSyncPlan;
+}
+/** Pure: one planSkillSync call per named directory, paired with the directory name so the
+ *  caller can report/apply per directory. No fs writes. */
+export declare function planSkillSyncBundle(packagedRoot: string, vendoredRoot: string, dirNames: readonly string[]): SkillSyncBundleDirPlan[];
+/** Shell: applies every directory's plan from planSkillSyncBundle. Same idempotency/no-merge
+ *  contract as applySkillSync, just looped. */
+export declare function applySkillSyncBundle(bundlePlan: SkillSyncBundleDirPlan[], packagedRoot: string, vendoredRoot: string): void;

package/dist/cli/skillSync.js

@@ -66,4 +66,19 @@ export function applySkillSync(plan, packagedDir, vendoredDir) {
         }
     }
 }
+/** Pure: one planSkillSync call per named directory, paired with the directory name so the
+ *  caller can report/apply per directory. No fs writes. */
+export function planSkillSyncBundle(packagedRoot, vendoredRoot, dirNames) {
+    return dirNames.map((dirName) => ({
+        dirName,
+        plan: planSkillSync(join(packagedRoot, dirName), join(vendoredRoot, dirName)),
+    }));
+}
+/** Shell: applies every directory's plan from planSkillSyncBundle. Same idempotency/no-merge
+ *  contract as applySkillSync, just looped. */
+export function applySkillSyncBundle(bundlePlan, packagedRoot, vendoredRoot) {
+    for (const { dirName, plan } of bundlePlan) {
+        applySkillSync(plan, join(packagedRoot, dirName), join(vendoredRoot, dirName));
+    }
+}
 //# sourceMappingURL=skillSync.js.map

package/dist/cli/skillSync.js.map

@@ -1 +1 @@
-{"version":3,"file":"skillSync.js","sourceRoot":"","sources":["../../src/cli/skillSync.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,yFAAyF;AACzF,mFAAmF;AACnF,yFAAyF;AACzF,0FAA0F;AAC1F,0EAA0E;AAC1E,EAAE;AACF,0FAA0F;AAC1F,4FAA4F;AAC5F,uFAAuF;AACvF,2FAA2F;AAC3F,yCAAyC;AACzC,EAAE;AACF,+FAA+F;AAC/F,sFAAsF;AACtF,yDAAyD;AAEzD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAgB7C,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,WAAmB;IACpE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE3E,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,CAAC,UAAU,IAAI,UAAU,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;YACrF,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,cAAc,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAmB,EAAE,WAAmB,EAAE,WAAmB;IAC1F,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"skillSync.js","sourceRoot":"","sources":["../../src/cli/skillSync.ts"],"names":[],"mappings":"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"}

package/dist/cli/sliceIndex.d.ts

@@ -9,6 +9,9 @@ export interface SliceIndexRow {
     name: string;
     pattern: string;
     status: string;
+    ratifiedBy: string;
+    owner: string;
+    tracking: string;
     implementedIn: string;
     docPath: string;
 }

package/dist/cli/sliceIndex.js

@@ -16,8 +16,8 @@ import { applyMarker } from "../util/markers.js";
 /** The marker name wrapping the Slices table: `<!-- GENERATED:slices:start -->` /
  *  `<!-- GENERATED:slices:end -->`, matching templates/model-readme.md. */
 export const SLICE_INDEX_MARKER = "slices";
-const TABLE_HEADER = "| # | Slice | Pattern | Status | Implemented in | Design doc |\n" +
-    "|---|-------|---------|--------|----------------|------------|";
+const TABLE_HEADER = "| # | Slice | Pattern | Status | Ratified by | Owner | Tracking | Implemented in | Design doc |\n" +
+    "|---|-------|---------|--------|-------------|-------|----------|----------------|------------|";
 /** Escape characters that would break a markdown table cell: `|` (the column separator) and
  *  newlines (a slice name is always one line, but a doc's freeform `implementedIn` text isn't
  *  guaranteed to be). */
@@ -53,11 +53,15 @@ export function buildSliceIndexTable(model, refs, baseDir) {
             name: slice.name,
             pattern: slicePatternLabel(pattern),
             status: statusCell(doc),
+            ratifiedBy: doc.ratifiedBy ?? "—",
+            owner: doc.owner ?? "—",
+            tracking: doc.tracking ?? "—",
             implementedIn: doc.implementedIn ?? "—",
             docPath: doc.path,
         };
     });
     const lines = rows.map((r) => `| ${r.index} | ${escapeCell(r.name)} | ${escapeCell(r.pattern)} | ${escapeCell(r.status)} | ` +
+        `${escapeCell(r.ratifiedBy)} | ${escapeCell(r.owner)} | ${escapeCell(r.tracking)} | ` +
         `${escapeCell(r.implementedIn)} | [${r.docPath}](${r.docPath}) |`);
     return { markdown: [TABLE_HEADER, ...lines].join("\n"), rows, diagnostics };
 }

package/dist/cli/sliceIndex.js.map

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

package/dist/cli/sliceLink.d.ts

@@ -0,0 +1,52 @@
+import { NormalizedModel, Element } from "../model/model.js";
+import { RefsResult } from "../model/refs.js";
+import { SlicePattern } from "./sliceNew.js";
+export type ResolvePrimaryElementResult = {
+    ok: true;
+    sliceIndex: number;
+    element: Element;
+} | {
+    ok: false;
+    message: string;
+};
+/** Resolve `sliceKey`'s primary element for `pattern` — the export key must match a slice
+ *  already declared in `model` (the ordinary case: the model phase already created the slice;
+ *  `slice` phase authoring adds its doc afterward), and that slice must have EXACTLY one element
+ *  of the pattern's primary kind(s) — zero or more than one is refused rather than guessed. */
+export declare function resolvePrimaryElement(model: NormalizedModel, refs: RefsResult, sliceKey: string, pattern: SlicePattern): ResolvePrimaryElementResult;
+export type InsertNoteResult = {
+    ok: true;
+    content: string;
+} | {
+    ok: false;
+    message: string;
+};
+/** Insert `note "<notePath>"` into one raw source line — see module header for the placement
+ *  rule. Pure string transform, no fs, no knowledge of the rest of the file. */
+export declare function insertNoteClause(rawLine: string, notePath: string): InsertNoteResult;
+/** Byte offsets of physical line `lineNo` (1-indexed) within `source`: `[start, end)` excludes
+ *  the line's own terminator (a trailing `\r` before `\n` is excluded too, so a CRLF file's line
+ *  content never carries a stray `\r`). Scans once, character by character, rather than
+ *  `split(/\r?\n/)` — a split+rejoin would silently normalize every OTHER line's terminator
+ *  style the moment the file is written back (the same pitfall markImplemented.ts/ratify.ts's
+ *  module headers document for frontmatter surgery — this is the `.em`-source counterpart). */
+export declare function findLineSpan(source: string, lineNo: number): {
+    start: number;
+    end: number;
+} | null;
+export type WireSliceNoteResult = {
+    ok: true;
+    content: string;
+    sliceName: string;
+    elementName: string;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Full `--wire` operation: resolve `sliceKey`'s primary element for `pattern`, then insert
+ * `note "<notePath>"` on its exact header line in `source`. `source` MUST be the same text
+ * `model`/`refs` were compiled from — line numbers are meaningless against any other text.
+ * Every byte outside that one line's span is returned unchanged.
+ */
+export declare function wireSliceNote(source: string, model: NormalizedModel, refs: RefsResult, sliceKey: string, pattern: SlicePattern, notePath: string): WireSliceNoteResult;

package/dist/cli/sliceLink.js

@@ -0,0 +1,152 @@
+// SPDX-License-Identifier: MIT
+// `em slice new --wire` (MIL-161 finding #3): `em slice new` already computes the exact
+// `note "slices/<key>.md"` line and knows which element is the slice's "primary" one for its
+// pattern (SKILL.md's slice phase, step 4) — this module does the mechanical part that used to
+// stop at printing that line: inserting it into the `.em` source directly, onto the right
+// element's declaration line.
+//
+// Deliberately narrow, matching every other .em-source-editing decision in this codebase (there
+// is no general .em serializer — see docModelConsistencyValidate.ts's header for why a
+// parse+re-serialize is never on the table here either): this ONLY ever edits the ONE physical
+// source line an element's declaration STARTS on (`Element.line`, 1-indexed, straight from the
+// parser — parser.ts's `parseElement`/`lineNo`), and only ever INSERTS a `note "..."` clause
+// into it. Every other line — including the rest of a multi-line field block and its closing
+// `}` — is copied through byte-for-byte; multi-line field text on the SAME line as a note
+// insertion (a block's opening line, e.g. `command Place Order { customerId`) is preserved
+// verbatim too, since the insertion point is always relative to the unquoted `{`, never to
+// anything after it.
+//
+// Placement follows the grammar exactly (parser.ts's `extractClauses`): `note`/`issue`/
+// `divergence`/`tag`/`renamed from` are all extracted from an element's header line BEFORE
+// `from`, and by locating the keyword anywhere in the line rather than requiring it in a fixed
+// position — so a `note "..."` clause parses identically whether it comes before or after a
+// `from "..."` clause, before or after a `@Tag`, immediately before an opening `{`, or right
+// after a `}` that already closed inline. That's what makes one placement rule safe for every
+// element shape:
+//
+//   - the header line opens a field block on this SAME line (an unquoted `{`, MIL-122's
+//     quote-aware scan — a literal `{` inside a quoted clause like `issue "PUT /widgets/{id}"`
+//     is not a block opener): insert immediately BEFORE that `{`, matching every existing
+//     note-before-fields example in the DSL (`event X @Ctx note "..." { ... }`).
+//   - otherwise (no field block at all on this line, OR a fully inline `{ ... }` block that
+//     already closed on the same line): append at the very end of the code, before any trailing
+//     `# comment` — matching the grammar's "clauses may trail a closing `}` on the same line"
+//     rule, which already covers both shapes identically.
+//
+// Refuses (never overwrites/duplicates) when the header line already carries a `note` clause —
+// the caller falls back to printing the line for a hand edit, same as when `--wire` isn't passed
+// at all.
+import { indexOfUnquoted, stripComment } from "../parser/lexer.js";
+/** Which element kind(s) count as a slice's "primary" element per pattern — the one `note
+ *  "slices/<key>.md"` binds to (SKILL.md's slice phase, step 4): the command for State Change,
+ *  the view for State View, the reactor (processor/automation/saga) for Automation, the
+ *  translation for Translation. Distinct from classify.ts's classifySlicePattern, which groups
+ *  every kind a pattern's slice may contain (e.g. an Automation slice's command too) — this
+ *  narrows to the single element the note actually binds to. */
+const PRIMARY_KINDS = {
+    "state-change": ["command"],
+    "state-view": ["view"],
+    automation: ["processor", "automation", "saga"],
+    translation: ["translation"],
+};
+/** Resolve `sliceKey`'s primary element for `pattern` — the export key must match a slice
+ *  already declared in `model` (the ordinary case: the model phase already created the slice;
+ *  `slice` phase authoring adds its doc afterward), and that slice must have EXACTLY one element
+ *  of the pattern's primary kind(s) — zero or more than one is refused rather than guessed. */
+export function resolvePrimaryElement(model, refs, sliceKey, pattern) {
+    const sliceIndex = refs.sliceKeys.indexOf(sliceKey);
+    if (sliceIndex === -1) {
+        return { ok: false, message: `no slice with export key "${sliceKey}" in this model` };
+    }
+    const slice = model.slices[sliceIndex];
+    const kinds = PRIMARY_KINDS[pattern];
+    const candidates = slice.elements.filter((el) => kinds.includes(el.kind));
+    if (candidates.length === 0) {
+        return {
+            ok: false,
+            message: `slice "${slice.name}" has no ${kinds.join("/")} element to wire the note onto`,
+        };
+    }
+    if (candidates.length > 1) {
+        return {
+            ok: false,
+            message: `slice "${slice.name}" has ${candidates.length} ${kinds.join("/")} elements — ambiguous, wire the note by hand`,
+        };
+    }
+    return { ok: true, sliceIndex, element: candidates[0] };
+}
+/** Insert `note "<notePath>"` into one raw source line — see module header for the placement
+ *  rule. Pure string transform, no fs, no knowledge of the rest of the file. */
+export function insertNoteClause(rawLine, notePath) {
+    const code = stripComment(rawLine);
+    const comment = rawLine.slice(code.length); // '' or the (whitespace + '#...') tail stripComment dropped
+    const trimmedCode = code.replace(/[ \t]+$/, "");
+    // Conservative existing-clause check: a bare "note" immediately followed by a quote is
+    // EXACTLY how the parser itself recognizes the clause (lexer.ts's QUOTE_OPENER_KEYWORDS
+    // anchoring), regardless of where else it appears — a false positive here just means an
+    // avoidable refusal (falls back to a hand edit), never a corrupted line.
+    if (/\bnote\s*"/.test(trimmedCode)) {
+        return { ok: false, message: "this line already has a `note` clause — edit it by hand instead" };
+    }
+    const clause = `note "${notePath}"`;
+    const braceAt = indexOfUnquoted(trimmedCode, "{");
+    // A `{` on THIS line only means "insert before it" when the block actually stays open past
+    // this line (no matching unquoted `}` here too) — a fully inline `{ ... }` block that already
+    // closed on the same line is grammatically just like having no braces at all: the note clause
+    // trails it, same as the no-brace case below.
+    const closesInline = braceAt >= 0 && indexOfUnquoted(trimmedCode.slice(braceAt + 1), "}") >= 0;
+    const newCode = braceAt >= 0 && !closesInline
+        ? `${trimmedCode.slice(0, braceAt).replace(/[ \t]+$/, "")} ${clause} ${trimmedCode.slice(braceAt)}`
+        : `${trimmedCode} ${clause}`;
+    return { ok: true, content: comment ? `${newCode} ${comment}` : newCode };
+}
+/** Byte offsets of physical line `lineNo` (1-indexed) within `source`: `[start, end)` excludes
+ *  the line's own terminator (a trailing `\r` before `\n` is excluded too, so a CRLF file's line
+ *  content never carries a stray `\r`). Scans once, character by character, rather than
+ *  `split(/\r?\n/)` — a split+rejoin would silently normalize every OTHER line's terminator
+ *  style the moment the file is written back (the same pitfall markImplemented.ts/ratify.ts's
+ *  module headers document for frontmatter surgery — this is the `.em`-source counterpart). */
+export function findLineSpan(source, lineNo) {
+    let line = 1;
+    let start = 0;
+    for (let i = 0; i <= source.length; i++) {
+        if (i === source.length || source[i] === "\n") {
+            let end = i;
+            if (end > start && source[end - 1] === "\r")
+                end--;
+            if (line === lineNo)
+                return { start, end };
+            line++;
+            start = i + 1;
+        }
+    }
+    return null;
+}
+/**
+ * Full `--wire` operation: resolve `sliceKey`'s primary element for `pattern`, then insert
+ * `note "<notePath>"` on its exact header line in `source`. `source` MUST be the same text
+ * `model`/`refs` were compiled from — line numbers are meaningless against any other text.
+ * Every byte outside that one line's span is returned unchanged.
+ */
+export function wireSliceNote(source, model, refs, sliceKey, pattern, notePath) {
+    const resolved = resolvePrimaryElement(model, refs, sliceKey, pattern);
+    if (!resolved.ok)
+        return resolved;
+    const span = findLineSpan(source, resolved.element.line);
+    if (!span) {
+        return {
+            ok: false,
+            message: `element "${resolved.element.name}"'s line ${resolved.element.line} not found in the given source — source doesn't match the compiled model`,
+        };
+    }
+    const inserted = insertNoteClause(source.slice(span.start, span.end), notePath);
+    if (!inserted.ok)
+        return inserted;
+    return {
+        ok: true,
+        content: source.slice(0, span.start) + inserted.content + source.slice(span.end),
+        sliceName: model.slices[resolved.sliceIndex].name,
+        elementName: resolved.element.name,
+    };
+}
+//# sourceMappingURL=sliceLink.js.map

package/dist/cli/sliceLink.js.map

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

package/dist/cli/status.d.ts

@@ -0,0 +1,261 @@
+import { NormalizedModel } from "../model/model.js";
+import { RefsResult } from "../model/refs.js";
+import { DocReason } from "../catalog/docJoin.js";
+import { DriftSignalKind } from "../catalog/driftSignal.js";
+import { Diagnostic } from "../model/validate.js";
+import { CoverageReport } from "./coverage.js";
+import { GitRunner } from "./diff-inputs.js";
+import { SliceDocFacts } from "./conformScope.js";
+/** The 4 canonical slice-doc lifecycle statuses (docs/slice-doc-schema.md) — the same enum
+ *  `em catalog`'s header coloring and `em render`'s status legend already recognize. */
+export declare const CANONICAL_STATUSES: readonly ["draft", "reviewed", "ready-to-implement", "implemented"];
+export type CanonicalStatus = (typeof CANONICAL_STATUSES)[number];
+/** Bucket a slice's lifecycle status falls into for the rollup: one of the 4 canonical values,
+ *  `"no-doc"` (no doc bound at all, or the binding names a missing file — `resolveSliceDocJoin`'s
+ *  `found: false`), `"frontmatter-invalid"` (a doc WAS found — a note binds it — but its
+ *  frontmatter is missing or malformed, so nothing reliable can be read from it; kept distinct
+ *  from `"no-doc"` because "nothing was ever referenced" and "something's referenced but broken"
+ *  are different states worth telling apart in a rollup), or `"unknown"` (a doc was found and its
+ *  frontmatter usable, but `status` isn't one of the 4 canonical strings — a freeform doc,
+ *  matching `em slice index`'s own "unknown" convention). */
+export type StatusBucket = CanonicalStatus | "no-doc" | "frontmatter-invalid" | "unknown";
+export declare function classifyStatusBucket(found: boolean, reason: DocReason, status: string | null): StatusBucket;
+/** One slice's status-rollup facts, joined from the same doc read every doc-aware command
+ *  shares — never a second parse of the model or the doc. */
+export interface SliceStatusFact {
+    file: string;
+    key: string;
+    docFound: boolean;
+    docReason: DocReason;
+    /** Resolved absolute path to the bound doc file, or null when none was found. Two slices can
+     *  legitimately resolve to the SAME doc (MIL-121 `covers:` cross-binding, one doc ratifying
+     *  coverage for several slices) — this is how `buildStatusReport` dedupes doc-body-derived
+     *  counts (Open Questions) so a shared doc's single unresolved question isn't counted once per
+     *  covered slice. */
+    docPath: string | null;
+    rawStatus: string | null;
+    /** The doc's own `implementedIn:` value verbatim (or null) — carried through from the same
+     *  `resolveSliceDocJoin` call this fact set already makes, so `resolveSlicePRsBehindHead`
+     *  (MIL-164) can build its `SliceDocFacts[]` input from these facts directly rather than
+     *  joining every slice's doc a second time. */
+    implementedIn: string | null;
+    /** MIL-171: the doc's own `owner:` value verbatim (or null) — carried through from the same
+     *  `resolveSliceDocJoin` call this fact set already makes, so a per-slice owner rollup
+     *  (`StatusReport.owners`) never needs a second doc join. */
+    owner: string | null;
+    bucket: StatusBucket;
+    driftSignal: DriftSignalKind | null;
+    openQuestionsTotal: number;
+    openQuestionsUnchecked: number;
+}
+export interface SliceStatusFactsResult {
+    facts: SliceStatusFact[];
+    /** Doc-join diagnostics (`binding-missing-file`/`frontmatter-invalid` warnings) raised while
+     *  resolving each slice's doc — the same diagnostics `em export`'s doc join raises. Carried
+     *  back rather than dropped: a state-of-the-system report shouldn't silently swallow "this
+     *  slice's doc reference is broken." */
+    diagnostics: Diagnostic[];
+}
+/**
+ * Resolve every slice's status-rollup facts for one already-compiled model. `baseDir` is the
+ * `.em` file's directory, same doc-resolution convention every other doc-aware command uses.
+ * Open Questions counts are read from the slice's OWN bound doc (re-deriving the key from
+ * `doc.path`, not assuming it's this slice's own — MIL-121 cross-binding can resolve to a
+ * different slice's doc, same re-derivation `em coverage`/`--slice-ready` use) rather than a
+ * second independent parse.
+ */
+export declare function resolveSliceStatusFacts(file: string, model: NormalizedModel, refs: RefsResult, baseDir: string): SliceStatusFactsResult;
+/** Open `issue "text"` markers in a model — the same predicate `em validate --list-issues`
+ *  counts, here reduced to a bare count for the rollup. */
+export declare function countOpenIssues(model: NormalizedModel): number;
+export interface ConformanceEntry {
+    file: string;
+    modelDir: string;
+    hasStateFile: boolean;
+    lastConformance: {
+        date: string;
+        revision: string;
+    } | null;
+    /** The repo `commitsBehindHead` was computed in — `--repo` when given, else the model's own
+     *  directory (works out of the box for a single-repo project; conform-scope's `--repo`
+     *  convention still applies for a model whose implementation lives in a different repo). */
+    repo: string;
+    commitsBehindHead: number | null;
+    /** Slices whose bound doc's `implementedIn:` maps to a path changed since `lastConformance`'s
+     *  revision (MIL-164) — the same `candidateSlices` computation `em conform-scope` makes for
+     *  one model at a time (`conformScope.ts`'s `changedPathsSince` + `buildConformScope`), rolled
+     *  up here to a single count: "how many slices likely shipped code since the last conform
+     *  sweep." Each candidate slice typically corresponds to one merged slice PR, hence the name.
+     *  Null under the same conditions `commitsBehindHead` is null — it needs the same revision to
+     *  diff against, and by construction is only ever null when `error` is also set (see
+     *  `resolveConformanceEntry` below): a bare "opted out of computing this" state doesn't occur
+     *  on the real CLI/MCP call paths, which always supply `sliceDocFacts`. */
+    slicePRsBehindHead: number | null;
+    /** Set when the state file exists and parses, but git couldn't answer commits-behind-HEAD or
+     *  slice-PRs-behind-HEAD (not a git repo, unknown revision, ...) — reported per-model rather
+     *  than aborting the whole rollup, since `em status` is a soft report, not a gate. Also carries
+     *  a state-file parse failure (unparseable `Last conformance:` bullet), same non-fatal
+     *  treatment. */
+    error: string | null;
+}
+/**
+ * `git rev-list --count <revision>..HEAD` in `repo` (any directory inside it, not necessarily
+ * its root — same "anchor dir, resolve toplevel" convention `conformScope.ts`'s
+ * `changedPathsSince` uses). The git runner is injectable so every failure branch is
+ * unit-testable without a real repository.
+ */
+export declare function commitsBehindHead(repo: string, revision: string, runGit?: GitRunner): {
+    ok: true;
+    count: number;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * `M` in "N commits and M slice-PRs behind HEAD" (MIL-164) — how many slices whose doc's
+ * `implementedIn:` names a path this model's target repo changed since `revision`. Reuses the
+ * exact `em conform-scope` machinery for one model at a time: `changedPathsSince` (the same
+ * `git diff --name-only <revision>..HEAD` walk, same injectable `GitRunner`) to get the changed
+ * paths, then `buildConformScope`'s own `implementedIn`-prefix matching (never fuzzy, never a
+ * second guess) to turn them into a candidate-slice count. `full` is always `false` here — this
+ * is only ever called once `lastConformance` is known non-null (see `resolveConformanceEntry`
+ * below), so there is always a revision to diff against.
+ */
+export declare function resolveSlicePRsBehindHead(repo: string, revision: string, slices: SliceDocFacts[], runGit?: GitRunner): {
+    ok: true;
+    count: number;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Resolve one model's conformance entry: read its sibling state file (if any — not every model
+ * has reached the `conform` phase, so a missing state file is routine, not an error), then
+ * compute commits-behind-HEAD and slice-PRs-behind-HEAD (MIL-164) when `Last conformance:` is
+ * set. `repoOverride` is `--repo`; omitted, each model's own directory is used as the repo to
+ * walk (the common single-repo project case — see `repo` field doc above). `sliceDocFacts` is
+ * THIS model's own slice facts (`key`/`status`/`implementedIn`) — the caller's responsibility to
+ * scope correctly per file, since `resolveSlicePRsBehindHead` matches against exactly this
+ * model's slices, not some other input model's.
+ *
+ * A state file is shared by every `.em` file in its directory (`.event-modeling.md` has no
+ * per-model namespacing), but its `Model file:` bullet names exactly ONE of them — so a sibling
+ * file it does NOT describe (the common case: a `conform-scope --seed-asis` scratch copy like
+ * `checkout-asis.em` sitting next to `checkout.em`) must not inherit `checkout.em`'s conformance
+ * record just because it lives in the same directory. When `Model file:` is set and doesn't match
+ * `basename(file)`, the record is reported as unattributed (via `error`, the same non-fatal
+ * channel a git failure uses) rather than silently misattributed.
+ */
+export declare function resolveConformanceEntry(file: string, repoOverride: string | undefined, sliceDocFacts: SliceDocFacts[], runGit?: GitRunner): ConformanceEntry;
+export interface StatusSliceCounts {
+    total: number;
+    byStatus: {
+        draft: number;
+        reviewed: number;
+        readyToImplement: number;
+        implemented: number;
+        noDoc: number;
+        /** A doc IS bound (a `note` names it) but its frontmatter is missing/malformed — see
+         *  `StatusBucket`'s `"frontmatter-invalid"` doc comment. Kept apart from `noDoc` (nothing
+         *  bound at all) and `unknown` (bound, usable, just a freeform `status` value), and always
+         *  equal to `driftSignal.frontmatterInvalid` below — same slices, two dimensions. */
+        frontmatterInvalid: number;
+        unknown: number;
+    };
+}
+export interface StatusDriftCounts {
+    inSync: number;
+    neverImplemented: number;
+    unpropagatedDelta: number;
+    implementedWithoutLink: number;
+    /** Slices with no doc bound at all (or a binding naming a missing file) — driftSignal is null
+     *  because there's nothing to classify. Distinct from `frontmatterInvalid` below: THIS bucket
+     *  is `resolveSliceDocJoin`'s `found: false`, in either dimension. */
+    notApplicable: number;
+    /** A doc IS bound and found (`found: true`) but its frontmatter is missing/malformed, so
+     *  `driftSignal` couldn't be classified — always equal to `slices.byStatus.frontmatterInvalid`
+     *  (same slices). Kept apart from `notApplicable` so "nothing was ever referenced" and
+     *  "something's referenced but broken" don't collapse into one ambiguous bucket (a doc that
+     *  IS found shouldn't tally the same as one that plain doesn't exist). */
+    frontmatterInvalid: number;
+}
+export interface StatusInvariantTotals {
+    testsDir: string;
+    total: number;
+    cited: number;
+    uncovered: number;
+}
+export interface StatusIssueTotals {
+    openIssues: number;
+    openQuestionsTotal: number;
+    openQuestionsUnchecked: number;
+}
+/** One doc-join diagnostic, tagged with the input file it came from — `em status` can aggregate
+ *  several models in one run, so (unlike `em export`'s single-model diagnostics) each entry
+ *  needs to say which file it concerns. */
+export type StatusDiagnostic = {
+    file: string;
+} & Diagnostic;
+/** MIL-171: one slice's owner fact — the per-slice detail this ticket asked `em status` to
+ *  surface, kept deliberately minimal (no other fact duplicated here that `slices`/`diagnostics`
+ *  already carry elsewhere in the report). `file`+`key` identify the slice the same way
+ *  `StatusDiagnostic`'s `file` tags a diagnostic to its model; `owner` is the doc's own `owner:`
+ *  verbatim, null when absent OR when no doc was found at all — same "null when absent"
+ *  convention `em export`'s doc join uses. Listed once per slice, never deduped: two slices
+ *  legitimately sharing one doc (MIL-121 `covers:`) also legitimately share the same owner. */
+export interface StatusOwnerEntry {
+    file: string;
+    key: string;
+    owner: string | null;
+}
+export interface StatusReport {
+    files: string[];
+    slices: StatusSliceCounts;
+    driftSignal: StatusDriftCounts;
+    /** Null when `--tests <dir>` wasn't given — invariant coverage is opt-in (it needs a test
+     *  tree to scan), unlike every other rollup dimension, which is always computable from the
+     *  model(s) alone. */
+    invariants: StatusInvariantTotals | null;
+    issues: StatusIssueTotals;
+    conformance: ConformanceEntry[];
+    /** Doc-join diagnostics (`binding-missing-file`/`frontmatter-invalid` warnings) collected
+     *  while resolving every slice's doc, across every input file — carried here rather than
+     *  discarded, so a state-of-the-system report doesn't hide a broken doc reference just
+     *  because it also folded that slice into `frontmatterInvalid`/`noDoc` above. */
+    diagnostics: StatusDiagnostic[];
+    /** MIL-171: per-slice owner facts, one entry per slice across every input file — see
+     *  `StatusOwnerEntry`. */
+    owners: StatusOwnerEntry[];
+}
+/** Aggregate everything `em status` reports into one `StatusReport` — pure, no I/O. Callers
+ *  (the CLI action, the MCP tool) resolve every input first (compile each model, join every
+ *  slice's doc, scan the test tree once, resolve conformance) and hand the results here. */
+export declare function buildStatusReport(files: string[], sliceFacts: SliceStatusFact[], openIssuesCount: number, invariants: StatusInvariantTotals | null, conformance: ConformanceEntry[], diagnostics: StatusDiagnostic[]): StatusReport;
+/** Sum per-model `CoverageReport`s (see `./coverage.ts`) into one `StatusInvariantTotals` —
+ *  `em status` doesn't need the per-slice/per-ID detail `em coverage --json` carries, just the
+ *  totals, across however many models `--tests <dir>` was scanned against. */
+export declare function aggregateInvariantTotals(testsDir: string, reports: CoverageReport[]): StatusInvariantTotals;
+/** Exported for `em freshness` (freshness.ts, MIL-164) — the standalone surface for exactly
+ *  this one clause, without pulling in the rest of `em status`'s rollup. */
+export declare function formatConformancePart(entry: ConformanceEntry): string;
+/** The one-line rollup: `"8/8 implemented · 20/20 invariants covered · 0 open issues · last
+ *  conformed <rev>, N commits behind HEAD"` (MIL-163's acceptance line). For multiple input
+ *  models, the conformance clause reports the FIRST file's entry — a single-file invocation is
+ *  the common case this line is written for; the full per-model breakdown is always in
+ *  `formatStatusDetail`/the JSON document regardless of file count. */
+export declare function formatStatusSummary(report: StatusReport): string;
+/** The detail block below the summary line: one line per rollup dimension, plus one line per
+ *  model's conformance entry. */
+export declare function formatStatusDetail(report: StatusReport): string;
+/** Full text report: the summary line, a blank line, then the detail block — same
+ *  "rollup line, then detail" shape `em diff`'s text report uses. */
+export declare function formatStatusText(report: StatusReport): string;
+/** A markdown block suited for pasting into a README (MIL-163's `--md`) — a small table,
+ *  same spirit as `em slice index`'s GENERATED Slices table, but not marker-managed: `--md`
+ *  just prints the block, leaving where/whether to embed it to the caller. */
+export declare function formatStatusMarkdown(report: StatusReport): string;
+/** Render one flat-style SVG badge — two colored rects (label, message) plus centered text,
+ *  no external fonts/images/scripts, so it renders identically anywhere an SVG does. */
+export declare function renderBadgeSvg(label: string, message: string, color: string): string;
+/** Build the `em status --badge` SVG document. */
+export declare function buildStatusBadge(report: StatusReport): string;