@miragon/pulse-engine-core 0.0.0-bootstrap.0 → 0.25.0

package/dist/dates.js

@@ -0,0 +1,189 @@
+/**
+ * Engine dates. CIB seven / Camunda 7 / Operaton parse EVERY date (query
+ * filters, request bodies, `Date` variables) with one Java pattern,
+ * `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, where `Z` is a `±HHMM` offset. A literal "Z",
+ * an offset with a colon, missing milliseconds or a bare date are all 400s.
+ * Callers therefore accept ordinary ISO 8601 at their boundary and convert it
+ * here, once: one parser, read in one of two {@link DateInputReading}s.
+ *
+ * The read direction has two readers as well: {@link engineDateMillis} (this
+ * parser, an offset required) and {@link engineTime} (`Date.parse`, which also
+ * reads an offset-less time, in the local zone). Both are kept as they are
+ * until the two readings are aligned (a behaviour change, not a move).
+ */
+/** The relaxed spellings; a time needs its offset. The default of every function here. */
+export const OFFSET_REQUIRED = "offset-required";
+/** The strict spellings; a time without an offset is UTC. */
+export const UTC_WITHOUT_OFFSET = "utc-without-offset";
+const READING_RULES = {
+    [OFFSET_REQUIRED]: { assumeUtc: false, relaxed: true },
+    [UTC_WITHOUT_OFFSET]: { assumeUtc: true, relaxed: false },
+};
+/** Example of the accepted input forms of {@link OFFSET_REQUIRED}, for error messages and descriptions. */
+export const ENGINE_DATE_INPUT_FORMS = "ISO 8601: a date (2026-10-01, midnight UTC) or a date-time with offset (2026-10-01T08:30:00Z, 2026-10-01T08:30:00.000+02:00)";
+// date [ sep time [ fraction ] [ offset ] ]: the union of both readings' spellings; `isAccepted`
+// refuses what the reading does not accept.
+const ISO_INPUT = /^(\d{4})-(\d{2})-(\d{2})(?:([Tt ])(\d{2}):(\d{2})(?::(\d{2})(?:([.,])(\d+))?)?([Zz]|[+-]\d{2}(?::?\d{2})?)?)?$/;
+const pad = (value, width = 2) => String(value).padStart(width, "0");
+/** `Z` / `+02` / `+02:00` / `+0200` → `+0000` / `+0200` (null when out of range). */
+function engineOffset(raw) {
+    if (raw === undefined || raw === "Z" || raw === "z")
+        return "+0000";
+    const digits = raw.slice(1).replace(":", "");
+    const hours = Number(digits.slice(0, 2));
+    const minutes = digits.length > 2 ? Number(digits.slice(2)) : 0;
+    if (hours > 23 || minutes > 59)
+        return null;
+    return `${raw[0]}${pad(hours)}${pad(minutes)}`;
+}
+function isLeapYear(year) {
+    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+}
+function daysInMonth(year, month) {
+    if (month === 2)
+        return isLeapYear(year) ? 29 : 28;
+    return [4, 6, 9, 11].includes(month) ? 30 : 31;
+}
+/** The day exists: `Date.UTC` rolls 2026-02-30 over to March (relaxed), or the Gregorian calendar. */
+function isCalendarDay(parts, relaxed) {
+    if (!relaxed) {
+        return (parts.month >= 1 &&
+            parts.month <= 12 &&
+            parts.day >= 1 &&
+            parts.day <= daysInMonth(parts.year, parts.month));
+    }
+    const probe = new Date(Date.UTC(parts.year, parts.month - 1, parts.day));
+    return probe.getUTCMonth() === parts.month - 1 && probe.getUTCDate() === parts.day;
+}
+/** The strict spellings: `T`, `.`, and `Z` or an offset with its minutes (`±HHMM`, `±HH:MM`). */
+function isStrictSpelling(separator, point, zone) {
+    return ((separator ?? "T") === "T" &&
+        (point ?? ".") === "." &&
+        (zone === undefined || zone === "Z" || zone.length > 3));
+}
+/** A time without an offset only as `assumeUtc`; the spellings of the reading. */
+function isAccepted(match, reading) {
+    const [, , , , separator, hour, , , point, fraction, zone] = match;
+    if (hour !== undefined && zone === undefined && !reading.assumeUtc)
+        return false;
+    return reading.relaxed ? (fraction?.length ?? 0) <= 9 : isStrictSpelling(separator, point, zone);
+}
+function toParts(match, offset) {
+    const [, y, mo, d, , h, mi, s, , fraction] = match;
+    return {
+        year: Number(y),
+        month: Number(mo),
+        day: Number(d),
+        hour: Number(h ?? 0),
+        minute: Number(mi ?? 0),
+        second: Number(s ?? 0),
+        // The engine keeps milliseconds; finer digits are cut, never rounded up
+        // into the next second.
+        millis: (fraction ?? "").slice(0, 3).padEnd(3, "0"),
+        offset,
+    };
+}
+function isClockTime(parts) {
+    return parts.hour <= 23 && parts.minute <= 59 && parts.second <= 59;
+}
+function parse(input, readingName) {
+    const reading = READING_RULES[readingName];
+    const match = ISO_INPUT.exec(reading.relaxed ? input.trim() : input);
+    if (!match || !isAccepted(match, reading))
+        return null;
+    const offset = engineOffset(match[10]);
+    if (offset === null)
+        return null;
+    const parts = toParts(match, offset);
+    return isClockTime(parts) && isCalendarDay(parts, reading.relaxed) ? parts : null;
+}
+/** Whether `input` is an ISO 8601 date the reading can convert. */
+export function isEngineDateInput(input, reading = OFFSET_REQUIRED) {
+    return parse(input, reading) !== null;
+}
+/** The engine format of an ISO 8601 date input; undefined when the reading refuses it. */
+export function engineDateInput(input, reading = OFFSET_REQUIRED) {
+    const parts = parse(input, reading);
+    if (!parts)
+        return undefined;
+    const date = `${pad(parts.year, 4)}-${pad(parts.month)}-${pad(parts.day)}`;
+    const time = `${pad(parts.hour)}:${pad(parts.minute)}:${pad(parts.second)}.${parts.millis}`;
+    return `${date}T${time}${parts.offset}`;
+}
+/**
+ * ISO 8601 (or a `Date`) → the engine's `yyyy-MM-dd'T'HH:mm:ss.SSS±HHMM`.
+ * A string keeps its own offset (`Z` becomes `+0000`), so the instant is
+ * unchanged; a bare date means midnight UTC; a `Date` is written in UTC.
+ * Throws a `RangeError` naming the accepted forms for anything else
+ * (read as {@link OFFSET_REQUIRED}).
+ */
+export function toEngineDate(input) {
+    if (input instanceof Date) {
+        if (Number.isNaN(input.getTime()))
+            throw new RangeError("Invalid date: not a valid Date");
+        return input.toISOString().replace("Z", "+0000");
+    }
+    const engine = engineDateInput(input);
+    if (engine === undefined) {
+        throw new RangeError(`Invalid date "${input}": expected ${ENGINE_DATE_INPUT_FORMS}`);
+    }
+    return engine;
+}
+/** {@link toEngineDate} for optional filters: `undefined` stays `undefined`. */
+export function toOptionalEngineDate(input) {
+    return input === undefined ? undefined : toEngineDate(input);
+}
+/**
+ * The read direction: a timestamp the engine EMITS (`…SSS±HHMM`, its local
+ * offset) → epoch millis; null when absent or unparseable. Engine timestamps
+ * order by instant, never as text: across a DST change the engine stamps
+ * `…+0200` and `…+0100`, and the string order is then off by up to an hour.
+ */
+export function engineDateMillis(value) {
+    const parts = value ? parse(value, OFFSET_REQUIRED) : null;
+    if (!parts)
+        return null;
+    const sign = parts.offset.startsWith("-") ? -1 : 1;
+    const offsetMinutes = sign * (Number(parts.offset.slice(1, 3)) * 60 + Number(parts.offset.slice(3, 5)));
+    const local = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second, Number(parts.millis));
+    return local - offsetMinutes * 60_000;
+}
+/** The engine timestamp `pick` prefers by instant, returned as given; null when none parses. */
+function pickEngineDate(values, pick) {
+    let best = null;
+    for (const value of values) {
+        // absent values never parse
+        if (typeof value !== "string")
+            continue;
+        const millis = engineDateMillis(value);
+        if (millis !== null && (best === null || pick(millis, best.millis)))
+            best = { value, millis };
+    }
+    return best?.value ?? null;
+}
+/** The newest of the given engine timestamps by instant (as given); null when none parses. */
+export function latestEngineDate(values) {
+    return pickEngineDate(values, (candidate, best) => candidate > best);
+}
+/** The oldest of the given engine timestamps by instant (as given); null when none parses. */
+export function earliestEngineDate(values) {
+    return pickEngineDate(values, (candidate, best) => candidate < best);
+}
+/** RFC 822 offsets (`+0200`) as ISO offsets (`+02:00`), which every Date parser accepts. */
+const RFC822_OFFSET = /([+-]\d{2})(\d{2})$/;
+/**
+ * Milliseconds of an engine timestamp (`2024-05-01T10:00:00.000+0200`), or undefined. Read by
+ * `Date.parse`: unlike {@link engineDateMillis} it also reads a time without an offset (in the
+ * local zone).
+ */
+export function engineTime(value) {
+    if (value === undefined)
+        return undefined;
+    const time = Date.parse(value.replace(RFC822_OFFSET, "$1:$2"));
+    return Number.isNaN(time) ? undefined : time;
+}
+/** An instant in the engine format, in UTC: `2024-05-01T08:00:00.000+0000`. */
+export function engineFormat(ms) {
+    return new Date(ms).toISOString().replace("Z", "+0000");
+}
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

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

package/dist/durations.d.ts

@@ -0,0 +1,4 @@
+/** Durations as the workflow messages print them. Pure. */
+/** The duration in its largest exact unit: 90000 → `90s`, 120000 → `2m`, 1500 → `1500ms`. */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=durations.d.ts.map

package/dist/durations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durations.d.ts","sourceRoot":"","sources":["../src/durations.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAS3D,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/dist/durations.js

@@ -0,0 +1,10 @@
+/** Durations as the workflow messages print them. Pure. */
+const UNITS = { ms: 1, s: 1000, m: 60_000, h: 3_600_000 };
+/** The largest unit first: `formatDuration` prints the largest exact one. */
+const LARGEST_FIRST = ["h", "m", "s"];
+/** The duration in its largest exact unit: 90000 → `90s`, 120000 → `2m`, 1500 → `1500ms`. */
+export function formatDuration(ms) {
+    const unit = LARGEST_FIRST.find((candidate) => ms % UNITS[candidate] === 0);
+    return unit === undefined ? `${ms}ms` : `${ms / UNITS[unit]}${unit}`;
+}
+//# sourceMappingURL=durations.js.map

package/dist/durations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durations.js","sourceRoot":"","sources":["../src/durations.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAW,CAAA;AAIlE,6EAA6E;AAC7E,MAAM,aAAa,GAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAEtD,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3E,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAA;AACtE,CAAC"}

package/dist/engine-status.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The status triage of one engine in one call. Round 1 loads version, statistics, incidents,
+ * external tasks, jobs, tasks and batches in parallel, round 2 the root cause of each incident
+ * group shown; the findings name their next step.
+ */
+import { type EngineStatus, type Finding } from "./findings.js";
+import { type EnginePort, type PlannedRequest } from "./port.js";
+import { type DefinitionStatus, type GroupStep, type IncidentGroup, type JobStatus, type TopicStatus } from "./status.js";
+export interface StatusOptions {
+    /** Process definition keys to look at; empty for the whole engine. */
+    readonly keys: readonly string[];
+    /**
+     * How long an executable job or a waiting external task may wait before it is a finding;
+     * `STALE_AFTER_MS` when left out.
+     */
+    readonly staleAfterMs?: number;
+    /** Incident groups shown (with their root cause) at most; `MAX_GROUPS` when left out. */
+    readonly maxGroups?: number;
+    /** The tie-break of equal incident groups; `defaultGroupOrder` when left out. */
+    readonly compareGroupSteps?: (left: GroupStep, right: GroupStep) => number;
+}
+/** The status of one engine; `next` steps structured, the engine without its address. */
+export interface StatusData {
+    readonly engine: {
+        readonly version: string | null;
+        readonly latencyMs: number;
+    };
+    readonly status: EngineStatus;
+    readonly findings: readonly Finding[];
+    readonly definitions: readonly DefinitionStatus[];
+    readonly incidents: readonly IncidentGroup[];
+    readonly incidentsTotal: number;
+    readonly propagated: number;
+    readonly externalTasks: readonly TopicStatus[];
+    readonly jobs: JobStatus;
+    readonly tasks: {
+        readonly open: number;
+    };
+    readonly batches?: {
+        readonly running: number;
+        readonly withFailures: number;
+    };
+    readonly truncated?: readonly string[];
+}
+export interface StatusDeps {
+    readonly port: EnginePort;
+    readonly now: () => number;
+}
+/** The requests of round 1, as a preview shows them (lists with their first page). */
+export declare function statusRequests(options: StatusOptions, now: number): PlannedRequest[];
+/**
+ * The status of the engine behind `deps.port`: findings with their severity, the overall status,
+ * definitions, incident groups with their root cause, topics, jobs, tasks and batches; every cut
+ * named in `truncated`. Reads `deps.now` once at the start and twice around the version request.
+ */
+export declare function readStatus(deps: StatusDeps, statusOptions: StatusOptions): Promise<StatusData>;
+//# sourceMappingURL=engine-status.d.ts.map

package/dist/engine-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-status.d.ts","sourceRoot":"","sources":["../src/engine-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAA0B,MAAM,eAAe,CAAA;AAEvF,OAAO,EAAE,KAAK,UAAU,EAAY,KAAK,cAAc,EAAyB,MAAM,WAAW,CAAA;AAIjG,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,SAAS,EAEd,KAAK,aAAa,EAClB,KAAK,SAAS,EAEd,KAAK,WAAW,EAGjB,MAAM,aAAa,CAAA;AAQpB,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,KAAK,MAAM,CAAA;CAC3E;AAaD,yFAAyF;AACzF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;QAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAC3B,CAAA;IACD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAA;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,SAAS,WAAW,EAAE,CAAA;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAA;CAC3B;AA6DD,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAcpF;AAiGD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,UAAU,CAAC,CAwCrB"}

package/dist/engine-status.js

@@ -0,0 +1,193 @@
+/**
+ * The status triage of one engine in one call. Round 1 loads version, statistics, incidents,
+ * external tasks, jobs, tasks and batches in parallel, round 2 the root cause of each incident
+ * group shown; the findings name their next step.
+ */
+import { EXECUTABLE } from "./conditions.js";
+import { findings, engineStatus } from "./findings.js";
+import { incidentCause } from "./inspect.js";
+import { PARALLEL, pageQuery } from "./port.js";
+import { engineFormat } from "./dates.js";
+import { amount, countOf, records, str } from "./records.js";
+import { queryInput } from "./requests.js";
+import { definitionStatus, groupIncidents, jobStatus, topicStatus, unknownKeys, } from "./status.js";
+import { compact, mapLimit, omit } from "./util.js";
+/** How long an executable job or a waiting external task may wait by default: 5 minutes. */
+const STALE_AFTER_MS = 300_000;
+/** Incident groups shown (with their root cause) by default. */
+const MAX_GROUPS = 10;
+function resolved(options) {
+    return {
+        ...options,
+        staleAfterMs: options.staleAfterMs ?? STALE_AFTER_MS,
+        maxGroups: options.maxGroups ?? MAX_GROUPS,
+    };
+}
+/** Incidents and external tasks loaded at most. */
+const LIST_CAP = 2000;
+const STALE_JOBS = 1000;
+const BATCHES = 100;
+const PAGE = 500;
+function request(operationId, query = {}) {
+    return { operationId, input: queryInput(query) };
+}
+function requests(options, now) {
+    const keyIn = options.keys.length > 0 ? options.keys.join(",") : undefined;
+    const filter = { processDefinitionKeyIn: keyIn };
+    const perKey = options.keys.length > 0 ? options.keys : [undefined];
+    const createTimes = `lt_${engineFormat(now - options.staleAfterMs)}`;
+    return {
+        version: request("getRestAPIVersion"),
+        statistics: request("getProcessDefinitionStatistics", {
+            failedJobs: "true",
+            rootIncidents: "true",
+        }),
+        incidentCount: request("getIncidentsCount", filter),
+        externalTaskCount: request("getExternalTasksCount", filter),
+        taskCount: request("getTasksCount", filter),
+        incidents: { sortBy: "incidentTimestamp", sortOrder: "desc", ...filter },
+        externalTasks: filter,
+        jobCounts: perKey.map((key) => request("getJobsCount", { ...EXECUTABLE, processDefinitionKey: key })),
+        staleJobs: perKey.map((key) => request("getJobs", {
+            ...EXECUTABLE,
+            createTimes,
+            maxResults: String(STALE_JOBS),
+            processDefinitionKey: key,
+        })),
+        ...compact({
+            batches: keyIn === undefined
+                ? request("getBatchStatistics", { maxResults: String(BATCHES) })
+                : undefined,
+        }),
+    };
+}
+/** The requests of round 1, as a preview shows them (lists with their first page). */
+export function statusRequests(options, now) {
+    const all = requests(resolved(options), now);
+    return [
+        all.version,
+        all.statistics,
+        request("getIncidents", pageQuery(all.incidents, 0, PAGE)),
+        all.incidentCount,
+        request("getExternalTasks", pageQuery(all.externalTasks, 0, PAGE)),
+        all.externalTaskCount,
+        ...all.jobCounts,
+        ...all.staleJobs,
+        all.taskCount,
+        ...(all.batches === undefined ? [] : [all.batches]),
+    ];
+}
+async function value(port, planned) {
+    return port.json(planned.operationId, planned.input);
+}
+async function timedVersion(deps, planned) {
+    const started = deps.now();
+    const version = await value(deps.port, planned);
+    return {
+        version: str(records([version])[0], "version") ?? null,
+        latencyMs: deps.now() - started,
+    };
+}
+async function roundOne(deps, all) {
+    const { port } = deps;
+    const counts = (list) => Promise.all(list.map(async (planned) => countOf(await value(port, planned))));
+    const [version, statistics, incidents, incidentCount, externalTasks, externalTaskCount, jobCounts, staleJobs, openTasks, batches,] = await Promise.all([
+        timedVersion(deps, all.version),
+        value(port, all.statistics),
+        port.list("getIncidents", all.incidents, LIST_CAP),
+        value(port, all.incidentCount),
+        port.list("getExternalTasks", all.externalTasks, LIST_CAP),
+        value(port, all.externalTaskCount),
+        counts(all.jobCounts),
+        Promise.all(all.staleJobs.map(async (planned) => records(await value(port, planned)))),
+        value(port, all.taskCount),
+        all.batches === undefined ? undefined : value(port, all.batches),
+    ]);
+    return {
+        ...version,
+        statistics: records(statistics),
+        incidents,
+        incidentCount: countOf(incidentCount),
+        externalTasks,
+        externalTaskCount: countOf(externalTaskCount),
+        executableJobs: jobCounts.reduce((sum, count) => sum + count, 0),
+        staleJobs: staleJobs.flat(),
+        // a key's page that reached the cap may hide more overdue jobs, whatever the other keys hold
+        staleJobsCut: staleJobs.some((page) => page.length >= STALE_JOBS),
+        openTasks: countOf(openTasks),
+        ...compact({ batches: batches === undefined ? undefined : records(batches) }),
+    };
+}
+function truncation(data, groups, options) {
+    const notes = [];
+    if (data.incidents.truncated)
+        notes.push(`incidents: ${data.incidents.items.length} of ${data.incidentCount} loaded`);
+    if (data.externalTasks.truncated)
+        notes.push(`externalTasks: ${data.externalTasks.items.length} of ${data.externalTaskCount} loaded`);
+    if (data.staleJobsCut)
+        notes.push(`jobs: the first ${STALE_JOBS} overdue candidates loaded`);
+    if (groups > options.maxGroups)
+        notes.push(`incident groups: ${options.maxGroups} of ${groups} shown`);
+    return notes;
+}
+/**
+ * Round 2: the incident groups (without the failed jobs of batches, which BATCH_FAILURES reports)
+ * and the root cause of each group shown.
+ */
+async function incidentGroups(port, data, options) {
+    const failedBatches = (data.batches ?? []).filter((batch) => amount(batch, "failedJobs") > 0);
+    const grouped = groupIncidents(data.incidents.items, data.statistics, new Set(failedBatches.flatMap((batch) => str(batch, "batchJobDefinitionId") ?? [])), options.compareGroupSteps);
+    const shown = grouped.groups.slice(0, options.maxGroups);
+    const causes = await mapLimit(shown, PARALLEL, (group) => incidentCause(port, group.newest, false));
+    const incidents = shown.map((group, index) => ({
+        ...omit(group, "newest"),
+        ...compact({ rootCause: causes[index]?.rootCause }),
+    }));
+    return { grouped, incidents };
+}
+/**
+ * The status of the engine behind `deps.port`: findings with their severity, the overall status,
+ * definitions, incident groups with their root cause, topics, jobs, tasks and batches; every cut
+ * named in `truncated`. Reads `deps.now` once at the start and twice around the version request.
+ */
+export async function readStatus(deps, statusOptions) {
+    const options = resolved(statusOptions);
+    const now = deps.now();
+    const data = await roundOne(deps, requests(options, now));
+    const { grouped, incidents } = await incidentGroups(deps.port, data, options);
+    const externalTasks = topicStatus(data.externalTasks.items, now);
+    const jobs = jobStatus(data.executableJobs, data.staleJobs, now - options.staleAfterMs);
+    const batches = data.batches ?? [];
+    const list = findings({
+        jobs,
+        incidents,
+        externalTasks,
+        batches,
+        unknownKeys: unknownKeys(data.statistics, options.keys),
+        staleAfterMs: options.staleAfterMs,
+        now,
+    });
+    const notes = truncation(data, grouped.groups.length, options);
+    return {
+        engine: { version: data.version, latencyMs: data.latencyMs },
+        status: engineStatus(list),
+        findings: list,
+        definitions: definitionStatus(data.statistics, options.keys),
+        incidents,
+        incidentsTotal: data.incidentCount,
+        propagated: grouped.propagated,
+        externalTasks,
+        jobs,
+        tasks: { open: data.openTasks },
+        ...compact({
+            batches: data.batches === undefined
+                ? undefined
+                : {
+                    running: batches.length,
+                    withFailures: batches.filter((batch) => amount(batch, "failedJobs") > 0).length,
+                },
+            truncated: notes.length > 0 ? notes : undefined,
+        }),
+    };
+}
+//# sourceMappingURL=engine-status.js.map

package/dist/engine-status.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,101 @@
+/**
+ * The errors of the workflow domain: a structured reason, never a message to show. A caller
+ * renders each reason in its own words (the CLI's flags and commands, the MCP tools' parameter
+ * names).
+ */
+import type { AdvanceOption, Candidate, InstanceState, Selection, WaitKind, WaitState } from "./types.js";
+/** Why a workflow refused or failed, with what a message about it needs. */
+export type WorkflowErrorReason = 
+/** An id together with filters or `latest`. */
+{
+    readonly kind: "selection-conflict";
+}
+/** Neither an id nor a filter; `latest` tells whether `latest` was given alone. */
+ | {
+    readonly kind: "selection-missing";
+    readonly latest: boolean;
+} | {
+    readonly kind: "selection-not-found";
+    readonly selection: Selection;
+}
+/** The first 10 merged candidates, in order; `more` when the engine had more matches. */
+ | {
+    readonly kind: "selection-ambiguous";
+    readonly selection: Selection;
+    readonly candidates: readonly Candidate[];
+    readonly more: boolean;
+}
+/** `latest` among several running instances without a history to order them. */
+ | {
+    readonly kind: "latest-needs-history";
+} | {
+    readonly kind: "instance-missing";
+    readonly id: string;
+} | {
+    readonly kind: "condition-invalid";
+    readonly raw: string;
+    readonly forms: readonly string[];
+} | {
+    readonly kind: "retry-selection-conflict";
+} | {
+    readonly kind: "retry-selection-missing";
+} | {
+    readonly kind: "retry-too-many";
+    readonly max: number;
+    readonly processDefinitionKey?: string;
+} | {
+    readonly kind: "advance-input";
+    readonly rule: "bpmn-error-excludes-fail" | "error-message-needs-bpmn-error" | "retries-need-fail";
+} | {
+    readonly kind: "advance-ended";
+    readonly id: string;
+    readonly state: InstanceState;
+} | {
+    readonly kind: "advance-suspended";
+    readonly id: string;
+}
+/**
+ * Nothing to move (at `activityId`): `waiting` are the advanceable wait states, `conditional`
+ * tells a conditional event, `firstChildId` the first called instance of a cut tree.
+ */
+ | {
+    readonly kind: "advance-nothing";
+    readonly id: string;
+    readonly activityId?: string;
+    readonly waiting: readonly {
+        readonly activityId: string;
+        readonly kind: WaitKind;
+    }[];
+    readonly conditional: boolean;
+    readonly firstChildId?: string;
+}
+/** Several wait states could move: `waits` in the order of the view. */
+ | {
+    readonly kind: "advance-ambiguous";
+    readonly id: string;
+    readonly waits: readonly WaitState[];
+}
+/** `appliesTo`: the wait kinds the option applies to, in the order the rule lists them. */
+ | {
+    readonly kind: "advance-option-kind";
+    readonly option: AdvanceOption;
+    readonly appliesTo: readonly WaitKind[];
+    readonly activityId: string;
+    readonly waitKind: WaitKind;
+} | {
+    readonly kind: "advance-job-suspended";
+    readonly jobId: string;
+    readonly activityId: string;
+} | {
+    readonly kind: "advance-locked";
+    readonly externalTaskId: string;
+    readonly workerId: string;
+    readonly lockExpirationTime?: string;
+};
+/** A refusal or failure of the workflow domain; its message is the reason's kind. */
+export declare class WorkflowError extends Error {
+    readonly reason: WorkflowErrorReason;
+    constructor(reason: WorkflowErrorReason);
+}
+export declare function isWorkflowError(error: unknown): error is WorkflowError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,18 @@
+/**
+ * The errors of the workflow domain: a structured reason, never a message to show. A caller
+ * renders each reason in its own words (the CLI's flags and commands, the MCP tools' parameter
+ * names).
+ */
+/** A refusal or failure of the workflow domain; its message is the reason's kind. */
+export class WorkflowError extends Error {
+    reason;
+    constructor(reason) {
+        super(reason.kind);
+        this.name = "WorkflowError";
+        this.reason = reason;
+    }
+}
+export function isWorkflowError(error) {
+    return error instanceof WorkflowError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkFH,qFAAqF;AACrF,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,MAAM,CAAqB;IAEpC,YAAY,MAA2B;QACrC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAA;AACvC,CAAC"}