@mastra/factory 0.28.0-alpha.11 → 0.28.0-alpha.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/README.md +17 -15
  2. package/dist/factory.d.ts.map +1 -1
  3. package/dist/factory.js +3 -1
  4. package/dist/factory.js.map +1 -1
  5. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  6. package/dist/mcp/routes.d.ts.map +1 -1
  7. package/dist/mcp/routes.js +3 -5
  8. package/dist/mcp/routes.js.map +1 -1
  9. package/dist/routes/board-snapshot.d.ts +7 -2
  10. package/dist/routes/board-snapshot.d.ts.map +1 -1
  11. package/dist/routes/board-snapshot.js +30 -11
  12. package/dist/routes/board-snapshot.js.map +1 -1
  13. package/dist/routes/contracts.d.ts +29 -2
  14. package/dist/routes/contracts.d.ts.map +1 -1
  15. package/dist/routes/contracts.js +42 -8
  16. package/dist/routes/contracts.js.map +1 -1
  17. package/dist/routes/work-item-selection.d.ts +16 -0
  18. package/dist/routes/work-item-selection.d.ts.map +1 -0
  19. package/dist/routes/work-item-selection.js +56 -0
  20. package/dist/routes/work-item-selection.js.map +1 -0
  21. package/dist/routes/work-items.d.ts.map +1 -1
  22. package/dist/routes/work-items.js +54 -21
  23. package/dist/routes/work-items.js.map +1 -1
  24. package/dist/rules/dispatch-errors.d.ts.map +1 -1
  25. package/dist/rules/dispatch-errors.js +4 -0
  26. package/dist/rules/dispatch-errors.js.map +1 -1
  27. package/dist/rules/dispatcher.d.ts +2 -1
  28. package/dist/rules/dispatcher.d.ts.map +1 -1
  29. package/dist/rules/dispatcher.js +35 -2
  30. package/dist/rules/dispatcher.js.map +1 -1
  31. package/dist/rules/processor.d.ts +2 -0
  32. package/dist/rules/processor.d.ts.map +1 -1
  33. package/dist/rules/processor.js +14 -0
  34. package/dist/rules/processor.js.map +1 -1
  35. package/dist/storage/domains/work-items/base.d.ts +21 -2
  36. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  37. package/dist/storage/domains/work-items/base.js +75 -15
  38. package/dist/storage/domains/work-items/base.js.map +1 -1
  39. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  40. package/dist/storage/domains/work-items/cards.js +2 -1
  41. package/dist/storage/domains/work-items/cards.js.map +1 -1
  42. package/dist/work-items/board-check.d.ts +11 -0
  43. package/dist/work-items/board-check.d.ts.map +1 -0
  44. package/dist/work-items/board-check.js +20 -0
  45. package/dist/work-items/board-check.js.map +1 -0
  46. package/factory-skills/factory-triage/SKILL.md +4 -4
  47. package/package.json +8 -8
@@ -64,6 +64,7 @@ const FACTORY_DISPATCH_FAILURE_CODES = [
64
64
  "unsupported_provider_item",
65
65
  "notification_delivery_failed",
66
66
  "run_terminal_event_missing",
67
+ "run_incomplete",
67
68
  "skill_delivery_ambiguous",
68
69
  "run_overdue",
69
70
  "repository_git_missing",
@@ -241,7 +242,8 @@ function toWorkItem(row) {
241
242
  revision: row.revision,
242
243
  createdBy: row.created_by,
243
244
  createdAt: row.created_at,
244
- updatedAt: row.updated_at
245
+ updatedAt: row.updated_at,
246
+ changedAt: row.changed_at ?? null
245
247
  };
246
248
  }
247
249
  const toRow = toWorkItem;
@@ -1037,7 +1039,9 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1037
1039
  }
1038
1040
  /** Refresh source evidence without changing work identity or board concurrency tokens. */
1039
1041
  async syncWorkItemSource(params) {
1040
- await this.#withTransaction((ops) => this.#syncWorkItemSource(ops, params));
1042
+ await this.#withTransaction(async (ops) => {
1043
+ await this.#syncWorkItemSource(ops, params);
1044
+ });
1041
1045
  }
1042
1046
  async #syncWorkItemSource(ops, { orgId, factoryProjectId, provider, externalId, patch, expectedRevision }) {
1043
1047
  const where = {
@@ -1077,7 +1081,10 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1077
1081
  updated_at: /* @__PURE__ */ new Date()
1078
1082
  };
1079
1083
  });
1080
- if (card && synced) await ops.updateMany(FACTORY_BOARD_ITEMS_SCHEMA.name, card, { changed_at: /* @__PURE__ */ new Date() });
1084
+ if (!card || !synced) return void 0;
1085
+ const changed_at = /* @__PURE__ */ new Date();
1086
+ await ops.updateMany(FACTORY_BOARD_ITEMS_SCHEMA.name, card, { changed_at });
1087
+ return changed_at;
1081
1088
  }
1082
1089
  /**
1083
1090
  * File one more external record on an existing card: a pull request on the
@@ -1132,6 +1139,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1132
1139
  async syncCard({ orgId, id, userId, patch, expectedSourceRevision, fillOnly = false }) {
1133
1140
  return this.#withTransaction(async (ops) => {
1134
1141
  let previous = emptyPrior();
1142
+ let stamped;
1135
1143
  const row = await this.#cards(ops, { transaction: true }).updateAtomic({
1136
1144
  org_id: orgId,
1137
1145
  id
@@ -1153,7 +1161,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1153
1161
  }
1154
1162
  const adapter = workItemProviderAdapter(item.externalSource);
1155
1163
  const split = splitCardMetadata(patch.metadata, adapter.providerMetadataKeys);
1156
- if (Object.keys(split.provider ?? {}).length > 0) await this.#syncWorkItemSource(ops, {
1164
+ if (Object.keys(split.provider ?? {}).length > 0) stamped = await this.#syncWorkItemSource(ops, {
1157
1165
  orgId,
1158
1166
  factoryProjectId: item.factoryProjectId,
1159
1167
  provider: source.provider,
@@ -1188,10 +1196,16 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1188
1196
  }
1189
1197
  });
1190
1198
  });
1191
- return row ? {
1192
- item: toWorkItem(row),
1199
+ if (!row) return null;
1200
+ const item = toWorkItem(row);
1201
+ const changedAt = stamped && !(item.changedAt && item.changedAt > stamped) ? stamped : item.changedAt;
1202
+ return {
1203
+ item: {
1204
+ ...item,
1205
+ changedAt
1206
+ },
1193
1207
  previous
1194
- } : null;
1208
+ };
1195
1209
  });
1196
1210
  }
1197
1211
  async dangerouslyClearAll() {
@@ -1372,6 +1386,13 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1372
1386
  factory_project_id: factoryProjectId
1373
1387
  }, { orderBy: [["created_at", "desc"], ["id", "desc"]] })).map(toWorkItem);
1374
1388
  }
1389
+ /** The ids deleted after `from`. */
1390
+ #removedSince(scope, from) {
1391
+ return super.ops.findMany(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, scope, {
1392
+ orderBy: [["deleted_at", "asc"]],
1393
+ cursor: { values: [from] }
1394
+ });
1395
+ }
1375
1396
  /**
1376
1397
  * `previous` updated with the cards changed or deleted since `since`. Reads from a few seconds
1377
1398
  * earlier so a writer whose clock runs behind this one is still caught.
@@ -1385,10 +1406,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1385
1406
  const [rows, tombstones] = await Promise.all([this.#cards(super.ops, { transaction: true }).findMany(scope, {
1386
1407
  orderBy: [["changed_at", "asc"]],
1387
1408
  cursor: { values: [from] }
1388
- }), super.ops.findMany(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, scope, {
1389
- orderBy: [["deleted_at", "asc"]],
1390
- cursor: { values: [from] }
1391
- })]);
1409
+ }), this.#removedSince(scope, from)]);
1392
1410
  if (rows.length === 0 && tombstones.length === 0) return [...previous];
1393
1411
  const changed = new Map(rows.map((row) => [row.id, toWorkItem(row)]));
1394
1412
  const deleted = new Set(tombstones.map((row) => row.id));
@@ -1418,14 +1436,54 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1418
1436
  async listShared({ orgId, factoryProjectId }) {
1419
1437
  return (await this.#listCached(orgId, factoryProjectId)).items;
1420
1438
  }
1421
- /** `cached` is true when `items` is shared with other callers, which callers that mutate must clone. */
1439
+ /**
1440
+ * {@link listShared} for a reader that keeps the board between reads. `cursor` names this read.
1441
+ * Sent back as `since`, it adds what moved since that read: `changed`, the listed cards written
1442
+ * since, and `removed`, the ids no longer listed. Without them only the whole list answers: no
1443
+ * cursor or one this didn't issue, or a board showing Review cards, which move without a write.
1444
+ */
1445
+ async listSharedSince(scope) {
1446
+ const { items, readFrom } = await this.#listCached(scope.orgId, scope.factoryProjectId);
1447
+ if (readFrom === void 0 || items.some((card) => card.board === "review")) return { items };
1448
+ const cursor = String(readFrom);
1449
+ if (scope.since === void 0) return {
1450
+ items,
1451
+ cursor
1452
+ };
1453
+ if (scope.since === cursor) return {
1454
+ items,
1455
+ cursor,
1456
+ changed: [],
1457
+ removed: []
1458
+ };
1459
+ const from = /* @__PURE__ */ new Date(Number(scope.since) - LIST_DELTA_CLOCK_SKEW_MS);
1460
+ const gone = await this.#removedSince({
1461
+ org_id: scope.orgId,
1462
+ factory_project_id: scope.factoryProjectId
1463
+ }, from);
1464
+ const removed = new Set(gone.map((row) => row.id));
1465
+ return {
1466
+ items,
1467
+ cursor,
1468
+ changed: items.filter((card) => {
1469
+ removed.delete(card.id);
1470
+ return card.changedAt && new Date(card.changedAt) > from;
1471
+ }),
1472
+ removed: [...removed]
1473
+ };
1474
+ }
1475
+ /**
1476
+ * `cached` is true when `items` is shared with other callers, which callers that mutate must clone.
1477
+ * `readFrom` is when the read that produced a cached `items` began.
1478
+ */
1422
1479
  async #listCached(orgId, factoryProjectId) {
1423
1480
  const key = `${orgId}\u0000${factoryProjectId}`;
1424
1481
  const version = await readBoardVersion(super.ops, orgId, factoryProjectId);
1425
1482
  const hit = this.#listCache.get(key);
1426
1483
  if (version && hit?.version === version && Date.now() - hit.takenAt < LIST_CACHE_TTL_MS) return {
1427
1484
  items: hit.items,
1428
- cached: true
1485
+ cached: true,
1486
+ readFrom: hit.readFrom
1429
1487
  };
1430
1488
  if (!version) {
1431
1489
  const items = await this.#listWithOps(super.ops, orgId, factoryProjectId);
@@ -1438,7 +1496,8 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1438
1496
  const inFlight = this.#listInFlight.get(key);
1439
1497
  if (inFlight?.version === version && Date.now() - inFlight.startedAt < LIST_CACHE_TTL_MS) return {
1440
1498
  items: await inFlight.items,
1441
- cached: true
1499
+ cached: true,
1500
+ readFrom: inFlight.startedAt
1442
1501
  };
1443
1502
  const startedAt = Date.now();
1444
1503
  const delta = hit && startedAt - hit.takenAt < LIST_CACHE_TTL_MS && !hit.items.some((card) => card.board === "review");
@@ -1462,7 +1521,8 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1462
1521
  }
1463
1522
  return {
1464
1523
  items,
1465
- cached: true
1524
+ cached: true,
1525
+ readFrom: startedAt
1466
1526
  };
1467
1527
  } finally {
1468
1528
  if (this.#listInFlight.get(key)?.items === read) this.#listInFlight.delete(key);