@openai/codex-security 0.8.3 → 0.10.0

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 (658) hide show
  1. package/README.md +36 -746
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +7 -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 +5 -2
  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/baseline-auditor.md +18 -0
  26. package/_bundled_plugin/references/core-scan.md +5 -42
  27. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  28. package/_bundled_plugin/references/final-report.md +5 -3
  29. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  30. package/_bundled_plugin/references/focused-investigator.md +13 -0
  31. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  32. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  33. package/_bundled_plugin/references/scan-contract.md +27 -33
  34. package/_bundled_plugin/references/scan-prologue.md +2 -2
  35. package/_bundled_plugin/references/scan-runtime.md +4 -2
  36. package/_bundled_plugin/references/security-guidance.md +14 -1
  37. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  38. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  39. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  40. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  41. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  42. package/_bundled_plugin/scripts/deep_scan_workbench.py +192 -352
  43. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  44. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  45. package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
  46. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  47. package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
  48. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  49. package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
  50. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  51. package/_bundled_plugin/scripts/report_projection.py +81 -43
  52. package/_bundled_plugin/scripts/review_state.py +8 -2
  53. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  54. package/_bundled_plugin/scripts/snapshot_sqlite.py +9 -2
  55. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  56. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  57. package/_bundled_plugin/scripts/windows_scan_local_files.py +582 -20
  58. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  59. package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
  60. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  61. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  62. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  63. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  64. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  65. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  66. package/_bundled_plugin/scripts/workbench/storage.py +91 -7
  67. package/_bundled_plugin/scripts/workbench_cli.py +54 -14
  68. package/_bundled_plugin/scripts/workbench_constants.py +12 -0
  69. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  70. package/_bundled_plugin/scripts/workbench_db.py +562 -303
  71. package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +238 -41
  75. package/_bundled_plugin/scripts/workbench_progress.py +169 -4
  76. package/_bundled_plugin/scripts/workbench_publication.py +16 -13
  77. package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
  82. package/_bundled_plugin/scripts/workbench_schema.py +258 -63
  83. package/_bundled_plugin/scripts/workbench_setup.py +14 -2
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  85. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  86. package/_bundled_plugin/scripts/workbench_target.py +594 -136
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
  88. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
  90. package/_bundled_plugin/shared/workbench-migrations.json +100 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  93. package/_bundled_plugin/skills/fix-finding/SKILL.md +2 -1
  94. package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
  95. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  96. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  97. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  98. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +409 -0
  99. package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
  100. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  104. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  105. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  106. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  107. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  108. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  110. package/bin/codex-security.mjs +2 -2
  111. package/dist/api.d.ts +45 -5
  112. package/dist/api.d.ts.map +1 -1
  113. package/dist/api.js +1192 -427
  114. package/dist/api.js.map +1 -1
  115. package/dist/armorcode-findings.d.ts +9 -0
  116. package/dist/armorcode-findings.d.ts.map +1 -0
  117. package/dist/armorcode-findings.js +145 -0
  118. package/dist/armorcode-findings.js.map +1 -0
  119. package/dist/artifact-export.d.ts +2 -0
  120. package/dist/artifact-export.d.ts.map +1 -1
  121. package/dist/artifact-export.js +29 -13
  122. package/dist/artifact-export.js.map +1 -1
  123. package/dist/auth.d.ts +6 -2
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +37 -18
  126. package/dist/auth.js.map +1 -1
  127. package/dist/batch-cost.d.ts +18 -0
  128. package/dist/batch-cost.d.ts.map +1 -0
  129. package/dist/batch-cost.js +41 -0
  130. package/dist/batch-cost.js.map +1 -0
  131. package/dist/bedrock-oss-pricing.d.ts +6 -0
  132. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  133. package/dist/bedrock-oss-pricing.js +58 -0
  134. package/dist/bedrock-oss-pricing.js.map +1 -0
  135. package/dist/bedrock-pricing.d.ts +15 -0
  136. package/dist/bedrock-pricing.d.ts.map +1 -0
  137. package/dist/bedrock-pricing.js +117 -0
  138. package/dist/bedrock-pricing.js.map +1 -0
  139. package/dist/blackduck-findings.d.ts +1 -1
  140. package/dist/blackduck-findings.d.ts.map +1 -1
  141. package/dist/blackduck-findings.js +24 -22
  142. package/dist/blackduck-findings.js.map +1 -1
  143. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  144. package/dist/bulk-scan-discovery.js +4 -4
  145. package/dist/bulk-scan-discovery.js.map +1 -1
  146. package/dist/bundled-plugin.d.ts +4 -0
  147. package/dist/bundled-plugin.d.ts.map +1 -0
  148. package/dist/bundled-plugin.js +23 -0
  149. package/dist/bundled-plugin.js.map +1 -0
  150. package/dist/checkmarx-evidence.d.ts +19 -0
  151. package/dist/checkmarx-evidence.d.ts.map +1 -0
  152. package/dist/checkmarx-evidence.js +36 -0
  153. package/dist/checkmarx-evidence.js.map +1 -0
  154. package/dist/checkmarx-findings.d.ts +4 -0
  155. package/dist/checkmarx-findings.d.ts.map +1 -0
  156. package/dist/checkmarx-findings.js +27 -0
  157. package/dist/checkmarx-findings.js.map +1 -0
  158. package/dist/checkmarx-one.d.ts +4 -0
  159. package/dist/checkmarx-one.d.ts.map +1 -0
  160. package/dist/checkmarx-one.js +53 -0
  161. package/dist/checkmarx-one.js.map +1 -0
  162. package/dist/checkmarx-repository.d.ts +12 -0
  163. package/dist/checkmarx-repository.d.ts.map +1 -0
  164. package/dist/checkmarx-repository.js +181 -0
  165. package/dist/checkmarx-repository.js.map +1 -0
  166. package/dist/checkmarx-xml.d.ts +12 -0
  167. package/dist/checkmarx-xml.d.ts.map +1 -0
  168. package/dist/checkmarx-xml.js +196 -0
  169. package/dist/checkmarx-xml.js.map +1 -0
  170. package/dist/classify-scan-severity.d.ts +1 -1
  171. package/dist/classify-scan-severity.d.ts.map +1 -1
  172. package/dist/classify-scan-severity.js +11 -3
  173. package/dist/classify-scan-severity.js.map +1 -1
  174. package/dist/classify-severity-records.d.ts +1 -9
  175. package/dist/classify-severity-records.d.ts.map +1 -1
  176. package/dist/classify-severity-records.js +3 -13
  177. package/dist/classify-severity-records.js.map +1 -1
  178. package/dist/classify-severity.d.ts.map +1 -1
  179. package/dist/classify-severity.js +11 -10
  180. package/dist/classify-severity.js.map +1 -1
  181. package/dist/cli-argument.d.ts +4 -0
  182. package/dist/cli-argument.d.ts.map +1 -0
  183. package/dist/cli-argument.js +17 -0
  184. package/dist/cli-argument.js.map +1 -0
  185. package/dist/cli-help.d.ts +1 -1
  186. package/dist/cli-help.d.ts.map +1 -1
  187. package/dist/cli-help.js +71 -29
  188. package/dist/cli-help.js.map +1 -1
  189. package/dist/cli-hook.d.ts +3 -0
  190. package/dist/cli-hook.d.ts.map +1 -0
  191. package/dist/cli-hook.js +87 -0
  192. package/dist/cli-hook.js.map +1 -0
  193. package/dist/cli-integrations.d.ts +13 -0
  194. package/dist/cli-integrations.d.ts.map +1 -0
  195. package/dist/cli-integrations.js +333 -0
  196. package/dist/cli-integrations.js.map +1 -0
  197. package/dist/cli-mcp.d.ts +15 -0
  198. package/dist/cli-mcp.d.ts.map +1 -0
  199. package/dist/cli-mcp.js +178 -0
  200. package/dist/cli-mcp.js.map +1 -0
  201. package/dist/cli-token-view.d.ts +10 -0
  202. package/dist/cli-token-view.d.ts.map +1 -0
  203. package/dist/cli-token-view.js +41 -0
  204. package/dist/cli-token-view.js.map +1 -0
  205. package/dist/cli.d.ts +16 -8
  206. package/dist/cli.d.ts.map +1 -1
  207. package/dist/cli.js +3382 -2017
  208. package/dist/cli.js.map +1 -1
  209. package/dist/cloud-publish.d.ts.map +1 -1
  210. package/dist/cloud-publish.js +35 -33
  211. package/dist/cloud-publish.js.map +1 -1
  212. package/dist/codex-sdk-environment.d.ts +6 -0
  213. package/dist/codex-sdk-environment.d.ts.map +1 -1
  214. package/dist/codex-sdk-environment.js +19 -0
  215. package/dist/codex-sdk-environment.js.map +1 -1
  216. package/dist/command-words.d.ts +3 -0
  217. package/dist/command-words.d.ts.map +1 -0
  218. package/dist/command-words.js +46 -0
  219. package/dist/command-words.js.map +1 -0
  220. package/dist/component-scan.d.ts +19 -4
  221. package/dist/component-scan.d.ts.map +1 -1
  222. package/dist/component-scan.js +67 -9
  223. package/dist/component-scan.js.map +1 -1
  224. package/dist/config.d.ts +1 -1
  225. package/dist/config.d.ts.map +1 -1
  226. package/dist/config.js +130 -67
  227. package/dist/config.js.map +1 -1
  228. package/dist/continuum-findings.d.ts +1 -1
  229. package/dist/continuum-findings.d.ts.map +1 -1
  230. package/dist/continuum-findings.js +149 -19
  231. package/dist/continuum-findings.js.map +1 -1
  232. package/dist/contract-values.d.ts +2 -0
  233. package/dist/contract-values.d.ts.map +1 -1
  234. package/dist/contract-values.js +12 -9
  235. package/dist/contract-values.js.map +1 -1
  236. package/dist/cost-model.d.ts +13 -1
  237. package/dist/cost-model.d.ts.map +1 -1
  238. package/dist/cost-model.js +66 -112
  239. package/dist/cost-model.js.map +1 -1
  240. package/dist/cost.d.ts +42 -3
  241. package/dist/cost.d.ts.map +1 -1
  242. package/dist/cost.js +484 -149
  243. package/dist/cost.js.map +1 -1
  244. package/dist/custom-publish.d.ts +4 -0
  245. package/dist/custom-publish.d.ts.map +1 -1
  246. package/dist/custom-publish.js +40 -3
  247. package/dist/custom-publish.js.map +1 -1
  248. package/dist/custom-validation-prompt.d.ts +1 -1
  249. package/dist/custom-validation-prompt.d.ts.map +1 -1
  250. package/dist/custom-validation-prompt.js +29 -19
  251. package/dist/custom-validation-prompt.js.map +1 -1
  252. package/dist/deduplication/local.d.ts +4 -2
  253. package/dist/deduplication/local.d.ts.map +1 -1
  254. package/dist/deduplication/local.js +9 -2
  255. package/dist/deduplication/local.js.map +1 -1
  256. package/dist/deduplication/refusal.d.ts.map +1 -1
  257. package/dist/deduplication/refusal.js +26 -5
  258. package/dist/deduplication/refusal.js.map +1 -1
  259. package/dist/deduplication/scan.d.ts +5 -0
  260. package/dist/deduplication/scan.d.ts.map +1 -1
  261. package/dist/deduplication/scan.js +24 -7
  262. package/dist/deduplication/scan.js.map +1 -1
  263. package/dist/deep-config.d.ts +0 -1
  264. package/dist/deep-config.d.ts.map +1 -1
  265. package/dist/deep-config.js +22 -33
  266. package/dist/deep-config.js.map +1 -1
  267. package/dist/deep-scan-defaults.d.ts +2 -0
  268. package/dist/deep-scan-defaults.d.ts.map +1 -1
  269. package/dist/deep-scan-defaults.js +28 -1
  270. package/dist/deep-scan-defaults.js.map +1 -1
  271. package/dist/deep-scan.d.ts +2 -0
  272. package/dist/deep-scan.d.ts.map +1 -1
  273. package/dist/deep-scan.js +44 -19
  274. package/dist/deep-scan.js.map +1 -1
  275. package/dist/default-severity-rubric.d.ts +1 -1
  276. package/dist/default-severity-rubric.d.ts.map +1 -1
  277. package/dist/default-severity-rubric.js +1 -1
  278. package/dist/default-severity-rubric.js.map +1 -1
  279. package/dist/endor-findings.d.ts +3 -1
  280. package/dist/endor-findings.d.ts.map +1 -1
  281. package/dist/endor-findings.js +86 -45
  282. package/dist/endor-findings.js.map +1 -1
  283. package/dist/errors.d.ts +4 -2
  284. package/dist/errors.d.ts.map +1 -1
  285. package/dist/errors.js +15 -4
  286. package/dist/errors.js.map +1 -1
  287. package/dist/executable-path.d.ts +3 -0
  288. package/dist/executable-path.d.ts.map +1 -1
  289. package/dist/executable-path.js +26 -0
  290. package/dist/executable-path.js.map +1 -1
  291. package/dist/external-findings-import.d.ts +5 -3
  292. package/dist/external-findings-import.d.ts.map +1 -1
  293. package/dist/external-findings-import.js +19 -7
  294. package/dist/external-findings-import.js.map +1 -1
  295. package/dist/external-findings-local.d.ts +69 -5
  296. package/dist/external-findings-local.d.ts.map +1 -1
  297. package/dist/external-findings-local.js +537 -108
  298. package/dist/external-findings-local.js.map +1 -1
  299. package/dist/external-findings-publish.d.ts +13 -6
  300. package/dist/external-findings-publish.d.ts.map +1 -1
  301. package/dist/external-findings-publish.js +895 -1142
  302. package/dist/external-findings-publish.js.map +1 -1
  303. package/dist/external-findings-read.d.ts +21 -2
  304. package/dist/external-findings-read.d.ts.map +1 -1
  305. package/dist/external-findings-read.js +130 -68
  306. package/dist/external-findings-read.js.map +1 -1
  307. package/dist/external-findings.d.ts +15 -3
  308. package/dist/external-findings.d.ts.map +1 -1
  309. package/dist/external-findings.js +54 -2
  310. package/dist/external-findings.js.map +1 -1
  311. package/dist/external-import-contract.d.ts +8 -12
  312. package/dist/external-import-contract.d.ts.map +1 -1
  313. package/dist/external-import-contract.js +51 -184
  314. package/dist/external-import-contract.js.map +1 -1
  315. package/dist/external-import-models.d.ts +1 -1
  316. package/dist/external-import-models.d.ts.map +1 -1
  317. package/dist/external-import-models.js.map +1 -1
  318. package/dist/feedback.d.ts.map +1 -1
  319. package/dist/feedback.js +5 -4
  320. package/dist/feedback.js.map +1 -1
  321. package/dist/finding-prompt.d.ts +5 -0
  322. package/dist/finding-prompt.d.ts.map +1 -0
  323. package/dist/finding-prompt.js +32 -0
  324. package/dist/finding-prompt.js.map +1 -0
  325. package/dist/findings-client.d.ts +1 -0
  326. package/dist/findings-client.d.ts.map +1 -1
  327. package/dist/findings-client.js +27 -3
  328. package/dist/findings-client.js.map +1 -1
  329. package/dist/github-advisories.d.ts.map +1 -1
  330. package/dist/github-advisories.js +0 -2
  331. package/dist/github-advisories.js.map +1 -1
  332. package/dist/github-dependabot-findings.d.ts.map +1 -1
  333. package/dist/github-dependabot-findings.js +18 -8
  334. package/dist/github-dependabot-findings.js.map +1 -1
  335. package/dist/github-findings.d.ts +4 -1
  336. package/dist/github-findings.d.ts.map +1 -1
  337. package/dist/github-findings.js +73 -316
  338. package/dist/github-findings.js.map +1 -1
  339. package/dist/hosted-git-remotes.d.ts +5 -0
  340. package/dist/hosted-git-remotes.d.ts.map +1 -0
  341. package/dist/hosted-git-remotes.js +285 -0
  342. package/dist/hosted-git-remotes.js.map +1 -0
  343. package/dist/hosted-git-repository.d.ts +28 -0
  344. package/dist/hosted-git-repository.d.ts.map +1 -0
  345. package/dist/hosted-git-repository.js +222 -0
  346. package/dist/hosted-git-repository.js.map +1 -0
  347. package/dist/hosted-remediation.d.ts +1 -0
  348. package/dist/hosted-remediation.d.ts.map +1 -1
  349. package/dist/hosted-remediation.js +23 -3
  350. package/dist/hosted-remediation.js.map +1 -1
  351. package/dist/hosted-scan-protocol.js +2 -2
  352. package/dist/hosted-scan-protocol.js.map +1 -1
  353. package/dist/hosted-scan.d.ts.map +1 -1
  354. package/dist/hosted-scan.js +16 -11
  355. package/dist/hosted-scan.js.map +1 -1
  356. package/dist/hosted-scanner-http.d.ts +21 -0
  357. package/dist/hosted-scanner-http.d.ts.map +1 -0
  358. package/dist/hosted-scanner-http.js +204 -0
  359. package/dist/hosted-scanner-http.js.map +1 -0
  360. package/dist/import-scan.d.ts.map +1 -1
  361. package/dist/import-scan.js +3 -0
  362. package/dist/import-scan.js.map +1 -1
  363. package/dist/index.d.ts +21 -9
  364. package/dist/index.d.ts.map +1 -1
  365. package/dist/index.js +12 -3
  366. package/dist/index.js.map +1 -1
  367. package/dist/inspector-findings.d.ts.map +1 -1
  368. package/dist/inspector-findings.js +52 -86
  369. package/dist/inspector-findings.js.map +1 -1
  370. package/dist/knowledge-base.d.ts +1 -1
  371. package/dist/knowledge-base.d.ts.map +1 -1
  372. package/dist/knowledge-base.js +102 -32
  373. package/dist/knowledge-base.js.map +1 -1
  374. package/dist/linear.d.ts +11 -0
  375. package/dist/linear.d.ts.map +1 -1
  376. package/dist/linear.js.map +1 -1
  377. package/dist/local-git-metadata.d.ts +5 -2
  378. package/dist/local-git-metadata.d.ts.map +1 -1
  379. package/dist/local-git-metadata.js +8 -5
  380. package/dist/local-git-metadata.js.map +1 -1
  381. package/dist/multiscan.d.ts +10 -4
  382. package/dist/multiscan.d.ts.map +1 -1
  383. package/dist/multiscan.js +217 -102
  384. package/dist/multiscan.js.map +1 -1
  385. package/dist/native-json-findings.d.ts +2 -1
  386. package/dist/native-json-findings.d.ts.map +1 -1
  387. package/dist/native-json-findings.js +12 -2
  388. package/dist/native-json-findings.js.map +1 -1
  389. package/dist/opengrep-findings.d.ts +5 -2
  390. package/dist/opengrep-findings.d.ts.map +1 -1
  391. package/dist/opengrep-findings.js +54 -33
  392. package/dist/opengrep-findings.js.map +1 -1
  393. package/dist/operation-telemetry.d.ts +104 -0
  394. package/dist/operation-telemetry.d.ts.map +1 -0
  395. package/dist/operation-telemetry.js +293 -0
  396. package/dist/operation-telemetry.js.map +1 -0
  397. package/dist/plugin-python-probe.d.ts +4 -0
  398. package/dist/plugin-python-probe.d.ts.map +1 -0
  399. package/dist/plugin-python-probe.js +10 -0
  400. package/dist/plugin-python-probe.js.map +1 -0
  401. package/dist/private-finding-import.d.ts +99 -9
  402. package/dist/private-finding-import.d.ts.map +1 -1
  403. package/dist/private-finding-import.js +116 -152
  404. package/dist/private-finding-import.js.map +1 -1
  405. package/dist/project-config.d.ts.map +1 -1
  406. package/dist/project-config.js +53 -13
  407. package/dist/project-config.js.map +1 -1
  408. package/dist/prompt-files.d.ts +7 -2
  409. package/dist/prompt-files.d.ts.map +1 -1
  410. package/dist/prompt-files.js +42 -20
  411. package/dist/prompt-files.js.map +1 -1
  412. package/dist/provider-profile.d.ts +1 -1
  413. package/dist/provider-profile.d.ts.map +1 -1
  414. package/dist/provider-profile.js +12 -10
  415. package/dist/provider-profile.js.map +1 -1
  416. package/dist/publication-telemetry.d.ts +45 -0
  417. package/dist/publication-telemetry.d.ts.map +1 -0
  418. package/dist/publication-telemetry.js +50 -0
  419. package/dist/publication-telemetry.js.map +1 -0
  420. package/dist/publication.d.ts +1 -1
  421. package/dist/publication.d.ts.map +1 -1
  422. package/dist/publication.js.map +1 -1
  423. package/dist/publish.d.ts +4 -0
  424. package/dist/publish.d.ts.map +1 -1
  425. package/dist/publish.js +42 -2
  426. package/dist/publish.js.map +1 -1
  427. package/dist/record.d.ts +1 -5
  428. package/dist/record.d.ts.map +1 -1
  429. package/dist/record.js +3 -51
  430. package/dist/record.js.map +1 -1
  431. package/dist/remediation.d.ts +1 -4
  432. package/dist/remediation.d.ts.map +1 -1
  433. package/dist/remediation.js +6 -8
  434. package/dist/remediation.js.map +1 -1
  435. package/dist/request-metadata.d.ts +3 -0
  436. package/dist/request-metadata.d.ts.map +1 -1
  437. package/dist/request-metadata.js +9 -0
  438. package/dist/request-metadata.js.map +1 -1
  439. package/dist/result.d.ts +4 -0
  440. package/dist/result.d.ts.map +1 -1
  441. package/dist/result.js +1 -1
  442. package/dist/result.js.map +1 -1
  443. package/dist/retry-windows-rename.d.ts +8 -0
  444. package/dist/retry-windows-rename.d.ts.map +1 -0
  445. package/dist/retry-windows-rename.js +24 -0
  446. package/dist/retry-windows-rename.js.map +1 -0
  447. package/dist/runtime.d.ts +54 -6
  448. package/dist/runtime.d.ts.map +1 -1
  449. package/dist/runtime.js +1084 -256
  450. package/dist/runtime.js.map +1 -1
  451. package/dist/saved-scan-bootstrap.d.ts +7 -1
  452. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  453. package/dist/saved-scan-bootstrap.js +269 -114
  454. package/dist/saved-scan-bootstrap.js.map +1 -1
  455. package/dist/scan-activity.d.ts.map +1 -1
  456. package/dist/scan-activity.js +141 -56
  457. package/dist/scan-activity.js.map +1 -1
  458. package/dist/scan-archive-path.d.ts +2 -0
  459. package/dist/scan-archive-path.d.ts.map +1 -0
  460. package/dist/scan-archive-path.js +5 -0
  461. package/dist/scan-archive-path.js.map +1 -0
  462. package/dist/scan-comparison.d.ts +10 -5
  463. package/dist/scan-comparison.d.ts.map +1 -1
  464. package/dist/scan-comparison.js +66 -17
  465. package/dist/scan-comparison.js.map +1 -1
  466. package/dist/scan-dashboard.d.ts +7 -6
  467. package/dist/scan-dashboard.d.ts.map +1 -1
  468. package/dist/scan-dashboard.js +92 -43
  469. package/dist/scan-dashboard.js.map +1 -1
  470. package/dist/scan-executor.d.ts +10 -1
  471. package/dist/scan-executor.d.ts.map +1 -1
  472. package/dist/scan-executor.js +24 -2
  473. package/dist/scan-executor.js.map +1 -1
  474. package/dist/scan-history-renderer.d.ts +1 -0
  475. package/dist/scan-history-renderer.d.ts.map +1 -1
  476. package/dist/scan-history-renderer.js +34 -28
  477. package/dist/scan-history-renderer.js.map +1 -1
  478. package/dist/scan-logs.d.ts +12 -0
  479. package/dist/scan-logs.d.ts.map +1 -1
  480. package/dist/scan-logs.js +131 -78
  481. package/dist/scan-logs.js.map +1 -1
  482. package/dist/scan-measurement.d.ts +26 -0
  483. package/dist/scan-measurement.d.ts.map +1 -0
  484. package/dist/scan-measurement.js +77 -0
  485. package/dist/scan-measurement.js.map +1 -0
  486. package/dist/scan-progress.d.ts +1 -0
  487. package/dist/scan-progress.d.ts.map +1 -1
  488. package/dist/scan-progress.js +3 -0
  489. package/dist/scan-progress.js.map +1 -1
  490. package/dist/scan-sessions.d.ts.map +1 -1
  491. package/dist/scan-sessions.js +4 -1
  492. package/dist/scan-sessions.js.map +1 -1
  493. package/dist/scan-settings.d.ts +1 -1
  494. package/dist/scan-settings.d.ts.map +1 -1
  495. package/dist/scan-settings.js +1 -24
  496. package/dist/scan-settings.js.map +1 -1
  497. package/dist/scanner-import.d.ts +25 -13
  498. package/dist/scanner-import.d.ts.map +1 -1
  499. package/dist/scanner-import.js +216 -97
  500. package/dist/scanner-import.js.map +1 -1
  501. package/dist/scanner-repository-url.d.ts +4 -1
  502. package/dist/scanner-repository-url.d.ts.map +1 -1
  503. package/dist/scanner-repository-url.js +10 -6
  504. package/dist/scanner-repository-url.js.map +1 -1
  505. package/dist/security-policy.d.ts +1 -1
  506. package/dist/security-policy.d.ts.map +1 -1
  507. package/dist/security-policy.js +26 -6
  508. package/dist/security-policy.js.map +1 -1
  509. package/dist/semgrep-findings.d.ts +6 -3
  510. package/dist/semgrep-findings.d.ts.map +1 -1
  511. package/dist/semgrep-findings.js +72 -42
  512. package/dist/semgrep-findings.js.map +1 -1
  513. package/dist/semgrep-guardian-findings.d.ts +38 -0
  514. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  515. package/dist/semgrep-guardian-findings.js +165 -0
  516. package/dist/semgrep-guardian-findings.js.map +1 -0
  517. package/dist/semgrep-platform-collector.d.ts +26 -0
  518. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  519. package/dist/semgrep-platform-collector.js +108 -0
  520. package/dist/semgrep-platform-collector.js.map +1 -0
  521. package/dist/semgrep-platform-findings.d.ts +157 -6
  522. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  523. package/dist/semgrep-platform-findings.js +766 -103
  524. package/dist/semgrep-platform-findings.js.map +1 -1
  525. package/dist/server/api.d.ts +1 -1
  526. package/dist/server/api.d.ts.map +1 -1
  527. package/dist/server/api.js.map +1 -1
  528. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  529. package/dist/server/embedding-tokenizer.d.ts +2 -0
  530. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  531. package/dist/server/embedding-tokenizer.js +322 -0
  532. package/dist/server/embedding-tokenizer.js.map +6 -0
  533. package/dist/server/embeddings.d.ts +16 -2
  534. package/dist/server/embeddings.d.ts.map +1 -1
  535. package/dist/server/embeddings.js +35 -5
  536. package/dist/server/embeddings.js.map +1 -1
  537. package/dist/session-lines.d.ts +5 -0
  538. package/dist/session-lines.d.ts.map +1 -0
  539. package/dist/session-lines.js +60 -0
  540. package/dist/session-lines.js.map +1 -0
  541. package/dist/severity-review.d.ts +3 -1
  542. package/dist/severity-review.d.ts.map +1 -1
  543. package/dist/severity-review.js +3 -2
  544. package/dist/severity-review.js.map +1 -1
  545. package/dist/skill-authentication.d.ts +1 -0
  546. package/dist/skill-authentication.d.ts.map +1 -1
  547. package/dist/skill-authentication.js +1 -0
  548. package/dist/skill-authentication.js.map +1 -1
  549. package/dist/snyk-findings.d.ts +9 -2
  550. package/dist/snyk-findings.d.ts.map +1 -1
  551. package/dist/snyk-findings.js +90 -70
  552. package/dist/snyk-findings.js.map +1 -1
  553. package/dist/snyk-rest-findings.d.ts +59 -0
  554. package/dist/snyk-rest-findings.d.ts.map +1 -0
  555. package/dist/snyk-rest-findings.js +879 -0
  556. package/dist/snyk-rest-findings.js.map +1 -0
  557. package/dist/snyk-token-origin.d.ts +4 -0
  558. package/dist/snyk-token-origin.d.ts.map +1 -0
  559. package/dist/snyk-token-origin.js +82 -0
  560. package/dist/snyk-token-origin.js.map +1 -0
  561. package/dist/sonar-collector.d.ts.map +1 -1
  562. package/dist/sonar-collector.js +0 -3
  563. package/dist/sonar-collector.js.map +1 -1
  564. package/dist/sonar-findings.d.ts +1 -1
  565. package/dist/sonar-findings.d.ts.map +1 -1
  566. package/dist/sonar-findings.js +2 -4
  567. package/dist/sonar-findings.js.map +1 -1
  568. package/dist/sonar-import.d.ts +3 -0
  569. package/dist/sonar-import.d.ts.map +1 -1
  570. package/dist/sonar-import.js +30 -34
  571. package/dist/sonar-import.js.map +1 -1
  572. package/dist/stored-finding-projection.d.ts +6 -0
  573. package/dist/stored-finding-projection.d.ts.map +1 -0
  574. package/dist/stored-finding-projection.js +104 -0
  575. package/dist/stored-finding-projection.js.map +1 -0
  576. package/dist/stored-findings-publication.d.ts +23 -0
  577. package/dist/stored-findings-publication.d.ts.map +1 -0
  578. package/dist/stored-findings-publication.js +169 -0
  579. package/dist/stored-findings-publication.js.map +1 -0
  580. package/dist/target-drift.d.ts +9 -0
  581. package/dist/target-drift.d.ts.map +1 -0
  582. package/dist/target-drift.js +27 -0
  583. package/dist/target-drift.js.map +1 -0
  584. package/dist/targets.d.ts +8 -1
  585. package/dist/targets.d.ts.map +1 -1
  586. package/dist/targets.js +131 -42
  587. package/dist/targets.js.map +1 -1
  588. package/dist/tenable-findings.d.ts +6 -0
  589. package/dist/tenable-findings.d.ts.map +1 -0
  590. package/dist/tenable-findings.js +122 -0
  591. package/dist/tenable-findings.js.map +1 -0
  592. package/dist/terminal-stream.d.ts +13 -0
  593. package/dist/terminal-stream.d.ts.map +1 -0
  594. package/dist/terminal-stream.js +35 -0
  595. package/dist/terminal-stream.js.map +1 -0
  596. package/dist/trivy-findings.d.ts +19 -0
  597. package/dist/trivy-findings.d.ts.map +1 -0
  598. package/dist/trivy-findings.js +424 -0
  599. package/dist/trivy-findings.js.map +1 -0
  600. package/dist/trivy-import.d.ts +19 -0
  601. package/dist/trivy-import.d.ts.map +1 -0
  602. package/dist/trivy-import.js +151 -0
  603. package/dist/trivy-import.js.map +1 -0
  604. package/dist/trusted-executable.d.ts +6 -0
  605. package/dist/trusted-executable.d.ts.map +1 -1
  606. package/dist/trusted-executable.js +140 -37
  607. package/dist/trusted-executable.js.map +1 -1
  608. package/dist/validation-records.js +1 -1
  609. package/dist/validation-records.js.map +1 -1
  610. package/dist/veracode-findings.d.ts +1 -1
  611. package/dist/veracode-findings.d.ts.map +1 -1
  612. package/dist/veracode-findings.js +19 -6
  613. package/dist/veracode-findings.js.map +1 -1
  614. package/dist/version.d.ts +3 -1
  615. package/dist/version.d.ts.map +1 -1
  616. package/dist/version.js +184 -32
  617. package/dist/version.js.map +1 -1
  618. package/dist/vertex-pricing.d.ts +8 -0
  619. package/dist/vertex-pricing.d.ts.map +1 -0
  620. package/dist/vertex-pricing.js +20 -0
  621. package/dist/vertex-pricing.js.map +1 -0
  622. package/dist/windows-path.d.ts +1 -0
  623. package/dist/windows-path.d.ts.map +1 -1
  624. package/dist/windows-path.js +26 -1
  625. package/dist/windows-path.js.map +1 -1
  626. package/dist/wiz-findings.d.ts +6 -2
  627. package/dist/wiz-findings.d.ts.map +1 -1
  628. package/dist/wiz-findings.js +65 -89
  629. package/dist/wiz-findings.js.map +1 -1
  630. package/docs/classify-severity-records.md +27 -12
  631. package/docs/cli.md +853 -639
  632. package/docs/dedupe-records.md +44 -24
  633. package/docs/findings-service.md +84 -44
  634. package/docs/hosted-remediation.md +27 -11
  635. package/docs/hosted-scans.md +50 -42
  636. package/docs/sdk.md +903 -0
  637. package/docs/telemetry.md +236 -0
  638. package/docs/validate-records.md +78 -44
  639. package/package.json +23 -16
  640. package/schemas/external-findings.schema.json +4 -1
  641. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  642. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  643. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  644. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  645. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  646. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  647. package/dist/external-imports-feature.d.ts +0 -6
  648. package/dist/external-imports-feature.d.ts.map +0 -1
  649. package/dist/external-imports-feature.js +0 -51
  650. package/dist/external-imports-feature.js.map +0 -1
  651. package/dist/finding-normalization.d.ts +0 -5
  652. package/dist/finding-normalization.d.ts.map +0 -1
  653. package/dist/finding-normalization.js +0 -155
  654. package/dist/finding-normalization.js.map +0 -1
  655. package/dist/reader-selection.d.ts +0 -13
  656. package/dist/reader-selection.d.ts.map +0 -1
  657. package/dist/reader-selection.js +0 -81
  658. package/dist/reader-selection.js.map +0 -1
@@ -0,0 +1,181 @@
1
+ import { isRecord } from "./record.js";
2
+ import { requiredText, text } from "./scanner-import.js";
3
+ import { checkmarxOneId } from "./checkmarx-one.js";
4
+ import { checkmarxResultViewer, checkmarxXmlId, checkmarxXmlInstance, checkmarxXmlScope, } from "./checkmarx-xml.js";
5
+ import { declaredScannerRepositoryUrl, repositoryScopeValidator, } from "./scanner-repository-url.js";
6
+ const nativeId = /^checkmarx-(?:one|cxsast):[a-f0-9]{64}$/u;
7
+ function checkmarxFormat(value) {
8
+ return value === "cxsast-xml" || value === "checkmarx-one-json";
9
+ }
10
+ function scanKey(value, xml) {
11
+ const uuid = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/iu;
12
+ return !xml && typeof value === "string" && uuid.test(value)
13
+ ? value.toLowerCase()
14
+ : value;
15
+ }
16
+ /** A native payload can verify its occurrence ID. A projection can still identify its source. */
17
+ function checkmarxSource({ source_finding_id: id, evidence }, provider) {
18
+ const data = evidence.source_data;
19
+ const format = data?.["format"];
20
+ if (checkmarxFormat(format))
21
+ return format;
22
+ const scanner = evidence.details?.scanner_origin;
23
+ const projected = nativeId.test(id) ||
24
+ scanner === "CxSAST" ||
25
+ scanner === "Checkmarx One SAST" ||
26
+ Boolean(checkmarxResultViewer(data));
27
+ if (data &&
28
+ (provider === "checkmarx" || projected || "sourceRepositoryUrl" in data)) {
29
+ const row = data["row"];
30
+ if (isRecord(row) && row["type"] === "sast" && "similarityId" in row)
31
+ return "checkmarx-one-json";
32
+ const path = data["path"];
33
+ if ("projectId" in data && isRecord(path) && "SimilarityId" in path)
34
+ return "cxsast-xml";
35
+ }
36
+ if (projected)
37
+ return "projection";
38
+ }
39
+ const mismatch = "Checkmarx finding does not match the retained report format, scan or project.";
40
+ /** Compare the claims present across the whole batch, including projected SDK rows. */
41
+ function checkBatchScope(findings, formats, report) {
42
+ const claims = new Map();
43
+ function claim(key, value) {
44
+ if (value == null)
45
+ return;
46
+ if (claims.has(key) && claims.get(key) !== value)
47
+ throw new Error(report
48
+ ? mismatch
49
+ : "Checkmarx occurrences must belong to the same product, project and scan.");
50
+ claims.set(key, value);
51
+ }
52
+ for (const format of [report?.["format"], ...formats])
53
+ if (checkmarxFormat(format))
54
+ claim("scanner", format === "cxsast-xml" ? "CxSAST" : "Checkmarx One SAST");
55
+ const sources = [report];
56
+ for (const { evidence } of findings) {
57
+ claim("scanner", evidence.details?.scanner_origin);
58
+ if (evidence.source_data)
59
+ sources.push(evidence.source_data);
60
+ }
61
+ if (sources.some(checkmarxResultViewer))
62
+ claim("scanner", "CxSAST");
63
+ const xml = claims.get("scanner") === "CxSAST";
64
+ const named = xml || sources.some((data) => text(data?.["teamFullPathOnReportDate"]));
65
+ claim("scan", scanKey(report?.["scanId"], xml));
66
+ for (const { evidence } of findings)
67
+ claim("scan", scanKey(evidence.source_scan_id, xml));
68
+ let instance;
69
+ for (const data of sources) {
70
+ if (!data)
71
+ continue;
72
+ claim("project", data["projectId"]);
73
+ if (named) {
74
+ claim("project name", text(data["projectName"]));
75
+ claim("team", text(data["teamFullPathOnReportDate"])
76
+ ?.replaceAll("\\", "/")
77
+ .replace(/^\/+|\/+$/gu, "")
78
+ .replace(/[A-Z]/gu, (c) => c.toLowerCase()));
79
+ }
80
+ // A URL identifies a deployment; other instance metadata in SDK rows is opaque.
81
+ const url = data["instance"];
82
+ if (xml ||
83
+ (typeof url === "string" &&
84
+ /^https?:$/u.test(URL.parse(url)?.protocol ?? ""))) {
85
+ const scope = checkmarxXmlScope(data);
86
+ instance = checkmarxXmlInstance(instance, scope.instance);
87
+ claim("project", scope.projectId);
88
+ claim("scan", scope.scanId);
89
+ }
90
+ }
91
+ }
92
+ /** Identify report and row provenance once for both import destinations. */
93
+ export function checkmarxSelection(provider, findings, report, target, historical = false) {
94
+ const selected = provider === "checkmarx";
95
+ const replay = historical && !selected;
96
+ const format = report?.["format"];
97
+ const nativeReport = checkmarxFormat(format);
98
+ const formats = new Map();
99
+ for (const finding of findings) {
100
+ const kind = checkmarxSource(finding, provider);
101
+ if (kind)
102
+ formats.set(finding, kind);
103
+ }
104
+ const validateUrl = (value) => declaredScannerRepositoryUrl(value, "Checkmarx", target);
105
+ function requireProvider() {
106
+ if (!selected)
107
+ throw new Error("Retained Checkmarx evidence requires the checkmarx provider.");
108
+ }
109
+ if (selected)
110
+ checkBatchScope(findings, formats.values(), report);
111
+ let reportUrl;
112
+ if (report && nativeReport && !replay) {
113
+ requireProvider();
114
+ const xml = format === "cxsast-xml";
115
+ const scan = scanKey(requiredText(report["scanId"], "Checkmarx report scan ID"), xml);
116
+ const project = xml
117
+ ? requiredText(report["projectId"], "CxSAST report project ID")
118
+ : undefined;
119
+ for (const finding of findings) {
120
+ const { evidence } = finding;
121
+ const data = evidence.source_data;
122
+ if ((data && "format" in data ? data["format"] : formats.get(finding)) !==
123
+ format ||
124
+ scanKey(evidence.source_scan_id, xml) !== scan ||
125
+ (xml && data?.["projectId"] !== project))
126
+ throw new Error(mismatch);
127
+ }
128
+ reportUrl = validateUrl(report["sourceRepositoryUrl"]);
129
+ }
130
+ else if (report) {
131
+ if (selected && "sourceRepositoryUrl" in report && "scanId" in report)
132
+ throw new Error("Expected the original Checkmarx report format.");
133
+ if (typeof report["sourceRepositoryUrl"] === "string" &&
134
+ (selected || nativeReport || formats.size))
135
+ reportUrl = validateUrl(report["sourceRepositoryUrl"]);
136
+ }
137
+ const marked = new Set(nativeReport || reportUrl ? findings : formats.keys());
138
+ function projectedRepository({ evidence }) {
139
+ const source = evidence.source_data?.["sourceRepositoryUrl"];
140
+ const url = typeof source === "string"
141
+ ? validateUrl(source)
142
+ : evidence.details?.repository?.url;
143
+ return url ? { url } : undefined;
144
+ }
145
+ const validateRows = repositoryScopeValidator({
146
+ provider: "checkmarx",
147
+ label: "Checkmarx",
148
+ scope: "product, project and scan",
149
+ }, (_, finding) => {
150
+ const { source_finding_id: id, evidence } = finding;
151
+ const data = evidence.source_data;
152
+ const kind = formats.get(finding);
153
+ if (checkmarxFormat(kind) && data) {
154
+ requireProvider();
155
+ requiredText(evidence.source_scan_id, "Checkmarx source scan ID");
156
+ const expected = kind === "cxsast-xml"
157
+ ? checkmarxXmlId(data)
158
+ : checkmarxOneId(data["row"]);
159
+ if (id !== expected)
160
+ throw new Error("Checkmarx source finding ID does not match the retained occurrence.");
161
+ return { url: validateUrl(data["sourceRepositoryUrl"]), scope: kind };
162
+ }
163
+ if (selected && nativeId.test(id))
164
+ throw new Error("Checkmarx source finding ID requires its original evidence.");
165
+ if (selected && data && "sourceRepositoryUrl" in data)
166
+ return { url: validateUrl(data["sourceRepositoryUrl"]) };
167
+ return kind ? projectedRepository(finding) : undefined;
168
+ });
169
+ return {
170
+ reportUrl,
171
+ projections: selected ? new Set() : marked,
172
+ repositories(sameRepositories) {
173
+ const rows = replay || (!selected && !formats.size)
174
+ ? undefined
175
+ : validateRows(provider, findings, target, sameRepositories);
176
+ return (finding) => rows?.get(finding.source_finding_id) ??
177
+ (marked.has(finding) ? projectedRepository(finding) : undefined);
178
+ },
179
+ };
180
+ }
181
+ //# sourceMappingURL=checkmarx-repository.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"checkmarx-repository.js","sourceRoot":"","sources":["../src/checkmarx-repository.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport type { ExternalImportTarget } from \"./external-import-contract.js\";\nimport type { Provider } from \"./external-import-models.js\";\nimport { isRecord } from \"./record.js\";\nimport { requiredText, text } from \"./scanner-import.js\";\nimport { checkmarxOneId } from \"./checkmarx-one.js\";\nimport {\n checkmarxResultViewer,\n checkmarxXmlId,\n checkmarxXmlInstance,\n checkmarxXmlScope,\n} from \"./checkmarx-xml.js\";\nimport {\n declaredScannerRepositoryUrl,\n repositoryScopeValidator,\n} from \"./scanner-repository-url.js\";\n\nconst nativeId = /^checkmarx-(?:one|cxsast):[a-f0-9]{64}$/u;\n\nfunction checkmarxFormat(value: unknown) {\n return value === \"cxsast-xml\" || value === \"checkmarx-one-json\";\n}\n\nfunction scanKey(value: unknown, xml: boolean) {\n const uuid = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/iu;\n return !xml && typeof value === \"string\" && uuid.test(value)\n ? value.toLowerCase()\n : value;\n}\n\n/** A native payload can verify its occurrence ID. A projection can still identify its source. */\nfunction checkmarxSource(\n { source_finding_id: id, evidence }: ExternalFinding,\n provider?: Provider,\n) {\n const data = evidence.source_data;\n const format = data?.[\"format\"];\n if (checkmarxFormat(format)) return format;\n const scanner = evidence.details?.scanner_origin;\n const projected =\n nativeId.test(id) ||\n scanner === \"CxSAST\" ||\n scanner === \"Checkmarx One SAST\" ||\n Boolean(checkmarxResultViewer(data));\n if (\n data &&\n (provider === \"checkmarx\" || projected || \"sourceRepositoryUrl\" in data)\n ) {\n const row = data[\"row\"];\n if (isRecord(row) && row[\"type\"] === \"sast\" && \"similarityId\" in row)\n return \"checkmarx-one-json\";\n const path = data[\"path\"];\n if (\"projectId\" in data && isRecord(path) && \"SimilarityId\" in path)\n return \"cxsast-xml\";\n }\n if (projected) return \"projection\";\n}\n\nconst mismatch =\n \"Checkmarx finding does not match the retained report format, scan or project.\";\n\n/** Compare the claims present across the whole batch, including projected SDK rows. */\nfunction checkBatchScope(\n findings: readonly ExternalFinding[],\n formats: Iterable<string>,\n report: ExternalFindings[\"report\"],\n) {\n const claims = new Map<string, unknown>();\n function claim(key: string, value: unknown) {\n if (value == null) return;\n if (claims.has(key) && claims.get(key) !== value)\n throw new Error(\n report\n ? mismatch\n : \"Checkmarx occurrences must belong to the same product, project and scan.\",\n );\n claims.set(key, value);\n }\n\n for (const format of [report?.[\"format\"], ...formats])\n if (checkmarxFormat(format))\n claim(\n \"scanner\",\n format === \"cxsast-xml\" ? \"CxSAST\" : \"Checkmarx One SAST\",\n );\n const sources = [report];\n for (const { evidence } of findings) {\n claim(\"scanner\", evidence.details?.scanner_origin);\n if (evidence.source_data) sources.push(evidence.source_data);\n }\n if (sources.some(checkmarxResultViewer)) claim(\"scanner\", \"CxSAST\");\n const xml = claims.get(\"scanner\") === \"CxSAST\";\n const named =\n xml || sources.some((data) => text(data?.[\"teamFullPathOnReportDate\"]));\n claim(\"scan\", scanKey(report?.[\"scanId\"], xml));\n for (const { evidence } of findings)\n claim(\"scan\", scanKey(evidence.source_scan_id, xml));\n\n let instance: string | undefined;\n for (const data of sources) {\n if (!data) continue;\n claim(\"project\", data[\"projectId\"]);\n if (named) {\n claim(\"project name\", text(data[\"projectName\"]));\n claim(\n \"team\",\n text(data[\"teamFullPathOnReportDate\"])\n ?.replaceAll(\"\\\\\", \"/\")\n .replace(/^\\/+|\\/+$/gu, \"\")\n .replace(/[A-Z]/gu, (c) => c.toLowerCase()),\n );\n }\n // A URL identifies a deployment; other instance metadata in SDK rows is opaque.\n const url = data[\"instance\"];\n if (\n xml ||\n (typeof url === \"string\" &&\n /^https?:$/u.test(URL.parse(url)?.protocol ?? \"\"))\n ) {\n const scope = checkmarxXmlScope(data);\n instance = checkmarxXmlInstance(instance, scope.instance);\n claim(\"project\", scope.projectId);\n claim(\"scan\", scope.scanId);\n }\n }\n}\n\n/** Identify report and row provenance once for both import destinations. */\nexport function checkmarxSelection(\n provider: Provider,\n findings: ExternalFindings[\"findings\"],\n report: ExternalFindings[\"report\"],\n target: ExternalImportTarget,\n historical = false,\n) {\n const selected = provider === \"checkmarx\";\n const replay = historical && !selected;\n const format = report?.[\"format\"];\n const nativeReport = checkmarxFormat(format);\n const formats = new Map<ExternalFinding, string>();\n for (const finding of findings) {\n const kind = checkmarxSource(finding, provider);\n if (kind) formats.set(finding, kind);\n }\n const validateUrl = (value: unknown) =>\n declaredScannerRepositoryUrl(value, \"Checkmarx\", target);\n function requireProvider() {\n if (!selected)\n throw new Error(\n \"Retained Checkmarx evidence requires the checkmarx provider.\",\n );\n }\n if (selected) checkBatchScope(findings, formats.values(), report);\n let reportUrl: string | undefined;\n if (report && nativeReport && !replay) {\n requireProvider();\n const xml = format === \"cxsast-xml\";\n const scan = scanKey(\n requiredText(report[\"scanId\"], \"Checkmarx report scan ID\"),\n xml,\n );\n const project = xml\n ? requiredText(report[\"projectId\"], \"CxSAST report project ID\")\n : undefined;\n for (const finding of findings) {\n const { evidence } = finding;\n const data = evidence.source_data;\n if (\n (data && \"format\" in data ? data[\"format\"] : formats.get(finding)) !==\n format ||\n scanKey(evidence.source_scan_id, xml) !== scan ||\n (xml && data?.[\"projectId\"] !== project)\n )\n throw new Error(mismatch);\n }\n reportUrl = validateUrl(report[\"sourceRepositoryUrl\"]);\n } else if (report) {\n if (selected && \"sourceRepositoryUrl\" in report && \"scanId\" in report)\n throw new Error(\"Expected the original Checkmarx report format.\");\n if (\n typeof report[\"sourceRepositoryUrl\"] === \"string\" &&\n (selected || nativeReport || formats.size)\n )\n reportUrl = validateUrl(report[\"sourceRepositoryUrl\"]);\n }\n const marked = new Set(nativeReport || reportUrl ? findings : formats.keys());\n function projectedRepository({ evidence }: ExternalFinding) {\n const source = evidence.source_data?.[\"sourceRepositoryUrl\"];\n const url =\n typeof source === \"string\"\n ? validateUrl(source)\n : evidence.details?.repository?.url;\n return url ? { url } : undefined;\n }\n const validateRows = repositoryScopeValidator(\n {\n provider: \"checkmarx\",\n label: \"Checkmarx\",\n scope: \"product, project and scan\",\n },\n (_, finding) => {\n const { source_finding_id: id, evidence } = finding;\n const data = evidence.source_data;\n const kind = formats.get(finding);\n if (checkmarxFormat(kind) && data) {\n requireProvider();\n requiredText(evidence.source_scan_id, \"Checkmarx source scan ID\");\n const expected =\n kind === \"cxsast-xml\"\n ? checkmarxXmlId(data)\n : checkmarxOneId(data[\"row\"]);\n if (id !== expected)\n throw new Error(\n \"Checkmarx source finding ID does not match the retained occurrence.\",\n );\n return { url: validateUrl(data[\"sourceRepositoryUrl\"]), scope: kind };\n }\n if (selected && nativeId.test(id))\n throw new Error(\n \"Checkmarx source finding ID requires its original evidence.\",\n );\n if (selected && data && \"sourceRepositoryUrl\" in data)\n return { url: validateUrl(data[\"sourceRepositoryUrl\"]) };\n return kind ? projectedRepository(finding) : undefined;\n },\n );\n return {\n reportUrl,\n projections: selected ? new Set<ExternalFinding>() : marked,\n repositories(sameRepositories?: (urls: Iterable<string>) => boolean) {\n const rows =\n replay || (!selected && !formats.size)\n ? undefined\n : validateRows(provider, findings, target, sameRepositories);\n return (finding: ExternalFinding) =>\n rows?.get(finding.source_finding_id) ??\n (marked.has(finding) ? projectedRepository(finding) : undefined);\n },\n };\n}\n"]}
@@ -0,0 +1,12 @@
1
+ import type { ExternalImportTarget } from "./external-import-contract.js";
2
+ export declare function checkmarxXmlInstance(current: string | undefined, next: string | undefined): string | undefined;
3
+ export declare function checkmarxResultViewer(source: Record<string, unknown> | null | undefined): URL | undefined;
4
+ export declare function checkmarxXmlScope(source: Record<string, unknown>, scanId?: string, projectId?: string): {
5
+ instance: string | undefined;
6
+ scanId: string | undefined;
7
+ projectId: string | undefined;
8
+ };
9
+ /** SimilarityId groups paths, including paths with different intermediate nodes. */
10
+ export declare function checkmarxXmlId(source: Record<string, unknown>): string;
11
+ export declare function normalizeCheckmarxXml(contents: string, repository: string, target: ExternalImportTarget): import("./external-findings.js").ExternalFindings;
12
+ //# sourceMappingURL=checkmarx-xml.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"checkmarx-xml.d.ts","sourceRoot":"","sources":["../src/checkmarx-xml.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAiE1E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,sBAUzB;AAaD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,mBAGnD;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM;IAUhB,QAAQ;IAMR,MAAM;IACN,SAAS;EAEZ;AAgED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAkBtE;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oBAAoB,qDA0D7B"}
@@ -0,0 +1,196 @@
1
+ import { SaxesParser } from "saxes";
2
+ import { asRecord } from "./record.js";
3
+ import { checkmarxEvidence } from "./checkmarx-evidence.js";
4
+ import { array, normalizeRecords, record, requiredText, stableId, text, } from "./scanner-import.js";
5
+ function fields(element) {
6
+ return Object.fromEntries(element.children
7
+ .filter((child) => !child.children.length)
8
+ .map((child) => [child.name, child.text]));
9
+ }
10
+ function pathNode(element) {
11
+ const node = fields(element);
12
+ const snippet = element.children.find((child) => child.name === "Snippet");
13
+ if (snippet)
14
+ node["Snippet"] = snippet.children
15
+ .filter((child) => child.name === "Line")
16
+ .map(fields);
17
+ return node;
18
+ }
19
+ const viewerPath = "/cxwebclient/viewermain.aspx";
20
+ function viewerLink(value) {
21
+ const url = typeof value === "string" ? URL.parse(value) : null;
22
+ if (url &&
23
+ /^https?:$/u.test(url.protocol) &&
24
+ url.pathname.toLowerCase().endsWith(viewerPath))
25
+ return url;
26
+ }
27
+ function viewerInstance(link) {
28
+ return link && link.origin + link.pathname.slice(0, -viewerPath.length);
29
+ }
30
+ function instanceKey(value) {
31
+ const url = URL.parse(value);
32
+ return url && /^https?:$/u.test(url.protocol) ? url.href : value;
33
+ }
34
+ export function checkmarxXmlInstance(current, next) {
35
+ if (current !== undefined &&
36
+ next !== undefined &&
37
+ current !== next &&
38
+ instanceKey(current) !== instanceKey(next))
39
+ throw new Error("CxSAST viewer links must identify the same instance.");
40
+ return current ?? next;
41
+ }
42
+ function viewerId(link, field, expected) {
43
+ let selected = expected;
44
+ for (const [key, id] of link?.searchParams ?? []) {
45
+ if (!id || key.toLowerCase() !== field)
46
+ continue;
47
+ if (selected !== undefined && selected !== id)
48
+ throw new Error(`CxSAST DeepLink ${field} does not match the report.`);
49
+ selected = id;
50
+ }
51
+ return selected;
52
+ }
53
+ export function checkmarxResultViewer(source) {
54
+ return viewerLink(asRecord(source?.["result"])?.["DeepLink"]);
55
+ }
56
+ export function checkmarxXmlScope(source, scanId, projectId) {
57
+ const link = checkmarxResultViewer(source);
58
+ viewerId(link, "pathid", text(asRecord(source["path"])?.["PathId"]) ?? undefined);
59
+ const instance = source["instance"];
60
+ return {
61
+ instance: checkmarxXmlInstance(instance === undefined
62
+ ? undefined
63
+ : requiredText(instance, "CxSAST instance"), viewerInstance(link)),
64
+ scanId: viewerId(link, "scanid", scanId),
65
+ projectId: viewerId(link, "projectid", projectId),
66
+ };
67
+ }
68
+ function readReport(contents) {
69
+ const rows = [];
70
+ const stack = [];
71
+ const parser = new SaxesParser({ xmlns: false });
72
+ let scanId = "";
73
+ let rootInstance;
74
+ const project = { projectId: "" };
75
+ parser.on("opentag", ({ name, attributes }) => {
76
+ const element = { name, attributes, children: [], text: "" };
77
+ if (!stack.length) {
78
+ if (name !== "CxXMLResults")
79
+ throw new Error("Expected a Checkmarx CxSAST CxXMLResults report.");
80
+ project.projectId = requiredText(attributes["ProjectId"], "CxSAST ProjectId");
81
+ scanId = requiredText(attributes["ScanId"], "CxSAST ScanId");
82
+ const projectName = text(attributes["ProjectName"]);
83
+ const team = text(attributes["TeamFullPathOnReportDate"]);
84
+ if (projectName)
85
+ project["projectName"] = projectName;
86
+ if (team)
87
+ project["teamFullPathOnReportDate"] = team;
88
+ const link = viewerLink(attributes["DeepLink"]);
89
+ viewerId(link, "scanid", scanId);
90
+ viewerId(link, "projectid", project.projectId);
91
+ rootInstance = viewerInstance(link);
92
+ }
93
+ else if ((stack.length === 1 && name !== "Query") ||
94
+ (stack.length === 2 && name !== "Result")) {
95
+ throw new Error("Expected CxSAST results directly under their Query.");
96
+ }
97
+ // Only build subtrees within the current result, then release them.
98
+ if (stack.length >= 3)
99
+ stack.at(-1).children.push(element);
100
+ stack.push(element);
101
+ });
102
+ function appendText(value) {
103
+ const element = stack.at(-1);
104
+ if (element)
105
+ element.text += value;
106
+ }
107
+ parser.on("text", appendText);
108
+ parser.on("cdata", appendText);
109
+ parser.on("closetag", () => {
110
+ const element = stack.pop();
111
+ const parent = stack.at(-1);
112
+ if (parent?.name !== "Query" || stack.length !== 2)
113
+ return;
114
+ const paths = element.children.filter((child) => child.name === "Path");
115
+ const path = paths.length === 1 ? paths[0] : undefined;
116
+ rows.push({
117
+ ...project,
118
+ query: parent.attributes,
119
+ result: element.attributes,
120
+ path: path?.attributes ?? null,
121
+ nodes: path?.children
122
+ .filter((child) => child.name === "PathNode")
123
+ .map(pathNode) ?? [],
124
+ });
125
+ });
126
+ parser.write(contents).close();
127
+ return { rows, project, scanId, rootInstance };
128
+ }
129
+ /** SimilarityId groups paths, including paths with different intermediate nodes. */
130
+ export function checkmarxXmlId(source) {
131
+ const projectId = requiredText(source["projectId"], "CxSAST ProjectId");
132
+ const query = record(source["query"], "CxSAST Query");
133
+ const result = record(source["result"], "CxSAST Result");
134
+ const path = record(source["path"], "CxSAST Path");
135
+ const nodes = array(source["nodes"], "CxSAST Path nodes");
136
+ const route = (nodes.length ? nodes : [result]).map((value) => {
137
+ const node = record(value, "CxSAST path node");
138
+ return ["FileName", "Line", "Column", "Name", "Type"].map((field) => text(node[field]));
139
+ });
140
+ return stableId("checkmarx-cxsast", [
141
+ projectId,
142
+ requiredText(query["id"], "CxSAST Query id"),
143
+ requiredText(path["SimilarityId"], "CxSAST SimilarityId"),
144
+ route,
145
+ ]);
146
+ }
147
+ export function normalizeCheckmarxXml(contents, repository, target) {
148
+ const { rows, project, scanId, rootInstance } = readReport(contents);
149
+ function normalize(instance) {
150
+ const report = {
151
+ format: "cxsast-xml",
152
+ scanId,
153
+ ...project,
154
+ ...(instance && { instance }),
155
+ sourceRepositoryUrl: repository,
156
+ };
157
+ return normalizeRecords(rows, (row) => {
158
+ const { query, result } = row;
159
+ return checkmarxEvidence(report, {
160
+ title: requiredText(query["name"], "CxSAST Query name"),
161
+ ruleId: query["id"],
162
+ severity: text(result["Severity"]) ?? query["Severity"],
163
+ description: result["Remark"],
164
+ status: result["Status"],
165
+ verdict: result["FalsePositive"]?.toLowerCase() === "true"
166
+ ? "False positive"
167
+ : result["state"],
168
+ cwe: query["cweId"],
169
+ sourceData: !row["instance"] && instance ? { ...row, instance } : row,
170
+ }, target);
171
+ }, (row) => {
172
+ const scope = checkmarxXmlScope(row, scanId, project.projectId);
173
+ if (scope.instance)
174
+ row["instance"] = scope.instance;
175
+ return checkmarxXmlId(row);
176
+ }, target, { report });
177
+ }
178
+ const result = normalize(rootInstance);
179
+ let instance = rootInstance;
180
+ let hasUnboundRows = false;
181
+ for (const { evidence } of result.findings) {
182
+ const rowInstance = text(evidence.source_data?.["instance"]);
183
+ if (rowInstance)
184
+ instance = checkmarxXmlInstance(instance, rowInstance);
185
+ else
186
+ hasUnboundRows = true;
187
+ }
188
+ if (instance && !rootInstance) {
189
+ // Count inherited instance bytes before accepting linkless findings for Cloud.
190
+ if (hasUnboundRows)
191
+ return normalize(instance);
192
+ result.report["instance"] = instance;
193
+ }
194
+ return result;
195
+ }
196
+ //# sourceMappingURL=checkmarx-xml.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"checkmarx-xml.js","sourceRoot":"","sources":["../src/checkmarx-xml.ts"],"names":[],"mappings":"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","sourcesContent":["import { SaxesParser } from \"saxes\";\nimport { asRecord } from \"./record.js\";\nimport { checkmarxEvidence } from \"./checkmarx-evidence.js\";\nimport type { ExternalImportTarget } from \"./external-import-contract.js\";\nimport {\n array,\n normalizeRecords,\n record,\n requiredText,\n stableId,\n text,\n} from \"./scanner-import.js\";\n\ntype Attributes = Record<string, string>;\ninterface Element {\n name: string;\n attributes: Attributes;\n children: Element[];\n text: string;\n}\n\nfunction fields(element: Element): Attributes {\n return Object.fromEntries(\n element.children\n .filter((child) => !child.children.length)\n .map((child) => [child.name, child.text]),\n );\n}\n\nfunction pathNode(element: Element): Record<string, unknown> {\n const node: Record<string, unknown> = fields(element);\n const snippet = element.children.find((child) => child.name === \"Snippet\");\n if (snippet)\n node[\"Snippet\"] = snippet.children\n .filter((child) => child.name === \"Line\")\n .map(fields);\n return node;\n}\n\ninterface Row extends Record<string, unknown> {\n projectId: string;\n query: Attributes;\n result: Attributes;\n path: Attributes | null;\n nodes: Record<string, unknown>[];\n}\n\nconst viewerPath = \"/cxwebclient/viewermain.aspx\";\n\nfunction viewerLink(value: unknown) {\n const url = typeof value === \"string\" ? URL.parse(value) : null;\n if (\n url &&\n /^https?:$/u.test(url.protocol) &&\n url.pathname.toLowerCase().endsWith(viewerPath)\n )\n return url;\n}\n\nfunction viewerInstance(link: URL | undefined) {\n return link && link.origin + link.pathname.slice(0, -viewerPath.length);\n}\n\nfunction instanceKey(value: string) {\n const url = URL.parse(value);\n return url && /^https?:$/u.test(url.protocol) ? url.href : value;\n}\n\nexport function checkmarxXmlInstance(\n current: string | undefined,\n next: string | undefined,\n) {\n if (\n current !== undefined &&\n next !== undefined &&\n current !== next &&\n instanceKey(current) !== instanceKey(next)\n )\n throw new Error(\"CxSAST viewer links must identify the same instance.\");\n return current ?? next;\n}\n\nfunction viewerId(link: URL | undefined, field: string, expected?: string) {\n let selected = expected;\n for (const [key, id] of link?.searchParams ?? []) {\n if (!id || key.toLowerCase() !== field) continue;\n if (selected !== undefined && selected !== id)\n throw new Error(`CxSAST DeepLink ${field} does not match the report.`);\n selected = id;\n }\n return selected;\n}\n\nexport function checkmarxResultViewer(\n source: Record<string, unknown> | null | undefined,\n) {\n return viewerLink(asRecord(source?.[\"result\"])?.[\"DeepLink\"]);\n}\n\nexport function checkmarxXmlScope(\n source: Record<string, unknown>,\n scanId?: string,\n projectId?: string,\n) {\n const link = checkmarxResultViewer(source);\n viewerId(\n link,\n \"pathid\",\n text(asRecord(source[\"path\"])?.[\"PathId\"]) ?? undefined,\n );\n const instance = source[\"instance\"];\n return {\n instance: checkmarxXmlInstance(\n instance === undefined\n ? undefined\n : requiredText(instance, \"CxSAST instance\"),\n viewerInstance(link),\n ),\n scanId: viewerId(link, \"scanid\", scanId),\n projectId: viewerId(link, \"projectid\", projectId),\n };\n}\n\nfunction readReport(contents: string) {\n const rows: Row[] = [];\n const stack: Element[] = [];\n const parser = new SaxesParser({ xmlns: false });\n let scanId = \"\";\n let rootInstance: string | undefined;\n const project: Attributes & { projectId: string } = { projectId: \"\" };\n parser.on(\"opentag\", ({ name, attributes }) => {\n const element: Element = { name, attributes, children: [], text: \"\" };\n if (!stack.length) {\n if (name !== \"CxXMLResults\")\n throw new Error(\"Expected a Checkmarx CxSAST CxXMLResults report.\");\n project.projectId = requiredText(\n attributes[\"ProjectId\"],\n \"CxSAST ProjectId\",\n );\n scanId = requiredText(attributes[\"ScanId\"], \"CxSAST ScanId\");\n const projectName = text(attributes[\"ProjectName\"]);\n const team = text(attributes[\"TeamFullPathOnReportDate\"]);\n if (projectName) project[\"projectName\"] = projectName;\n if (team) project[\"teamFullPathOnReportDate\"] = team;\n const link = viewerLink(attributes[\"DeepLink\"]);\n viewerId(link, \"scanid\", scanId);\n viewerId(link, \"projectid\", project.projectId);\n rootInstance = viewerInstance(link);\n } else if (\n (stack.length === 1 && name !== \"Query\") ||\n (stack.length === 2 && name !== \"Result\")\n ) {\n throw new Error(\"Expected CxSAST results directly under their Query.\");\n }\n // Only build subtrees within the current result, then release them.\n if (stack.length >= 3) stack.at(-1)!.children.push(element);\n stack.push(element);\n });\n function appendText(value: string) {\n const element = stack.at(-1);\n if (element) element.text += value;\n }\n parser.on(\"text\", appendText);\n parser.on(\"cdata\", appendText);\n parser.on(\"closetag\", () => {\n const element = stack.pop()!;\n const parent = stack.at(-1);\n if (parent?.name !== \"Query\" || stack.length !== 2) return;\n const paths = element.children.filter((child) => child.name === \"Path\");\n const path = paths.length === 1 ? paths[0] : undefined;\n rows.push({\n ...project,\n query: parent.attributes,\n result: element.attributes,\n path: path?.attributes ?? null,\n nodes:\n path?.children\n .filter((child) => child.name === \"PathNode\")\n .map(pathNode) ?? [],\n });\n });\n parser.write(contents).close();\n return { rows, project, scanId, rootInstance };\n}\n\n/** SimilarityId groups paths, including paths with different intermediate nodes. */\nexport function checkmarxXmlId(source: Record<string, unknown>): string {\n const projectId = requiredText(source[\"projectId\"], \"CxSAST ProjectId\");\n const query = record(source[\"query\"], \"CxSAST Query\");\n const result = record(source[\"result\"], \"CxSAST Result\");\n const path = record(source[\"path\"], \"CxSAST Path\");\n const nodes = array(source[\"nodes\"], \"CxSAST Path nodes\");\n const route = (nodes.length ? nodes : [result]).map((value) => {\n const node = record(value, \"CxSAST path node\");\n return [\"FileName\", \"Line\", \"Column\", \"Name\", \"Type\"].map((field) =>\n text(node[field]),\n );\n });\n return stableId(\"checkmarx-cxsast\", [\n projectId,\n requiredText(query[\"id\"], \"CxSAST Query id\"),\n requiredText(path[\"SimilarityId\"], \"CxSAST SimilarityId\"),\n route,\n ]);\n}\n\nexport function normalizeCheckmarxXml(\n contents: string,\n repository: string,\n target: ExternalImportTarget,\n) {\n const { rows, project, scanId, rootInstance } = readReport(contents);\n function normalize(instance: string | undefined) {\n const report = {\n format: \"cxsast-xml\",\n scanId,\n ...project,\n ...(instance && { instance }),\n sourceRepositoryUrl: repository,\n } as const;\n return normalizeRecords(\n rows,\n (row) => {\n const { query, result } = row;\n return checkmarxEvidence(\n report,\n {\n title: requiredText(query[\"name\"], \"CxSAST Query name\"),\n ruleId: query[\"id\"],\n severity: text(result[\"Severity\"]) ?? query[\"Severity\"],\n description: result[\"Remark\"],\n status: result[\"Status\"],\n verdict:\n result[\"FalsePositive\"]?.toLowerCase() === \"true\"\n ? \"False positive\"\n : result[\"state\"],\n cwe: query[\"cweId\"],\n sourceData:\n !row[\"instance\"] && instance ? { ...row, instance } : row,\n },\n target,\n );\n },\n (row) => {\n const scope = checkmarxXmlScope(row, scanId, project.projectId);\n if (scope.instance) row[\"instance\"] = scope.instance;\n return checkmarxXmlId(row);\n },\n target,\n { report },\n );\n }\n\n const result = normalize(rootInstance);\n let instance = rootInstance;\n let hasUnboundRows = false;\n for (const { evidence } of result.findings) {\n const rowInstance = text(evidence.source_data?.[\"instance\"]);\n if (rowInstance) instance = checkmarxXmlInstance(instance, rowInstance);\n else hasUnboundRows = true;\n }\n if (instance && !rootInstance) {\n // Count inherited instance bytes before accepting linkless findings for Cloud.\n if (hasUnboundRows) return normalize(instance);\n result.report![\"instance\"] = instance;\n }\n return result;\n}\n"]}
@@ -3,7 +3,7 @@ export interface ScanSeverityClassification extends SeverityClassification {
3
3
  scanId: string;
4
4
  }
5
5
  export interface ClassifyScanSeverityOptions extends ClassifySeverityOptions {
6
- /** Exact selection, such as dedupe's uniqueFindingIds. Omit to classify all findings. */
6
+ /** Exact selection, such as dedupe's scanRepresentativeFindingIds. Omit to classify all findings. */
7
7
  findingIds?: readonly string[];
8
8
  /** Reclassify selected findings even when their saved assessment matches the inputs. */
9
9
  reprocess?: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"classify-scan-severity.d.ts","sourceRoot":"","sources":["../src/classify-scan-severity.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAahC,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,yFAAyF;IACzF,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qFAAqF;AACrF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC,CAErC;AAwCD,sGAAsG;AACtG,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC,CAErC"}
1
+ {"version":3,"file":"classify-scan-severity.d.ts","sourceRoot":"","sources":["../src/classify-scan-severity.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAehC,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,qGAAqG;IACrG,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qFAAqF;AACrF,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC,CAErC;AAmDD,sGAAsG;AACtG,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC,CAErC"}
@@ -8,6 +8,7 @@ import { bundledPluginRoot } from "./runtime.js";
8
8
  import { savedScanWorkbench } from "./saved-scan-bootstrap.js";
9
9
  import { resolveCompletedScan, } from "./saved-scan.js";
10
10
  import { SeverityStore } from "./severity-store.js";
11
+ import { documentSourceRoot, nullIfMissingPath } from "./targets.js";
11
12
  const CLASSIFICATION_FILE = "severity-classification.json";
12
13
  /** Resolve a saved scan ID, unique prefix, or latest and save its classification. */
13
14
  export async function classifyScanSeverity(scanId, options = {}) {
@@ -35,14 +36,21 @@ export async function classifyScanSeverityInternal(scanId, options = {}, depende
35
36
  options.expectedScanId !== scan.scanId) {
36
37
  throw new CodexSecurityError("Saved scan does not match expectedScanId.");
37
38
  }
38
- return classifyScanDirectorySeverityInternal(scan.scanDir, { ...options, expectedScanId: scan.scanId }, surface, bootstrap?.protectedRoots);
39
+ const target = scan["targetPath"];
40
+ // The workbench enables remediation only for the recorded checkout and revision.
41
+ const sourceRoot = scan["remediationAvailable"] === true &&
42
+ typeof target === "string" &&
43
+ (options.rubricPath !== undefined || options.knowledgeBasePaths?.length)
44
+ ? await documentSourceRoot(target, options.signal).catch(nullIfMissingPath)
45
+ : null;
46
+ return classifyScanDirectorySeverityInternal(scan.scanDir, { ...options, expectedScanId: scan.scanId }, surface, bootstrap?.protectedRoots, sourceRoot === null ? null : [sourceRoot]);
39
47
  }
40
48
  /** Classify a sealed scan directory and save a separate assessment without changing its artifacts. */
41
49
  export async function classifyScanDirectorySeverity(scanDirectory, options = {}) {
42
50
  return classifyScanDirectorySeverityInternal(scanDirectory, options);
43
51
  }
44
52
  /** @internal */
45
- export async function classifyScanDirectorySeverityInternal(requestedDirectory, options = {}, surface = "sdk", protectedRoots = []) {
53
+ export async function classifyScanDirectorySeverityInternal(requestedDirectory, options = {}, surface = "sdk", protectedRoots = [], sourceRoots = []) {
46
54
  const { contract, scanDirectory } = await loadContractWithScanDirectory(requestedDirectory, {
47
55
  pluginRoot: await bundledPluginRoot(),
48
56
  expectedScanId: options.expectedScanId,
@@ -51,7 +59,7 @@ export async function classifyScanDirectorySeverityInternal(requestedDirectory,
51
59
  const findings = selectClassificationFindings(contract.findings.findings, options.findingIds);
52
60
  const store = new SeverityStore(options.environment ?? process.env, scanDirectory, options.signal, protectedRoots);
53
61
  const result = {
54
- ...(await classifySeverityInternal(findings, options, surface, store.checkpoint(contract.manifest.scan.id, findings.map(({ findingId }) => findingId), options.reprocess ?? false))),
62
+ ...(await classifySeverityInternal(findings, options, surface, store.checkpoint(contract.manifest.scan.id, findings.map(({ findingId }) => findingId), options.reprocess ?? false), sourceRoots && [scanDirectory, ...sourceRoots])),
55
63
  scanId: contract.manifest.scan.id,
56
64
  };
57
65
  options.signal?.throwIfAborted();
@@ -1 +1 @@
1
- {"version":3,"file":"classify-scan-severity.js","sourceRoot":"","sources":["../src/classify-scan-severity.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { rename, rm, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport {\n classifySeverityInternal,\n validateSeverityClassification,\n type ClassifySeverityOptions,\n type SeverityClassification,\n} from \"./classify-severity.js\";\nimport { loadContractWithScanDirectory } from \"./contract.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport type { Finding } from \"./models.js\";\nimport { bundledPluginRoot } from \"./runtime.js\";\nimport { savedScanWorkbench } from \"./saved-scan-bootstrap.js\";\nimport {\n resolveCompletedScan,\n type SavedScanDependencies,\n} from \"./saved-scan.js\";\nimport { SeverityStore } from \"./severity-store.js\";\n\nconst CLASSIFICATION_FILE = \"severity-classification.json\";\nexport interface ScanSeverityClassification extends SeverityClassification {\n scanId: string;\n}\n\nexport interface ClassifyScanSeverityOptions extends ClassifySeverityOptions {\n /** Exact selection, such as dedupe's uniqueFindingIds. Omit to classify all findings. */\n findingIds?: readonly string[];\n /** Reclassify selected findings even when their saved assessment matches the inputs. */\n reprocess?: boolean;\n expectedScanId?: string;\n}\n\n/** Resolve a saved scan ID, unique prefix, or latest and save its classification. */\nexport async function classifyScanSeverity(\n scanId: string,\n options: ClassifyScanSeverityOptions = {},\n): Promise<ScanSeverityClassification> {\n return classifyScanSeverityInternal(scanId, options);\n}\n\n/** @internal */\nexport async function classifyScanSeverityInternal(\n scanId: string,\n options: ClassifyScanSeverityOptions = {},\n dependencies: Partial<SavedScanDependencies> = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n): Promise<ScanSeverityClassification> {\n options.signal?.throwIfAborted();\n const environment = options.environment ?? process.env;\n const pluginRoot = await bundledPluginRoot();\n const currentDirectory = dependencies.currentDirectory?.() ?? process.cwd();\n const bootstrap = dependencies.runWorkbench\n ? undefined\n : await savedScanWorkbench(scanId, {\n environment,\n pluginRoot,\n currentDirectory,\n signal: options.signal,\n });\n const scan = await resolveCompletedScan(scanId, {\n currentDirectory: () => currentDirectory,\n runWorkbench: (args, input) =>\n (dependencies.runWorkbench ?? bootstrap!)(args, input, options.signal),\n });\n if (\n options.expectedScanId !== undefined &&\n options.expectedScanId !== scan.scanId\n ) {\n throw new CodexSecurityError(\"Saved scan does not match expectedScanId.\");\n }\n return classifyScanDirectorySeverityInternal(\n scan.scanDir,\n { ...options, expectedScanId: scan.scanId },\n surface,\n bootstrap?.protectedRoots,\n );\n}\n\n/** Classify a sealed scan directory and save a separate assessment without changing its artifacts. */\nexport async function classifyScanDirectorySeverity(\n scanDirectory: string,\n options: ClassifyScanSeverityOptions = {},\n): Promise<ScanSeverityClassification> {\n return classifyScanDirectorySeverityInternal(scanDirectory, options);\n}\n\n/** @internal */\nexport async function classifyScanDirectorySeverityInternal(\n requestedDirectory: string,\n options: ClassifyScanSeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n protectedRoots: readonly string[] = [],\n): Promise<ScanSeverityClassification> {\n const { contract, scanDirectory } = await loadContractWithScanDirectory(\n requestedDirectory,\n {\n pluginRoot: await bundledPluginRoot(),\n expectedScanId: options.expectedScanId,\n signal: options.signal,\n },\n );\n const findings = selectClassificationFindings(\n contract.findings.findings,\n options.findingIds,\n );\n const store = new SeverityStore(\n options.environment ?? process.env,\n scanDirectory,\n options.signal,\n protectedRoots,\n );\n const result: ScanSeverityClassification = {\n ...(await classifySeverityInternal(\n findings,\n options,\n surface,\n store.checkpoint(\n contract.manifest.scan.id,\n findings.map(({ findingId }) => findingId),\n options.reprocess ?? false,\n ),\n )),\n scanId: contract.manifest.scan.id,\n };\n options.signal?.throwIfAborted();\n const temporary = join(\n scanDirectory,\n `.severity-classification-${randomUUID()}.json`,\n );\n try {\n await writeFile(temporary, `${JSON.stringify(result, null, 2)}\\n`, {\n flag: \"wx\",\n mode: 0o600,\n signal: options.signal,\n });\n options.signal?.throwIfAborted();\n await rename(temporary, join(scanDirectory, CLASSIFICATION_FILE));\n } finally {\n await rm(temporary, { force: true });\n }\n return result;\n}\n\n/** @internal */\nexport function selectClassificationFindings(\n findings: readonly Finding[],\n findingIds?: readonly string[],\n): readonly Finding[] {\n if (findingIds === undefined) return findings;\n const selected = new Set(findingIds);\n const result = findings.filter((finding) => selected.has(finding.findingId));\n if (result.length !== selected.size) {\n throw new CodexSecurityError(\n \"Selected finding IDs must belong to the supplied scan.\",\n );\n }\n return result;\n}\n\n/** @internal */\nexport async function readScanSeverityClassification(\n scanDirectory: string,\n scanId: string,\n findings: readonly Finding[],\n signal?: AbortSignal,\n environment: NodeJS.ProcessEnv = process.env,\n): Promise<SeverityClassification | undefined> {\n const classification = await new SeverityStore(\n environment,\n scanDirectory,\n signal,\n ).read(scanId);\n return classification === undefined\n ? undefined\n : validateSeverityClassification(classification, findings);\n}\n"]}
1
+ {"version":3,"file":"classify-scan-severity.js","sourceRoot":"","sources":["../src/classify-scan-severity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAG/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,oBAAoB,GAErB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAa3D,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc,EACd,OAAO,GAAgC,EAAE;IAEzC,OAAO,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAAc,EACd,OAAO,GAAgC,EAAE,EACzC,YAAY,GAAmC,EAAE,EACjD,OAAO,GAAkB,KAAK;IAE9B,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IACvD,MAAM,UAAU,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC7C,MAAM,gBAAgB,GAAG,YAAY,CAAC,gBAAgB,EAAE,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC5E,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY;QACzC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,kBAAkB,CAAC,MAAM,EAAE;YAC/B,WAAW;YACX,UAAU;YACV,gBAAgB;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACP,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE;QAC9C,gBAAgB,EAAE,GAAG,EAAE,CAAC,gBAAgB;QACxC,YAAY,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC5B,CAAC,YAAY,CAAC,YAAY,IAAI,SAAU,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC;KACzE,CAAC,CAAC;IACH,IACE,OAAO,CAAC,cAAc,KAAK,SAAS;QACpC,OAAO,CAAC,cAAc,KAAK,IAAI,CAAC,MAAM,EACtC,CAAC;QACD,MAAM,IAAI,kBAAkB,CAAC,2CAA2C,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IAClC,iFAAiF;IACjF,MAAM,UAAU,GACd,IAAI,CAAC,sBAAsB,CAAC,KAAK,IAAI;QACrC,OAAO,MAAM,KAAK,QAAQ;QAC1B,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,kBAAkB,EAAE,MAAM,CAAC;QACtE,CAAC,CAAC,MAAM,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CACpD,iBAAiB,CAClB;QACH,CAAC,CAAC,IAAI,CAAC;IACX,OAAO,qCAAqC,CAC1C,IAAI,CAAC,OAAO,EACZ,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,MAAM,EAAE,EAC3C,OAAO,EACP,SAAS,EAAE,cAAc,EACzB,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAC1C,CAAC;AACJ,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,aAAqB,EACrB,OAAO,GAAgC,EAAE;IAEzC,OAAO,qCAAqC,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,kBAA0B,EAC1B,OAAO,GAAgC,EAAE,EACzC,OAAO,GAAkB,KAAK,EAC9B,cAAc,GAAsB,EAAE,EACtC,WAAW,GAAkB,EAAE;IAE/B,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,6BAA6B,CACrE,kBAAkB,EAClB;QACE,UAAU,EAAE,MAAM,iBAAiB,EAAE;QACrC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CACF,CAAC;IACF,MAAM,QAAQ,GAAG,4BAA4B,CAC3C,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAC1B,OAAO,CAAC,UAAU,CACnB,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,aAAa,CAC7B,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAClC,aAAa,EACb,OAAO,CAAC,MAAM,EACd,cAAc,CACf,CAAC;IACF,MAAM,MAAM,GAA+B;QACzC,GAAG,CAAC,MAAM,wBAAwB,CAChC,QAAQ,EACR,OAAO,EACP,OAAO,EACP,KAAK,CAAC,UAAU,CACd,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EACzB,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAC1C,OAAO,CAAC,SAAS,IAAI,KAAK,CAC3B,EACD,WAAW,IAAI,CAAC,aAAa,EAAE,GAAG,WAAW,CAAC,CAC/C,CAAC;QACF,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;KAClC,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,CACpB,aAAa,EACb,4BAA4B,UAAU,EAAE,OAAO,CAChD,CAAC;IACF,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YACjE,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACpE,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,4BAA4B,CAC1C,QAA4B,EAC5B,UAA8B;IAE9B,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,IAAI,kBAAkB,CAC1B,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,aAAqB,EACrB,MAAc,EACd,QAA4B,EAC5B,MAAoB,EACpB,WAAW,GAAsB,OAAO,CAAC,GAAG;IAE5C,MAAM,cAAc,GAAG,MAAM,IAAI,aAAa,CAC5C,WAAW,EACX,aAAa,EACb,MAAM,CACP,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,OAAO,cAAc,KAAK,SAAS;QACjC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,8BAA8B,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { rename, rm, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport {\n classifySeverityInternal,\n validateSeverityClassification,\n type ClassifySeverityOptions,\n type SeverityClassification,\n} from \"./classify-severity.js\";\nimport { loadContractWithScanDirectory } from \"./contract.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport type { Finding } from \"./models.js\";\nimport type { DocumentRoots } from \"./prompt-files.js\";\nimport { bundledPluginRoot } from \"./runtime.js\";\nimport { savedScanWorkbench } from \"./saved-scan-bootstrap.js\";\nimport {\n resolveCompletedScan,\n type SavedScanDependencies,\n} from \"./saved-scan.js\";\nimport { SeverityStore } from \"./severity-store.js\";\nimport { documentSourceRoot, nullIfMissingPath } from \"./targets.js\";\n\nconst CLASSIFICATION_FILE = \"severity-classification.json\";\nexport interface ScanSeverityClassification extends SeverityClassification {\n scanId: string;\n}\n\nexport interface ClassifyScanSeverityOptions extends ClassifySeverityOptions {\n /** Exact selection, such as dedupe's scanRepresentativeFindingIds. Omit to classify all findings. */\n findingIds?: readonly string[];\n /** Reclassify selected findings even when their saved assessment matches the inputs. */\n reprocess?: boolean;\n expectedScanId?: string;\n}\n\n/** Resolve a saved scan ID, unique prefix, or latest and save its classification. */\nexport async function classifyScanSeverity(\n scanId: string,\n options: ClassifyScanSeverityOptions = {},\n): Promise<ScanSeverityClassification> {\n return classifyScanSeverityInternal(scanId, options);\n}\n\n/** @internal */\nexport async function classifyScanSeverityInternal(\n scanId: string,\n options: ClassifyScanSeverityOptions = {},\n dependencies: Partial<SavedScanDependencies> = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n): Promise<ScanSeverityClassification> {\n options.signal?.throwIfAborted();\n const environment = options.environment ?? process.env;\n const pluginRoot = await bundledPluginRoot();\n const currentDirectory = dependencies.currentDirectory?.() ?? process.cwd();\n const bootstrap = dependencies.runWorkbench\n ? undefined\n : await savedScanWorkbench(scanId, {\n environment,\n pluginRoot,\n currentDirectory,\n signal: options.signal,\n });\n const scan = await resolveCompletedScan(scanId, {\n currentDirectory: () => currentDirectory,\n runWorkbench: (args, input) =>\n (dependencies.runWorkbench ?? bootstrap!)(args, input, options.signal),\n });\n if (\n options.expectedScanId !== undefined &&\n options.expectedScanId !== scan.scanId\n ) {\n throw new CodexSecurityError(\"Saved scan does not match expectedScanId.\");\n }\n const target = scan[\"targetPath\"];\n // The workbench enables remediation only for the recorded checkout and revision.\n const sourceRoot =\n scan[\"remediationAvailable\"] === true &&\n typeof target === \"string\" &&\n (options.rubricPath !== undefined || options.knowledgeBasePaths?.length)\n ? await documentSourceRoot(target, options.signal).catch(\n nullIfMissingPath,\n )\n : null;\n return classifyScanDirectorySeverityInternal(\n scan.scanDir,\n { ...options, expectedScanId: scan.scanId },\n surface,\n bootstrap?.protectedRoots,\n sourceRoot === null ? null : [sourceRoot],\n );\n}\n\n/** Classify a sealed scan directory and save a separate assessment without changing its artifacts. */\nexport async function classifyScanDirectorySeverity(\n scanDirectory: string,\n options: ClassifyScanSeverityOptions = {},\n): Promise<ScanSeverityClassification> {\n return classifyScanDirectorySeverityInternal(scanDirectory, options);\n}\n\n/** @internal */\nexport async function classifyScanDirectorySeverityInternal(\n requestedDirectory: string,\n options: ClassifyScanSeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n protectedRoots: readonly string[] = [],\n sourceRoots: DocumentRoots = [],\n): Promise<ScanSeverityClassification> {\n const { contract, scanDirectory } = await loadContractWithScanDirectory(\n requestedDirectory,\n {\n pluginRoot: await bundledPluginRoot(),\n expectedScanId: options.expectedScanId,\n signal: options.signal,\n },\n );\n const findings = selectClassificationFindings(\n contract.findings.findings,\n options.findingIds,\n );\n const store = new SeverityStore(\n options.environment ?? process.env,\n scanDirectory,\n options.signal,\n protectedRoots,\n );\n const result: ScanSeverityClassification = {\n ...(await classifySeverityInternal(\n findings,\n options,\n surface,\n store.checkpoint(\n contract.manifest.scan.id,\n findings.map(({ findingId }) => findingId),\n options.reprocess ?? false,\n ),\n sourceRoots && [scanDirectory, ...sourceRoots],\n )),\n scanId: contract.manifest.scan.id,\n };\n options.signal?.throwIfAborted();\n const temporary = join(\n scanDirectory,\n `.severity-classification-${randomUUID()}.json`,\n );\n try {\n await writeFile(temporary, `${JSON.stringify(result, null, 2)}\\n`, {\n flag: \"wx\",\n mode: 0o600,\n signal: options.signal,\n });\n options.signal?.throwIfAborted();\n await rename(temporary, join(scanDirectory, CLASSIFICATION_FILE));\n } finally {\n await rm(temporary, { force: true });\n }\n return result;\n}\n\n/** @internal */\nexport function selectClassificationFindings(\n findings: readonly Finding[],\n findingIds?: readonly string[],\n): readonly Finding[] {\n if (findingIds === undefined) return findings;\n const selected = new Set(findingIds);\n const result = findings.filter((finding) => selected.has(finding.findingId));\n if (result.length !== selected.size) {\n throw new CodexSecurityError(\n \"Selected finding IDs must belong to the supplied scan.\",\n );\n }\n return result;\n}\n\n/** @internal */\nexport async function readScanSeverityClassification(\n scanDirectory: string,\n scanId: string,\n findings: readonly Finding[],\n signal?: AbortSignal,\n environment: NodeJS.ProcessEnv = process.env,\n): Promise<SeverityClassification | undefined> {\n const classification = await new SeverityStore(\n environment,\n scanDirectory,\n signal,\n ).read(scanId);\n return classification === undefined\n ? undefined\n : validateSeverityClassification(classification, findings);\n}\n"]}
@@ -14,15 +14,7 @@ export declare const classifySeverityRecordsInputSchema: z.ZodObject<{
14
14
  sha256: z.ZodString;
15
15
  }, z.core.$strict>>;
16
16
  model: z.ZodString;
17
- effort: z.ZodEnum<{
18
- high: "high";
19
- low: "low";
20
- max: "max";
21
- medium: "medium";
22
- minimal: "minimal";
23
- ultra: "ultra";
24
- xhigh: "xhigh";
25
- }>;
17
+ effort: z.ZodString;
26
18
  records: z.ZodArray<z.ZodObject<{
27
19
  id: z.ZodString;
28
20
  revision: z.ZodNumber;
@@ -1 +1 @@
1
- {"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAO9B,eAAO,MAAM,4BAA4B;;;;kBAIvC,CAAC;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;kBAyBpC,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,yBAAyB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QACZ,GAAG,CACD,OAAO,EAAE,mCAAmC,EAC5C,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,gBAAgB,EAChB,WAAW,CACZ,GAAG;IACF,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,GAC9D,CACI;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,2BAA2B,EAAE,CAAA;CAAE,GACnE;IACE,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CACJ,CAAC;AAMJ;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAuFxC"}
1
+ {"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAO9B,eAAO,MAAM,4BAA4B;;;;kBAIvC,CAAC;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;kBAiBpC,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,yBAAyB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QACZ,GAAG,CACD,OAAO,EAAE,mCAAmC,EAC5C,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,gBAAgB,EAChB,WAAW,CACZ,GAAG;IACF,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,GAC9D,CACI;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,2BAA2B,EAAE,CAAA;CAAE,GACnE;IACE,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CACJ,CAAC;AAMJ;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAqFxC"}