@mastra/factory 0.2.2-alpha.0 → 0.2.2-alpha.2

package/dist/storage/domains/work-items/metrics.js

@@ -1,203 +1,221 @@
-// src/storage/domains/work-items/base.ts
-import { createHash } from "crypto";
-import { FactoryStorageDomain, UniqueViolationError } from "@mastra/core/storage";
-var AUTOMATION_ACTORS = /* @__PURE__ */ new Set([
-  "factory",
-  "system",
-  "automation",
-  "factory-rule-dispatcher",
-  "factory-tool-result-rule"
-]);
-function isAutomationActor(by) {
-  if (by === void 0) return false;
-  return AUTOMATION_ACTORS.has(by) || by.startsWith("agent:") || by.startsWith("github:");
-}
-
-// src/storage/domains/work-items/metrics.ts
-var DEFAULT_METRICS_WINDOW = 30;
-var MAX_METRICS_WINDOW = 366;
-var DAY_MS = 864e5;
-var DONE_STAGE = "done";
-var CANCELED_STAGE = "canceled";
-var TERMINAL_STAGES = /* @__PURE__ */ new Set([DONE_STAGE, CANCELED_STAGE]);
-var AGING_WIP_LIMIT = 10;
-var DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
-var ZONED_DATETIME_RE = /(?:[Zz]|[+-]\d{2}:?\d{2})$/;
+import { isAutomationActor } from "./base.js";
+//#region src/storage/domains/work-items/metrics.ts
+/**
+* Aggregation math for the Factory Metrics page.
+*
+* Pure functions over `work_items` rows — flow metrics (throughput, cycle
+* time, stage durations, WIP, aging WIP) plus demand mix, all derived from the
+* server-appended `stageHistory` log. Keeping this DB-free makes the math unit
+* testable and lets the route stay a thin shell.
+*/
+/** Default window span (days) when the request omits or malforms the range. */
+const DEFAULT_METRICS_WINDOW = 30;
+/** Hard cap on the range span (days) — bounds the gap-filled throughput array. */
+const MAX_METRICS_WINDOW = 366;
+const DAY_MS = 864e5;
+/** Terminal stage — items here count as completed, not in-flight. */
+const DONE_STAGE = "done";
+/** Terminal stage for tracked non-completions — never a completion. */
+const CANCELED_STAGE = "canceled";
+/**
+* Terminal stages — items holding only these are not in-flight. `done` is a
+* completion (feeds throughput/cycle time); `canceled` is a tracked
+* non-completion outcome and feeds neither.
+*/
+const TERMINAL_STAGES = /* @__PURE__ */ new Set([DONE_STAGE, CANCELED_STAGE]);
+const AGING_WIP_LIMIT = 10;
+const DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
+/** Datetime carrying an explicit `Z` or `±HH:MM` offset. */
+const ZONED_DATETIME_RE = /(?:[Zz]|[+-]\d{2}:?\d{2})$/;
 function parseRangeParam(value, boundary) {
-  if (typeof value !== "string" || value.length === 0) return void 0;
-  const dateOnly = DATE_ONLY_RE.test(value);
-  if (!dateOnly && !ZONED_DATETIME_RE.test(value)) return void 0;
-  const time = Date.parse(value);
-  if (Number.isNaN(time)) return void 0;
-  return boundary === "to" && dateOnly ? time + DAY_MS : time;
+	if (typeof value !== "string" || value.length === 0) return void 0;
+	const dateOnly = DATE_ONLY_RE.test(value);
+	if (!dateOnly && !ZONED_DATETIME_RE.test(value)) return void 0;
+	const time = Date.parse(value);
+	if (Number.isNaN(time)) return void 0;
+	return boundary === "to" && dateOnly ? time + DAY_MS : time;
 }
 function utcDayStart(time) {
-  return Date.parse(`${utcDay(time)}T00:00:00Z`);
+	return Date.parse(`${utcDay(time)}T00:00:00Z`);
 }
+/**
+* Resolve untrusted `from`/`to` into a bounded half-open UTC window. A date-only
+* `to` covers the whole day; an open/future end resolves to the end of the
+* current UTC day (not `now`) so an event at this instant stays inside the
+* window instead of on its excluded edge.
+*/
 function parseMetricsRange(fromParam, toParam, now) {
-  const nowMs = now.getTime();
-  const endOfToday = utcDayStart(nowMs) + DAY_MS;
-  const requestedEnd = parseRangeParam(toParam, "to") ?? endOfToday;
-  const windowEnd = Math.min(requestedEnd, endOfToday);
-  const lastIncludedDay = utcDayStart(windowEnd - 1);
-  const defaultStart = lastIncludedDay - (DEFAULT_METRICS_WINDOW - 1) * DAY_MS;
-  const parsedFrom = parseRangeParam(fromParam, "from");
-  let windowStart = parsedFrom !== void 0 && parsedFrom < windowEnd ? parsedFrom : defaultStart;
-  const earliestStart = lastIncludedDay - (MAX_METRICS_WINDOW - 1) * DAY_MS;
-  if (windowStart < earliestStart) windowStart = earliestStart;
-  return { windowStart, windowEnd };
+	const endOfToday = utcDayStart(now.getTime()) + DAY_MS;
+	const requestedEnd = parseRangeParam(toParam, "to") ?? endOfToday;
+	const windowEnd = Math.min(requestedEnd, endOfToday);
+	const lastIncludedDay = utcDayStart(windowEnd - 1);
+	const defaultStart = lastIncludedDay - 29 * DAY_MS;
+	const parsedFrom = parseRangeParam(fromParam, "from");
+	let windowStart = parsedFrom !== void 0 && parsedFrom < windowEnd ? parsedFrom : defaultStart;
+	const earliestStart = lastIncludedDay - 365 * DAY_MS;
+	if (windowStart < earliestStart) windowStart = earliestStart;
+	return {
+		windowStart,
+		windowEnd
+	};
 }
 function parseTime(iso) {
-  const time = Date.parse(iso);
-  return Number.isNaN(time) ? 0 : time;
+	const time = Date.parse(iso);
+	return Number.isNaN(time) ? 0 : time;
 }
+/** Nearest-rank percentile over an unsorted sample list. */
 function percentile(samples, fraction) {
-  if (samples.length === 0) return null;
-  const sorted = [...samples].sort((a, b) => a - b);
-  const rank = Math.max(1, Math.ceil(fraction * sorted.length));
-  return sorted[rank - 1];
+	if (samples.length === 0) return null;
+	const sorted = [...samples].sort((a, b) => a - b);
+	return sorted[Math.max(1, Math.ceil(fraction * sorted.length)) - 1];
 }
+/** UTC `YYYY-MM-DD` for a timestamp. */
 function utcDay(time) {
-  return new Date(time).toISOString().slice(0, 10);
+	return new Date(time).toISOString().slice(0, 10);
 }
+/**
+* The item's completion time: the `enteredAt` of its still-open `done` entry.
+* `undefined` when the item isn't currently done (including when it was pulled
+* back out of done — that visit has `exitedAt` and doesn't count).
+*/
 function completedAt(item) {
-  if (!item.stages.includes(DONE_STAGE)) return void 0;
-  for (let i = item.stageHistory.length - 1; i >= 0; i--) {
-    const entry = item.stageHistory[i];
-    if (entry.stage === DONE_STAGE && entry.exitedAt === void 0) return parseTime(entry.enteredAt);
-  }
-  return void 0;
+	if (!item.stages.includes(DONE_STAGE)) return void 0;
+	for (let i = item.stageHistory.length - 1; i >= 0; i--) {
+		const entry = item.stageHistory[i];
+		if (entry.stage === DONE_STAGE && entry.exitedAt === void 0) return parseTime(entry.enteredAt);
+	}
 }
+/** Open (no `exitedAt`) history entry for a currently-held non-terminal stage. */
 function openEntries(item) {
-  return item.stageHistory.filter(
-    (entry) => entry.exitedAt === void 0 && !TERMINAL_STAGES.has(entry.stage) && item.stages.includes(entry.stage)
-  );
+	return item.stageHistory.filter((entry) => entry.exitedAt === void 0 && !TERMINAL_STAGES.has(entry.stage) && item.stages.includes(entry.stage));
 }
 function computeFactoryMetrics(items, opts) {
-  const { windowStart, windowEnd } = opts;
-  let earliest = Infinity;
-  for (const item of items) earliest = Math.min(earliest, item.createdAt.getTime());
-  const earliestItemAt = Number.isFinite(earliest) ? new Date(earliest).toISOString() : null;
-  const throughputByDay = /* @__PURE__ */ new Map();
-  const firstDay = utcDayStart(windowStart);
-  for (let day = firstDay; day < windowEnd; day += DAY_MS) {
-    throughputByDay.set(utcDay(day), 0);
-  }
-  const cycleSamples = [];
-  for (const item of items) {
-    const doneAt = completedAt(item);
-    if (doneAt === void 0 || doneAt < windowStart || doneAt >= windowEnd) continue;
-    const day = utcDay(doneAt);
-    throughputByDay.set(day, (throughputByDay.get(day) ?? 0) + 1);
-    cycleSamples.push(Math.max(0, doneAt - item.createdAt.getTime()));
-  }
-  const durationsByStage = /* @__PURE__ */ new Map();
-  for (const item of items) {
-    for (const entry of item.stageHistory) {
-      if (entry.exitedAt === void 0 || TERMINAL_STAGES.has(entry.stage)) continue;
-      const exited = parseTime(entry.exitedAt);
-      if (exited < windowStart || exited >= windowEnd) continue;
-      const duration = Math.max(0, exited - parseTime(entry.enteredAt));
-      const samples = durationsByStage.get(entry.stage) ?? [];
-      samples.push(duration);
-      durationsByStage.set(entry.stage, samples);
-    }
-  }
-  const wipByStage = /* @__PURE__ */ new Map();
-  let wipTotal = 0;
-  const aging = [];
-  for (const item of items) {
-    for (const stage of item.stages) {
-      wipByStage.set(stage, (wipByStage.get(stage) ?? 0) + 1);
-    }
-    const inFlightStages = item.stages.filter((stage) => !TERMINAL_STAGES.has(stage));
-    if (inFlightStages.length === 0) continue;
-    wipTotal += 1;
-    const open = openEntries(item);
-    const oldest = open.reduce(
-      (best, entry) => !best || parseTime(entry.enteredAt) < parseTime(best.enteredAt) ? entry : best,
-      void 0
-    );
-    aging.push({
-      id: item.id,
-      title: item.title,
-      stage: oldest?.stage ?? inFlightStages[0],
-      enteredAt: oldest?.enteredAt ?? item.createdAt.toISOString(),
-      url: item.externalSource?.url ?? null
-    });
-  }
-  aging.sort((a, b) => parseTime(a.enteredAt) - parseTime(b.enteredAt));
-  const sourceCounts = /* @__PURE__ */ new Map();
-  let transitionsTotal = 0;
-  let transitionsHuman = 0;
-  for (const item of items) {
-    if (item.createdAt.getTime() >= windowStart && item.createdAt.getTime() < windowEnd) {
-      const source = item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : "manual";
-      sourceCounts.set(source, (sourceCounts.get(source) ?? 0) + 1);
-    }
-    for (const entry of item.stageHistory) {
-      const entered = parseTime(entry.enteredAt);
-      if (entered < windowStart || entered >= windowEnd) continue;
-      transitionsTotal += 1;
-      if (!isAutomationActor(entry.by)) transitionsHuman += 1;
-    }
-  }
-  const automationByStage = /* @__PURE__ */ new Map();
-  for (const item of items) {
-    const itemDone = completedAt(item) !== void 0;
-    const itemCanceled = item.stages.includes(CANCELED_STAGE);
-    for (let i = 0; i < item.stageHistory.length; i++) {
-      const entry = item.stageHistory[i];
-      if (entry.exitedAt === void 0 || TERMINAL_STAGES.has(entry.stage)) continue;
-      const exited = parseTime(entry.exitedAt);
-      if (exited < windowStart || exited >= windowEnd) continue;
-      let row = automationByStage.get(entry.stage);
-      if (!row) {
-        row = {
-          stage: entry.stage,
-          exits: 0,
-          automated: 0,
-          outcomes: { done: 0, canceled: 0, reworked: 0, inFlight: 0 }
-        };
-        automationByStage.set(entry.stage, row);
-      }
-      row.exits += 1;
-      const firstVisitIndex = item.stageHistory.findIndex((e) => e.stage === entry.stage);
-      if (firstVisitIndex !== i || !isAutomationActor(entry.by) || !isAutomationActor(entry.exitedBy)) continue;
-      row.automated += 1;
-      const reworked = item.stageHistory.some((e, j) => j > i && e.stage === entry.stage);
-      if (reworked) row.outcomes.reworked += 1;
-      else if (itemDone) row.outcomes.done += 1;
-      else if (itemCanceled) row.outcomes.canceled += 1;
-      else row.outcomes.inFlight += 1;
-    }
-  }
-  return {
-    windowDays: throughputByDay.size,
-    earliestItemAt,
-    throughput: [...throughputByDay.entries()].map(([date, count]) => ({ date, count })).sort((a, b) => a.date.localeCompare(b.date)),
-    cycleTime: {
-      medianMs: percentile(cycleSamples, 0.5),
-      p90Ms: percentile(cycleSamples, 0.9),
-      samples: cycleSamples.length
-    },
-    stageDurations: [...durationsByStage.entries()].map(([stage, samples]) => ({
-      stage,
-      medianMs: percentile(samples, 0.5),
-      samples: samples.length
-    })),
-    wip: [...wipByStage.entries()].map(([stage, count]) => ({ stage, count })),
-    wipTotal,
-    agingWip: aging.slice(0, AGING_WIP_LIMIT),
-    sourceMix: [...sourceCounts.entries()].map(([source, count]) => ({ source, count })).sort((a, b) => b.count - a.count),
-    transitions: { human: transitionsHuman, total: transitionsTotal },
-    stageAutomation: [...automationByStage.values()]
-  };
+	const { windowStart, windowEnd } = opts;
+	let earliest = Infinity;
+	for (const item of items) earliest = Math.min(earliest, item.createdAt.getTime());
+	const earliestItemAt = Number.isFinite(earliest) ? new Date(earliest).toISOString() : null;
+	const throughputByDay = /* @__PURE__ */ new Map();
+	const firstDay = utcDayStart(windowStart);
+	for (let day = firstDay; day < windowEnd; day += DAY_MS) throughputByDay.set(utcDay(day), 0);
+	const cycleSamples = [];
+	for (const item of items) {
+		const doneAt = completedAt(item);
+		if (doneAt === void 0 || doneAt < windowStart || doneAt >= windowEnd) continue;
+		const day = utcDay(doneAt);
+		throughputByDay.set(day, (throughputByDay.get(day) ?? 0) + 1);
+		cycleSamples.push(Math.max(0, doneAt - item.createdAt.getTime()));
+	}
+	const durationsByStage = /* @__PURE__ */ new Map();
+	for (const item of items) for (const entry of item.stageHistory) {
+		if (entry.exitedAt === void 0 || TERMINAL_STAGES.has(entry.stage)) continue;
+		const exited = parseTime(entry.exitedAt);
+		if (exited < windowStart || exited >= windowEnd) continue;
+		const duration = Math.max(0, exited - parseTime(entry.enteredAt));
+		const samples = durationsByStage.get(entry.stage) ?? [];
+		samples.push(duration);
+		durationsByStage.set(entry.stage, samples);
+	}
+	const wipByStage = /* @__PURE__ */ new Map();
+	let wipTotal = 0;
+	const aging = [];
+	for (const item of items) {
+		for (const stage of item.stages) wipByStage.set(stage, (wipByStage.get(stage) ?? 0) + 1);
+		const inFlightStages = item.stages.filter((stage) => !TERMINAL_STAGES.has(stage));
+		if (inFlightStages.length === 0) continue;
+		wipTotal += 1;
+		const oldest = openEntries(item).reduce((best, entry) => !best || parseTime(entry.enteredAt) < parseTime(best.enteredAt) ? entry : best, void 0);
+		aging.push({
+			id: item.id,
+			title: item.title,
+			stage: oldest?.stage ?? inFlightStages[0],
+			enteredAt: oldest?.enteredAt ?? item.createdAt.toISOString(),
+			url: item.externalSource?.url ?? null
+		});
+	}
+	aging.sort((a, b) => parseTime(a.enteredAt) - parseTime(b.enteredAt));
+	const sourceCounts = /* @__PURE__ */ new Map();
+	let transitionsTotal = 0;
+	let transitionsHuman = 0;
+	for (const item of items) {
+		if (item.createdAt.getTime() >= windowStart && item.createdAt.getTime() < windowEnd) {
+			const source = item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : "manual";
+			sourceCounts.set(source, (sourceCounts.get(source) ?? 0) + 1);
+		}
+		for (const entry of item.stageHistory) {
+			const entered = parseTime(entry.enteredAt);
+			if (entered < windowStart || entered >= windowEnd) continue;
+			transitionsTotal += 1;
+			if (!isAutomationActor(entry.by)) transitionsHuman += 1;
+		}
+	}
+	const automationByStage = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const itemDone = completedAt(item) !== void 0;
+		const itemCanceled = item.stages.includes(CANCELED_STAGE);
+		for (let i = 0; i < item.stageHistory.length; i++) {
+			const entry = item.stageHistory[i];
+			if (entry.exitedAt === void 0 || TERMINAL_STAGES.has(entry.stage)) continue;
+			const exited = parseTime(entry.exitedAt);
+			if (exited < windowStart || exited >= windowEnd) continue;
+			let row = automationByStage.get(entry.stage);
+			if (!row) {
+				row = {
+					stage: entry.stage,
+					exits: 0,
+					automated: 0,
+					outcomes: {
+						done: 0,
+						canceled: 0,
+						reworked: 0,
+						inFlight: 0
+					}
+				};
+				automationByStage.set(entry.stage, row);
+			}
+			row.exits += 1;
+			if (item.stageHistory.findIndex((e) => e.stage === entry.stage) !== i || !isAutomationActor(entry.by) || !isAutomationActor(entry.exitedBy)) continue;
+			row.automated += 1;
+			if (item.stageHistory.some((e, j) => j > i && e.stage === entry.stage)) row.outcomes.reworked += 1;
+			else if (itemDone) row.outcomes.done += 1;
+			else if (itemCanceled) row.outcomes.canceled += 1;
+			else row.outcomes.inFlight += 1;
+		}
+	}
+	return {
+		windowDays: throughputByDay.size,
+		earliestItemAt,
+		throughput: [...throughputByDay.entries()].map(([date, count]) => ({
+			date,
+			count
+		})).sort((a, b) => a.date.localeCompare(b.date)),
+		cycleTime: {
+			medianMs: percentile(cycleSamples, .5),
+			p90Ms: percentile(cycleSamples, .9),
+			samples: cycleSamples.length
+		},
+		stageDurations: [...durationsByStage.entries()].map(([stage, samples]) => ({
+			stage,
+			medianMs: percentile(samples, .5),
+			samples: samples.length
+		})),
+		wip: [...wipByStage.entries()].map(([stage, count]) => ({
+			stage,
+			count
+		})),
+		wipTotal,
+		agingWip: aging.slice(0, AGING_WIP_LIMIT),
+		sourceMix: [...sourceCounts.entries()].map(([source, count]) => ({
+			source,
+			count
+		})).sort((a, b) => b.count - a.count),
+		transitions: {
+			human: transitionsHuman,
+			total: transitionsTotal
+		},
+		stageAutomation: [...automationByStage.values()]
+	};
 }
-export {
-  DEFAULT_METRICS_WINDOW,
-  MAX_METRICS_WINDOW,
-  computeFactoryMetrics,
-  parseMetricsRange
-};
+//#endregion
+export { DEFAULT_METRICS_WINDOW, MAX_METRICS_WINDOW, computeFactoryMetrics, parseMetricsRange };
+
 //# sourceMappingURL=metrics.js.map