@openai/codex-security 0.8.3 → 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 (534) hide show
  1. package/README.md +192 -151
  2. package/_bundled_plugin/.mcp.json +5 -1
  3. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  4. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  5. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  6. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  7. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  8. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  9. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  10. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/package.json +1 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  20. package/_bundled_plugin/mcp/server.mjs +2 -11
  21. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  22. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  23. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  24. package/_bundled_plugin/references/final-report.md +5 -3
  25. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  26. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  27. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  28. package/_bundled_plugin/references/scan-contract.md +27 -33
  29. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  30. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  31. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  32. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  33. package/_bundled_plugin/scripts/deep_scan_workbench.py +165 -342
  34. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  35. package/_bundled_plugin/scripts/finalize_scan_contract.py +153 -227
  36. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  37. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  38. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  39. package/_bundled_plugin/scripts/posix_scan_local_files.py +11 -0
  40. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  41. package/_bundled_plugin/scripts/report_projection.py +81 -43
  42. package/_bundled_plugin/scripts/review_state.py +8 -2
  43. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  44. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  45. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  46. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  47. package/_bundled_plugin/scripts/windows_scan_local_files.py +388 -17
  48. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  49. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  50. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  51. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  52. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  53. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  54. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  55. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  56. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  57. package/_bundled_plugin/scripts/workbench_cli.py +30 -12
  58. package/_bundled_plugin/scripts/workbench_constants.py +10 -0
  59. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  60. package/_bundled_plugin/scripts/workbench_db.py +369 -137
  61. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  62. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  63. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  64. package/_bundled_plugin/scripts/workbench_native_indexes.py +12 -12
  65. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  66. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  67. package/_bundled_plugin/scripts/workbench_remediation.py +13 -0
  68. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  69. package/_bundled_plugin/scripts/workbench_scan_history.py +117 -55
  70. package/_bundled_plugin/scripts/workbench_scan_start.py +83 -24
  71. package/_bundled_plugin/scripts/workbench_scan_usage.py +644 -68
  72. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  73. package/_bundled_plugin/scripts/workbench_setup.py +13 -1
  74. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  75. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  76. package/_bundled_plugin/scripts/workbench_target.py +127 -56
  77. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  78. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  79. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -23
  80. package/_bundled_plugin/shared/workbench-migrations.json +34 -0
  81. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  82. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  83. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -1
  84. package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -25
  85. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  86. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  87. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  88. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  89. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  90. package/dist/api.d.ts +39 -4
  91. package/dist/api.d.ts.map +1 -1
  92. package/dist/api.js +774 -292
  93. package/dist/api.js.map +1 -1
  94. package/dist/auth.d.ts.map +1 -1
  95. package/dist/auth.js +4 -6
  96. package/dist/auth.js.map +1 -1
  97. package/dist/bedrock-oss-pricing.d.ts +6 -0
  98. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  99. package/dist/bedrock-oss-pricing.js +58 -0
  100. package/dist/bedrock-oss-pricing.js.map +1 -0
  101. package/dist/bedrock-pricing.d.ts +15 -0
  102. package/dist/bedrock-pricing.d.ts.map +1 -0
  103. package/dist/bedrock-pricing.js +117 -0
  104. package/dist/bedrock-pricing.js.map +1 -0
  105. package/dist/blackduck-findings.d.ts.map +1 -1
  106. package/dist/blackduck-findings.js +35 -20
  107. package/dist/blackduck-findings.js.map +1 -1
  108. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  109. package/dist/bulk-scan-discovery.js +4 -4
  110. package/dist/bulk-scan-discovery.js.map +1 -1
  111. package/dist/checkmarx-evidence.d.ts +19 -0
  112. package/dist/checkmarx-evidence.d.ts.map +1 -0
  113. package/dist/checkmarx-evidence.js +36 -0
  114. package/dist/checkmarx-evidence.js.map +1 -0
  115. package/dist/checkmarx-findings.d.ts +4 -0
  116. package/dist/checkmarx-findings.d.ts.map +1 -0
  117. package/dist/checkmarx-findings.js +27 -0
  118. package/dist/checkmarx-findings.js.map +1 -0
  119. package/dist/checkmarx-one.d.ts +4 -0
  120. package/dist/checkmarx-one.d.ts.map +1 -0
  121. package/dist/checkmarx-one.js +53 -0
  122. package/dist/checkmarx-one.js.map +1 -0
  123. package/dist/checkmarx-repository.d.ts +12 -0
  124. package/dist/checkmarx-repository.d.ts.map +1 -0
  125. package/dist/checkmarx-repository.js +181 -0
  126. package/dist/checkmarx-repository.js.map +1 -0
  127. package/dist/checkmarx-xml.d.ts +12 -0
  128. package/dist/checkmarx-xml.d.ts.map +1 -0
  129. package/dist/checkmarx-xml.js +196 -0
  130. package/dist/checkmarx-xml.js.map +1 -0
  131. package/dist/classify-severity-records.d.ts +1 -9
  132. package/dist/classify-severity-records.d.ts.map +1 -1
  133. package/dist/classify-severity-records.js +3 -13
  134. package/dist/classify-severity-records.js.map +1 -1
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +2 -4
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli.d.ts +11 -5
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1734 -1238
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.js +2 -2
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/component-scan.d.ts +16 -3
  145. package/dist/component-scan.d.ts.map +1 -1
  146. package/dist/component-scan.js +27 -2
  147. package/dist/component-scan.js.map +1 -1
  148. package/dist/config.d.ts.map +1 -1
  149. package/dist/config.js +100 -66
  150. package/dist/config.js.map +1 -1
  151. package/dist/continuum-findings.d.ts.map +1 -1
  152. package/dist/continuum-findings.js +80 -12
  153. package/dist/continuum-findings.js.map +1 -1
  154. package/dist/contract-values.d.ts +2 -0
  155. package/dist/contract-values.d.ts.map +1 -1
  156. package/dist/contract-values.js +12 -9
  157. package/dist/contract-values.js.map +1 -1
  158. package/dist/cost-model.d.ts +13 -1
  159. package/dist/cost-model.d.ts.map +1 -1
  160. package/dist/cost-model.js +66 -112
  161. package/dist/cost-model.js.map +1 -1
  162. package/dist/cost.d.ts +42 -3
  163. package/dist/cost.d.ts.map +1 -1
  164. package/dist/cost.js +483 -104
  165. package/dist/cost.js.map +1 -1
  166. package/dist/custom-publish.d.ts +4 -0
  167. package/dist/custom-publish.d.ts.map +1 -1
  168. package/dist/custom-publish.js +40 -3
  169. package/dist/custom-publish.js.map +1 -1
  170. package/dist/deduplication/local.d.ts +2 -2
  171. package/dist/deduplication/local.d.ts.map +1 -1
  172. package/dist/deduplication/local.js +2 -2
  173. package/dist/deduplication/local.js.map +1 -1
  174. package/dist/deduplication/refusal.d.ts.map +1 -1
  175. package/dist/deduplication/refusal.js +25 -5
  176. package/dist/deduplication/refusal.js.map +1 -1
  177. package/dist/deduplication/scan.d.ts +3 -0
  178. package/dist/deduplication/scan.d.ts.map +1 -1
  179. package/dist/deduplication/scan.js +1 -1
  180. package/dist/deduplication/scan.js.map +1 -1
  181. package/dist/deep-config.d.ts +0 -1
  182. package/dist/deep-config.d.ts.map +1 -1
  183. package/dist/deep-config.js +22 -33
  184. package/dist/deep-config.js.map +1 -1
  185. package/dist/deep-scan-defaults.d.ts +2 -0
  186. package/dist/deep-scan-defaults.d.ts.map +1 -1
  187. package/dist/deep-scan-defaults.js +28 -1
  188. package/dist/deep-scan-defaults.js.map +1 -1
  189. package/dist/deep-scan.d.ts +2 -0
  190. package/dist/deep-scan.d.ts.map +1 -1
  191. package/dist/deep-scan.js +28 -4
  192. package/dist/deep-scan.js.map +1 -1
  193. package/dist/default-severity-rubric.d.ts +1 -1
  194. package/dist/default-severity-rubric.d.ts.map +1 -1
  195. package/dist/default-severity-rubric.js +1 -1
  196. package/dist/default-severity-rubric.js.map +1 -1
  197. package/dist/endor-findings.d.ts +3 -1
  198. package/dist/endor-findings.d.ts.map +1 -1
  199. package/dist/endor-findings.js +103 -45
  200. package/dist/endor-findings.js.map +1 -1
  201. package/dist/errors.d.ts +1 -1
  202. package/dist/errors.d.ts.map +1 -1
  203. package/dist/errors.js +8 -1
  204. package/dist/errors.js.map +1 -1
  205. package/dist/external-findings-import.d.ts +5 -3
  206. package/dist/external-findings-import.d.ts.map +1 -1
  207. package/dist/external-findings-import.js +7 -6
  208. package/dist/external-findings-import.js.map +1 -1
  209. package/dist/external-findings-local.d.ts +7 -5
  210. package/dist/external-findings-local.d.ts.map +1 -1
  211. package/dist/external-findings-local.js +337 -89
  212. package/dist/external-findings-local.js.map +1 -1
  213. package/dist/external-findings-publish.d.ts +8 -6
  214. package/dist/external-findings-publish.d.ts.map +1 -1
  215. package/dist/external-findings-publish.js +1318 -258
  216. package/dist/external-findings-publish.js.map +1 -1
  217. package/dist/external-findings-read.d.ts +20 -2
  218. package/dist/external-findings-read.d.ts.map +1 -1
  219. package/dist/external-findings-read.js +148 -66
  220. package/dist/external-findings-read.js.map +1 -1
  221. package/dist/external-findings.d.ts +15 -3
  222. package/dist/external-findings.d.ts.map +1 -1
  223. package/dist/external-findings.js +42 -1
  224. package/dist/external-findings.js.map +1 -1
  225. package/dist/external-import-contract.d.ts +5 -1
  226. package/dist/external-import-contract.d.ts.map +1 -1
  227. package/dist/external-import-contract.js +23 -9
  228. package/dist/external-import-contract.js.map +1 -1
  229. package/dist/external-import-models.d.ts +1 -1
  230. package/dist/external-import-models.d.ts.map +1 -1
  231. package/dist/external-import-models.js.map +1 -1
  232. package/dist/feedback.d.ts.map +1 -1
  233. package/dist/feedback.js +5 -4
  234. package/dist/feedback.js.map +1 -1
  235. package/dist/finding-prompt.d.ts +5 -0
  236. package/dist/finding-prompt.d.ts.map +1 -0
  237. package/dist/finding-prompt.js +32 -0
  238. package/dist/finding-prompt.js.map +1 -0
  239. package/dist/findings-client.d.ts +1 -0
  240. package/dist/findings-client.d.ts.map +1 -1
  241. package/dist/findings-client.js +27 -3
  242. package/dist/findings-client.js.map +1 -1
  243. package/dist/github-advisories.d.ts.map +1 -1
  244. package/dist/github-advisories.js +0 -2
  245. package/dist/github-advisories.js.map +1 -1
  246. package/dist/github-dependabot-findings.d.ts.map +1 -1
  247. package/dist/github-dependabot-findings.js +15 -4
  248. package/dist/github-dependabot-findings.js.map +1 -1
  249. package/dist/github-findings.d.ts +4 -1
  250. package/dist/github-findings.d.ts.map +1 -1
  251. package/dist/github-findings.js +55 -30
  252. package/dist/github-findings.js.map +1 -1
  253. package/dist/hosted-git-remotes.d.ts +5 -0
  254. package/dist/hosted-git-remotes.d.ts.map +1 -0
  255. package/dist/hosted-git-remotes.js +285 -0
  256. package/dist/hosted-git-remotes.js.map +1 -0
  257. package/dist/hosted-git-repository.d.ts +28 -0
  258. package/dist/hosted-git-repository.d.ts.map +1 -0
  259. package/dist/hosted-git-repository.js +222 -0
  260. package/dist/hosted-git-repository.js.map +1 -0
  261. package/dist/hosted-scan-protocol.js +2 -2
  262. package/dist/hosted-scan-protocol.js.map +1 -1
  263. package/dist/hosted-scan.d.ts.map +1 -1
  264. package/dist/hosted-scan.js +16 -11
  265. package/dist/hosted-scan.js.map +1 -1
  266. package/dist/hosted-scanner-http.d.ts +21 -0
  267. package/dist/hosted-scanner-http.d.ts.map +1 -0
  268. package/dist/hosted-scanner-http.js +204 -0
  269. package/dist/hosted-scanner-http.js.map +1 -0
  270. package/dist/hosted-scanner-v1.d.ts +6 -0
  271. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  272. package/dist/hosted-scanner-v1.js +60 -0
  273. package/dist/hosted-scanner-v1.js.map +1 -0
  274. package/dist/import-scan.d.ts.map +1 -1
  275. package/dist/import-scan.js +3 -0
  276. package/dist/import-scan.js.map +1 -1
  277. package/dist/index.d.ts +18 -7
  278. package/dist/index.d.ts.map +1 -1
  279. package/dist/index.js +10 -2
  280. package/dist/index.js.map +1 -1
  281. package/dist/inspector-findings.d.ts.map +1 -1
  282. package/dist/inspector-findings.js +47 -65
  283. package/dist/inspector-findings.js.map +1 -1
  284. package/dist/knowledge-base.d.ts.map +1 -1
  285. package/dist/knowledge-base.js +68 -5
  286. package/dist/knowledge-base.js.map +1 -1
  287. package/dist/local-git-metadata.d.ts +1 -1
  288. package/dist/local-git-metadata.d.ts.map +1 -1
  289. package/dist/local-git-metadata.js +1 -2
  290. package/dist/local-git-metadata.js.map +1 -1
  291. package/dist/multiscan.d.ts +6 -4
  292. package/dist/multiscan.d.ts.map +1 -1
  293. package/dist/multiscan.js +138 -65
  294. package/dist/multiscan.js.map +1 -1
  295. package/dist/native-json-findings.d.ts +2 -1
  296. package/dist/native-json-findings.d.ts.map +1 -1
  297. package/dist/native-json-findings.js +12 -2
  298. package/dist/native-json-findings.js.map +1 -1
  299. package/dist/opengrep-findings.d.ts +1 -0
  300. package/dist/opengrep-findings.d.ts.map +1 -1
  301. package/dist/opengrep-findings.js +17 -13
  302. package/dist/opengrep-findings.js.map +1 -1
  303. package/dist/operation-telemetry.d.ts +104 -0
  304. package/dist/operation-telemetry.d.ts.map +1 -0
  305. package/dist/operation-telemetry.js +293 -0
  306. package/dist/operation-telemetry.js.map +1 -0
  307. package/dist/plugin-python-probe.d.ts +4 -0
  308. package/dist/plugin-python-probe.d.ts.map +1 -0
  309. package/dist/plugin-python-probe.js +10 -0
  310. package/dist/plugin-python-probe.js.map +1 -0
  311. package/dist/private-finding-import.d.ts +97 -2
  312. package/dist/private-finding-import.d.ts.map +1 -1
  313. package/dist/private-finding-import.js +58 -34
  314. package/dist/private-finding-import.js.map +1 -1
  315. package/dist/provider-profile.d.ts +1 -1
  316. package/dist/provider-profile.d.ts.map +1 -1
  317. package/dist/provider-profile.js +8 -1
  318. package/dist/provider-profile.js.map +1 -1
  319. package/dist/publication-telemetry.d.ts +45 -0
  320. package/dist/publication-telemetry.d.ts.map +1 -0
  321. package/dist/publication-telemetry.js +50 -0
  322. package/dist/publication-telemetry.js.map +1 -0
  323. package/dist/publish.d.ts +4 -0
  324. package/dist/publish.d.ts.map +1 -1
  325. package/dist/publish.js +42 -2
  326. package/dist/publish.js.map +1 -1
  327. package/dist/reader-selection.d.ts +2 -0
  328. package/dist/reader-selection.d.ts.map +1 -1
  329. package/dist/reader-selection.js +8 -0
  330. package/dist/reader-selection.js.map +1 -1
  331. package/dist/remediation.d.ts +1 -4
  332. package/dist/remediation.d.ts.map +1 -1
  333. package/dist/remediation.js +3 -7
  334. package/dist/remediation.js.map +1 -1
  335. package/dist/request-metadata.d.ts +3 -0
  336. package/dist/request-metadata.d.ts.map +1 -1
  337. package/dist/request-metadata.js +9 -0
  338. package/dist/request-metadata.js.map +1 -1
  339. package/dist/result.d.ts +4 -0
  340. package/dist/result.d.ts.map +1 -1
  341. package/dist/result.js +1 -1
  342. package/dist/result.js.map +1 -1
  343. package/dist/retry-windows-rename.d.ts +8 -0
  344. package/dist/retry-windows-rename.d.ts.map +1 -0
  345. package/dist/retry-windows-rename.js +24 -0
  346. package/dist/retry-windows-rename.js.map +1 -0
  347. package/dist/runtime.d.ts +20 -0
  348. package/dist/runtime.d.ts.map +1 -1
  349. package/dist/runtime.js +313 -110
  350. package/dist/runtime.js.map +1 -1
  351. package/dist/saved-scan-bootstrap.d.ts +1 -0
  352. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  353. package/dist/saved-scan-bootstrap.js +18 -15
  354. package/dist/saved-scan-bootstrap.js.map +1 -1
  355. package/dist/scan-activity.d.ts.map +1 -1
  356. package/dist/scan-activity.js +141 -56
  357. package/dist/scan-activity.js.map +1 -1
  358. package/dist/scan-comparison.d.ts +10 -5
  359. package/dist/scan-comparison.d.ts.map +1 -1
  360. package/dist/scan-comparison.js +60 -15
  361. package/dist/scan-comparison.js.map +1 -1
  362. package/dist/scan-dashboard.d.ts +6 -6
  363. package/dist/scan-dashboard.d.ts.map +1 -1
  364. package/dist/scan-dashboard.js +75 -42
  365. package/dist/scan-dashboard.js.map +1 -1
  366. package/dist/scan-executor.d.ts +10 -1
  367. package/dist/scan-executor.d.ts.map +1 -1
  368. package/dist/scan-executor.js +22 -2
  369. package/dist/scan-executor.js.map +1 -1
  370. package/dist/scan-history-renderer.d.ts.map +1 -1
  371. package/dist/scan-history-renderer.js +9 -19
  372. package/dist/scan-history-renderer.js.map +1 -1
  373. package/dist/scan-logs.d.ts +12 -0
  374. package/dist/scan-logs.d.ts.map +1 -1
  375. package/dist/scan-logs.js +106 -77
  376. package/dist/scan-logs.js.map +1 -1
  377. package/dist/scan-measurement.d.ts +26 -0
  378. package/dist/scan-measurement.d.ts.map +1 -0
  379. package/dist/scan-measurement.js +77 -0
  380. package/dist/scan-measurement.js.map +1 -0
  381. package/dist/scan-progress.d.ts +1 -0
  382. package/dist/scan-progress.d.ts.map +1 -1
  383. package/dist/scan-progress.js +3 -0
  384. package/dist/scan-progress.js.map +1 -1
  385. package/dist/scan-sessions.d.ts.map +1 -1
  386. package/dist/scan-sessions.js +4 -1
  387. package/dist/scan-sessions.js.map +1 -1
  388. package/dist/scan-settings.d.ts +1 -1
  389. package/dist/scan-settings.d.ts.map +1 -1
  390. package/dist/scan-settings.js +1 -24
  391. package/dist/scan-settings.js.map +1 -1
  392. package/dist/scanner-import.d.ts +20 -2
  393. package/dist/scanner-import.d.ts.map +1 -1
  394. package/dist/scanner-import.js +200 -8
  395. package/dist/scanner-import.js.map +1 -1
  396. package/dist/scanner-repository-url.d.ts +4 -1
  397. package/dist/scanner-repository-url.d.ts.map +1 -1
  398. package/dist/scanner-repository-url.js +10 -6
  399. package/dist/scanner-repository-url.js.map +1 -1
  400. package/dist/security-policy.d.ts +1 -1
  401. package/dist/security-policy.d.ts.map +1 -1
  402. package/dist/security-policy.js.map +1 -1
  403. package/dist/semgrep-findings.d.ts +6 -3
  404. package/dist/semgrep-findings.d.ts.map +1 -1
  405. package/dist/semgrep-findings.js +107 -43
  406. package/dist/semgrep-findings.js.map +1 -1
  407. package/dist/semgrep-guardian-findings.d.ts +38 -0
  408. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  409. package/dist/semgrep-guardian-findings.js +165 -0
  410. package/dist/semgrep-guardian-findings.js.map +1 -0
  411. package/dist/semgrep-platform-collector.d.ts +26 -0
  412. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  413. package/dist/semgrep-platform-collector.js +108 -0
  414. package/dist/semgrep-platform-collector.js.map +1 -0
  415. package/dist/semgrep-platform-findings.d.ts +207 -6
  416. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  417. package/dist/semgrep-platform-findings.js +983 -103
  418. package/dist/semgrep-platform-findings.js.map +1 -1
  419. package/dist/semgrep-platform-v1.d.ts +6 -0
  420. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  421. package/dist/semgrep-platform-v1.js +83 -0
  422. package/dist/semgrep-platform-v1.js.map +1 -0
  423. package/dist/server/api.d.ts +1 -1
  424. package/dist/server/api.d.ts.map +1 -1
  425. package/dist/server/api.js.map +1 -1
  426. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  427. package/dist/server/embedding-tokenizer.d.ts +2 -0
  428. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  429. package/dist/server/embedding-tokenizer.js +322 -0
  430. package/dist/server/embedding-tokenizer.js.map +6 -0
  431. package/dist/server/embeddings.d.ts +16 -2
  432. package/dist/server/embeddings.d.ts.map +1 -1
  433. package/dist/server/embeddings.js +35 -5
  434. package/dist/server/embeddings.js.map +1 -1
  435. package/dist/session-lines.d.ts +5 -0
  436. package/dist/session-lines.d.ts.map +1 -0
  437. package/dist/session-lines.js +60 -0
  438. package/dist/session-lines.js.map +1 -0
  439. package/dist/severity-review.d.ts +3 -1
  440. package/dist/severity-review.d.ts.map +1 -1
  441. package/dist/severity-review.js +3 -2
  442. package/dist/severity-review.js.map +1 -1
  443. package/dist/skill-authentication.d.ts +1 -0
  444. package/dist/skill-authentication.d.ts.map +1 -1
  445. package/dist/skill-authentication.js +1 -0
  446. package/dist/skill-authentication.js.map +1 -1
  447. package/dist/snyk-findings.d.ts +7 -2
  448. package/dist/snyk-findings.d.ts.map +1 -1
  449. package/dist/snyk-findings.js +93 -70
  450. package/dist/snyk-findings.js.map +1 -1
  451. package/dist/snyk-rest-findings.d.ts +76 -0
  452. package/dist/snyk-rest-findings.d.ts.map +1 -0
  453. package/dist/snyk-rest-findings.js +1051 -0
  454. package/dist/snyk-rest-findings.js.map +1 -0
  455. package/dist/snyk-rest-v1.d.ts +28 -0
  456. package/dist/snyk-rest-v1.d.ts.map +1 -0
  457. package/dist/snyk-rest-v1.js +132 -0
  458. package/dist/snyk-rest-v1.js.map +1 -0
  459. package/dist/snyk-token-origin.d.ts +4 -0
  460. package/dist/snyk-token-origin.d.ts.map +1 -0
  461. package/dist/snyk-token-origin.js +82 -0
  462. package/dist/snyk-token-origin.js.map +1 -0
  463. package/dist/sonar-collector.d.ts.map +1 -1
  464. package/dist/sonar-collector.js +0 -3
  465. package/dist/sonar-collector.js.map +1 -1
  466. package/dist/sonar-import.d.ts.map +1 -1
  467. package/dist/sonar-import.js +2 -4
  468. package/dist/sonar-import.js.map +1 -1
  469. package/dist/target-drift.d.ts +9 -0
  470. package/dist/target-drift.d.ts.map +1 -0
  471. package/dist/target-drift.js +27 -0
  472. package/dist/target-drift.js.map +1 -0
  473. package/dist/targets.d.ts +2 -0
  474. package/dist/targets.d.ts.map +1 -1
  475. package/dist/targets.js +56 -20
  476. package/dist/targets.js.map +1 -1
  477. package/dist/tenable-findings.d.ts +9 -0
  478. package/dist/tenable-findings.d.ts.map +1 -0
  479. package/dist/tenable-findings.js +122 -0
  480. package/dist/tenable-findings.js.map +1 -0
  481. package/dist/terminal-stream.d.ts +13 -0
  482. package/dist/terminal-stream.d.ts.map +1 -0
  483. package/dist/terminal-stream.js +35 -0
  484. package/dist/terminal-stream.js.map +1 -0
  485. package/dist/trivy-findings.d.ts +19 -0
  486. package/dist/trivy-findings.d.ts.map +1 -0
  487. package/dist/trivy-findings.js +435 -0
  488. package/dist/trivy-findings.js.map +1 -0
  489. package/dist/trivy-import.d.ts +19 -0
  490. package/dist/trivy-import.d.ts.map +1 -0
  491. package/dist/trivy-import.js +151 -0
  492. package/dist/trivy-import.js.map +1 -0
  493. package/dist/validation-records.js +1 -1
  494. package/dist/validation-records.js.map +1 -1
  495. package/dist/veracode-findings.d.ts +2 -0
  496. package/dist/veracode-findings.d.ts.map +1 -1
  497. package/dist/veracode-findings.js +49 -11
  498. package/dist/veracode-findings.js.map +1 -1
  499. package/dist/vertex-pricing.d.ts +8 -0
  500. package/dist/vertex-pricing.d.ts.map +1 -0
  501. package/dist/vertex-pricing.js +20 -0
  502. package/dist/vertex-pricing.js.map +1 -0
  503. package/dist/windows-path.d.ts +1 -0
  504. package/dist/windows-path.d.ts.map +1 -1
  505. package/dist/windows-path.js +26 -1
  506. package/dist/windows-path.js.map +1 -1
  507. package/dist/wiz-findings.d.ts +4 -0
  508. package/dist/wiz-findings.d.ts.map +1 -1
  509. package/dist/wiz-findings.js +57 -3
  510. package/dist/wiz-findings.js.map +1 -1
  511. package/docs/classify-severity-records.md +27 -12
  512. package/docs/cli.md +497 -550
  513. package/docs/dedupe-records.md +44 -24
  514. package/docs/findings-service.md +66 -39
  515. package/docs/hosted-remediation.md +14 -7
  516. package/docs/hosted-scans.md +50 -42
  517. package/docs/telemetry.md +236 -0
  518. package/docs/validate-records.md +78 -44
  519. package/package.json +18 -15
  520. package/schemas/external-findings.schema.json +3 -1
  521. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  522. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  523. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  524. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  525. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  526. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  527. package/dist/external-imports-feature.d.ts +0 -6
  528. package/dist/external-imports-feature.d.ts.map +0 -1
  529. package/dist/external-imports-feature.js +0 -51
  530. package/dist/external-imports-feature.js.map +0 -1
  531. package/dist/finding-normalization.d.ts +0 -5
  532. package/dist/finding-normalization.d.ts.map +0 -1
  533. package/dist/finding-normalization.js +0 -155
  534. package/dist/finding-normalization.js.map +0 -1
@@ -1,11 +1,17 @@
1
+ import { semgrepLegacyRepositoryWitnesses, semgrepPlatformFindingBinding, semgrepPlatformReportScope, semgrepPlatformRepositoryReference, isSemgrepPlatformEvidence, semgrepReferenceMatches, } from "./semgrep-platform-findings.js";
2
+ import { gitPathToHttpPath, gitServiceHostname, isPublicGitHost, gitTransportBytes, hostedRepositoryMatches, } from "./hosted-git-repository.js";
3
+ import { checkRetainedTrivyProvider, checkTrivyReportProvider, matchTrivyCheckout, } from "./trivy-import.js";
4
+ import { readGitRemoteNames, readHostedGitRemotes, } from "./hosted-git-remotes.js";
1
5
  import { CodexSecurityError } from "./errors.js";
2
- import { forwardExternalImportSetting, requireExternalImports, } from "./external-imports-feature.js";
3
- import { cloneImportPreview, snapshotImportOptions, snapshotNormalizedFindings, snapshotSourceRepositories, } from "./external-findings.js";
4
- import { cloudRepositoryUrlKey, requireSafeJsonInteger, repositoryUrlKey, } from "./external-import-contract.js";
5
- import { localFindingRepositories } from "./external-findings-read.js";
6
- import { hasGitMetadata, localGitProtectionRoots, importGitProtectionRoots, } from "./local-git-metadata.js";
6
+ import { externalImportDisposition, NoPublishableFindingsError, cloneImportPreview, snapshotImportOptions, snapshotNormalizedFindings, snapshotSourceRepositories, } from "./external-findings.js";
7
+ import { cloudRepositoryUrlKey, requireSafeJsonInteger, repositoryUrlKey, validateExternalEvidence, } from "./external-import-contract.js";
8
+ import { localFindingRepositories, semgrepSarifRepositories, } from "./external-findings-read.js";
9
+ import { tenableReportFormat, tenableSourceRepository, } from "./tenable-findings.js";
10
+ import { guardianFindingRepository, guardianSelectionFormat, } from "./semgrep-guardian-findings.js";
11
+ import { hasGitMetadata, localGitProtectionRoots, commandGitProtectionRoots, } from "./local-git-metadata.js";
7
12
  import { blackDuckReportRepositories, projectedBlackDuckRepositoryUrl, } from "./blackduck-findings.js";
8
13
  import { azureReposHttpsUrl, isGitHubCloudHost, isGitHubSshOverHttps, isGitSsh, parseGitRemote, } from "./git-remote.js";
14
+ import { checkmarxSelection } from "./checkmarx-repository.js";
9
15
  import { continuumReportRepositories } from "./continuum-findings.js";
10
16
  import { veracodeReportRepositories } from "./veracode-findings.js";
11
17
  import { inspectorReportRepository } from "./inspector-findings.js";
@@ -13,6 +19,8 @@ import { declaredScannerRepositoryUrl } from "./scanner-repository-url.js";
13
19
  import { sonarRepositoryUrls } from "./sonar-findings.js";
14
20
  import { isRecord } from "./record.js";
15
21
  import { dependabotRepository } from "./github-dependabot-findings.js";
22
+ import { retainedGitHubRepository } from "./github-findings.js";
23
+ import { snykRestImportRepository, snykRestCheckoutMatches, } from "./snyk-rest-findings.js";
16
24
  import { bundledPluginRoot, canonicalConfigPath, canonicalizeModelSafePath, expandHome, requireOutputOutsideRepositories, runWorkbench, workbenchEnvironment, } from "./runtime.js";
17
25
  import { abortable, enclosingGitWorktreeRoot, gitOutput, normalizeRepository, } from "./targets.js";
18
26
  function requireIdentity(value, field) {
@@ -34,14 +42,9 @@ const gitTransportPorts = {
34
42
  "ftp:": "21",
35
43
  "ftps:": "990",
36
44
  };
37
- function sonarHostedGit(hostname) {
38
- return (isGitHubCloudHost(hostname) ||
39
- hostname === "gitlab.com" ||
40
- hostname === "bitbucket.org");
41
- }
42
45
  function sonarHostedHostname(hostname) {
43
- const name = hostname.toLowerCase().replace(/\.$/u, "");
44
- return sonarHostedGit(name) ||
46
+ const name = gitServiceHostname(hostname.toLowerCase());
47
+ return isPublicGitHost(name) ||
45
48
  ["ssh.github.com", "ssh.dev.azure.com", "dev.azure.com"].includes(name)
46
49
  ? name
47
50
  : undefined;
@@ -106,27 +109,19 @@ function remoteRepository(value, provider, bound, platform = provider, possibleS
106
109
  };
107
110
  }
108
111
  // Git passes the original path (including dot segments, '?' and '#') to upload-pack.
109
- const literal = (raw) => {
110
- const bytes = Buffer.from(raw).toString("latin1");
111
- return scpStyle
112
- ? bytes
113
- : bytes.replace(/%(?!00)([\da-f]{2})/giu, (_, hex) => String.fromCharCode(parseInt(hex, 16)));
114
- };
115
112
  if (!scpStyle && !transport)
116
113
  return { key: value };
117
- const gitPath = literal(transport?.[2] ?? path);
114
+ const gitPath = gitTransportBytes(transport?.[2] ?? path, scpStyle);
118
115
  const login = scpStyle
119
116
  ? /^([^@/:\s?#]+)@/u.exec(value)?.[1]
120
117
  : /^(.*)@/u.exec(authority ?? "")?.[1];
121
118
  const homeRelative = /^\/?~(?:\/|$)/u.test(gitPath) || (scpStyle && !/^[~/]/u.test(gitPath));
122
119
  const suffix = /[?#].*$/su.exec(gitPath);
123
120
  // Express upload-pack bytes as a URL path for comparison with the HTTP source.
124
- const name = gitPath
125
- .slice(0, suffix?.index)
126
- .replace(/^\//u, "")
127
- .replace(/[%\x00-\x20\x7f-\xff]/gu, (byte) => "%" + byte.charCodeAt(0).toString(16).toUpperCase().padStart(2, "0"));
121
+ const name = gitPathToHttpPath(gitPath.slice(0, suffix?.index));
128
122
  // Azure's generated SCP clone URL spells spaces as %20, even though Git sends SCP paths literally.
129
- const azure = provider === "sonar" && !(scpStyle && path.startsWith("/"))
123
+ const azure = (provider === "sonar" || provider === "checkmarx") &&
124
+ !(scpStyle && path.startsWith("/"))
130
125
  ? azureReposHttpsUrl(url, scpStyle ? name.replace(/%2520/gu, "%20") : name)
131
126
  : undefined;
132
127
  const repository = suffix
@@ -136,7 +131,7 @@ function remoteRepository(value, provider, bound, platform = provider, possibleS
136
131
  : key(azure ?? origin + name);
137
132
  return {
138
133
  key: repository,
139
- account: ssh && login ? literal(login) : undefined,
134
+ account: ssh && login ? gitTransportBytes(login, scpStyle) : undefined,
140
135
  // GitHub serves the same repository path through its SCP and SSH URLs.
141
136
  homeRelative: ssh && platform !== "github" && !isGitHubCloudHost(hostname.toLowerCase())
142
137
  ? homeRelative
@@ -153,6 +148,20 @@ function matchingRemote(left, right) {
153
148
  right.account === undefined ||
154
149
  left.account === right.account));
155
150
  }
151
+ // Within one fetch key and home-relative mode, matchingRemote can use any
152
+ // account, the requested login, or an unspecified login.
153
+ function fetchAliasMatcher(rows) {
154
+ const homes = Map.groupBy(rows, ({ fetch }) => fetch.homeRelative);
155
+ const accounts = Array.from(homes.values(), (group) => new Map(group.map(({ fetch }) => [fetch.account, fetch])));
156
+ return (fetch) => accounts.some((group) => [
157
+ group.values().next().value,
158
+ group.get(fetch.account),
159
+ group.get(undefined),
160
+ ].some((candidate) => candidate !== undefined && matchingRemote(fetch, candidate)));
161
+ }
162
+ function fetchAliasMatchers(rows, key) {
163
+ return new Map(Array.from(Map.groupBy(rows, key), ([name, group]) => [name, fetchAliasMatcher(group)]));
164
+ }
156
165
  /** A credential-free Sonar repository binding from a supported Git fetch transport. */
157
166
  export function sonarRepositoryForRemote(origin) {
158
167
  try {
@@ -182,7 +191,7 @@ export function sonarRepositoryForRemote(origin) {
182
191
  else if (isGitSsh(url.protocol) &&
183
192
  url.username === "git" &&
184
193
  (!url.port || url.port === "22") &&
185
- sonarHostedGit(hostname)) {
194
+ isPublicGitHost(hostname)) {
186
195
  candidate = `https://${hostname}/${path}`;
187
196
  }
188
197
  else {
@@ -259,27 +268,13 @@ export async function configuredFetchRemotes(repository, provider, protectedRoot
259
268
  !(await boundSonarWorktree(repository, gitProtectedRoots, environment, signal)))
260
269
  return [];
261
270
  const readGit = (args) => abortable(() => gitOutput(repository, args, signal, { LC_ALL: "C" }, undefined, "utf8", gitProtectedRoots, environment), signal);
262
- let remoteNames;
263
- try {
264
- remoteNames = await readGit(["remote"]);
265
- }
266
- catch (error) {
267
- signal?.throwIfAborted();
268
- // A local source directory need not be a Git checkout.
269
- if (error instanceof Error &&
270
- "code" in error &&
271
- error.code === 128 &&
272
- "stderr" in error &&
273
- typeof error.stderr === "string" &&
274
- (error.stderr.trimEnd() ===
275
- "fatal: not a git repository (or any of the parent directories): .git" ||
276
- /^fatal: not a git repository \(or any parent up to mount point [^\r\n]+\)\r?\nStopping at filesystem boundary \(GIT_DISCOVERY_ACROSS_FILESYSTEM not set\)\.$/u.test(error.stderr.trimEnd())))
277
- return [];
278
- throw error;
279
- }
271
+ const remoteNames = await readGitRemoteNames(readGit, signal);
272
+ if (remoteNames === undefined)
273
+ return [];
280
274
  const remotes = [];
275
+ const firstUrlOnly = provider === "sonar" || provider === "checkmarx";
281
276
  for (const name of remoteNames.split(/\r?\n/u).filter(Boolean)) {
282
- if (provider === "sonar") {
277
+ if (firstUrlOnly) {
283
278
  // Git fetches from only the first URL, after insteadOf rewrites.
284
279
  const url = await readGit(["remote", "get-url", "--", name]);
285
280
  if (/[\r\n]/u.test(url))
@@ -294,17 +289,41 @@ export async function configuredFetchRemotes(repository, provider, protectedRoot
294
289
  }
295
290
  return remotes;
296
291
  }
297
- async function requireMatchingRepository(repository, provider, sources, strictSources, strictPlatformFor, protectedRoots, environment, signal, possibleSshHost, fetchRemotes) {
298
- if (sources.length === 0)
292
+ async function requireMatchingRepository(repository, provider, sources, strictSources, hostedSources, platformFor, snyk, protectedRoots, environment, signal, possibleSshHost, fetchRemotes, isCheckmarxSource) {
293
+ if (!snyk && sources.length === 0 && hostedSources.length === 0)
299
294
  return false;
295
+ let allSourcesMatched = true;
296
+ if (snyk || hostedSources.length) {
297
+ if (!(await hasGitMetadata(repository, signal)))
298
+ return false;
299
+ const remotes = await readHostedGitRemotes(repository, [
300
+ ...protectedRoots,
301
+ await abortable(() => canonicalConfigPath(process.cwd()), signal),
302
+ ], environment, signal);
303
+ if (snyk) {
304
+ if (remotes &&
305
+ !remotes.some((remote) => snykRestCheckoutMatches(snyk, remote)))
306
+ throw new CodexSecurityError(`Imported repository ${JSON.stringify(snyk.url)} does not match a configured remote of ${repository}. Select the matching local repository.`);
307
+ return remotes !== undefined;
308
+ }
309
+ allSourcesMatched = remotes !== undefined;
310
+ if (remotes) {
311
+ for (const source of hostedSources)
312
+ if (!remotes.some((remote) => hostedRepositoryMatches(source, remote)))
313
+ throw new CodexSecurityError(`Imported repository ${JSON.stringify(source.url)} does not match a configured remote of ${repository}. Select the matching local repository.`);
314
+ }
315
+ if (!sources.length)
316
+ return allSourcesMatched;
317
+ }
318
+ const remoteProvider = (checkmarx) => checkmarx && provider !== "sonar" ? "checkmarx" : provider;
300
319
  const remotes = fetchRemotes ??
301
- (await configuredFetchRemotes(repository, provider, protectedRoots, environment, signal));
320
+ (await configuredFetchRemotes(repository, remoteProvider(Boolean(isCheckmarxSource)), protectedRoots, environment, signal));
302
321
  const boundProvider = provider === "sonar" ||
322
+ provider === "checkmarx" ||
303
323
  provider === "continuum" ||
304
324
  provider === "inspector" ||
305
325
  provider === "blackduck" ||
306
326
  provider === "veracode";
307
- const loosePlatformFor = localRepositoryPlatform(provider, sources, false);
308
327
  const comparable = [];
309
328
  const unverified = [];
310
329
  for (const { url: remote } of remotes) {
@@ -314,13 +333,11 @@ async function requireMatchingRepository(repository, provider, sources, strictSo
314
333
  else if (!/[\s\\\p{Cc}?#]/u.test(remote))
315
334
  unverified.push(remote);
316
335
  }
317
- let allSourcesMatched = true;
318
336
  for (const source of sources) {
319
337
  const bound = boundProvider || strictSources.has(source.url);
320
- const platform = bound
321
- ? (strictSources.get(source.url) ?? strictPlatformFor(source))
322
- : loosePlatformFor(source);
323
- const identity = (url) => remoteRepository(url, provider, bound, platform);
338
+ const platform = strictSources.get(source.url) ?? platformFor(source, bound);
339
+ const sourceProvider = remoteProvider(isCheckmarxSource?.(source.url));
340
+ const identity = (url, fallbackHost) => remoteRepository(url, sourceProvider, bound, platform, fallbackHost);
324
341
  const targets = comparable.flatMap((remote) => identity(remote) ?? []);
325
342
  const target = identity(source.url);
326
343
  if (target && targets.some((remote) => matchingRemote(remote, target)))
@@ -328,8 +345,7 @@ async function requireMatchingRepository(repository, provider, sources, strictSo
328
345
  allSourcesMatched = false;
329
346
  // A custom SSH upstream can agree with a manual mapping even when a
330
347
  // recognized HTTPS remote points at a fork. It cannot prove a Cloud binding.
331
- const configured = unverified.flatMap((remote) => remoteRepository(remote, provider, bound, platform, possibleSshHost) ??
332
- []);
348
+ const configured = unverified.flatMap((remote) => identity(remote, possibleSshHost) ?? []);
333
349
  if (target && configured.some((remote) => matchingRemote(remote, target)))
334
350
  continue;
335
351
  if (targets.length || configured.length)
@@ -338,14 +354,11 @@ async function requireMatchingRepository(repository, provider, sources, strictSo
338
354
  return allSourcesMatched;
339
355
  }
340
356
  export function sonarCheckoutMatchesSource(repository, url, protectedRoots, environment, signal) {
341
- return requireMatchingRepository(repository, "sonar", [{ url }], new Map(), () => "sonar", [...protectedRoots], environment, signal);
357
+ return requireMatchingRepository(repository, "sonar", [{ url }], new Map(), [], () => "sonar", undefined, [...protectedRoots], environment, signal);
342
358
  }
343
359
  async function localContext(selectedRepository, dependencies, mode = "import") {
344
360
  dependencies.signal?.throwIfAborted();
345
- const selected = dependencies.environment ?? process.env;
346
- const environment = workbenchEnvironment(selected);
347
- forwardExternalImportSetting(selected, environment);
348
- requireExternalImports(environment);
361
+ const environment = workbenchEnvironment(dependencies.environment ?? process.env);
349
362
  const path = expandHome(selectedRepository, environment);
350
363
  const repository = mode === "read"
351
364
  ? await abortable(() => canonicalConfigPath(path), dependencies.signal)
@@ -353,7 +366,7 @@ async function localContext(selectedRepository, dependencies, mode = "import") {
353
366
  const protectedRoot = [
354
367
  ...new Set([
355
368
  repository,
356
- ...(await abortable(() => importGitProtectionRoots(path, environment, dependencies.signal), dependencies.signal)),
369
+ ...(await abortable(() => commandGitProtectionRoots(path, environment, dependencies.signal), dependencies.signal)),
357
370
  ]),
358
371
  ];
359
372
  requireOutputOutsideRepositories(protectedRoot, await abortable(() => canonicalizeModelSafePath(environment.CODEX_SECURITY_STATE_DIR), dependencies.signal), "runtime");
@@ -371,13 +384,41 @@ async function localContext(selectedRepository, dependencies, mode = "import") {
371
384
  /** Prepare scanner evidence without writing state or performing a security assessment. */
372
385
  export async function prepareNormalizedLocalImport(input, options, dependencies = {}) {
373
386
  dependencies.signal?.throwIfAborted();
374
- requireExternalImports(dependencies.environment);
375
387
  return prepareLocalImport(input, snapshotImportOptions(options), dependencies);
376
388
  }
389
+ // A scanner can repeat the same repository reference for every finding in a run.
390
+ export function distinctSourceRepositories(sources) {
391
+ const seen = new Map();
392
+ return sources.filter(({ url, platform }) => {
393
+ const urls = seen.get(platform) ?? new Set();
394
+ if (urls.has(url))
395
+ return false;
396
+ urls.add(url);
397
+ seen.set(platform, urls);
398
+ return true;
399
+ });
400
+ }
377
401
  /** @internal Prepare evidence using settings captured by either local import entrypoint. */
378
- export async function prepareLocalImport(input, options, dependencies, readerSources = snapshotSourceRepositories(dependencies.sourceRepositories), parsedSources = [], fetchRemotes) {
402
+ export async function prepareLocalImport(input, options, dependencies, readerSources = distinctSourceRepositories(snapshotSourceRepositories(dependencies.sourceRepositories)), parsedInput = [], fetchRemotes) {
379
403
  requireIdentity(options.sourceKey, "Source key");
404
+ const parsedSources = distinctSourceRepositories(parsedInput);
380
405
  const current = snapshotNormalizedFindings(input, checkStoredNumber);
406
+ if (options.provider !== "tenable" &&
407
+ (current.report?.["format"] === tenableReportFormat ||
408
+ current.findings.some((row) => row.evidence?.source_data?.["format"] === tenableReportFormat)))
409
+ throw new CodexSecurityError("Retained Tenable evidence requires the tenable provider.");
410
+ checkTrivyReportProvider(options.provider, current.report);
411
+ // The JSON snapshot omits inherited or non-enumerable SDK reader properties.
412
+ if (!("snykRestContext" in current) && "snykRestContext" in input)
413
+ current.snykRestContext = structuredClone(input.snykRestContext);
414
+ if (options.provider === "snyk" || current.snykRestContext !== undefined) {
415
+ for (const key of [
416
+ "sourceRepositoryUrl",
417
+ "sourceRepositoryPlatform",
418
+ ])
419
+ if (key in input && !(key in current))
420
+ Object.assign(current, { [key]: structuredClone(input[key]) });
421
+ }
381
422
  let dependabotSource;
382
423
  const identities = new Set();
383
424
  for (const finding of current.findings) {
@@ -387,6 +428,7 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
387
428
  identities.add(finding.source_finding_id);
388
429
  if (!isRecord(finding.evidence))
389
430
  throw new CodexSecurityError("Imported evidence must be an object.");
431
+ checkRetainedTrivyProvider(options.provider, finding, "local");
390
432
  if (options.provider !== "github")
391
433
  continue;
392
434
  const native = dependabotRepository(finding);
@@ -400,13 +442,25 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
400
442
  throw new CodexSecurityError("Select Dependabot alerts from only one GitHub host and repository.");
401
443
  dependabotSource = native;
402
444
  }
403
- const { repository, options: workbenchOptions } = await localContext(options.repository, dependencies);
445
+ const context = await localContext(options.repository, dependencies);
446
+ if (options.provider === "tenable") {
447
+ const source = tenableSourceRepository(current, options.sourceRepositoryUrl, [...readerSources, ...parsedSources]);
448
+ const remotes = await readHostedGitRemotes(context.repository, [
449
+ ...context.options.protectedRoot,
450
+ await abortable(() => canonicalConfigPath(process.cwd()), dependencies.signal),
451
+ ], context.options.environment, dependencies.signal);
452
+ if (!remotes?.some((remote) => hostedRepositoryMatches(source, remote)))
453
+ throw new CodexSecurityError("Tenable's source repository must match a configured Git fetch remote of the selected checkout.");
454
+ return preparedLocalStorage(current, options, context, dependencies, true);
455
+ }
456
+ const { repository, options: workbenchOptions } = context;
404
457
  const sources = new Map();
405
458
  const references = [...readerSources, ...parsedSources];
406
459
  const inspector = inspectorReportRepository(options.provider, current.findings, "local", options.inspectorProjectMap);
407
- const projected = options.provider === "blackduck"
408
- ? []
409
- : current.findings.filter((finding) => projectedBlackDuckRepositoryUrl(finding, "local"));
460
+ const checkmarx = checkmarxSelection(options.provider, current.findings, current.report, "local");
461
+ const projected = current.findings.filter((finding) => (options.provider !== "blackduck" &&
462
+ projectedBlackDuckRepositoryUrl(finding, "local")) ||
463
+ checkmarx.projections.has(finding));
410
464
  const mixed = projected.length > 0 && readerSources.length > 0;
411
465
  const nativeSources = new Map((mixed ? current.findings : projected)
412
466
  .filter(({ evidence }) => options.provider !== "endor" ||
@@ -430,6 +484,7 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
430
484
  const operatorPlatform = localRepositoryPlatform(options.provider, readerSources, true);
431
485
  const sameRepositories = (urls) => sameScannerRepositories(Array.from(urls, identify));
432
486
  const bound = blackDuckReportRepositories(options.provider, current.findings, "local", sameRepositories);
487
+ const checkmarxRepository = checkmarx.repositories(sameRepositories);
433
488
  for (const repositories of [
434
489
  veracodeReportRepositories,
435
490
  continuumReportRepositories,
@@ -439,19 +494,97 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
439
494
  }
440
495
  }
441
496
  const strictSources = new Map();
497
+ const checkmarxKeys = new Set();
498
+ const hostedSources = new Map();
499
+ const semgrepReportScope = semgrepPlatformReportScope(current, options.provider, readerSources);
500
+ const semgrepPlatformRepositoryUrl = semgrepReportScope?.url;
501
+ function addSemgrepSource(url) {
502
+ if (options.provider !== "semgrep")
503
+ throw new CodexSecurityError("Use the semgrep provider for Semgrep Platform findings.");
504
+ const source = semgrepPlatformRepositoryReference(url, readerSources);
505
+ if (semgrepPlatformRepositoryUrl &&
506
+ semgrepPlatformRepositoryUrl !== url &&
507
+ !semgrepReferenceMatches(source, semgrepPlatformRepositoryUrl))
508
+ throw new CodexSecurityError("The Semgrep report repository does not match the native finding's project.");
509
+ hostedSources.set(source.url, source);
510
+ }
511
+ function addGuardianSource(value) {
512
+ if (options.provider !== "semgrep")
513
+ throw new CodexSecurityError("Use the semgrep provider for Guardian findings.");
514
+ const url = declaredScannerRepositoryUrl(value, "Guardian", "local");
515
+ const source = hostedSources.get(url) ??
516
+ semgrepPlatformRepositoryReference(url, readerSources);
517
+ hostedSources.set(url, source);
518
+ return source;
519
+ }
520
+ const guardianReport = current.report?.["format"] === guardianSelectionFormat
521
+ ? addGuardianSource(current.report["repositoryUrl"])
522
+ : undefined;
523
+ if (semgrepPlatformRepositoryUrl)
524
+ addSemgrepSource(semgrepPlatformRepositoryUrl);
442
525
  const known = new Set(parsedSources.map(({ url }) => url));
526
+ const legacyWitnesses = semgrepLegacyRepositoryWitnesses(current.findings, options.provider, readerSources);
527
+ const hasPlatformEvidence = options.provider === "semgrep" &&
528
+ (semgrepReportScope !== undefined ||
529
+ current.findings.some((row) => isSemgrepPlatformEvidence(row, options.provider)));
530
+ let hasOrdinaryRows = false;
531
+ let ordinaryRowNeedsReferences = false;
443
532
  for (const finding of current.findings) {
444
- const { evidence, source_finding_id: id } = finding;
445
- const url = evidence.details?.repository?.url;
446
- if (url)
447
- sources.set(url, { url });
448
- const retained = bound.get(id);
533
+ const retained = bound.get(finding.source_finding_id) ?? checkmarxRepository(finding);
449
534
  const native = nativeSources.get(finding) ?? [];
450
- if (retained) {
535
+ const sarif = hasPlatformEvidence ? semgrepSarifRepositories(finding) : [];
536
+ const semgrep = semgrepPlatformFindingBinding(finding, options.provider, readerSources, legacyWitnesses, semgrepReportScope, [retained, ...native, ...sarif]);
537
+ if (semgrep) {
538
+ addSemgrepSource(semgrep.url);
539
+ if (semgrep.sourceData)
540
+ finding.evidence.source_data = semgrep.sourceData;
541
+ if (semgrep.migration)
542
+ Object.assign(finding.evidence, semgrep.migration);
543
+ }
544
+ const { evidence } = finding;
545
+ if (options.provider === "github") {
546
+ const source = retainedGitHubRepository(finding, (url) => identify(url).key);
547
+ if (source)
548
+ sources.set(source, { url: source, platform: "github" });
549
+ }
550
+ const guardian = guardianFindingRepository(finding, "local");
551
+ const url = evidence.details?.repository?.url;
552
+ if (guardian) {
553
+ const source = addGuardianSource(guardian);
554
+ if ((guardianReport &&
555
+ !semgrepReferenceMatches(guardianReport, source.url)) ||
556
+ (url &&
557
+ !semgrepReferenceMatches(source, declaredScannerRepositoryUrl(url, "Guardian", "local"))))
558
+ throw new CodexSecurityError("The Guardian finding repository does not match its recorded selection.");
559
+ }
560
+ else if (!semgrep) {
561
+ hasOrdinaryRows = true;
562
+ if (url)
563
+ sources.set(url, { url });
564
+ }
565
+ if (hasPlatformEvidence &&
566
+ !semgrep &&
567
+ !guardian &&
568
+ !retained &&
569
+ !native.length) {
570
+ for (const source of sarif)
571
+ sources.set(source.url, source);
572
+ if (!url && !sarif.length)
573
+ ordinaryRowNeedsReferences = true;
574
+ if (!url && references.length) {
575
+ for (const source of sarif) {
576
+ const claim = identify(source.url);
577
+ if (!references.some((ref) => matchingRemote(claim, identify(ref.url))))
578
+ throw new CodexSecurityError(`The reader must supply the projected Semgrep SARIF repository ${JSON.stringify(source.url)} for the configured remote.`);
579
+ }
580
+ }
581
+ }
582
+ const projectedCheckmarx = checkmarx.projections.has(finding);
583
+ if (retained || (projectedCheckmarx && native.length)) {
584
+ const rowSources = retained ? [retained, ...native] : native;
451
585
  const claims = [
452
- retained.url,
586
+ ...rowSources.map((ref) => ref.url),
453
587
  ...(url ? [url] : []),
454
- ...native.map((ref) => ref.url),
455
588
  ];
456
589
  const rowPlatform = (claim) => options.provider !== "wiz"
457
590
  ? platformFor({ url: claim })
@@ -462,9 +595,11 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
462
595
  key: claim,
463
596
  })))
464
597
  throw new CodexSecurityError("The retained scanner repository does not match the original provider finding.");
465
- for (const source of [retained, ...native])
598
+ for (const source of rowSources)
466
599
  sources.set(source.url, source);
467
600
  for (const claim of claims) {
601
+ if (projectedCheckmarx)
602
+ checkmarxKeys.add(identify(claim).key);
468
603
  const platform = rowPlatform(claim);
469
604
  if (!strictSources.has(claim) || platform !== "github")
470
605
  strictSources.set(claim, platform);
@@ -473,12 +608,54 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
473
608
  for (const source of native)
474
609
  known.add(source.url);
475
610
  }
611
+ // Match references for native Platform rows using their hosted Git identity.
612
+ const hosted = Array.from(hostedSources.values());
613
+ const hostedReferences = new Set(references.filter((ref) => hosted.some((source) => semgrepReferenceMatches(source, ref.url))));
614
+ const sharedReferences = new Set();
615
+ const ordinaryReferences = new Set();
616
+ if (hostedReferences.size) {
617
+ const readerPlatform = localRepositoryPlatform(options.provider, [...sources.values(), ...references], false);
618
+ const ordinaryIdentity = (url) => remoteRepository(url, options.provider, false, readerPlatform({ url })) ?? { key: url };
619
+ const aliases = references.map((ref) => ({
620
+ ref,
621
+ fetch: identify(ref.url),
622
+ ordinary: ordinaryIdentity(ref.url).key,
623
+ }));
624
+ const claims = Map.groupBy(Array.from(sources.keys(), (url) => ({
625
+ fetch: identify(url),
626
+ ordinary: strictSources.has(url)
627
+ ? undefined
628
+ : ordinaryIdentity(url).key,
629
+ })), (claim) => claim.fetch.key);
630
+ for (const [key, refs] of Map.groupBy(aliases, (alias) => alias.fetch.key)) {
631
+ const hosted = refs.filter(({ ref }) => hostedReferences.has(ref));
632
+ const group = claims.get(key);
633
+ if (!hosted.length || !group)
634
+ continue;
635
+ const shared = fetchAliasMatcher(group);
636
+ const readers = fetchAliasMatchers(refs, (alias) => alias.ordinary);
637
+ // Keep a sole fetch alias subject to checkout validation. A redundant
638
+ // Platform spelling can be dropped when another reference serves the reader.
639
+ const required = fetchAliasMatchers(group, ({ fetch, ordinary }) => ordinary !== undefined && readers.get(ordinary)?.(fetch)
640
+ ? ordinary
641
+ : undefined);
642
+ for (const alias of hosted) {
643
+ if (!shared(alias.fetch))
644
+ continue;
645
+ sharedReferences.add(alias.ref);
646
+ if (required.get(undefined)?.(alias.fetch) ||
647
+ required.get(alias.ordinary)?.(alias.fetch))
648
+ ordinaryReferences.add(alias.ref);
649
+ }
650
+ }
651
+ }
476
652
  if (mixed) {
477
- // A caller reference with no matching row spelling can still be a Git alias.
653
+ // Other caller references must identify an ordinary row or one of its Git aliases.
478
654
  const rows = [...sources.keys(), ...known].map(identify);
479
655
  const byKey = Map.groupBy(rows, (remote) => remote.key);
480
656
  const represented = new Set(rows.map((remote) => JSON.stringify(remote)));
481
657
  const aliases = readerSources
658
+ .filter((ref) => !hostedReferences.has(ref) || sharedReferences.has(ref))
482
659
  .map(({ url }) => identify(url))
483
660
  .filter((remote) => !represented.has(JSON.stringify(remote)));
484
661
  for (const [key, group] of Map.groupBy(aliases, (remote) => remote.key)) {
@@ -490,11 +667,15 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
490
667
  if (strictSources.size && options.provider !== "blackduck") {
491
668
  const keys = new Set(Array.from(strictSources.keys(), (url) => identify(url).key));
492
669
  for (const source of references)
493
- if (!strictSources.has(source.url) && keys.has(identify(source.url).key))
670
+ if (!strictSources.has(source.url) &&
671
+ keys.has(identify(source.url).key)) {
494
672
  strictSources.set(source.url, platformFor(source));
673
+ if (sharedReferences.has(source))
674
+ ordinaryReferences.add(source);
675
+ }
495
676
  }
496
677
  if (inspector) {
497
- const platform = inspector.platform ?? options.provider;
678
+ const platform = inspector.platform === "github" ? "github" : options.provider;
498
679
  const native = remoteRepository(inspector.url, options.provider, true, platform);
499
680
  for (const url of sources.keys()) {
500
681
  if (!native ||
@@ -503,11 +684,34 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
503
684
  throw new CodexSecurityError(`Imported repository ${JSON.stringify(url)} does not match the retained Inspector repository ${JSON.stringify(inspector.url)}.`);
504
685
  }
505
686
  }
687
+ if (readerSources.length &&
688
+ hosted.length &&
689
+ ((!hasOrdinaryRows &&
690
+ !readerSources.every((ref) => hostedReferences.has(ref))) ||
691
+ hosted.some((source) => !readerSources.some((ref) => semgrepReferenceMatches(source, ref.url)))))
692
+ throw new CodexSecurityError("The reader's source repository does not match the selected Semgrep project.");
506
693
  for (const source of [...(inspector ? [inspector] : []), ...references]) {
694
+ if (!ordinaryRowNeedsReferences &&
695
+ hostedReferences.has(source) &&
696
+ !ordinaryReferences.has(source))
697
+ continue;
507
698
  // A reader's platform must not loosen an operator-supplied Inspector map.
508
699
  if (sources.get(source.url)?.platform !== "github")
509
700
  sources.set(source.url, options.inspectorProjectMap ? { url: source.url } : source);
510
701
  }
702
+ const reportUrl = checkmarx.reportUrl;
703
+ if (reportUrl) {
704
+ const source = sources.get(reportUrl) ?? { url: reportUrl };
705
+ sources.set(reportUrl, source);
706
+ checkmarxKeys.add(identify(reportUrl).key);
707
+ if (!strictSources.has(reportUrl))
708
+ strictSources.set(reportUrl, platformFor(source));
709
+ }
710
+ if (((options.provider === "checkmarx" || reportUrl) &&
711
+ !sameRepositories(sources.keys())) ||
712
+ (reportUrl &&
713
+ hosted.some((source) => !semgrepReferenceMatches(source, reportUrl))))
714
+ throw new Error("The retained Checkmarx report repository does not match the finding repository.");
511
715
  const sonarSources = sonarRepositoryUrls(options.provider, current.findings, current.report, "local");
512
716
  const manualSource = options.provider === "sonar" && options.sourceRepositoryUrl
513
717
  ? declaredScannerRepositoryUrl(options.sourceRepositoryUrl, "Sonar", "local")
@@ -531,8 +735,40 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
531
735
  url: dependabotSource,
532
736
  platform: "github",
533
737
  });
738
+ const snyk = snykRestImportRepository(current, options.provider, [
739
+ ...sources.keys(),
740
+ ...(options.sourceRepositoryUrl === undefined
741
+ ? []
742
+ : [options.sourceRepositoryUrl]),
743
+ ], readerSources, (finding, source) => {
744
+ finding.evidence.source_data = source;
745
+ });
746
+ if (snyk) {
747
+ // Preserve reader display fields while validating their complete native evidence.
748
+ for (const { evidence } of current.findings)
749
+ validateExternalEvidence(structuredClone(evidence), "local");
750
+ }
751
+ else if (options.provider === "snyk" && current.sourceRepositoryUrl) {
752
+ const declared = { url: current.sourceRepositoryUrl };
753
+ const native = current.findings.flatMap((finding) => localFindingRepositories("snyk", finding));
754
+ for (const source of [declared, ...native])
755
+ if (!sources.has(source.url))
756
+ sources.set(source.url, source);
757
+ if (!sameRepositories(sources.keys()))
758
+ throw new CodexSecurityError("The normalized repository does not match the Snyk reader's repository.");
759
+ }
760
+ const ordinarySources = [...sources.values()];
761
+ // A reader can identify the VCS for both a hosted project and an ordinary row.
762
+ const loosePlatformFor = localRepositoryPlatform(options.provider, [...ordinarySources, ...hostedReferences], false);
534
763
  const selected = manualSource ? new URL(manualSource) : undefined;
535
- const matchesRepositoryRemote = await requireMatchingRepository(repository, options.provider, [...sources.values()], strictSources, platformFor, workbenchOptions.protectedRoot, workbenchOptions.environment, dependencies.signal, selected?.protocol === "https:" ? selected.hostname : undefined, fetchRemotes);
764
+ const matchesRepositoryRemote = options.provider === "trivy"
765
+ ? await matchTrivyCheckout(repository, current, references, workbenchOptions)
766
+ : await requireMatchingRepository(repository, options.provider, ordinarySources, strictSources, hosted, (source, bound) => bound ? platformFor(source) : loosePlatformFor(source), snyk, workbenchOptions.protectedRoot, workbenchOptions.environment, dependencies.signal, selected?.protocol === "https:" ? selected.hostname : undefined, fetchRemotes, checkmarx.projections.size
767
+ ? (url) => checkmarxKeys.has(identify(url).key)
768
+ : undefined);
769
+ return preparedLocalStorage(current, options, context, dependencies, matchesRepositoryRemote);
770
+ }
771
+ function preparedLocalStorage(current, options, { repository, options: workbenchOptions, }, dependencies, matchesRepositoryRemote) {
536
772
  dependencies.signal?.throwIfAborted();
537
773
  const preview = {
538
774
  ...cloneImportPreview(current),
@@ -553,6 +789,25 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
553
789
  preview,
554
790
  async import() {
555
791
  dependencies.signal?.throwIfAborted();
792
+ const disposition = externalImportDisposition(current);
793
+ if (disposition === "failed")
794
+ throw new NoPublishableFindingsError(cloneImportPreview(current));
795
+ const summary = {
796
+ repository,
797
+ read: current.read,
798
+ ...(current.report === undefined
799
+ ? {}
800
+ : snapshotNormalizedFindings({ report: current.report })),
801
+ ready: current.findings.length,
802
+ excluded: structuredClone(current.excluded),
803
+ };
804
+ if (disposition !== "ready") {
805
+ return {
806
+ ...summary,
807
+ findings: [],
808
+ counts: { created: 0, updated: 0, unchanged: 0 },
809
+ };
810
+ }
556
811
  const protectedRoot = [
557
812
  ...new Set([
558
813
  ...workbenchOptions.protectedRoot,
@@ -565,13 +820,7 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
565
820
  return (dependencies.runWorkbench ?? runWorkbench)({ ...workbenchOptions, protectedRoot }, ["store-external-findings"], payload);
566
821
  }, dependencies.signal);
567
822
  return {
568
- repository,
569
- read: current.read,
570
- ...(current.report === undefined
571
- ? {}
572
- : snapshotNormalizedFindings({ report: current.report })),
573
- ready: current.findings.length,
574
- excluded: structuredClone(current.excluded),
823
+ ...summary,
575
824
  findings: result["findings"],
576
825
  counts: result["counts"],
577
826
  };
@@ -581,7 +830,6 @@ export async function prepareLocalImport(input, options, dependencies, readerSou
581
830
  /** Read imported source records, including evidence that has not been assessed by Codex. */
582
831
  export async function listLocalExternalFindings(selection, dependencies = {}) {
583
832
  dependencies.signal?.throwIfAborted();
584
- requireExternalImports(dependencies.environment);
585
833
  if (selection.id !== undefined)
586
834
  requireIdentity(selection.id, "Finding id");
587
835
  const { repository, options } = await localContext(selection.repository, dependencies, "read");