@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
@@ -1,9 +1,14 @@
1
1
  import { hash } from "node:crypto";
2
2
  import { readFile } from "node:fs/promises";
3
+ import { posix } from "node:path";
3
4
  import { promisify } from "node:util";
4
5
  import { gunzip } from "node:zlib";
6
+ import validSemver from "semver/functions/valid.js";
5
7
  import { CodexSecurityError, errorMessage } from "./errors.js";
6
- import { isRecord } from "./record.js";
8
+ import { REPORTABLE_SEVERITIES, SCAN_SEVERITIES } from "./scan-settings.js";
9
+ import { asRecord, isRecord } from "./record.js";
10
+ import { previousAdmission } from "./external-import-contract.js";
11
+ import { rememberPreviousSelection } from "./reader-selection.js";
7
12
  export function record(value, label) {
8
13
  if (!value || typeof value !== "object" || Array.isArray(value))
9
14
  throw new Error(`${label} must be an object.`);
@@ -14,15 +19,172 @@ export function array(value, label) {
14
19
  throw new Error(`${label} must be an array.`);
15
20
  return value;
16
21
  }
22
+ export function optionalArray(value, label) {
23
+ return value === undefined ? [] : array(value, label);
24
+ }
25
+ // SARIF uses the same index/GUID/ID references for components and descriptors.
26
+ function sarifReferences(entries, select, first = 0) {
27
+ const refs = new Map();
28
+ entries.forEach((entry, index) => {
29
+ if (!isRecord(entry))
30
+ return;
31
+ const item = select(entry);
32
+ refs.set(index + first, item);
33
+ if (typeof entry["guid"] === "string")
34
+ refs.set("guid:" + entry["guid"].toLowerCase(), item);
35
+ if (typeof entry["id"] === "string")
36
+ refs.set("id:" + entry["id"], item);
37
+ });
38
+ return (ref) => {
39
+ const { index, guid, id } = asRecord(ref) ?? {};
40
+ if (typeof index === "number" && index >= 0)
41
+ return refs.get(index);
42
+ if (typeof guid === "string")
43
+ return refs.get("guid:" + guid.toLowerCase());
44
+ return typeof id === "string" ? refs.get("id:" + id) : refs.get(-1);
45
+ };
46
+ }
47
+ function notificationDescriptors(value) {
48
+ const tool = asRecord(value);
49
+ // The driver is the default component (-1); extension indexes start at 0.
50
+ const component = sarifReferences([
51
+ tool?.["driver"],
52
+ ...optionalArray(tool?.["extensions"], "SARIF tool extensions"),
53
+ ], (owner) => sarifReferences(optionalArray(owner["notifications"], "SARIF notification descriptors"), (entry) => entry), -1);
54
+ return (ref) => component(asRecord(ref)?.["toolComponent"])?.(ref);
55
+ }
56
+ export function validateSarifRun(run, producer) {
57
+ if (hasSarifExternalPropertyReferences(run["externalPropertyFileReferences"]))
58
+ throw new Error(`Use a self-contained ${producer} SARIF report.`);
59
+ function validate(values, tool, strictExecution) {
60
+ let descriptors;
61
+ const resolve = (ref) => isRecord(ref)
62
+ ? (descriptors ??= notificationDescriptors(tool))(ref)
63
+ : undefined;
64
+ for (const value of values) {
65
+ const invocation = record(value, `${producer} invocation`);
66
+ const successful = invocation["executionSuccessful"];
67
+ if (typeof successful !== "boolean")
68
+ throw new Error(`${producer} SARIF executionSuccessful must be a boolean.`);
69
+ const list = (key) => optionalArray(invocation[key], `${producer} ${key}`);
70
+ const execution = list("toolExecutionNotifications");
71
+ const notices = execution.concat(list("toolConfigurationNotifications"));
72
+ if (!successful) {
73
+ const details = [
74
+ invocation["processStartFailureMessage"],
75
+ invocation["exitCodeDescription"],
76
+ invocation["exitCode"],
77
+ invocation["exitSignalName"],
78
+ ...notices,
79
+ ].filter((value) => value !== undefined);
80
+ throw new Error(`${producer} SARIF contains an unsuccessful invocation.${details.length ? " " + JSON.stringify(details) : ""}`);
81
+ }
82
+ if (strictExecution && execution.length)
83
+ throw new Error(`${producer} SARIF contains scan error notifications: ${JSON.stringify(execution)}`);
84
+ const levels = new Map();
85
+ for (const value of list("notificationConfigurationOverrides")) {
86
+ const override = asRecord(value);
87
+ const descriptor = resolve(override?.["descriptor"]);
88
+ const level = asRecord(override?.["configuration"])?.["level"];
89
+ if (descriptor && level !== undefined)
90
+ levels.set(descriptor, level);
91
+ }
92
+ for (const value of notices) {
93
+ const notice = record(value, `${producer} notification`);
94
+ const descriptor = resolve(notice["descriptor"]);
95
+ const level = notice["level"] ??
96
+ (descriptor && levels.get(descriptor)) ??
97
+ asRecord(descriptor?.["defaultConfiguration"])?.["level"];
98
+ if (level === "error")
99
+ throw new Error(`${producer} SARIF contains scan error notifications: ${JSON.stringify(notice)}`);
100
+ }
101
+ }
102
+ }
103
+ // Semgrep reports scanner errors as execution notices even below error level.
104
+ validate(optionalArray(run["invocations"], `${producer} invocations`), run["tool"], producer === "Semgrep");
105
+ if (run["conversion"] !== undefined) {
106
+ const conversion = record(run["conversion"], `${producer} conversion`);
107
+ if (conversion["invocation"] !== undefined)
108
+ validate([conversion["invocation"]], conversion["tool"], false);
109
+ }
110
+ }
17
111
  export function text(value) {
18
112
  return typeof value === "string" && value.trim() ? value : null;
19
113
  }
114
+ /** AWS APIs use epoch seconds and AWS CLI exports use timezone-qualified ISO dates. */
115
+ export function awsTimestampSeconds(value) {
116
+ if (typeof value === "number")
117
+ return value;
118
+ if (typeof value === "string" &&
119
+ /^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d+)?(?:Z|[+-]\d\d:\d\d)$/u.test(value))
120
+ return Date.parse(value) / 1000;
121
+ return NaN;
122
+ }
123
+ export function concreteVersion(value, ecosystem, osPackage) {
124
+ const version = text(value);
125
+ if (!version)
126
+ return null;
127
+ // Debian versions use internal tildes for prereleases and backports.
128
+ if (osPackage && version.includes("~"))
129
+ return /^(?:\d+:)?\d[a-z\d.+~]*(?:-[a-z\d.+~]+)*$/iu.test(version)
130
+ ? version
131
+ : null;
132
+ if (validSemver(version))
133
+ return version;
134
+ if (ecosystem === "npm" || ecosystem === "cargo")
135
+ return null;
136
+ if (ecosystem === "java" || ecosystem === "maven") {
137
+ if (version === "LATEST" ||
138
+ version === "RELEASE" ||
139
+ version.startsWith("latest."))
140
+ return null;
141
+ return /^[a-z\d][\w.+-]*$/iu.test(version) && !version.endsWith("+")
142
+ ? version
143
+ : null;
144
+ }
145
+ if (!ecosystem && version.endsWith("+"))
146
+ return null;
147
+ const publicVersion = ecosystem === "pypi" ? version.split("+", 1)[0] : version;
148
+ return /\d/u.test(version) &&
149
+ /^(?:\d+:)?[a-z\d][\w.+!-]*$/iu.test(version) &&
150
+ !/(?:^|\.)x(?:\.|$)/iu.test(publicVersion)
151
+ ? version
152
+ : null;
153
+ }
20
154
  export function requiredText(value, label) {
21
155
  const result = text(value);
22
156
  if (!result)
23
157
  throw new Error(`${label} must be nonempty text.`);
24
158
  return result;
25
159
  }
160
+ /** SARIF repository claims must be checked even when a run has no results. */
161
+ export function sarifRunRepositories(run, producer) {
162
+ if (run == null)
163
+ return [];
164
+ return array(record(run, `${producer} run context`)["versionControlProvenance"] ?? [], `${producer} version control provenance`).flatMap((entry) => {
165
+ const ref = record(entry, `${producer} repository provenance`);
166
+ const url = producer === "Semgrep"
167
+ ? text(ref["repositoryUri"])
168
+ : requiredText(ref["repositoryUri"], `${producer} repository URI`);
169
+ if (url === null)
170
+ return [];
171
+ const branch = ref["branch"];
172
+ return [
173
+ {
174
+ url,
175
+ ...(producer === "Semgrep" && typeof branch === "string" && { branch }),
176
+ },
177
+ ];
178
+ });
179
+ }
180
+ /** Normalize scanners whose reported severities range from low to critical. */
181
+ export function reportableScannerSeverity(value) {
182
+ const level = text(value)?.toLowerCase();
183
+ return (REPORTABLE_SEVERITIES.find((severity) => severity === level) ?? "unknown");
184
+ }
185
+ export function scannerSeverity(value) {
186
+ return SCAN_SEVERITIES.find((severity) => severity === value) ?? "unknown";
187
+ }
26
188
  export function strings(value) {
27
189
  return Array.isArray(value)
28
190
  ? value.filter((v) => text(v) !== null)
@@ -39,17 +201,49 @@ export function relativePath(value) {
39
201
  ? path
40
202
  : null;
41
203
  }
204
+ // Hosted findings do not identify the scanner operating system or its path separator.
205
+ export function hostedRepositoryPath(value) {
206
+ const path = text(value);
207
+ return path && !path.includes("\\") && !path.includes("://")
208
+ ? relativePath(path)
209
+ : null;
210
+ }
211
+ export function repositoryFilePath(value) {
212
+ const relative = relativePath(value);
213
+ if (!relative)
214
+ return null;
215
+ const path = posix.normalize(relative);
216
+ // Anchor the SCP branch at the first eligible @ to avoid rescanning long filenames.
217
+ return path === "." ||
218
+ path.endsWith("/") ||
219
+ /^(?:[a-z][a-z\d+.-]*:|~[^/]*(?:\/|$)|[^/][^/@]*@[^/]+:)/iu.test(path)
220
+ ? null
221
+ : path;
222
+ }
42
223
  export function stableId(prefix, fields) {
43
224
  return `${prefix}:${hash("sha256", JSON.stringify(fields))}`;
44
225
  }
45
226
  const strictUtf8 = new TextDecoder("utf-8", { fatal: true });
46
227
  const gunzipAsync = promisify(gunzip);
47
- async function readScannerBytes(path) {
228
+ async function readScannerInput(path) {
48
229
  const bytes = await readFile(path);
49
- return bytes[0] === 0x1f && bytes[1] === 0x8b ? gunzipAsync(bytes) : bytes;
230
+ const gzip = bytes[0] === 0x1f && bytes[1] === 0x8b;
231
+ return { gzip, bytes: gzip ? await gunzipAsync(bytes) : bytes };
232
+ }
233
+ export async function readScannerBytes(path) {
234
+ return (await readScannerInput(path)).bytes;
50
235
  }
51
236
  export async function readScannerText(path) {
52
- return strictUtf8.decode(await readScannerBytes(path));
237
+ const { bytes, gzip } = await readScannerInput(path);
238
+ const contents = strictUtf8.decode(bytes);
239
+ // Empty JSONL is a valid stream of zero records; a blank JSON or CSV document isn't.
240
+ if (!contents.trim()) {
241
+ if (!gzip && /\.gz$/iu.test(path))
242
+ throw new Error("The report is blank and contains no gzip stream.");
243
+ if (/\.(?:json|csv)(?:\.gz)?$/iu.test(path))
244
+ throw new Error("The report is blank.");
245
+ }
246
+ return contents;
53
247
  }
54
248
  export function parseJsonOrJsonl(contents) {
55
249
  try {
@@ -62,7 +256,7 @@ export function parseJsonOrJsonl(contents) {
62
256
  .map((line) => JSON.parse(line));
63
257
  }
64
258
  }
65
- export async function readScannerJson(path) {
259
+ export async function readScannerJson(path, parse = JSON.parse) {
66
260
  const bytes = await readScannerBytes(path);
67
261
  let decoded;
68
262
  try {
@@ -72,7 +266,7 @@ export async function readScannerJson(path) {
72
266
  throw new CodexSecurityError(`Scanner report is not valid UTF-8. ${errorMessage(error)}`, { cause: error });
73
267
  }
74
268
  try {
75
- return JSON.parse(decoded.replace(/^\uFEFF/u, ""));
269
+ return parse(decoded.replace(/^\uFEFF/u, ""));
76
270
  }
77
271
  catch (error) {
78
272
  throw new CodexSecurityError(`Scanner JSON could not be parsed. ${errorMessage(error)}`, { cause: error });
@@ -97,11 +291,7 @@ const sarifArtifactLocationFields = new Set([
97
291
  "mappedTo",
98
292
  "displayBase",
99
293
  ]);
100
- /** Keep original artifact indexes; omit only inventory unrelated to this finding. */
101
- export function sarifRunContextForResult(runContext, ...selectedEvidence) {
102
- const { artifacts, ...context } = runContext;
103
- if (!Array.isArray(artifacts) || artifacts.length === 0)
104
- return runContext;
294
+ function sarifArtifactReferences(evidence) {
105
295
  const locations = [];
106
296
  let hasArtifactLink = false;
107
297
  function visit(value) {
@@ -126,46 +316,226 @@ export function sarifRunContextForResult(runContext, ...selectedEvidence) {
126
316
  visit(child);
127
317
  }
128
318
  }
129
- visit([context, ...selectedEvidence]);
130
- if (hasArtifactLink)
131
- return runContext;
132
- const unresolvedUri = /[%:\\]|(?:^|\/)\.\.?(?:\/|$)/u;
133
- for (const location of locations) {
134
- if (typeof location["index"] === "number" && location["index"] >= 0)
135
- return runContext;
136
- if (typeof location["uri"] !== "string")
319
+ visit(evidence);
320
+ return { locations, hasArtifactLink };
321
+ }
322
+ const unresolvedUri = /[%:\\]|(?:^|\/)\.\.?(?:\/|$)/u;
323
+ function artifactUriMatcher(artifacts) {
324
+ const uris = new Set();
325
+ let hasLocation = false;
326
+ let base;
327
+ for (const artifact of artifacts) {
328
+ if (!isRecord(artifact) || !isRecord(artifact["location"]))
137
329
  continue;
138
- for (const artifact of artifacts) {
139
- if (!isRecord(artifact) || !isRecord(artifact["location"]))
140
- continue;
141
- const candidate = artifact["location"];
142
- // Keep URI spellings that need resolution; evidence is never rewritten.
143
- if (location["uriBaseId"] !== candidate["uriBaseId"] ||
144
- unresolvedUri.test(location["uri"]) ||
145
- (typeof candidate["uri"] === "string" &&
146
- unresolvedUri.test(candidate["uri"])) ||
147
- location["uri"] === candidate["uri"])
330
+ const { uri, uriBaseId } = artifact["location"];
331
+ // Mixed bases or a URI that needs resolution can match any direct reference.
332
+ if ((hasLocation && uriBaseId !== base) ||
333
+ (typeof uri === "string" && unresolvedUri.test(uri)))
334
+ return () => true;
335
+ hasLocation = true;
336
+ base = uriBaseId;
337
+ if (typeof uri === "string")
338
+ uris.add(uri);
339
+ }
340
+ return (uri, uriBaseId) => hasLocation &&
341
+ (uriBaseId !== base || unresolvedUri.test(uri) || uris.has(uri));
342
+ }
343
+ /** Keep original artifact indexes; omit only inventory unrelated to this finding. */
344
+ export function sarifRunContextSelector(runContext) {
345
+ const { artifacts, ...context } = runContext;
346
+ if (!Array.isArray(artifacts) || artifacts.length === 0)
347
+ return () => runContext;
348
+ let matchesUri;
349
+ return (...selectedEvidence) => {
350
+ const { locations, hasArtifactLink } = sarifArtifactReferences([
351
+ context,
352
+ ...selectedEvidence,
353
+ ]);
354
+ if (hasArtifactLink)
355
+ return runContext;
356
+ for (const location of locations) {
357
+ const { index, uri, uriBaseId } = location;
358
+ if (typeof index === "number" && index >= 0)
148
359
  return runContext;
360
+ if (typeof uri === "string") {
361
+ matchesUri ??= artifactUriMatcher(artifacts);
362
+ if (matchesUri(uri, uriBaseId))
363
+ return runContext;
364
+ }
149
365
  }
150
- }
151
- return context;
366
+ return context;
367
+ };
152
368
  }
153
369
  /** Duplicate IDs cannot identify a single rule in this run. */
154
- export function indexSarifRules(rules) {
370
+ export function indexSarifRules(entries) {
155
371
  const byId = new Map();
156
- for (const [index, rule] of rules.entries()) {
372
+ for (const [index, rule] of entries) {
157
373
  const id = rule["id"];
158
374
  byId.set(id, byId.has(id) ? null : { rule, index });
159
375
  }
160
376
  return byId;
161
377
  }
378
+ /** Unpack the common SARIF envelope; each reader qualifies its own producer. */
379
+ export function readSarifRuns(input, producer, read) {
380
+ const document = record(input, `${producer} SARIF`);
381
+ if (document["version"] !== "2.1.0")
382
+ throw new Error(`Expected ${producer} SARIF 2.1.0.`);
383
+ return array(document["runs"], "SARIF runs").flatMap((value) => {
384
+ const run = record(value, "SARIF run");
385
+ const tool = record(run["tool"], "SARIF tool");
386
+ const driver = record(tool["driver"], "SARIF driver");
387
+ return read({ document, run, tool, driver });
388
+ });
389
+ }
390
+ /** Pair each result with its shared run context and original evidence. */
391
+ export function sarifRunResults({ document, run, tool, driver }, producer) {
392
+ validateSarifRun(run, producer);
393
+ const rules = array(driver["rules"] ?? [], `${producer} rules`).map((rule) => record(rule, `${producer} rule`));
394
+ const rulesById = indexSarifRules(rules.entries());
395
+ const { runs: _runs, ...documentContext } = document;
396
+ const { results: _results, tool: _tool, ...runContext } = run;
397
+ const { rules: _rules, ...driverContext } = driver;
398
+ const { driver: _driver, ...toolContext } = tool;
399
+ const selectRunContext = sarifRunContextSelector(runContext);
400
+ // JS callers may supply lazy metadata. Preserve each adapter's original traversal order.
401
+ const metadataInReadOrder = producer === "Semgrep"
402
+ ? [driverContext, toolContext, documentContext]
403
+ : [documentContext, driverContext, toolContext];
404
+ const context = {
405
+ rulesById,
406
+ runContext,
407
+ sourceData(result, rule) {
408
+ return structuredClone({
409
+ documentContext,
410
+ runContext: selectRunContext(result, rule, ...metadataInReadOrder),
411
+ driverContext,
412
+ toolContext,
413
+ ...(rule ? { rule } : {}),
414
+ result,
415
+ });
416
+ },
417
+ };
418
+ return optionalArray(run["results"], `${producer} results`).map((result) => ({
419
+ result,
420
+ context,
421
+ }));
422
+ }
423
+ /** The top-level index and nested descriptor must agree with the selected driver rule. */
424
+ export function validateSarifRuleReference(result, ruleId, selected, producer) {
425
+ // Snyk's original diagnostics use unqualified SARIF field names.
426
+ const label = producer === "Snyk" ? "Result" : producer;
427
+ if (result["ruleIndex"] !== undefined &&
428
+ result["ruleIndex"] !== selected?.index)
429
+ throw new Error(`${label} ruleIndex and ruleId disagree.`);
430
+ if (result["rule"] === undefined)
431
+ return;
432
+ const reference = record(result["rule"], producer === "Snyk" ? "Rule reference" : `${producer} rule reference`);
433
+ if (reference["toolComponent"] !== undefined ||
434
+ (reference["id"] !== undefined && reference["id"] !== ruleId) ||
435
+ (reference["index"] !== undefined &&
436
+ reference["index"] !== selected?.index) ||
437
+ (reference["guid"] !== undefined &&
438
+ reference["guid"] !== selected?.rule["guid"]))
439
+ throw new Error(producer === "Snyk"
440
+ ? "Result uses an inconsistent or external rule reference."
441
+ : `Inconsistent or external ${producer} rule reference.`);
442
+ }
443
+ /** Track older size decisions while a single reader constructs its result. */
444
+ export function trackReaderSelection(result) {
445
+ const changes = [];
446
+ const uncertainIds = new Set();
447
+ function append(position, id, project) {
448
+ const index = result.findings.length;
449
+ let outcome;
450
+ try {
451
+ const evidence = project();
452
+ outcome = evidence;
453
+ result.findings.push({ source_finding_id: id, evidence });
454
+ }
455
+ catch (error) {
456
+ outcome = error;
457
+ result.excluded.push({
458
+ position,
459
+ source_finding_id: id,
460
+ reason: errorMessage(error),
461
+ });
462
+ }
463
+ const previous = outcome && typeof outcome === "object"
464
+ ? previousAdmission(outcome)
465
+ : undefined;
466
+ if (previous === "uncertain")
467
+ uncertainIds.add(id);
468
+ else if (previous !== undefined)
469
+ changes.push({ index, position, id, previous });
470
+ }
471
+ function finish(filter) {
472
+ if (!changes.length && !uncertainIds.size) {
473
+ filter?.(result);
474
+ return result;
475
+ }
476
+ const findings = [];
477
+ const excluded = [];
478
+ const restoredPositions = new Set();
479
+ let cursor = 0;
480
+ for (const { index, position, id, previous } of changes) {
481
+ while (cursor < index)
482
+ findings.push(result.findings[cursor++]);
483
+ if (previous) {
484
+ findings.push({ source_finding_id: id, evidence: previous });
485
+ restoredPositions.add(position);
486
+ }
487
+ else {
488
+ cursor++;
489
+ excluded.push({
490
+ position,
491
+ source_finding_id: id,
492
+ reason: "Evidence exceeds the Cloud limit of 256 KiB.",
493
+ });
494
+ }
495
+ }
496
+ while (cursor < result.findings.length)
497
+ findings.push(result.findings[cursor++]);
498
+ for (const row of result.excluded) {
499
+ if (!restoredPositions.has(row.position))
500
+ excluded.push(row);
501
+ }
502
+ excluded.sort((a, b) => a.position - b.position);
503
+ const previous = { ...result, findings, excluded };
504
+ // A removed sibling could have depended on an unproven row for its scope.
505
+ filter?.(previous, uncertainIds.size ? uncertainIds : undefined);
506
+ filter?.(result);
507
+ const sourceFindingIds = [
508
+ ...new Set([
509
+ ...previous.findings.map((row) => row.source_finding_id),
510
+ ...uncertainIds,
511
+ ]),
512
+ ];
513
+ if (uncertainIds.size) {
514
+ rememberPreviousSelection(result, {
515
+ sourceFindingIds,
516
+ uncertainFindingIds: [...uncertainIds],
517
+ knownFindings: structuredClone(previous.findings.filter((row) => !uncertainIds.has(row.source_finding_id))),
518
+ });
519
+ }
520
+ else {
521
+ rememberPreviousSelection(result, {
522
+ sourceFindingIds,
523
+ snapshot: structuredClone(previous),
524
+ });
525
+ }
526
+ return result;
527
+ }
528
+ return { append, finish, uncertainIds };
529
+ }
162
530
  /** Exclude every colliding record: choosing the first could overwrite another occurrence. */
163
- export function normalizeRecords(records, projectEvidence, identify, target = "cloud") {
531
+ export function normalizeRecords(records, projectEvidence, identify, target = "cloud", options = {}) {
164
532
  const result = {
165
533
  read: records.length,
166
534
  findings: [],
167
535
  excluded: [],
536
+ ...(options.report === undefined ? {} : { report: options.report }),
168
537
  };
538
+ const selection = trackReaderSelection(result);
169
539
  const identified = [];
170
540
  const counts = new Map();
171
541
  for (const [index, value] of records.entries()) {
@@ -197,21 +567,9 @@ export function normalizeRecords(records, projectEvidence, identify, target = "c
197
567
  });
198
568
  continue;
199
569
  }
200
- try {
201
- result.findings.push({
202
- source_finding_id: id,
203
- evidence: projectEvidence(value, id),
204
- });
205
- }
206
- catch (error) {
207
- result.excluded.push({
208
- position,
209
- source_finding_id: id,
210
- reason: errorMessage(error),
211
- });
212
- }
570
+ selection.append(position, id, () => projectEvidence(value, id));
213
571
  }
214
572
  result.excluded.sort((a, b) => a.position - b.position);
215
- return result;
573
+ return selection.finish(options.filter);
216
574
  }
217
575
  //# sourceMappingURL=scanner-import.js.map