@mastra/factory 0.0.0-aggregate-trace-20261015182851

package/dist/storage/domains/work-items/board-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-version.js","names":["#scopes"],"sources":["../../../../src/storage/domains/work-items/board-version.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { CollectionSchema, CollectionWhere, FactoryStorageOps } from '@mastra/core/storage';\n\n/**\n * One row per project whose `version` is replaced after every committed write to that project's\n * `work_items`. Readers of the full card list compare it against the version their snapshot was\n * taken at, so an unchanged board costs one indexed row read instead of every card.\n */\nexport const FACTORY_BOARD_VERSIONS_SCHEMA: CollectionSchema = {\n  name: 'factory_board_versions',\n  columns: {\n    id: { type: 'uuid-pk' },\n    org_id: { type: 'text' },\n    factory_project_id: { type: 'text' },\n    version: { type: 'text' },\n    updated_at: { type: 'timestamp' },\n  },\n  uniqueIndexes: [{ name: 'factory_board_versions_scope_unique', columns: ['org_id', 'factory_project_id'] }],\n};\n\n/** A project, or every project in an org when a write's filter only names the org. */\nexport interface BoardScope {\n  orgId: string;\n  factoryProjectId?: string;\n}\n\nconst scopeKey = (scope: BoardScope) => `${scope.orgId}\\u0000${scope.factoryProjectId ?? ''}`;\n\nfunction scopeOfRow(row: Record<string, unknown> | null): BoardScope | undefined {\n  if (!row || typeof row.org_id !== 'string') return undefined;\n  return typeof row.factory_project_id === 'string'\n    ? { orgId: row.org_id, factoryProjectId: row.factory_project_id }\n    : { orgId: row.org_id };\n}\n\nfunction scopeOfWhere(where: CollectionWhere): BoardScope | undefined {\n  if (typeof where.org_id !== 'string') return undefined;\n  return typeof where.factory_project_id === 'string'\n    ? { orgId: where.org_id, factoryProjectId: where.factory_project_id }\n    : { orgId: where.org_id };\n}\n\n/**\n * Wrap `ops` so every write to `work_items` reports the board it changed, once the write has\n * resolved. Writes outside any tenant (`dangerouslyClearAll`) report nothing.\n */\nexport function trackBoardWrites(\n  ops: FactoryStorageOps,\n  changed: (scope: BoardScope) => void | Promise<void>,\n): FactoryStorageOps {\n  const report = async (scope: BoardScope | undefined) => {\n    if (scope) await changed(scope);\n  };\n  return new Proxy(ops, {\n    get(target, property, receiver) {\n      const value = Reflect.get(target, property, receiver);\n      if (typeof value !== 'function') return value;\n      switch (property) {\n        case 'updateAtomic':\n          return async (collection: string, where: unknown, updater: (row: unknown) => unknown, ...args: unknown[]) => {\n            let patched = false;\n            const row = await value.call(\n              target,\n              collection,\n              where,\n              async (current: unknown) => {\n                const patch = await updater(current);\n                patched = patch != null;\n                return patch;\n              },\n              ...args,\n            );\n            if (collection === 'work_items' && patched) await report(scopeOfRow(row));\n            return row;\n          };\n        case 'insertOne':\n        case 'upsertOne':\n          return async (collection: string, ...args: unknown[]) => {\n            const row = await value.call(target, collection, ...args);\n            if (collection === 'work_items') await report(scopeOfRow(row));\n            return row;\n          };\n        case 'updateMany':\n        case 'deleteMany':\n          return async (collection: string, where: CollectionWhere, ...args: unknown[]) => {\n            const count: number = await value.call(target, collection, where, ...args);\n            if (collection === 'work_items' && count > 0) await report(scopeOfWhere(where));\n            return count;\n          };\n        default:\n          return value.bind(target);\n      }\n    },\n  });\n}\n\n/** Collects the boards a transaction changed so they can be bumped once it has committed. */\nexport class BoardScopes {\n  readonly #scopes = new Map<string, BoardScope>();\n\n  add = (scope: BoardScope): void => {\n    this.#scopes.set(scopeKey(scope), scope);\n  };\n\n  values(): BoardScope[] {\n    return [...this.#scopes.values()];\n  }\n}\n\nexport async function bumpBoardVersions(ops: FactoryStorageOps, scopes: readonly BoardScope[]): Promise<void> {\n  for (const scope of scopes) {\n    const version = randomUUID();\n    const updated_at = new Date();\n    if (scope.factoryProjectId) {\n      await ops.upsertOne(FACTORY_BOARD_VERSIONS_SCHEMA.name, ['org_id', 'factory_project_id'], {\n        org_id: scope.orgId,\n        factory_project_id: scope.factoryProjectId,\n        version,\n        updated_at,\n      });\n    } else {\n      // Projects without a row yet have no version, which never matches a snapshot.\n      await ops.updateMany(FACTORY_BOARD_VERSIONS_SCHEMA.name, { org_id: scope.orgId }, { version, updated_at });\n    }\n  }\n}\n\nexport async function readBoardVersion(\n  ops: FactoryStorageOps,\n  orgId: string,\n  factoryProjectId: string,\n): Promise<string | undefined> {\n  const row = await ops.findOne<{ version: string }>(FACTORY_BOARD_VERSIONS_SCHEMA.name, {\n    org_id: orgId,\n    factory_project_id: factoryProjectId,\n  });\n  return row?.version;\n}\n"],"mappings":";;;;;;;AAQA,MAAa,gCAAkD;CAC7D,MAAM;CACN,SAAS;EACP,IAAI,EAAE,MAAM,UAAU;EACtB,QAAQ,EAAE,MAAM,OAAO;EACvB,oBAAoB,EAAE,MAAM,OAAO;EACnC,SAAS,EAAE,MAAM,OAAO;EACxB,YAAY,EAAE,MAAM,YAAY;CAClC;CACA,eAAe,CAAC;EAAE,MAAM;EAAuC,SAAS,CAAC,UAAU,oBAAoB;CAAE,CAAC;AAC5G;AAQA,MAAM,YAAY,UAAsB,GAAG,MAAM,MAAM,QAAQ,MAAM,oBAAoB;AAEzF,SAAS,WAAW,KAA6D;CAC/E,IAAI,CAAC,OAAO,OAAO,IAAI,WAAW,UAAU,OAAO,KAAA;CACnD,OAAO,OAAO,IAAI,uBAAuB,WACrC;EAAE,OAAO,IAAI;EAAQ,kBAAkB,IAAI;CAAmB,IAC9D,EAAE,OAAO,IAAI,OAAO;AAC1B;AAEA,SAAS,aAAa,OAAgD;CACpE,IAAI,OAAO,MAAM,WAAW,UAAU,OAAO,KAAA;CAC7C,OAAO,OAAO,MAAM,uBAAuB,WACvC;EAAE,OAAO,MAAM;EAAQ,kBAAkB,MAAM;CAAmB,IAClE,EAAE,OAAO,MAAM,OAAO;AAC5B;;;;;AAMA,SAAgB,iBACd,KACA,SACmB;CACnB,MAAM,SAAS,OAAO,UAAkC;EACtD,IAAI,OAAO,MAAM,QAAQ,KAAK;CAChC;CACA,OAAO,IAAI,MAAM,KAAK,EACpB,IAAI,QAAQ,UAAU,UAAU;EAC9B,MAAM,QAAQ,QAAQ,IAAI,QAAQ,UAAU,QAAQ;EACpD,IAAI,OAAO,UAAU,YAAY,OAAO;EACxC,QAAQ,UAAR;GACE,KAAK,gBACH,OAAO,OAAO,YAAoB,OAAgB,SAAoC,GAAG,SAAoB;IAC3G,IAAI,UAAU;IACd,MAAM,MAAM,MAAM,MAAM,KACtB,QACA,YACA,OACA,OAAO,YAAqB;KAC1B,MAAM,QAAQ,MAAM,QAAQ,OAAO;KACnC,UAAU,SAAS;KACnB,OAAO;IACT,GACA,GAAG,IACL;IACA,IAAI,eAAe,gBAAgB,SAAS,MAAM,OAAO,WAAW,GAAG,CAAC;IACxE,OAAO;GACT;GACF,KAAK;GACL,KAAK,aACH,OAAO,OAAO,YAAoB,GAAG,SAAoB;IACvD,MAAM,MAAM,MAAM,MAAM,KAAK,QAAQ,YAAY,GAAG,IAAI;IACxD,IAAI,eAAe,cAAc,MAAM,OAAO,WAAW,GAAG,CAAC;IAC7D,OAAO;GACT;GACF,KAAK;GACL,KAAK,cACH,OAAO,OAAO,YAAoB,OAAwB,GAAG,SAAoB;IAC/E,MAAM,QAAgB,MAAM,MAAM,KAAK,QAAQ,YAAY,OAAO,GAAG,IAAI;IACzE,IAAI,eAAe,gBAAgB,QAAQ,GAAG,MAAM,OAAO,aAAa,KAAK,CAAC;IAC9E,OAAO;GACT;GACF,SACE,OAAO,MAAM,KAAK,MAAM;EAC5B;CACF,EACF,CAAC;AACH;;AAGA,IAAa,cAAb,MAAyB;CACvB,0BAAmB,IAAI,IAAwB;CAE/C,OAAO,UAA4B;EACjC,KAAKA,QAAQ,IAAI,SAAS,KAAK,GAAG,KAAK;CACzC;CAEA,SAAuB;EACrB,OAAO,CAAC,GAAG,KAAKA,QAAQ,OAAO,CAAC;CAClC;AACF;AAEA,eAAsB,kBAAkB,KAAwB,QAA8C;CAC5G,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,UAAU,WAAW;EAC3B,MAAM,6BAAa,IAAI,KAAK;EAC5B,IAAI,MAAM,kBACR,MAAM,IAAI,UAAU,8BAA8B,MAAM,CAAC,UAAU,oBAAoB,GAAG;GACxF,QAAQ,MAAM;GACd,oBAAoB,MAAM;GAC1B;GACA;EACF,CAAC;OAGD,MAAM,IAAI,WAAW,8BAA8B,MAAM,EAAE,QAAQ,MAAM,MAAM,GAAG;GAAE;GAAS;EAAW,CAAC;CAE7G;AACF;AAEA,eAAsB,iBACpB,KACA,OACA,kBAC6B;CAK7B,QAAO,MAJW,IAAI,QAA6B,8BAA8B,MAAM;EACrF,QAAQ;EACR,oBAAoB;CACtB,CAAC,EAAA,EACW;AACd"}

package/dist/storage/domains/work-items/metrics.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Aggregation math for the Factory Overview page.
+ *
+ * Pure functions over `work_items` rows — throughput, lead time, in-flight
+ * count, demand mix and per-stage agent coverage, all read from the
+ * server-appended `stageHistory` log. Keeping this DB-free makes the math unit
+ * testable and lets the route stay a thin shell.
+ *
+ * Everything windowed is counted as an event that happened inside the window,
+ * never as "the state the board happens to be in now", so re-querying a past
+ * window always returns the same numbers.
+ */
+import type { WorkItemRow } from './base.js';
+/** Default window span (days) when the request omits or malforms the range. */
+export declare const DEFAULT_METRICS_WINDOW = 30;
+/** Hard cap on the range span (days) — bounds the gap-filled throughput array. */
+export declare const MAX_METRICS_WINDOW = 366;
+/**
+ * Flow metrics over the cards the Factory ran ({@link hasFactoryRun}) — synced
+ * upstream issues and PRs nobody started a run on are not the Factory's work
+ * and are excluded from every field below.
+ */
+export interface FactoryMetrics {
+    /**
+     * Days the series covers: the requested window clipped to the board's life.
+     * Days before the first card could hold no completion, so counting them would
+     * drag the per-day rate toward zero on a young board.
+     */
+    daysCovered: number;
+    /** Entries into `done` per UTC day, gap-filled across the covered days. */
+    throughput: {
+        date: string;
+        count: number;
+    }[];
+    /** Card creation → `done` for every completion that landed in the window. */
+    leadTime: {
+        medianMs: number | null;
+        p90Ms: number | null;
+        samples: number;
+    };
+    /** Distinct cards in a pipeline stage — past intake, not yet terminal. */
+    wipTotal: number;
+    /** Cards created in the window, by source. */
+    sourceMix: {
+        source: string;
+        count: number;
+    }[];
+    /** Per-stage agent coverage over first visits that ended in the window. */
+    agentCoverage: {
+        stage: string;
+        /**
+         * First visits to this stage that ended in the window. Repeat visits are
+         * excluded from both sides: they are rework, already reported as such, and
+         * counting them in the denominator alone caps a fully agent-run stage below
+         * 100%.
+         */
+        passes: number;
+        /**
+         * Of those: passes an agent finished (`exitedBy` is an agent actor). The
+         * entry actor is not required — the rules engine is what queues a card into
+         * a stage, so demanding both ends would report 0% for stages agents run
+         * end to end. Missing `exitedBy` (entries written before exit stamping)
+         * does not count.
+         */
+        byAgent: number;
+        /**
+         * Outcomes of the agent-finished passes' items as of the window's end,
+         * mutually exclusive, first match wins: `reworked` (a later visit to the
+         * same stage — deliberately outranks `done`: a pass that needed a redo is a
+         * failed pass even if the item eventually merged), then `done`, then
+         * `canceled`, then `inFlight`.
+         */
+        outcomes: {
+            done: number;
+            canceled: number;
+            reworked: number;
+            inFlight: number;
+        };
+    }[];
+}
+/**
+ * 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.
+ */
+export declare function parseMetricsRange(fromParam: unknown, toParam: unknown, now: Date): {
+    windowStart: number;
+    windowEnd: number;
+};
+type Window = {
+    windowStart: number;
+    windowEnd: number;
+};
+export declare function computeFactoryMetrics(boardItems: WorkItemRow[], window: Window): FactoryMetrics;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/storage/domains/work-items/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../src/storage/domains/work-items/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAqCtC;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,6EAA6E;IAC7E,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,2EAA2E;IAC3E,aAAa,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd;;;;;WAKG;QACH,MAAM,EAAE,MAAM,CAAC;QACf;;;;;;WAMG;QACH,OAAO,EAAE,MAAM,CAAC;QAChB;;;;;;WAMG;QACH,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC;KAClF,EAAE,CAAC;CACL;AAqBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,IAAI,GACR;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAY5C;AA2CD,KAAK,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AA8FzD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAoB/F"}

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

@@ -0,0 +1,226 @@
+import { isAgentActor } from "./base.js";
+//#region src/storage/domains/work-items/metrics.ts
+/**
+* Aggregation math for the Factory Overview page.
+*
+* Pure functions over `work_items` rows — throughput, lead time, in-flight
+* count, demand mix and per-stage agent coverage, all read from the
+* server-appended `stageHistory` log. Keeping this DB-free makes the math unit
+* testable and lets the route stay a thin shell.
+*
+* Everything windowed is counted as an event that happened inside the window,
+* never as "the state the board happens to be in now", so re-querying a past
+* window always returns the same numbers.
+*/
+/** 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/lead time); `canceled` is a tracked
+* non-completion outcome and feeds neither.
+*/
+const TERMINAL_STAGES = /* @__PURE__ */ new Set([DONE_STAGE, CANCELED_STAGE]);
+const INTAKE_STAGE = "intake";
+/**
+* Pipeline work excludes the inbox as well as the terminal stages: an intake
+* card is queued, not in flight, and its pass through is the poller filing it.
+*/
+function isPipelineStage(stage) {
+	return !TERMINAL_STAGES.has(stage) && stage !== INTAKE_STAGE;
+}
+/**
+* Cards the Factory ran: starting a run records its session on the row. The
+* integrations sync every issue and PR of a connected repo into the board and
+* those outnumber the Factory's own work by an order of magnitude, so counting
+* them reports the upstream repo's flow as the Factory's.
+*/
+function hasFactoryRun(item) {
+	return Object.keys(item.sessions).length > 0;
+}
+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;
+}
+function utcDayStart(time) {
+	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 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
+	};
+}
+/** Stage history is server-appended, so an unparsable stamp is a corrupt row. */
+function parseTime(iso) {
+	const time = Date.parse(iso);
+	if (Number.isNaN(time)) throw new Error(`Unparsable stage-history timestamp: ${iso}`);
+	return time;
+}
+/** Asserted up front so a corrupt row fails every window, not just the ones that read it. */
+function assertParsableHistory(items) {
+	for (const item of items) for (const entry of item.stageHistory) {
+		parseTime(entry.enteredAt);
+		if (entry.exitedAt !== void 0) parseTime(entry.exitedAt);
+	}
+}
+/** 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);
+	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);
+}
+/** Stages the item was holding at `time`, replayed from its history. */
+function stagesHeldAt(item, time) {
+	const held = /* @__PURE__ */ new Set();
+	for (const entry of item.stageHistory) {
+		if (parseTime(entry.enteredAt) >= time) continue;
+		if (entry.exitedAt !== void 0 && parseTime(entry.exitedAt) <= time) continue;
+		held.add(entry.stage);
+	}
+	return held;
+}
+/**
+* Completions per UTC day, plus one lead-time sample each. A completion is an
+* entry *into* `done`, not the state of the card now: a card reopened today
+* must not erase the day it shipped, and a card that shipped twice shipped
+* twice. Days before the oldest card are left out rather than gap-filled with
+* zeroes that would drag the daily average down.
+*/
+function completions(items, { windowStart, windowEnd }) {
+	let earliestItem = Infinity;
+	for (const item of items) earliestItem = Math.min(earliestItem, item.createdAt.getTime());
+	const boardStart = Number.isFinite(earliestItem) ? utcDayStart(earliestItem) : -Infinity;
+	const byDay = /* @__PURE__ */ new Map();
+	for (let day = Math.max(utcDayStart(windowStart), boardStart); day < windowEnd; day += DAY_MS) byDay.set(utcDay(day), 0);
+	const leadSamples = [];
+	for (const item of items) for (const entry of item.stageHistory) {
+		if (entry.stage !== DONE_STAGE) continue;
+		const doneAt = parseTime(entry.enteredAt);
+		if (doneAt < windowStart || doneAt >= windowEnd) continue;
+		byDay.set(utcDay(doneAt), (byDay.get(utcDay(doneAt)) ?? 0) + 1);
+		leadSamples.push(Math.max(0, doneAt - item.createdAt.getTime()));
+	}
+	return {
+		byDay,
+		leadSamples
+	};
+}
+/** Cards holding at least one pipeline stage right now — window-independent. */
+function countInFlight(items) {
+	return items.filter((item) => item.stages.some(isPipelineStage)).length;
+}
+/** Where the window's cards came from, most common first. */
+function demandMix(items, { windowStart, windowEnd }) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const created = item.createdAt.getTime();
+		if (created < windowStart || created >= windowEnd) continue;
+		const source = item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : "manual";
+		counts.set(source, (counts.get(source) ?? 0) + 1);
+	}
+	return [...counts.entries()].map(([source, count]) => ({
+		source,
+		count
+	})).sort((a, b) => b.count - a.count);
+}
+/**
+* How much of each stage's work an agent finished, counting a card's first
+* visit to a stage once. Rows appear in insertion order of each stage's first
+* counted exit; only pipeline stages get rows, since intake and terminal
+* stages have no pass to hand over.
+*/
+function agentCoverage(items, { windowStart, windowEnd }) {
+	const byStage = /* @__PURE__ */ new Map();
+	for (const item of items) {
+		const heldAtWindowEnd = stagesHeldAt(item, windowEnd);
+		const visited = /* @__PURE__ */ new Set();
+		for (let i = 0; i < item.stageHistory.length; i++) {
+			const entry = item.stageHistory[i];
+			if (!isPipelineStage(entry.stage) || visited.has(entry.stage)) continue;
+			visited.add(entry.stage);
+			if (entry.exitedAt === void 0) continue;
+			const exited = parseTime(entry.exitedAt);
+			if (exited < windowStart || exited >= windowEnd) continue;
+			let row = byStage.get(entry.stage);
+			if (!row) {
+				row = {
+					stage: entry.stage,
+					passes: 0,
+					byAgent: 0,
+					outcomes: {
+						done: 0,
+						canceled: 0,
+						reworked: 0,
+						inFlight: 0
+					}
+				};
+				byStage.set(entry.stage, row);
+			}
+			row.passes += 1;
+			if (!isAgentActor(entry.exitedBy)) continue;
+			row.byAgent += 1;
+			if (item.stageHistory.some((later, j) => j > i && later.stage === entry.stage && parseTime(later.enteredAt) < windowEnd)) row.outcomes.reworked += 1;
+			else if (heldAtWindowEnd.has(DONE_STAGE)) row.outcomes.done += 1;
+			else if (heldAtWindowEnd.has(CANCELED_STAGE)) row.outcomes.canceled += 1;
+			else row.outcomes.inFlight += 1;
+		}
+	}
+	return [...byStage.values()];
+}
+function computeFactoryMetrics(boardItems, window) {
+	const items = boardItems.filter(hasFactoryRun);
+	assertParsableHistory(items);
+	const { byDay, leadSamples } = completions(items, window);
+	return {
+		daysCovered: byDay.size,
+		throughput: [...byDay.entries()].map(([date, count]) => ({
+			date,
+			count
+		})).sort((a, b) => a.date.localeCompare(b.date)),
+		leadTime: {
+			medianMs: percentile(leadSamples, .5),
+			p90Ms: percentile(leadSamples, .9),
+			samples: leadSamples.length
+		},
+		wipTotal: countInFlight(items),
+		sourceMix: demandMix(items, window),
+		agentCoverage: agentCoverage(items, window)
+	};
+}
+//#endregion
+export { DEFAULT_METRICS_WINDOW, MAX_METRICS_WINDOW, computeFactoryMetrics, parseMetricsRange };
+
+//# sourceMappingURL=metrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","names":[],"sources":["../../../../src/storage/domains/work-items/metrics.ts"],"sourcesContent":["/**\n * Aggregation math for the Factory Overview page.\n *\n * Pure functions over `work_items` rows — throughput, lead time, in-flight\n * count, demand mix and per-stage agent coverage, all read from the\n * server-appended `stageHistory` log. Keeping this DB-free makes the math unit\n * testable and lets the route stay a thin shell.\n *\n * Everything windowed is counted as an event that happened inside the window,\n * never as \"the state the board happens to be in now\", so re-querying a past\n * window always returns the same numbers.\n */\n\nimport { isAgentActor } from './base.js';\nimport type { WorkItemRow } from './base.js';\n\n/** Default window span (days) when the request omits or malforms the range. */\nexport const DEFAULT_METRICS_WINDOW = 30;\n/** Hard cap on the range span (days) — bounds the gap-filled throughput array. */\nexport const MAX_METRICS_WINDOW = 366;\n\nconst DAY_MS = 86_400_000;\n\n/** Terminal stage — items here count as completed, not in-flight. */\nconst DONE_STAGE = 'done';\n\n/** Terminal stage for tracked non-completions — never a completion. */\nconst CANCELED_STAGE = 'canceled';\n\n/**\n * Terminal stages — items holding only these are not in-flight. `done` is a\n * completion (feeds throughput/lead time); `canceled` is a tracked\n * non-completion outcome and feeds neither.\n */\nconst TERMINAL_STAGES = new Set([DONE_STAGE, CANCELED_STAGE]);\n\nconst INTAKE_STAGE = 'intake';\n\n/**\n * Pipeline work excludes the inbox as well as the terminal stages: an intake\n * card is queued, not in flight, and its pass through is the poller filing it.\n */\nfunction isPipelineStage(stage: string): boolean {\n  return !TERMINAL_STAGES.has(stage) && stage !== INTAKE_STAGE;\n}\n\n/**\n * Cards the Factory ran: starting a run records its session on the row. The\n * integrations sync every issue and PR of a connected repo into the board and\n * those outnumber the Factory's own work by an order of magnitude, so counting\n * them reports the upstream repo's flow as the Factory's.\n */\nfunction hasFactoryRun(item: WorkItemRow): boolean {\n  return Object.keys(item.sessions).length > 0;\n}\n\n/**\n * Flow metrics over the cards the Factory ran ({@link hasFactoryRun}) — synced\n * upstream issues and PRs nobody started a run on are not the Factory's work\n * and are excluded from every field below.\n */\nexport interface FactoryMetrics {\n  /**\n   * Days the series covers: the requested window clipped to the board's life.\n   * Days before the first card could hold no completion, so counting them would\n   * drag the per-day rate toward zero on a young board.\n   */\n  daysCovered: number;\n  /** Entries into `done` per UTC day, gap-filled across the covered days. */\n  throughput: { date: string; count: number }[];\n  /** Card creation → `done` for every completion that landed in the window. */\n  leadTime: { medianMs: number | null; p90Ms: number | null; samples: number };\n  /** Distinct cards in a pipeline stage — past intake, not yet terminal. */\n  wipTotal: number;\n  /** Cards created in the window, by source. */\n  sourceMix: { source: string; count: number }[];\n  /** Per-stage agent coverage over first visits that ended in the window. */\n  agentCoverage: {\n    stage: string;\n    /**\n     * First visits to this stage that ended in the window. Repeat visits are\n     * excluded from both sides: they are rework, already reported as such, and\n     * counting them in the denominator alone caps a fully agent-run stage below\n     * 100%.\n     */\n    passes: number;\n    /**\n     * Of those: passes an agent finished (`exitedBy` is an agent actor). The\n     * entry actor is not required — the rules engine is what queues a card into\n     * a stage, so demanding both ends would report 0% for stages agents run\n     * end to end. Missing `exitedBy` (entries written before exit stamping)\n     * does not count.\n     */\n    byAgent: number;\n    /**\n     * Outcomes of the agent-finished passes' items as of the window's end,\n     * mutually exclusive, first match wins: `reworked` (a later visit to the\n     * same stage — deliberately outranks `done`: a pass that needed a redo is a\n     * failed pass even if the item eventually merged), then `done`, then\n     * `canceled`, then `inFlight`.\n     */\n    outcomes: { done: number; canceled: number; reworked: number; inFlight: number };\n  }[];\n}\n\nconst DATE_ONLY_RE = /^\\d{4}-\\d{2}-\\d{2}$/;\n/** Datetime carrying an explicit `Z` or `±HH:MM` offset. */\nconst ZONED_DATETIME_RE = /(?:[Zz]|[+-]\\d{2}:?\\d{2})$/;\n\nfunction parseRangeParam(value: unknown, boundary: 'from' | 'to'): number | undefined {\n  if (typeof value !== 'string' || value.length === 0) return undefined;\n  const dateOnly = DATE_ONLY_RE.test(value);\n  // Timezone-less datetimes are parsed as server-local by Date.parse, so the\n  // window would shift by deployment region — reject them as invalid.\n  if (!dateOnly && !ZONED_DATETIME_RE.test(value)) return undefined;\n  const time = Date.parse(value);\n  if (Number.isNaN(time)) return undefined;\n  return boundary === 'to' && dateOnly ? time + DAY_MS : time;\n}\n\nfunction utcDayStart(time: number): number {\n  return Date.parse(`${utcDay(time)}T00:00:00Z`);\n}\n\n/**\n * Resolve untrusted `from`/`to` into a bounded half-open UTC window. A date-only\n * `to` covers the whole day; an open/future end resolves to the end of the\n * current UTC day (not `now`) so an event at this instant stays inside the\n * window instead of on its excluded edge.\n */\nexport function parseMetricsRange(\n  fromParam: unknown,\n  toParam: unknown,\n  now: Date,\n): { windowStart: number; windowEnd: number } {\n  const nowMs = now.getTime();\n  const endOfToday = utcDayStart(nowMs) + DAY_MS;\n  const requestedEnd = parseRangeParam(toParam, 'to') ?? endOfToday;\n  const windowEnd = Math.min(requestedEnd, endOfToday);\n  const lastIncludedDay = utcDayStart(windowEnd - 1);\n  const defaultStart = lastIncludedDay - (DEFAULT_METRICS_WINDOW - 1) * DAY_MS;\n  const parsedFrom = parseRangeParam(fromParam, 'from');\n  let windowStart = parsedFrom !== undefined && parsedFrom < windowEnd ? parsedFrom : defaultStart;\n  const earliestStart = lastIncludedDay - (MAX_METRICS_WINDOW - 1) * DAY_MS;\n  if (windowStart < earliestStart) windowStart = earliestStart;\n  return { windowStart, windowEnd };\n}\n\n/** Stage history is server-appended, so an unparsable stamp is a corrupt row. */\nfunction parseTime(iso: string): number {\n  const time = Date.parse(iso);\n  if (Number.isNaN(time)) throw new Error(`Unparsable stage-history timestamp: ${iso}`);\n  return time;\n}\n\n/** Asserted up front so a corrupt row fails every window, not just the ones that read it. */\nfunction assertParsableHistory(items: WorkItemRow[]): void {\n  for (const item of items) {\n    for (const entry of item.stageHistory) {\n      parseTime(entry.enteredAt);\n      if (entry.exitedAt !== undefined) parseTime(entry.exitedAt);\n    }\n  }\n}\n\n/** Nearest-rank percentile over an unsorted sample list. */\nfunction percentile(samples: number[], fraction: number): number | null {\n  if (samples.length === 0) return null;\n  const sorted = [...samples].sort((a, b) => a - b);\n  const rank = Math.max(1, Math.ceil(fraction * sorted.length));\n  return sorted[rank - 1]!;\n}\n\n/** UTC `YYYY-MM-DD` for a timestamp. */\nfunction utcDay(time: number): string {\n  return new Date(time).toISOString().slice(0, 10);\n}\n\n/** Stages the item was holding at `time`, replayed from its history. */\nfunction stagesHeldAt(item: WorkItemRow, time: number): Set<string> {\n  const held = new Set<string>();\n  for (const entry of item.stageHistory) {\n    if (parseTime(entry.enteredAt) >= time) continue;\n    if (entry.exitedAt !== undefined && parseTime(entry.exitedAt) <= time) continue;\n    held.add(entry.stage);\n  }\n  return held;\n}\n\ntype Window = { windowStart: number; windowEnd: number };\n\n/**\n * Completions per UTC day, plus one lead-time sample each. A completion is an\n * entry *into* `done`, not the state of the card now: a card reopened today\n * must not erase the day it shipped, and a card that shipped twice shipped\n * twice. Days before the oldest card are left out rather than gap-filled with\n * zeroes that would drag the daily average down.\n */\nfunction completions(items: WorkItemRow[], { windowStart, windowEnd }: Window) {\n  let earliestItem = Infinity;\n  for (const item of items) earliestItem = Math.min(earliestItem, item.createdAt.getTime());\n  const boardStart = Number.isFinite(earliestItem) ? utcDayStart(earliestItem) : -Infinity;\n\n  const byDay = new Map<string, number>();\n  for (let day = Math.max(utcDayStart(windowStart), boardStart); day < windowEnd; day += DAY_MS) {\n    byDay.set(utcDay(day), 0);\n  }\n\n  const leadSamples: number[] = [];\n  for (const item of items) {\n    for (const entry of item.stageHistory) {\n      if (entry.stage !== DONE_STAGE) continue;\n      const doneAt = parseTime(entry.enteredAt);\n      if (doneAt < windowStart || doneAt >= windowEnd) continue;\n      byDay.set(utcDay(doneAt), (byDay.get(utcDay(doneAt)) ?? 0) + 1);\n      leadSamples.push(Math.max(0, doneAt - item.createdAt.getTime()));\n    }\n  }\n  return { byDay, leadSamples };\n}\n\n/** Cards holding at least one pipeline stage right now — window-independent. */\nfunction countInFlight(items: WorkItemRow[]): number {\n  return items.filter(item => item.stages.some(isPipelineStage)).length;\n}\n\n/** Where the window's cards came from, most common first. */\nfunction demandMix(items: WorkItemRow[], { windowStart, windowEnd }: Window): FactoryMetrics['sourceMix'] {\n  const counts = new Map<string, number>();\n  for (const item of items) {\n    const created = item.createdAt.getTime();\n    if (created < windowStart || created >= windowEnd) continue;\n    const source = item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : 'manual';\n    counts.set(source, (counts.get(source) ?? 0) + 1);\n  }\n  return [...counts.entries()].map(([source, count]) => ({ source, count })).sort((a, b) => b.count - a.count);\n}\n\n/**\n * How much of each stage's work an agent finished, counting a card's first\n * visit to a stage once. Rows appear in insertion order of each stage's first\n * counted exit; only pipeline stages get rows, since intake and terminal\n * stages have no pass to hand over.\n */\nfunction agentCoverage(items: WorkItemRow[], { windowStart, windowEnd }: Window): FactoryMetrics['agentCoverage'] {\n  const byStage = new Map<string, FactoryMetrics['agentCoverage'][number]>();\n  for (const item of items) {\n    const heldAtWindowEnd = stagesHeldAt(item, windowEnd);\n    const visited = new Set<string>();\n    for (let i = 0; i < item.stageHistory.length; i++) {\n      const entry = item.stageHistory[i]!;\n      if (!isPipelineStage(entry.stage) || visited.has(entry.stage)) continue;\n      visited.add(entry.stage);\n      if (entry.exitedAt === undefined) continue;\n      const exited = parseTime(entry.exitedAt);\n      if (exited < windowStart || exited >= windowEnd) continue;\n\n      let row = byStage.get(entry.stage);\n      if (!row) {\n        row = {\n          stage: entry.stage,\n          passes: 0,\n          byAgent: 0,\n          outcomes: { done: 0, canceled: 0, reworked: 0, inFlight: 0 },\n        };\n        byStage.set(entry.stage, row);\n      }\n      row.passes += 1;\n      if (!isAgentActor(entry.exitedBy)) continue;\n      row.byAgent += 1;\n\n      const reworked = item.stageHistory.some(\n        (later, j) => j > i && later.stage === entry.stage && parseTime(later.enteredAt) < windowEnd,\n      );\n      if (reworked) row.outcomes.reworked += 1;\n      else if (heldAtWindowEnd.has(DONE_STAGE)) row.outcomes.done += 1;\n      else if (heldAtWindowEnd.has(CANCELED_STAGE)) row.outcomes.canceled += 1;\n      else row.outcomes.inFlight += 1;\n    }\n  }\n  return [...byStage.values()];\n}\n\nexport function computeFactoryMetrics(boardItems: WorkItemRow[], window: Window): FactoryMetrics {\n  const items = boardItems.filter(hasFactoryRun);\n  assertParsableHistory(items);\n\n  const { byDay, leadSamples } = completions(items, window);\n\n  return {\n    daysCovered: byDay.size,\n    throughput: [...byDay.entries()]\n      .map(([date, count]) => ({ date, count }))\n      .sort((a, b) => a.date.localeCompare(b.date)),\n    leadTime: {\n      medianMs: percentile(leadSamples, 0.5),\n      p90Ms: percentile(leadSamples, 0.9),\n      samples: leadSamples.length,\n    },\n    wipTotal: countInFlight(items),\n    sourceMix: demandMix(items, window),\n    agentCoverage: agentCoverage(items, window),\n  };\n}\n"],"mappings":"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"}

package/dist/supervisor/health-worker.d.ts

@@ -0,0 +1,19 @@
+import { MastraWorker } from '@mastra/core/worker';
+import type { BoardRegistry } from '../boards/index.js';
+import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
+import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
+export declare const DEFAULT_SUPERVISOR_HEALTH_INTERVAL_MS: number;
+export declare class FactorySupervisorHealthWorker extends MastraWorker {
+    #private;
+    readonly name = "factory-supervisor-health";
+    constructor(input: {
+        projects: FactoryProjectsStorage;
+        workItems: WorkItemsStorage;
+        boards: BoardRegistry;
+        intervalMs?: number;
+    });
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    get isRunning(): boolean;
+}
+//# sourceMappingURL=health-worker.d.ts.map

package/dist/supervisor/health-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-worker.d.ts","sourceRoot":"","sources":["../../src/supervisor/health-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAG9E,eAAO,MAAM,qCAAqC,QAAa,CAAC;AAEhE,qBAAa,6BAA8B,SAAQ,YAAY;;IAC7D,QAAQ,CAAC,IAAI,+BAA+B;gBAUhC,KAAK,EAAE;QACjB,QAAQ,EAAE,sBAAsB,CAAC;QACjC,SAAS,EAAE,gBAAgB,CAAC;QAC5B,MAAM,EAAE,aAAa,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAQK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,IAAI,SAAS,IAAI,OAAO,CAEvB;CA4CF"}

package/dist/supervisor/health-worker.js

@@ -0,0 +1,74 @@
+import { runFactoryHealthCheck } from "./health.js";
+import { MastraWorker } from "@mastra/core/worker";
+//#region src/supervisor/health-worker.ts
+const DEFAULT_SUPERVISOR_HEALTH_INTERVAL_MS = 5 * 6e4;
+var FactorySupervisorHealthWorker = class extends MastraWorker {
+	name = "factory-supervisor-health";
+	#projects;
+	#workItems;
+	#boards;
+	#intervalMs;
+	#running = false;
+	#timer;
+	#inFlight;
+	constructor(input) {
+		super();
+		this.#projects = input.projects;
+		this.#workItems = input.workItems;
+		this.#boards = input.boards;
+		this.#intervalMs = input.intervalMs ?? 3e5;
+	}
+	async start() {
+		if (this.#running) return;
+		if (!this.deps) throw new Error("FactorySupervisorHealthWorker: call init() before start()");
+		this.#running = true;
+		this.#schedule(0);
+	}
+	async stop() {
+		this.#running = false;
+		if (this.#timer) clearTimeout(this.#timer);
+		this.#timer = void 0;
+		await this.#inFlight;
+	}
+	get isRunning() {
+		return this.#running;
+	}
+	#schedule(delayMs) {
+		if (!this.#running) return;
+		this.#timer = setTimeout(() => {
+			this.#timer = void 0;
+			this.#inFlight = this.#tick().catch((error) => this.deps?.logger.error("Factory supervisor health sweep failed", { error })).finally(() => {
+				this.#inFlight = void 0;
+				this.#schedule(this.#intervalMs);
+			});
+		}, delayMs);
+		this.#timer.unref?.();
+	}
+	async #tick() {
+		const now = /* @__PURE__ */ new Date();
+		const projects = await this.#projects.listAll();
+		const concurrency = 4;
+		let nextIndex = 0;
+		const failure = (await Promise.allSettled(Array.from({ length: Math.min(concurrency, projects.length) }, async () => {
+			while (nextIndex < projects.length) {
+				const project = projects[nextIndex++];
+				if (!project) return;
+				const report = await runFactoryHealthCheck(this.#workItems, this.#boards, {
+					orgId: project.orgId,
+					factoryProjectId: project.id
+				}, { now });
+				await this.#workItems.syncSupervisorFindings({
+					orgId: project.orgId,
+					factoryProjectId: project.id,
+					findings: report.findings,
+					now
+				});
+			}
+		}))).find((result) => result.status === "rejected");
+		if (failure) throw failure.reason;
+	}
+};
+//#endregion
+export { DEFAULT_SUPERVISOR_HEALTH_INTERVAL_MS, FactorySupervisorHealthWorker };
+
+//# sourceMappingURL=health-worker.js.map

package/dist/supervisor/health-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-worker.js","names":["#projects","#workItems","#boards","#intervalMs","#running","#schedule","#timer","#inFlight","#tick"],"sources":["../../src/supervisor/health-worker.ts"],"sourcesContent":["import { MastraWorker } from '@mastra/core/worker';\n\nimport type { BoardRegistry } from '../boards/index.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { runFactoryHealthCheck } from './health.js';\n\nexport const DEFAULT_SUPERVISOR_HEALTH_INTERVAL_MS = 5 * 60_000;\n\nexport class FactorySupervisorHealthWorker extends MastraWorker {\n  readonly name = 'factory-supervisor-health';\n\n  readonly #projects: FactoryProjectsStorage;\n  readonly #workItems: WorkItemsStorage;\n  readonly #boards: BoardRegistry;\n  readonly #intervalMs: number;\n  #running = false;\n  #timer: ReturnType<typeof setTimeout> | undefined;\n  #inFlight: Promise<void> | undefined;\n\n  constructor(input: {\n    projects: FactoryProjectsStorage;\n    workItems: WorkItemsStorage;\n    boards: BoardRegistry;\n    intervalMs?: number;\n  }) {\n    super();\n    this.#projects = input.projects;\n    this.#workItems = input.workItems;\n    this.#boards = input.boards;\n    this.#intervalMs = input.intervalMs ?? DEFAULT_SUPERVISOR_HEALTH_INTERVAL_MS;\n  }\n\n  async start(): Promise<void> {\n    if (this.#running) return;\n    if (!this.deps) throw new Error('FactorySupervisorHealthWorker: call init() before start()');\n    this.#running = true;\n    this.#schedule(0);\n  }\n\n  async stop(): Promise<void> {\n    this.#running = false;\n    if (this.#timer) clearTimeout(this.#timer);\n    this.#timer = undefined;\n    await this.#inFlight;\n  }\n\n  get isRunning(): boolean {\n    return this.#running;\n  }\n\n  #schedule(delayMs: number): void {\n    if (!this.#running) return;\n    this.#timer = setTimeout(() => {\n      this.#timer = undefined;\n      this.#inFlight = this.#tick()\n        .catch(error => this.deps?.logger.error('Factory supervisor health sweep failed', { error }))\n        .finally(() => {\n          this.#inFlight = undefined;\n          this.#schedule(this.#intervalMs);\n        });\n    }, delayMs);\n    this.#timer.unref?.();\n  }\n\n  async #tick(): Promise<void> {\n    const now = new Date();\n    const projects = await this.#projects.listAll();\n    const concurrency = 4;\n    let nextIndex = 0;\n    const results = await Promise.allSettled(\n      Array.from({ length: Math.min(concurrency, projects.length) }, async () => {\n        while (nextIndex < projects.length) {\n          const project = projects[nextIndex++];\n          if (!project) return;\n          const report = await runFactoryHealthCheck(\n            this.#workItems,\n            this.#boards,\n            { orgId: project.orgId, factoryProjectId: project.id },\n            { now },\n          );\n          await this.#workItems.syncSupervisorFindings({\n            orgId: project.orgId,\n            factoryProjectId: project.id,\n            findings: report.findings,\n            now,\n          });\n        }\n      }),\n    );\n    const failure = results.find((result): result is PromiseRejectedResult => result.status === 'rejected');\n    if (failure) throw failure.reason;\n  }\n}\n"],"mappings":";;;AAOA,MAAa,wCAAwC,IAAI;AAEzD,IAAa,gCAAb,cAAmD,aAAa;CAC9D,OAAgB;CAEhB;CACA;CACA;CACA;CACA,WAAW;CACX;CACA;CAEA,YAAY,OAKT;EACD,MAAM;EACN,KAAKA,YAAY,MAAM;EACvB,KAAKC,aAAa,MAAM;EACxB,KAAKC,UAAU,MAAM;EACrB,KAAKC,cAAc,MAAM,cAAA;CAC3B;CAEA,MAAM,QAAuB;EAC3B,IAAI,KAAKC,UAAU;EACnB,IAAI,CAAC,KAAK,MAAM,MAAM,IAAI,MAAM,2DAA2D;EAC3F,KAAKA,WAAW;EAChB,KAAKC,UAAU,CAAC;CAClB;CAEA,MAAM,OAAsB;EAC1B,KAAKD,WAAW;EAChB,IAAI,KAAKE,QAAQ,aAAa,KAAKA,MAAM;EACzC,KAAKA,SAAS,KAAA;EACd,MAAM,KAAKC;CACb;CAEA,IAAI,YAAqB;EACvB,OAAO,KAAKH;CACd;CAEA,UAAU,SAAuB;EAC/B,IAAI,CAAC,KAAKA,UAAU;EACpB,KAAKE,SAAS,iBAAiB;GAC7B,KAAKA,SAAS,KAAA;GACd,KAAKC,YAAY,KAAKC,MAAM,CAAC,CAC1B,OAAM,UAAS,KAAK,MAAM,OAAO,MAAM,0CAA0C,EAAE,MAAM,CAAC,CAAC,CAAC,CAC5F,cAAc;IACb,KAAKD,YAAY,KAAA;IACjB,KAAKF,UAAU,KAAKF,WAAW;GACjC,CAAC;EACL,GAAG,OAAO;EACV,KAAKG,OAAO,QAAQ;CACtB;CAEA,MAAME,QAAuB;EAC3B,MAAM,sBAAM,IAAI,KAAK;EACrB,MAAM,WAAW,MAAM,KAAKR,UAAU,QAAQ;EAC9C,MAAM,cAAc;EACpB,IAAI,YAAY;EAqBhB,MAAM,WAAU,MApBM,QAAQ,WAC5B,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,aAAa,SAAS,MAAM,EAAE,GAAG,YAAY;GACzE,OAAO,YAAY,SAAS,QAAQ;IAClC,MAAM,UAAU,SAAS;IACzB,IAAI,CAAC,SAAS;IACd,MAAM,SAAS,MAAM,sBACnB,KAAKC,YACL,KAAKC,SACL;KAAE,OAAO,QAAQ;KAAO,kBAAkB,QAAQ;IAAG,GACrD,EAAE,IAAI,CACR;IACA,MAAM,KAAKD,WAAW,uBAAuB;KAC3C,OAAO,QAAQ;KACf,kBAAkB,QAAQ;KAC1B,UAAU,OAAO;KACjB;IACF,CAAC;GACH;EACF,CAAC,CACH,EAAA,CACwB,MAAM,WAA4C,OAAO,WAAW,UAAU;EACtG,IAAI,SAAS,MAAM,QAAQ;CAC7B;AACF"}

package/dist/supervisor/health.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Deterministic Factory health check.
+ *
+ * Every finding is computed from storage rows alone — no model, no controller —
+ * so the supervisor agent explains findings rather than inventing them, and the
+ * same list can be rendered by the UI or polled by a timer. Each finding names
+ * the row it came from and the standard repair a person (or the supervisor's
+ * write tools) would apply.
+ */
+import type { BoardRegistry, PhaseSemantics } from '../boards/index.js';
+import type { FactoryDeferredDecisionRecord, FactoryPendingStartRecord, FactoryRunBindingRecord, WorkItemRow, WorkItemsStorage } from '../storage/domains/work-items/base.js';
+export type FactoryHealthFindingKind = 'decision-stuck' | 'start-stalled' | 'seat-orphaned' | 'seat-missing' | 'held-waiting' | 'label-drift';
+export type FactoryHealthRepair = {
+    action: 'revoke-binding';
+    bindingId: string;
+} | {
+    action: 'accept-work-item';
+    workItemId: string;
+} | {
+    action: 'start-run';
+    workItemId: string;
+    role: string;
+} | {
+    action: 'reconcile-labels';
+    workItemId: string;
+};
+export interface FactoryHealthFinding {
+    kind: FactoryHealthFindingKind;
+    /** Stable per (kind, subject) so the UI and attention inbox can dedupe. */
+    id: string;
+    workItemId: string | null;
+    /** Card number as shown on the board, when the row carries one. */
+    workItemNumber: number | null;
+    title: string;
+    /** One sentence of grounded evidence: ids, timestamps, error text. */
+    evidence: string;
+    /** ISO instant the condition began, when it is age-based. */
+    beganAt: string | null;
+    suggestedRepair: FactoryHealthRepair | null;
+}
+export interface FactoryHealthReport {
+    checkedAt: string;
+    findings: FactoryHealthFinding[];
+    counts: Record<FactoryHealthFindingKind, number>;
+}
+export interface FactoryHealthThresholds {
+    /** A retry/pending decision whose `availableAt` is this far in the past never got picked up. */
+    stuckDecisionMs: number;
+    /** A lease this far past its expiry belongs to a worker that died mid-dispatch. */
+    expiredLeaseMs: number;
+    /** A pending start this old is not "booting", it is stalled. */
+    stalledStartMs: number;
+    /** Held cards older than this are worth nudging a maintainer about. */
+    waitingOnPersonMs: number;
+}
+export declare const DEFAULT_HEALTH_THRESHOLDS: FactoryHealthThresholds;
+interface HealthInputs {
+    items: WorkItemRow[];
+    decisions: FactoryDeferredDecisionRecord[];
+    bindings: FactoryRunBindingRecord[];
+    pendingStarts: FactoryPendingStartRecord[];
+    /**
+     * What the item's installed board says its current phase means. Undefined when the
+     * board is not installed, the phase is undeclared, or the row spans several stages;
+     * the check then neither revokes nor starts anything on a guess.
+     */
+    phaseSemantics: (item: WorkItemRow) => PhaseSemantics | undefined;
+}
+/** Pure: findings from rows. Exported so tests can feed fixtures directly. */
+export declare function computeFactoryHealth(inputs: HealthInputs, now: Date, thresholds?: FactoryHealthThresholds): FactoryHealthReport;
+export declare function runFactoryHealthCheck(workItems: WorkItemsStorage, boards: BoardRegistry, scope: {
+    orgId: string;
+    factoryProjectId: string;
+}, options?: {
+    now?: Date;
+    thresholds?: FactoryHealthThresholds;
+}): Promise<FactoryHealthReport>;
+export {};
+//# sourceMappingURL=health.d.ts.map

package/dist/supervisor/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/supervisor/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,KAAK,EACV,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,cAAc,GACd,cAAc,GACd,aAAa,CAAC;AAElB,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mEAAmE;IACnE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,uBAAuB;IACtC,gGAAgG;IAChG,eAAe,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,yBAAyB,EAAE,uBAKvC,CAAC;AAoDF,UAAU,YAAY;IACpB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,SAAS,EAAE,6BAA6B,EAAE,CAAC;IAC3C,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,aAAa,EAAE,yBAAyB,EAAE,CAAC;IAC3C;;;;OAIG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,cAAc,GAAG,SAAS,CAAC;CACnE;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,IAAI,EACT,UAAU,GAAE,uBAAmD,GAC9D,mBAAmB,CAwJrB;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,EAClD,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,uBAAuB,CAAA;CAAO,GACjE,OAAO,CAAC,mBAAmB,CAAC,CAc9B"}