@mastra/factory 0.28.0-alpha.10 → 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 (82) hide show
  1. package/README.md +18 -14
  2. package/dist/capabilities/version-control.d.ts +6 -1
  3. package/dist/capabilities/version-control.d.ts.map +1 -1
  4. package/dist/environment/build-schedule.js +1 -1
  5. package/dist/environment/build-schedule.js.map +1 -1
  6. package/dist/environment/build.d.ts +3 -3
  7. package/dist/environment/build.d.ts.map +1 -1
  8. package/dist/environment/build.js +3 -1
  9. package/dist/environment/build.js.map +1 -1
  10. package/dist/environment/heads.d.ts +1 -1
  11. package/dist/environment/heads.d.ts.map +1 -1
  12. package/dist/environment/heads.js +4 -1
  13. package/dist/environment/heads.js.map +1 -1
  14. package/dist/environment/repository-access.d.ts +13 -0
  15. package/dist/environment/repository-access.d.ts.map +1 -0
  16. package/dist/environment/repository-access.js +55 -0
  17. package/dist/environment/repository-access.js.map +1 -0
  18. package/dist/factory.d.ts.map +1 -1
  19. package/dist/factory.js +3 -1
  20. package/dist/factory.js.map +1 -1
  21. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  22. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  23. package/dist/integrations/platform/github/integration.js +18 -12
  24. package/dist/integrations/platform/github/integration.js.map +1 -1
  25. package/dist/integrations/slack/integration.d.ts.map +1 -1
  26. package/dist/integrations/slack/integration.js +7 -4
  27. package/dist/integrations/slack/integration.js.map +1 -1
  28. package/dist/mcp/routes.d.ts.map +1 -1
  29. package/dist/mcp/routes.js +3 -5
  30. package/dist/mcp/routes.js.map +1 -1
  31. package/dist/routes/board-snapshot.d.ts +12 -1
  32. package/dist/routes/board-snapshot.d.ts.map +1 -1
  33. package/dist/routes/board-snapshot.js +43 -7
  34. package/dist/routes/board-snapshot.js.map +1 -1
  35. package/dist/routes/contracts.d.ts +33 -0
  36. package/dist/routes/contracts.d.ts.map +1 -1
  37. package/dist/routes/contracts.js +50 -5
  38. package/dist/routes/contracts.js.map +1 -1
  39. package/dist/routes/work-item-selection.d.ts +16 -0
  40. package/dist/routes/work-item-selection.d.ts.map +1 -0
  41. package/dist/routes/work-item-selection.js +56 -0
  42. package/dist/routes/work-item-selection.js.map +1 -0
  43. package/dist/routes/work-items.d.ts.map +1 -1
  44. package/dist/routes/work-items.js +102 -15
  45. package/dist/routes/work-items.js.map +1 -1
  46. package/dist/rules/dispatch-errors.d.ts.map +1 -1
  47. package/dist/rules/dispatch-errors.js +4 -0
  48. package/dist/rules/dispatch-errors.js.map +1 -1
  49. package/dist/rules/dispatcher.d.ts +2 -1
  50. package/dist/rules/dispatcher.d.ts.map +1 -1
  51. package/dist/rules/dispatcher.js +35 -2
  52. package/dist/rules/dispatcher.js.map +1 -1
  53. package/dist/rules/processor.d.ts +2 -0
  54. package/dist/rules/processor.d.ts.map +1 -1
  55. package/dist/rules/processor.js +14 -0
  56. package/dist/rules/processor.js.map +1 -1
  57. package/dist/session/live-sessions.d.ts +1 -1
  58. package/dist/session/live-sessions.d.ts.map +1 -1
  59. package/dist/session/live-sessions.js +12 -2
  60. package/dist/session/live-sessions.js.map +1 -1
  61. package/dist/storage/domains/work-items/base.d.ts +21 -2
  62. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  63. package/dist/storage/domains/work-items/base.js +89 -16
  64. package/dist/storage/domains/work-items/base.js.map +1 -1
  65. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  66. package/dist/storage/domains/work-items/cards.js +3 -2
  67. package/dist/storage/domains/work-items/cards.js.map +1 -1
  68. package/dist/work-items/board-check.d.ts +11 -0
  69. package/dist/work-items/board-check.d.ts.map +1 -0
  70. package/dist/work-items/board-check.js +20 -0
  71. package/dist/work-items/board-check.js.map +1 -0
  72. package/dist/work-items/related-cards.d.ts +21 -0
  73. package/dist/work-items/related-cards.d.ts.map +1 -0
  74. package/dist/work-items/related-cards.js +45 -0
  75. package/dist/work-items/related-cards.js.map +1 -0
  76. package/dist/workspace.d.ts.map +1 -1
  77. package/dist/workspace.js +7 -14
  78. package/dist/workspace.js.map +1 -1
  79. package/factory-skills/factory-build/SKILL.md +1 -1
  80. package/factory-skills/factory-self-review/SKILL.md +1 -1
  81. package/factory-skills/factory-triage/SKILL.md +4 -4
  82. package/package.json +9 -9
@@ -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,9 +1039,21 @@ 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 }) {
1047
+ const where = {
1048
+ org_id: orgId,
1049
+ factory_project_id: factoryProjectId,
1050
+ provider,
1051
+ external_id: externalId
1052
+ };
1053
+ const source = await ops.findOne(FACTORY_WORK_ITEM_SOURCES_SCHEMA.name, where);
1054
+ const card = source && { work_item_id: source.work_item_id };
1055
+ if (card) await ops.updateAtomic(FACTORY_BOARD_ITEMS_SCHEMA.name, card, () => null);
1056
+ let synced = false;
1043
1057
  await ops.updateAtomic(FACTORY_WORK_ITEM_SOURCES_SCHEMA.name, {
1044
1058
  org_id: orgId,
1045
1059
  factory_project_id: factoryProjectId,
@@ -1049,6 +1063,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1049
1063
  if (expectedRevision !== void 0 && current.revision !== expectedRevision) throw new WorkItemUpdateConflictError("revision");
1050
1064
  const next = typeof patch === "function" ? patch(current) : patch;
1051
1065
  if (!next) return null;
1066
+ synced = true;
1052
1067
  const { metadata, ...facts } = next;
1053
1068
  const nextMetadata = metadata === null ? null : {
1054
1069
  ...current.metadata,
@@ -1066,6 +1081,10 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1066
1081
  updated_at: /* @__PURE__ */ new Date()
1067
1082
  };
1068
1083
  });
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;
1069
1088
  }
1070
1089
  /**
1071
1090
  * File one more external record on an existing card: a pull request on the
@@ -1120,6 +1139,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1120
1139
  async syncCard({ orgId, id, userId, patch, expectedSourceRevision, fillOnly = false }) {
1121
1140
  return this.#withTransaction(async (ops) => {
1122
1141
  let previous = emptyPrior();
1142
+ let stamped;
1123
1143
  const row = await this.#cards(ops, { transaction: true }).updateAtomic({
1124
1144
  org_id: orgId,
1125
1145
  id
@@ -1141,7 +1161,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1141
1161
  }
1142
1162
  const adapter = workItemProviderAdapter(item.externalSource);
1143
1163
  const split = splitCardMetadata(patch.metadata, adapter.providerMetadataKeys);
1144
- if (Object.keys(split.provider ?? {}).length > 0) await this.#syncWorkItemSource(ops, {
1164
+ if (Object.keys(split.provider ?? {}).length > 0) stamped = await this.#syncWorkItemSource(ops, {
1145
1165
  orgId,
1146
1166
  factoryProjectId: item.factoryProjectId,
1147
1167
  provider: source.provider,
@@ -1176,10 +1196,16 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1176
1196
  }
1177
1197
  });
1178
1198
  });
1179
- return row ? {
1180
- 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
+ },
1181
1207
  previous
1182
- } : null;
1208
+ };
1183
1209
  });
1184
1210
  }
1185
1211
  async dangerouslyClearAll() {
@@ -1360,6 +1386,13 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1360
1386
  factory_project_id: factoryProjectId
1361
1387
  }, { orderBy: [["created_at", "desc"], ["id", "desc"]] })).map(toWorkItem);
1362
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
+ }
1363
1396
  /**
1364
1397
  * `previous` updated with the cards changed or deleted since `since`. Reads from a few seconds
1365
1398
  * earlier so a writer whose clock runs behind this one is still caught.
@@ -1373,10 +1406,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1373
1406
  const [rows, tombstones] = await Promise.all([this.#cards(super.ops, { transaction: true }).findMany(scope, {
1374
1407
  orderBy: [["changed_at", "asc"]],
1375
1408
  cursor: { values: [from] }
1376
- }), super.ops.findMany(FACTORY_BOARD_ITEM_TOMBSTONES_SCHEMA.name, scope, {
1377
- orderBy: [["deleted_at", "asc"]],
1378
- cursor: { values: [from] }
1379
- })]);
1409
+ }), this.#removedSince(scope, from)]);
1380
1410
  if (rows.length === 0 && tombstones.length === 0) return [...previous];
1381
1411
  const changed = new Map(rows.map((row) => [row.id, toWorkItem(row)]));
1382
1412
  const deleted = new Set(tombstones.map((row) => row.id));
@@ -1406,14 +1436,54 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1406
1436
  async listShared({ orgId, factoryProjectId }) {
1407
1437
  return (await this.#listCached(orgId, factoryProjectId)).items;
1408
1438
  }
1409
- /** `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
+ */
1410
1479
  async #listCached(orgId, factoryProjectId) {
1411
1480
  const key = `${orgId}\u0000${factoryProjectId}`;
1412
1481
  const version = await readBoardVersion(super.ops, orgId, factoryProjectId);
1413
1482
  const hit = this.#listCache.get(key);
1414
1483
  if (version && hit?.version === version && Date.now() - hit.takenAt < LIST_CACHE_TTL_MS) return {
1415
1484
  items: hit.items,
1416
- cached: true
1485
+ cached: true,
1486
+ readFrom: hit.readFrom
1417
1487
  };
1418
1488
  if (!version) {
1419
1489
  const items = await this.#listWithOps(super.ops, orgId, factoryProjectId);
@@ -1426,10 +1496,12 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1426
1496
  const inFlight = this.#listInFlight.get(key);
1427
1497
  if (inFlight?.version === version && Date.now() - inFlight.startedAt < LIST_CACHE_TTL_MS) return {
1428
1498
  items: await inFlight.items,
1429
- cached: true
1499
+ cached: true,
1500
+ readFrom: inFlight.startedAt
1430
1501
  };
1431
1502
  const startedAt = Date.now();
1432
- const read = (hit && startedAt - hit.takenAt < LIST_CACHE_TTL_MS ? this.#listDelta(orgId, factoryProjectId, hit.items, hit.readFrom) : this.#listWithOps(super.ops, orgId, factoryProjectId)).then(deepFreeze);
1503
+ const delta = hit && startedAt - hit.takenAt < LIST_CACHE_TTL_MS && !hit.items.some((card) => card.board === "review");
1504
+ const read = (delta ? this.#listDelta(orgId, factoryProjectId, hit.items, hit.readFrom) : this.#listWithOps(super.ops, orgId, factoryProjectId)).then(deepFreeze);
1433
1505
  this.#listInFlight.set(key, {
1434
1506
  version,
1435
1507
  startedAt,
@@ -1441,7 +1513,7 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1441
1513
  this.#listCache.delete(key);
1442
1514
  this.#listCache.set(key, {
1443
1515
  version,
1444
- takenAt: hit && startedAt - hit.takenAt < LIST_CACHE_TTL_MS ? hit.takenAt : Date.now(),
1516
+ takenAt: delta ? hit.takenAt : Date.now(),
1445
1517
  readFrom: startedAt,
1446
1518
  items
1447
1519
  });
@@ -1449,7 +1521,8 @@ var WorkItemsStorage = class extends FactoryStorageDomain {
1449
1521
  }
1450
1522
  return {
1451
1523
  items,
1452
- cached: true
1524
+ cached: true,
1525
+ readFrom: startedAt
1453
1526
  };
1454
1527
  } finally {
1455
1528
  if (this.#listInFlight.get(key)?.items === read) this.#listInFlight.delete(key);