@openai/codex-security 0.8.2 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"git-remote.js","sourceRoot":"","sources":["../src/git-remote.ts"],"names":[],"mappings":"AAOA,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO;YACL,GAAG;YACH,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3B,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,uDAAuD,CAAC,IAAI,CACtE,MAAM,CACP,CAAC;IACF,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACnC,OAAO;QACL,GAAG,EAAE,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,wEAAwE;QACxE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAE;QACb,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC5D,CAAC","sourcesContent":["export interface GitRemote {\n url: URL;\n /** Repository path without a URL's leading slash; SCP paths remain literal. */\n path: string;\n scpStyle: boolean;\n}\n\n/** Parse transport syntax only; callers decide which hosts and credentials are allowed. */\nexport function parseGitRemote(remote: string): GitRemote | undefined {\n if (remote.includes(\"://\")) {\n const url = new URL(remote);\n return {\n url,\n path: url.pathname.slice(1),\n scpStyle: false,\n };\n }\n const scp = /^((?:[^@/:\\s?#]+@)?(?:\\[[^\\]]+\\]|[^@/:\\s?#]+)):(.+)$/u.exec(\n remote,\n );\n if (scp === null) return undefined;\n return {\n url: new URL(`ssh://${scp[1]}`),\n // An SCP path's ?, #, and dot segments are literal Git path characters.\n path: scp[2]!,\n scpStyle: true,\n };\n}\n\nexport function isGitHubCloudHost(host: string): boolean {\n return host === \"github.com\" || host.endsWith(\".ghe.com\");\n}\n"]}
1
+ {"version":3,"file":"git-remote.js","sourceRoot":"","sources":["../src/git-remote.ts"],"names":[],"mappings":"AAOA,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO;YACL,GAAG;YACH,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3B,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,uDAAuD,CAAC,IAAI,CACtE,MAAM,CACP,CAAC;IACF,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACnC,OAAO;QACL,GAAG,EAAE,IAAI,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,wEAAwE;QACxE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAE;QACb,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAQ;IAC3C,OAAO,CACL,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QACtB,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,gBAAgB;QAC/C,GAAG,CAAC,IAAI,KAAK,KAAK,CACnB,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,GAAQ,EAAE,IAAY;IACvD,IACE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QACvB,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,mBAAmB;QAClD,GAAG,CAAC,QAAQ,KAAK,KAAK;QACtB,GAAG,CAAC,QAAQ;QACZ,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC;QAE/B,OAAO;IACT,MAAM,KAAK,GAAG,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,KAAK;QACP,OAAO,yBAAyB,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC","sourcesContent":["export interface GitRemote {\n url: URL;\n /** Repository path without a URL's leading slash; SCP paths remain literal. */\n path: string;\n scpStyle: boolean;\n}\n\n/** Parse transport syntax only; callers decide which hosts and credentials are allowed. */\nexport function parseGitRemote(remote: string): GitRemote | undefined {\n if (remote.includes(\"://\")) {\n const url = new URL(remote);\n return {\n url,\n path: url.pathname.slice(1),\n scpStyle: false,\n };\n }\n const scp = /^((?:[^@/:\\s?#]+@)?(?:\\[[^\\]]+\\]|[^@/:\\s?#]+)):(.+)$/u.exec(\n remote,\n );\n if (scp === null) return undefined;\n return {\n url: new URL(`ssh://${scp[1]}`),\n // An SCP path's ?, #, and dot segments are literal Git path characters.\n path: scp[2]!,\n scpStyle: true,\n };\n}\n\nexport function isGitHubCloudHost(host: string): boolean {\n return host === \"github.com\" || host.endsWith(\".ghe.com\");\n}\n\nexport function isGitSsh(protocol: string): boolean {\n return [\"ssh:\", \"git+ssh:\", \"ssh+git:\"].includes(protocol);\n}\n\nexport function isGitHubSshOverHttps(url: URL): boolean {\n return (\n isGitSsh(url.protocol) &&\n url.hostname.toLowerCase() === \"ssh.github.com\" &&\n url.port === \"443\"\n );\n}\n\n/** Azure Repos uses different hosts and paths for the same SSH and HTTPS repository. */\nexport function azureReposHttpsUrl(url: URL, path: string): string | undefined {\n if (\n !isGitSsh(url.protocol) ||\n url.hostname.toLowerCase() !== \"ssh.dev.azure.com\" ||\n url.username !== \"git\" ||\n url.password ||\n (url.port && url.port !== \"22\")\n )\n return;\n const match = /^v3\\/([^/]+)\\/([^/]+)\\/([^/]+)$/u.exec(path);\n if (match)\n return `https://dev.azure.com/${match[1]}/${match[2]}/_git/${match[3]}`;\n}\n"]}
@@ -1,6 +1,7 @@
1
1
  import type { Octokit } from "@octokit/core";
2
+ import { type GitHubImportConnectionOptions, type GitHubImportDependencies } from "./github.js";
2
3
  export declare const GITHUB_ADVISORY_STATES: readonly ["published", "draft", "triage", "closed"];
3
- export interface GitHubAdvisoryImportOptions {
4
+ export interface GitHubAdvisoryImportOptions extends GitHubImportConnectionOptions {
4
5
  /** Source repository, or the selected target for explicit global advisory IDs. */
5
6
  repository: string;
6
7
  /** Exact GHSA IDs. Required for the global advisory API. */
@@ -9,11 +10,6 @@ export interface GitHubAdvisoryImportOptions {
9
10
  source?: "repository" | "global";
10
11
  /** Repository list state (default: published). Exact IDs ignore state. */
11
12
  state?: (typeof GITHUB_ADVISORY_STATES)[number];
12
- /** Defaults to GH_HOST or github.com. */
13
- githubHost?: string;
14
- /** Omit to use the authenticated GitHub CLI. */
15
- githubToken?: string;
16
- signal?: AbortSignal;
17
13
  }
18
14
  type RepositoryAdvisory = Awaited<ReturnType<typeof fetchRepositoryAdvisory>>;
19
15
  type GlobalAdvisory = Awaited<ReturnType<typeof fetchGlobalAdvisory>>;
@@ -27,13 +23,8 @@ export interface ImportedGitHubAdvisory {
27
23
  /** Upstream disclosure, not proof that the selected repository is affected. */
28
24
  advisory: RepositoryAdvisory | GlobalAdvisory;
29
25
  }
30
- interface GitHubAdvisoryImportDependencies {
31
- environment?: NodeJS.ProcessEnv;
32
- currentDirectory?: string;
33
- createGitHub?: (host: string, signal?: AbortSignal) => Promise<Octokit>;
34
- }
35
26
  /** Read repository disclosures or explicitly selected public GHSA records. */
36
- export declare function importGitHubAdvisories(options: GitHubAdvisoryImportOptions, dependencies?: GitHubAdvisoryImportDependencies): Promise<ImportedGitHubAdvisory[]>;
27
+ export declare function importGitHubAdvisories(options: GitHubAdvisoryImportOptions, dependencies?: GitHubImportDependencies): Promise<ImportedGitHubAdvisory[]>;
37
28
  declare function fetchRepositoryAdvisory(github: Octokit, owner: string, repo: string, id: string, signal?: AbortSignal): Promise<{
38
29
  ghsa_id: string;
39
30
  cve_id: string | null;
@@ -1 +1 @@
1
- {"version":3,"file":"github-advisories.d.ts","sourceRoot":"","sources":["../src/github-advisories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAS7C,eAAO,MAAM,sBAAsB,YACjC,WAAW,EACX,OAAO,EACP,QAAQ,EACR,QAAQ,CACA,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;IACjC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,KAAK,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAC9E,KAAK,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,0BAA0B,CAAC;IACnC,SAAS,EAAE,YAAY,GAAG,QAAQ,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,QAAQ,EAAE,kBAAkB,GAAG,cAAc,CAAC;CAC/C;AAED,UAAU,gCAAgC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED,8EAA8E;AAC9E,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,2BAA2B,EACpC,YAAY,GAAE,gCAAqC,GAClD,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAuInC;AAED,iBAAe,uBAAuB,CACpC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAYrB;AAED,iBAAe,mBAAmB,CAChC,MAAM,EAAE,OAAO,EACf,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAOrB"}
1
+ {"version":3,"file":"github-advisories.d.ts","sourceRoot":"","sources":["../src/github-advisories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAM7C,OAAO,EAIL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,sBAAsB,YACjC,WAAW,EACX,OAAO,EACP,QAAQ,EACR,QAAQ,CACA,CAAC;AAEX,MAAM,WAAW,2BAA4B,SAAQ,6BAA6B;IAChF,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;IACjC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;CACjD;AAED,KAAK,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAC9E,KAAK,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,0BAA0B,CAAC;IACnC,SAAS,EAAE,YAAY,GAAG,QAAQ,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,QAAQ,EAAE,kBAAkB,GAAG,cAAc,CAAC;CAC/C;AAED,8EAA8E;AAC9E,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,2BAA2B,EACpC,YAAY,GAAE,wBAA6B,GAC1C,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAiHnC;AAED,iBAAe,uBAAuB,CACpC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAYrB;AAED,iBAAe,mBAAmB,CAChC,MAAM,EAAE,OAAO,EACf,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAOrB"}
@@ -1,7 +1,6 @@
1
1
  import { CANONICAL_GHSA_ID, githubRepositoryParts, } from "./github-identifiers.js";
2
- import { CodexSecurityError, errorMessage } from "./errors.js";
3
- import { requireExternalImports } from "./external-imports-feature.js";
4
- import { createAuthenticatedGitHub } from "./github.js";
2
+ import { CodexSecurityError } from "./errors.js";
3
+ import { githubImportHost, githubImportClient, githubImportError, } from "./github.js";
5
4
  export const GITHUB_ADVISORY_STATES = [
6
5
  "published",
7
6
  "draft",
@@ -12,7 +11,6 @@ export const GITHUB_ADVISORY_STATES = [
12
11
  export async function importGitHubAdvisories(options, dependencies = {}) {
13
12
  options.signal?.throwIfAborted();
14
13
  const environment = dependencies.environment ?? process.env;
15
- requireExternalImports(environment);
16
14
  const repository = options.repository.trim();
17
15
  const parts = githubRepositoryParts(repository);
18
16
  if (!parts)
@@ -36,19 +34,9 @@ export async function importGitHubAdvisories(options, dependencies = {}) {
36
34
  throw new CodexSecurityError("Select explicit GHSA IDs for global advisories; database-wide import is not supported.");
37
35
  if (ids.length > 0 && state !== "published")
38
36
  throw new CodexSecurityError("--github-state only filters repository lists; omit it when selecting exact GHSA IDs.");
39
- const host = options.githubHost?.trim() ??
40
- (environment["GH_HOST"]?.trim() || "github.com");
41
- if (!host)
42
- throw new CodexSecurityError("GitHub host must not be empty.");
37
+ const host = githubImportHost(options.githubHost, environment);
43
38
  try {
44
- const github = dependencies.createGitHub
45
- ? await dependencies.createGitHub(host, options.signal)
46
- : await createAuthenticatedGitHub(host, {
47
- token: options.githubToken,
48
- environment,
49
- currentDirectory: dependencies.currentDirectory,
50
- signal: options.signal,
51
- });
39
+ const github = await githubImportClient(host, options, dependencies, environment);
52
40
  const advisories = [];
53
41
  if (ids.length > 0) {
54
42
  for (const id of ids) {
@@ -97,21 +85,11 @@ export async function importGitHubAdvisories(options, dependencies = {}) {
97
85
  }));
98
86
  }
99
87
  catch (error) {
100
- options.signal?.throwIfAborted();
101
- if (error instanceof CodexSecurityError)
102
- throw error;
103
- const status = typeof error === "object" && error !== null && "status" in error
104
- ? error.status
105
- : undefined;
106
- if (status === 401)
107
- throw new CodexSecurityError("GitHub authentication failed.");
108
- if (status === 403)
109
- throw new CodexSecurityError("GitHub denied security advisory access. Check repository advisory permissions and API rate limits.");
110
- if (status === 404)
111
- throw new CodexSecurityError("GitHub repository or security advisory was not found or is not accessible.");
112
- if (status === 429)
113
- throw new CodexSecurityError("GitHub request was rate limited. Wait and retry.");
114
- throw new CodexSecurityError(`GitHub security advisory request failed${typeof status === "number" ? ` (HTTP ${status})` : ""}: ${errorMessage(error)}`);
88
+ throw githubImportError(error, options.signal, {
89
+ operation: "security advisory",
90
+ denied: "GitHub denied security advisory access. Check repository advisory permissions and API rate limits.",
91
+ notFound: "GitHub repository or security advisory was not found or is not accessible.",
92
+ });
115
93
  }
116
94
  }
117
95
  async function fetchRepositoryAdvisory(github, owner, repo, id, signal) {
@@ -1 +1 @@
1
- {"version":3,"file":"github-advisories.js","sourceRoot":"","sources":["../src/github-advisories.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Octokit } from \"@octokit/core\";\nimport {\n CANONICAL_GHSA_ID,\n githubRepositoryParts,\n} from \"./github-identifiers.js\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { requireExternalImports } from \"./external-imports-feature.js\";\nimport { createAuthenticatedGitHub } from \"./github.js\";\n\nexport const GITHUB_ADVISORY_STATES = [\n \"published\",\n \"draft\",\n \"triage\",\n \"closed\",\n] as const;\n\nexport interface GitHubAdvisoryImportOptions {\n /** Source repository, or the selected target for explicit global advisory IDs. */\n repository: string;\n /** Exact GHSA IDs. Required for the global advisory API. */\n advisoryIds?: readonly string[];\n /** Repository advisories by default; global never enumerates the database. */\n source?: \"repository\" | \"global\";\n /** Repository list state (default: published). Exact IDs ignore state. */\n state?: (typeof GITHUB_ADVISORY_STATES)[number];\n /** Defaults to GH_HOST or github.com. */\n githubHost?: string;\n /** Omit to use the authenticated GitHub CLI. */\n githubToken?: string;\n signal?: AbortSignal;\n}\n\ntype RepositoryAdvisory = Awaited<ReturnType<typeof fetchRepositoryAdvisory>>;\ntype GlobalAdvisory = Awaited<ReturnType<typeof fetchGlobalAdvisory>>;\n\nexport interface ImportedGitHubAdvisory {\n source: \"github-security-advisory\";\n selection: \"repository\" | \"global\";\n repository: string;\n githubHost: string;\n ghsaId: string;\n url: string;\n /** Upstream disclosure, not proof that the selected repository is affected. */\n advisory: RepositoryAdvisory | GlobalAdvisory;\n}\n\ninterface GitHubAdvisoryImportDependencies {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n createGitHub?: (host: string, signal?: AbortSignal) => Promise<Octokit>;\n}\n\n/** Read repository disclosures or explicitly selected public GHSA records. */\nexport async function importGitHubAdvisories(\n options: GitHubAdvisoryImportOptions,\n dependencies: GitHubAdvisoryImportDependencies = {},\n): Promise<ImportedGitHubAdvisory[]> {\n options.signal?.throwIfAborted();\n const environment = dependencies.environment ?? process.env;\n requireExternalImports(environment);\n const repository = options.repository.trim();\n const parts = githubRepositoryParts(repository);\n if (!parts)\n throw new CodexSecurityError(\"GitHub repository must be OWNER/REPO.\");\n const [owner, repo] = parts;\n const ids = [\n ...new Set(\n (options.advisoryIds ?? []).map((id) =>\n id\n .trim()\n .toLowerCase()\n .replace(/^ghsa-/u, \"GHSA-\"),\n ),\n ),\n ];\n if (ids.some((id) => !CANONICAL_GHSA_ID.test(id)))\n throw new CodexSecurityError(\n \"GitHub advisory IDs must use GHSA-xxxx-xxxx-xxxx form.\",\n );\n const source = options.source ?? \"repository\";\n const state = options.state ?? \"published\";\n if (source !== \"repository\" && source !== \"global\")\n throw new CodexSecurityError(\n \"GitHub advisory source must be repository or global.\",\n );\n if (!GITHUB_ADVISORY_STATES.includes(state))\n throw new CodexSecurityError(\"GitHub advisory state is invalid.\");\n if (source === \"global\" && ids.length === 0)\n throw new CodexSecurityError(\n \"Select explicit GHSA IDs for global advisories; database-wide import is not supported.\",\n );\n if (ids.length > 0 && state !== \"published\")\n throw new CodexSecurityError(\n \"--github-state only filters repository lists; omit it when selecting exact GHSA IDs.\",\n );\n const host =\n options.githubHost?.trim() ??\n (environment[\"GH_HOST\"]?.trim() || \"github.com\");\n if (!host) throw new CodexSecurityError(\"GitHub host must not be empty.\");\n\n try {\n const github = dependencies.createGitHub\n ? await dependencies.createGitHub(host, options.signal)\n : await createAuthenticatedGitHub(host, {\n token: options.githubToken,\n environment,\n currentDirectory: dependencies.currentDirectory,\n signal: options.signal,\n });\n const advisories: (RepositoryAdvisory | GlobalAdvisory)[] = [];\n if (ids.length > 0) {\n for (const id of ids) {\n options.signal?.throwIfAborted();\n advisories.push(\n source === \"global\"\n ? await fetchGlobalAdvisory(github, id, options.signal)\n : await fetchRepositoryAdvisory(\n github,\n owner,\n repo,\n id,\n options.signal,\n ),\n );\n }\n } else {\n let after: string | undefined;\n const cursors = new Set<string>();\n do {\n options.signal?.throwIfAborted();\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/security-advisories\",\n {\n owner,\n repo,\n state,\n per_page: 100,\n after,\n request: { signal: options.signal, redirect: \"error\" },\n },\n );\n advisories.push(...response.data);\n const next = response.headers.link\n ?.split(\",\")\n .find((link) => /;\\s*rel=\"next\"/u.test(link));\n const nextUrl = next?.match(/<([^>]+)>/u)?.[1];\n // Keep requests on the authenticated route; only carry over the cursor.\n after = nextUrl\n ? (new URL(nextUrl).searchParams.get(\"after\") ?? undefined)\n : undefined;\n if (next && (!after || cursors.has(after)))\n throw new CodexSecurityError(\n \"GitHub returned invalid advisory pagination.\",\n );\n if (after) cursors.add(after);\n } while (after !== undefined);\n }\n return advisories.map((advisory) => ({\n source: \"github-security-advisory\",\n selection: source,\n repository,\n githubHost: host,\n ghsaId: advisory.ghsa_id,\n url: advisory.html_url,\n advisory,\n }));\n } catch (error) {\n options.signal?.throwIfAborted();\n if (error instanceof CodexSecurityError) throw error;\n const status =\n typeof error === \"object\" && error !== null && \"status\" in error\n ? error.status\n : undefined;\n if (status === 401)\n throw new CodexSecurityError(\"GitHub authentication failed.\");\n if (status === 403)\n throw new CodexSecurityError(\n \"GitHub denied security advisory access. Check repository advisory permissions and API rate limits.\",\n );\n if (status === 404)\n throw new CodexSecurityError(\n \"GitHub repository or security advisory was not found or is not accessible.\",\n );\n if (status === 429)\n throw new CodexSecurityError(\n \"GitHub request was rate limited. Wait and retry.\",\n );\n throw new CodexSecurityError(\n `GitHub security advisory request failed${typeof status === \"number\" ? ` (HTTP ${status})` : \"\"}: ${errorMessage(error)}`,\n );\n }\n}\n\nasync function fetchRepositoryAdvisory(\n github: Octokit,\n owner: string,\n repo: string,\n id: string,\n signal?: AbortSignal,\n) {\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/security-advisories/{ghsa_id}\",\n {\n owner,\n repo,\n ghsa_id: id,\n request: { signal, redirect: \"error\" },\n },\n );\n return response.data;\n}\n\nasync function fetchGlobalAdvisory(\n github: Octokit,\n id: string,\n signal?: AbortSignal,\n) {\n const response = await github.request(\"GET /advisories/{ghsa_id}\", {\n ghsa_id: id,\n request: { signal, redirect: \"error\" },\n });\n return response.data;\n}\n"]}
1
+ {"version":3,"file":"github-advisories.js","sourceRoot":"","sources":["../src/github-advisories.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Octokit } from \"@octokit/core\";\nimport {\n CANONICAL_GHSA_ID,\n githubRepositoryParts,\n} from \"./github-identifiers.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport {\n githubImportHost,\n githubImportClient,\n githubImportError,\n type GitHubImportConnectionOptions,\n type GitHubImportDependencies,\n} from \"./github.js\";\n\nexport const GITHUB_ADVISORY_STATES = [\n \"published\",\n \"draft\",\n \"triage\",\n \"closed\",\n] as const;\n\nexport interface GitHubAdvisoryImportOptions extends GitHubImportConnectionOptions {\n /** Source repository, or the selected target for explicit global advisory IDs. */\n repository: string;\n /** Exact GHSA IDs. Required for the global advisory API. */\n advisoryIds?: readonly string[];\n /** Repository advisories by default; global never enumerates the database. */\n source?: \"repository\" | \"global\";\n /** Repository list state (default: published). Exact IDs ignore state. */\n state?: (typeof GITHUB_ADVISORY_STATES)[number];\n}\n\ntype RepositoryAdvisory = Awaited<ReturnType<typeof fetchRepositoryAdvisory>>;\ntype GlobalAdvisory = Awaited<ReturnType<typeof fetchGlobalAdvisory>>;\n\nexport interface ImportedGitHubAdvisory {\n source: \"github-security-advisory\";\n selection: \"repository\" | \"global\";\n repository: string;\n githubHost: string;\n ghsaId: string;\n url: string;\n /** Upstream disclosure, not proof that the selected repository is affected. */\n advisory: RepositoryAdvisory | GlobalAdvisory;\n}\n\n/** Read repository disclosures or explicitly selected public GHSA records. */\nexport async function importGitHubAdvisories(\n options: GitHubAdvisoryImportOptions,\n dependencies: GitHubImportDependencies = {},\n): Promise<ImportedGitHubAdvisory[]> {\n options.signal?.throwIfAborted();\n const environment = dependencies.environment ?? process.env;\n const repository = options.repository.trim();\n const parts = githubRepositoryParts(repository);\n if (!parts)\n throw new CodexSecurityError(\"GitHub repository must be OWNER/REPO.\");\n const [owner, repo] = parts;\n const ids = [\n ...new Set(\n (options.advisoryIds ?? []).map((id) =>\n id\n .trim()\n .toLowerCase()\n .replace(/^ghsa-/u, \"GHSA-\"),\n ),\n ),\n ];\n if (ids.some((id) => !CANONICAL_GHSA_ID.test(id)))\n throw new CodexSecurityError(\n \"GitHub advisory IDs must use GHSA-xxxx-xxxx-xxxx form.\",\n );\n const source = options.source ?? \"repository\";\n const state = options.state ?? \"published\";\n if (source !== \"repository\" && source !== \"global\")\n throw new CodexSecurityError(\n \"GitHub advisory source must be repository or global.\",\n );\n if (!GITHUB_ADVISORY_STATES.includes(state))\n throw new CodexSecurityError(\"GitHub advisory state is invalid.\");\n if (source === \"global\" && ids.length === 0)\n throw new CodexSecurityError(\n \"Select explicit GHSA IDs for global advisories; database-wide import is not supported.\",\n );\n if (ids.length > 0 && state !== \"published\")\n throw new CodexSecurityError(\n \"--github-state only filters repository lists; omit it when selecting exact GHSA IDs.\",\n );\n const host = githubImportHost(options.githubHost, environment);\n\n try {\n const github = await githubImportClient(\n host,\n options,\n dependencies,\n environment,\n );\n const advisories: (RepositoryAdvisory | GlobalAdvisory)[] = [];\n if (ids.length > 0) {\n for (const id of ids) {\n options.signal?.throwIfAborted();\n advisories.push(\n source === \"global\"\n ? await fetchGlobalAdvisory(github, id, options.signal)\n : await fetchRepositoryAdvisory(\n github,\n owner,\n repo,\n id,\n options.signal,\n ),\n );\n }\n } else {\n let after: string | undefined;\n const cursors = new Set<string>();\n do {\n options.signal?.throwIfAborted();\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/security-advisories\",\n {\n owner,\n repo,\n state,\n per_page: 100,\n after,\n request: { signal: options.signal, redirect: \"error\" },\n },\n );\n advisories.push(...response.data);\n const next = response.headers.link\n ?.split(\",\")\n .find((link) => /;\\s*rel=\"next\"/u.test(link));\n const nextUrl = next?.match(/<([^>]+)>/u)?.[1];\n // Keep requests on the authenticated route; only carry over the cursor.\n after = nextUrl\n ? (new URL(nextUrl).searchParams.get(\"after\") ?? undefined)\n : undefined;\n if (next && (!after || cursors.has(after)))\n throw new CodexSecurityError(\n \"GitHub returned invalid advisory pagination.\",\n );\n if (after) cursors.add(after);\n } while (after !== undefined);\n }\n return advisories.map((advisory) => ({\n source: \"github-security-advisory\",\n selection: source,\n repository,\n githubHost: host,\n ghsaId: advisory.ghsa_id,\n url: advisory.html_url,\n advisory,\n }));\n } catch (error) {\n throw githubImportError(error, options.signal, {\n operation: \"security advisory\",\n denied:\n \"GitHub denied security advisory access. Check repository advisory permissions and API rate limits.\",\n notFound:\n \"GitHub repository or security advisory was not found or is not accessible.\",\n });\n }\n}\n\nasync function fetchRepositoryAdvisory(\n github: Octokit,\n owner: string,\n repo: string,\n id: string,\n signal?: AbortSignal,\n) {\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/security-advisories/{ghsa_id}\",\n {\n owner,\n repo,\n ghsa_id: id,\n request: { signal, redirect: \"error\" },\n },\n );\n return response.data;\n}\n\nasync function fetchGlobalAdvisory(\n github: Octokit,\n id: string,\n signal?: AbortSignal,\n) {\n const response = await github.request(\"GET /advisories/{ghsa_id}\", {\n ghsa_id: id,\n request: { signal, redirect: \"error\" },\n });\n return response.data;\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"github-dependabot-findings.d.ts","sourceRoot":"","sources":["../src/github-dependabot-findings.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAKhF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAalC;AAkHD,wBAAgB,oBAAoB,CAAC,EACnC,iBAAiB,EAAE,EAAE,EACrB,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,GAC3C,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CA8BtC;AAmID,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,oBAA8B,GACrC,gBAAgB,CAwClB"}
1
+ {"version":3,"file":"github-dependabot-findings.d.ts","sourceRoot":"","sources":["../src/github-dependabot-findings.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAYhF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAalC;AAkHD,wBAAgB,oBAAoB,CAAC,EACnC,iBAAiB,EAAE,EAAE,EACrB,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,EAAE,GAC3C,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CA8BtC;AAiJD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,oBAA8B,GACrC,gBAAgB,CAgClB"}
@@ -1,10 +1,11 @@
1
1
  import { z } from "zod";
2
2
  import { GHSA_ID, githubRepositoryParts } from "./github-identifiers.js";
3
- import { CodexSecurityError, errorMessage } from "./errors.js";
3
+ import { CodexSecurityError } from "./errors.js";
4
4
  import { validateExternalEvidence, } from "./external-import-contract.js";
5
5
  import { isGitHubCloudHost } from "./git-remote.js";
6
6
  import { isRecord } from "./record.js";
7
- import { record, relativePath, requiredText, text } from "./scanner-import.js";
7
+ import { REPORTABLE_SEVERITIES } from "./scan-settings.js";
8
+ import { trackReaderSelection, record, relativePath, requiredText, text, } from "./scanner-import.js";
8
9
  export function isGitHubDependabotAlert(value) {
9
10
  return (isRecord(value) &&
10
11
  ("security_vulnerability" in value ||
@@ -133,15 +134,26 @@ const matchedVulnerability = z.object({
133
134
  package: z.object({ name: nonblank, ecosystem: nonblank }),
134
135
  vulnerable_version_range: nonblank,
135
136
  first_patched_version: z.object({ identifier: nonblank }).nullable(),
136
- severity: z.enum(["critical", "high", "medium", "low"]),
137
+ severity: z.enum(REPORTABLE_SEVERITIES),
137
138
  });
139
+ // Python distribution identity ignores case and treats runs of -, _ and . alike.
140
+ function packageNameKey(ecosystem, name) {
141
+ if (ecosystem === "pip" &&
142
+ typeof name === "string" &&
143
+ /^[a-zA-Z0-9](?:[a-zA-Z0-9._-]*[a-zA-Z0-9])?$/u.test(name))
144
+ return name.toLowerCase().replace(/[-_.]+/gu, "-");
145
+ return name;
146
+ }
138
147
  function evidence(alert, url) {
139
148
  const dependency = record(alert["dependency"], "Dependabot dependency");
140
149
  const advisory = record(alert["security_advisory"], "Dependabot security_advisory");
141
150
  const { package: { name, ecosystem }, vulnerable_version_range: range, first_patched_version: patch, severity, } = matchedVulnerability.parse(alert["security_vulnerability"]);
151
+ const nameKey = packageNameKey(ecosystem, name);
152
+ const matchesPackage = (pkg) => pkg["ecosystem"] === ecosystem &&
153
+ packageNameKey(ecosystem, pkg["name"]) === nameKey;
142
154
  if ("package" in dependency) {
143
155
  const observed = record(dependency["package"], "Dependabot dependency package");
144
- if (observed["name"] !== name || observed["ecosystem"] !== ecosystem)
156
+ if (!matchesPackage(observed))
145
157
  throw new Error("Dependabot dependency and matched vulnerability packages disagree.");
146
158
  }
147
159
  const path = dependency["manifest_path"] ?? null;
@@ -160,8 +172,7 @@ function evidence(alert, url) {
160
172
  if (!Array.isArray(affected) ||
161
173
  !affected.some((entry) => isRecord(entry) &&
162
174
  isRecord(entry["package"]) &&
163
- entry["package"]["name"] === name &&
164
- entry["package"]["ecosystem"] === ecosystem &&
175
+ matchesPackage(entry["package"]) &&
165
176
  entry["vulnerable_version_range"] === range))
166
177
  throw new Error("Dependabot advisory does not cover the matched package and vulnerable range.");
167
178
  const state = alert["state"];
@@ -215,6 +226,7 @@ export function normalizeGitHubDependabotAlerts(input, target = "cloud") {
215
226
  findings: [],
216
227
  excluded: [],
217
228
  };
229
+ const selection = trackReaderSelection(result);
218
230
  const ids = new Set();
219
231
  let sourceRepository;
220
232
  for (const [index, alert] of alerts.entries()) {
@@ -226,22 +238,12 @@ export function normalizeGitHubDependabotAlerts(input, target = "cloud") {
226
238
  throw new CodexSecurityError(`Duplicate source finding id ${JSON.stringify(sourceId)}. Select each Dependabot alert once.`);
227
239
  ids.add(sourceId);
228
240
  const inputEvidence = evidence(alert, url);
229
- try {
241
+ selection.append(index + 1, sourceId, () => {
230
242
  if (target === "cloud" && Buffer.byteLength(sourceId) > 512)
231
243
  throw new Error("Source finding ID exceeds the Cloud limit of 512 UTF-8 bytes.");
232
- result.findings.push({
233
- source_finding_id: sourceId,
234
- evidence: validateExternalEvidence(inputEvidence, target),
235
- });
236
- }
237
- catch (error) {
238
- result.excluded.push({
239
- position: index + 1,
240
- source_finding_id: sourceId,
241
- reason: errorMessage(error),
242
- });
243
- }
244
+ return validateExternalEvidence(inputEvidence, target);
245
+ });
244
246
  }
245
- return result;
247
+ return selection.finish();
246
248
  }
247
249
  //# sourceMappingURL=github-dependabot-findings.js.map
@@ -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, errorMessage } 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 { record, relativePath, requiredText, text } 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 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 try {\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 result.findings.push({\n source_finding_id: sourceId,\n evidence: validateExternalEvidence(inputEvidence, target),\n });\n } catch (error) {\n result.excluded.push({\n position: index + 1,\n source_finding_id: sourceId,\n reason: errorMessage(error),\n });\n }\n }\n return result;\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 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(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 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,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;AAK1E,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;AA4SrE,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;AAM1E,OAAO,EACL,qBAAqB,EAOtB,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;AA+QrE,yGAAyG;AACzG,wBAAgB,wBAAwB,CACtC,EAAE,QAAQ,EAAE,EAAE,eAAe,EAC7B,aAAa,+BAAwB,GACpC,MAAM,GAAG,SAAS,CAiCpB;AAiXD,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"}