vika-cli 0.0.0-stage → 0.1.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 (243) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +37 -2
  3. package/dist/cli.js +32 -0
  4. package/dist/cli.js.map +1 -0
  5. package/dist/commands/approve-and-create-tickets.js +51 -0
  6. package/dist/commands/approve-and-create-tickets.js.map +1 -0
  7. package/dist/commands/create-tickets-command.js +30 -0
  8. package/dist/commands/create-tickets-command.js.map +1 -0
  9. package/dist/commands/doctor-command.js +59 -0
  10. package/dist/commands/doctor-command.js.map +1 -0
  11. package/dist/commands/init-command.js +21 -0
  12. package/dist/commands/init-command.js.map +1 -0
  13. package/dist/commands/mark-deploy-command.js +59 -0
  14. package/dist/commands/mark-deploy-command.js.map +1 -0
  15. package/dist/commands/report-command.js +40 -0
  16. package/dist/commands/report-command.js.map +1 -0
  17. package/dist/commands/run-cli.js +197 -0
  18. package/dist/commands/run-cli.js.map +1 -0
  19. package/dist/commands/run-exit-code.js +11 -0
  20. package/dist/commands/run-exit-code.js.map +1 -0
  21. package/dist/commands/serve-command.js +49 -0
  22. package/dist/commands/serve-command.js.map +1 -0
  23. package/dist/configuration/configuration-errors.js +43 -0
  24. package/dist/configuration/configuration-errors.js.map +1 -0
  25. package/dist/configuration/configuration-schema.js +69 -0
  26. package/dist/configuration/configuration-schema.js.map +1 -0
  27. package/dist/configuration/database-url-checks.js +43 -0
  28. package/dist/configuration/database-url-checks.js.map +1 -0
  29. package/dist/configuration/describe-configuration-safely.js +20 -0
  30. package/dist/configuration/describe-configuration-safely.js.map +1 -0
  31. package/dist/configuration/hide-secrets.js +44 -0
  32. package/dist/configuration/hide-secrets.js.map +1 -0
  33. package/dist/configuration/load-configuration.js +97 -0
  34. package/dist/configuration/load-configuration.js.map +1 -0
  35. package/dist/configuration/read-environment-file.js +77 -0
  36. package/dist/configuration/read-environment-file.js.map +1 -0
  37. package/dist/dashboard/dashboard-page.js +267 -0
  38. package/dist/dashboard/dashboard-page.js.map +1 -0
  39. package/dist/dashboard/dashboard-server.js +144 -0
  40. package/dist/dashboard/dashboard-server.js.map +1 -0
  41. package/dist/dashboard/github-issue-link.js +23 -0
  42. package/dist/dashboard/github-issue-link.js.map +1 -0
  43. package/dist/dashboard/request-guard.js +34 -0
  44. package/dist/dashboard/request-guard.js.map +1 -0
  45. package/dist/database/database-store.js +425 -0
  46. package/dist/database/database-store.js.map +1 -0
  47. package/dist/database/store-types.js +2 -0
  48. package/dist/database/store-types.js.map +1 -0
  49. package/dist/deploys/check-sha-on-branch.js +21 -0
  50. package/dist/deploys/check-sha-on-branch.js.map +1 -0
  51. package/dist/deploys/commits-in-range.js +31 -0
  52. package/dist/deploys/commits-in-range.js.map +1 -0
  53. package/dist/deploys/marker-deploys.js +18 -0
  54. package/dist/deploys/marker-deploys.js.map +1 -0
  55. package/dist/deploys/merge-log.js +33 -0
  56. package/dist/deploys/merge-log.js.map +1 -0
  57. package/dist/deploys/pull-request-number.js +5 -0
  58. package/dist/deploys/pull-request-number.js.map +1 -0
  59. package/dist/deploys/read-merge-deploys.js +46 -0
  60. package/dist/deploys/read-merge-deploys.js.map +1 -0
  61. package/dist/deploys/record-deploys.js +12 -0
  62. package/dist/deploys/record-deploys.js.map +1 -0
  63. package/dist/deploys/run-git.js +49 -0
  64. package/dist/deploys/run-git.js.map +1 -0
  65. package/dist/deploys/starting-point.js +5 -0
  66. package/dist/deploys/starting-point.js.map +1 -0
  67. package/dist/deploys/utc-timestamp.js +6 -0
  68. package/dist/deploys/utc-timestamp.js.map +1 -0
  69. package/dist/doctor/check-configuration.js +46 -0
  70. package/dist/doctor/check-configuration.js.map +1 -0
  71. package/dist/doctor/check-database.js +30 -0
  72. package/dist/doctor/check-database.js.map +1 -0
  73. package/dist/doctor/check-deploys.js +22 -0
  74. package/dist/doctor/check-deploys.js.map +1 -0
  75. package/dist/doctor/check-service-logs.js +107 -0
  76. package/dist/doctor/check-service-logs.js.map +1 -0
  77. package/dist/doctor/check-service-repository.js +43 -0
  78. package/dist/doctor/check-service-repository.js.map +1 -0
  79. package/dist/doctor/check-tracker.js +20 -0
  80. package/dist/doctor/check-tracker.js.map +1 -0
  81. package/dist/doctor/check-webhook.js +13 -0
  82. package/dist/doctor/check-webhook.js.map +1 -0
  83. package/dist/doctor/doctor-check-types.js +4 -0
  84. package/dist/doctor/doctor-check-types.js.map +1 -0
  85. package/dist/doctor/format-doctor-report.js +15 -0
  86. package/dist/doctor/format-doctor-report.js.map +1 -0
  87. package/dist/doctor/suggest-path-map.js +35 -0
  88. package/dist/doctor/suggest-path-map.js.map +1 -0
  89. package/dist/error-grouping/build-clusters.js +77 -0
  90. package/dist/error-grouping/build-clusters.js.map +1 -0
  91. package/dist/error-grouping/cluster-types.js +3 -0
  92. package/dist/error-grouping/cluster-types.js.map +1 -0
  93. package/dist/error-grouping/exception-type.js +6 -0
  94. package/dist/error-grouping/exception-type.js.map +1 -0
  95. package/dist/error-grouping/fingerprints.js +18 -0
  96. package/dist/error-grouping/fingerprints.js.map +1 -0
  97. package/dist/error-grouping/normalize-message.js +29 -0
  98. package/dist/error-grouping/normalize-message.js.map +1 -0
  99. package/dist/error-grouping/template-miner.js +75 -0
  100. package/dist/error-grouping/template-miner.js.map +1 -0
  101. package/dist/log-parsing/assemble-log-entries.js +49 -0
  102. package/dist/log-parsing/assemble-log-entries.js.map +1 -0
  103. package/dist/log-parsing/build-log-entry.js +33 -0
  104. package/dist/log-parsing/build-log-entry.js.map +1 -0
  105. package/dist/log-parsing/detect-log-format.js +44 -0
  106. package/dist/log-parsing/detect-log-format.js.map +1 -0
  107. package/dist/log-parsing/json-log-format.js +56 -0
  108. package/dist/log-parsing/json-log-format.js.map +1 -0
  109. package/dist/log-parsing/line-readers.js +14 -0
  110. package/dist/log-parsing/line-readers.js.map +1 -0
  111. package/dist/log-parsing/log-entry-types.js +3 -0
  112. package/dist/log-parsing/log-entry-types.js.map +1 -0
  113. package/dist/log-parsing/log-levels.js +21 -0
  114. package/dist/log-parsing/log-levels.js.map +1 -0
  115. package/dist/log-parsing/nginx-log-format.js +56 -0
  116. package/dist/log-parsing/nginx-log-format.js.map +1 -0
  117. package/dist/log-parsing/parse-log-lines.js +11 -0
  118. package/dist/log-parsing/parse-log-lines.js.map +1 -0
  119. package/dist/log-parsing/read-line-timestamp.js +21 -0
  120. package/dist/log-parsing/read-line-timestamp.js.map +1 -0
  121. package/dist/log-parsing/read-log-command.js +68 -0
  122. package/dist/log-parsing/read-log-command.js.map +1 -0
  123. package/dist/log-parsing/read-log-file.js +32 -0
  124. package/dist/log-parsing/read-log-file.js.map +1 -0
  125. package/dist/log-parsing/stack-frames.js +10 -0
  126. package/dist/log-parsing/stack-frames.js.map +1 -0
  127. package/dist/log-parsing/text-log-format.js +24 -0
  128. package/dist/log-parsing/text-log-format.js.map +1 -0
  129. package/dist/log-parsing/timestamps.js +22 -0
  130. package/dist/log-parsing/timestamps.js.map +1 -0
  131. package/dist/pipeline/analyze-service.js +45 -0
  132. package/dist/pipeline/analyze-service.js.map +1 -0
  133. package/dist/pipeline/build-stored-report.js +24 -0
  134. package/dist/pipeline/build-stored-report.js.map +1 -0
  135. package/dist/pipeline/ingest-service-logs.js +39 -0
  136. package/dist/pipeline/ingest-service-logs.js.map +1 -0
  137. package/dist/pipeline/load-deploys-for-service.js +16 -0
  138. package/dist/pipeline/load-deploys-for-service.js.map +1 -0
  139. package/dist/pipeline/prepare-ticket-drafts.js +33 -0
  140. package/dist/pipeline/prepare-ticket-drafts.js.map +1 -0
  141. package/dist/pipeline/read-new-log-lines.js +39 -0
  142. package/dist/pipeline/read-new-log-lines.js.map +1 -0
  143. package/dist/pipeline/run-all-services.js +73 -0
  144. package/dist/pipeline/run-all-services.js.map +1 -0
  145. package/dist/pipeline/timestamp-range.js +20 -0
  146. package/dist/pipeline/timestamp-range.js.map +1 -0
  147. package/dist/project-setup/detect-project.js +76 -0
  148. package/dist/project-setup/detect-project.js.map +1 -0
  149. package/dist/project-setup/write-starter-files.js +68 -0
  150. package/dist/project-setup/write-starter-files.js.map +1 -0
  151. package/dist/redaction/redact-ip-addresses.js +26 -0
  152. package/dist/redaction/redact-ip-addresses.js.map +1 -0
  153. package/dist/redaction/redact-sensitive-text.js +40 -0
  154. package/dist/redaction/redact-sensitive-text.js.map +1 -0
  155. package/dist/redaction/redaction-kinds.js +5 -0
  156. package/dist/redaction/redaction-kinds.js.map +1 -0
  157. package/dist/regression-detection/count-series.js +38 -0
  158. package/dist/regression-detection/count-series.js.map +1 -0
  159. package/dist/regression-detection/detect-regressions.js +162 -0
  160. package/dist/regression-detection/detect-regressions.js.map +1 -0
  161. package/dist/regression-detection/detection-types.js +9 -0
  162. package/dist/regression-detection/detection-types.js.map +1 -0
  163. package/dist/regression-detection/noise-check.js +7 -0
  164. package/dist/regression-detection/noise-check.js.map +1 -0
  165. package/dist/regression-detection/restore-time.js +19 -0
  166. package/dist/regression-detection/restore-time.js.map +1 -0
  167. package/dist/regression-detection/severity.js +12 -0
  168. package/dist/regression-detection/severity.js.map +1 -0
  169. package/dist/regression-detection/time-units.js +12 -0
  170. package/dist/regression-detection/time-units.js.map +1 -0
  171. package/dist/reporting/build-report.js +77 -0
  172. package/dist/reporting/build-report.js.map +1 -0
  173. package/dist/reporting/compute-metrics.js +42 -0
  174. package/dist/reporting/compute-metrics.js.map +1 -0
  175. package/dist/reporting/format-terminal-report.js +104 -0
  176. package/dist/reporting/format-terminal-report.js.map +1 -0
  177. package/dist/reporting/report-schema.js +96 -0
  178. package/dist/reporting/report-schema.js.map +1 -0
  179. package/dist/reporting/report-types.js +2 -0
  180. package/dist/reporting/report-types.js.map +1 -0
  181. package/dist/suspect-attribution/apply-path-map.js +31 -0
  182. package/dist/suspect-attribution/apply-path-map.js.map +1 -0
  183. package/dist/suspect-attribution/attribute-regression.js +176 -0
  184. package/dist/suspect-attribution/attribute-regression.js.map +1 -0
  185. package/dist/suspect-attribution/bot-authors.js +8 -0
  186. package/dist/suspect-attribution/bot-authors.js.map +1 -0
  187. package/dist/suspect-attribution/callee-files.js +53 -0
  188. package/dist/suspect-attribution/callee-files.js.map +1 -0
  189. package/dist/suspect-attribution/changed-file-categories.js +39 -0
  190. package/dist/suspect-attribution/changed-file-categories.js.map +1 -0
  191. package/dist/suspect-attribution/crash-line-inputs.js +81 -0
  192. package/dist/suspect-attribution/crash-line-inputs.js.map +1 -0
  193. package/dist/suspect-attribution/function-names.js +42 -0
  194. package/dist/suspect-attribution/function-names.js.map +1 -0
  195. package/dist/suspect-attribution/git-blame-reader.js +160 -0
  196. package/dist/suspect-attribution/git-blame-reader.js.map +1 -0
  197. package/dist/suspect-attribution/score-suspects.js +100 -0
  198. package/dist/suspect-attribution/score-suspects.js.map +1 -0
  199. package/dist/suspect-attribution/suspect-types.js +2 -0
  200. package/dist/suspect-attribution/suspect-types.js.map +1 -0
  201. package/dist/ticket-trackers/create-tracker.js +21 -0
  202. package/dist/ticket-trackers/create-tracker.js.map +1 -0
  203. package/dist/ticket-trackers/jira-document.js +34 -0
  204. package/dist/ticket-trackers/jira-document.js.map +1 -0
  205. package/dist/ticket-trackers/jira-tracker.js +65 -0
  206. package/dist/ticket-trackers/jira-tracker.js.map +1 -0
  207. package/dist/ticket-trackers/linear-tracker.js +109 -0
  208. package/dist/ticket-trackers/linear-tracker.js.map +1 -0
  209. package/dist/ticket-trackers/send-tracker-request.js +84 -0
  210. package/dist/ticket-trackers/send-tracker-request.js.map +1 -0
  211. package/dist/ticket-trackers/tracker-types.js +3 -0
  212. package/dist/ticket-trackers/tracker-types.js.map +1 -0
  213. package/dist/ticketing/build-ticket-comment.js +14 -0
  214. package/dist/ticketing/build-ticket-comment.js.map +1 -0
  215. package/dist/ticketing/build-ticket-draft.js +172 -0
  216. package/dist/ticketing/build-ticket-draft.js.map +1 -0
  217. package/dist/ticketing/choose-assignee.js +30 -0
  218. package/dist/ticketing/choose-assignee.js.map +1 -0
  219. package/dist/ticketing/create-ticket.js +92 -0
  220. package/dist/ticketing/create-ticket.js.map +1 -0
  221. package/dist/ticketing/describe-ticket-outcome.js +24 -0
  222. package/dist/ticketing/describe-ticket-outcome.js.map +1 -0
  223. package/dist/ticketing/read-code-owners.js +82 -0
  224. package/dist/ticketing/read-code-owners.js.map +1 -0
  225. package/dist/ticketing/render-ticket-text.js +22 -0
  226. package/dist/ticketing/render-ticket-text.js.map +1 -0
  227. package/dist/ticketing/ticket-types.js +2 -0
  228. package/dist/ticketing/ticket-types.js.map +1 -0
  229. package/dist/webhook/build-webhook-payload.js +29 -0
  230. package/dist/webhook/build-webhook-payload.js.map +1 -0
  231. package/dist/webhook/send-regression-webhooks.js +57 -0
  232. package/dist/webhook/send-regression-webhooks.js.map +1 -0
  233. package/dist/webhook/sign-webhook-body.js +16 -0
  234. package/dist/webhook/sign-webhook-body.js.map +1 -0
  235. package/dist/webhook/webhook-payload-schema.js +32 -0
  236. package/dist/webhook/webhook-payload-schema.js.map +1 -0
  237. package/migrations/001_init.sql +66 -0
  238. package/migrations/002_bookmark_history_start.sql +9 -0
  239. package/migrations/003_tickets.sql +20 -0
  240. package/migrations/004_ticket_comment_count.sql +10 -0
  241. package/migrations/005_webhook_events.sql +18 -0
  242. package/migrations/README.md +1 -0
  243. package/package.json +37 -3
@@ -0,0 +1,81 @@
1
+ // Finds what the failing line depends on, inside its own function:
2
+ // - lines above it that set a variable it reads ("const user = ...")
3
+ // - functions whose return value it reads ("const user = getUser(...)",
4
+ // or a call on the failing line itself)
5
+ // A bug is often not on the line that throws but in where its values came
6
+ // from: "user.email" fails because getUser() started returning null.
7
+ //
8
+ // A plain-text heuristic for JavaScript and TypeScript. It follows one step
9
+ // only (not the inputs of the inputs), which keeps it simple and predictable.
10
+ import { isFunctionDefinitionLine } from "./function-names.js";
11
+ // If the function's definition line can't be found (no name in the stack
12
+ // frame, or an unusual definition), look this many lines above the failing line.
13
+ const FALLBACK_LOOKBACK_LINES = 30;
14
+ // Give up looking for the definition line after this many lines: further up
15
+ // it is more likely another function with the same name.
16
+ const MAX_FUNCTION_LINES = 300;
17
+ const KEYWORDS = new Set([
18
+ "await", "break", "case", "catch", "class", "const", "continue", "default", "delete", "do", "else",
19
+ "export", "extends", "false", "finally", "for", "function", "if", "import", "in", "instanceof",
20
+ "let", "new", "null", "of", "return", "super", "switch", "this", "throw", "true", "try", "typeof",
21
+ "undefined", "var", "void", "while", "yield", "as", "async",
22
+ ]);
23
+ const IDENTIFIER = /(?<![\w$.])[A-Za-z_$][\w$]*/g;
24
+ const CALLED_IDENTIFIER = /(?<![\w$.])([A-Za-z_$][\w$]*)\s*\(/g;
25
+ const ASSIGNMENT = /^\s*(?:const|let|var)?\s*([A-Za-z_$][\w$]*)\s*=(?![=>])\s*(.*)$/;
26
+ const DIRECT_CALL_START = /^(?:await\s+)?([A-Za-z_$][\w$]*)\s*\(/;
27
+ // Strings and comments can hold words that look like names; blank them out.
28
+ function removeStringsAndComments(line) {
29
+ return line.replace(/(["'`])(?:\\.|(?!\1)[^\\])*\1/g, '""').replace(/\/\/.*$/, "");
30
+ }
31
+ // Names the line reads: identifiers that are not property names (after ".")
32
+ // and not keywords. The name a declaration creates is not read.
33
+ function findReadNames(code) {
34
+ const declaredName = /^\s*(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=/.exec(code)?.[1];
35
+ const readNames = new Set();
36
+ for (const identifierMatch of code.matchAll(IDENTIFIER)) {
37
+ const name = identifierMatch[0];
38
+ if (!KEYWORDS.has(name) && name !== declaredName)
39
+ readNames.add(name);
40
+ }
41
+ return readNames;
42
+ }
43
+ // The index of the failing function's definition line, or the fallback
44
+ // starting point when it can't be found.
45
+ function findFunctionStartIndex(fileLines, crashIndex, functionName) {
46
+ if (functionName !== undefined) {
47
+ for (let lineIndex = crashIndex - 1; lineIndex >= Math.max(0, crashIndex - MAX_FUNCTION_LINES); lineIndex--) {
48
+ if (isFunctionDefinitionLine(fileLines[lineIndex], functionName))
49
+ return lineIndex;
50
+ }
51
+ }
52
+ return Math.max(0, crashIndex - FALLBACK_LOOKBACK_LINES) - 1;
53
+ }
54
+ export function findCrashLineInputs(fileContent, crashLineNumber, functionName) {
55
+ const fileLines = fileContent.split("\n");
56
+ const crashIndex = crashLineNumber - 1;
57
+ const crashLine = fileLines[crashIndex];
58
+ if (crashLine === undefined)
59
+ return { inputLineNumbers: [], calleeNames: [] };
60
+ const crashCode = removeStringsAndComments(crashLine);
61
+ const readNames = findReadNames(crashCode);
62
+ const calleeNames = new Set();
63
+ for (const callMatch of crashCode.matchAll(CALLED_IDENTIFIER)) {
64
+ if (!KEYWORDS.has(callMatch[1]))
65
+ calleeNames.add(callMatch[1]);
66
+ }
67
+ const inputLineNumbers = [];
68
+ const functionStartIndex = findFunctionStartIndex(fileLines, crashIndex, functionName);
69
+ // The definition line itself only holds parameters, so start below it.
70
+ for (let lineIndex = functionStartIndex + 1; lineIndex < crashIndex; lineIndex++) {
71
+ const assignmentMatch = ASSIGNMENT.exec(removeStringsAndComments(fileLines[lineIndex]));
72
+ if (!assignmentMatch || !readNames.has(assignmentMatch[1]))
73
+ continue;
74
+ inputLineNumbers.push(lineIndex + 1);
75
+ const calleeName = DIRECT_CALL_START.exec(assignmentMatch[2].trim())?.[1];
76
+ if (calleeName !== undefined && !KEYWORDS.has(calleeName))
77
+ calleeNames.add(calleeName);
78
+ }
79
+ return { inputLineNumbers, calleeNames: [...calleeNames].sort() };
80
+ }
81
+ //# sourceMappingURL=crash-line-inputs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"crash-line-inputs.js","sourceRoot":"","sources":["../../src/suspect-attribution/crash-line-inputs.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,uEAAuE;AACvE,0EAA0E;AAC1E,4CAA4C;AAC5C,0EAA0E;AAC1E,qEAAqE;AACrE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,yEAAyE;AACzE,iFAAiF;AACjF,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,4EAA4E;AAC5E,yDAAyD;AACzD,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IACvB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM;IAClG,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY;IAC9F,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ;IACjG,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO;CAC5D,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,8BAA8B,CAAC;AAClD,MAAM,iBAAiB,GAAG,qCAAqC,CAAC;AAChE,MAAM,UAAU,GAAG,iEAAiE,CAAC;AACrF,MAAM,iBAAiB,GAAG,uCAAuC,CAAC;AAOlE,4EAA4E;AAC5E,SAAS,wBAAwB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,4EAA4E;AAC5E,gEAAgE;AAChE,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,YAAY,GAAG,gDAAgD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,eAAe,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,YAAY;YAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,uEAAuE;AACvE,yCAAyC;AACzC,SAAS,sBAAsB,CAAC,SAAmB,EAAE,UAAkB,EAAE,YAAgC;IACvG,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,IAAI,SAAS,GAAG,UAAU,GAAG,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC;YAC5G,IAAI,wBAAwB,CAAC,SAAS,CAAC,SAAS,CAAE,EAAE,YAAY,CAAC;gBAAE,OAAO,SAAS,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAmB,EAAE,eAAuB,EAAE,YAAgC;IAChH,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,eAAe,GAAG,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAE9E,MAAM,SAAS,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IACvF,uEAAuE;IACvE,KAAK,IAAI,SAAS,GAAG,kBAAkB,GAAG,CAAC,EAAE,SAAS,GAAG,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC;QACjF,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,SAAS,CAAE,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAE,CAAC;YAAE,SAAS;QACtE,gBAAgB,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACrC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACpE,CAAC"}
@@ -0,0 +1,42 @@
1
+ // Function names from stack frames, and where a function is defined in a file.
2
+ // The definition matcher is a plain-text heuristic for JavaScript and
3
+ // TypeScript; for other languages it simply finds nothing.
4
+ const PLAIN_NAME = /^[A-Za-z_$][\w$]*$/;
5
+ // Stack frames name functions in many ways: "createOrder", "Layer.handle",
6
+ // "async handleRequest", "new OrderService", "Object.<anonymous>". git needs
7
+ // the plain name as it appears in the source ("handle", "OrderService"), or
8
+ // nothing when there is no usable name.
9
+ export function plainFunctionName(frameFunctionName) {
10
+ if (frameFunctionName === undefined)
11
+ return undefined;
12
+ const withoutKeywords = frameFunctionName.trim().replace(/^(?:async|new)\s+/, "");
13
+ const lastPart = withoutKeywords.split(".").pop() ?? "";
14
+ return PLAIN_NAME.test(lastPart) ? lastPart : undefined;
15
+ }
16
+ export function escapeForRegex(text) {
17
+ return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
18
+ }
19
+ // Does this line define `functionName`? Recognizes
20
+ // function name(...) (also "export", "async", "function*")
21
+ // const name = (...) => / const name = function
22
+ // name(...) { (a class method; a plain call has no "{")
23
+ // name: (...) => / name: function (an object property)
24
+ export function isFunctionDefinitionLine(line, functionName) {
25
+ if (/^\s*(?:\/\/|\/?\*)/.test(line))
26
+ return false; // comment lines
27
+ const name = escapeForRegex(functionName);
28
+ const definitionPatterns = [
29
+ new RegExp(`\\bfunction\\s*\\*?\\s*${name}\\s*[(<]`),
30
+ new RegExp(`^\\s*(?:export\\s+)?(?:const|let|var)\\s+${name}\\s*(?::[^=]*)?=(?!=)`),
31
+ new RegExp(`^\\s*(?:(?:public|private|protected|static|async|get|set|override)\\s+)*\\*?${name}\\s*[(<].*\\{\\s*$`),
32
+ new RegExp(`^\\s*${name}\\s*:\\s*(?:async\\s+)?(?:function\\b|\\()`),
33
+ ];
34
+ return definitionPatterns.some((pattern) => pattern.test(line));
35
+ }
36
+ // The first line that defines `functionName`, or undefined.
37
+ export function findFunctionDefinitionLine(fileContent, functionName) {
38
+ const fileLines = fileContent.split("\n");
39
+ const lineIndex = fileLines.findIndex((line) => isFunctionDefinitionLine(line, functionName));
40
+ return lineIndex === -1 ? undefined : { lineNumber: lineIndex + 1, lineText: fileLines[lineIndex] };
41
+ }
42
+ //# sourceMappingURL=function-names.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"function-names.js","sourceRoot":"","sources":["../../src/suspect-attribution/function-names.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,sEAAsE;AACtE,2DAA2D;AAE3D,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,wCAAwC;AACxC,MAAM,UAAU,iBAAiB,CAAC,iBAAqC;IACrE,IAAI,iBAAiB,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtD,MAAM,eAAe,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACxD,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,mDAAmD;AACnD,mFAAmF;AACnF,kDAAkD;AAClD,uFAAuF;AACvF,kEAAkE;AAClE,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,YAAoB;IACzE,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,gBAAgB;IACnE,MAAM,IAAI,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC1C,MAAM,kBAAkB,GAAG;QACzB,IAAI,MAAM,CAAC,0BAA0B,IAAI,UAAU,CAAC;QACpD,IAAI,MAAM,CAAC,4CAA4C,IAAI,uBAAuB,CAAC;QACnF,IAAI,MAAM,CAAC,+EAA+E,IAAI,oBAAoB,CAAC;QACnH,IAAI,MAAM,CAAC,QAAQ,IAAI,4CAA4C,CAAC;KACrE,CAAC;IACF,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,0BAA0B,CAAC,WAAmB,EAAE,YAAoB;IAClF,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;IAC9F,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAE,EAAE,CAAC;AACvG,CAAC"}
@@ -0,0 +1,160 @@
1
+ // READ-ONLY git reads for suspect attribution: file contents, blame, and
2
+ // which commits in a deploy changed which files, lines and functions.
3
+ //
4
+ // Safety: only blame, diff, log and show are run, always through runGit (no
5
+ // shell, arguments as an array, cwd = the repo path). Code is always read at
6
+ // the deployed sha, never at HEAD or in the working tree. Refs and paths
7
+ // that start with "-" are refused so git can never read them as options.
8
+ import { assertSafeRevision, runGit, runGitOrThrow } from "../deploys/run-git.js";
9
+ import { escapeForRegex } from "./function-names.js";
10
+ // Printed before each commit sha in `git log` output, so commit lines can be
11
+ // told apart from file names and diff lines (none of which start with it).
12
+ const COMMIT_MARKER = "vika-commit ";
13
+ const COMMIT_LINE = /^vika-commit ([0-9a-f]{40}|[0-9a-f]{64})$/;
14
+ const FULL_SHA = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
15
+ export function assertSafePath(filePath) {
16
+ if (filePath === "" || filePath.startsWith("-") || /[\0\n\r]/.test(filePath))
17
+ throw new Error(`invalid path: "${filePath}"`);
18
+ }
19
+ // Commit shas from `git log --format="vika-commit %H"` output, in log order.
20
+ function parseCommitLines(gitOutput) {
21
+ const commitShas = [];
22
+ for (const line of gitOutput.split("\n")) {
23
+ const commitMatch = COMMIT_LINE.exec(line);
24
+ if (commitMatch)
25
+ commitShas.push(commitMatch[1]);
26
+ }
27
+ return commitShas;
28
+ }
29
+ // The file's content at `commitSha`, or undefined if it doesn't exist there.
30
+ export async function readFileAtCommit(repoPath, commitSha, filePath) {
31
+ assertSafeRevision(commitSha, "sha");
32
+ assertSafePath(filePath);
33
+ // --no-textconv: the stored content, not a filter's rendering of it.
34
+ const result = await runGit(repoPath, ["show", "--no-textconv", `${commitSha}:${filePath}`, "--"]);
35
+ return result.exitCode === 0 ? result.stdout : undefined;
36
+ }
37
+ // Commits listed in .git-blame-ignore-revs at the deployed sha (formatting
38
+ // sweeps and the like), so blame looks past them. Empty if there is no file.
39
+ export async function readBlameIgnoreRevisions(repoPath, deploySha) {
40
+ const fileContent = await readFileAtCommit(repoPath, deploySha, ".git-blame-ignore-revs");
41
+ if (fileContent === undefined)
42
+ return [];
43
+ return fileContent
44
+ .split("\n")
45
+ .map((line) => line.replace(/#.*$/, "").trim())
46
+ .filter((line) => FULL_SHA.test(line));
47
+ }
48
+ function parseBlamePorcelain(blameOutput) {
49
+ const outputLines = blameOutput.split("\n");
50
+ const commitSha = /^([0-9a-f]{40}|[0-9a-f]{64}) /.exec(outputLines[0] ?? "")?.[1];
51
+ if (commitSha === undefined)
52
+ throw new Error("unexpected git blame output");
53
+ let authorName = "";
54
+ let authorEmail = "";
55
+ let lineText = "";
56
+ for (const line of outputLines.slice(1)) {
57
+ // The line's own text comes last, after a tab.
58
+ if (line.startsWith("\t")) {
59
+ lineText = line.slice(1);
60
+ break;
61
+ }
62
+ if (line.startsWith("author "))
63
+ authorName = line.slice("author ".length);
64
+ else if (line.startsWith("author-mail "))
65
+ authorEmail = line.slice("author-mail ".length).replace(/^<|>$/g, "");
66
+ }
67
+ return { commitSha, lineText, authorName, authorEmail };
68
+ }
69
+ // Who last changed one line, as of the deployed sha. -w ignores whitespace
70
+ // changes; -M and -C follow lines moved or copied within and across files,
71
+ // so a reformat or a move doesn't hide the commit that wrote the line.
72
+ export async function blameLine(repoPath, deploySha, filePath, lineNumber, ignoredRevisions) {
73
+ assertSafeRevision(deploySha, "sha");
74
+ assertSafePath(filePath);
75
+ const blameArguments = (revisionsToIgnore) => [
76
+ "blame",
77
+ "-w",
78
+ "-M",
79
+ "-C",
80
+ ...revisionsToIgnore.flatMap((revision) => ["--ignore-rev", revision]),
81
+ "-L",
82
+ `${lineNumber},${lineNumber}`,
83
+ "--porcelain",
84
+ deploySha,
85
+ "--",
86
+ filePath,
87
+ ];
88
+ const result = await runGit(repoPath, blameArguments(ignoredRevisions));
89
+ if (result.exitCode === 0)
90
+ return parseBlamePorcelain(result.stdout);
91
+ // An ignore file can list commits this clone doesn't have, and git refuses
92
+ // to run then. A plain blame is better than none.
93
+ if (ignoredRevisions.length > 0)
94
+ return parseBlamePorcelain(await runGitOrThrow(repoPath, blameArguments([])));
95
+ throw new Error(`git blame failed in ${repoPath}: ${result.stderr.trim()}`);
96
+ }
97
+ // Files that differ between the two deploys: git diff --name-only previousSha..deploySha.
98
+ export async function listChangedFiles(repoPath, previousSha, deploySha) {
99
+ assertSafeRevision(previousSha, "sha");
100
+ assertSafeRevision(deploySha, "sha");
101
+ const gitOutput = await runGitOrThrow(repoPath, ["diff", "--name-only", `${previousSha}..${deploySha}`, "--"]);
102
+ return gitOutput.split("\n").filter((filePath) => filePath !== "");
103
+ }
104
+ // Which files each commit in the range changed: commit sha -> file paths.
105
+ export async function listChangedFilesByCommit(repoPath, previousSha, deploySha) {
106
+ assertSafeRevision(previousSha, "sha");
107
+ assertSafeRevision(deploySha, "sha");
108
+ const gitOutput = await runGitOrThrow(repoPath, ["log", `--format=${COMMIT_MARKER}%H`, "--name-only", `${previousSha}..${deploySha}`, "--"]);
109
+ const changedFilesByCommit = new Map();
110
+ let currentFiles;
111
+ for (const line of gitOutput.split("\n")) {
112
+ const commitMatch = COMMIT_LINE.exec(line);
113
+ if (commitMatch) {
114
+ currentFiles = [];
115
+ changedFilesByCommit.set(commitMatch[1], currentFiles);
116
+ }
117
+ else if (line !== "" && currentFiles !== undefined) {
118
+ currentFiles.push(line);
119
+ }
120
+ }
121
+ return changedFilesByCommit;
122
+ }
123
+ // Commits in previousSha..deploySha that changed the function `functionName`
124
+ // in `filePath` (git log -L :function:file). Undefined when git can't find
125
+ // the function in the file, so the caller can fall back to a line range.
126
+ export async function listCommitsChangingFunction(repoPath, previousSha, deploySha, filePath, functionName) {
127
+ assertSafeRevision(previousSha, "sha");
128
+ assertSafeRevision(deploySha, "sha");
129
+ assertSafePath(filePath);
130
+ // git reads the name as a regex. Names are plain identifiers (letters,
131
+ // digits, "_" and "$"), so escaping "$" is all that matters.
132
+ const result = await runGit(repoPath, [
133
+ "log",
134
+ "-s", // commit lines only, no patches
135
+ `--format=${COMMIT_MARKER}%H`,
136
+ "-L",
137
+ `:${escapeForRegex(functionName)}:${filePath}`,
138
+ `${previousSha}..${deploySha}`,
139
+ "--",
140
+ ]);
141
+ return result.exitCode === 0 ? parseCommitLines(result.stdout) : undefined;
142
+ }
143
+ // Commits in previousSha..deploySha that changed lines startLine..endLine of
144
+ // `filePath` (line numbers as of deploySha).
145
+ export async function listCommitsChangingLines(repoPath, previousSha, deploySha, filePath, startLine, endLine) {
146
+ assertSafeRevision(previousSha, "sha");
147
+ assertSafeRevision(deploySha, "sha");
148
+ assertSafePath(filePath);
149
+ const gitOutput = await runGitOrThrow(repoPath, [
150
+ "log",
151
+ "-s",
152
+ `--format=${COMMIT_MARKER}%H`,
153
+ "-L",
154
+ `${startLine},${endLine}:${filePath}`,
155
+ `${previousSha}..${deploySha}`,
156
+ "--",
157
+ ]);
158
+ return parseCommitLines(gitOutput);
159
+ }
160
+ //# sourceMappingURL=git-blame-reader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"git-blame-reader.js","sourceRoot":"","sources":["../../src/suspect-attribution/git-blame-reader.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,100 @@
1
+ import { extractPrNumber } from "../deploys/pull-request-number.js";
2
+ import { isBotAuthor } from "./bot-authors.js";
3
+ export const MAX_SUSPECTS = 3;
4
+ export const NO_STRONG_SUSPECT_MESSAGE = "no strong suspect in this deploy; may be external";
5
+ const STRENGTH_DETAILS = {
6
+ "blamed-line": { rank: 7, confidence: "high", evidenceKind: "blamed-line-changed" },
7
+ "crash-input-line": { rank: 6, confidence: "high", evidenceKind: "same-function-changed" },
8
+ "crash-input-callee": { rank: 5, confidence: "high", evidenceKind: "call-chain-function-changed" },
9
+ "same-function": { rank: 4, confidence: "medium", evidenceKind: "same-function-changed" },
10
+ "lower-frame-function": { rank: 3, confidence: "medium", evidenceKind: "call-chain-function-changed" },
11
+ file: { rank: 2, confidence: "medium", evidenceKind: "file-changed" },
12
+ "dependency-or-config": { rank: 1, confidence: "medium", evidenceKind: "dependency-or-config-change" },
13
+ };
14
+ const TIMING_ONLY_DETAILS = { rank: 0, confidence: "low", evidenceKind: "timing-only" };
15
+ // "createOrder()" when the function is known, otherwise "the code".
16
+ const describeFunction = (functionName) => (functionName === null ? "the code" : `${functionName}()`);
17
+ function writeReason(finding) {
18
+ const functionText = describeFunction(finding.functionName);
19
+ switch (finding.strength) {
20
+ case "blamed-line":
21
+ return `Line ${finding.lineNumber} of ${finding.filePath}, where the error is thrown, was last changed by this commit.`;
22
+ case "crash-input-line":
23
+ return `This commit changed line ${finding.lineNumber} of ${finding.filePath}, which sets a value the failing line in ${functionText} reads.`;
24
+ case "crash-input-callee":
25
+ return `This commit changed ${finding.calleeName}() in ${finding.filePath}, and the failing line in ${functionText} uses what it returns.`;
26
+ case "same-function":
27
+ return `This commit changed ${functionText} in ${finding.filePath}, the function where the error is thrown.`;
28
+ case "lower-frame-function":
29
+ return `This commit changed ${functionText} in ${finding.filePath}, which is further down the stack trace.`;
30
+ case "file":
31
+ return `This commit changed ${finding.filePath}, which appears in the stack trace.`;
32
+ case "dependency-or-config":
33
+ return `This commit changed ${finding.filePath}, a ${finding.fileCategory ?? "config file"}, in this deploy.`;
34
+ }
35
+ }
36
+ function buildSuspect(commit, details, fields) {
37
+ return {
38
+ commitSha: commit.sha,
39
+ prNumber: extractPrNumber(commit.subject),
40
+ confidence: details.confidence,
41
+ evidenceKind: details.evidenceKind,
42
+ reason: fields.reason,
43
+ filePath: fields.filePath,
44
+ lineNumber: fields.lineNumber,
45
+ lineText: fields.lineText,
46
+ author: { name: commit.authorName, email: commit.authorEmail },
47
+ isInDeployRange: true,
48
+ isBot: isBotAuthor(commit.authorName, commit.authorEmail),
49
+ };
50
+ }
51
+ // Plain string order (not locale-aware), so output never depends on the machine.
52
+ const compareStrings = (left, right) => (left < right ? -1 : left > right ? 1 : 0);
53
+ export function scoreSuspects(input) {
54
+ const rangePositionBySha = new Map(input.commitsInRange.map((commit, rangePosition) => [commit.sha, rangePosition]));
55
+ // Only commits the deploy shipped can be suspects: a blame that points
56
+ // before the range never counts.
57
+ const findingsInRange = input.findings.filter((finding) => rangePositionBySha.has(finding.commitSha));
58
+ // Strongest first. Ties: closer to the top of the stack, then the order
59
+ // the deploy shipped the commits in, then file and line, so the result
60
+ // never depends on the order findings were collected in.
61
+ findingsInRange.sort((left, right) => STRENGTH_DETAILS[right.strength].rank - STRENGTH_DETAILS[left.strength].rank ||
62
+ left.frameIndex - right.frameIndex ||
63
+ rangePositionBySha.get(left.commitSha) - rangePositionBySha.get(right.commitSha) ||
64
+ compareStrings(left.filePath, right.filePath) ||
65
+ (left.lineNumber ?? Infinity) - (right.lineNumber ?? Infinity));
66
+ // One suspect per commit, from its strongest finding. The findings are
67
+ // sorted, so the suspects come out strongest first.
68
+ const rankedSuspects = [];
69
+ const suspectedShas = new Set();
70
+ for (const finding of findingsInRange) {
71
+ if (suspectedShas.has(finding.commitSha))
72
+ continue;
73
+ suspectedShas.add(finding.commitSha);
74
+ const commit = input.commitsInRange[rangePositionBySha.get(finding.commitSha)];
75
+ rankedSuspects.push(buildSuspect(commit, STRENGTH_DETAILS[finding.strength], {
76
+ reason: writeReason(finding),
77
+ filePath: finding.filePath,
78
+ lineNumber: finding.lineNumber,
79
+ lineText: finding.lineText,
80
+ }));
81
+ }
82
+ // Every other commit in the deploy is a timing-only suspect, after all the
83
+ // others, in the order the deploy shipped them.
84
+ for (const commit of input.commitsInRange) {
85
+ if (suspectedShas.has(commit.sha))
86
+ continue;
87
+ const firstChangedFile = [...(input.changedFilesByCommit.get(commit.sha) ?? [])].sort(compareStrings)[0] ?? "";
88
+ rankedSuspects.push(buildSuspect(commit, TIMING_ONLY_DETAILS, {
89
+ reason: "This commit shipped in this deploy, but nothing ties it to the error except timing.",
90
+ filePath: firstChangedFile,
91
+ lineNumber: null,
92
+ lineText: null,
93
+ }));
94
+ }
95
+ const topSuspects = rankedSuspects.slice(0, MAX_SUSPECTS);
96
+ if (topSuspects.length === 0 || topSuspects[0].confidence === "low")
97
+ return { suspects: [], message: NO_STRONG_SUSPECT_MESSAGE };
98
+ return { suspects: topSuspects, message: null };
99
+ }
100
+ //# sourceMappingURL=score-suspects.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"score-suspects.js","sourceRoot":"","sources":["../../src/suspect-attribution/score-suspects.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=suspect-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"suspect-types.js","sourceRoot":"","sources":["../../src/suspect-attribution/suspect-types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,21 @@
1
+ import { createJiraTracker } from "./jira-tracker.js";
2
+ import { createLinearTracker } from "./linear-tracker.js";
3
+ export function createTracker(configuration, fetchFunction, secrets) {
4
+ const { tracker, trackerCredentials } = configuration;
5
+ if (tracker.type === "jira" && trackerCredentials.type === "jira") {
6
+ return createJiraTracker({
7
+ baseUrl: trackerCredentials.baseUrl,
8
+ email: trackerCredentials.email,
9
+ apiToken: trackerCredentials.apiToken,
10
+ projectKey: tracker.project,
11
+ issueType: tracker.issueType,
12
+ fetchFunction,
13
+ secrets,
14
+ });
15
+ }
16
+ if (tracker.type === "linear" && trackerCredentials.type === "linear") {
17
+ return createLinearTracker({ apiKey: trackerCredentials.apiKey, teamKey: tracker.team, fetchFunction, secrets });
18
+ }
19
+ return null;
20
+ }
21
+ //# sourceMappingURL=create-tracker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-tracker.js","sourceRoot":"","sources":["../../src/ticket-trackers/create-tracker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,UAAU,aAAa,CAAC,aAAkC,EAAE,aAA4B,EAAE,OAAiB;IAC/G,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,aAAa,CAAC;IACtD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,kBAAkB,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAClE,OAAO,iBAAiB,CAAC;YACvB,OAAO,EAAE,kBAAkB,CAAC,OAAO;YACnC,KAAK,EAAE,kBAAkB,CAAC,KAAK;YAC/B,QAAQ,EAAE,kBAAkB,CAAC,QAAQ;YACrC,UAAU,EAAE,OAAO,CAAC,OAAO;YAC3B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,aAAa;YACb,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,kBAAkB,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtE,OAAO,mBAAmB,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;IACnH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,34 @@
1
+ // ADF refuses empty text nodes.
2
+ const toTextNodes = (text) => (text === "" ? [] : [{ type: "text", text }]);
3
+ // Lines starting with "- " become one bullet list; other lines are paragraphs.
4
+ function linesToNodes(lines) {
5
+ const nodes = [];
6
+ for (const line of lines) {
7
+ if (line.startsWith("- ")) {
8
+ const item = { type: "listItem", content: [{ type: "paragraph", content: toTextNodes(line.slice(2)) }] };
9
+ const lastNode = nodes.at(-1);
10
+ if (lastNode?.type === "bulletList")
11
+ lastNode.content.push(item);
12
+ else
13
+ nodes.push({ type: "bulletList", content: [item] });
14
+ }
15
+ else if (line !== "") {
16
+ nodes.push({ type: "paragraph", content: toTextNodes(line) });
17
+ }
18
+ }
19
+ return nodes;
20
+ }
21
+ export function sectionsToAdf(sections) {
22
+ return {
23
+ type: "doc",
24
+ version: 1,
25
+ content: sections.flatMap((section) => [
26
+ { type: "heading", attrs: { level: 3 }, content: toTextNodes(section.heading) },
27
+ ...linesToNodes(section.lines),
28
+ ]),
29
+ };
30
+ }
31
+ export function textToAdf(text) {
32
+ return { type: "doc", version: 1, content: linesToNodes(text.split("\n")) };
33
+ }
34
+ //# sourceMappingURL=jira-document.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jira-document.js","sourceRoot":"","sources":["../../src/ticket-trackers/jira-document.ts"],"names":[],"mappings":"AAmBA,gCAAgC;AAChC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAiB,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEnG,+EAA+E;AAC/E,SAAS,YAAY,CAAC,KAAe;IACnC,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,UAAmB,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3H,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,QAAQ,EAAE,IAAI,KAAK,YAAY;gBAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;gBAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAuB;IACnD,OAAO;QACL,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACrC,EAAE,IAAI,EAAE,SAAkB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YACxF,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC;SAC/B,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC"}
@@ -0,0 +1,65 @@
1
+ // Jira Cloud (REST API v3). Basic auth with JIRA_EMAIL and JIRA_API_TOKEN;
2
+ // descriptions and comments in ADF. Issues go into the project from
3
+ // vika.yaml (tracker.project), with tracker.issueType (default "Bug").
4
+ import { sectionsToAdf, textToAdf } from "./jira-document.js";
5
+ import { sendTrackerRequest, TrackerError } from "./send-tracker-request.js";
6
+ import { TRACKER_TIMEOUT_MS } from "./tracker-types.js";
7
+ export const DEFAULT_JIRA_ISSUE_TYPE = "Bug";
8
+ export function createJiraTracker(options) {
9
+ const baseUrl = options.baseUrl.replace(/\/+$/, "");
10
+ const authorization = `Basic ${Buffer.from(`${options.email}:${options.apiToken}`).toString("base64")}`;
11
+ const send = (method, path, body) => sendTrackerRequest({
12
+ trackerName: "Jira",
13
+ credentialsHint: "JIRA_EMAIL and JIRA_API_TOKEN",
14
+ fetchFunction: options.fetchFunction,
15
+ url: `${baseUrl}${path}`,
16
+ method,
17
+ headers: { Authorization: authorization },
18
+ ...(body === undefined ? {} : { body }),
19
+ timeoutMs: options.timeoutMs ?? TRACKER_TIMEOUT_MS,
20
+ secrets: options.secrets,
21
+ });
22
+ const issueUrl = (issueKey) => `${baseUrl}/browse/${issueKey}`;
23
+ return {
24
+ trackerType: "jira",
25
+ async findUserByEmail(email) {
26
+ const users = (await send("GET", `/rest/api/3/user/search?query=${encodeURIComponent(email)}`));
27
+ // Real people only (not apps). Jira may hide email addresses for
28
+ // privacy; then a single match on the query is taken as the person.
29
+ const people = (Array.isArray(users) ? users : []).filter((user) => user.accountType === undefined || user.accountType === "atlassian");
30
+ const exactMatch = people.find((user) => user.emailAddress?.toLowerCase() === email.toLowerCase());
31
+ const match = exactMatch ?? (people.length === 1 && people[0].emailAddress === undefined ? people[0] : undefined);
32
+ return match === undefined ? undefined : { id: match.accountId, name: match.displayName ?? email };
33
+ },
34
+ async createIssue(draft, assigneeId) {
35
+ const created = (await send("POST", "/rest/api/3/issue", {
36
+ fields: {
37
+ project: { key: options.projectKey },
38
+ issuetype: { name: options.issueType ?? DEFAULT_JIRA_ISSUE_TYPE },
39
+ summary: draft.title,
40
+ description: sectionsToAdf(draft.bodySections),
41
+ labels: draft.labels,
42
+ ...(assigneeId === undefined ? {} : { assignee: { accountId: assigneeId } }),
43
+ },
44
+ }));
45
+ if (typeof created.key !== "string")
46
+ throw new TrackerError("Jira created the issue but did not say its key.", null);
47
+ return { issueKey: created.key, issueUrl: issueUrl(created.key) };
48
+ },
49
+ async addComment(issueKey, text) {
50
+ await send("POST", `/rest/api/3/issue/${encodeURIComponent(issueKey)}/comment`, { body: textToAdf(text) });
51
+ },
52
+ async checkCredentials() {
53
+ const myself = (await send("GET", "/rest/api/3/myself"));
54
+ return { name: myself.displayName ?? myself.emailAddress ?? options.email };
55
+ },
56
+ async findIssueByLabel(label) {
57
+ // Labels never contain quotes (they are built by vika), but escape anyway.
58
+ const jql = `project = "${options.projectKey.replace(/"/g, '\\"')}" AND labels = "${label.replace(/"/g, '\\"')}" ORDER BY created ASC`;
59
+ const found = (await send("POST", "/rest/api/3/search/jql", { jql, fields: ["key"], maxResults: 1 }));
60
+ const issueKey = found.issues?.[0]?.key;
61
+ return issueKey === undefined ? undefined : { issueKey, issueUrl: issueUrl(issueKey) };
62
+ },
63
+ };
64
+ }
65
+ //# sourceMappingURL=jira-tracker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jira-tracker.js","sourceRoot":"","sources":["../../src/ticket-trackers/jira-tracker.ts"],"names":[],"mappings":"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"}