@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
@@ -1 +1 @@
1
- {"version":3,"file":"github-dependabot-findings.js","sourceRoot":"","sources":["../src/github-dependabot-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { GHSA_ID, githubRepositoryParts } from \"./github-identifiers.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport {\n type ExternalImportTarget,\n validateExternalEvidence,\n} from \"./external-import-contract.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport { isGitHubCloudHost } from \"./git-remote.js\";\nimport { isRecord } from \"./record.js\";\nimport {\n trackReaderSelection,\n record,\n relativePath,\n requiredText,\n text,\n} from \"./scanner-import.js\";\n\nexport function isGitHubDependabotAlert(\n value: unknown,\n): value is Record<string, unknown> {\n return (\n isRecord(value) &&\n (\"security_vulnerability\" in value ||\n (\"dependency\" in value && \"security_advisory\" in value) ||\n [value[\"url\"], value[\"html_url\"]].some(\n (url) =>\n typeof url === \"string\" &&\n /^\\/(?:[^/]+\\/[^/]+\\/security\\/dependabot|(?:api\\/v3\\/)?repos\\/[^/]+\\/[^/]+\\/dependabot\\/alerts)\\/\\d+$/iu.test(\n URL.parse(url)?.pathname ?? \"\",\n ),\n ))\n );\n}\n\nfunction webIdentity(url: string) {\n const match =\n /^(https?):\\/\\/([^/?#@\\\\\\s]+)\\/([^/?#]+\\/[^/?#]+)\\/security\\/dependabot\\/([1-9]\\d*)$/iu.exec(\n url,\n );\n if (!match || !githubRepositoryParts(match[3]!)) return null;\n const parsed = URL.parse(url);\n if (\n !parsed ||\n (parsed.protocol === \"http:\" && isGitHubCloudHost(parsed.hostname))\n )\n return null;\n const host = match[2]!.toLowerCase();\n const repository = match[3]!.toLowerCase();\n const origin = `${parsed.protocol}//${host}`;\n const number = match[4]!;\n const apiBase = isGitHubCloudHost(parsed.hostname)\n ? `https://api.${host}`\n : `${origin}/api/v3`;\n const repositoryUrl = `${origin}/${repository}`;\n const apiRepo = `${apiBase}/repos/${repository}`;\n return {\n repository,\n repositoryUrl,\n apiRepo,\n number,\n sourceId: `${host}/${repository}/dependabot/${number}`,\n htmlUrl: `${repositoryUrl}/security/dependabot/${number}`,\n apiUrl: `${apiRepo}/dependabot/alerts/${number}`,\n };\n}\n\n// Normalized SDK evidence may link to either REST or the web UI.\nfunction alertUrlIdentity(url: unknown) {\n if (typeof url !== \"string\") return null;\n const web = webIdentity(url);\n if (web) return web;\n const api =\n /^(https?:\\/\\/)([^/?#@\\\\\\s]+)\\/(api\\/v3\\/)?repos\\/([^/]+\\/[^/]+)\\/dependabot\\/alerts\\/([1-9]\\d*)$/iu.exec(\n url,\n );\n if (!api) return null;\n const host = api[3] ? api[2] : api[2]!.replace(/^api\\./iu, \"\");\n const parsed = webIdentity(\n `${api[1]}${host}/${api[4]}/security/dependabot/${api[5]}`,\n );\n return parsed?.apiUrl === url.toLowerCase() ? parsed : null;\n}\n\nfunction checkSourceFamily(alert: Record<string, unknown>) {\n if (\n alert[\"source\"] === \"github-code-scanning\" ||\n alert[\"source\"] === \"github-security-advisory\"\n )\n throw new Error(\n \"Dependabot alert conflicts with its GitHub source family.\",\n );\n}\n\nfunction checkNativeClaims(\n alert: Record<string, unknown>,\n occurrence: NonNullable<ReturnType<typeof webIdentity>>,\n) {\n if (\"number\" in alert && alert[\"number\"] !== Number(occurrence.number))\n throw new Error(\n \"Dependabot alert number must match the repository alert URL.\",\n );\n if (\n (\"url\" in alert &&\n text(alert[\"url\"])?.toLowerCase() !== occurrence.apiUrl) ||\n (\"html_url\" in alert &&\n text(alert[\"html_url\"])?.toLowerCase() !== occurrence.htmlUrl)\n )\n throw new Error(\n \"Dependabot API url and html_url must identify the same host, repository and alert number.\",\n );\n if (\"repository\" in alert) {\n const declared = record(alert[\"repository\"], \"Dependabot repository\");\n if (\n text(declared[\"full_name\"])?.toLowerCase() !== occurrence.repository ||\n (\"html_url\" in declared &&\n text(declared[\"html_url\"])?.toLowerCase() !==\n occurrence.repositoryUrl) ||\n (\"url\" in declared &&\n text(declared[\"url\"])?.toLowerCase() !== occurrence.apiRepo)\n )\n throw new Error(\n \"Dependabot repository metadata conflicts with its alert URLs.\",\n );\n }\n}\n\nfunction identity(alert: Record<string, unknown>) {\n checkSourceFamily(alert);\n const number = alert[\"number\"];\n if (typeof number !== \"number\" || !Number.isSafeInteger(number) || number < 1)\n throw new Error(\"Dependabot alert number must be a positive safe integer.\");\n const url = requiredText(alert[\"html_url\"], \"Dependabot html_url\");\n const parsed = webIdentity(url);\n if (!parsed || parsed.number !== String(number))\n throw new Error(\n \"Dependabot html_url must identify the repository and alert number.\",\n );\n requiredText(alert[\"url\"], \"Dependabot API url\");\n checkNativeClaims(alert, parsed);\n return {\n repositoryUrl: parsed.repositoryUrl,\n sourceId: parsed.sourceId,\n url,\n };\n}\n\nexport function dependabotRepository({\n source_finding_id: id,\n evidence: { source_data: sourceData, url },\n}: ExternalFinding): string | undefined {\n const native = isGitHubDependabotAlert(sourceData) ? sourceData : null;\n const raw =\n native &&\n (alertUrlIdentity(native[\"html_url\"]) ?? alertUrlIdentity(native[\"url\"]));\n const projected = alertUrlIdentity(url);\n const occurrence = raw ?? projected;\n const structuredId =\n /^[^/]+\\/[^/]+\\/[^/]+\\/(?:dependabot|code-scanning|security-advisory)\\//u.test(\n id,\n );\n if (!occurrence) {\n if (/^[^/]+\\/[^/]+\\/[^/]+\\/dependabot\\/[1-9]\\d*$/u.test(id))\n throw new CodexSecurityError(\n \"The normalized Dependabot occurrence needs the original alert or its repository alert URL.\",\n );\n return;\n }\n if (isRecord(sourceData)) checkSourceFamily(sourceData);\n if (native) checkNativeClaims(native, occurrence);\n // A caller may have stored this occurrence under an opaque ID before native imports existed.\n if ((structuredId || id === \"\") && id !== occurrence.sourceId)\n throw new CodexSecurityError(\n \"The normalized source finding ID does not match the original Dependabot alert.\",\n );\n if (raw && projected && raw.htmlUrl !== projected.htmlUrl)\n throw new CodexSecurityError(\n \"The normalized alert URL does not match the original Dependabot alert.\",\n );\n return occurrence.repositoryUrl;\n}\n\nfunction selectedAlerts(input: unknown) {\n const selection = Array.isArray(input) ? input : [input];\n const hasPages = selection.some(Array.isArray);\n if (hasPages && !selection.every(Array.isArray))\n throw new Error(\n \"Dependabot input must not mix alert records and page arrays.\",\n );\n const rows: unknown[] = hasPages ? selection.flat() : selection;\n if (!rows.every(isGitHubDependabotAlert))\n throw new Error(\n \"Expected complete native Dependabot repository alerts, not mixed families, page shapes or API envelopes.\",\n );\n return rows;\n}\n\n// Parse only the matched vulnerability projection. Keep the complete upstream alert as evidence.\nconst nonblank = z.string().regex(/\\S/u);\nconst matchedVulnerability = z.object({\n package: z.object({ name: nonblank, ecosystem: nonblank }),\n vulnerable_version_range: nonblank,\n first_patched_version: z.object({ identifier: nonblank }).nullable(),\n severity: z.enum([\"critical\", \"high\", \"medium\", \"low\"]),\n});\n\nfunction evidence(alert: Record<string, unknown>, url: string) {\n const dependency = record(alert[\"dependency\"], \"Dependabot dependency\");\n const advisory = record(\n alert[\"security_advisory\"],\n \"Dependabot security_advisory\",\n );\n const {\n package: { name, ecosystem },\n vulnerable_version_range: range,\n first_patched_version: patch,\n severity,\n } = matchedVulnerability.parse(alert[\"security_vulnerability\"]);\n if (\"package\" in dependency) {\n const observed = record(\n dependency[\"package\"],\n \"Dependabot dependency package\",\n );\n if (observed[\"name\"] !== name || observed[\"ecosystem\"] !== ecosystem)\n throw new Error(\n \"Dependabot dependency and matched vulnerability packages disagree.\",\n );\n }\n const path = dependency[\"manifest_path\"] ?? null;\n if (path !== null) {\n const filename = relativePath(path)?.split(\"/\").at(-1);\n if (\n typeof path !== \"string\" ||\n /^[a-z][a-z\\d+.-]*:/iu.test(path) ||\n !filename ||\n filename === \".\"\n )\n throw new Error(\n \"Dependabot manifest_path must identify a repository-relative file.\",\n );\n }\n const ghsa = requiredText(advisory[\"ghsa_id\"], \"Dependabot GHSA ID\");\n if (!GHSA_ID.test(ghsa))\n throw new Error(\"Dependabot security_advisory must identify a GHSA.\");\n const affected = advisory[\"vulnerabilities\"];\n if (\n !Array.isArray(affected) ||\n !affected.some(\n (entry) =>\n isRecord(entry) &&\n isRecord(entry[\"package\"]) &&\n entry[\"package\"][\"name\"] === name &&\n entry[\"package\"][\"ecosystem\"] === ecosystem &&\n entry[\"vulnerable_version_range\"] === range,\n )\n )\n throw new Error(\n \"Dependabot advisory does not cover the matched package and vulnerable range.\",\n );\n const state = alert[\"state\"];\n if (\n typeof state !== \"string\" ||\n ![\"open\", \"dismissed\", \"auto_dismissed\", \"fixed\"].includes(state)\n )\n throw new Error(\n \"Dependabot alert state must be open, dismissed, auto_dismissed or fixed.\",\n );\n const updated =\n Date.parse(requiredText(alert[\"updated_at\"], \"Dependabot updated_at\")) /\n 1000;\n if (!Number.isFinite(updated) || updated < 0)\n throw new Error(\"Dependabot updated_at must be a valid timestamp.\");\n const advisoryIds = new Set([ghsa]);\n const cve = text(advisory[\"cve_id\"]);\n if (cve) advisoryIds.add(cve);\n const identifiers = advisory[\"identifiers\"];\n if (Array.isArray(identifiers)) {\n for (const item of identifiers) {\n const value = isRecord(item) && text(item[\"value\"]);\n if (!value) continue;\n if (\n (item[\"type\"] === \"GHSA\" || /^GHSA-/iu.test(value)) &&\n value.toUpperCase() !== ghsa.toUpperCase()\n )\n throw new Error(\n \"Dependabot advisory identifiers disagree on the GHSA.\",\n );\n advisoryIds.add(value);\n }\n }\n return {\n title: requiredText(advisory[\"summary\"], \"Dependabot advisory summary\"),\n description: text(advisory[\"description\"]),\n severity,\n url,\n advisory_ids: [...advisoryIds],\n packages: [\n {\n name,\n ecosystem,\n manifest_path: path,\n vulnerable_version_range: range,\n fixed_versions: patch ? [patch.identifier] : [],\n },\n ],\n locations: path ? [{ path }] : [],\n source_updated_at: Math.floor(updated),\n source_data: structuredClone(alert),\n };\n}\n\nexport function normalizeGitHubDependabotAlerts(\n input: unknown,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n const alerts = selectedAlerts(input);\n const result: ExternalFindings = {\n read: alerts.length,\n findings: [],\n excluded: [],\n };\n const selection = trackReaderSelection(result);\n const ids = new Set<string>();\n let sourceRepository: string | undefined;\n for (const [index, alert] of alerts.entries()) {\n const { repositoryUrl, sourceId, url } = identity(alert);\n if (sourceRepository !== undefined && sourceRepository !== repositoryUrl)\n throw new CodexSecurityError(\n \"Select Dependabot alerts from only one GitHub host and repository.\",\n );\n sourceRepository = repositoryUrl;\n if (ids.has(sourceId))\n throw new CodexSecurityError(\n `Duplicate source finding id ${JSON.stringify(sourceId)}. Select each Dependabot alert once.`,\n );\n ids.add(sourceId);\n const inputEvidence = evidence(alert, url);\n selection.append(index + 1, sourceId, () => {\n if (target === \"cloud\" && Buffer.byteLength(sourceId) > 512)\n throw new Error(\n \"Source finding ID exceeds the Cloud limit of 512 UTF-8 bytes.\",\n );\n return validateExternalEvidence(inputEvidence, target);\n });\n }\n return selection.finish();\n}\n"]}
1
+ {"version":3,"file":"github-dependabot-findings.js","sourceRoot":"","sources":["../src/github-dependabot-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { GHSA_ID, githubRepositoryParts } from \"./github-identifiers.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport {\n type ExternalImportTarget,\n validateExternalEvidence,\n} from \"./external-import-contract.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport { isGitHubCloudHost } from \"./git-remote.js\";\nimport { isRecord } from \"./record.js\";\nimport { REPORTABLE_SEVERITIES } from \"./scan-settings.js\";\nimport {\n appendFinding,\n record,\n relativePath,\n requiredText,\n text,\n} from \"./scanner-import.js\";\n\nexport function isGitHubDependabotAlert(\n value: unknown,\n): value is Record<string, unknown> {\n return (\n isRecord(value) &&\n (\"security_vulnerability\" in value ||\n (\"dependency\" in value && \"security_advisory\" in value) ||\n [value[\"url\"], value[\"html_url\"]].some(\n (url) =>\n typeof url === \"string\" &&\n /^\\/(?:[^/]+\\/[^/]+\\/security\\/dependabot|(?:api\\/v3\\/)?repos\\/[^/]+\\/[^/]+\\/dependabot\\/alerts)\\/\\d+$/iu.test(\n URL.parse(url)?.pathname ?? \"\",\n ),\n ))\n );\n}\n\nfunction webIdentity(url: string) {\n const match =\n /^(https?):\\/\\/([^/?#@\\\\\\s]+)\\/([^/?#]+\\/[^/?#]+)\\/security\\/dependabot\\/([1-9]\\d*)$/iu.exec(\n url,\n );\n if (!match || !githubRepositoryParts(match[3]!)) return null;\n const parsed = URL.parse(url);\n if (\n !parsed ||\n (parsed.protocol === \"http:\" && isGitHubCloudHost(parsed.hostname))\n )\n return null;\n const host = match[2]!.toLowerCase();\n const repository = match[3]!.toLowerCase();\n const origin = `${parsed.protocol}//${host}`;\n const number = match[4]!;\n const apiBase = isGitHubCloudHost(parsed.hostname)\n ? `https://api.${host}`\n : `${origin}/api/v3`;\n const repositoryUrl = `${origin}/${repository}`;\n const apiRepo = `${apiBase}/repos/${repository}`;\n return {\n repository,\n repositoryUrl,\n apiRepo,\n number,\n sourceId: `${host}/${repository}/dependabot/${number}`,\n htmlUrl: `${repositoryUrl}/security/dependabot/${number}`,\n apiUrl: `${apiRepo}/dependabot/alerts/${number}`,\n };\n}\n\n// Normalized SDK evidence may link to either REST or the web UI.\nfunction alertUrlIdentity(url: unknown) {\n if (typeof url !== \"string\") return null;\n const web = webIdentity(url);\n if (web) return web;\n const api =\n /^(https?:\\/\\/)([^/?#@\\\\\\s]+)\\/(api\\/v3\\/)?repos\\/([^/]+\\/[^/]+)\\/dependabot\\/alerts\\/([1-9]\\d*)$/iu.exec(\n url,\n );\n if (!api) return null;\n const host = api[3] ? api[2] : api[2]!.replace(/^api\\./iu, \"\");\n const parsed = webIdentity(\n `${api[1]}${host}/${api[4]}/security/dependabot/${api[5]}`,\n );\n return parsed?.apiUrl === url.toLowerCase() ? parsed : null;\n}\n\nfunction checkSourceFamily(alert: Record<string, unknown>) {\n if (\n alert[\"source\"] === \"github-code-scanning\" ||\n alert[\"source\"] === \"github-security-advisory\"\n )\n throw new Error(\n \"Dependabot alert conflicts with its GitHub source family.\",\n );\n}\n\nfunction checkNativeClaims(\n alert: Record<string, unknown>,\n occurrence: NonNullable<ReturnType<typeof webIdentity>>,\n) {\n if (\"number\" in alert && alert[\"number\"] !== Number(occurrence.number))\n throw new Error(\n \"Dependabot alert number must match the repository alert URL.\",\n );\n if (\n (\"url\" in alert &&\n text(alert[\"url\"])?.toLowerCase() !== occurrence.apiUrl) ||\n (\"html_url\" in alert &&\n text(alert[\"html_url\"])?.toLowerCase() !== occurrence.htmlUrl)\n )\n throw new Error(\n \"Dependabot API url and html_url must identify the same host, repository and alert number.\",\n );\n if (\"repository\" in alert) {\n const declared = record(alert[\"repository\"], \"Dependabot repository\");\n if (\n text(declared[\"full_name\"])?.toLowerCase() !== occurrence.repository ||\n (\"html_url\" in declared &&\n text(declared[\"html_url\"])?.toLowerCase() !==\n occurrence.repositoryUrl) ||\n (\"url\" in declared &&\n text(declared[\"url\"])?.toLowerCase() !== occurrence.apiRepo)\n )\n throw new Error(\n \"Dependabot repository metadata conflicts with its alert URLs.\",\n );\n }\n}\n\nfunction identity(alert: Record<string, unknown>) {\n checkSourceFamily(alert);\n const number = alert[\"number\"];\n if (typeof number !== \"number\" || !Number.isSafeInteger(number) || number < 1)\n throw new Error(\"Dependabot alert number must be a positive safe integer.\");\n const url = requiredText(alert[\"html_url\"], \"Dependabot html_url\");\n const parsed = webIdentity(url);\n if (!parsed || parsed.number !== String(number))\n throw new Error(\n \"Dependabot html_url must identify the repository and alert number.\",\n );\n requiredText(alert[\"url\"], \"Dependabot API url\");\n checkNativeClaims(alert, parsed);\n return {\n repositoryUrl: parsed.repositoryUrl,\n sourceId: parsed.sourceId,\n url,\n };\n}\n\nexport function dependabotRepository({\n source_finding_id: id,\n evidence: { source_data: sourceData, url },\n}: ExternalFinding): string | undefined {\n const native = isGitHubDependabotAlert(sourceData) ? sourceData : null;\n const raw =\n native &&\n (alertUrlIdentity(native[\"html_url\"]) ?? alertUrlIdentity(native[\"url\"]));\n const projected = alertUrlIdentity(url);\n const occurrence = raw ?? projected;\n const structuredId =\n /^[^/]+\\/[^/]+\\/[^/]+\\/(?:dependabot|code-scanning|security-advisory)\\//u.test(\n id,\n );\n if (!occurrence) {\n if (/^[^/]+\\/[^/]+\\/[^/]+\\/dependabot\\/[1-9]\\d*$/u.test(id))\n throw new CodexSecurityError(\n \"The normalized Dependabot occurrence needs the original alert or its repository alert URL.\",\n );\n return;\n }\n if (isRecord(sourceData)) checkSourceFamily(sourceData);\n if (native) checkNativeClaims(native, occurrence);\n // A caller may have stored this occurrence under an opaque ID before native imports existed.\n if ((structuredId || id === \"\") && id !== occurrence.sourceId)\n throw new CodexSecurityError(\n \"The normalized source finding ID does not match the original Dependabot alert.\",\n );\n if (raw && projected && raw.htmlUrl !== projected.htmlUrl)\n throw new CodexSecurityError(\n \"The normalized alert URL does not match the original Dependabot alert.\",\n );\n return occurrence.repositoryUrl;\n}\n\nfunction selectedAlerts(input: unknown) {\n const selection = Array.isArray(input) ? input : [input];\n const hasPages = selection.some(Array.isArray);\n if (hasPages && !selection.every(Array.isArray))\n throw new Error(\n \"Dependabot input must not mix alert records and page arrays.\",\n );\n const rows: unknown[] = hasPages ? selection.flat() : selection;\n if (!rows.every(isGitHubDependabotAlert))\n throw new Error(\n \"Expected complete native Dependabot repository alerts, not mixed families, page shapes or API envelopes.\",\n );\n return rows;\n}\n\n// Parse only the matched vulnerability projection. Keep the complete upstream alert as evidence.\nconst nonblank = z.string().regex(/\\S/u);\nconst matchedVulnerability = z.object({\n package: z.object({ name: nonblank, ecosystem: nonblank }),\n vulnerable_version_range: nonblank,\n first_patched_version: z.object({ identifier: nonblank }).nullable(),\n severity: z.enum(REPORTABLE_SEVERITIES),\n});\n\n// Python distribution identity ignores case and treats runs of -, _ and . alike.\nfunction packageNameKey(ecosystem: string, name: unknown): unknown {\n if (\n ecosystem === \"pip\" &&\n typeof name === \"string\" &&\n /^[a-zA-Z0-9](?:[a-zA-Z0-9._-]*[a-zA-Z0-9])?$/u.test(name)\n )\n return name.toLowerCase().replace(/[-_.]+/gu, \"-\");\n return name;\n}\n\nfunction evidence(alert: Record<string, unknown>, url: string) {\n const dependency = record(alert[\"dependency\"], \"Dependabot dependency\");\n const advisory = record(\n alert[\"security_advisory\"],\n \"Dependabot security_advisory\",\n );\n const {\n package: { name, ecosystem },\n vulnerable_version_range: range,\n first_patched_version: patch,\n severity,\n } = matchedVulnerability.parse(alert[\"security_vulnerability\"]);\n const nameKey = packageNameKey(ecosystem, name);\n const matchesPackage = (pkg: Record<string, unknown>) =>\n pkg[\"ecosystem\"] === ecosystem &&\n packageNameKey(ecosystem, pkg[\"name\"]) === nameKey;\n if (\"package\" in dependency) {\n const observed = record(\n dependency[\"package\"],\n \"Dependabot dependency package\",\n );\n if (!matchesPackage(observed))\n throw new Error(\n \"Dependabot dependency and matched vulnerability packages disagree.\",\n );\n }\n const path = dependency[\"manifest_path\"] ?? null;\n if (path !== null) {\n const filename = relativePath(path)?.split(\"/\").at(-1);\n if (\n typeof path !== \"string\" ||\n /^[a-z][a-z\\d+.-]*:/iu.test(path) ||\n !filename ||\n filename === \".\"\n )\n throw new Error(\n \"Dependabot manifest_path must identify a repository-relative file.\",\n );\n }\n const ghsa = requiredText(advisory[\"ghsa_id\"], \"Dependabot GHSA ID\");\n if (!GHSA_ID.test(ghsa))\n throw new Error(\"Dependabot security_advisory must identify a GHSA.\");\n const affected = advisory[\"vulnerabilities\"];\n if (\n !Array.isArray(affected) ||\n !affected.some(\n (entry) =>\n isRecord(entry) &&\n isRecord(entry[\"package\"]) &&\n matchesPackage(entry[\"package\"]) &&\n entry[\"vulnerable_version_range\"] === range,\n )\n )\n throw new Error(\n \"Dependabot advisory does not cover the matched package and vulnerable range.\",\n );\n const state = alert[\"state\"];\n if (\n typeof state !== \"string\" ||\n ![\"open\", \"dismissed\", \"auto_dismissed\", \"fixed\"].includes(state)\n )\n throw new Error(\n \"Dependabot alert state must be open, dismissed, auto_dismissed or fixed.\",\n );\n const updated =\n Date.parse(requiredText(alert[\"updated_at\"], \"Dependabot updated_at\")) /\n 1000;\n if (!Number.isFinite(updated) || updated < 0)\n throw new Error(\"Dependabot updated_at must be a valid timestamp.\");\n const advisoryIds = new Set([ghsa]);\n const cve = text(advisory[\"cve_id\"]);\n if (cve) advisoryIds.add(cve);\n const identifiers = advisory[\"identifiers\"];\n if (Array.isArray(identifiers)) {\n for (const item of identifiers) {\n const value = isRecord(item) && text(item[\"value\"]);\n if (!value) continue;\n if (\n (item[\"type\"] === \"GHSA\" || /^GHSA-/iu.test(value)) &&\n value.toUpperCase() !== ghsa.toUpperCase()\n )\n throw new Error(\n \"Dependabot advisory identifiers disagree on the GHSA.\",\n );\n advisoryIds.add(value);\n }\n }\n return {\n title: requiredText(advisory[\"summary\"], \"Dependabot advisory summary\"),\n description: text(advisory[\"description\"]),\n severity,\n url,\n advisory_ids: [...advisoryIds],\n packages: [\n {\n name,\n ecosystem,\n manifest_path: path,\n vulnerable_version_range: range,\n fixed_versions: patch ? [patch.identifier] : [],\n },\n ],\n locations: path ? [{ path }] : [],\n source_updated_at: Math.floor(updated),\n source_data: structuredClone(alert),\n };\n}\n\nexport function normalizeGitHubDependabotAlerts(\n input: unknown,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n const alerts = selectedAlerts(input);\n const result: ExternalFindings = {\n read: alerts.length,\n findings: [],\n excluded: [],\n };\n const ids = new Set<string>();\n let sourceRepository: string | undefined;\n for (const [index, alert] of alerts.entries()) {\n const { repositoryUrl, sourceId, url } = identity(alert);\n if (sourceRepository !== undefined && sourceRepository !== repositoryUrl)\n throw new CodexSecurityError(\n \"Select Dependabot alerts from only one GitHub host and repository.\",\n );\n sourceRepository = repositoryUrl;\n if (ids.has(sourceId))\n throw new CodexSecurityError(\n `Duplicate source finding id ${JSON.stringify(sourceId)}. Select each Dependabot alert once.`,\n );\n ids.add(sourceId);\n const inputEvidence = evidence(alert, url);\n appendFinding(result, index + 1, sourceId, () => {\n if (target === \"cloud\" && Buffer.byteLength(sourceId) > 512)\n throw new Error(\n \"Source finding ID exceeds the Cloud limit of 512 UTF-8 bytes.\",\n );\n return validateExternalEvidence(inputEvidence, target);\n });\n }\n return result;\n}\n"]}
@@ -1,7 +1,10 @@
1
1
  import type { ExternalImportTarget } from "./external-import-contract.js";
2
- import type { ExternalFindings } from "./external-findings.js";
2
+ import { cloudRepositoryUrlKey } from "./external-import-contract.js";
3
+ import type { ExternalFinding, ExternalFindings } from "./external-findings.js";
3
4
  import type { ImportedGitHubCodeScanningAlert } from "./github.js";
4
5
  import type { ImportedGitHubAdvisory } from "./github-advisories.js";
6
+ /** Keep the repository from a retained collector export when SDK callers supply their own projection. */
7
+ export declare function retainedGitHubRepository({ evidence }: ExternalFinding, repositoryKey?: typeof cloudRepositoryUrlKey): string | undefined;
5
8
  /** Map selected code-scanning instances while retaining complete upstream evidence. */
6
9
  export declare function normalizeGitHubCodeScanningAlerts(alerts: readonly ImportedGitHubCodeScanningAlert[], target?: ExternalImportTarget): ExternalFindings;
7
10
  /** Map advisory disclosures without asserting an installed vulnerable dependency. */
@@ -1 +1 @@
1
- {"version":3,"file":"github-findings.d.ts","sourceRoot":"","sources":["../src/github-findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAc1E,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AA6nBrE,uFAAuF;AACvF,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,SAAS,+BAA+B,EAAE,EAClD,MAAM,GAAE,oBAA8B,GACrC,gBAAgB,CAElB;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,sBAAsB,EAAE,EAC7C,MAAM,GAAE,oBAA8B,GACrC,gBAAgB,CAElB;AAED,uFAAuF;AACvF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,oBAA8B,GACrC,OAAO,CAAC,gBAAgB,CAAC,CAoB3B"}
1
+ {"version":3,"file":"github-findings.d.ts","sourceRoot":"","sources":["../src/github-findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAK1E,OAAO,EACL,qBAAqB,EAGtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAsQrE,yGAAyG;AACzG,wBAAgB,wBAAwB,CACtC,EAAE,QAAQ,EAAE,EAAE,eAAe,EAC7B,aAAa,+BAAwB,GACpC,MAAM,GAAG,SAAS,CAiCpB;AA8DD,uFAAuF;AACvF,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,SAAS,+BAA+B,EAAE,EAClD,MAAM,GAAE,oBAA8B,GACrC,gBAAgB,CAElB;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,sBAAsB,EAAE,EAC7C,MAAM,GAAE,oBAA8B,GACrC,gBAAgB,CAElB;AAED,uFAAuF;AACvF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,oBAA8B,GACrC,OAAO,CAAC,gBAAgB,CAAC,CAoB3B"}
@@ -1,13 +1,11 @@
1
1
  import { hash } from "node:crypto";
2
- import { isDeepStrictEqual } from "node:util";
3
- import { isBoxedPrimitive, isDate, isProxy } from "node:util/types";
2
+ import { isProxy } from "node:util/types";
4
3
  import { GHSA_ID, githubRepositoryParts } from "./github-identifiers.js";
5
4
  import { CodexSecurityError, errorMessage } from "./errors.js";
6
- import { CloudEvidenceDepthError, exportedGitHubRecord, previousGitHubExclusion, validateExternalEvidenceFields, validateExternalEvidenceJson, validateExternalEvidence, } from "./external-import-contract.js";
5
+ import { cloudRepositoryUrlKey, exportedGitHubRecord, validateExternalEvidence, } from "./external-import-contract.js";
7
6
  import { isGitHubDependabotAlert, normalizeGitHubDependabotAlerts, } from "./github-dependabot-findings.js";
8
- import { asRecord, canSnapshotWithoutGetters, cloneWithoutGetters, } from "./record.js";
9
- import { parseJsonOrJsonl, readScannerText, text } from "./scanner-import.js";
10
- import { rememberPreviousSelection, } from "./reader-selection.js";
7
+ import { asRecord } from "./record.js";
8
+ import { parseJsonOrJsonl, readScannerText, scannerSeverity, text, } from "./scanner-import.js";
11
9
  function repositoryName(value) {
12
10
  const repository = text(value);
13
11
  if (!repository || !githubRepositoryParts(repository))
@@ -30,13 +28,6 @@ function sourceTimestamp(value) {
30
28
  throw new Error("GitHub updated_at is not a valid timestamp.");
31
29
  return Math.floor(seconds);
32
30
  }
33
- function severity(value) {
34
- // SARIF error/warning/note are not vulnerability severity ratings.
35
- return typeof value === "string" &&
36
- ["critical", "high", "medium", "low", "informational"].includes(value)
37
- ? value
38
- : "unknown";
39
- }
40
31
  function codeScanningPrefix({ parsed, host }, repository, number) {
41
32
  const name = repository.toLowerCase();
42
33
  const path = parsed.pathname.toLowerCase();
@@ -44,8 +35,8 @@ function codeScanningPrefix({ parsed, host }, repository, number) {
44
35
  if (path === `/${name}/${alert}` || path === `/${name}/security/${alert}`)
45
36
  return `${host}/${name}/${alert}/`;
46
37
  }
47
- function codeScanningFinding(record) {
48
- const repository = repositoryName(record["repository"]);
38
+ function codeScanningSource(record) {
39
+ const name = repositoryName(record["repository"]);
49
40
  const alert = asRecord(record["alert"]);
50
41
  const number = record["number"];
51
42
  if (!alert ||
@@ -58,9 +49,14 @@ function codeScanningFinding(record) {
58
49
  if (!url || url !== alert["html_url"])
59
50
  throw new Error("GitHub alert URL must match the original alert.");
60
51
  const link = sourceUrl(url);
61
- const prefix = codeScanningPrefix(link, repository, number);
52
+ const prefix = codeScanningPrefix(link, name, number);
62
53
  if (!prefix)
63
54
  throw new Error("GitHub alert URL does not match the selected repository and alert.");
55
+ const repository = { url: `${link.origin}/${name}`, name };
56
+ return { alert, number, prefix, url, repository };
57
+ }
58
+ function codeScanningFinding(record) {
59
+ const { alert, number, prefix, url, repository } = codeScanningSource(record);
64
60
  const rule = asRecord(alert["rule"]);
65
61
  const instance = asRecord(alert["most_recent_instance"]);
66
62
  const ref = text(instance?.["ref"]);
@@ -86,7 +82,8 @@ function codeScanningFinding(record) {
86
82
  title: text(rule?.["name"]) ??
87
83
  text(rule?.["description"]) ??
88
84
  `GitHub code-scanning alert #${number}`,
89
- severity: severity(rule?.["security_severity_level"]),
85
+ // SARIF error, warning and note describe diagnostics. Use the security rating.
86
+ severity: scannerSeverity(text(rule?.["security_severity_level"])),
90
87
  description: [...new Set([message, description].filter(Boolean))].join("\n\n") ||
91
88
  null,
92
89
  url,
@@ -97,10 +94,7 @@ function codeScanningFinding(record) {
97
94
  source_data: record,
98
95
  details: {
99
96
  kind: "sast",
100
- repository: {
101
- url: `${link.origin}/${repository}`,
102
- name: repository,
103
- },
97
+ repository,
104
98
  // Dismissal covers every branch; detection state belongs to the selected ref.
105
99
  source_status: alert["state"] === "dismissed"
106
100
  ? "dismissed"
@@ -117,8 +111,8 @@ function codeScanningFinding(record) {
117
111
  function advisorySourceId(host, selection, repository, id) {
118
112
  return `${host}/${selection === "repository" ? repository.toLowerCase() : "global"}/security-advisory/${id.toUpperCase()}`;
119
113
  }
120
- function advisoryFinding(record) {
121
- const repository = repositoryName(record["repository"]);
114
+ function advisorySource(record) {
115
+ const name = repositoryName(record["repository"]);
122
116
  const advisory = asRecord(record["advisory"]);
123
117
  const id = text(record["ghsaId"]);
124
118
  const selection = record["selection"];
@@ -137,12 +131,17 @@ function advisoryFinding(record) {
137
131
  // Enterprise APIs may return the public advisory database's canonical link.
138
132
  const canonicalGlobalLink = selection === "global" && parsedUrl.host === "github.com";
139
133
  const expectedPath = selection === "repository"
140
- ? `/${repository}/security/advisories/${id}`
134
+ ? `/${name}/security/advisories/${id}`
141
135
  : `/advisories/${id}`;
142
136
  if (!host ||
143
137
  (linkHost !== host && !canonicalGlobalLink) ||
144
138
  parsedUrl.pathname.toLowerCase() !== expectedPath.toLowerCase())
145
139
  throw new Error("GitHub advisory URL does not match the selected source and GHSA ID.");
140
+ const repository = { url: `${origin}/${name}`, name };
141
+ return { advisory, id, selection, url, host, repository };
142
+ }
143
+ function advisoryFinding(record) {
144
+ const { advisory, id, selection, url, host, repository } = advisorySource(record);
146
145
  const vulnerabilities = advisory["vulnerabilities"] === null ? [] : advisory["vulnerabilities"];
147
146
  if (!Array.isArray(vulnerabilities))
148
147
  throw new Error("GitHub advisory vulnerabilities must be an array.");
@@ -175,10 +174,10 @@ function advisoryFinding(record) {
175
174
  });
176
175
  const cwes = Array.isArray(advisory["cwes"]) ? advisory["cwes"] : [];
177
176
  return {
178
- source_finding_id: advisorySourceId(host, selection, repository, id),
177
+ source_finding_id: advisorySourceId(host, selection, repository.name, id),
179
178
  evidence: {
180
179
  title: text(advisory["summary"]) ?? id,
181
- severity: severity(advisory["severity"]),
180
+ severity: scannerSeverity(text(advisory["severity"])),
182
181
  description: text(advisory["description"]),
183
182
  url,
184
183
  advisory_ids: [...new Set(advisoryIds)],
@@ -188,14 +187,7 @@ function advisoryFinding(record) {
188
187
  details: {
189
188
  kind: "advisory",
190
189
  advisory: { source: selection },
191
- ...(selection === "repository"
192
- ? {
193
- repository: {
194
- url: `${origin}/${repository}`,
195
- name: repository,
196
- },
197
- }
198
- : {}),
190
+ ...(selection === "repository" ? { repository } : {}),
199
191
  source_status: text(advisory["withdrawn_at"])
200
192
  ? "withdrawn"
201
193
  : (text(advisory["state"]) ??
@@ -208,6 +200,37 @@ function advisoryFinding(record) {
208
200
  },
209
201
  };
210
202
  }
203
+ /** Keep the repository from a retained collector export when SDK callers supply their own projection. */
204
+ export function retainedGitHubRepository({ evidence }, repositoryKey = cloudRepositoryUrlKey) {
205
+ const data = evidence.source_data;
206
+ if (!data?.["url"] || !data["repository"])
207
+ return;
208
+ let source;
209
+ if (data["source"] === "github-code-scanning" &&
210
+ data["number"] !== undefined &&
211
+ asRecord(data["alert"])?.["html_url"]) {
212
+ source = codeScanningSource(data);
213
+ }
214
+ else if (data["source"] === "github-security-advisory" &&
215
+ data["ghsaId"] &&
216
+ data["githubHost"] &&
217
+ data["selection"] &&
218
+ asRecord(data["advisory"])?.["html_url"]) {
219
+ source = advisorySource(data);
220
+ if (source.selection === "global") {
221
+ if (evidence.details?.repository)
222
+ throw new CodexSecurityError("Global advisory evidence cannot claim a source repository.");
223
+ return;
224
+ }
225
+ }
226
+ else
227
+ return;
228
+ const native = source.repository.url;
229
+ const projected = evidence.details?.repository?.url;
230
+ if (projected && repositoryKey(projected) !== repositoryKey(native))
231
+ throw new CodexSecurityError("The normalized repository does not match the original GitHub finding.");
232
+ return native;
233
+ }
211
234
  function mapRecord(input) {
212
235
  const record = asRecord(input);
213
236
  if (!record)
@@ -222,232 +245,24 @@ function ownData(value, key) {
222
245
  if (value && typeof value === "object" && !isProxy(value))
223
246
  return Object.getOwnPropertyDescriptor(value, key)?.value;
224
247
  }
225
- function priorAdvisoryId(value) {
226
- if (ownData(value, "source") !== "github-security-advisory")
227
- return;
228
- const id = text(ownData(value, "ghsaId"));
229
- const host = text(ownData(value, "githubHost"))?.toLowerCase();
230
- const selection = ownData(value, "selection");
231
- const repository = text(ownData(value, "repository"));
232
- if (id &&
233
- GHSA_ID.test(id) &&
234
- host &&
235
- repository &&
236
- githubRepositoryParts(repository) &&
237
- (selection === "repository" || selection === "global"))
238
- return advisorySourceId(host, selection, repository, id);
239
- }
240
- // Determine whether JSON can call a serializer without evaluating a getter.
241
- function maySerialize(value) {
242
- while (value && typeof value === "object") {
243
- if (isProxy(value))
244
- return true;
245
- const field = Object.getOwnPropertyDescriptor(value, "toJSON");
246
- if (field)
247
- return (!Object.hasOwn(field, "value") || typeof field.value === "function");
248
- value = Object.getPrototypeOf(value);
249
- }
250
- return false;
251
- }
252
- function codeOccurrencePrefix(value) {
253
- const repository = ownData(value, "repository"), number = ownData(value, "number"), url = ownData(value, "url");
254
- if (ownData(value, "source") !== "github-code-scanning" ||
255
- typeof repository !== "string" ||
256
- !githubRepositoryParts(repository) ||
257
- typeof number !== "number" ||
258
- !Number.isSafeInteger(number) ||
259
- number <= 0 ||
260
- typeof url !== "string")
261
- return;
262
- try {
263
- return codeScanningPrefix(sourceUrl(url), repository, number);
264
- }
265
- catch {
266
- /* No validated occurrence anchor. */
267
- }
268
- }
269
- // The released reader measured the caller's source_data JSON before native capture.
270
- function captureGitHubRecord(input, target) {
271
- // Only plain records, arrays and standard Buffers have a reconstructable wire size.
272
- let plainBuffers = [];
273
- let hiddenFields = false;
274
- let largeLocalRow = false;
275
- const record = cloneWithoutGetters(input, (value) => {
276
- const prototype = Object.getPrototypeOf(value);
277
- if (target === "local" &&
278
- ((Array.isArray(value) && value.length > 256 * 1024) ||
279
- (prototype === Buffer.prototype &&
280
- Buffer.isBuffer(value) &&
281
- !Object.hasOwn(value, "byteLength") &&
282
- value.byteLength > 256 * 1024))) {
283
- largeLocalRow = true;
284
- return false;
285
- }
286
- // Native capture drops non-enumerable fields the released vendor mapper could read.
287
- if (!Array.isArray(value) &&
288
- !ArrayBuffer.isView(value) &&
289
- !isBoxedPrimitive(value) &&
290
- !isDate(value) &&
291
- Object.getOwnPropertyNames(value).some((key) => key !== "toJSON" &&
292
- !Object.prototype.propertyIsEnumerable.call(value, key)))
293
- hiddenFields = true;
294
- if (!plainBuffers)
295
- return;
296
- if (Buffer.isBuffer(value)) {
297
- if (prototype === Buffer.prototype &&
298
- !Object.hasOwn(value, "toJSON") &&
299
- !Object.hasOwn(value, "length") &&
300
- !("_arr" in value))
301
- plainBuffers.push(value);
302
- else
303
- plainBuffers = undefined;
304
- }
305
- else if ((prototype !== Object.prototype &&
306
- prototype !== null &&
307
- prototype !== Array.prototype) ||
308
- maySerialize(value))
309
- plainBuffers = undefined;
310
- });
311
- return {
312
- record: asRecord(record),
313
- hiddenFields,
314
- plainBuffers,
315
- largeLocalRow,
316
- };
317
- }
318
- function normalizeRecords(records, target = "cloud", snapshot = false) {
248
+ function normalizeRecords(records, target, snapshot = false) {
319
249
  const result = {
320
250
  read: records.length,
321
251
  findings: [],
322
252
  excluded: [],
323
253
  };
324
- const previous = snapshot
325
- ? { read: records.length, findings: [], excluded: [] }
326
- : undefined;
327
- const checks = [];
328
- const uncertainIds = new Set();
329
- const unidentifiedRows = new Set();
330
- let independentlyObserved = Infinity;
331
- let ranRootSerializer = false;
332
- let largeLocalSelection = false;
333
- const potentialIds = [];
334
- const prefixes = new Set();
335
254
  const identities = new Set();
336
255
  for (const [index, input] of records.entries()) {
337
- const afterRootSerializer = ranRootSerializer;
338
- const keySensitive = previous !== undefined && maySerialize(input);
339
- ranRootSerializer ||= keySensitive;
340
256
  let exported = input;
341
- const capture = previous ? captureGitHubRecord(input, target) : undefined;
342
- const before = capture?.record;
343
- const priorPrefix = previous ? codeOccurrencePrefix(input) : undefined;
344
- let priorId = previous ? priorAdvisoryId(input) : undefined;
345
- let prefix = priorPrefix;
346
- const rowIds = new Set();
347
- let rowUncertain = false;
348
- const priorRowCount = previous?.findings.length ?? 0;
349
- function possible() {
350
- rowUncertain = true;
351
- // A caller getter can mutate a later row before its native evidence is seen.
352
- independentlyObserved = Math.min(independentlyObserved, priorRowCount);
353
- for (const id of rowIds)
354
- uncertainIds.add(id);
355
- if (prefix)
356
- prefixes.add(prefix);
357
- if (priorId)
358
- uncertainIds.add(priorId);
359
- else if (!priorPrefix)
360
- unidentifiedRows.add(index);
361
- }
362
- // The old reader called a root serializer with "source_data" rather than its
363
- // array index. That code could change a later occurrence before it was read.
364
- if (afterRootSerializer) {
365
- possible();
366
- unidentifiedRows.add(index);
367
- }
368
- function retainPrevious(selection, id, evidence) {
369
- selection.findings.push({ source_finding_id: id, evidence });
370
- potentialIds.push(id);
371
- checks.push(() => {
372
- if (!isDeepStrictEqual(before, asRecord(cloneWithoutGetters(input))))
373
- possible();
374
- });
375
- }
376
- const exclusion = (record, reason) => ({
377
- position: index + 1,
378
- source_finding_id: text(asRecord(record)?.["url"]),
379
- reason,
380
- });
381
- let possibleFreshId = false;
382
257
  try {
383
- if (previous && capture) {
384
- const source = exportedGitHubRecord(input, index, target, target === "local" && !capture.largeLocalRow);
385
- exported = source.record;
386
- prefix ??= codeOccurrencePrefix(exported);
387
- // A serializer or Buffer can expand a native record that fit the approved request.
388
- const oversizedLocalRow = target === "local" &&
389
- (capture.largeLocalRow ||
390
- (source.bytes > 256 * 1024 &&
391
- (!before || capture.plainBuffers?.length === 0)));
392
- if (oversizedLocalRow || !before) {
393
- if (!oversizedLocalRow &&
394
- source.previousInvalid &&
395
- !source.skippedRawValue &&
396
- canSnapshotWithoutGetters(input)) {
397
- previous.excluded.push(exclusion(exported, errorMessage(source.previousInvalid)));
398
- }
399
- else if (target !== "local" &&
400
- source.bytes + source.adjustment > 256 * 1024 &&
401
- canSnapshotWithoutGetters(input) &&
402
- !keySensitive) {
403
- previous.excluded.push(exclusion(exported, "Evidence exceeds the Cloud limit of 256 KiB."));
404
- }
405
- else {
406
- largeLocalSelection ||= oversizedLocalRow;
407
- // An occurrence without independent native evidence can only stop a retry.
408
- possible();
409
- possibleFreshId = true;
410
- }
411
- }
412
- else {
413
- if (capture.hiddenFields || source.skippedRawValue)
414
- possible();
415
- try {
416
- const row = mapRecord(before);
417
- const knownOldId = row.source_finding_id;
418
- priorId = knownOldId;
419
- if (!afterRootSerializer)
420
- unidentifiedRows.delete(index);
421
- rowIds.add(knownOldId);
422
- if (rowUncertain)
423
- uncertainIds.add(knownOldId);
424
- const evidence = validateExternalEvidenceFields(row.evidence, target);
425
- if (source.previousInvalid)
426
- throw source.previousInvalid;
427
- if (keySensitive)
428
- possible();
429
- const reason = keySensitive || target === "local"
430
- ? undefined
431
- : previousGitHubExclusion(evidence, source.bytes, source.adjustment);
432
- if (reason)
433
- previous.excluded.push(exclusion(before, reason));
434
- else
435
- retainPrevious(previous, knownOldId, evidence);
436
- }
437
- catch (error) {
438
- previous.excluded.push(exclusion(before, errorMessage(error)));
439
- }
440
- }
441
- if (source.invalid)
442
- throw source.invalid;
258
+ if (snapshot) {
259
+ const capture = exportedGitHubRecord(input, index, target);
260
+ exported = capture.record;
261
+ if (capture.invalid)
262
+ throw capture.invalid;
443
263
  }
444
- const mapped = mapRecord(exported), id = mapped.source_finding_id;
445
- rowIds.add(id);
446
- if (rowUncertain)
447
- uncertainIds.add(id);
448
- if (possibleFreshId)
449
- potentialIds.push(id);
450
- const evidence = validateExternalEvidence(mapped.evidence, target);
264
+ const { source_finding_id: id, evidence: mapped } = mapRecord(exported);
265
+ const evidence = validateExternalEvidence(mapped, target);
451
266
  if (identities.has(id))
452
267
  throw new CodexSecurityError(`Duplicate source finding id ${JSON.stringify(id)}. Select each GitHub occurrence once.`);
453
268
  identities.add(id);
@@ -456,72 +271,14 @@ function normalizeRecords(records, target = "cloud", snapshot = false) {
456
271
  catch (error) {
457
272
  if (error instanceof CodexSecurityError)
458
273
  throw error;
459
- const reason = errorMessage(error);
460
- result.excluded.push(exclusion(snapshot && exported === input
461
- ? { url: ownData(input, "url") }
462
- : exported, reason));
463
- if (previous && exported === input) {
464
- if (error instanceof CloudEvidenceDepthError &&
465
- before &&
466
- // Extra Buffer fields were inspected by the old row validator, but
467
- // structuredClone does not retain them as part of the typed array.
468
- capture?.plainBuffers?.every((buffer) => Object.keys(buffer).length === buffer.length)) {
469
- // Exported JSON can be deeper than an approved native snapshot.
470
- // Retain only the independently observed, valid prior selection.
471
- try {
472
- const row = mapRecord(before);
473
- const evidence = validateExternalEvidence(row.evidence, target);
474
- const savedSource = JSON.stringify(evidence.source_data);
475
- // structuredClone turns each Buffer into a Uint8Array. Reconstruct its
476
- // original serialized size on detached data without running caller hooks.
477
- const oldSource = JSON.stringify(evidence.source_data, (_key, value) => value instanceof Uint8Array
478
- ? { type: "Buffer", data: [...value] }
479
- : value);
480
- validateExternalEvidenceJson(evidence, target, Buffer.byteLength(oldSource) - Buffer.byteLength(savedSource));
481
- retainPrevious(previous, row.source_finding_id, evidence);
482
- }
483
- catch (priorError) {
484
- previous.excluded.push(exclusion(before, errorMessage(priorError)));
485
- }
486
- continue;
487
- }
488
- // A serializer may throw at its array key while the old source_data
489
- // key produced a valid record. Keep only evidence for refusing a match.
490
- possible();
491
- if (before)
492
- try {
493
- const id = mapRecord(before).source_finding_id;
494
- priorId = id;
495
- if (!afterRootSerializer)
496
- unidentifiedRows.delete(index);
497
- potentialIds.push(id);
498
- uncertainIds.add(id);
499
- }
500
- catch {
501
- /* No old identity. */
502
- }
503
- }
504
- }
505
- }
506
- if (previous) {
507
- for (const check of checks)
508
- check();
509
- const uncertain = independentlyObserved !== Infinity;
510
- if (uncertain || !isDeepStrictEqual(previous.findings, result.findings)) {
511
- const prior = { sourceFindingIds: potentialIds };
512
- if (uncertain) {
513
- prior.unprovenIdPrefixes = [...prefixes];
514
- prior.uncertainFindingIds = [...uncertainIds];
515
- if (unidentifiedRows.size)
516
- prior.unprovenOccurrenceCount = unidentifiedRows.size;
517
- if (!largeLocalSelection)
518
- prior.knownFindings = previous.findings
519
- .slice(0, independentlyObserved)
520
- .filter((finding) => !uncertainIds.has(finding.source_finding_id));
521
- }
522
- else
523
- prior.snapshot = previous;
524
- rememberPreviousSelection(result, prior);
274
+ const url = snapshot && exported === input
275
+ ? ownData(input, "url")
276
+ : asRecord(exported)?.["url"];
277
+ result.excluded.push({
278
+ position: index + 1,
279
+ source_finding_id: text(url),
280
+ reason: errorMessage(error),
281
+ });
525
282
  }
526
283
  }
527
284
  return result;