@granular-software/fractory 0.0.0-stage → 0.1.24

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 (273) 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 +118 -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 +1083 -0
  37. package/dist/compose.d.ts +9 -0
  38. package/dist/compose.js +72 -0
  39. package/dist/core.d.ts +86 -0
  40. package/dist/core.js +206 -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 +66 -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 +4 -0
  54. package/dist/factory-graph.js +318 -0
  55. package/dist/factory-model.d.ts +97 -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/issue-cache.d.ts +9 -0
  76. package/dist/issue-cache.js +68 -0
  77. package/dist/issue-cli.d.ts +1 -0
  78. package/dist/issue-cli.js +89 -0
  79. package/dist/issue-links.d.ts +15 -0
  80. package/dist/issue-links.js +125 -0
  81. package/dist/linear-issues.d.ts +19 -0
  82. package/dist/linear-issues.js +124 -0
  83. package/dist/local-runtime.d.ts +8 -0
  84. package/dist/local-runtime.js +59 -0
  85. package/dist/map-activity.d.ts +73 -0
  86. package/dist/map-activity.js +234 -0
  87. package/dist/map-model.d.ts +5 -0
  88. package/dist/map-model.js +166 -0
  89. package/dist/map-quality.d.ts +14 -0
  90. package/dist/map-quality.js +56 -0
  91. package/dist/mapping-coverage.d.ts +87 -0
  92. package/dist/mapping-coverage.js +404 -0
  93. package/dist/model.d.ts +182 -0
  94. package/dist/model.js +66 -0
  95. package/dist/operation-benchmark-worker.d.ts +2 -0
  96. package/dist/operation-benchmark-worker.js +60 -0
  97. package/dist/operation-benchmark.d.ts +29 -0
  98. package/dist/operation-benchmark.js +1 -0
  99. package/dist/otel-metrics.d.ts +21 -0
  100. package/dist/otel-metrics.js +146 -0
  101. package/dist/performance-model.d.ts +185 -0
  102. package/dist/performance-model.js +396 -0
  103. package/dist/product-map.d.ts +69 -0
  104. package/dist/product-map.js +168 -0
  105. package/dist/provider-access.cjs +207 -0
  106. package/dist/provider-access.d.cts +14 -0
  107. package/dist/reports-cli.d.ts +1 -0
  108. package/dist/reports-cli.js +111 -0
  109. package/dist/reports-model.d.ts +27 -0
  110. package/dist/reports-model.js +39 -0
  111. package/dist/reports.d.ts +23 -0
  112. package/dist/reports.js +223 -0
  113. package/dist/repository-map.d.ts +22 -0
  114. package/dist/repository-map.js +151 -0
  115. package/dist/resource-cache.d.ts +17 -0
  116. package/dist/resource-cache.js +65 -0
  117. package/dist/review-cli.d.ts +19 -0
  118. package/dist/review-cli.js +224 -0
  119. package/dist/review.d.ts +48 -0
  120. package/dist/review.js +289 -0
  121. package/dist/runtime-metrics.d.ts +26 -0
  122. package/dist/runtime-metrics.js +290 -0
  123. package/dist/scope.d.ts +12 -0
  124. package/dist/scope.js +94 -0
  125. package/dist/sentry-activity.d.ts +39 -0
  126. package/dist/sentry-activity.js +174 -0
  127. package/dist/sentry.d.ts +130 -0
  128. package/dist/sentry.js +369 -0
  129. package/dist/service-release.d.ts +16 -0
  130. package/dist/service-release.js +14 -0
  131. package/dist/setup-cli.d.ts +2 -0
  132. package/dist/setup-cli.js +52 -0
  133. package/dist/setup-kit.cjs +163 -0
  134. package/dist/setup-kit.d.cts +32 -0
  135. package/dist/source-index.d.ts +37 -0
  136. package/dist/source-index.js +166 -0
  137. package/dist/source-review-git.d.ts +7 -0
  138. package/dist/source-review-git.js +103 -0
  139. package/dist/source-review.d.ts +16 -0
  140. package/dist/source-review.js +493 -0
  141. package/dist/telemetry.d.ts +17 -0
  142. package/dist/telemetry.js +51 -0
  143. package/dist/time-window.d.ts +9 -0
  144. package/dist/time-window.js +35 -0
  145. package/dist/trace-evidence.d.ts +23 -0
  146. package/dist/trace-evidence.js +55 -0
  147. package/dist/trace-model.d.ts +26 -0
  148. package/dist/trace-model.js +1 -0
  149. package/dist/tracing.d.ts +44 -0
  150. package/dist/tracing.js +123 -0
  151. package/dist/work-check.d.ts +17 -0
  152. package/dist/work-check.js +110 -0
  153. package/dist/work-cli.d.ts +1 -0
  154. package/dist/work-cli.js +148 -0
  155. package/dist/work-context.d.ts +57 -0
  156. package/dist/work-context.js +568 -0
  157. package/dist/work-intents.d.ts +6 -0
  158. package/dist/work-intents.js +140 -0
  159. package/dist/work-items.d.ts +58 -0
  160. package/dist/work-items.js +86 -0
  161. package/dist/work-model.d.ts +110 -0
  162. package/dist/work-model.js +261 -0
  163. package/dist/work-review-git.d.ts +8 -0
  164. package/dist/work-review-git.js +111 -0
  165. package/dist/work-review.d.ts +26 -0
  166. package/dist/work-review.js +426 -0
  167. package/dist/work-switcher-model.d.ts +43 -0
  168. package/dist/work-switcher-model.js +79 -0
  169. package/dist/work-switcher.d.ts +6 -0
  170. package/dist/work-switcher.js +171 -0
  171. package/dist/working-cli.d.ts +1 -0
  172. package/dist/working-cli.js +33 -0
  173. package/dist/working-code.d.ts +74 -0
  174. package/dist/working-code.js +421 -0
  175. package/dist/workspace-notes.d.ts +71 -0
  176. package/dist/workspace-notes.js +177 -0
  177. package/dist/workspace-tests.d.ts +21 -0
  178. package/dist/workspace-tests.js +573 -0
  179. package/package.json +547 -4
  180. package/src/activity-volume.ts +149 -0
  181. package/src/annotations.ts +481 -0
  182. package/src/benchmark-cli.ts +118 -0
  183. package/src/benchmark-worker.ts +22 -0
  184. package/src/benchmarks.ts +493 -0
  185. package/src/bin.ts +54 -0
  186. package/src/block-cli.ts +106 -0
  187. package/src/block-documents.ts +117 -0
  188. package/src/change-impact.ts +280 -0
  189. package/src/check-source.ts +82 -0
  190. package/src/checks-model.ts +108 -0
  191. package/src/cli.ts +440 -0
  192. package/src/code-model.ts +159 -0
  193. package/src/code-store.ts +98 -0
  194. package/src/compare-artifact.ts +314 -0
  195. package/src/compare.ts +440 -0
  196. package/src/compiler.ts +1326 -0
  197. package/src/compose.ts +94 -0
  198. package/src/core.ts +357 -0
  199. package/src/coverage-cli.ts +52 -0
  200. package/src/declaration-sources.ts +69 -0
  201. package/src/declared-graph.ts +74 -0
  202. package/src/display-name.ts +8 -0
  203. package/src/error-heat.ts +161 -0
  204. package/src/evidence.ts +94 -0
  205. package/src/factory-graph.ts +378 -0
  206. package/src/factory-model.ts +73 -0
  207. package/src/git-code.ts +461 -0
  208. package/src/git-refs.ts +43 -0
  209. package/src/history-activity.ts +146 -0
  210. package/src/history-churn.ts +416 -0
  211. package/src/history-git.ts +163 -0
  212. package/src/history-ledger.ts +636 -0
  213. package/src/history-ownership.ts +116 -0
  214. package/src/history-source.ts +117 -0
  215. package/src/integrations-cli.ts +187 -0
  216. package/src/issue-cache.ts +96 -0
  217. package/src/issue-cli.ts +137 -0
  218. package/src/issue-links.ts +153 -0
  219. package/src/linear-issues.ts +154 -0
  220. package/src/local-runtime.ts +70 -0
  221. package/src/map-activity.ts +309 -0
  222. package/src/map-model.ts +213 -0
  223. package/src/map-quality.ts +61 -0
  224. package/src/mapping-coverage.ts +570 -0
  225. package/src/model.ts +221 -0
  226. package/src/operation-benchmark-worker.ts +60 -0
  227. package/src/operation-benchmark.ts +28 -0
  228. package/src/otel-metrics.ts +176 -0
  229. package/src/performance-model.ts +575 -0
  230. package/src/product-map.ts +236 -0
  231. package/src/provider-access.cjs +207 -0
  232. package/src/provider-access.d.cts +14 -0
  233. package/src/reports-cli.ts +125 -0
  234. package/src/reports-model.ts +73 -0
  235. package/src/reports.ts +276 -0
  236. package/src/repository-map.ts +189 -0
  237. package/src/resource-cache.ts +76 -0
  238. package/src/review-cli.ts +256 -0
  239. package/src/review.ts +376 -0
  240. package/src/runtime-metrics.ts +386 -0
  241. package/src/scope.ts +103 -0
  242. package/src/sentry-activity.ts +234 -0
  243. package/src/sentry.ts +545 -0
  244. package/src/service-release.ts +18 -0
  245. package/src/setup-cli.ts +58 -0
  246. package/src/setup-kit.cjs +163 -0
  247. package/src/setup-kit.d.cts +32 -0
  248. package/src/source-index.ts +205 -0
  249. package/src/source-review-git.ts +129 -0
  250. package/src/source-review.ts +637 -0
  251. package/src/telemetry.ts +68 -0
  252. package/src/time-window.ts +51 -0
  253. package/src/trace-evidence.ts +80 -0
  254. package/src/trace-model.ts +26 -0
  255. package/src/tracing.ts +165 -0
  256. package/src/work-check.ts +143 -0
  257. package/src/work-cli.ts +195 -0
  258. package/src/work-context.ts +713 -0
  259. package/src/work-intents.ts +196 -0
  260. package/src/work-items.ts +151 -0
  261. package/src/work-model.ts +400 -0
  262. package/src/work-review-git.ts +130 -0
  263. package/src/work-review.ts +573 -0
  264. package/src/work-switcher-model.ts +121 -0
  265. package/src/work-switcher.ts +191 -0
  266. package/src/working-cli.ts +38 -0
  267. package/src/working-code.ts +582 -0
  268. package/src/workspace-notes.ts +203 -0
  269. package/src/workspace-tests.ts +654 -0
  270. package/toolkit/GUIDE.md +305 -0
  271. package/toolkit/SKILL.md +131 -0
  272. package/toolkit/bin/fractory +2 -0
  273. package/toolkit/build.json +1 -0
package/dist/scope.js ADDED
@@ -0,0 +1,94 @@
1
+ /** A focused scope shows its contents and genuine external endpoints, never unrelated siblings. */
2
+ export function scopeGraph(graph, focus, expanded) {
3
+ const byId = new Map(graph.elements.map((node) => [node.id, node]));
4
+ const scope = byId.get(focus) || byId.get(graph.id);
5
+ const inside = (id) => {
6
+ let current = byId.get(id);
7
+ while (current) {
8
+ if (current.id === scope.id)
9
+ return true;
10
+ current = current.parent ? byId.get(current.parent) : undefined;
11
+ }
12
+ return false;
13
+ };
14
+ const visibleInside = (node) => node.parent === scope.id ||
15
+ (!!node.parent &&
16
+ inside(node.parent) &&
17
+ expanded.has(node.parent) &&
18
+ !!byId.get(node.parent) &&
19
+ visibleInside(byId.get(node.parent)));
20
+ const nodes = graph.elements.filter((node) => node.id !== scope.id && inside(node.id) && visibleInside(node));
21
+ const shown = new Set(nodes.map((node) => node.id));
22
+ const external = new Set();
23
+ const contextLabel = (node) => {
24
+ const names = [];
25
+ let current = node.parent ? byId.get(node.parent) : undefined;
26
+ while (current && current.id !== graph.id) {
27
+ names.unshift(current.label);
28
+ current = current.parent ? byId.get(current.parent) : undefined;
29
+ }
30
+ return names.join(" / ");
31
+ };
32
+ const endpoint = (id) => {
33
+ if (id === scope.id) {
34
+ if (scope.id === graph.id)
35
+ return;
36
+ if (!shown.has(id)) {
37
+ nodes.push(scope);
38
+ shown.add(id);
39
+ }
40
+ return id;
41
+ }
42
+ let current = byId.get(id);
43
+ if (!current)
44
+ return;
45
+ if (inside(id)) {
46
+ while (current && !shown.has(current.id))
47
+ current = current.parent ? byId.get(current.parent) : undefined;
48
+ return current?.id;
49
+ }
50
+ // Outside methods meet this scope through their public interface. Preserve
51
+ // original endpoints on the edge for contracts and source inspection.
52
+ if (current.kind === "method" &&
53
+ current.parent &&
54
+ byId.get(current.parent)?.kind === "interface") {
55
+ current = byId.get(current.parent);
56
+ id = current.id;
57
+ }
58
+ // At a product-area zoom level, outside peers are product areas too. Keep
59
+ // fine-grained endpoints on the wire instead of filling the canvas with
60
+ // external methods. Deeper views still meet public interfaces directly.
61
+ if (scope.parent === graph.id) {
62
+ while (current.parent && current.parent !== graph.id) {
63
+ const parent = byId.get(current.parent);
64
+ if (!parent)
65
+ break;
66
+ current = parent;
67
+ }
68
+ id = current.id;
69
+ }
70
+ if (!shown.has(id)) {
71
+ nodes.push(current);
72
+ shown.add(id);
73
+ external.add(id);
74
+ }
75
+ return id;
76
+ };
77
+ const edges = [];
78
+ for (const edge of graph.connections) {
79
+ if (!inside(edge.source) && !inside(edge.target))
80
+ continue;
81
+ const source = endpoint(edge.source), target = endpoint(edge.target);
82
+ if (source && target && source !== target)
83
+ edges.push({
84
+ ...edge,
85
+ source,
86
+ target,
87
+ originalSource: edge.source,
88
+ originalTarget: edge.target,
89
+ });
90
+ }
91
+ if (!nodes.length && scope.id !== graph.id)
92
+ nodes.push(scope);
93
+ return { scope, nodes, edges, external, contextLabel };
94
+ }
@@ -0,0 +1,39 @@
1
+ import type { DefinitionGraph } from "./model.js";
2
+ import type { CodeSnapshot } from "./code-model.js";
3
+ import { type ErrorCount, type ErrorObservation } from "./error-heat.js";
4
+ import { SentryReader, type SentryAreaRule, type SentryProjectWarning } from "./sentry.js";
5
+ import { type TimeWindow } from "./time-window.js";
6
+ /** Provider occurrence counts drive the map. Small filtered samples drive inspection.
7
+ * Only stored, exact-revision artifacts permit a sample to claim source ownership. */
8
+ export declare function sentryActivity(graph: DefinitionGraph, reader: SentryReader, options: {
9
+ org: string;
10
+ projects: string[];
11
+ window: TimeWindow;
12
+ areas: SentryAreaRule[];
13
+ snapshot: (commit: string) => CodeSnapshot | undefined;
14
+ }): Promise<{
15
+ period: string;
16
+ window: TimeWindow;
17
+ warnings: SentryProjectWarning[];
18
+ accounting: {
19
+ projects: {
20
+ project: string;
21
+ total: number | null;
22
+ }[];
23
+ samplePartial: boolean;
24
+ classificationPartial: boolean;
25
+ total: number;
26
+ source: number;
27
+ related: number;
28
+ };
29
+ counts?: ErrorCount[];
30
+ fetchedAt: string;
31
+ partial: boolean;
32
+ events: ErrorObservation[];
33
+ cells: Record<string, {
34
+ source: number;
35
+ related: number;
36
+ intensity: number;
37
+ }>;
38
+ unassigned: number;
39
+ }>;
@@ -0,0 +1,174 @@
1
+ import { errorHeat, } from "./error-heat.js";
2
+ import { readSentryProjects, relatedSentryAreas, matchSentryEvent, eventCommit, } from "./sentry.js";
3
+ import { inTimeWindow } from "./time-window.js";
4
+ /** Provider occurrence counts drive the map. Small filtered samples drive inspection.
5
+ * Only stored, exact-revision artifacts permit a sample to claim source ownership. */
6
+ export async function sentryActivity(graph, reader, options) {
7
+ const tags = [...new Set(options.areas.map((rule) => rule.tag))];
8
+ const sampleWarnings = [];
9
+ const { pages, warnings } = await readSentryProjects(options.projects, async (project) => {
10
+ const counts = await reader.errorCounts(project, options.window, tags);
11
+ let samples = {
12
+ events: [],
13
+ partial: false,
14
+ };
15
+ try {
16
+ samples = await reader.errorSamples(project, options.window, tags);
17
+ }
18
+ catch (error) {
19
+ sampleWarnings.push({
20
+ project,
21
+ scope: "samples",
22
+ message: error instanceof Error && error.message.startsWith("Sentry")
23
+ ? error.message
24
+ : "Sentry event samples are unavailable.",
25
+ });
26
+ }
27
+ return { counts, samples };
28
+ });
29
+ const rows = [], observations = [];
30
+ const byId = new Map(graph.elements.map((node) => [node.id, node]));
31
+ for (const page of pages) {
32
+ const groups = page.counts.groups.map((group) => {
33
+ const areas = [
34
+ ...new Set(relatedSentryAreas(graph, page.project, {
35
+ tags: Object.entries(group.tags).map(([key, value]) => ({
36
+ key,
37
+ value,
38
+ })),
39
+ }, options.areas).map((area) => area.id)),
40
+ ];
41
+ const elementId = areas.length === 1 ? areas[0] : undefined;
42
+ const row = {
43
+ project: page.project,
44
+ count: group.count,
45
+ elementId,
46
+ basis: elementId ? "component" : "unassigned",
47
+ reason: elementId
48
+ ? "Provider component tag; not a verified leaf source match"
49
+ : areas.length > 1
50
+ ? "Component tags point to several blocks"
51
+ : "No mapped block attribution tag",
52
+ };
53
+ rows.push(row);
54
+ return { group, row };
55
+ });
56
+ const remainder = {
57
+ project: page.project,
58
+ count: page.counts.total -
59
+ groups.reduce((sum, value) => sum + value.row.count, 0),
60
+ basis: "unassigned",
61
+ reason: page.counts.partial
62
+ ? "Classification budget reached; occurrences remain in the total"
63
+ : "No mapped block attribution tag",
64
+ };
65
+ rows.push(remainder);
66
+ let inspected = 0;
67
+ const seen = new Set();
68
+ for (const sample of page.counts.total ? page.samples.events : []) {
69
+ const eventId = sample.eventID || sample.id;
70
+ if (!eventId ||
71
+ seen.has(eventId) ||
72
+ !inTimeWindow(sample.dateCreated, options.window))
73
+ continue;
74
+ seen.add(eventId);
75
+ const commit = eventCommit(sample), snapshot = commit ? options.snapshot(commit) : undefined;
76
+ let matchReason = !commit
77
+ ? "Event has no unambiguous full Git commit"
78
+ : !snapshot
79
+ ? "No factory snapshot captured for this commit"
80
+ : "Full frame inspection is available on demand";
81
+ let owner, basis = "unassigned";
82
+ // Do not download stacks for every occurrence or reconstruct historical factories.
83
+ if (snapshot && inspected < 2) {
84
+ inspected++;
85
+ try {
86
+ const full = await reader.event(page.project, eventId), match = matchSentryEvent(full, snapshot);
87
+ const first = match.matches.find((frame) => frame.status !== "unmapped");
88
+ if (first?.status === "matched") {
89
+ const original = first.elementIds[0];
90
+ let node = snapshot.graph.elements.find((node) => node.id === original);
91
+ const visited = new Set();
92
+ while (node && !visited.has(node.id)) {
93
+ visited.add(node.id);
94
+ const id = graph.aliases?.[node.id] || node.id;
95
+ if (byId.has(id)) {
96
+ owner = id;
97
+ basis = node.id === original ? "source" : "component";
98
+ break;
99
+ }
100
+ node = snapshot.graph.elements.find((parent) => parent.id === node?.parent);
101
+ }
102
+ }
103
+ matchReason =
104
+ match.reason ||
105
+ "Historical owner is no longer on the displayed map";
106
+ }
107
+ catch {
108
+ matchReason =
109
+ "Full source inspection is unavailable; aggregate counts are retained";
110
+ }
111
+ }
112
+ const grouped = groups.find(({ group }) => Object.entries(group.tags).every(([key, value]) => (sample.tags?.find((tag) => tag.key === key)?.value || "") ===
113
+ value));
114
+ if (owner) {
115
+ const from = grouped?.row.count
116
+ ? grouped.row
117
+ : remainder.count
118
+ ? remainder
119
+ : undefined;
120
+ if (from) {
121
+ from.count--;
122
+ rows.push({
123
+ project: page.project,
124
+ count: 1,
125
+ elementId: owner,
126
+ basis,
127
+ reason: basis === "source"
128
+ ? "Exact-version source match for this inspected event"
129
+ : "Historical source owner rolled up to its surviving parent",
130
+ });
131
+ }
132
+ else
133
+ owner = undefined;
134
+ }
135
+ if (!owner) {
136
+ owner = grouped?.row.elementId;
137
+ basis = owner ? "component" : "unassigned";
138
+ }
139
+ observations.push({
140
+ eventId,
141
+ project: page.project,
142
+ issueId: sample.groupID,
143
+ title: sample.title || "Sentry error",
144
+ at: sample.dateCreated,
145
+ commit,
146
+ elementId: owner,
147
+ basis,
148
+ matchReason: basis === "source" ? undefined : matchReason,
149
+ issueUrl: sample.groupID && /^\d+$/.test(sample.groupID)
150
+ ? `https://${encodeURIComponent(options.org)}.sentry.io/issues/${sample.groupID}/`
151
+ : undefined,
152
+ });
153
+ }
154
+ }
155
+ const result = errorHeat(graph, observations, warnings.length > 0, rows.filter((row) => row.count));
156
+ const total = pages.reduce((sum, page) => sum + page.counts.total, 0);
157
+ if (result.accounting?.total !== total)
158
+ throw Error("Sentry accounting did not reconcile; no partial totals were published.");
159
+ return {
160
+ ...result,
161
+ period: "custom",
162
+ window: options.window,
163
+ warnings: [...warnings, ...sampleWarnings],
164
+ accounting: {
165
+ ...result.accounting,
166
+ projects: options.projects.map((project) => ({
167
+ project,
168
+ total: pages.find((page) => page.project === project)?.counts.total ?? null,
169
+ })),
170
+ samplePartial: pages.some((page) => page.samples.partial),
171
+ classificationPartial: pages.some((page) => page.counts.partial),
172
+ },
173
+ };
174
+ }
@@ -0,0 +1,130 @@
1
+ import { type CodeMatch, type CodeSnapshot } from "./code-model.js";
2
+ import type { DefinitionGraph } from "./model.js";
3
+ export interface SentryAreaRule {
4
+ project: string;
5
+ tag: string;
6
+ value: string;
7
+ elementId: string;
8
+ }
9
+ /** Coarse event metadata associations are separate from versioned source ownership. */
10
+ export declare function relatedSentryAreas(graph: DefinitionGraph, project: string, event: SentryEvent, rules: SentryAreaRule[]): {
11
+ id: string;
12
+ label: string;
13
+ basis: string;
14
+ }[];
15
+ type Frame = {
16
+ filename?: string;
17
+ absPath?: string;
18
+ abs_path?: string;
19
+ lineNo?: number;
20
+ lineno?: number;
21
+ inApp?: boolean;
22
+ in_app?: boolean;
23
+ };
24
+ export interface SentryEvent {
25
+ eventID?: string;
26
+ id?: string;
27
+ groupID?: string;
28
+ title?: string;
29
+ issueShortId?: string;
30
+ type?: string;
31
+ level?: string;
32
+ dateCreated?: string;
33
+ release?: string | {
34
+ version?: string;
35
+ } | null;
36
+ tags?: {
37
+ key: string;
38
+ value: string;
39
+ }[];
40
+ entries?: {
41
+ type: string;
42
+ data?: {
43
+ values?: {
44
+ stacktrace?: {
45
+ frames?: Frame[];
46
+ };
47
+ }[];
48
+ frames?: Frame[];
49
+ };
50
+ }[];
51
+ exception?: {
52
+ values?: {
53
+ stacktrace?: {
54
+ frames?: Frame[];
55
+ };
56
+ }[];
57
+ };
58
+ }
59
+ export interface SentryCountGroup {
60
+ count: number;
61
+ tags: Record<string, string>;
62
+ }
63
+ export interface SentryCounts {
64
+ total: number;
65
+ groups: SentryCountGroup[];
66
+ partial: boolean;
67
+ }
68
+ export declare function eventCommit(event: SentryEvent): string | undefined;
69
+ export declare function matchSentryEvent(event: SentryEvent, snapshot?: CodeSnapshot): {
70
+ commit: string | undefined;
71
+ status: "version_unavailable";
72
+ matches: CodeMatch[];
73
+ reason: string;
74
+ } | {
75
+ reason?: string | undefined;
76
+ commit: string;
77
+ status: "matched" | "unmapped";
78
+ matches: CodeMatch[];
79
+ };
80
+ /** Server/CLI only. Credentials and raw event payloads never belong in the viewer. */
81
+ export declare class SentryReader {
82
+ private config;
83
+ private request;
84
+ constructor(config: {
85
+ token: string;
86
+ org: string;
87
+ projects: string[];
88
+ baseUrl?: string;
89
+ environment?: string;
90
+ }, request?: typeof fetch);
91
+ private get;
92
+ private project;
93
+ /** Explore applies environment and time filters; the legacy project event list ignores environment. */
94
+ private errorQuery;
95
+ errorCounts(project: string, window: import("./time-window.js").TimeWindow, tags: string[]): Promise<SentryCounts>;
96
+ errorSamples(project: string, window: import("./time-window.js").TimeWindow, tags?: string[]): Promise<{
97
+ events: SentryEvent[];
98
+ partial: boolean;
99
+ }>;
100
+ errorVolume(project: string, window: import("./time-window.js").TimeWindow): Promise<import("./activity-volume.js").ActivityVolume>;
101
+ issues(project: string, window?: import("./time-window.js").TimeWindow): Promise<{
102
+ id: string;
103
+ shortId: string;
104
+ title: string;
105
+ count: string;
106
+ lastSeen: string;
107
+ status: string;
108
+ url: string;
109
+ }[]>;
110
+ errors(project: string, window?: import("./time-window.js").TimeWindow): Promise<{
111
+ events: SentryEvent[];
112
+ partial: boolean;
113
+ }>;
114
+ event(project: string, eventId: string): Promise<SentryEvent>;
115
+ issueEvent(project: string, issue: string, window?: import("./time-window.js").TimeWindow): Promise<SentryEvent>;
116
+ }
117
+ export interface SentryProjectWarning {
118
+ project: string;
119
+ message: string;
120
+ scope?: "samples" | "counts";
121
+ }
122
+ /** A failed project is unavailable, never an empty project. Keep independent
123
+ * successful reads and tell the viewer exactly which projects are missing. */
124
+ export declare function readSentryProjects<T extends object>(projects: string[], read: (project: string) => Promise<T>): Promise<{
125
+ pages: (T & {
126
+ project: string;
127
+ })[];
128
+ warnings: SentryProjectWarning[];
129
+ }>;
130
+ export {};