@mastra/factory 0.28.0-alpha.9 → 0.28.0

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 (184) hide show
  1. package/README.md +61 -42
  2. package/dist/boards/board-writes.d.ts +3 -3
  3. package/dist/boards/board-writes.d.ts.map +1 -1
  4. package/dist/boards/board-writes.js +24 -20
  5. package/dist/boards/board-writes.js.map +1 -1
  6. package/dist/boards/project-boards.d.ts +20 -0
  7. package/dist/boards/project-boards.d.ts.map +1 -1
  8. package/dist/boards/project-boards.js +35 -11
  9. package/dist/boards/project-boards.js.map +1 -1
  10. package/dist/boards/registry.d.ts.map +1 -1
  11. package/dist/boards/registry.js +0 -3
  12. package/dist/boards/registry.js.map +1 -1
  13. package/dist/capabilities/version-control.d.ts +6 -1
  14. package/dist/capabilities/version-control.d.ts.map +1 -1
  15. package/dist/environment/build-runner.d.ts +13 -2
  16. package/dist/environment/build-runner.d.ts.map +1 -1
  17. package/dist/environment/build-runner.js +42 -0
  18. package/dist/environment/build-runner.js.map +1 -1
  19. package/dist/environment/build-schedule.js +1 -1
  20. package/dist/environment/build-schedule.js.map +1 -1
  21. package/dist/environment/build-workflow.d.ts +6 -4
  22. package/dist/environment/build-workflow.d.ts.map +1 -1
  23. package/dist/environment/build-workflow.js +70 -66
  24. package/dist/environment/build-workflow.js.map +1 -1
  25. package/dist/environment/build.d.ts +22 -7
  26. package/dist/environment/build.d.ts.map +1 -1
  27. package/dist/environment/build.js +73 -15
  28. package/dist/environment/build.js.map +1 -1
  29. package/dist/environment/heads.d.ts +1 -1
  30. package/dist/environment/heads.d.ts.map +1 -1
  31. package/dist/environment/heads.js +4 -1
  32. package/dist/environment/heads.js.map +1 -1
  33. package/dist/environment/repository-access.d.ts +13 -0
  34. package/dist/environment/repository-access.d.ts.map +1 -0
  35. package/dist/environment/repository-access.js +55 -0
  36. package/dist/environment/repository-access.js.map +1 -0
  37. package/dist/factory.d.ts +5 -2
  38. package/dist/factory.d.ts.map +1 -1
  39. package/dist/factory.js +32 -25
  40. package/dist/factory.js.map +1 -1
  41. package/dist/integrations/github/sandbox-release.d.ts +12 -0
  42. package/dist/integrations/github/sandbox-release.d.ts.map +1 -1
  43. package/dist/integrations/github/sandbox-release.js +16 -1
  44. package/dist/integrations/github/sandbox-release.js.map +1 -1
  45. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  46. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  47. package/dist/integrations/platform/github/integration.js +137 -105
  48. package/dist/integrations/platform/github/integration.js.map +1 -1
  49. package/dist/integrations/platform/jira/integration.d.ts.map +1 -1
  50. package/dist/integrations/platform/jira/integration.js +5 -1
  51. package/dist/integrations/platform/jira/integration.js.map +1 -1
  52. package/dist/integrations/slack/integration.d.ts.map +1 -1
  53. package/dist/integrations/slack/integration.js +7 -4
  54. package/dist/integrations/slack/integration.js.map +1 -1
  55. package/dist/mcp/routes.d.ts.map +1 -1
  56. package/dist/mcp/routes.js +3 -5
  57. package/dist/mcp/routes.js.map +1 -1
  58. package/dist/routes/board-snapshot.d.ts +17 -1
  59. package/dist/routes/board-snapshot.d.ts.map +1 -1
  60. package/dist/routes/board-snapshot.js +54 -7
  61. package/dist/routes/board-snapshot.js.map +1 -1
  62. package/dist/routes/boards.d.ts +2 -3
  63. package/dist/routes/boards.d.ts.map +1 -1
  64. package/dist/routes/boards.js.map +1 -1
  65. package/dist/routes/contracts.d.ts +102 -0
  66. package/dist/routes/contracts.d.ts.map +1 -1
  67. package/dist/routes/contracts.js +96 -6
  68. package/dist/routes/contracts.js.map +1 -1
  69. package/dist/routes/projects.d.ts.map +1 -1
  70. package/dist/routes/projects.js +5 -0
  71. package/dist/routes/projects.js.map +1 -1
  72. package/dist/routes/sandbox-envs.d.ts +2 -0
  73. package/dist/routes/sandbox-envs.d.ts.map +1 -1
  74. package/dist/routes/sandbox-envs.js +3 -0
  75. package/dist/routes/sandbox-envs.js.map +1 -1
  76. package/dist/routes/source-control-settings.d.ts +2 -0
  77. package/dist/routes/source-control-settings.d.ts.map +1 -1
  78. package/dist/routes/source-control-settings.js +5 -0
  79. package/dist/routes/source-control-settings.js.map +1 -1
  80. package/dist/routes/surface.d.ts +2 -0
  81. package/dist/routes/surface.d.ts.map +1 -1
  82. package/dist/routes/surface.js +2 -1
  83. package/dist/routes/surface.js.map +1 -1
  84. package/dist/routes/work-item-activity.d.ts +11 -0
  85. package/dist/routes/work-item-activity.d.ts.map +1 -0
  86. package/dist/routes/work-item-activity.js +25 -0
  87. package/dist/routes/work-item-activity.js.map +1 -0
  88. package/dist/routes/work-item-selection.d.ts +18 -0
  89. package/dist/routes/work-item-selection.d.ts.map +1 -0
  90. package/dist/routes/work-item-selection.js +61 -0
  91. package/dist/routes/work-item-selection.js.map +1 -0
  92. package/dist/routes/work-item-starters.d.ts +29 -0
  93. package/dist/routes/work-item-starters.d.ts.map +1 -0
  94. package/dist/routes/work-item-starters.js +169 -0
  95. package/dist/routes/work-item-starters.js.map +1 -0
  96. package/dist/routes/work-items.d.ts.map +1 -1
  97. package/dist/routes/work-items.js +162 -15
  98. package/dist/routes/work-items.js.map +1 -1
  99. package/dist/rules/dispatch-errors.d.ts.map +1 -1
  100. package/dist/rules/dispatch-errors.js +4 -0
  101. package/dist/rules/dispatch-errors.js.map +1 -1
  102. package/dist/rules/dispatcher.d.ts +2 -1
  103. package/dist/rules/dispatcher.d.ts.map +1 -1
  104. package/dist/rules/dispatcher.js +84 -16
  105. package/dist/rules/dispatcher.js.map +1 -1
  106. package/dist/rules/processor.d.ts +2 -0
  107. package/dist/rules/processor.d.ts.map +1 -1
  108. package/dist/rules/processor.js +18 -4
  109. package/dist/rules/processor.js.map +1 -1
  110. package/dist/rules/transition-service.d.ts +20 -2
  111. package/dist/rules/transition-service.d.ts.map +1 -1
  112. package/dist/rules/transition-service.js +40 -18
  113. package/dist/rules/transition-service.js.map +1 -1
  114. package/dist/sandbox/context-sandboxes.d.ts +70 -0
  115. package/dist/sandbox/context-sandboxes.d.ts.map +1 -0
  116. package/dist/sandbox/context-sandboxes.js +120 -0
  117. package/dist/sandbox/context-sandboxes.js.map +1 -0
  118. package/dist/sandbox/session-retirement.d.ts +11 -4
  119. package/dist/sandbox/session-retirement.d.ts.map +1 -1
  120. package/dist/sandbox/session-retirement.js +39 -13
  121. package/dist/sandbox/session-retirement.js.map +1 -1
  122. package/dist/session/live-sessions.d.ts +1 -1
  123. package/dist/session/live-sessions.d.ts.map +1 -1
  124. package/dist/session/live-sessions.js +12 -2
  125. package/dist/session/live-sessions.js.map +1 -1
  126. package/dist/storage/domains/boards/base.d.ts +25 -5
  127. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  128. package/dist/storage/domains/boards/base.js +57 -20
  129. package/dist/storage/domains/boards/base.js.map +1 -1
  130. package/dist/storage/domains/projects/base.d.ts +8 -2
  131. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  132. package/dist/storage/domains/projects/base.js +21 -4
  133. package/dist/storage/domains/projects/base.js.map +1 -1
  134. package/dist/storage/domains/work-items/base.d.ts +47 -6
  135. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  136. package/dist/storage/domains/work-items/base.js +161 -17
  137. package/dist/storage/domains/work-items/base.js.map +1 -1
  138. package/dist/storage/domains/work-items/cards.d.ts +1 -0
  139. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  140. package/dist/storage/domains/work-items/cards.js +32 -8
  141. package/dist/storage/domains/work-items/cards.js.map +1 -1
  142. package/dist/storage/domains/work-items/legacy-review.d.ts +19 -1
  143. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -1
  144. package/dist/storage/domains/work-items/legacy-review.js +62 -3
  145. package/dist/storage/domains/work-items/legacy-review.js.map +1 -1
  146. package/dist/storage/domains/work-items/work-item-schema.d.ts +1 -0
  147. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  148. package/dist/storage/domains/work-items/work-item-schema.js +46 -18
  149. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  150. package/dist/tools/annotations.d.ts.map +1 -1
  151. package/dist/tools/annotations.js +4 -0
  152. package/dist/tools/annotations.js.map +1 -1
  153. package/dist/tools/audit-events-tool.d.ts +29 -0
  154. package/dist/tools/audit-events-tool.d.ts.map +1 -0
  155. package/dist/tools/audit-events-tool.js +180 -0
  156. package/dist/tools/audit-events-tool.js.map +1 -0
  157. package/dist/tools/index.d.ts +2 -1
  158. package/dist/tools/index.d.ts.map +1 -1
  159. package/dist/tools/index.js +2 -0
  160. package/dist/tools/index.js.map +1 -1
  161. package/dist/tools/permissions.d.ts.map +1 -1
  162. package/dist/tools/permissions.js +1 -0
  163. package/dist/tools/permissions.js.map +1 -1
  164. package/dist/tools/sessions-state-processor.js +1 -1
  165. package/dist/tools/sessions-state-processor.js.map +1 -1
  166. package/dist/work-items/board-check.d.ts +11 -0
  167. package/dist/work-items/board-check.d.ts.map +1 -0
  168. package/dist/work-items/board-check.js +20 -0
  169. package/dist/work-items/board-check.js.map +1 -0
  170. package/dist/work-items/related-cards.d.ts +21 -0
  171. package/dist/work-items/related-cards.d.ts.map +1 -0
  172. package/dist/work-items/related-cards.js +45 -0
  173. package/dist/work-items/related-cards.js.map +1 -0
  174. package/dist/work-items/split-migration.d.ts.map +1 -1
  175. package/dist/work-items/split-migration.js +6 -2
  176. package/dist/work-items/split-migration.js.map +1 -1
  177. package/dist/workspace.d.ts +0 -1
  178. package/dist/workspace.d.ts.map +1 -1
  179. package/dist/workspace.js +49 -32
  180. package/dist/workspace.js.map +1 -1
  181. package/factory-skills/factory-build/SKILL.md +1 -1
  182. package/factory-skills/factory-self-review/SKILL.md +1 -1
  183. package/factory-skills/factory-triage/SKILL.md +4 -4
  184. package/package.json +16 -16
@@ -0,0 +1,169 @@
1
+ import "../boards/index.js";
2
+ import { boardFlow, boardForWorkItem, isPullRequestCard } from "../boards/semantics.js";
3
+ import { workItemBranchSource } from "../work-item-branch.js";
4
+ // src/routes/work-item-starters.ts
5
+ /**
6
+ * The decisions a board's cards show their run state from: one page of these statuses, newest
7
+ * first. Failures older than that page are not counted, on the cards or here.
8
+ */
9
+ const CARD_DECISION_STATUSES = [
10
+ "pending",
11
+ "proposed",
12
+ "leased",
13
+ "retry",
14
+ "failed"
15
+ ];
16
+ const CARD_DECISION_PAGE_SIZE = 50;
17
+ /** A pull request waiting longer than this is stale rather than waiting for review. */
18
+ const REVIEW_HORIZON_MS = 2592e6;
19
+ /** Labels GitHub ships with every repository: they say what kind of issue it is, not which area. */
20
+ const GITHUB_TYPE_LABELS = [
21
+ "bug",
22
+ "documentation",
23
+ "duplicate",
24
+ "enhancement",
25
+ "good first issue",
26
+ "help wanted",
27
+ "invalid",
28
+ "question",
29
+ "wontfix"
30
+ ];
31
+ /** The cards whose newest decision past proposal failed: a proposal waits on a person, it is not the run's state. */
32
+ function cardsWithFailedRun(decisions) {
33
+ const settled = /* @__PURE__ */ new Set();
34
+ const failed = /* @__PURE__ */ new Set();
35
+ for (const { workItemId, status } of decisions) {
36
+ if (workItemId === null || status === "proposed" || settled.has(workItemId)) continue;
37
+ settled.add(workItemId);
38
+ if (status === "failed") failed.add(workItemId);
39
+ }
40
+ return failed;
41
+ }
42
+ /**
43
+ * What the card's source says about it. A Factory card has no source: its facts are its work
44
+ * item's with the card's own on top, as clients read them. A synced one keeps them on its work item.
45
+ */
46
+ function sourceFacts(card) {
47
+ const { workItem } = card;
48
+ if (workItem.provider === "factory") return {
49
+ ...workItem.metadata,
50
+ ...card.metadata
51
+ };
52
+ return {
53
+ ...workItem.metadata,
54
+ labels: workItem.labels,
55
+ state: workItem.state
56
+ };
57
+ }
58
+ function labelsOf({ labels }) {
59
+ return Array.isArray(labels) ? labels.filter((label) => typeof label === "string") : [];
60
+ }
61
+ function isPullRequest(card) {
62
+ return isPullRequestCard({ source: workItemBranchSource(card.externalSource) });
63
+ }
64
+ /** An open pull request that is not a draft. A source that reports no state is read off the card: `finished` says it sits in a terminal phase. */
65
+ function isOpenPullRequest(facts, finished) {
66
+ if (facts.state === "merged" || facts.merged === true || facts.state === "closed") return false;
67
+ if (facts.state !== "open" && finished) return false;
68
+ return facts.draft !== true;
69
+ }
70
+ function openedAt(card, { sourceCreatedAt }) {
71
+ const opened = typeof sourceCreatedAt === "string" ? Date.parse(sourceCreatedAt) : NaN;
72
+ return Number.isNaN(opened) ? card.createdAt.getTime() : opened;
73
+ }
74
+ /** A review verdict given on an earlier head no longer speaks for the pull request. */
75
+ function verdictOutdated({ reviewedHeadSha, pullRequestHeadSha }) {
76
+ return typeof reviewedHeadSha === "string" && typeof pullRequestHeadSha === "string" && reviewedHeadSha.toLowerCase() !== pullRequestHeadSha.toLowerCase();
77
+ }
78
+ function starterSeats(board, flow) {
79
+ const working = Object.keys(board.phases).filter((phase) => board.phaseKind(phase) === "working");
80
+ const triageContext = flow.triage === void 0 ? void 0 : board.roleForPhase(flow.triage);
81
+ const build = flow.build;
82
+ return {
83
+ working,
84
+ ...flow.triage !== void 0 && triageContext !== void 0 ? { triage: {
85
+ phase: flow.triage,
86
+ context: triageContext
87
+ } } : {},
88
+ ...flow.buildRole !== void 0 ? { planner: flow.buildRole } : {},
89
+ ...build !== void 0 ? { planPhase: working.find((phase) => phase !== build && board.roleForPhase(phase) === flow.buildRole && board.allowsTransition(phase, build)) } : {}
90
+ };
91
+ }
92
+ /**
93
+ * Whether a triaged card resting in the first phase waits on a person's decision: its next move
94
+ * is still triage, because no later working phase has held it.
95
+ */
96
+ function awaitsTriageDecision(board, seats, card) {
97
+ const { triage } = seats;
98
+ if (!triage || card.sessions[triage.context] === void 0) return false;
99
+ const deepest = seats.working.findLast((phase) => card.stageHistory.some((entry) => entry.stage === phase));
100
+ if (deepest === void 0) return true;
101
+ return (board.allowsTransition(board.initialPhase, deepest) ? deepest : seats.planPhase ?? deepest) === triage.phase;
102
+ }
103
+ /**
104
+ * Count the cards behind each starter. `cards` are the project's cards as storage holds them,
105
+ * `failedCardIds` the cards whose run failed ({@link cardsWithFailedRun}).
106
+ */
107
+ function workItemStarters({ board, cards, failedCardIds, now }) {
108
+ const starters = {
109
+ failed: 0,
110
+ changesRequested: 0,
111
+ review: { count: 0 },
112
+ undecided: 0,
113
+ untriaged: 0,
114
+ unplannedBugs: 0,
115
+ stale: 0
116
+ };
117
+ if (!board) return starters;
118
+ const flow = boardFlow(board);
119
+ const seats = starterSeats(board, flow);
120
+ const firstPhase = Object.keys(board.phases)[0];
121
+ const triagePhase = flow.triage;
122
+ const horizon = now - REVIEW_HORIZON_MS;
123
+ const areas = /* @__PURE__ */ new Map();
124
+ let oldestOpenedAt = Number.POSITIVE_INFINITY;
125
+ for (const card of cards) {
126
+ const finished = card.stages.some((stage) => board.isTerminal(stage));
127
+ if (failedCardIds.has(card.id) && !finished) starters.failed += 1;
128
+ if (boardForWorkItem(card) !== board.id) continue;
129
+ const resting = card.stages.includes(board.initialPhase) || board.initialPhase === firstPhase && !card.stages.some((stage) => Object.hasOwn(board.phases, stage));
130
+ if (isPullRequest(card)) {
131
+ const facts = sourceFacts(card);
132
+ if (!isOpenPullRequest(facts, finished)) continue;
133
+ const verdict = {
134
+ ...card.workItem.metadata,
135
+ ...card.metadata
136
+ };
137
+ if (verdict.factoryAuthored === true && verdict.reviewVerdict === "request changes" && !verdictOutdated(verdict)) starters.changesRequested += 1;
138
+ if (!resting) continue;
139
+ const opened = openedAt(card, facts);
140
+ if (opened < horizon) starters.stale += 1;
141
+ else {
142
+ starters.review.count += 1;
143
+ oldestOpenedAt = Math.min(oldestOpenedAt, opened);
144
+ }
145
+ continue;
146
+ }
147
+ if (resting && seats.triage) {
148
+ if (card.sessions[seats.triage.context] === void 0) starters.untriaged += 1;
149
+ else if (awaitsTriageDecision(board, seats, card)) starters.undecided += 1;
150
+ }
151
+ if (!(resting || triagePhase !== void 0 && card.stages.includes(triagePhase))) continue;
152
+ const labels = labelsOf(sourceFacts(card));
153
+ if (seats.planner !== void 0 && labels.some((label) => label.toLowerCase() === "bug") && card.sessions[seats.planner] === void 0 && card.sessions.plan === void 0) starters.unplannedBugs += 1;
154
+ for (const label of labels) {
155
+ if (label.includes(":") || GITHUB_TYPE_LABELS.includes(label.toLowerCase())) continue;
156
+ areas.set(label, (areas.get(label) ?? 0) + 1);
157
+ }
158
+ }
159
+ if (starters.review.count > 0) starters.review.oldestOpenedAt = new Date(oldestOpenedAt).toISOString();
160
+ const [largest] = [...areas].sort(([a, x], [b, y]) => y - x || a.localeCompare(b));
161
+ if (largest) starters.sweep = {
162
+ area: largest[0],
163
+ count: largest[1]
164
+ };
165
+ return starters;
166
+ }
167
+ export { CARD_DECISION_PAGE_SIZE, CARD_DECISION_STATUSES, cardsWithFailedRun, workItemStarters };
168
+
169
+ //# sourceMappingURL=work-item-starters.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"work-item-starters.js","names":[],"sources":["../../src/routes/work-item-starters.ts"],"sourcesContent":["/**\n * What the draft page's starter buttons count: each number is the cards one button would act on,\n * read off the project's default board. The page words the buttons; the rules for which cards\n * count live here, so the page never downloads the board to count them.\n */\n\nimport type { z } from 'zod';\n\nimport type { InstalledBoard } from '../boards/index.js';\nimport { boardFlow, boardForWorkItem, isPullRequestCard } from '../boards/index.js';\nimport type { FactoryRuleBoardFlow } from '../rules/types.js';\nimport type { Card, FactoryDeferredDecisionRecord } from '../storage/domains/work-items/base.js';\nimport { workItemBranchSource } from '../work-item-branch.js';\nimport type { workItemStartersResponseSchema } from './contracts.js';\n\nexport type WorkItemStarters = z.infer<typeof workItemStartersResponseSchema>;\n\n/**\n * The decisions a board's cards show their run state from: one page of these statuses, newest\n * first. Failures older than that page are not counted, on the cards or here.\n */\nexport const CARD_DECISION_STATUSES = ['pending', 'proposed', 'leased', 'retry', 'failed'] as const;\nexport const CARD_DECISION_PAGE_SIZE = 50;\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n/** A pull request waiting longer than this is stale rather than waiting for review. */\nconst REVIEW_HORIZON_MS = 30 * DAY_MS;\n\n/** Labels GitHub ships with every repository: they say what kind of issue it is, not which area. */\nconst GITHUB_TYPE_LABELS = [\n 'bug',\n 'documentation',\n 'duplicate',\n 'enhancement',\n 'good first issue',\n 'help wanted',\n 'invalid',\n 'question',\n 'wontfix',\n];\n\n/** The cards whose newest decision past proposal failed: a proposal waits on a person, it is not the run's state. */\nexport function cardsWithFailedRun(\n decisions: readonly Pick<FactoryDeferredDecisionRecord, 'workItemId' | 'status'>[],\n): Set<string> {\n const settled = new Set<string>();\n const failed = new Set<string>();\n for (const { workItemId, status } of decisions) {\n // A decision about no card says nothing of a card's run.\n if (workItemId === null || status === 'proposed' || settled.has(workItemId)) continue;\n settled.add(workItemId);\n if (status === 'failed') failed.add(workItemId);\n }\n return failed;\n}\n\n/**\n * What the card's source says about it. A Factory card has no source: its facts are its work\n * item's with the card's own on top, as clients read them. A synced one keeps them on its work item.\n */\nfunction sourceFacts(card: Card): Record<string, unknown> {\n const { workItem } = card;\n if (workItem.provider === 'factory') return { ...workItem.metadata, ...card.metadata };\n return { ...workItem.metadata, labels: workItem.labels, state: workItem.state };\n}\n\nfunction labelsOf({ labels }: Record<string, unknown>): string[] {\n return Array.isArray(labels) ? labels.filter((label): label is string => typeof label === 'string') : [];\n}\n\nfunction isPullRequest(card: Card): boolean {\n return isPullRequestCard({ source: workItemBranchSource(card.externalSource) });\n}\n\n/** An open pull request that is not a draft. A source that reports no state is read off the card: `finished` says it sits in a terminal phase. */\nfunction isOpenPullRequest(facts: Record<string, unknown>, finished: boolean): boolean {\n if (facts.state === 'merged' || facts.merged === true || facts.state === 'closed') return false;\n if (facts.state !== 'open' && finished) return false;\n return facts.draft !== true;\n}\n\nfunction openedAt(card: Card, { sourceCreatedAt }: Record<string, unknown>): number {\n const opened = typeof sourceCreatedAt === 'string' ? Date.parse(sourceCreatedAt) : Number.NaN;\n return Number.isNaN(opened) ? card.createdAt.getTime() : opened;\n}\n\n/** A review verdict given on an earlier head no longer speaks for the pull request. */\nfunction verdictOutdated({ reviewedHeadSha, pullRequestHeadSha }: Record<string, unknown>): boolean {\n return (\n typeof reviewedHeadSha === 'string' &&\n typeof pullRequestHeadSha === 'string' &&\n reviewedHeadSha.toLowerCase() !== pullRequestHeadSha.toLowerCase()\n );\n}\n\n/** The seats of a board's loop the starters ask about. */\ninterface StarterSeats {\n /** The phase that triages a card and the context its session is kept under. */\n triage?: { phase: string; context: string };\n /** The context that plans and builds. */\n planner?: string;\n /** The phase that plans before the build, when the board has one. */\n planPhase?: string;\n /** The working phases, in declaration order. */\n working: string[];\n}\n\nfunction starterSeats(board: InstalledBoard, flow: FactoryRuleBoardFlow): StarterSeats {\n const working = Object.keys(board.phases).filter(phase => board.phaseKind(phase) === 'working');\n const triageContext = flow.triage === undefined ? undefined : board.roleForPhase(flow.triage);\n const build = flow.build;\n return {\n working,\n ...(flow.triage !== undefined && triageContext !== undefined\n ? { triage: { phase: flow.triage, context: triageContext } }\n : {}),\n ...(flow.buildRole !== undefined ? { planner: flow.buildRole } : {}),\n ...(build !== undefined\n ? {\n planPhase: working.find(\n phase =>\n phase !== build && board.roleForPhase(phase) === flow.buildRole && board.allowsTransition(phase, build),\n ),\n }\n : {}),\n };\n}\n\n/**\n * Whether a triaged card resting in the first phase waits on a person's decision: its next move\n * is still triage, because no later working phase has held it.\n */\nfunction awaitsTriageDecision(board: InstalledBoard, seats: StarterSeats, card: Card): boolean {\n const { triage } = seats;\n if (!triage || card.sessions[triage.context] === undefined) return false;\n const deepest = seats.working.findLast(phase => card.stageHistory.some(entry => entry.stage === phase));\n if (deepest === undefined) return true;\n const resume = board.allowsTransition(board.initialPhase, deepest) ? deepest : (seats.planPhase ?? deepest);\n return resume === triage.phase;\n}\n\n/**\n * Count the cards behind each starter. `cards` are the project's cards as storage holds them,\n * `failedCardIds` the cards whose run failed ({@link cardsWithFailedRun}).\n */\nexport function workItemStarters({\n board,\n cards,\n failedCardIds,\n now,\n}: {\n board: InstalledBoard | undefined;\n cards: readonly Card[];\n failedCardIds: ReadonlySet<string>;\n now: number;\n}): WorkItemStarters {\n const starters: WorkItemStarters = {\n failed: 0,\n changesRequested: 0,\n review: { count: 0 },\n undecided: 0,\n untriaged: 0,\n unplannedBugs: 0,\n stale: 0,\n };\n if (!board) return starters;\n\n const flow = boardFlow(board);\n const seats = starterSeats(board, flow);\n const firstPhase = Object.keys(board.phases)[0];\n const triagePhase = flow.triage;\n const horizon = now - REVIEW_HORIZON_MS;\n const areas = new Map<string, number>();\n let oldestOpenedAt = Number.POSITIVE_INFINITY;\n\n for (const card of cards) {\n // Finished is judged by the default board's terminal phases for every card, as the buttons always have.\n const finished = card.stages.some(stage => board.isTerminal(stage));\n if (failedCardIds.has(card.id) && !finished) starters.failed += 1;\n if (boardForWorkItem(card) !== board.id) continue;\n\n // A card in none of the board's phases rests in the first one when that is where cards start.\n const resting =\n card.stages.includes(board.initialPhase) ||\n (board.initialPhase === firstPhase && !card.stages.some(stage => Object.hasOwn(board.phases, stage)));\n\n if (isPullRequest(card)) {\n const facts = sourceFacts(card);\n if (!isOpenPullRequest(facts, finished)) continue;\n // Factory's verdict sits on the card, over what the source reports.\n const verdict = { ...card.workItem.metadata, ...card.metadata };\n if (\n verdict.factoryAuthored === true &&\n verdict.reviewVerdict === 'request changes' &&\n !verdictOutdated(verdict)\n ) {\n starters.changesRequested += 1;\n }\n if (!resting) continue;\n const opened = openedAt(card, facts);\n if (opened < horizon) {\n starters.stale += 1;\n } else {\n starters.review.count += 1;\n oldestOpenedAt = Math.min(oldestOpenedAt, opened);\n }\n continue;\n }\n\n if (resting && seats.triage) {\n if (card.sessions[seats.triage.context] === undefined) starters.untriaged += 1;\n else if (awaitsTriageDecision(board, seats, card)) starters.undecided += 1;\n }\n\n const notStarted = resting || (triagePhase !== undefined && card.stages.includes(triagePhase));\n if (!notStarted) continue;\n const labels = labelsOf(sourceFacts(card));\n if (\n seats.planner !== undefined &&\n labels.some(label => label.toLowerCase() === 'bug') &&\n card.sessions[seats.planner] === undefined &&\n // Cards planned before planning moved into the build context hold their planner under `plan`.\n card.sessions.plan === undefined\n ) {\n starters.unplannedBugs += 1;\n }\n for (const label of labels) {\n if (label.includes(':') || GITHUB_TYPE_LABELS.includes(label.toLowerCase())) continue;\n areas.set(label, (areas.get(label) ?? 0) + 1);\n }\n }\n\n if (starters.review.count > 0) starters.review.oldestOpenedAt = new Date(oldestOpenedAt).toISOString();\n const [largest] = [...areas].sort(([a, x], [b, y]) => y - x || a.localeCompare(b));\n if (largest) starters.sweep = { area: largest[0], count: largest[1] };\n return starters;\n}\n"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"work-items.d.ts","sourceRoot":"","sources":["../../src/routes/work-items.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,6BAA6B,CAAC;AAG1F,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAA4B,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAEzG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EAAuB,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAElF,OAAO,KAAK,EACV,mBAAmB,EAEnB,mBAAmB,EAEnB,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAa/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,KAAK,EAAE,YAAY,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,sBAAsB,CAAC;IACjC,kDAAkD;IAClD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kDAAkD;IAClD,oFAAoF;IACpF,aAAa,CAAC,EAAE,aAAa,GAAG,kBAAkB,CAAC;IACnD,6EAA6E;IAC7E,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,iDAAiD;IACjD,WAAW,EAAE,kBAAkB,CAAC;IAChC,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;IACnF,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;IAC5D,2GAA2G;IAC3G,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;CACvE;AAoCD,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAG7E;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAG7E;AAyFD,qBAAa,cAAe,SAAQ,KAAK,CAAC,kBAAkB,CAAC;;IAoH3D,gEAAgE;IAChE,MAAM,IAAI,QAAQ,EAAE,CA+bnB;CACF"}
1
+ {"version":3,"file":"work-items.d.ts","sourceRoot":"","sources":["../../src/routes/work-items.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,6BAA6B,CAAC;AAG1F,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAA4B,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAEzG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EAAuB,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAElF,OAAO,KAAK,EACV,mBAAmB,EAEnB,mBAAmB,EAEnB,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAiB/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAU1C,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,KAAK,EAAE,YAAY,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,sBAAsB,CAAC;IACjC,kDAAkD;IAClD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kDAAkD;IAClD,oFAAoF;IACpF,aAAa,CAAC,EAAE,aAAa,GAAG,kBAAkB,CAAC;IACnD,6EAA6E;IAC7E,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,iDAAiD;IACjD,WAAW,EAAE,kBAAkB,CAAC;IAChC,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;IACnF,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;IAC5D,2GAA2G;IAC3G,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;CACvE;AAmGD,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAG7E;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAG7E;AAyFD,qBAAa,cAAe,SAAQ,KAAK,CAAC,kBAAkB,CAAC;;IAoH3D,gEAAgE;IAChE,MAAM,IAAI,QAAQ,EAAE,CAqhBnB;CACF"}
@@ -1,5 +1,6 @@
1
- import { boardFlow, boardPhaseOutcomes } from "../boards/semantics.js";
2
1
  import "../boards/index.js";
2
+ import { DEFAULT_BOARD_ID } from "../boards/default-board.js";
3
+ import { boardFlow, boardPhaseOutcomes, isPullRequestCard } from "../boards/semantics.js";
3
4
  import { toBoardSource } from "../boards/project-boards.js";
4
5
  import { EXTERNAL_SOURCE_MISSING_KEY } from "../integrations/issue-reconciler.js";
5
6
  import { decisionRetryable, overtakenDecisionIds } from "../rules/decision-applicability.js";
@@ -10,12 +11,17 @@ import { effectiveModelScope } from "../storage/domains/projects/base.js";
10
11
  import { thresholdsOrDefault } from "../storage/domains/queue-health/base.js";
11
12
  import { FACTORY_PULL_REQUEST_RECONCILIATION_KEY, FACTORY_RULE_MATERIALIZATION_KEY, WorkItemRelationError, WorkItemUpdateConflictError } from "../storage/domains/work-items/base.js";
12
13
  import { computeFactoryMetrics, parseMetricsRange } from "../storage/domains/work-items/metrics.js";
14
+ import { workItemBranchSource } from "../work-item-branch.js";
13
15
  import { createFactoryWorkItem } from "../work-items/create-work-item.js";
14
16
  import { resolveFactoryProposal, retryFactoryDecision } from "../work-items/decision-actions.js";
17
+ import { relatedCardIndex } from "../work-items/related-cards.js";
15
18
  import { buildAttentionRoutes } from "./attention.js";
16
- import { boardSnapshot, matchesEtag } from "./board-snapshot.js";
19
+ import { boardSnapshot, hashedBody, listCheck, matchesEtag, movedBody, scopedSnapshot } from "./board-snapshot.js";
17
20
  import { FACTORY_ROUTE_CONTRACTS } from "./contracts.js";
18
21
  import { Route, loose } from "./route.js";
22
+ import { workItemActivity } from "./work-item-activity.js";
23
+ import { cardsFiledFrom, cardsWithIds, unstartedCards } from "./work-item-selection.js";
24
+ import { CARD_DECISION_STATUSES, cardsWithFailedRun, workItemStarters } from "./work-item-starters.js";
19
25
  import { registerApiRoute } from "@mastra/core/server";
20
26
  // src/routes/work-items.ts
21
27
  /** The card as clients see it, without the dispatcher's internal bookkeeping. */
@@ -38,6 +44,55 @@ function sessionIdsWhere(items, predicate) {
38
44
  for (const item of items) for (const { sessionId } of Object.values(item.sessions)) if (predicate(sessionId)) picked.add(sessionId);
39
45
  return [...picked];
40
46
  }
47
+ const CARD_PULL_REQUESTS = {
48
+ isPullRequest: (card) => isPullRequestCard({ source: workItemBranchSource(card.externalSource) }),
49
+ headBranch: (card) => {
50
+ const branch = card.workItem.metadata?.headBranch;
51
+ return typeof branch === "string" ? branch : void 0;
52
+ }
53
+ };
54
+ const relatedCards = /* @__PURE__ */ new WeakMap();
55
+ const cardsInSessions = /* @__PURE__ */ new WeakMap();
56
+ /** The cards `holds` picks, and the cards related to them, in board order. */
57
+ function withRelatedCards(board, holds) {
58
+ let relatedTo = relatedCards.get(board);
59
+ if (!relatedTo) {
60
+ relatedTo = relatedCardIndex(board, CARD_PULL_REQUESTS);
61
+ relatedCards.set(board, relatedTo);
62
+ }
63
+ const picked = /* @__PURE__ */ new Set();
64
+ for (const card of board) {
65
+ if (!holds(card)) continue;
66
+ picked.add(card);
67
+ for (const related of relatedTo(card)) picked.add(related);
68
+ }
69
+ return board.filter((card) => picked.has(card));
70
+ }
71
+ /** The cards that hold one of the sessions, and the cards related to them, in board order. */
72
+ function sessionCards(board, sessionIds) {
73
+ const wanted = new Set(sessionIds);
74
+ return withRelatedCards(board, (card) => Object.values(card.sessions).some((session) => wanted.has(session.sessionId)));
75
+ }
76
+ /** The cards that hold any session, and the cards related to them, in board order. */
77
+ function allSessionCards(board) {
78
+ let cards = cardsInSessions.get(board);
79
+ if (!cards) {
80
+ cards = withRelatedCards(board, (card) => Object.keys(card.sessions).length > 0);
81
+ cardsInSessions.set(board, cards);
82
+ }
83
+ return cards;
84
+ }
85
+ /** The error a list query is refused with, named after the parameter that failed to parse. */
86
+ function listQueryError(field) {
87
+ switch (field) {
88
+ case "scope": return "invalid_scope";
89
+ case "started": return "invalid_started";
90
+ case "q": return "invalid_search";
91
+ case "source": return "invalid_source";
92
+ case "workItemId": return "invalid_work_item_id";
93
+ default: return "invalid_session_id";
94
+ }
95
+ }
41
96
  function publicWorkItemMetadata(value) {
42
97
  if (value === null) return null;
43
98
  const { [FACTORY_RULE_MATERIALIZATION_KEY]: _materialization, [FACTORY_PULL_REQUEST_RECONCILIATION_KEY]: _reconciliation, [EXTERNAL_SOURCE_MISSING_KEY]: _externalSourceMissingAt, ...metadata } = value;
@@ -276,26 +331,63 @@ var WorkItemRoutes = class extends Route {
276
331
  method: FACTORY_ROUTE_CONTRACTS.workItemList.method,
277
332
  requiresAuth: false,
278
333
  handler: async (c) => {
279
- const resolved = await this.#resolveProject(loose(c));
334
+ const context = loose(c);
335
+ const resolved = await this.#resolveProject(context);
280
336
  if ("response" in resolved) return resolved.response;
337
+ const query = FACTORY_ROUTE_CONTRACTS.workItemList.querySchema.safeParse({
338
+ sessionId: context.req.queries("sessionId"),
339
+ scope: context.req.query("scope"),
340
+ started: context.req.query("started"),
341
+ q: context.req.query("q"),
342
+ limit: context.req.query("limit"),
343
+ source: context.req.queries("source"),
344
+ workItemId: context.req.queries("workItemId"),
345
+ since: context.req.query("since")
346
+ });
347
+ if (!query.success) return c.json({ error: listQueryError(query.error.issues[0]?.path[0]) }, 400);
281
348
  await workItems.ensureReady();
282
- const items = await workItems.listShared({
349
+ const { sessionId: sessionIds, scope, started, q, limit, source, workItemId: ids, since } = query.data;
350
+ const list = await workItems.listSharedSince({
283
351
  orgId: resolved.orgId,
284
- factoryProjectId: resolved.factoryProjectId
352
+ factoryProjectId: resolved.factoryProjectId,
353
+ since
285
354
  });
286
- const snapshot = boardSnapshot(items, toWireWorkItem, sessionIdsWhere(items, (sessionId) => liveSessions.isRunning(sessionId)), sessionIdsWhere(items, (sessionId) => liveSessions.parked(sessionId) !== void 0));
355
+ const board = list.items;
356
+ const unstarted = started ? unstartedCards(board, q ?? "", limit) : void 0;
357
+ const part = unstarted?.cards ?? (scope ? allSessionCards(board) : sessionIds ? sessionCards(board, sessionIds) : source ? cardsFiledFrom(board, source) : ids && cardsWithIds(board, ids));
358
+ const items = part ?? board;
359
+ const running = sessionIdsWhere(items, (sessionId) => liveSessions.isRunning(sessionId));
360
+ const parked = sessionIdsWhere(items, (sessionId) => liveSessions.parked(sessionId) !== void 0);
361
+ const send = async (body, headers) => {
362
+ headers["Content-Type"] = "application/json; charset=UTF-8";
363
+ headers.Vary = "Accept-Encoding";
364
+ if (!/\bgzip\b/.test(c.req.header("accept-encoding") ?? "")) return c.body(body.json, 200, headers);
365
+ headers["Content-Encoding"] = "gzip";
366
+ return c.body(new Uint8Array(await body.gzipped()), 200, headers);
367
+ };
368
+ if (list.changed) {
369
+ const moved = {
370
+ workItems: list.changed.map(toWireWorkItem),
371
+ removedIds: list.removed,
372
+ check: listCheck(board),
373
+ cursor: list.cursor
374
+ };
375
+ return send(movedBody({
376
+ ...moved,
377
+ runningSessionIds: running,
378
+ parkedSessionIds: parked
379
+ }), { "Cache-Control": "no-store" });
380
+ }
381
+ const snapshot = part ? scopedSnapshot(part, toWireWorkItem, running, parked, unstarted?.total) : boardSnapshot(board, toWireWorkItem, running, parked, list.cursor);
287
382
  const headers = {
288
383
  ETag: snapshot.etag,
289
- "Cache-Control": "private, no-cache",
290
- Vary: "Accept-Encoding"
384
+ "Cache-Control": "private, no-cache"
291
385
  };
292
- if (matchesEtag(c.req.header("if-none-match"), snapshot.etag)) return c.body(null, 304, headers);
293
- headers["Content-Type"] = "application/json; charset=UTF-8";
294
- if (/\bgzip\b/.test(c.req.header("accept-encoding") ?? "")) {
295
- headers["Content-Encoding"] = "gzip";
296
- return c.body(new Uint8Array(await snapshot.gzipped()), 200, headers);
297
- }
298
- return c.body(snapshot.json, 200, headers);
386
+ if (matchesEtag(c.req.header("if-none-match"), snapshot.etag)) return c.body(null, 304, {
387
+ ...headers,
388
+ Vary: "Accept-Encoding"
389
+ });
390
+ return send(snapshot, headers);
299
391
  }
300
392
  }),
301
393
  registerApiRoute(FACTORY_ROUTE_CONTRACTS.metricsGet.path, {
@@ -326,6 +418,61 @@ var WorkItemRoutes = class extends Route {
326
418
  }, boardPhaseOutcomes(boards)) });
327
419
  }
328
420
  }),
421
+ registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemStarters.path, {
422
+ method: FACTORY_ROUTE_CONTRACTS.workItemStarters.method,
423
+ requiresAuth: false,
424
+ handler: async (c) => {
425
+ const resolved = await this.#resolveProject(loose(c));
426
+ if ("response" in resolved) return resolved.response;
427
+ const project = {
428
+ orgId: resolved.orgId,
429
+ factoryProjectId: resolved.factoryProjectId
430
+ };
431
+ await workItems.ensureReady();
432
+ const [cards, boards, { decisions }] = await Promise.all([
433
+ workItems.listShared(project),
434
+ this.#boards.load(project),
435
+ workItems.listDeferredDecisionPage({
436
+ ...project,
437
+ statuses: [...CARD_DECISION_STATUSES],
438
+ limit: 50
439
+ })
440
+ ]);
441
+ return c.json(workItemStarters({
442
+ board: boards.get(DEFAULT_BOARD_ID),
443
+ cards,
444
+ failedCardIds: cardsWithFailedRun(decisions),
445
+ now: Date.now()
446
+ }));
447
+ }
448
+ }),
449
+ registerApiRoute(FACTORY_ROUTE_CONTRACTS.workItemActivity.path, {
450
+ method: FACTORY_ROUTE_CONTRACTS.workItemActivity.method,
451
+ requiresAuth: false,
452
+ handler: async (c) => {
453
+ const context = loose(c);
454
+ const resolved = await this.#resolveProject(context);
455
+ if ("response" in resolved) return resolved.response;
456
+ const query = FACTORY_ROUTE_CONTRACTS.workItemActivity.querySchema.safeParse({ since: context.req.query("since") });
457
+ if (!query.success) return c.json({ error: "invalid_activity_since" }, 400);
458
+ const project = {
459
+ orgId: resolved.orgId,
460
+ factoryProjectId: resolved.factoryProjectId
461
+ };
462
+ await workItems.ensureReady();
463
+ const [cards, boards] = await Promise.all([workItems.listShared(project), this.#boards.load(project)]);
464
+ const answer = hashedBody(workItemActivity(cards, boards, query.data.since));
465
+ const headers = {
466
+ ETag: answer.etag,
467
+ "Cache-Control": "private, no-cache"
468
+ };
469
+ if (matchesEtag(c.req.header("if-none-match"), answer.etag)) return c.body(null, 304, headers);
470
+ return c.body(answer.json, 200, {
471
+ ...headers,
472
+ "Content-Type": "application/json; charset=UTF-8"
473
+ });
474
+ }
475
+ }),
329
476
  registerApiRoute(FACTORY_ROUTE_CONTRACTS.healthThresholdsGet.path, {
330
477
  method: FACTORY_ROUTE_CONTRACTS.healthThresholdsGet.method,
331
478
  requiresAuth: false,