@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,21 +1,37 @@
1
- import { lstat, readFile, realpath, stat } from "node:fs/promises";
2
- import { dirname, isAbsolute, join, resolve, sep } from "node:path";
3
- import { isNumberObject } from "node:util/types";
4
- import { environmentEntry } from "./auth.js";
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";
5
5
  import { CodexSecurityError } from "./errors.js";
6
- import { forwardExternalImportSetting, requireExternalImports, } from "./external-imports-feature.js";
7
- import { snapshotImportOptions, } from "./external-findings.js";
8
- import { cloudRepositoryUrlKey, repositoryUrlKey, validateExternalReport, } from "./external-import-contract.js";
9
- import { isGitHubCloudHost, parseGitRemote } from "./git-remote.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";
12
+ import { blackDuckReportRepositories, projectedBlackDuckRepositoryUrl, } from "./blackduck-findings.js";
13
+ import { azureReposHttpsUrl, isGitHubCloudHost, isGitHubSshOverHttps, isGitSsh, parseGitRemote, } from "./git-remote.js";
14
+ import { checkmarxSelection } from "./checkmarx-repository.js";
15
+ import { continuumReportRepositories } from "./continuum-findings.js";
16
+ import { veracodeReportRepositories } from "./veracode-findings.js";
10
17
  import { inspectorReportRepository } from "./inspector-findings.js";
18
+ import { declaredScannerRepositoryUrl } from "./scanner-repository-url.js";
19
+ import { sonarRepositoryUrls } from "./sonar-findings.js";
11
20
  import { isRecord } from "./record.js";
12
21
  import { dependabotRepository } from "./github-dependabot-findings.js";
22
+ import { retainedGitHubRepository } from "./github-findings.js";
23
+ import { snykRestImportRepository, snykRestCheckoutMatches, } from "./snyk-rest-findings.js";
13
24
  import { bundledPluginRoot, canonicalConfigPath, canonicalizeModelSafePath, expandHome, requireOutputOutsideRepositories, runWorkbench, workbenchEnvironment, } from "./runtime.js";
14
- import { abortable, gitMarkerRoot, gitOutput, gitProtectionRoots, normalizeRepository, nullIfMissingPath, } from "./targets.js";
25
+ import { abortable, enclosingGitWorktreeRoot, gitOutput, normalizeRepository, } from "./targets.js";
15
26
  function requireIdentity(value, field) {
16
27
  if (typeof value !== "string" || !value.trim() || value.includes("\0"))
17
28
  throw new CodexSecurityError(`${field} must be nonempty and contain no NUL characters.`);
18
29
  }
30
+ function checkStoredNumber(value) {
31
+ if (!Number.isFinite(value))
32
+ throw new TypeError("Stored finding JSON cannot contain non-finite numbers.");
33
+ requireSafeJsonInteger(value, "Stored finding JSON");
34
+ }
19
35
  const gitTransportPorts = {
20
36
  "http:": "80",
21
37
  "https:": "443",
@@ -26,8 +42,14 @@ const gitTransportPorts = {
26
42
  "ftp:": "21",
27
43
  "ftps:": "990",
28
44
  };
29
- /** Compare transport forms without changing retained scanner evidence. */
30
- function remoteRepository(value, provider, bound) {
45
+ function sonarHostedHostname(hostname) {
46
+ const name = gitServiceHostname(hostname.toLowerCase());
47
+ return isPublicGitHost(name) ||
48
+ ["ssh.github.com", "ssh.dev.azure.com", "dev.azure.com"].includes(name)
49
+ ? name
50
+ : undefined;
51
+ }
52
+ function remoteRepository(value, provider, bound, platform = provider, possibleSshHost) {
31
53
  if (/^[A-Za-z]:[\\/]/u.test(value))
32
54
  return undefined;
33
55
  const transport = bound
@@ -51,18 +73,23 @@ function remoteRepository(value, provider, bound) {
51
73
  if (!remote || !Object.hasOwn(gitTransportPorts, remote.url.protocol))
52
74
  return undefined;
53
75
  const { url, path, scpStyle } = remote;
54
- const ssh = url.protocol.includes("ssh");
76
+ const ssh = isGitSsh(url.protocol);
55
77
  const protocol = url.protocol === "http:" ? "http:" : "https:";
56
- const githubSshOverHttps = ssh &&
57
- url.hostname.toLowerCase() === "ssh.github.com" &&
58
- url.port === "443";
59
- const hostname = githubSshOverHttps ? "github.com" : url.hostname;
78
+ const hosted = sonarHostedHostname(url.hostname);
79
+ if (provider === "sonar" && hosted)
80
+ url.hostname = hosted;
81
+ const githubSshOverHttps = isGitHubSshOverHttps(url);
82
+ let hostname = githubSshOverHttps ? "github.com" : url.hostname;
83
+ // An unresolved SSH name can be a local Host alias. Only substitute the
84
+ // supplied hostname when checking the path of an unverified manual mapping.
85
+ if (possibleSshHost && ssh && (!hosted || hosted === "dev.azure.com"))
86
+ hostname = sonarHostedHostname(possibleSshHost) ?? possibleSshHost;
60
87
  const port = githubSshOverHttps || url.port === gitTransportPorts[url.protocol]
61
88
  ? ""
62
89
  : url.port;
63
90
  // A GitHub source identifies a case-insensitive repository on custom Enterprise
64
91
  // hosts too; other providers can refer to VCS hosts with case-sensitive paths.
65
- const key = provider === "github" ? cloudRepositoryUrlKey : repositoryUrlKey;
92
+ const key = platform === "github" ? cloudRepositoryUrlKey : repositoryUrlKey;
66
93
  const origin = `${protocol}//${hostname}${port ? `:${port}` : ""}/`;
67
94
  if (!bound)
68
95
  return { key: key(origin + path) };
@@ -82,223 +109,256 @@ function remoteRepository(value, provider, bound) {
82
109
  };
83
110
  }
84
111
  // Git passes the original path (including dot segments, '?' and '#') to upload-pack.
85
- const literal = (raw) => {
86
- const bytes = Buffer.from(raw).toString("latin1");
87
- return scpStyle
88
- ? bytes
89
- : bytes.replace(/%(?!00)([\da-f]{2})/giu, (_, hex) => String.fromCharCode(parseInt(hex, 16)));
90
- };
91
112
  if (!scpStyle && !transport)
92
113
  return { key: value };
93
- const gitPath = literal(transport?.[2] ?? path);
114
+ const gitPath = gitTransportBytes(transport?.[2] ?? path, scpStyle);
94
115
  const login = scpStyle
95
116
  ? /^([^@/:\s?#]+)@/u.exec(value)?.[1]
96
117
  : /^(.*)@/u.exec(authority ?? "")?.[1];
97
118
  const homeRelative = /^\/?~(?:\/|$)/u.test(gitPath) || (scpStyle && !/^[~/]/u.test(gitPath));
98
119
  const suffix = /[?#].*$/su.exec(gitPath);
99
120
  // Express upload-pack bytes as a URL path for comparison with the HTTP source.
100
- const name = gitPath
101
- .slice(0, suffix?.index)
102
- .replace(/^\//u, "")
103
- .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));
122
+ // Azure's generated SCP clone URL spells spaces as %20, even though Git sends SCP paths literally.
123
+ const azure = (provider === "sonar" || provider === "checkmarx") &&
124
+ !(scpStyle && path.startsWith("/"))
125
+ ? azureReposHttpsUrl(url, scpStyle ? name.replace(/%2520/gu, "%20") : name)
126
+ : undefined;
104
127
  const repository = suffix
105
128
  ? key(origin + name + "?") +
106
129
  "\0" +
107
130
  suffix[0].replace(/\/$/u, "").replace(/\.git$/u, "")
108
- : key(origin + name);
131
+ : key(azure ?? origin + name);
109
132
  return {
110
133
  key: repository,
111
- account: ssh && login ? literal(login) : undefined,
134
+ account: ssh && login ? gitTransportBytes(login, scpStyle) : undefined,
112
135
  // GitHub serves the same repository path through its SCP and SSH URLs.
113
- homeRelative: ssh && provider !== "github" && !isGitHubCloudHost(hostname.toLowerCase())
136
+ homeRelative: ssh && platform !== "github" && !isGitHubCloudHost(hostname.toLowerCase())
114
137
  ? homeRelative
115
138
  : undefined,
116
139
  };
117
140
  }
118
- async function bareMetadataRoots(repository, signal) {
119
- const roots = [];
120
- let directory = repository;
121
- for (;;) {
122
- signal?.throwIfAborted();
123
- const present = async (name) => (await abortable(() => lstat(join(directory, name)).catch(nullIfMissingPath), signal)) !== null;
124
- // Git also discovers bare repositories and linked metadata without .git.
125
- const head = await abortable(() => lstat(join(directory, "HEAD")).catch(nullIfMissingPath), signal);
126
- if ((head?.isFile() || head?.isSymbolicLink()) &&
127
- ((await present("commondir")) ||
128
- ((await present("objects")) && (await present("refs")))))
129
- roots.push(directory);
130
- const parent = dirname(directory);
131
- if (parent === directory)
132
- return roots;
133
- directory = parent;
134
- }
141
+ function matchingRemote(left, right) {
142
+ return (left.key === right.key &&
143
+ (left.homeRelative === undefined ||
144
+ right.homeRelative === undefined ||
145
+ left.homeRelative === right.homeRelative) &&
146
+ ((left.homeRelative === false && right.homeRelative === false) ||
147
+ left.account === undefined ||
148
+ right.account === undefined ||
149
+ left.account === right.account));
135
150
  }
136
- async function metadataPointer(path, prefix, context, signal) {
137
- const metadata = await abortable(() => stat(path).catch(nullIfMissingPath), signal);
138
- if (!metadata?.isFile())
139
- return undefined;
140
- const text = await abortable(() => readFile(path, "utf8"), signal);
141
- if (!text.startsWith(prefix) || (prefix === "" && text.length === 0))
142
- return undefined;
143
- const payload = text.slice(prefix.length).replace(/[\r\n]+$/u, "");
144
- if (prefix !== "" && payload.length === 0)
145
- return undefined;
146
- // Git checks emptiness before consuming the path as a NUL-terminated string.
147
- const value = payload.split("\0", 1)[0];
148
- // Preserve filesystem traversal through links before '..'.
149
- let target = isAbsolute(value) ? value : `${dirname(path)}${sep}${value}`;
150
- if (process.platform === "win32") {
151
- const drive = /^[A-Za-z]:(?![\\/])/u.exec(value)?.[0].toUpperCase();
152
- if (drive !== undefined) {
153
- const directory = context.directory.slice(0, 2).toUpperCase() === drive
154
- ? context.directory
155
- : environmentEntry(context.environment, `=${drive}`) || `${drive}\\`;
156
- target = resolve(directory, value.slice(2));
157
- }
158
- else if (isAbsolute(value))
159
- target = resolve(context.directory, value);
160
- }
161
- return ((await abortable(() => realpath(target).catch(nullIfMissingPath), signal)) ?? undefined);
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)));
162
161
  }
163
- async function associatedMetadataRoots(directory, context, signal, configurationDirectory) {
164
- const head = await abortable(() => lstat(join(directory, "HEAD")).catch(nullIfMissingPath), signal);
165
- if (!head || (!head.isFile() && !head.isSymbolicLink()))
166
- return [];
167
- const commonMarker = join(directory, "commondir");
168
- const hasCommon = await abortable(() => lstat(commonMarker).catch(nullIfMissingPath), signal);
169
- const common = hasCommon
170
- ? await metadataPointer(commonMarker, "", context, signal)
171
- : undefined;
172
- if (hasCommon && common === undefined)
173
- return [];
174
- const storage = common ?? directory;
175
- for (const name of ["objects", "refs"]) {
176
- const metadata = await abortable(() => stat(join(storage, name)).catch(nullIfMissingPath), signal);
177
- if (!metadata?.isDirectory())
178
- return [];
179
- }
180
- const roots = common === undefined ? [directory] : [directory, common];
181
- if (process.platform === "win32" &&
182
- configurationDirectory !== undefined &&
183
- configurationDirectory !== context.directory) {
184
- // Git rereads commondir after changing to the discovered repository root.
185
- roots.push(...(await associatedMetadataRoots(directory, {
186
- ...context,
187
- directory: await abortable(() => canonicalConfigPath(configurationDirectory), signal),
188
- }, signal)));
189
- }
190
- return roots;
162
+ function fetchAliasMatchers(rows, key) {
163
+ return new Map(Array.from(Map.groupBy(rows, key), ([name, group]) => [name, fetchAliasMatcher(group)]));
191
164
  }
192
- async function localGitProtectionRoots(repository, environment, signal) {
193
- const roots = new Set(await abortable(() => gitProtectionRoots(repository, signal), signal));
194
- const context = {
195
- directory: await abortable(() => canonicalConfigPath(repository), signal),
196
- environment,
197
- };
198
- const paths = new Set([resolve(repository), context.directory]);
199
- for (const path of paths) {
200
- for (const root of await bareMetadataRoots(path, signal)) {
201
- roots.add(root);
202
- for (const associated of await associatedMetadataRoots(root, context, signal, root))
203
- roots.add(associated);
165
+ /** A credential-free Sonar repository binding from a supported Git fetch transport. */
166
+ export function sonarRepositoryForRemote(origin) {
167
+ try {
168
+ if (/[\s\\\p{Cc}?#]/u.test(origin))
169
+ return;
170
+ const remote = parseGitRemote(origin);
171
+ if (!remote)
172
+ return;
173
+ const { url } = remote;
174
+ // Git dispatches remote helpers by the literal scheme, while URL lowercases it.
175
+ if (!remote.scpStyle && !origin.startsWith(url.protocol + "//"))
176
+ return;
177
+ // Git passes literal SSH paths to upload-pack. URL.pathname collapses dot segments.
178
+ const path = remote.scpStyle
179
+ ? remote.path
180
+ : /^[^:/]+:\/\/[^/]+\/(.+)$/u.exec(origin)?.[1];
181
+ if (!path)
182
+ return;
183
+ const hostname = url.hostname.toLowerCase();
184
+ let candidate;
185
+ if (url.protocol === "http:" || url.protocol === "https:") {
186
+ candidate = `${url.origin}/${path}`;
204
187
  }
205
- let directory = path;
206
- for (;;) {
207
- signal?.throwIfAborted();
208
- const marker = join(directory, ".git");
209
- const metadata = await abortable(() => stat(marker).catch(nullIfMissingPath), signal);
210
- if (metadata !== null) {
211
- roots.add(directory);
212
- const gitDirectory = metadata.isDirectory()
213
- ? await abortable(() => realpath(marker), signal)
214
- : await metadataPointer(marker, "gitdir: ", context, signal);
215
- if (gitDirectory !== undefined)
216
- for (const associated of await associatedMetadataRoots(gitDirectory, context, signal, directory))
217
- roots.add(associated);
218
- }
219
- const parent = dirname(directory);
220
- if (parent === directory)
221
- break;
222
- directory = parent;
188
+ else if (url.username === "git" && isGitHubSshOverHttps(url)) {
189
+ candidate = `https://github.com/${path}`;
190
+ }
191
+ else if (isGitSsh(url.protocol) &&
192
+ url.username === "git" &&
193
+ (!url.port || url.port === "22") &&
194
+ isPublicGitHost(hostname)) {
195
+ candidate = `https://${hostname}/${path}`;
223
196
  }
197
+ else {
198
+ candidate = azureReposHttpsUrl(url, path);
199
+ }
200
+ if (!candidate)
201
+ return;
202
+ const source = declaredScannerRepositoryUrl(candidate.replace(/\.git$/iu, ""), "Sonar", "local");
203
+ const candidateRemote = remoteRepository(origin, "sonar", true);
204
+ const target = remoteRepository(source, "sonar", true);
205
+ if (isGitSsh(url.protocol) && candidateRemote?.account !== "git")
206
+ return;
207
+ return candidateRemote && target && matchingRemote(candidateRemote, target)
208
+ ? source
209
+ : undefined;
210
+ }
211
+ catch {
212
+ return undefined;
224
213
  }
225
- for (const root of [...roots])
226
- roots.add(await abortable(() => canonicalConfigPath(root), signal));
227
- return [...roots];
228
214
  }
229
- async function hasGitMetadata(repository, signal) {
230
- return ((await abortable(() => gitMarkerRoot(repository, signal, "nearest"), signal)) !== null || (await bareMetadataRoots(repository, signal)).length !== 0);
215
+ /** Use the same executable and configuration boundaries for every Git query proving a binding. */
216
+ export function boundSonarWorktree(repository, protectedRoots, environment, signal) {
217
+ return enclosingGitWorktreeRoot(repository, signal, {
218
+ requireIfPresent: true,
219
+ readGit: (directory, args) => gitOutput(directory, args, signal, undefined, undefined, "utf8", protectedRoots, environment),
220
+ });
231
221
  }
232
- async function requireMatchingRepository(repository, provider, sources, protectedRoots, environment, signal) {
233
- if (sources.length === 0)
234
- return;
222
+ function localRepositoryPlatform(provider, sources, bound) {
223
+ const githubKey = (url) => remoteRepository(url, provider, bound, "github")?.key;
224
+ const githubRepositories = new Set(sources.flatMap((source) => {
225
+ if (source.platform !== "github")
226
+ return [];
227
+ const key = githubKey(source.url);
228
+ return key === undefined ? [] : [key];
229
+ }));
230
+ return (source) => {
231
+ if (source.platform === "github")
232
+ return "github";
233
+ if (githubRepositories.size === 0)
234
+ return provider;
235
+ const key = githubKey(source.url);
236
+ return key !== undefined && githubRepositories.has(key)
237
+ ? "github"
238
+ : provider;
239
+ };
240
+ }
241
+ function sameScannerRepositories(remotes) {
242
+ let known;
243
+ for (const remote of remotes) {
244
+ if (known && !matchingRemote(known, remote))
245
+ return false;
246
+ // HTTPS does not specify the login or path interpretation carried by SSH.
247
+ known = {
248
+ key: remote.key,
249
+ account: remote.account ?? known?.account,
250
+ homeRelative: remote.homeRelative ?? known?.homeRelative,
251
+ };
252
+ }
253
+ return true;
254
+ }
255
+ /** @internal Effective fetch URLs from the selected, protected checkout. */
256
+ export async function configuredFetchRemotes(repository, provider, protectedRoots, environment, signal) {
235
257
  if (!(await hasGitMetadata(repository, signal)))
236
- return;
258
+ return [];
237
259
  const gitProtectedRoots = [
238
260
  ...(typeof protectedRoots === "string"
239
261
  ? [protectedRoots]
240
262
  : (protectedRoots ?? [])),
241
- await abortable(() => canonicalConfigPath(process.cwd()), signal),
242
263
  ];
264
+ // The Sonar caller includes the discovered Git roots for both checkouts.
265
+ if (provider !== "sonar")
266
+ gitProtectedRoots.push(await abortable(() => canonicalConfigPath(process.cwd()), signal));
267
+ if (provider === "sonar" &&
268
+ !(await boundSonarWorktree(repository, gitProtectedRoots, environment, signal)))
269
+ return [];
243
270
  const readGit = (args) => abortable(() => gitOutput(repository, args, signal, { LC_ALL: "C" }, undefined, "utf8", gitProtectedRoots, environment), signal);
244
- let remoteNames;
245
- try {
246
- remoteNames = await readGit(["remote"]);
247
- }
248
- catch (error) {
249
- signal?.throwIfAborted();
250
- // A local source directory need not be a Git checkout.
251
- if (error instanceof Error &&
252
- "code" in error &&
253
- error.code === 128 &&
254
- "stderr" in error &&
255
- typeof error.stderr === "string" &&
256
- (error.stderr.trimEnd() ===
257
- "fatal: not a git repository (or any of the parent directories): .git" ||
258
- /^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())))
259
- return;
260
- throw error;
261
- }
271
+ const remoteNames = await readGitRemoteNames(readGit, signal);
272
+ if (remoteNames === undefined)
273
+ return [];
262
274
  const remotes = [];
275
+ const firstUrlOnly = provider === "sonar" || provider === "checkmarx";
263
276
  for (const name of remoteNames.split(/\r?\n/u).filter(Boolean)) {
264
- const urls = await readGit(["remote", "get-url", "--all", "--", name]);
265
- remotes.push(...urls.split(/\r?\n/u));
277
+ if (firstUrlOnly) {
278
+ // Git fetches from only the first URL, after insteadOf rewrites.
279
+ const url = await readGit(["remote", "get-url", "--", name]);
280
+ if (/[\r\n]/u.test(url))
281
+ throw new CodexSecurityError("A configured Git remote URL contains a line break. Configure each fetch URL as a separate Git value.");
282
+ remotes.push({ name, url });
283
+ }
284
+ else {
285
+ const urls = await readGit(["remote", "get-url", "--all", "--", name]);
286
+ for (const url of urls.split(/\r?\n/u))
287
+ remotes.push({ name, url });
288
+ }
289
+ }
290
+ return remotes;
291
+ }
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)
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;
319
+ const remotes = fetchRemotes ??
320
+ (await configuredFetchRemotes(repository, remoteProvider(Boolean(isCheckmarxSource)), protectedRoots, environment, signal));
321
+ const boundProvider = provider === "sonar" ||
322
+ provider === "checkmarx" ||
323
+ provider === "continuum" ||
324
+ provider === "inspector" ||
325
+ provider === "blackduck" ||
326
+ provider === "veracode";
327
+ const comparable = [];
328
+ const unverified = [];
329
+ for (const { url: remote } of remotes) {
330
+ const verified = provider === "sonar" ? sonarRepositoryForRemote(remote) : remote;
331
+ if (verified)
332
+ comparable.push(verified);
333
+ else if (!/[\s\\\p{Cc}?#]/u.test(remote))
334
+ unverified.push(remote);
266
335
  }
267
- const identity = (value, platform) => remoteRepository(value, platform, provider === "inspector");
268
- const githubRepositories = new Set(sources.flatMap((source) => {
269
- if (source.platform !== "github")
270
- return [];
271
- const key = identity(source.url, "github")?.key;
272
- return key === undefined ? [] : [key];
273
- }));
274
336
  for (const source of sources) {
275
- const githubKey = identity(source.url, "github")?.key;
276
- const sourceProvider = source.platform === "github" ||
277
- (githubKey !== undefined && githubRepositories.has(githubKey))
278
- ? "github"
279
- : provider;
280
- const targets = remotes.flatMap((remote) => identity(remote, sourceProvider) ?? []);
281
- if (!targets.length)
337
+ const bound = boundProvider || strictSources.has(source.url);
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);
341
+ const targets = comparable.flatMap((remote) => identity(remote) ?? []);
342
+ const target = identity(source.url);
343
+ if (target && targets.some((remote) => matchingRemote(remote, target)))
344
+ continue;
345
+ allSourcesMatched = false;
346
+ // A custom SSH upstream can agree with a manual mapping even when a
347
+ // recognized HTTPS remote points at a fork. It cannot prove a Cloud binding.
348
+ const configured = unverified.flatMap((remote) => identity(remote, possibleSshHost) ?? []);
349
+ if (target && configured.some((remote) => matchingRemote(remote, target)))
282
350
  continue;
283
- const target = identity(source.url, sourceProvider);
284
- if (!target ||
285
- !targets.some(({ key, account, homeRelative }) => key === target.key &&
286
- (homeRelative === undefined ||
287
- target.homeRelative === undefined ||
288
- homeRelative === target.homeRelative) &&
289
- ((homeRelative === false && target.homeRelative === false) ||
290
- account === undefined ||
291
- target.account === undefined ||
292
- account === target.account)))
351
+ if (targets.length || configured.length)
293
352
  throw new CodexSecurityError(`Imported repository ${JSON.stringify(source.url)} does not match a configured remote of ${repository}. Select the matching local repository.`);
294
353
  }
354
+ return allSourcesMatched;
355
+ }
356
+ export function sonarCheckoutMatchesSource(repository, url, protectedRoots, environment, signal) {
357
+ return requireMatchingRepository(repository, "sonar", [{ url }], new Map(), [], () => "sonar", undefined, [...protectedRoots], environment, signal);
295
358
  }
296
359
  async function localContext(selectedRepository, dependencies, mode = "import") {
297
360
  dependencies.signal?.throwIfAborted();
298
- const selected = dependencies.environment ?? process.env;
299
- const environment = workbenchEnvironment(selected);
300
- forwardExternalImportSetting(selected, environment);
301
- requireExternalImports(environment);
361
+ const environment = workbenchEnvironment(dependencies.environment ?? process.env);
302
362
  const path = expandHome(selectedRepository, environment);
303
363
  const repository = mode === "read"
304
364
  ? await abortable(() => canonicalConfigPath(path), dependencies.signal)
@@ -306,8 +366,7 @@ async function localContext(selectedRepository, dependencies, mode = "import") {
306
366
  const protectedRoot = [
307
367
  ...new Set([
308
368
  repository,
309
- ...(await abortable(() => localGitProtectionRoots(path, environment, dependencies.signal), dependencies.signal)),
310
- ...(await abortable(() => localGitProtectionRoots(process.cwd(), environment, dependencies.signal), dependencies.signal)),
369
+ ...(await abortable(() => commandGitProtectionRoots(path, environment, dependencies.signal), dependencies.signal)),
311
370
  ]),
312
371
  ];
313
372
  requireOutputOutsideRepositories(protectedRoot, await abortable(() => canonicalizeModelSafePath(environment.CODEX_SECURITY_STATE_DIR), dependencies.signal), "runtime");
@@ -325,14 +384,41 @@ async function localContext(selectedRepository, dependencies, mode = "import") {
325
384
  /** Prepare scanner evidence without writing state or performing a security assessment. */
326
385
  export async function prepareNormalizedLocalImport(input, options, dependencies = {}) {
327
386
  dependencies.signal?.throwIfAborted();
328
- requireExternalImports(dependencies.environment);
329
387
  return prepareLocalImport(input, snapshotImportOptions(options), dependencies);
330
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
+ }
331
401
  /** @internal Prepare evidence using settings captured by either local import entrypoint. */
332
- export async function prepareLocalImport(input, options, dependencies) {
402
+ export async function prepareLocalImport(input, options, dependencies, readerSources = distinctSourceRepositories(snapshotSourceRepositories(dependencies.sourceRepositories)), parsedInput = [], fetchRemotes) {
333
403
  requireIdentity(options.sourceKey, "Source key");
334
- const current = structuredClone(input);
335
- validateExternalReport(current.report);
404
+ const parsedSources = distinctSourceRepositories(parsedInput);
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
+ }
336
422
  let dependabotSource;
337
423
  const identities = new Set();
338
424
  for (const finding of current.findings) {
@@ -342,6 +428,7 @@ export async function prepareLocalImport(input, options, dependencies) {
342
428
  identities.add(finding.source_finding_id);
343
429
  if (!isRecord(finding.evidence))
344
430
  throw new CodexSecurityError("Imported evidence must be an object.");
431
+ checkRetainedTrivyProvider(options.provider, finding, "local");
345
432
  if (options.provider !== "github")
346
433
  continue;
347
434
  const native = dependabotRepository(finding);
@@ -355,39 +442,336 @@ export async function prepareLocalImport(input, options, dependencies) {
355
442
  throw new CodexSecurityError("Select Dependabot alerts from only one GitHub host and repository.");
356
443
  dependabotSource = native;
357
444
  }
358
- 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;
359
457
  const sources = new Map();
458
+ const references = [...readerSources, ...parsedSources];
459
+ const inspector = inspectorReportRepository(options.provider, current.findings, "local", options.inspectorProjectMap);
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));
464
+ const mixed = projected.length > 0 && readerSources.length > 0;
465
+ const nativeSources = new Map((mixed ? current.findings : projected)
466
+ .filter(({ evidence }) => options.provider !== "endor" ||
467
+ isRecord(evidence.source_data?.["runContext"]))
468
+ .map((finding) => [
469
+ finding,
470
+ localFindingRepositories(options.provider, finding),
471
+ ]));
472
+ const platformFor = localRepositoryPlatform(options.provider, options.inspectorProjectMap
473
+ ? []
474
+ : [
475
+ ...references,
476
+ ...Array.from(nativeSources.values()).flat(),
477
+ ...(inspector ? [inspector] : []),
478
+ ], true);
479
+ const identify = (url) => remoteRepository(url, options.provider, true, platformFor({ url })) ?? {
480
+ key: url,
481
+ };
482
+ // A hint from an independent reader applies across projected rows. A native
483
+ // GitHub asset in one row only identifies the platform of that row's claims.
484
+ const operatorPlatform = localRepositoryPlatform(options.provider, readerSources, true);
485
+ const sameRepositories = (urls) => sameScannerRepositories(Array.from(urls, identify));
486
+ const bound = blackDuckReportRepositories(options.provider, current.findings, "local", sameRepositories);
487
+ const checkmarxRepository = checkmarx.repositories(sameRepositories);
488
+ for (const repositories of [
489
+ veracodeReportRepositories,
490
+ continuumReportRepositories,
491
+ ]) {
492
+ for (const source of repositories(options.provider, current.findings, "local", sameRepositories).values()) {
493
+ sources.set(source.url, source);
494
+ }
495
+ }
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);
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;
360
532
  for (const finding of current.findings) {
361
- const url = finding.evidence.details?.repository?.url;
362
- if (url)
363
- sources.set(url, { url });
533
+ const retained = bound.get(finding.source_finding_id) ?? checkmarxRepository(finding);
534
+ const native = nativeSources.get(finding) ?? [];
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;
585
+ const claims = [
586
+ ...rowSources.map((ref) => ref.url),
587
+ ...(url ? [url] : []),
588
+ ];
589
+ const rowPlatform = (claim) => options.provider !== "wiz"
590
+ ? platformFor({ url: claim })
591
+ : native.some((source) => source.platform === "github")
592
+ ? "github"
593
+ : operatorPlatform({ url: claim });
594
+ if (!sameScannerRepositories(claims.map((claim) => remoteRepository(claim, options.provider, true, rowPlatform(claim)) ?? {
595
+ key: claim,
596
+ })))
597
+ throw new CodexSecurityError("The retained scanner repository does not match the original provider finding.");
598
+ for (const source of rowSources)
599
+ sources.set(source.url, source);
600
+ for (const claim of claims) {
601
+ if (projectedCheckmarx)
602
+ checkmarxKeys.add(identify(claim).key);
603
+ const platform = rowPlatform(claim);
604
+ if (!strictSources.has(claim) || platform !== "github")
605
+ strictSources.set(claim, platform);
606
+ }
607
+ }
608
+ for (const source of native)
609
+ known.add(source.url);
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
+ }
652
+ if (mixed) {
653
+ // Other caller references must identify an ordinary row or one of its Git aliases.
654
+ const rows = [...sources.keys(), ...known].map(identify);
655
+ const byKey = Map.groupBy(rows, (remote) => remote.key);
656
+ const represented = new Set(rows.map((remote) => JSON.stringify(remote)));
657
+ const aliases = readerSources
658
+ .filter((ref) => !hostedReferences.has(ref) || sharedReferences.has(ref))
659
+ .map(({ url }) => identify(url))
660
+ .filter((remote) => !represented.has(JSON.stringify(remote)));
661
+ for (const [key, group] of Map.groupBy(aliases, (remote) => remote.key)) {
662
+ const candidates = byKey.get(key);
663
+ if (!candidates || !sameScannerRepositories([...candidates, ...group]))
664
+ throw new CodexSecurityError("Reader repository does not match a source in the normalized findings.");
665
+ }
666
+ }
667
+ if (strictSources.size && options.provider !== "blackduck") {
668
+ const keys = new Set(Array.from(strictSources.keys(), (url) => identify(url).key));
669
+ for (const source of references)
670
+ if (!strictSources.has(source.url) &&
671
+ keys.has(identify(source.url).key)) {
672
+ strictSources.set(source.url, platformFor(source));
673
+ if (sharedReferences.has(source))
674
+ ordinaryReferences.add(source);
675
+ }
364
676
  }
365
- const inspector = inspectorReportRepository(options.provider, current.findings, "local", options.inspectorProjectMap);
366
677
  if (inspector) {
367
- const platform = inspector.platform ?? options.provider;
368
- const native = remoteRepository(inspector.url, platform, true);
678
+ const platform = inspector.platform === "github" ? "github" : options.provider;
679
+ const native = remoteRepository(inspector.url, options.provider, true, platform);
369
680
  for (const url of sources.keys()) {
370
- if (!native || remoteRepository(url, platform, true)?.key !== native.key)
681
+ if (!native ||
682
+ remoteRepository(url, options.provider, true, platform)?.key !==
683
+ native.key)
371
684
  throw new CodexSecurityError(`Imported repository ${JSON.stringify(url)} does not match the retained Inspector repository ${JSON.stringify(inspector.url)}.`);
372
685
  }
373
686
  }
374
- for (const source of [
375
- ...(inspector ? [inspector] : []),
376
- ...(dependencies.sourceRepositories ?? []),
377
- ]) {
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.");
693
+ for (const source of [...(inspector ? [inspector] : []), ...references]) {
694
+ if (!ordinaryRowNeedsReferences &&
695
+ hostedReferences.has(source) &&
696
+ !ordinaryReferences.has(source))
697
+ continue;
378
698
  // A reader's platform must not loosen an operator-supplied Inspector map.
379
699
  if (sources.get(source.url)?.platform !== "github")
380
700
  sources.set(source.url, options.inspectorProjectMap ? { url: source.url } : source);
381
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.");
715
+ const sonarSources = sonarRepositoryUrls(options.provider, current.findings, current.report, "local");
716
+ const manualSource = options.provider === "sonar" && options.sourceRepositoryUrl
717
+ ? declaredScannerRepositoryUrl(options.sourceRepositoryUrl, "Sonar", "local")
718
+ : undefined;
719
+ if (manualSource)
720
+ sonarSources.add(manualSource);
721
+ for (const url of sonarSources)
722
+ if (!sources.has(url))
723
+ sources.set(url, { url });
724
+ if (sonarSources.size && !sameRepositories(sources.keys()))
725
+ throw new CodexSecurityError(manualSource
726
+ ? "The Sonar evidence does not match the declared source repository."
727
+ : "The retained Sonar repository does not match the other source repository claims.");
728
+ if (options.provider === "blackduck" &&
729
+ current.findings.length &&
730
+ sources.size > 1 &&
731
+ !sameScannerRepositories(Array.from(sources.keys(), identify)))
732
+ throw new CodexSecurityError("Black Duck occurrences must belong to the same project version and source repository.");
382
733
  if (dependabotSource)
383
734
  sources.set(dependabotSource, {
384
735
  url: dependabotSource,
385
736
  platform: "github",
386
737
  });
387
- await requireMatchingRepository(repository, options.provider, [...sources.values()], workbenchOptions.protectedRoot, workbenchOptions.environment, dependencies.signal);
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);
763
+ const selected = manualSource ? new URL(manualSource) : undefined;
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) {
388
772
  dependencies.signal?.throwIfAborted();
389
773
  const preview = {
390
- ...structuredClone(current),
774
+ ...cloneImportPreview(current),
391
775
  repository,
392
776
  source: { provider: options.provider, source_key: options.sourceKey },
393
777
  };
@@ -395,18 +779,35 @@ export async function prepareLocalImport(input, options, dependencies) {
395
779
  repository,
396
780
  provider: options.provider,
397
781
  sourceKey: options.sourceKey,
398
- findings: current.findings,
399
- }, (_key, value) => {
400
- if (isNumberObject(value))
401
- value = +value;
402
- if (typeof value === "number" && !Number.isFinite(value))
403
- throw new TypeError("Stored finding JSON cannot contain non-finite numbers.");
404
- return value;
782
+ findings: current.findings.map(({ source_finding_id, evidence }) => ({
783
+ source_finding_id,
784
+ evidence,
785
+ })),
405
786
  });
406
787
  return {
788
+ matchesRepositoryRemote,
407
789
  preview,
408
790
  async import() {
409
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
+ }
410
811
  const protectedRoot = [
411
812
  ...new Set([
412
813
  ...workbenchOptions.protectedRoot,
@@ -419,13 +820,7 @@ export async function prepareLocalImport(input, options, dependencies) {
419
820
  return (dependencies.runWorkbench ?? runWorkbench)({ ...workbenchOptions, protectedRoot }, ["store-external-findings"], payload);
420
821
  }, dependencies.signal);
421
822
  return {
422
- repository,
423
- read: current.read,
424
- ...(current.report === undefined
425
- ? {}
426
- : { report: structuredClone(current.report) }),
427
- ready: current.findings.length,
428
- excluded: structuredClone(current.excluded),
823
+ ...summary,
429
824
  findings: result["findings"],
430
825
  counts: result["counts"],
431
826
  };
@@ -435,7 +830,6 @@ export async function prepareLocalImport(input, options, dependencies) {
435
830
  /** Read imported source records, including evidence that has not been assessed by Codex. */
436
831
  export async function listLocalExternalFindings(selection, dependencies = {}) {
437
832
  dependencies.signal?.throwIfAborted();
438
- requireExternalImports(dependencies.environment);
439
833
  if (selection.id !== undefined)
440
834
  requireIdentity(selection.id, "Finding id");
441
835
  const { repository, options } = await localContext(selection.repository, dependencies, "read");