@granular-software/fractory 0.0.0-stage → 0.1.25

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 (285) hide show
  1. package/LICENSE +4 -0
  2. package/README.md +28 -2
  3. package/dist/activity-volume.d.ts +18 -0
  4. package/dist/activity-volume.js +94 -0
  5. package/dist/annotations.d.ts +122 -0
  6. package/dist/annotations.js +304 -0
  7. package/dist/benchmark-cli.d.ts +1 -0
  8. package/dist/benchmark-cli.js +95 -0
  9. package/dist/benchmark-worker.d.ts +2 -0
  10. package/dist/benchmark-worker.js +22 -0
  11. package/dist/benchmarks.d.ts +19 -0
  12. package/dist/benchmarks.js +414 -0
  13. package/dist/bin.d.ts +2 -0
  14. package/dist/bin.js +63 -0
  15. package/dist/block-cli.d.ts +1 -0
  16. package/dist/block-cli.js +88 -0
  17. package/dist/block-documents.d.ts +35 -0
  18. package/dist/block-documents.js +84 -0
  19. package/dist/change-impact.d.ts +55 -0
  20. package/dist/change-impact.js +223 -0
  21. package/dist/check-source.d.ts +2 -0
  22. package/dist/check-source.js +66 -0
  23. package/dist/checks-model.d.ts +64 -0
  24. package/dist/checks-model.js +36 -0
  25. package/dist/cli.d.ts +2 -0
  26. package/dist/cli.js +359 -0
  27. package/dist/code-model.d.ts +38 -0
  28. package/dist/code-model.js +94 -0
  29. package/dist/code-store.d.ts +9 -0
  30. package/dist/code-store.js +79 -0
  31. package/dist/compare-artifact.d.ts +6 -0
  32. package/dist/compare-artifact.js +277 -0
  33. package/dist/compare.d.ts +81 -0
  34. package/dist/compare.js +291 -0
  35. package/dist/compiler.d.ts +10 -0
  36. package/dist/compiler.js +1240 -0
  37. package/dist/compose.d.ts +9 -0
  38. package/dist/compose.js +72 -0
  39. package/dist/core.d.ts +87 -0
  40. package/dist/core.js +207 -0
  41. package/dist/coverage-cli.d.ts +1 -0
  42. package/dist/coverage-cli.js +42 -0
  43. package/dist/declaration-sources.d.ts +3 -0
  44. package/dist/declaration-sources.js +51 -0
  45. package/dist/declared-graph.d.ts +3 -0
  46. package/dist/declared-graph.js +67 -0
  47. package/dist/display-name.d.ts +2 -0
  48. package/dist/display-name.js +8 -0
  49. package/dist/error-heat.d.ts +58 -0
  50. package/dist/error-heat.js +96 -0
  51. package/dist/evidence.d.ts +3 -0
  52. package/dist/evidence.js +68 -0
  53. package/dist/factory-graph.d.ts +7 -0
  54. package/dist/factory-graph.js +389 -0
  55. package/dist/factory-model.d.ts +111 -0
  56. package/dist/factory-model.js +1 -0
  57. package/dist/git-code.d.ts +47 -0
  58. package/dist/git-code.js +352 -0
  59. package/dist/git-refs.d.ts +4 -0
  60. package/dist/git-refs.js +37 -0
  61. package/dist/history-activity.d.ts +4 -0
  62. package/dist/history-activity.js +129 -0
  63. package/dist/history-churn.d.ts +36 -0
  64. package/dist/history-churn.js +302 -0
  65. package/dist/history-git.d.ts +21 -0
  66. package/dist/history-git.js +125 -0
  67. package/dist/history-ledger.d.ts +43 -0
  68. package/dist/history-ledger.js +450 -0
  69. package/dist/history-ownership.d.ts +10 -0
  70. package/dist/history-ownership.js +75 -0
  71. package/dist/history-source.d.ts +13 -0
  72. package/dist/history-source.js +100 -0
  73. package/dist/integrations-cli.d.ts +2 -0
  74. package/dist/integrations-cli.js +159 -0
  75. package/dist/interface-map.d.ts +15 -0
  76. package/dist/interface-map.js +125 -0
  77. package/dist/issue-cache.d.ts +9 -0
  78. package/dist/issue-cache.js +68 -0
  79. package/dist/issue-cli.d.ts +1 -0
  80. package/dist/issue-cli.js +89 -0
  81. package/dist/issue-links.d.ts +15 -0
  82. package/dist/issue-links.js +125 -0
  83. package/dist/linear-issues.d.ts +19 -0
  84. package/dist/linear-issues.js +124 -0
  85. package/dist/local-runtime.d.ts +8 -0
  86. package/dist/local-runtime.js +59 -0
  87. package/dist/map-activity.d.ts +73 -0
  88. package/dist/map-activity.js +234 -0
  89. package/dist/map-model.d.ts +5 -0
  90. package/dist/map-model.js +166 -0
  91. package/dist/map-quality.d.ts +20 -0
  92. package/dist/map-quality.js +61 -0
  93. package/dist/mapping-coverage.d.ts +87 -0
  94. package/dist/mapping-coverage.js +404 -0
  95. package/dist/model.d.ts +186 -0
  96. package/dist/model.js +66 -0
  97. package/dist/operation-benchmark-worker.d.ts +2 -0
  98. package/dist/operation-benchmark-worker.js +60 -0
  99. package/dist/operation-benchmark.d.ts +29 -0
  100. package/dist/operation-benchmark.js +1 -0
  101. package/dist/otel-metrics.d.ts +21 -0
  102. package/dist/otel-metrics.js +146 -0
  103. package/dist/performance-model.d.ts +185 -0
  104. package/dist/performance-model.js +396 -0
  105. package/dist/product-map.d.ts +71 -0
  106. package/dist/product-map.js +197 -0
  107. package/dist/provider-access.cjs +207 -0
  108. package/dist/provider-access.d.cts +14 -0
  109. package/dist/public-boundaries.d.ts +13 -0
  110. package/dist/public-boundaries.js +115 -0
  111. package/dist/reports-cli.d.ts +1 -0
  112. package/dist/reports-cli.js +111 -0
  113. package/dist/reports-model.d.ts +27 -0
  114. package/dist/reports-model.js +39 -0
  115. package/dist/reports.d.ts +23 -0
  116. package/dist/reports.js +223 -0
  117. package/dist/repository-map.d.ts +22 -0
  118. package/dist/repository-map.js +153 -0
  119. package/dist/resource-cache.d.ts +17 -0
  120. package/dist/resource-cache.js +65 -0
  121. package/dist/review-cli.d.ts +19 -0
  122. package/dist/review-cli.js +224 -0
  123. package/dist/review.d.ts +48 -0
  124. package/dist/review.js +289 -0
  125. package/dist/runtime-metrics.d.ts +26 -0
  126. package/dist/runtime-metrics.js +290 -0
  127. package/dist/scope.d.ts +14 -0
  128. package/dist/scope.js +168 -0
  129. package/dist/sentry-activity.d.ts +39 -0
  130. package/dist/sentry-activity.js +174 -0
  131. package/dist/sentry.d.ts +130 -0
  132. package/dist/sentry.js +369 -0
  133. package/dist/service-release.d.ts +16 -0
  134. package/dist/service-release.js +14 -0
  135. package/dist/setup-cli.d.ts +2 -0
  136. package/dist/setup-cli.js +52 -0
  137. package/dist/setup-kit.cjs +163 -0
  138. package/dist/setup-kit.d.cts +32 -0
  139. package/dist/source-index.d.ts +37 -0
  140. package/dist/source-index.js +170 -0
  141. package/dist/source-review-git.d.ts +7 -0
  142. package/dist/source-review-git.js +105 -0
  143. package/dist/source-review.d.ts +18 -0
  144. package/dist/source-review.js +573 -0
  145. package/dist/telemetry.d.ts +17 -0
  146. package/dist/telemetry.js +51 -0
  147. package/dist/time-window.d.ts +9 -0
  148. package/dist/time-window.js +35 -0
  149. package/dist/trace-evidence.d.ts +23 -0
  150. package/dist/trace-evidence.js +55 -0
  151. package/dist/trace-model.d.ts +26 -0
  152. package/dist/trace-model.js +1 -0
  153. package/dist/tracing.d.ts +44 -0
  154. package/dist/tracing.js +123 -0
  155. package/dist/work-check.d.ts +18 -0
  156. package/dist/work-check.js +115 -0
  157. package/dist/work-cli.d.ts +1 -0
  158. package/dist/work-cli.js +176 -0
  159. package/dist/work-context.d.ts +59 -0
  160. package/dist/work-context.js +594 -0
  161. package/dist/work-intents.d.ts +6 -0
  162. package/dist/work-intents.js +140 -0
  163. package/dist/work-items.d.ts +58 -0
  164. package/dist/work-items.js +86 -0
  165. package/dist/work-lock-check.d.ts +12 -0
  166. package/dist/work-lock-check.js +339 -0
  167. package/dist/work-locks.d.ts +10 -0
  168. package/dist/work-locks.js +98 -0
  169. package/dist/work-model.d.ts +119 -0
  170. package/dist/work-model.js +310 -0
  171. package/dist/work-review-git.d.ts +8 -0
  172. package/dist/work-review-git.js +111 -0
  173. package/dist/work-review.d.ts +26 -0
  174. package/dist/work-review.js +426 -0
  175. package/dist/work-switcher-model.d.ts +43 -0
  176. package/dist/work-switcher-model.js +79 -0
  177. package/dist/work-switcher.d.ts +6 -0
  178. package/dist/work-switcher.js +171 -0
  179. package/dist/working-cli.d.ts +1 -0
  180. package/dist/working-cli.js +33 -0
  181. package/dist/working-code.d.ts +74 -0
  182. package/dist/working-code.js +421 -0
  183. package/dist/workspace-notes.d.ts +71 -0
  184. package/dist/workspace-notes.js +177 -0
  185. package/dist/workspace-tests.d.ts +21 -0
  186. package/dist/workspace-tests.js +573 -0
  187. package/package.json +547 -4
  188. package/src/activity-volume.ts +149 -0
  189. package/src/annotations.ts +485 -0
  190. package/src/benchmark-cli.ts +118 -0
  191. package/src/benchmark-worker.ts +22 -0
  192. package/src/benchmarks.ts +493 -0
  193. package/src/bin.ts +54 -0
  194. package/src/block-cli.ts +106 -0
  195. package/src/block-documents.ts +117 -0
  196. package/src/change-impact.ts +280 -0
  197. package/src/check-source.ts +82 -0
  198. package/src/checks-model.ts +108 -0
  199. package/src/cli.ts +440 -0
  200. package/src/code-model.ts +159 -0
  201. package/src/code-store.ts +98 -0
  202. package/src/compare-artifact.ts +314 -0
  203. package/src/compare.ts +440 -0
  204. package/src/compiler.ts +1512 -0
  205. package/src/compose.ts +94 -0
  206. package/src/core.ts +361 -0
  207. package/src/coverage-cli.ts +52 -0
  208. package/src/declaration-sources.ts +69 -0
  209. package/src/declared-graph.ts +75 -0
  210. package/src/display-name.ts +8 -0
  211. package/src/error-heat.ts +161 -0
  212. package/src/evidence.ts +94 -0
  213. package/src/factory-graph.ts +462 -0
  214. package/src/factory-model.ts +82 -0
  215. package/src/git-code.ts +461 -0
  216. package/src/git-refs.ts +43 -0
  217. package/src/history-activity.ts +146 -0
  218. package/src/history-churn.ts +416 -0
  219. package/src/history-git.ts +163 -0
  220. package/src/history-ledger.ts +636 -0
  221. package/src/history-ownership.ts +116 -0
  222. package/src/history-source.ts +117 -0
  223. package/src/integrations-cli.ts +187 -0
  224. package/src/interface-map.ts +166 -0
  225. package/src/issue-cache.ts +96 -0
  226. package/src/issue-cli.ts +137 -0
  227. package/src/issue-links.ts +153 -0
  228. package/src/linear-issues.ts +154 -0
  229. package/src/local-runtime.ts +70 -0
  230. package/src/map-activity.ts +309 -0
  231. package/src/map-model.ts +213 -0
  232. package/src/map-quality.ts +66 -0
  233. package/src/mapping-coverage.ts +570 -0
  234. package/src/model.ts +228 -0
  235. package/src/operation-benchmark-worker.ts +60 -0
  236. package/src/operation-benchmark.ts +28 -0
  237. package/src/otel-metrics.ts +176 -0
  238. package/src/performance-model.ts +575 -0
  239. package/src/product-map.ts +271 -0
  240. package/src/provider-access.cjs +207 -0
  241. package/src/provider-access.d.cts +14 -0
  242. package/src/public-boundaries.ts +143 -0
  243. package/src/reports-cli.ts +125 -0
  244. package/src/reports-model.ts +73 -0
  245. package/src/reports.ts +276 -0
  246. package/src/repository-map.ts +191 -0
  247. package/src/resource-cache.ts +76 -0
  248. package/src/review-cli.ts +256 -0
  249. package/src/review.ts +376 -0
  250. package/src/runtime-metrics.ts +386 -0
  251. package/src/scope.ts +192 -0
  252. package/src/sentry-activity.ts +234 -0
  253. package/src/sentry.ts +545 -0
  254. package/src/service-release.ts +18 -0
  255. package/src/setup-cli.ts +58 -0
  256. package/src/setup-kit.cjs +163 -0
  257. package/src/setup-kit.d.cts +32 -0
  258. package/src/source-index.ts +208 -0
  259. package/src/source-review-git.ts +131 -0
  260. package/src/source-review.ts +736 -0
  261. package/src/telemetry.ts +68 -0
  262. package/src/time-window.ts +51 -0
  263. package/src/trace-evidence.ts +80 -0
  264. package/src/trace-model.ts +26 -0
  265. package/src/tracing.ts +165 -0
  266. package/src/work-check.ts +149 -0
  267. package/src/work-cli.ts +229 -0
  268. package/src/work-context.ts +753 -0
  269. package/src/work-intents.ts +196 -0
  270. package/src/work-items.ts +151 -0
  271. package/src/work-lock-check.ts +549 -0
  272. package/src/work-locks.ts +108 -0
  273. package/src/work-model.ts +466 -0
  274. package/src/work-review-git.ts +130 -0
  275. package/src/work-review.ts +573 -0
  276. package/src/work-switcher-model.ts +121 -0
  277. package/src/work-switcher.ts +191 -0
  278. package/src/working-cli.ts +38 -0
  279. package/src/working-code.ts +582 -0
  280. package/src/workspace-notes.ts +203 -0
  281. package/src/workspace-tests.ts +654 -0
  282. package/toolkit/GUIDE.md +354 -0
  283. package/toolkit/SKILL.md +142 -0
  284. package/toolkit/bin/fractory +2 -0
  285. package/toolkit/build.json +1 -0
@@ -0,0 +1,234 @@
1
+ import type { DefinitionGraph } from "./model";
2
+ import type { CodeSnapshot } from "./code-model";
3
+ import {
4
+ errorHeat,
5
+ type ErrorCount,
6
+ type ErrorObservation,
7
+ } from "./error-heat";
8
+ import {
9
+ SentryReader,
10
+ readSentryProjects,
11
+ relatedSentryAreas,
12
+ matchSentryEvent,
13
+ eventCommit,
14
+ type SentryAreaRule,
15
+ type SentryProjectWarning,
16
+ } from "./sentry";
17
+ import { inTimeWindow, type TimeWindow } from "./time-window";
18
+
19
+ /** Provider occurrence counts drive the map. Small filtered samples drive inspection.
20
+ * Only stored, exact-revision artifacts permit a sample to claim source ownership. */
21
+ export async function sentryActivity(
22
+ graph: DefinitionGraph,
23
+ reader: SentryReader,
24
+ options: {
25
+ org: string;
26
+ projects: string[];
27
+ window: TimeWindow;
28
+ areas: SentryAreaRule[];
29
+ snapshot: (commit: string) => CodeSnapshot | undefined;
30
+ },
31
+ ) {
32
+ const tags = [...new Set(options.areas.map((rule) => rule.tag))];
33
+ const sampleWarnings: SentryProjectWarning[] = [];
34
+ const { pages, warnings } = await readSentryProjects(
35
+ options.projects,
36
+ async (project) => {
37
+ const counts = await reader.errorCounts(project, options.window, tags);
38
+ let samples: Awaited<ReturnType<SentryReader["errorSamples"]>> = {
39
+ events: [],
40
+ partial: false,
41
+ };
42
+ try {
43
+ samples = await reader.errorSamples(project, options.window, tags);
44
+ } catch (error) {
45
+ sampleWarnings.push({
46
+ project,
47
+ scope: "samples",
48
+ message:
49
+ error instanceof Error && error.message.startsWith("Sentry")
50
+ ? error.message
51
+ : "Sentry event samples are unavailable.",
52
+ });
53
+ }
54
+ return { counts, samples };
55
+ },
56
+ );
57
+ const rows: ErrorCount[] = [],
58
+ observations: ErrorObservation[] = [];
59
+ const byId = new Map(graph.elements.map((node) => [node.id, node]));
60
+ for (const page of pages) {
61
+ const groups = page.counts.groups.map((group) => {
62
+ const areas = [
63
+ ...new Set(
64
+ relatedSentryAreas(
65
+ graph,
66
+ page.project,
67
+ {
68
+ tags: Object.entries(group.tags).map(([key, value]) => ({
69
+ key,
70
+ value,
71
+ })),
72
+ },
73
+ options.areas,
74
+ ).map((area) => area.id),
75
+ ),
76
+ ];
77
+ const elementId = areas.length === 1 ? areas[0] : undefined;
78
+ const row: ErrorCount = {
79
+ project: page.project,
80
+ count: group.count,
81
+ elementId,
82
+ basis: elementId ? "component" : "unassigned",
83
+ reason: elementId
84
+ ? "Provider component tag; not a verified leaf source match"
85
+ : areas.length > 1
86
+ ? "Component tags point to several blocks"
87
+ : "No mapped block attribution tag",
88
+ };
89
+ rows.push(row);
90
+ return { group, row };
91
+ });
92
+ const remainder: ErrorCount = {
93
+ project: page.project,
94
+ count:
95
+ page.counts.total -
96
+ groups.reduce((sum, value) => sum + value.row.count, 0),
97
+ basis: "unassigned",
98
+ reason: page.counts.partial
99
+ ? "Classification budget reached; occurrences remain in the total"
100
+ : "No mapped block attribution tag",
101
+ };
102
+ rows.push(remainder);
103
+ let inspected = 0;
104
+ const seen = new Set<string>();
105
+ for (const sample of page.counts.total ? page.samples.events : []) {
106
+ const eventId = sample.eventID || sample.id;
107
+ if (
108
+ !eventId ||
109
+ seen.has(eventId) ||
110
+ !inTimeWindow(sample.dateCreated, options.window)
111
+ )
112
+ continue;
113
+ seen.add(eventId);
114
+ const commit = eventCommit(sample),
115
+ snapshot = commit ? options.snapshot(commit) : undefined;
116
+ let matchReason = !commit
117
+ ? "Event has no unambiguous full Git commit"
118
+ : !snapshot
119
+ ? "No factory snapshot captured for this commit"
120
+ : "Full frame inspection is available on demand";
121
+ let owner: string | undefined,
122
+ basis: ErrorObservation["basis"] = "unassigned";
123
+ // Do not download stacks for every occurrence or reconstruct historical factories.
124
+ if (snapshot && inspected < 2) {
125
+ inspected++;
126
+ try {
127
+ const full = await reader.event(page.project, eventId),
128
+ match = matchSentryEvent(full, snapshot);
129
+ const first = match.matches.find(
130
+ (frame) => frame.status !== "unmapped",
131
+ );
132
+ if (first?.status === "matched") {
133
+ const original = first.elementIds[0];
134
+ let node = snapshot.graph.elements.find(
135
+ (node) => node.id === original,
136
+ );
137
+ const visited = new Set<string>();
138
+ while (node && !visited.has(node.id)) {
139
+ visited.add(node.id);
140
+ const id = graph.aliases?.[node.id] || node.id;
141
+ if (byId.has(id)) {
142
+ owner = id;
143
+ basis = node.id === original ? "source" : "component";
144
+ break;
145
+ }
146
+ node = snapshot.graph.elements.find(
147
+ (parent) => parent.id === node?.parent,
148
+ );
149
+ }
150
+ }
151
+ matchReason =
152
+ match.reason ||
153
+ "Historical owner is no longer on the displayed map";
154
+ } catch {
155
+ matchReason =
156
+ "Full source inspection is unavailable; aggregate counts are retained";
157
+ }
158
+ }
159
+ const grouped = groups.find(({ group }) =>
160
+ Object.entries(group.tags).every(
161
+ ([key, value]) =>
162
+ (sample.tags?.find((tag) => tag.key === key)?.value || "") ===
163
+ value,
164
+ ),
165
+ );
166
+ if (owner) {
167
+ const from = grouped?.row.count
168
+ ? grouped.row
169
+ : remainder.count
170
+ ? remainder
171
+ : undefined;
172
+ if (from) {
173
+ from.count--;
174
+ rows.push({
175
+ project: page.project,
176
+ count: 1,
177
+ elementId: owner,
178
+ basis,
179
+ reason:
180
+ basis === "source"
181
+ ? "Exact-version source match for this inspected event"
182
+ : "Historical source owner rolled up to its surviving parent",
183
+ });
184
+ } else owner = undefined;
185
+ }
186
+ if (!owner) {
187
+ owner = grouped?.row.elementId;
188
+ basis = owner ? "component" : "unassigned";
189
+ }
190
+ observations.push({
191
+ eventId,
192
+ project: page.project,
193
+ issueId: sample.groupID,
194
+ title: sample.title || "Sentry error",
195
+ at: sample.dateCreated,
196
+ commit,
197
+ elementId: owner,
198
+ basis,
199
+ matchReason: basis === "source" ? undefined : matchReason,
200
+ issueUrl:
201
+ sample.groupID && /^\d+$/.test(sample.groupID)
202
+ ? `https://${encodeURIComponent(options.org)}.sentry.io/issues/${sample.groupID}/`
203
+ : undefined,
204
+ });
205
+ }
206
+ }
207
+ const result = errorHeat(
208
+ graph,
209
+ observations,
210
+ warnings.length > 0,
211
+ rows.filter((row) => row.count),
212
+ );
213
+ const total = pages.reduce((sum, page) => sum + page.counts.total, 0);
214
+ if (result.accounting?.total !== total)
215
+ throw Error(
216
+ "Sentry accounting did not reconcile; no partial totals were published.",
217
+ );
218
+ return {
219
+ ...result,
220
+ period: "custom",
221
+ window: options.window,
222
+ warnings: [...warnings, ...sampleWarnings],
223
+ accounting: {
224
+ ...result.accounting!,
225
+ projects: options.projects.map((project) => ({
226
+ project,
227
+ total:
228
+ pages.find((page) => page.project === project)?.counts.total ?? null,
229
+ })),
230
+ samplePartial: pages.some((page) => page.samples.partial),
231
+ classificationPartial: pages.some((page) => page.counts.partial),
232
+ },
233
+ };
234
+ }