@openai/codex-security 0.8.2 → 0.9.1

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 (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -0,0 +1,288 @@
1
+ import { z } from "zod";
2
+ import { cloudRepositoryUrlKey, repositoryUrlKey, validateExternalEvidence, } from "./external-import-contract.js";
3
+ import { isRecord } from "./record.js";
4
+ import { array, normalizeRecords, readScannerJson, record, relativePath, requiredText, text, } from "./scanner-import.js";
5
+ import { declaredScannerRepositoryUrl } from "./scanner-repository-url.js";
6
+ const sonarFormat = "sonar-issues/v1";
7
+ const captureText = z.string().refine((value) => Boolean(value.trim()));
8
+ const captureSchema = z.object({
9
+ format: z.literal(sonarFormat),
10
+ server: captureText,
11
+ organization: captureText,
12
+ project: captureText,
13
+ branch: captureText.optional(),
14
+ pullRequest: captureText.optional(),
15
+ repositoryUrl: captureText.optional(),
16
+ projectBase: z
17
+ .string()
18
+ .refine((path) => path === "" || relativePath(path) === path)
19
+ .optional(),
20
+ pages: z.array(z.unknown()).min(1),
21
+ queryPageCounts: z.array(z.int().positive()).min(1).optional(),
22
+ });
23
+ export function parseSonarCapture(value) {
24
+ const capture = captureSchema.parse(value);
25
+ if (capture.branch && capture.pullRequest)
26
+ throw new Error("A Sonar capture must select a branch or a pull request, not both.");
27
+ const url = URL.parse(capture.server);
28
+ if (!url ||
29
+ !["https:", "http:"].includes(url.protocol) ||
30
+ url.username ||
31
+ url.password ||
32
+ url.search ||
33
+ url.hash)
34
+ throw new Error("Expected an HTTP(S) Sonar server URL without credentials, query or fragment.");
35
+ capture.server = url.href.replace(/\/$/u, "");
36
+ if (capture.repositoryUrl)
37
+ declaredScannerRepositoryUrl(capture.repositoryUrl, "Sonar", "local");
38
+ return capture;
39
+ }
40
+ const issueScopeFields = [
41
+ "organization",
42
+ "project",
43
+ "branch",
44
+ "pullRequest",
45
+ ];
46
+ const scopeFields = ["server", ...issueScopeFields];
47
+ function mergeSonarScope(scope, data, fields = scopeFields) {
48
+ for (const field of fields) {
49
+ const value = text(data[field]);
50
+ if (value === null)
51
+ continue;
52
+ if (scope[field] !== undefined && scope[field] !== value)
53
+ throw new Error(`The Sonar export contains conflicting ${field} values.`);
54
+ scope[field] = value;
55
+ }
56
+ if (scope.branch && scope.pullRequest)
57
+ throw new Error("The Sonar export mixes branch and pull request results.");
58
+ }
59
+ function requireConsistentSonarRef(scope, hasUnscopedIssue) {
60
+ if (hasUnscopedIssue && (scope.branch || scope.pullRequest))
61
+ throw new Error("The Sonar export mixes issues with a named ref and issues without a ref.");
62
+ }
63
+ /** Normalized Sonar reports and their individual issues retain the source repository. */
64
+ export function sonarRepositoryUrls(provider, findings, report, target) {
65
+ const urls = new Set();
66
+ function add(data, scope) {
67
+ if (data?.["format"] !== sonarFormat)
68
+ return;
69
+ if (provider !== "sonar")
70
+ throw new Error("Retained Sonar evidence requires the sonar provider.");
71
+ mergeSonarScope(scope, data);
72
+ urls.add(declaredScannerRepositoryUrl(data["repositoryUrl"], "Sonar", target));
73
+ }
74
+ const reportScope = {};
75
+ add(report, reportScope);
76
+ const scope = { ...reportScope };
77
+ let hasUnscopedIssue = false;
78
+ for (const { evidence, source_finding_id } of findings) {
79
+ const data = evidence.source_data;
80
+ const rowScope = { ...reportScope };
81
+ add(data ?? undefined, rowScope);
82
+ if (data?.["format"] === sonarFormat && data["issue"] !== undefined) {
83
+ const issue = record(data["issue"], "Retained Sonar issue");
84
+ mergeSonarScope(rowScope, issue, issueScopeFields);
85
+ if (requiredText(issue["key"], "Retained Sonar issue key") !==
86
+ source_finding_id)
87
+ throw new Error("The normalized finding ID does not match the retained Sonar issue key.");
88
+ }
89
+ mergeSonarScope(scope, rowScope);
90
+ if (!rowScope.branch && !rowScope.pullRequest)
91
+ hasUnscopedIssue = true;
92
+ }
93
+ requireConsistentSonarRef(scope, hasUnscopedIssue);
94
+ if (scope.branch &&
95
+ findings.some(({ evidence }) => (report?.["format"] === sonarFormat ||
96
+ evidence.source_data?.["format"] === sonarFormat) &&
97
+ evidence.branch != null &&
98
+ evidence.branch !== scope.branch))
99
+ throw new Error("The finding branch does not match the retained Sonar branch.");
100
+ return urls;
101
+ }
102
+ const pagingSchema = z.object({
103
+ pageIndex: z.int().positive(),
104
+ pageSize: z.int().positive(),
105
+ total: z.int().nonnegative(),
106
+ });
107
+ function indexByKey(value, label) {
108
+ const index = new Map();
109
+ for (const item of array(value ?? [], label)) {
110
+ const row = record(item, label);
111
+ const key = requiredText(row["key"], `${label} key`);
112
+ index.set(key, row);
113
+ }
114
+ return index;
115
+ }
116
+ export function mergeSonarIssueScope(scope, issue) {
117
+ mergeSonarScope(scope, issue, issueScopeFields);
118
+ }
119
+ function readPage(value) {
120
+ const page = record(value, "Sonar issue search page");
121
+ return {
122
+ paging: pagingSchema.parse(page["paging"]),
123
+ issues: array(page["issues"], "Sonar issues").map((issue) => record(issue, "Sonar issue")),
124
+ components: indexByKey(page["components"], "Sonar component"),
125
+ rules: indexByKey(page["rules"], "Sonar rule"),
126
+ };
127
+ }
128
+ function completeQueryPages(values) {
129
+ const pages = values
130
+ .map(readPage)
131
+ .sort((a, b) => a.paging.pageIndex - b.paging.pageIndex);
132
+ const first = pages[0]?.paging;
133
+ if (!first ||
134
+ pages.length !== Math.max(1, Math.ceil(first.total / first.pageSize)) ||
135
+ pages.some(({ paging, issues }, i) => paging.pageIndex !== i + 1 ||
136
+ paging.total !== first.total ||
137
+ paging.pageSize !== first.pageSize ||
138
+ issues.length !==
139
+ Math.min(first.pageSize, first.total - i * first.pageSize)))
140
+ throw new Error("Supply every Sonar issue search page exactly once, with consistent paging and issue counts.");
141
+ return pages;
142
+ }
143
+ export function completeSonarPages(values, queryPageCounts) {
144
+ const counts = queryPageCounts ?? [values.length];
145
+ if (counts.reduce((sum, count) => sum + count, 0) !== values.length)
146
+ throw new Error("Sonar query page counts do not match the captured pages.");
147
+ let offset = 0;
148
+ const pages = counts.flatMap((count) => {
149
+ const query = values.slice(offset, offset + count);
150
+ offset += count;
151
+ return completeQueryPages(query);
152
+ });
153
+ const ids = new Set();
154
+ for (const { issues } of pages) {
155
+ for (const issue of issues) {
156
+ const id = text(issue["key"]);
157
+ if (id && ids.has(id))
158
+ throw new Error("Sonar issue search pages overlap. Collect the selection again.");
159
+ if (id)
160
+ ids.add(id);
161
+ }
162
+ }
163
+ return pages;
164
+ }
165
+ const severityLevels = {
166
+ BLOCKER: "critical",
167
+ HIGH: "high",
168
+ MEDIUM: "medium",
169
+ LOW: "low",
170
+ INFO: "informational",
171
+ CRITICAL: "high",
172
+ MAJOR: "medium",
173
+ MINOR: "low",
174
+ };
175
+ function securitySeverity(issue) {
176
+ const impacts = array(issue["impacts"] ?? [], "Sonar issue impacts");
177
+ const security = impacts.find((impact) => isRecord(impact) && impact["softwareQuality"] === "SECURITY");
178
+ if (!isRecord(security) &&
179
+ (impacts.length || issue["type"] !== "VULNERABILITY"))
180
+ throw new Error("Sonar issue has no security impact or legacy vulnerability type.");
181
+ const value = isRecord(security) ? security["severity"] : issue["severity"];
182
+ return typeof value === "string" && Object.hasOwn(severityLevels, value)
183
+ ? severityLevels[value]
184
+ : "unknown";
185
+ }
186
+ function relatedComponents(issue, primary, components) {
187
+ const keys = new Set([primary]);
188
+ for (const value of array(issue["flows"] ?? [], "Sonar issue flows")) {
189
+ const flow = record(value, "Sonar flow");
190
+ for (const entry of array(flow["locations"], "Sonar flow locations")) {
191
+ const location = record(entry, "Sonar flow location");
192
+ const key = text(location["component"]);
193
+ if (key)
194
+ keys.add(key);
195
+ }
196
+ }
197
+ return Array.from(keys).flatMap((key) => components.get(key) ?? []);
198
+ }
199
+ function issueLink(server, project, id, branch, pullRequest) {
200
+ const link = new URL("project/issues", server + "/");
201
+ link.searchParams.set("id", project);
202
+ if (branch)
203
+ link.searchParams.set("branch", branch);
204
+ if (pullRequest)
205
+ link.searchParams.set("pullRequest", pullRequest);
206
+ link.searchParams.set("open", id);
207
+ link.searchParams.set("issues", id);
208
+ return link.href;
209
+ }
210
+ export function normalizeSonarFindings(input, sourceRepositoryUrl, target = "cloud") {
211
+ const capture = isRecord(input) && "format" in input ? parseSonarCapture(input) : undefined;
212
+ const repository = declaredScannerRepositoryUrl(capture?.repositoryUrl ?? sourceRepositoryUrl, "Sonar", target);
213
+ if (capture?.repositoryUrl && sourceRepositoryUrl) {
214
+ const key = target === "cloud" ? cloudRepositoryUrlKey : repositoryUrlKey;
215
+ if (key(repository) !==
216
+ key(declaredScannerRepositoryUrl(sourceRepositoryUrl, "Sonar", target)))
217
+ throw new Error("The Sonar capture repository does not match the declared source repository.");
218
+ }
219
+ const pages = completeSonarPages(capture?.pages ?? (Array.isArray(input) ? input : [input]), capture?.queryPageCounts);
220
+ const rows = pages.flatMap((page) => page.issues.map((issue) => ({ issue, page })));
221
+ const scope = {};
222
+ if (capture)
223
+ mergeSonarScope(scope, capture);
224
+ const hasUnscopedIssue = rows.some(({ issue }) => !text(issue["branch"]) && !text(issue["pullRequest"]));
225
+ for (const { issue } of rows) {
226
+ requiredText(issue["project"], "Sonar issue project");
227
+ mergeSonarIssueScope(scope, issue);
228
+ }
229
+ requireConsistentSonarRef(scope, !capture?.branch && !capture?.pullRequest && hasUnscopedIssue);
230
+ const context = {
231
+ format: sonarFormat,
232
+ ...(capture?.projectBase !== undefined && {
233
+ projectBase: capture.projectBase,
234
+ }),
235
+ ...scope,
236
+ repositoryUrl: repository,
237
+ };
238
+ return normalizeRecords(rows, ({ issue, page }, id) => {
239
+ const component = requiredText(issue["component"], "Sonar issue component");
240
+ const componentPath = relativePath(page.components.get(component)?.["path"]);
241
+ const base = capture?.projectBase;
242
+ const path = componentPath && base !== undefined
243
+ ? base
244
+ ? `${base}/${componentPath}`
245
+ : componentPath
246
+ : null;
247
+ const range = issue["textRange"] == null
248
+ ? null
249
+ : record(issue["textRange"], "Sonar issue textRange");
250
+ const line = range?.["startLine"] ?? issue["line"] ?? null;
251
+ const rule = requiredText(issue["rule"], "Sonar issue rule");
252
+ const descriptor = page.rules.get(rule);
253
+ const name = text(descriptor?.["name"]);
254
+ const updated = text(issue["updateDate"]);
255
+ const severity = securitySeverity(issue);
256
+ return validateExternalEvidence({
257
+ title: name ?? rule,
258
+ severity,
259
+ description: text(issue["message"]),
260
+ url: capture
261
+ ? issueLink(capture.server, capture.project, id, scope.branch, scope.pullRequest)
262
+ : null,
263
+ locations: path ? [{ path, line }] : [],
264
+ branch: scope.branch ?? null,
265
+ source_updated_at: updated
266
+ ? Math.floor(Date.parse(updated) / 1000)
267
+ : null,
268
+ details: {
269
+ kind: "sast",
270
+ scanner_origin: "SonarQube",
271
+ repository: { url: repository },
272
+ source_status: text(issue["issueStatus"]) ?? text(issue["status"]),
273
+ rule: { id: rule, name },
274
+ code: { end_line: path ? (range?.["endLine"] ?? null) : null },
275
+ },
276
+ source_data: structuredClone({
277
+ ...context,
278
+ issue,
279
+ components: relatedComponents(issue, component, page.components),
280
+ ...(descriptor && { rule: descriptor }),
281
+ }),
282
+ }, target);
283
+ }, ({ issue }) => requiredText(issue["key"], "Sonar issue key"), target, { report: context });
284
+ }
285
+ export async function readSonarFindings(path, sourceRepositoryUrl, target = "cloud") {
286
+ return normalizeSonarFindings(await readScannerJson(path), sourceRepositoryUrl, target);
287
+ }
288
+ //# sourceMappingURL=sonar-findings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sonar-findings.js","sourceRoot":"","sources":["../src/sonar-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport {\n cloudRepositoryUrlKey,\n type ExternalImportTarget,\n repositoryUrlKey,\n validateExternalEvidence,\n} from \"./external-import-contract.js\";\nimport type { ExternalFindings } from \"./external-findings.js\";\nimport type { Provider, Severity } from \"./external-import-models.js\";\nimport { isRecord } from \"./record.js\";\nimport {\n array,\n normalizeRecords,\n readScannerJson,\n record,\n relativePath,\n requiredText,\n text,\n} from \"./scanner-import.js\";\nimport { declaredScannerRepositoryUrl } from \"./scanner-repository-url.js\";\n\nconst sonarFormat = \"sonar-issues/v1\";\nconst captureText = z.string().refine((value) => Boolean(value.trim()));\nconst captureSchema = z.object({\n format: z.literal(sonarFormat),\n server: captureText,\n organization: captureText,\n project: captureText,\n branch: captureText.optional(),\n pullRequest: captureText.optional(),\n repositoryUrl: captureText.optional(),\n projectBase: z\n .string()\n .refine((path) => path === \"\" || relativePath(path) === path)\n .optional(),\n pages: z.array(z.unknown()).min(1),\n queryPageCounts: z.array(z.int().positive()).min(1).optional(),\n});\nexport type SonarCapture = z.infer<typeof captureSchema>;\n\nexport function parseSonarCapture(value: unknown): SonarCapture {\n const capture = captureSchema.parse(value);\n if (capture.branch && capture.pullRequest)\n throw new Error(\n \"A Sonar capture must select a branch or a pull request, not both.\",\n );\n const url = URL.parse(capture.server);\n if (\n !url ||\n ![\"https:\", \"http:\"].includes(url.protocol) ||\n url.username ||\n url.password ||\n url.search ||\n url.hash\n )\n throw new Error(\n \"Expected an HTTP(S) Sonar server URL without credentials, query or fragment.\",\n );\n capture.server = url.href.replace(/\\/$/u, \"\");\n if (capture.repositoryUrl)\n declaredScannerRepositoryUrl(capture.repositoryUrl, \"Sonar\", \"local\");\n return capture;\n}\n\ntype NativeRecord = Record<string, unknown>;\n\nconst issueScopeFields = [\n \"organization\",\n \"project\",\n \"branch\",\n \"pullRequest\",\n] as const;\nconst scopeFields = [\"server\", ...issueScopeFields] as const;\ntype SonarScope = Partial<Record<(typeof scopeFields)[number], string>>;\n\nfunction mergeSonarScope(\n scope: SonarScope,\n data: NativeRecord,\n fields: readonly (keyof SonarScope)[] = scopeFields,\n) {\n for (const field of fields) {\n const value = text(data[field]);\n if (value === null) continue;\n if (scope[field] !== undefined && scope[field] !== value)\n throw new Error(`The Sonar export contains conflicting ${field} values.`);\n scope[field] = value;\n }\n if (scope.branch && scope.pullRequest)\n throw new Error(\"The Sonar export mixes branch and pull request results.\");\n}\n\nfunction requireConsistentSonarRef(\n scope: SonarScope,\n hasUnscopedIssue: boolean,\n) {\n if (hasUnscopedIssue && (scope.branch || scope.pullRequest))\n throw new Error(\n \"The Sonar export mixes issues with a named ref and issues without a ref.\",\n );\n}\n\n/** Normalized Sonar reports and their individual issues retain the source repository. */\nexport function sonarRepositoryUrls(\n provider: Provider,\n findings: ExternalFindings[\"findings\"],\n report: ExternalFindings[\"report\"],\n target: ExternalImportTarget,\n): Set<string> {\n const urls = new Set<string>();\n function add(data: NativeRecord | undefined, scope: SonarScope) {\n if (data?.[\"format\"] !== sonarFormat) return;\n if (provider !== \"sonar\")\n throw new Error(\"Retained Sonar evidence requires the sonar provider.\");\n mergeSonarScope(scope, data);\n urls.add(\n declaredScannerRepositoryUrl(data[\"repositoryUrl\"], \"Sonar\", target),\n );\n }\n const reportScope: SonarScope = {};\n add(report, reportScope);\n const scope = { ...reportScope };\n let hasUnscopedIssue = false;\n for (const { evidence, source_finding_id } of findings) {\n const data = evidence.source_data;\n const rowScope = { ...reportScope };\n add(data ?? undefined, rowScope);\n if (data?.[\"format\"] === sonarFormat && data[\"issue\"] !== undefined) {\n const issue = record(data[\"issue\"], \"Retained Sonar issue\");\n mergeSonarScope(rowScope, issue, issueScopeFields);\n if (\n requiredText(issue[\"key\"], \"Retained Sonar issue key\") !==\n source_finding_id\n )\n throw new Error(\n \"The normalized finding ID does not match the retained Sonar issue key.\",\n );\n }\n mergeSonarScope(scope, rowScope);\n if (!rowScope.branch && !rowScope.pullRequest) hasUnscopedIssue = true;\n }\n requireConsistentSonarRef(scope, hasUnscopedIssue);\n if (\n scope.branch &&\n findings.some(\n ({ evidence }) =>\n (report?.[\"format\"] === sonarFormat ||\n evidence.source_data?.[\"format\"] === sonarFormat) &&\n evidence.branch != null &&\n evidence.branch !== scope.branch,\n )\n )\n throw new Error(\n \"The finding branch does not match the retained Sonar branch.\",\n );\n return urls;\n}\n\nconst pagingSchema = z.object({\n pageIndex: z.int().positive(),\n pageSize: z.int().positive(),\n total: z.int().nonnegative(),\n});\n\nfunction indexByKey(value: unknown, label: string) {\n const index = new Map<string, NativeRecord>();\n for (const item of array(value ?? [], label)) {\n const row = record(item, label);\n const key = requiredText(row[\"key\"], `${label} key`);\n index.set(key, row);\n }\n return index;\n}\n\nexport function mergeSonarIssueScope(scope: SonarScope, issue: NativeRecord) {\n mergeSonarScope(scope, issue, issueScopeFields);\n}\n\nfunction readPage(value: unknown) {\n const page = record(value, \"Sonar issue search page\");\n return {\n paging: pagingSchema.parse(page[\"paging\"]),\n issues: array(page[\"issues\"], \"Sonar issues\").map((issue) =>\n record(issue, \"Sonar issue\"),\n ),\n components: indexByKey(page[\"components\"], \"Sonar component\"),\n rules: indexByKey(page[\"rules\"], \"Sonar rule\"),\n };\n}\n\nfunction completeQueryPages(values: unknown[]) {\n const pages = values\n .map(readPage)\n .sort((a, b) => a.paging.pageIndex - b.paging.pageIndex);\n const first = pages[0]?.paging;\n if (\n !first ||\n pages.length !== Math.max(1, Math.ceil(first.total / first.pageSize)) ||\n pages.some(\n ({ paging, issues }, i) =>\n paging.pageIndex !== i + 1 ||\n paging.total !== first.total ||\n paging.pageSize !== first.pageSize ||\n issues.length !==\n Math.min(first.pageSize, first.total - i * first.pageSize),\n )\n )\n throw new Error(\n \"Supply every Sonar issue search page exactly once, with consistent paging and issue counts.\",\n );\n return pages;\n}\n\nexport function completeSonarPages(\n values: unknown[],\n queryPageCounts?: number[],\n) {\n const counts = queryPageCounts ?? [values.length];\n if (counts.reduce((sum, count) => sum + count, 0) !== values.length)\n throw new Error(\"Sonar query page counts do not match the captured pages.\");\n let offset = 0;\n const pages = counts.flatMap((count) => {\n const query = values.slice(offset, offset + count);\n offset += count;\n return completeQueryPages(query);\n });\n const ids = new Set<string>();\n for (const { issues } of pages) {\n for (const issue of issues) {\n const id = text(issue[\"key\"]);\n if (id && ids.has(id))\n throw new Error(\n \"Sonar issue search pages overlap. Collect the selection again.\",\n );\n if (id) ids.add(id);\n }\n }\n return pages;\n}\n\nconst severityLevels: Readonly<Record<string, Severity>> = {\n BLOCKER: \"critical\",\n HIGH: \"high\",\n MEDIUM: \"medium\",\n LOW: \"low\",\n INFO: \"informational\",\n CRITICAL: \"high\",\n MAJOR: \"medium\",\n MINOR: \"low\",\n};\n\nfunction securitySeverity(issue: NativeRecord): Severity {\n const impacts = array(issue[\"impacts\"] ?? [], \"Sonar issue impacts\");\n const security = impacts.find(\n (impact) => isRecord(impact) && impact[\"softwareQuality\"] === \"SECURITY\",\n );\n if (\n !isRecord(security) &&\n (impacts.length || issue[\"type\"] !== \"VULNERABILITY\")\n )\n throw new Error(\n \"Sonar issue has no security impact or legacy vulnerability type.\",\n );\n const value = isRecord(security) ? security[\"severity\"] : issue[\"severity\"];\n return typeof value === \"string\" && Object.hasOwn(severityLevels, value)\n ? severityLevels[value]!\n : \"unknown\";\n}\n\nfunction relatedComponents(\n issue: NativeRecord,\n primary: string,\n components: Map<string, NativeRecord>,\n) {\n const keys = new Set([primary]);\n for (const value of array(issue[\"flows\"] ?? [], \"Sonar issue flows\")) {\n const flow = record(value, \"Sonar flow\");\n for (const entry of array(flow[\"locations\"], \"Sonar flow locations\")) {\n const location = record(entry, \"Sonar flow location\");\n const key = text(location[\"component\"]);\n if (key) keys.add(key);\n }\n }\n return Array.from(keys).flatMap((key) => components.get(key) ?? []);\n}\n\nfunction issueLink(\n server: string,\n project: string,\n id: string,\n branch?: string,\n pullRequest?: string,\n) {\n const link = new URL(\"project/issues\", server + \"/\");\n link.searchParams.set(\"id\", project);\n if (branch) link.searchParams.set(\"branch\", branch);\n if (pullRequest) link.searchParams.set(\"pullRequest\", pullRequest);\n link.searchParams.set(\"open\", id);\n link.searchParams.set(\"issues\", id);\n return link.href;\n}\n\nexport function normalizeSonarFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n) {\n const capture =\n isRecord(input) && \"format\" in input ? parseSonarCapture(input) : undefined;\n const repository = declaredScannerRepositoryUrl(\n capture?.repositoryUrl ?? sourceRepositoryUrl,\n \"Sonar\",\n target,\n );\n if (capture?.repositoryUrl && sourceRepositoryUrl) {\n const key = target === \"cloud\" ? cloudRepositoryUrlKey : repositoryUrlKey;\n if (\n key(repository) !==\n key(declaredScannerRepositoryUrl(sourceRepositoryUrl, \"Sonar\", target))\n )\n throw new Error(\n \"The Sonar capture repository does not match the declared source repository.\",\n );\n }\n const pages = completeSonarPages(\n capture?.pages ?? (Array.isArray(input) ? input : [input]),\n capture?.queryPageCounts,\n );\n const rows = pages.flatMap((page) =>\n page.issues.map((issue) => ({ issue, page })),\n );\n const scope: SonarScope = {};\n if (capture) mergeSonarScope(scope, capture);\n const hasUnscopedIssue = rows.some(\n ({ issue }) => !text(issue[\"branch\"]) && !text(issue[\"pullRequest\"]),\n );\n for (const { issue } of rows) {\n requiredText(issue[\"project\"], \"Sonar issue project\");\n mergeSonarIssueScope(scope, issue);\n }\n requireConsistentSonarRef(\n scope,\n !capture?.branch && !capture?.pullRequest && hasUnscopedIssue,\n );\n const context = {\n format: sonarFormat,\n ...(capture?.projectBase !== undefined && {\n projectBase: capture.projectBase,\n }),\n ...scope,\n repositoryUrl: repository,\n };\n return normalizeRecords(\n rows,\n ({ issue, page }, id) => {\n const component = requiredText(\n issue[\"component\"],\n \"Sonar issue component\",\n );\n const componentPath = relativePath(\n page.components.get(component)?.[\"path\"],\n );\n const base = capture?.projectBase;\n const path =\n componentPath && base !== undefined\n ? base\n ? `${base}/${componentPath}`\n : componentPath\n : null;\n const range =\n issue[\"textRange\"] == null\n ? null\n : record(issue[\"textRange\"], \"Sonar issue textRange\");\n const line = range?.[\"startLine\"] ?? issue[\"line\"] ?? null;\n const rule = requiredText(issue[\"rule\"], \"Sonar issue rule\");\n const descriptor = page.rules.get(rule);\n const name = text(descriptor?.[\"name\"]);\n const updated = text(issue[\"updateDate\"]);\n const severity = securitySeverity(issue);\n return validateExternalEvidence(\n {\n title: name ?? rule,\n severity,\n description: text(issue[\"message\"]),\n url: capture\n ? issueLink(\n capture.server,\n capture.project,\n id,\n scope.branch,\n scope.pullRequest,\n )\n : null,\n locations: path ? [{ path, line }] : [],\n branch: scope.branch ?? null,\n source_updated_at: updated\n ? Math.floor(Date.parse(updated) / 1000)\n : null,\n details: {\n kind: \"sast\",\n scanner_origin: \"SonarQube\",\n repository: { url: repository },\n source_status: text(issue[\"issueStatus\"]) ?? text(issue[\"status\"]),\n rule: { id: rule, name },\n code: { end_line: path ? (range?.[\"endLine\"] ?? null) : null },\n },\n source_data: structuredClone({\n ...context,\n issue,\n components: relatedComponents(issue, component, page.components),\n ...(descriptor && { rule: descriptor }),\n }),\n },\n target,\n );\n },\n ({ issue }) => requiredText(issue[\"key\"], \"Sonar issue key\"),\n target,\n { report: context },\n ) as ExternalFindings & { report: typeof context };\n}\n\nexport async function readSonarFindings(\n path: string,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeSonarFindings(\n await readScannerJson(path),\n sourceRepositoryUrl,\n target,\n );\n}\n"]}
@@ -0,0 +1,111 @@
1
+ import { collectSonarIssues } from "./sonar-collector.js";
2
+ import { type ExternalPublicationDependencies, type ExternalPublicationPreview } from "./external-findings-publish.js";
3
+ interface SonarImportOptions {
4
+ cwd: string;
5
+ capture?: string | undefined;
6
+ project?: string | undefined;
7
+ branch?: string | undefined;
8
+ pullRequest?: string | undefined;
9
+ issueKeys: string[];
10
+ sourceRepositoryUrl?: string | undefined;
11
+ to: "local" | "cloud";
12
+ dryRun: boolean;
13
+ yes: boolean;
14
+ }
15
+ export declare function prepareSonarImport(options: SonarImportOptions, dependencies: ExternalPublicationDependencies & {
16
+ collect?: typeof collectSonarIssues;
17
+ onCapture?: (path: string) => void;
18
+ }): Promise<{
19
+ info: {
20
+ capture: string;
21
+ repository: string;
22
+ repositoryUrl: string;
23
+ sourceKey: string;
24
+ server: string;
25
+ organization: string;
26
+ project: string;
27
+ branch: string | undefined;
28
+ pullRequest: string | undefined;
29
+ };
30
+ local: import("./external-findings-local.js").LocalExternalImportPreview;
31
+ cloud: ExternalPublicationPreview | undefined;
32
+ cloudError: string | undefined;
33
+ import(): Promise<{
34
+ capture: string;
35
+ repository: string;
36
+ repositoryUrl: string;
37
+ sourceKey: string;
38
+ server: string;
39
+ organization: string;
40
+ project: string;
41
+ branch: string | undefined;
42
+ pullRequest: string | undefined;
43
+ local: {
44
+ counts: {
45
+ created: number;
46
+ updated: number;
47
+ unchanged: number;
48
+ };
49
+ ready: number;
50
+ excluded: {
51
+ position: number;
52
+ source_finding_id: string | null;
53
+ reason: string;
54
+ }[];
55
+ };
56
+ cloudError: string | undefined;
57
+ cloud: undefined;
58
+ } | {
59
+ capture: string;
60
+ repository: string;
61
+ repositoryUrl: string;
62
+ sourceKey: string;
63
+ server: string;
64
+ organization: string;
65
+ project: string;
66
+ branch: string | undefined;
67
+ pullRequest: string | undefined;
68
+ local: {
69
+ counts: {
70
+ created: number;
71
+ updated: number;
72
+ unchanged: number;
73
+ };
74
+ ready: number;
75
+ excluded: {
76
+ position: number;
77
+ source_finding_id: string | null;
78
+ reason: string;
79
+ }[];
80
+ };
81
+ cloud: import("./external-findings-publish.js").ExternalPublicationResult;
82
+ cloudError: undefined;
83
+ } | {
84
+ capture: string;
85
+ repository: string;
86
+ repositoryUrl: string;
87
+ sourceKey: string;
88
+ server: string;
89
+ organization: string;
90
+ project: string;
91
+ branch: string | undefined;
92
+ pullRequest: string | undefined;
93
+ local: {
94
+ counts: {
95
+ created: number;
96
+ updated: number;
97
+ unchanged: number;
98
+ };
99
+ ready: number;
100
+ excluded: {
101
+ position: number;
102
+ source_finding_id: string | null;
103
+ reason: string;
104
+ }[];
105
+ };
106
+ cloudError: string;
107
+ cloud: import("./external-findings-publish.js").ExternalPublicationResult | undefined;
108
+ }>;
109
+ }>;
110
+ export {};
111
+ //# sourceMappingURL=sonar-import.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sonar-import.d.ts","sourceRoot":"","sources":["../src/sonar-import.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,OAAO,EAKL,KAAK,+BAA+B,EACpC,KAAK,0BAA0B,EAEhC,MAAM,gCAAgC,CAAC;AAqBxC,UAAU,kBAAkB;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AA8ED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,YAAY,EAAE,+BAA+B,GAAG;IAC9C,OAAO,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACpC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+QF"}