@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,320 @@
1
+ import { CodexSecurityError } from "./errors.js";
2
+ import { validateEnrichedExternalEvidence, } from "./external-import-contract.js";
3
+ import { canonicalJson, isRecord } from "./record.js";
4
+ import { array, normalizeRecords, readScannerJson, record, reportableScannerSeverity, requiredText, stableId, text, } from "./scanner-import.js";
5
+ import { declaredScannerRepositoryUrl, repositoryScopeValidator, } from "./scanner-repository-url.js";
6
+ const format = "blackduck-bom-6";
7
+ const componentVersionPath = /^components\/[^/]+\/versions\/[^/]+$/u;
8
+ const nativeId = /^blackduck-bom:[a-f0-9]{64}$/u;
9
+ export function projectedBlackDuckRepositoryUrl(finding, target) {
10
+ if (!nativeId.test(finding.source_finding_id))
11
+ return;
12
+ const url = finding.evidence.source_data?.["sourceRepositoryUrl"];
13
+ if (typeof url === "string")
14
+ return declaredScannerRepositoryUrl(url, "Black Duck", target);
15
+ return finding.evidence.details?.repository?.url ?? undefined;
16
+ }
17
+ function hasBlackDuckEvidence(data) {
18
+ if (!isRecord(data))
19
+ return false;
20
+ return (data["format"] === format ||
21
+ [data, data["row"]].some((row) => {
22
+ if (!isRecord(row) || !isRecord(row["vulnerabilityWithRemediation"]))
23
+ return false;
24
+ const resource = parseApiResource(text(row["componentVersion"]));
25
+ return resource !== undefined && componentVersionPath.test(resource.path);
26
+ }));
27
+ }
28
+ function retainedRepository(provider, finding, target) {
29
+ const { source_finding_id: id, evidence: { source_data: data }, } = finding;
30
+ const nativeEvidence = hasBlackDuckEvidence(data);
31
+ if (provider !== "blackduck") {
32
+ if (nativeEvidence)
33
+ throw new CodexSecurityError("Retained Black Duck evidence requires the blackduck provider.");
34
+ const url = projectedBlackDuckRepositoryUrl(finding, target);
35
+ return url ? { url } : undefined;
36
+ }
37
+ const native = nativeEvidence || nativeId.test(id);
38
+ if (native && (!isRecord(data) || !isRecord(data["row"])))
39
+ throw new Error("Expected retained Black Duck BOM occurrence evidence.");
40
+ if (!isRecord(data) || (!native && !("sourceRepositoryUrl" in data)))
41
+ return;
42
+ const url = declaredScannerRepositoryUrl(data["sourceRepositoryUrl"], "Black Duck", target);
43
+ if (!native)
44
+ return { url };
45
+ const resource = apiResource(data["projectVersionUrl"], "retained project-version URL");
46
+ if (!/^projects\/[^/]+\/versions\/[^/]+$/u.test(resource.path) ||
47
+ resource.query.size)
48
+ throw new Error("Invalid retained Black Duck project-version URL.");
49
+ const projectVersion = `${resource.base}/${resource.path}`;
50
+ const actual = occurrenceId(scopedRow(data["row"], projectVersion, false), projectVersion);
51
+ if (id !== actual)
52
+ throw new Error("Black Duck source finding ID contradicts the retained native occurrence.");
53
+ return { url, scope: projectVersion };
54
+ }
55
+ export const blackDuckReportRepositories = repositoryScopeValidator({ provider: "blackduck", label: "Black Duck", scope: "project version" }, retainedRepository);
56
+ function parseApiResource(href) {
57
+ const url = href && URL.parse(href);
58
+ const parts = url && /^(.*\/api)\/(.+?)\/?$/u.exec(url.pathname);
59
+ if (!url ||
60
+ !parts ||
61
+ !["http:", "https:"].includes(url.protocol) ||
62
+ url.username ||
63
+ url.password ||
64
+ url.hash)
65
+ return;
66
+ return {
67
+ base: url.origin + parts[1],
68
+ path: parts[2],
69
+ query: url.searchParams,
70
+ };
71
+ }
72
+ function apiResource(href, label) {
73
+ const resource = parseApiResource(requiredText(href, label));
74
+ if (!resource)
75
+ throw new Error(`Expected a credential-free Black Duck API URL for ${label}.`);
76
+ return resource;
77
+ }
78
+ function links(meta) {
79
+ if (meta === undefined)
80
+ return [];
81
+ const value = record(meta, "Black Duck _meta")["links"];
82
+ return value === undefined
83
+ ? []
84
+ : array(value, "Black Duck _meta.links").map((entry) => record(entry, "Black Duck link"));
85
+ }
86
+ function collectionScope(collection) {
87
+ const meta = record(collection["_meta"], "Black Duck collection _meta");
88
+ const resource = apiResource(meta["href"], "collection href");
89
+ const project = /^projects?\/([^/]+)\/versions\/([^/]+)\/vulnerable-bom-components$/u.exec(resource.path);
90
+ if (!project)
91
+ throw new Error("Expected a Black Duck project-version vulnerable-bom-components collection.");
92
+ if (resource.query.getAll("offset").some((offset) => !/^0+$/u.test(offset)) ||
93
+ links(meta).some((link) => ["next", "prev", "previous"].includes(String(link["rel"]))))
94
+ throw new Error("Incomplete Black Duck collection page. Supply a complete export or explicitly selected rows.");
95
+ return `${resource.base}/projects/${project[1]}/versions/${project[2]}`;
96
+ }
97
+ function projectReference(href, relation) {
98
+ const label = relation === "remediation" ? "remediation URL" : "matched-files link";
99
+ const resource = apiResource(href, label);
100
+ const match = /^(projects\/[^/]+\/versions\/[^/]+)\/(components\/[^/]+\/versions\/[^/]+)(?:\/origins\/([^/]+))?\/(matched-files|vulnerabilities\/[^/]+\/remediation)$/u.exec(resource.path);
101
+ if (!match || !match[4].endsWith(relation))
102
+ throw new Error(`Invalid Black Duck project-version ${label}.`);
103
+ return {
104
+ scope: `${resource.base}/${match[1]}`,
105
+ component: `${resource.base}/${match[2]}`,
106
+ origin: match[3],
107
+ };
108
+ }
109
+ function scopedRow(value, scope, selected) {
110
+ const row = isRecord(value) ? value : {};
111
+ const meta = row["_meta"];
112
+ const declared = isRecord(meta) ? meta["links"] : undefined;
113
+ const matched = (Array.isArray(declared) ? declared : [])
114
+ .filter((link) => isRecord(link) && link["rel"] === "matched-files")
115
+ .map((link) => projectReference(link["href"], "matched-files"));
116
+ if (isRecord(meta) && meta["href"] !== undefined)
117
+ matched.push(projectReference(meta["href"], "remediation"));
118
+ if (selected && !matched.length)
119
+ throw new Error("Each selected Black Duck row must identify its project version with a remediation or matched-files link.");
120
+ for (const reference of matched) {
121
+ if (scope !== undefined && scope !== reference.scope)
122
+ throw new Error("Black Duck rows must belong to the same project version and server as the collection or selection.");
123
+ scope = reference.scope;
124
+ }
125
+ const vulnerability = row["vulnerabilityWithRemediation"];
126
+ return {
127
+ row,
128
+ matched,
129
+ scope,
130
+ // Shape errors are row exclusions; project-scope errors abort the report.
131
+ get vulnerability() {
132
+ record(value, "Black Duck BOM component");
133
+ return record(vulnerability, "Black Duck vulnerabilityWithRemediation");
134
+ },
135
+ };
136
+ }
137
+ function occurrenceId({ row, vulnerability, matched }, projectVersion) {
138
+ const resource = apiResource(row["componentVersion"], "componentVersion");
139
+ const component = `${resource.base}/${resource.path}`;
140
+ if (!componentVersionPath.test(resource.path) ||
141
+ resource.base !==
142
+ projectVersion.slice(0, projectVersion.lastIndexOf("/projects/")))
143
+ throw new Error("Black Duck componentVersion must identify a component version on the same server.");
144
+ const origins = new Set();
145
+ for (const reference of matched) {
146
+ if (reference.component !== component)
147
+ throw new Error("Black Duck project-version link contradicts componentVersion.");
148
+ if (reference.origin)
149
+ origins.add(reference.origin);
150
+ }
151
+ for (const link of links(row["_meta"]).filter((entry) => entry["rel"] === "vulnerabilities")) {
152
+ const reference = apiResource(link["href"], "vulnerabilities link");
153
+ const match = /^(components\/[^/]+\/versions\/[^/]+)(?:\/origin\/([^/]+))?\/vulnerabilities$/u.exec(reference.path);
154
+ if (!match)
155
+ continue;
156
+ if (`${reference.base}/${match[1]}` !== component)
157
+ throw new Error("Black Duck vulnerabilities link contradicts componentVersion.");
158
+ if (match[2])
159
+ origins.add(match[2]);
160
+ }
161
+ const [origin] = origins;
162
+ if (!origin || origins.size !== 1)
163
+ throw new Error("Black Duck row must identify one unambiguous component-version origin.");
164
+ const source = requiredText(vulnerability["source"], "Black Duck advisory source");
165
+ if (source !== "BDSA" && source !== "NVD")
166
+ throw new Error(`Unsupported Black Duck advisory source: ${source}.`);
167
+ return stableId("blackduck-bom", [
168
+ projectVersion,
169
+ component,
170
+ origin,
171
+ source,
172
+ requiredText(vulnerability["vulnerabilityName"], "Black Duck vulnerability name"),
173
+ ]);
174
+ }
175
+ const nameVersionForges = new Map([
176
+ ["npmjs", "npm"],
177
+ ["pypi", "pypi"],
178
+ ["nuget", "nuget"],
179
+ ["rubygems", "gem"],
180
+ ["crates", "cargo"],
181
+ ]);
182
+ function packageUrlName(ecosystem, parts) {
183
+ if (parts.some((part) => !part || part.includes("/")))
184
+ return;
185
+ if (ecosystem === "github" && parts.length === 2)
186
+ return parts.join("/").toLowerCase();
187
+ if (ecosystem === "maven" || ecosystem === "composer")
188
+ return parts.length === 2
189
+ ? parts.join(ecosystem === "maven" ? ":" : "/")
190
+ : undefined;
191
+ if (parts.length === 1 ||
192
+ ecosystem === "golang" ||
193
+ ecosystem === "generic" ||
194
+ (parts.length === 2 && ecosystem === "npm" && parts[0].startsWith("@")))
195
+ return parts.join("/");
196
+ }
197
+ function originPackage(row) {
198
+ const origin = text(row["componentVersionOriginName"])?.toLowerCase();
199
+ const id = text(row["componentVersionOriginId"]) ?? "";
200
+ if (origin === "maven") {
201
+ const coordinate = /^([^:\s/]+:[^:\s/]+):([^:\s/]+)$/u.exec(id);
202
+ if (coordinate)
203
+ return {
204
+ name: coordinate[1],
205
+ ecosystem: origin,
206
+ installed_version: coordinate[2],
207
+ };
208
+ }
209
+ const ecosystem = nameVersionForges.get(origin ?? "");
210
+ if (ecosystem) {
211
+ const coordinate = /^(?:(@[^/\s]+)\/)?([^/\s]+)\/([^/\s]+)$/u.exec(id);
212
+ if (coordinate && (!coordinate[1] || ecosystem === "npm"))
213
+ return {
214
+ name: id.slice(0, id.lastIndexOf("/")),
215
+ ecosystem,
216
+ installed_version: coordinate[3],
217
+ };
218
+ }
219
+ }
220
+ function blackDuckPackages(row) {
221
+ const origin = originPackage(row);
222
+ const fallback = origin ? [origin] : [];
223
+ const purl = /^pkg:([a-z][a-z0-9.+-]*)\/((?:@[^/@?#]+\/)?[^@?#]+)(?:@([^@?#]+))?(?:[?#].*)?$/iu.exec(text(row["packageUrl"]) ?? "");
224
+ if (purl) {
225
+ try {
226
+ const ecosystem = purl[1].toLowerCase();
227
+ const name = packageUrlName(ecosystem, purl[2].split("/").map(decodeURIComponent));
228
+ if (name) {
229
+ if (!purl[3] && origin?.ecosystem === ecosystem && origin.name === name)
230
+ return { packages: fallback };
231
+ const pkg = {
232
+ name,
233
+ ecosystem,
234
+ installed_version: purl[3]
235
+ ? decodeURIComponent(purl[3])
236
+ : text(row["componentVersionName"]),
237
+ };
238
+ // Earlier versions used the origin fallback for owner/repository PURLs.
239
+ return ecosystem === "github" && name.includes("/")
240
+ ? { packages: fallback, enrichment: { packages: [pkg] } }
241
+ : { packages: [pkg] };
242
+ }
243
+ }
244
+ catch {
245
+ // A malformed escape does not invalidate the native origin coordinate.
246
+ }
247
+ }
248
+ return { packages: fallback };
249
+ }
250
+ function normalizeReport(input, sourceRepositoryUrl, target, previous) {
251
+ const repository = declaredScannerRepositoryUrl(sourceRepositoryUrl, "Black Duck", target);
252
+ const selected = Array.isArray(input);
253
+ let scope;
254
+ let items;
255
+ if (selected) {
256
+ items = input;
257
+ }
258
+ else {
259
+ const collection = record(input, "Black Duck collection");
260
+ items = array(collection["items"], "Black Duck items");
261
+ scope = collectionScope(collection);
262
+ if (collection["totalCount"] !== items.length)
263
+ throw new Error("Incomplete Black Duck collection: totalCount must equal the number of items. Supply a complete export or explicitly selected rows.");
264
+ }
265
+ const rows = items.map((value) => {
266
+ const entry = scopedRow(value, scope, selected);
267
+ scope = entry.scope;
268
+ return entry;
269
+ });
270
+ if (!scope)
271
+ throw new Error("An empty Black Duck selection cannot identify a project version. Supply its complete collection envelope.");
272
+ const projectVersion = scope;
273
+ const result = normalizeRecords(rows, ({ row, vulnerability }) => {
274
+ const advisory = requiredText(vulnerability["vulnerabilityName"], "Black Duck vulnerability name");
275
+ const name = requiredText(row["componentName"], "Black Duck component name");
276
+ const related = text(vulnerability["relatedVulnerability"]);
277
+ const { packages, enrichment } = blackDuckPackages(row);
278
+ return validateEnrichedExternalEvidence({
279
+ title: `${advisory} in ${name}`,
280
+ description: text(vulnerability["description"]),
281
+ severity: reportableScannerSeverity(vulnerability["severity"]),
282
+ advisory_ids: related && related !== advisory ? [advisory, related] : [advisory],
283
+ packages,
284
+ source_data: {
285
+ format,
286
+ sourceRepositoryUrl: repository,
287
+ projectVersionUrl: projectVersion,
288
+ row: structuredClone(row),
289
+ },
290
+ }, target, previous ? undefined : enrichment);
291
+ }, (entry) => occurrenceId(entry, projectVersion), target);
292
+ if (!selected) {
293
+ // normalizeRecords excludes every collision. An unidentified row can also
294
+ // repeat across pages, so compare its original JSON when it has no ID.
295
+ const seen = new Set();
296
+ for (const excluded of result.excluded) {
297
+ const key = excluded.source_finding_id ??
298
+ canonicalJson(items[excluded.position - 1]);
299
+ if (seen.has(key))
300
+ throw new CodexSecurityError("Duplicate row in a collection with a declared total; pages may overlap. Retrieve the complete export again.");
301
+ seen.add(key);
302
+ }
303
+ }
304
+ return result;
305
+ }
306
+ export function normalizeBlackDuckFindings(input, sourceRepositoryUrl, target = "cloud") {
307
+ return normalizeReport(input, sourceRepositoryUrl, target, false);
308
+ }
309
+ /** @internal Earlier readers used the native origin fallback for GitHub package URLs. */
310
+ export function needsPreviousBlackDuckProjection({ findings, }) {
311
+ return findings.some(({ evidence }) => evidence.packages?.some((pkg) => pkg.ecosystem === "github" && pkg.name.includes("/")));
312
+ }
313
+ /** @internal Reconstruct the original evidence for an interrupted Cloud request. */
314
+ export function normalizePreviousBlackDuckFindings(input, sourceRepositoryUrl, target = "cloud") {
315
+ return normalizeReport(input, sourceRepositoryUrl, target, true);
316
+ }
317
+ export async function readBlackDuckFindings(path, sourceRepositoryUrl, target = "cloud") {
318
+ return normalizeBlackDuckFindings(await readScannerJson(path), sourceRepositoryUrl, target);
319
+ }
320
+ //# sourceMappingURL=blackduck-findings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"blackduck-findings.js","sourceRoot":"","sources":["../src/blackduck-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport type { Provider } from \"./external-import-models.js\";\nimport {\n type ExternalImportTarget,\n validateEnrichedExternalEvidence,\n} from \"./external-import-contract.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport { canonicalJson, isRecord } from \"./record.js\";\nimport {\n array,\n normalizeRecords,\n readScannerJson,\n record,\n reportableScannerSeverity,\n requiredText,\n stableId,\n text,\n} from \"./scanner-import.js\";\nimport {\n declaredScannerRepositoryUrl,\n repositoryScopeValidator,\n} from \"./scanner-repository-url.js\";\n\nconst format = \"blackduck-bom-6\";\nconst componentVersionPath = /^components\\/[^/]+\\/versions\\/[^/]+$/u;\nconst nativeId = /^blackduck-bom:[a-f0-9]{64}$/u;\n\nexport function projectedBlackDuckRepositoryUrl(\n finding: ExternalFinding,\n target: ExternalImportTarget,\n): string | undefined {\n if (!nativeId.test(finding.source_finding_id)) return;\n const url = finding.evidence.source_data?.[\"sourceRepositoryUrl\"];\n if (typeof url === \"string\")\n return declaredScannerRepositoryUrl(url, \"Black Duck\", target);\n return finding.evidence.details?.repository?.url ?? undefined;\n}\n\nfunction hasBlackDuckEvidence(data: unknown): boolean {\n if (!isRecord(data)) return false;\n return (\n data[\"format\"] === format ||\n [data, data[\"row\"]].some((row) => {\n if (!isRecord(row) || !isRecord(row[\"vulnerabilityWithRemediation\"]))\n return false;\n const resource = parseApiResource(text(row[\"componentVersion\"]));\n return resource !== undefined && componentVersionPath.test(resource.path);\n })\n );\n}\n\nfunction retainedRepository(\n provider: Provider,\n finding: ExternalFinding,\n target: ExternalImportTarget,\n): { url: string; scope?: string } | undefined {\n const {\n source_finding_id: id,\n evidence: { source_data: data },\n } = finding;\n const nativeEvidence = hasBlackDuckEvidence(data);\n if (provider !== \"blackduck\") {\n if (nativeEvidence)\n throw new CodexSecurityError(\n \"Retained Black Duck evidence requires the blackduck provider.\",\n );\n const url = projectedBlackDuckRepositoryUrl(finding, target);\n return url ? { url } : undefined;\n }\n const native = nativeEvidence || nativeId.test(id);\n if (native && (!isRecord(data) || !isRecord(data[\"row\"])))\n throw new Error(\"Expected retained Black Duck BOM occurrence evidence.\");\n if (!isRecord(data) || (!native && !(\"sourceRepositoryUrl\" in data))) return;\n const url = declaredScannerRepositoryUrl(\n data[\"sourceRepositoryUrl\"],\n \"Black Duck\",\n target,\n );\n if (!native) return { url };\n const resource = apiResource(\n data[\"projectVersionUrl\"],\n \"retained project-version URL\",\n );\n if (\n !/^projects\\/[^/]+\\/versions\\/[^/]+$/u.test(resource.path) ||\n resource.query.size\n )\n throw new Error(\"Invalid retained Black Duck project-version URL.\");\n const projectVersion = `${resource.base}/${resource.path}`;\n const actual = occurrenceId(\n scopedRow(data[\"row\"], projectVersion, false),\n projectVersion,\n );\n if (id !== actual)\n throw new Error(\n \"Black Duck source finding ID contradicts the retained native occurrence.\",\n );\n return { url, scope: projectVersion };\n}\n\nexport const blackDuckReportRepositories = repositoryScopeValidator(\n { provider: \"blackduck\", label: \"Black Duck\", scope: \"project version\" },\n retainedRepository,\n);\n\nfunction parseApiResource(href: string | null) {\n const url = href && URL.parse(href);\n const parts = url && /^(.*\\/api)\\/(.+?)\\/?$/u.exec(url.pathname);\n if (\n !url ||\n !parts ||\n ![\"http:\", \"https:\"].includes(url.protocol) ||\n url.username ||\n url.password ||\n url.hash\n )\n return;\n return {\n base: url.origin + parts[1],\n path: parts[2]!,\n query: url.searchParams,\n };\n}\n\nfunction apiResource(href: unknown, label: string) {\n const resource = parseApiResource(requiredText(href, label));\n if (!resource)\n throw new Error(\n `Expected a credential-free Black Duck API URL for ${label}.`,\n );\n return resource;\n}\n\nfunction links(meta: unknown): Record<string, unknown>[] {\n if (meta === undefined) return [];\n const value = record(meta, \"Black Duck _meta\")[\"links\"];\n return value === undefined\n ? []\n : array(value, \"Black Duck _meta.links\").map((entry) =>\n record(entry, \"Black Duck link\"),\n );\n}\n\nfunction collectionScope(collection: Record<string, unknown>) {\n const meta = record(collection[\"_meta\"], \"Black Duck collection _meta\");\n const resource = apiResource(meta[\"href\"], \"collection href\");\n const project =\n /^projects?\\/([^/]+)\\/versions\\/([^/]+)\\/vulnerable-bom-components$/u.exec(\n resource.path,\n );\n if (!project)\n throw new Error(\n \"Expected a Black Duck project-version vulnerable-bom-components collection.\",\n );\n if (\n resource.query.getAll(\"offset\").some((offset) => !/^0+$/u.test(offset)) ||\n links(meta).some((link) =>\n [\"next\", \"prev\", \"previous\"].includes(String(link[\"rel\"])),\n )\n )\n throw new Error(\n \"Incomplete Black Duck collection page. Supply a complete export or explicitly selected rows.\",\n );\n return `${resource.base}/projects/${project[1]}/versions/${project[2]}`;\n}\n\nfunction projectReference(\n href: unknown,\n relation: \"remediation\" | \"matched-files\",\n) {\n const label =\n relation === \"remediation\" ? \"remediation URL\" : \"matched-files link\";\n const resource = apiResource(href, label);\n const match =\n /^(projects\\/[^/]+\\/versions\\/[^/]+)\\/(components\\/[^/]+\\/versions\\/[^/]+)(?:\\/origins\\/([^/]+))?\\/(matched-files|vulnerabilities\\/[^/]+\\/remediation)$/u.exec(\n resource.path,\n );\n if (!match || !match[4]!.endsWith(relation))\n throw new Error(`Invalid Black Duck project-version ${label}.`);\n return {\n scope: `${resource.base}/${match[1]}`,\n component: `${resource.base}/${match[2]}`,\n origin: match[3],\n };\n}\n\nfunction scopedRow(\n value: unknown,\n scope: string | undefined,\n selected: boolean,\n) {\n const row = isRecord(value) ? value : {};\n const meta = row[\"_meta\"];\n const declared = isRecord(meta) ? meta[\"links\"] : undefined;\n const matched = (Array.isArray(declared) ? declared : [])\n .filter(\n (link): link is Record<string, unknown> =>\n isRecord(link) && link[\"rel\"] === \"matched-files\",\n )\n .map((link) => projectReference(link[\"href\"], \"matched-files\"));\n if (isRecord(meta) && meta[\"href\"] !== undefined)\n matched.push(projectReference(meta[\"href\"], \"remediation\"));\n if (selected && !matched.length)\n throw new Error(\n \"Each selected Black Duck row must identify its project version with a remediation or matched-files link.\",\n );\n for (const reference of matched) {\n if (scope !== undefined && scope !== reference.scope)\n throw new Error(\n \"Black Duck rows must belong to the same project version and server as the collection or selection.\",\n );\n scope = reference.scope;\n }\n const vulnerability = row[\"vulnerabilityWithRemediation\"];\n return {\n row,\n matched,\n scope,\n // Shape errors are row exclusions; project-scope errors abort the report.\n get vulnerability() {\n record(value, \"Black Duck BOM component\");\n return record(vulnerability, \"Black Duck vulnerabilityWithRemediation\");\n },\n };\n}\n\nfunction occurrenceId(\n { row, vulnerability, matched }: ReturnType<typeof scopedRow>,\n projectVersion: string,\n) {\n const resource = apiResource(row[\"componentVersion\"], \"componentVersion\");\n const component = `${resource.base}/${resource.path}`;\n if (\n !componentVersionPath.test(resource.path) ||\n resource.base !==\n projectVersion.slice(0, projectVersion.lastIndexOf(\"/projects/\"))\n )\n throw new Error(\n \"Black Duck componentVersion must identify a component version on the same server.\",\n );\n const origins = new Set<string>();\n for (const reference of matched) {\n if (reference.component !== component)\n throw new Error(\n \"Black Duck project-version link contradicts componentVersion.\",\n );\n if (reference.origin) origins.add(reference.origin);\n }\n for (const link of links(row[\"_meta\"]).filter(\n (entry) => entry[\"rel\"] === \"vulnerabilities\",\n )) {\n const reference = apiResource(link[\"href\"], \"vulnerabilities link\");\n const match =\n /^(components\\/[^/]+\\/versions\\/[^/]+)(?:\\/origin\\/([^/]+))?\\/vulnerabilities$/u.exec(\n reference.path,\n );\n if (!match) continue;\n if (`${reference.base}/${match[1]}` !== component)\n throw new Error(\n \"Black Duck vulnerabilities link contradicts componentVersion.\",\n );\n if (match[2]) origins.add(match[2]);\n }\n const [origin] = origins;\n if (!origin || origins.size !== 1)\n throw new Error(\n \"Black Duck row must identify one unambiguous component-version origin.\",\n );\n const source = requiredText(\n vulnerability[\"source\"],\n \"Black Duck advisory source\",\n );\n if (source !== \"BDSA\" && source !== \"NVD\")\n throw new Error(`Unsupported Black Duck advisory source: ${source}.`);\n return stableId(\"blackduck-bom\", [\n projectVersion,\n component,\n origin,\n source,\n requiredText(\n vulnerability[\"vulnerabilityName\"],\n \"Black Duck vulnerability name\",\n ),\n ]);\n}\n\nconst nameVersionForges = new Map([\n [\"npmjs\", \"npm\"],\n [\"pypi\", \"pypi\"],\n [\"nuget\", \"nuget\"],\n [\"rubygems\", \"gem\"],\n [\"crates\", \"cargo\"],\n]);\n\nfunction packageUrlName(ecosystem: string, parts: string[]) {\n if (parts.some((part) => !part || part.includes(\"/\"))) return;\n if (ecosystem === \"github\" && parts.length === 2)\n return parts.join(\"/\").toLowerCase();\n if (ecosystem === \"maven\" || ecosystem === \"composer\")\n return parts.length === 2\n ? parts.join(ecosystem === \"maven\" ? \":\" : \"/\")\n : undefined;\n if (\n parts.length === 1 ||\n ecosystem === \"golang\" ||\n ecosystem === \"generic\" ||\n (parts.length === 2 && ecosystem === \"npm\" && parts[0]!.startsWith(\"@\"))\n )\n return parts.join(\"/\");\n}\n\nfunction originPackage(row: Record<string, unknown>) {\n const origin = text(row[\"componentVersionOriginName\"])?.toLowerCase();\n const id = text(row[\"componentVersionOriginId\"]) ?? \"\";\n if (origin === \"maven\") {\n const coordinate = /^([^:\\s/]+:[^:\\s/]+):([^:\\s/]+)$/u.exec(id);\n if (coordinate)\n return {\n name: coordinate[1]!,\n ecosystem: origin,\n installed_version: coordinate[2]!,\n };\n }\n const ecosystem = nameVersionForges.get(origin ?? \"\");\n if (ecosystem) {\n const coordinate = /^(?:(@[^/\\s]+)\\/)?([^/\\s]+)\\/([^/\\s]+)$/u.exec(id);\n if (coordinate && (!coordinate[1] || ecosystem === \"npm\"))\n return {\n name: id.slice(0, id.lastIndexOf(\"/\")),\n ecosystem,\n installed_version: coordinate[3]!,\n };\n }\n}\n\nfunction blackDuckPackages(row: Record<string, unknown>) {\n const origin = originPackage(row);\n const fallback = origin ? [origin] : [];\n const purl =\n /^pkg:([a-z][a-z0-9.+-]*)\\/((?:@[^/@?#]+\\/)?[^@?#]+)(?:@([^@?#]+))?(?:[?#].*)?$/iu.exec(\n text(row[\"packageUrl\"]) ?? \"\",\n );\n if (purl) {\n try {\n const ecosystem = purl[1]!.toLowerCase();\n const name = packageUrlName(\n ecosystem,\n purl[2]!.split(\"/\").map(decodeURIComponent),\n );\n if (name) {\n if (!purl[3] && origin?.ecosystem === ecosystem && origin.name === name)\n return { packages: fallback };\n const pkg = {\n name,\n ecosystem,\n installed_version: purl[3]\n ? decodeURIComponent(purl[3])\n : text(row[\"componentVersionName\"]),\n };\n // Earlier versions used the origin fallback for owner/repository PURLs.\n return ecosystem === \"github\" && name.includes(\"/\")\n ? { packages: fallback, enrichment: { packages: [pkg] } }\n : { packages: [pkg] };\n }\n } catch {\n // A malformed escape does not invalidate the native origin coordinate.\n }\n }\n\n return { packages: fallback };\n}\n\nfunction normalizeReport(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget,\n previous: boolean,\n): ExternalFindings {\n const repository = declaredScannerRepositoryUrl(\n sourceRepositoryUrl,\n \"Black Duck\",\n target,\n );\n const selected = Array.isArray(input);\n let scope: string | undefined;\n let items: unknown[];\n if (selected) {\n items = input;\n } else {\n const collection = record(input, \"Black Duck collection\");\n items = array(collection[\"items\"], \"Black Duck items\");\n scope = collectionScope(collection);\n if (collection[\"totalCount\"] !== items.length)\n throw new Error(\n \"Incomplete Black Duck collection: totalCount must equal the number of items. Supply a complete export or explicitly selected rows.\",\n );\n }\n\n const rows = items.map((value) => {\n const entry = scopedRow(value, scope, selected);\n scope = entry.scope;\n return entry;\n });\n if (!scope)\n throw new Error(\n \"An empty Black Duck selection cannot identify a project version. Supply its complete collection envelope.\",\n );\n const projectVersion = scope;\n const result = normalizeRecords(\n rows,\n ({ row, vulnerability }) => {\n const advisory = requiredText(\n vulnerability[\"vulnerabilityName\"],\n \"Black Duck vulnerability name\",\n );\n const name = requiredText(\n row[\"componentName\"],\n \"Black Duck component name\",\n );\n const related = text(vulnerability[\"relatedVulnerability\"]);\n const { packages, enrichment } = blackDuckPackages(row);\n return validateEnrichedExternalEvidence(\n {\n title: `${advisory} in ${name}`,\n description: text(vulnerability[\"description\"]),\n severity: reportableScannerSeverity(vulnerability[\"severity\"]),\n advisory_ids:\n related && related !== advisory ? [advisory, related] : [advisory],\n packages,\n source_data: {\n format,\n sourceRepositoryUrl: repository,\n projectVersionUrl: projectVersion,\n row: structuredClone(row),\n },\n },\n target,\n previous ? undefined : enrichment,\n );\n },\n (entry) => occurrenceId(entry, projectVersion),\n target,\n );\n if (!selected) {\n // normalizeRecords excludes every collision. An unidentified row can also\n // repeat across pages, so compare its original JSON when it has no ID.\n const seen = new Set<string>();\n for (const excluded of result.excluded) {\n const key =\n excluded.source_finding_id ??\n canonicalJson(items[excluded.position - 1]);\n if (seen.has(key))\n throw new CodexSecurityError(\n \"Duplicate row in a collection with a declared total; pages may overlap. Retrieve the complete export again.\",\n );\n seen.add(key);\n }\n }\n return result;\n}\n\nexport function normalizeBlackDuckFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n return normalizeReport(input, sourceRepositoryUrl, target, false);\n}\n\n/** @internal Earlier readers used the native origin fallback for GitHub package URLs. */\nexport function needsPreviousBlackDuckProjection({\n findings,\n}: ExternalFindings) {\n return findings.some(({ evidence }) =>\n evidence.packages?.some(\n (pkg) => pkg.ecosystem === \"github\" && pkg.name.includes(\"/\"),\n ),\n );\n}\n\n/** @internal Reconstruct the original evidence for an interrupted Cloud request. */\nexport function normalizePreviousBlackDuckFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n return normalizeReport(input, sourceRepositoryUrl, target, true);\n}\n\nexport async function readBlackDuckFindings(\n path: string,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeBlackDuckFindings(\n await readScannerJson(path),\n sourceRepositoryUrl,\n target,\n );\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"bulk-scan-discovery.d.ts","sourceRoot":"","sources":["../src/bulk-scan-discovery.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AA8CxC,MAAM,WAAW,cAAc;IAC7B,aAAa,IAAI,OAAO,CAAC;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,OAAO,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,CAAC,KAAK,SAAS,MAAM,EACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EACnE,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAClC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC,CAAC;IAClB,QAAQ,CAAC,KAAK,SAAS,MAAM,EAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EACnE,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EACtD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,IAAI,MAAM,CAAC;IACd,gBAAgB,IAAI,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE;IAC3D,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,IAAI,MAAM,CAAC;IACd,gBAAgB,IAAI,MAAM,CAAC;CAC5B,GAAG,6BAA6B,CAehC;AAED,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,6BAA6B,EAC3C,MAAM,CAAC,EAAE,WAAW,EACpB,gBAAgB,SAAqB,GACpC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAmEtC;AAyID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAsEzE"}
1
+ {"version":3,"file":"bulk-scan-discovery.d.ts","sourceRoot":"","sources":["../src/bulk-scan-discovery.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AA8CxC,MAAM,WAAW,cAAc;IAC7B,aAAa,IAAI,OAAO,CAAC;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,OAAO,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,CAAC,KAAK,SAAS,MAAM,EACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EACnE,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAClC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC,CAAC;IAClB,QAAQ,CAAC,KAAK,SAAS,MAAM,EAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EACnE,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EACtD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,IAAI,MAAM,CAAC;IACd,gBAAgB,IAAI,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE;IAC3D,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,IAAI,MAAM,CAAC;IACd,gBAAgB,IAAI,MAAM,CAAC;CAC5B,GAAG,6BAA6B,CAehC;AAED,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,6BAA6B,EAC3C,MAAM,CAAC,EAAE,WAAW,EACpB,gBAAgB,SAAqB,GACpC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAmEtC;AA+ID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CA+EzE"}
@@ -3,7 +3,6 @@ import { lstat, mkdir, writeFile } from "node:fs/promises";
3
3
  import { join, resolve } from "node:path";
4
4
  import { stdin } from "node:process";
5
5
  import { Writable } from "node:stream";
6
- import { checkbox, confirm, input, search, Separator } from "@inquirer/prompts";
7
6
  import Papa from "papaparse";
8
7
  import { createAuthenticatedGitHub } from "./github.js";
9
8
  import { expandHome } from "./runtime.js";
@@ -58,12 +57,12 @@ export async function runBulkScanWizard(dependencies, signal, defaultOutputDir =
58
57
  prompt.write("\nNo repositories matched your selection.\n");
59
58
  return null;
60
59
  }
61
- prompt.write(`\nFound ${discovered.length} repositories.\n`);
60
+ prompt.write(`\nFound ${formatRepositoryCount(discovered.length)}.\n`);
62
61
  const repositories = await selectGitHubRepositories(discovered, prompt, signal);
63
62
  const outputDir = resolve(dependencies.currentDirectory(), expandHome(await prompt.input("Where should scan results be saved?", defaultOutputDir, signal)));
64
63
  const inputPath = join(outputDir, "repositories.csv");
65
64
  await validateWizardOutput(outputDir);
66
- prompt.write(`\nReady to scan ${repositories.length} repositories?\n` +
65
+ prompt.write(`\nReady to scan ${formatRepositoryCount(repositories.length)}?\n` +
67
66
  `Results: ${outputDir}\nRepository list: ${inputPath}\n`);
68
67
  if (!(await prompt.confirm("Start scanning?", false, signal))) {
69
68
  prompt.write("\nScan canceled.\n");
@@ -103,14 +102,18 @@ async function selectGitHubOwner(github, prompt, signal) {
103
102
  prompt.write(`\nFinding repositories in ${personal}.\n`);
104
103
  return personal;
105
104
  }
105
+ function formatRepositoryCount(count) {
106
+ return count === 1 ? "1 repository" : `${count} repositories`;
107
+ }
106
108
  async function selectGitHubRepositories(repositories, prompt, signal) {
109
+ const allLabel = repositories.length === 1
110
+ ? "All repositories"
111
+ : `All ${formatRepositoryCount(repositories.length)}`;
107
112
  const selected = new Set();
108
113
  while (selected.size < repositories.length) {
109
114
  const choice = await prompt.select("Select repositories to scan (type to filter)", [
110
115
  {
111
- label: selected.size
112
- ? `Done (${selected.size} selected)`
113
- : `All ${repositories.length} repositories`,
116
+ label: selected.size ? `Done (${selected.size} selected)` : allLabel,
114
117
  value: "",
115
118
  },
116
119
  ...repositories
@@ -202,41 +205,53 @@ export function createTerminalPrompt(output) {
202
205
  write: (value) => {
203
206
  output.write(value);
204
207
  },
205
- confirm: (message, defaultValue = false, signal) => confirm({ message, default: defaultValue }, context(signal)),
206
- input: (message, defaultValue, signal) => input({ message, default: defaultValue }, context(signal)),
207
- checkbox: (message, options, presentation, signal) => checkbox({
208
- message,
209
- choices: [
208
+ async confirm(message, defaultValue = false, signal) {
209
+ const { default: confirm } = await import("@inquirer/confirm");
210
+ return confirm({ message, default: defaultValue }, context(signal));
211
+ },
212
+ async input(message, defaultValue, signal) {
213
+ const { default: input } = await import("@inquirer/input");
214
+ return input({ message, default: defaultValue }, context(signal));
215
+ },
216
+ async checkbox(message, options, presentation, signal) {
217
+ const { default: checkbox, Separator } = await import("@inquirer/checkbox");
218
+ return checkbox({
219
+ message,
220
+ choices: [
221
+ ...(presentation?.header === undefined
222
+ ? []
223
+ : [new Separator(presentation.header)]),
224
+ ...options.map(({ label, value, short }) => ({
225
+ name: label,
226
+ value,
227
+ ...(short === undefined ? {} : { short }),
228
+ })),
229
+ ],
230
+ required: presentation?.required,
231
+ }, context(signal));
232
+ },
233
+ async select(message, options, presentation, signal) {
234
+ const { default: search } = await import("@inquirer/search");
235
+ return search({
236
+ message,
210
237
  ...(presentation?.header === undefined
211
- ? []
212
- : [new Separator(presentation.header)]),
213
- ...options.map(({ label, value, short }) => ({
238
+ ? {}
239
+ : {
240
+ theme: {
241
+ style: {
242
+ searchTerm: (term) => `${term}\n ${presentation.header}`,
243
+ },
244
+ },
245
+ }),
246
+ source: (term) => options
247
+ .filter(({ label }) => label.toLowerCase().includes(term?.toLowerCase() ?? ""))
248
+ .map(({ label, value, short }) => ({
214
249
  name: label,
215
250
  value,
216
251
  ...(short === undefined ? {} : { short }),
217
252
  })),
218
- ],
219
- required: presentation?.required,
220
- }, context(signal)),
221
- select: (message, options, presentation, signal) => search({
222
- message,
223
- ...(presentation?.header === undefined
224
- ? {}
225
- : {
226
- theme: {
227
- style: {
228
- searchTerm: (term) => `${term}\n ${presentation.header}`,
229
- },
230
- },
231
- }),
232
- source: (term) => options
233
- .filter(({ label }) => label.toLowerCase().includes(term?.toLowerCase() ?? ""))
234
- .map(({ label, value, short }) => ({
235
- name: label,
236
- value,
237
- ...(short === undefined ? {} : { short }),
238
- })),
239
- }, context(signal)),
253
+ }, context(signal));
254
+ },
240
255
  };
241
256
  }
242
257
  //# sourceMappingURL=bulk-scan-discovery.js.map