@mastra/factory 0.12.1-alpha.0 → 0.13.0-alpha.10

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

@@ -65,6 +65,23 @@ function factoryDecisionAttentionIdentity(decisionId, failureOccurrence) {
 		occurrence: failureOccurrence
 	};
 }
+function factoryProposalAttentionIdentity(decisionId) {
+	return {
+		kind: "automation-proposed",
+		sourceId: decisionId,
+		occurrence: 0
+	};
+}
+function proposalReceiptFilter(orgId, factoryProjectId, decisionId) {
+	const identity = factoryProposalAttentionIdentity(decisionId);
+	return {
+		org_id: orgId,
+		factory_project_id: factoryProjectId,
+		kind: identity.kind,
+		source_id: identity.sourceId,
+		occurrence: identity.occurrence
+	};
+}
 function factoryMentionAttentionIdentity(commentId) {
 	return {
 		kind: "mention",
@@ -80,6 +97,13 @@ function factoryActivityAttentionIdentity(workItemId, occurrence) {
 		occurrence
 	};
 }
+function factorySupervisorFindingAttentionIdentity(findingKey, occurrence) {
+	return {
+		kind: "supervisor-finding",
+		sourceId: findingKey,
+		occurrence
+	};
+}
 function factoryAttentionKey(factoryProjectId, identity) {
 	return `factory:${factoryProjectId}:attention:${identity.kind}:${identity.sourceId}:${identity.occurrence}`;
 }
@@ -101,6 +125,10 @@ const WORK_ITEMS_SCHEMA = {
 		id: { type: "uuid-pk" },
 		org_id: { type: "text" },
 		factory_project_id: { type: "text" },
+		board: {
+			type: "text",
+			nullable: true
+		},
 		external_source: {
 			type: "json",
 			nullable: true
@@ -196,6 +224,7 @@ function toWorkItem(row) {
 		id: row.id,
 		orgId: row.org_id,
 		factoryProjectId: String(row.factory_project_id),
+		board: row.board ?? null,
 		externalSource: row.external_source,
 		parentWorkItemId: row.parent_work_item_id,
 		title: row.title,
@@ -218,6 +247,7 @@ function toWorkItem(row) {
 const toRow = toWorkItem;
 function patchColumns(changes) {
 	return {
+		...changes.board !== void 0 ? { board: changes.board } : {},
 		...changes.parentWorkItemId !== void 0 ? { parent_work_item_id: changes.parentWorkItemId } : {},
 		...changes.title !== void 0 ? { title: changes.title } : {},
 		...changes.stages !== void 0 ? { stages: changes.stages } : {},
@@ -246,6 +276,14 @@ function priorState(row) {
 var WorkItemRelationError = class extends Error {
 	code = "invalid_work_item_relation";
 };
+var WorkItemUpdateConflictError = class extends Error {
+	reason;
+	code = "work_item_update_conflict";
+	constructor(reason) {
+		super(`Work item ${reason} precondition failed`);
+		this.reason = reason;
+	}
+};
 function validateParentRelation(projectItems, itemId, parentWorkItemId) {
 	if (parentWorkItemId === null) return;
 	const byId = new Map(projectItems.map((item) => [item.id, item]));
@@ -296,6 +334,7 @@ function stampSessions(sessions, by) {
 function applyUpdate({ current, userId, input }) {
 	const now = /* @__PURE__ */ new Date();
 	return {
+		...input.board !== void 0 ? { board: input.board } : {},
 		...input.parentWorkItemId !== void 0 ? { parent_work_item_id: input.parentWorkItemId } : {},
 		...input.title !== void 0 ? { title: input.title } : {},
 		...input.stages !== void 0 ? {
@@ -310,6 +349,7 @@ function applyUpdate({ current, userId, input }) {
 			...current.metadata ?? {},
 			...input.metadata
 		} } : {},
+		...input.plansPreapproved && !current.plans_preapproved_at ? { plans_preapproved_at: now } : {},
 		revision: current.revision + 1,
 		updated_at: now
 	};
@@ -490,6 +530,41 @@ const FACTORY_GOVERNANCE_SCHEMAS = [
 			}
 		]
 	},
+	{
+		name: "factory_supervisor_findings",
+		columns: {
+			id: { type: "uuid-pk" },
+			org_id: { type: "text" },
+			factory_project_id: { type: "text" },
+			finding_key: { type: "text" },
+			occurrence: { type: "integer" },
+			finding: { type: "json" },
+			opened_at: { type: "timestamp" },
+			updated_at: { type: "timestamp" },
+			resolved_at: {
+				type: "timestamp",
+				nullable: true
+			}
+		},
+		uniqueIndexes: [{
+			name: "factory_supervisor_findings_project_key_unique",
+			columns: [
+				"org_id",
+				"factory_project_id",
+				"finding_key"
+			]
+		}],
+		indexes: [{
+			name: "factory_supervisor_findings_project_open_idx",
+			columns: [
+				"org_id",
+				"factory_project_id",
+				"resolved_at",
+				"updated_at",
+				"id"
+			]
+		}]
+	},
 	{
 		name: "factory_attention_receipts",
 		columns: {
@@ -683,9 +758,22 @@ function toDeferredDecision(row) {
 	};
 }
 function attentionReceiptKind(value) {
-	if (value === "automation-failed" || value === "mention" || value === "activity") return value;
+	if (value === "automation-failed" || value === "automation-proposed" || value === "mention" || value === "activity" || value === "supervisor-finding") return value;
 	throw new Error(`Unsupported attention receipt kind '${String(value)}'.`);
 }
+function toSupervisorFinding(row) {
+	return {
+		id: row.id,
+		orgId: String(row.org_id),
+		factoryProjectId: String(row.factory_project_id),
+		findingKey: String(row.finding_key),
+		occurrence: Number(row.occurrence),
+		finding: row.finding,
+		openedAt: row.opened_at,
+		updatedAt: row.updated_at,
+		resolvedAt: row.resolved_at ?? null
+	};
+}
 function attentionReceiptState(value) {
 	if (value === "read" || value === "archived") return value;
 	throw new Error(`Unsupported attention receipt state '${String(value)}'.`);
@@ -768,6 +856,86 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 		if (!count) throw new Error("[WorkItemsStorage] storage backend does not support collection counts.");
 		return count.call(this.#db, collection, where);
 	}
+	async syncSupervisorFindings(input) {
+		if (await this.#withProjectRelationTransaction(input.orgId, input.factoryProjectId, async (ops) => {
+			let changed = false;
+			const existingOpen = await ops.findMany("factory_supervisor_findings", {
+				org_id: input.orgId,
+				factory_project_id: input.factoryProjectId,
+				resolved_at: null
+			});
+			const currentKeys = new Set(input.findings.map((finding) => finding.id));
+			for (const row of existingOpen) if (!currentKeys.has(String(row.finding_key))) {
+				await ops.updateAtomic("factory_supervisor_findings", {
+					id: row.id,
+					resolved_at: null
+				}, () => ({
+					resolved_at: input.now,
+					updated_at: input.now
+				}));
+				changed = true;
+			}
+			const openByKey = new Map(existingOpen.map((row) => [String(row.finding_key), row]));
+			for (const finding of input.findings) {
+				const row = openByKey.get(finding.id) ?? await ops.findOne("factory_supervisor_findings", {
+					org_id: input.orgId,
+					factory_project_id: input.factoryProjectId,
+					finding_key: finding.id
+				});
+				if (!row) {
+					await ops.insertOne("factory_supervisor_findings", {
+						org_id: input.orgId,
+						factory_project_id: input.factoryProjectId,
+						finding_key: finding.id,
+						occurrence: 0,
+						finding,
+						opened_at: input.now,
+						updated_at: input.now,
+						resolved_at: null
+					});
+					changed = true;
+					continue;
+				}
+				const reopening = row.resolved_at !== null;
+				const findingChanged = stableJson(row.finding) !== stableJson(finding);
+				if (!reopening && !findingChanged) continue;
+				await ops.updateAtomic("factory_supervisor_findings", { id: row.id }, (current) => ({
+					finding,
+					occurrence: Number(current.occurrence) + (current.resolved_at !== null ? 1 : 0),
+					opened_at: current.resolved_at !== null ? input.now : current.opened_at,
+					updated_at: input.now,
+					resolved_at: null
+				}));
+				changed = true;
+			}
+			return changed;
+		})) this.#attentionChanged?.({
+			orgId: input.orgId,
+			factoryProjectId: input.factoryProjectId
+		});
+	}
+	async listSupervisorFindingPage(input) {
+		const rows = await this.#db.findMany("factory_supervisor_findings", {
+			org_id: input.orgId,
+			factory_project_id: input.factoryProjectId,
+			resolved_at: null
+		}, {
+			orderBy: [["updated_at", "desc"], ["id", "desc"]],
+			limit: input.limit + 1,
+			...input.before ? { cursor: { values: [input.before.occurredAt, input.before.id] } } : {}
+		});
+		return {
+			rows: rows.slice(0, input.limit).map(toSupervisorFinding),
+			hasMore: rows.length > input.limit
+		};
+	}
+	async countOpenSupervisorFindings(input) {
+		return this.#countRows("factory_supervisor_findings", {
+			org_id: input.orgId,
+			factory_project_id: input.factoryProjectId,
+			resolved_at: null
+		});
+	}
 	async #withProjectRelationTransaction(orgId, factoryProjectId, fn) {
 		return withInProcessProjectLock(`work-items:${orgId}:${factoryProjectId}`, () => this.storage.withTransaction(fn, { isolationLevel: "serializable" }));
 	}
@@ -1255,11 +1423,12 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 			hasMore: rows.length > input.limit
 		};
 	}
-	async listFailedDecisionPage(input) {
+	/** Newest-parked-first keyset over one status, on the `updated_at` the status was stamped. */
+	async listDecisionPageByStatus(input) {
 		const rows = await this.#db.findMany("factory_deferred_decisions", {
 			org_id: input.orgId,
 			factory_project_id: input.factoryProjectId,
-			status: "failed"
+			status: input.status
 		}, {
 			orderBy: [["updated_at", "desc"], ["id", "desc"]],
 			limit: input.limit + 1,
@@ -1353,6 +1522,18 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 			});
 			return Boolean(decision) && currentOccurrence;
 		}
+		if (identity.kind === "automation-proposed") {
+			let parked = false;
+			const decision = await ops.updateAtomic("factory_deferred_decisions", {
+				id: identity.sourceId,
+				org_id: orgId,
+				factory_project_id: factoryProjectId
+			}, (current) => {
+				parked = current.status === "proposed" && identity.occurrence === 0;
+				return null;
+			});
+			return Boolean(decision) && parked;
+		}
 		if (identity.kind === "activity") return await ops.findOne("work_item_activity", {
 			work_item_id: identity.sourceId,
 			participant_id: userId,
@@ -1360,6 +1541,13 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 			factory_project_id: factoryProjectId,
 			occurrence: identity.occurrence
 		}) !== null;
+		if (identity.kind === "supervisor-finding") return await ops.findOne("factory_supervisor_findings", {
+			org_id: orgId,
+			factory_project_id: factoryProjectId,
+			finding_key: identity.sourceId,
+			occurrence: identity.occurrence,
+			resolved_at: null
+		}) !== null;
 		if (identity.occurrence !== 0) return false;
 		if (!await ops.findOne("work_item_comment_mentions", {
 			comment_id: identity.sourceId,
@@ -1497,6 +1685,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 			});
 			if (!settled || !row) return null;
 			const record = toDeferredDecision(row);
+			await ops.deleteMany("factory_attention_receipts", proposalReceiptFilter(orgId, factoryProjectId, decisionId));
 			if (record.workItemId) await ops.updateAtomic("work_items", {
 				org_id: orgId,
 				id: record.workItemId
@@ -1553,20 +1742,23 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 		return superseded;
 	}
 	async #settleProposedDecision({ orgId, factoryProjectId, decisionId }, patch) {
-		let settled = false;
-		const row = await this.#db.updateAtomic("factory_deferred_decisions", {
-			id: decisionId,
-			org_id: orgId,
-			factory_project_id: factoryProjectId
-		}, (current) => {
-			if (current.status !== "proposed") return null;
-			settled = true;
-			return patch;
+		const settled = await this.storage.withTransaction(async (ops) => {
+			let updated = false;
+			const row = await ops.updateAtomic("factory_deferred_decisions", {
+				id: decisionId,
+				org_id: orgId,
+				factory_project_id: factoryProjectId
+			}, (current) => {
+				if (current.status !== "proposed") return null;
+				updated = true;
+				return patch;
+			});
+			if (!updated || !row) return null;
+			await ops.deleteMany("factory_attention_receipts", proposalReceiptFilter(orgId, factoryProjectId, decisionId));
+			return toDeferredDecision(row);
 		});
-		if (!settled || !row) return null;
-		const record = toDeferredDecision(row);
-		this.#attentionChanged(record);
-		return record;
+		if (settled) this.#attentionChanged(settled);
+		return settled;
 	}
 	async #resolveFailedDecision({ orgId, factoryProjectId, decisionId, status, now }) {
 		const resolved = await this.storage.withTransaction(async (ops) => {
@@ -1886,6 +2078,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 					org_id: input.orgId,
 					created_by: input.userId,
 					factory_project_id: input.factoryProjectId,
+					board: create.board ?? null,
 					external_source: create.externalSource ?? null,
 					source_key: externalSourceKey(create.externalSource),
 					parent_work_item_id: create.parentWorkItemId ?? null,
@@ -1900,14 +2093,6 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 				});
 				item = toRow(row);
 			}
-			if (input.armAutonomy && !item.autonomyArmedAt) {
-				const armedRow = await ops.updateAtomic("work_items", { id: item.id }, (current) => current.autonomy_armed_at ? null : { autonomy_armed_at: now });
-				if (armedRow) item = toRow(armedRow);
-			}
-			if (input.preapprovePlans && !item.plansPreapprovedAt) {
-				const grantedRow = await ops.updateAtomic("work_items", { id: item.id }, (current) => current.plans_preapproved_at ? null : { plans_preapproved_at: now });
-				if (grantedRow) item = toRow(grantedRow);
-			}
 			await ops.updateMany("factory_run_bindings", {
 				org_id: input.orgId,
 				factory_project_id: input.factoryProjectId,
@@ -2034,6 +2219,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 				} : fullPatch;
 				if (patch.parentWorkItemId !== void 0) validateParentRelation(await this.#listWithOps(ops, orgId, factoryProjectId), current.id, patch.parentWorkItemId);
 				return {
+					board: reuseMode === "non-stage" ? current.board : input.board ?? current.board ?? null,
 					external_source: input.externalSource ?? null,
 					...applyUpdate({
 						current,
@@ -2057,6 +2243,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 			item: toWorkItem(await ops.insertOne("work_items", {
 				org_id: orgId,
 				factory_project_id: factoryProjectId,
+				board: input.board ?? null,
 				external_source: input.externalSource ?? null,
 				source_key: key,
 				parent_work_item_id: input.parentWorkItemId ?? null,
@@ -2100,7 +2287,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 			return row ? toWorkItem(row) : null;
 		});
 	}
-	async update({ orgId, id, userId, patch }) {
+	async update({ orgId, id, userId, patch, expectedRevision, expectedBoard }) {
 		const run = async (ops) => {
 			let previous = emptyPrior();
 			const row = await ops.updateAtomic("work_items", {
@@ -2108,6 +2295,8 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 				id
 			}, async (current) => {
 				previous = priorState(current);
+				if (expectedBoard !== void 0 && current.board !== expectedBoard) throw new WorkItemUpdateConflictError("board");
+				if (expectedRevision !== void 0 && current.revision !== expectedRevision) throw new WorkItemUpdateConflictError("revision");
 				if (patch.parentWorkItemId !== void 0) validateParentRelation(await this.#listWithOps(ops, orgId, current.factory_project_id), current.id, patch.parentWorkItemId);
 				return applyUpdate({
 					current,
@@ -2129,18 +2318,6 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 		return this.#withProjectRelationTransaction(orgId, candidate.factory_project_id, run);
 	}
 	/**
-	* Record that a person committed this item to the Factory. Only the first
-	* time counts: the timestamp marks when the item stopped needing permission,
-	* so later runs must not push it forward. Bumps no revision, because arming
-	* is not a change anyone is editing against.
-	*/
-	async armAutonomy({ orgId, id, now }) {
-		await this.#db.updateAtomic("work_items", {
-			org_id: orgId,
-			id
-		}, (current) => current.autonomy_armed_at ? null : { autonomy_armed_at: now });
-	}
-	/**
 	* Drop the governance rows that materialized a source key so a deleted work item
 	* is not resurrected by the prior-ingress replay path on the next intake poll.
 	*/
@@ -2247,6 +2424,6 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
 	}
 };
 //#endregion
-export { FACTORY_PULL_REQUEST_RECONCILIATION_KEY, FACTORY_RULE_MATERIALIZATION_KEY, WORK_ITEMS_SCHEMA, WorkItemRelationError, WorkItemsStorage, applyStageTransition, externalSourceKey, factoryActivityAttentionIdentity, factoryAttentionKey, factoryDecisionAttentionIdentity, factoryDecisionHash, factoryMentionAttentionIdentity, isAgentActor, stampSessions, validateParentRelation };
+export { FACTORY_PULL_REQUEST_RECONCILIATION_KEY, FACTORY_RULE_MATERIALIZATION_KEY, WORK_ITEMS_SCHEMA, WorkItemRelationError, WorkItemUpdateConflictError, WorkItemsStorage, applyStageTransition, externalSourceKey, factoryActivityAttentionIdentity, factoryAttentionKey, factoryDecisionAttentionIdentity, factoryDecisionHash, factoryMentionAttentionIdentity, factoryProposalAttentionIdentity, factorySupervisorFindingAttentionIdentity, isAgentActor, stampSessions, validateParentRelation };
 
 //# sourceMappingURL=base.js.map