@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,14 +1,13 @@
1
1
  import { hash } from "node:crypto";
2
+ import { isDeepStrictEqual } from "node:util";
3
+ import { isBoxedPrimitive, isDate, isProxy } from "node:util/types";
2
4
  import { GHSA_ID, githubRepositoryParts } from "./github-identifiers.js";
3
5
  import { CodexSecurityError, errorMessage } from "./errors.js";
4
- import { validateExternalEvidence } from "./external-import-contract.js";
6
+ import { cloudRepositoryUrlKey, CloudEvidenceDepthError, exportedGitHubRecord, previousGitHubExclusion, validateExternalEvidenceFields, validateExternalEvidenceJson, validateExternalEvidence, } from "./external-import-contract.js";
5
7
  import { isGitHubDependabotAlert, normalizeGitHubDependabotAlerts, } from "./github-dependabot-findings.js";
6
- import { parseJsonOrJsonl, readScannerText, text } from "./scanner-import.js";
7
- function object(value) {
8
- return value !== null && typeof value === "object" && !Array.isArray(value)
9
- ? value
10
- : undefined;
11
- }
8
+ import { asRecord, canSnapshotWithoutGetters, cloneWithoutGetters, } from "./record.js";
9
+ import { parseJsonOrJsonl, readScannerText, scannerSeverity, text, } from "./scanner-import.js";
10
+ import { rememberPreviousSelection, } from "./reader-selection.js";
12
11
  function repositoryName(value) {
13
12
  const repository = text(value);
14
13
  if (!repository || !githubRepositoryParts(repository))
@@ -31,16 +30,16 @@ function sourceTimestamp(value) {
31
30
  throw new Error("GitHub updated_at is not a valid timestamp.");
32
31
  return Math.floor(seconds);
33
32
  }
34
- function severity(value) {
35
- // SARIF error/warning/note are not vulnerability severity ratings.
36
- return typeof value === "string" &&
37
- ["critical", "high", "medium", "low", "informational"].includes(value)
38
- ? value
39
- : "unknown";
33
+ function codeScanningPrefix({ parsed, host }, repository, number) {
34
+ const name = repository.toLowerCase();
35
+ const path = parsed.pathname.toLowerCase();
36
+ const alert = `code-scanning/${number}`;
37
+ if (path === `/${name}/${alert}` || path === `/${name}/security/${alert}`)
38
+ return `${host}/${name}/${alert}/`;
40
39
  }
41
- function codeScanningFinding(record, target = "cloud") {
42
- const repository = repositoryName(record["repository"]);
43
- const alert = object(record["alert"]);
40
+ function codeScanningSource(record) {
41
+ const name = repositoryName(record["repository"]);
42
+ const alert = asRecord(record["alert"]);
44
43
  const number = record["number"];
45
44
  if (!alert ||
46
45
  typeof number !== "number" ||
@@ -51,18 +50,23 @@ function codeScanningFinding(record, target = "cloud") {
51
50
  const url = text(record["url"]);
52
51
  if (!url || url !== alert["html_url"])
53
52
  throw new Error("GitHub alert URL must match the original alert.");
54
- const { parsed: parsedUrl, host, origin } = sourceUrl(url);
55
- if (!["security/code-scanning", "code-scanning"].some((route) => parsedUrl.pathname.toLowerCase() ===
56
- `/${repository}/${route}/${number}`.toLowerCase()))
53
+ const link = sourceUrl(url);
54
+ const prefix = codeScanningPrefix(link, name, number);
55
+ if (!prefix)
57
56
  throw new Error("GitHub alert URL does not match the selected repository and alert.");
58
- const rule = object(alert["rule"]);
59
- const instance = object(alert["most_recent_instance"]);
57
+ const repository = { url: `${link.origin}/${name}`, name };
58
+ return { alert, number, prefix, url, repository };
59
+ }
60
+ function codeScanningFinding(record) {
61
+ const { alert, number, prefix, url, repository } = codeScanningSource(record);
62
+ const rule = asRecord(alert["rule"]);
63
+ const instance = asRecord(alert["most_recent_instance"]);
60
64
  const ref = text(instance?.["ref"]);
61
65
  if (!ref)
62
66
  throw new Error("GitHub code-scanning evidence requires the selected instance ref.");
63
- const location = object(instance?.["location"]);
64
- const tool = object(alert["tool"]);
65
- const message = text(object(instance?.["message"])?.["text"]);
67
+ const location = asRecord(instance?.["location"]);
68
+ const tool = asRecord(alert["tool"]);
69
+ const message = text(asRecord(instance?.["message"])?.["text"]);
66
70
  const description = text(rule?.["full_description"]) ?? text(rule?.["description"]);
67
71
  const tags = Array.isArray(rule?.["tags"]) ? rule["tags"] : [];
68
72
  const weaknessIds = [
@@ -74,30 +78,25 @@ function codeScanningFinding(record, target = "cloud") {
74
78
  })),
75
79
  ];
76
80
  const path = text(location?.["path"]);
77
- const sourceId = `${host}/${repository.toLowerCase()}/code-scanning/${number}/${hash("sha256", ref)}`;
78
81
  return {
79
- source_finding_id: sourceId,
80
- evidence: validateExternalEvidence({
82
+ source_finding_id: prefix + hash("sha256", ref),
83
+ evidence: {
81
84
  title: text(rule?.["name"]) ??
82
85
  text(rule?.["description"]) ??
83
86
  `GitHub code-scanning alert #${number}`,
84
- severity: severity(rule?.["security_severity_level"]),
87
+ // SARIF error, warning and note describe diagnostics. Use the security rating.
88
+ severity: scannerSeverity(text(rule?.["security_severity_level"])),
85
89
  description: [...new Set([message, description].filter(Boolean))].join("\n\n") ||
86
90
  null,
87
91
  url,
88
- locations: path
89
- ? [{ path, line: location?.["start_line"] ?? null }]
90
- : [],
92
+ locations: path ? [{ path, line: location?.["start_line"] ?? null }] : [],
91
93
  branch: ref,
92
94
  code_revision: text(instance?.["commit_sha"]),
93
95
  source_updated_at: sourceTimestamp(alert["updated_at"]),
94
96
  source_data: record,
95
97
  details: {
96
98
  kind: "sast",
97
- repository: {
98
- url: `${origin}/${repository}`,
99
- name: repository,
100
- },
99
+ repository,
101
100
  // Dismissal covers every branch; detection state belongs to the selected ref.
102
101
  source_status: alert["state"] === "dismissed"
103
102
  ? "dismissed"
@@ -108,12 +107,15 @@ function codeScanningFinding(record, target = "cloud") {
108
107
  remediation_instructions: text(rule?.["help"]),
109
108
  code: path ? { end_line: location?.["end_line"] ?? null } : null,
110
109
  },
111
- }, target),
110
+ },
112
111
  };
113
112
  }
114
- function advisoryFinding(record, target = "cloud") {
115
- const repository = repositoryName(record["repository"]);
116
- const advisory = object(record["advisory"]);
113
+ function advisorySourceId(host, selection, repository, id) {
114
+ return `${host}/${selection === "repository" ? repository.toLowerCase() : "global"}/security-advisory/${id.toUpperCase()}`;
115
+ }
116
+ function advisorySource(record) {
117
+ const name = repositoryName(record["repository"]);
118
+ const advisory = asRecord(record["advisory"]);
117
119
  const id = text(record["ghsaId"]);
118
120
  const selection = record["selection"];
119
121
  if (!advisory ||
@@ -131,12 +133,17 @@ function advisoryFinding(record, target = "cloud") {
131
133
  // Enterprise APIs may return the public advisory database's canonical link.
132
134
  const canonicalGlobalLink = selection === "global" && parsedUrl.host === "github.com";
133
135
  const expectedPath = selection === "repository"
134
- ? `/${repository}/security/advisories/${id}`
136
+ ? `/${name}/security/advisories/${id}`
135
137
  : `/advisories/${id}`;
136
138
  if (!host ||
137
139
  (linkHost !== host && !canonicalGlobalLink) ||
138
140
  parsedUrl.pathname.toLowerCase() !== expectedPath.toLowerCase())
139
141
  throw new Error("GitHub advisory URL does not match the selected source and GHSA ID.");
142
+ const repository = { url: `${origin}/${name}`, name };
143
+ return { advisory, id, selection, url, host, repository };
144
+ }
145
+ function advisoryFinding(record) {
146
+ const { advisory, id, selection, url, host, repository } = advisorySource(record);
140
147
  const vulnerabilities = advisory["vulnerabilities"] === null ? [] : advisory["vulnerabilities"];
141
148
  if (!Array.isArray(vulnerabilities))
142
149
  throw new Error("GitHub advisory vulnerabilities must be an array.");
@@ -146,11 +153,11 @@ function advisoryFinding(record, target = "cloud") {
146
153
  const advisoryIds = [
147
154
  id,
148
155
  text(advisory["cve_id"]),
149
- ...identifiers.map((identifier) => text(object(identifier)?.["value"])),
156
+ ...identifiers.map((identifier) => text(asRecord(identifier)?.["value"])),
150
157
  ].filter((value) => value !== null);
151
158
  const packages = vulnerabilities.flatMap((value) => {
152
- const vulnerability = object(value);
153
- const pkg = object(vulnerability?.["package"]);
159
+ const vulnerability = asRecord(value);
160
+ const pkg = asRecord(vulnerability?.["package"]);
154
161
  const name = text(pkg?.["name"]);
155
162
  // GitHub permits incomplete package metadata in advisory disclosures.
156
163
  // Preserve it in source_data without inventing a typed package identity.
@@ -169,10 +176,10 @@ function advisoryFinding(record, target = "cloud") {
169
176
  });
170
177
  const cwes = Array.isArray(advisory["cwes"]) ? advisory["cwes"] : [];
171
178
  return {
172
- source_finding_id: `${host}/${selection === "repository" ? repository.toLowerCase() : "global"}/security-advisory/${id.toUpperCase()}`,
173
- evidence: validateExternalEvidence({
179
+ source_finding_id: advisorySourceId(host, selection, repository.name, id),
180
+ evidence: {
174
181
  title: text(advisory["summary"]) ?? id,
175
- severity: severity(advisory["severity"]),
182
+ severity: scannerSeverity(text(advisory["severity"])),
176
183
  description: text(advisory["description"]),
177
184
  url,
178
185
  advisory_ids: [...new Set(advisoryIds)],
@@ -182,69 +189,375 @@ function advisoryFinding(record, target = "cloud") {
182
189
  details: {
183
190
  kind: "advisory",
184
191
  advisory: { source: selection },
185
- ...(selection === "repository"
186
- ? {
187
- repository: {
188
- url: `${origin}/${repository}`,
189
- name: repository,
190
- },
191
- }
192
- : {}),
192
+ ...(selection === "repository" ? { repository } : {}),
193
193
  source_status: text(advisory["withdrawn_at"])
194
194
  ? "withdrawn"
195
195
  : (text(advisory["state"]) ??
196
196
  (selection === "global" ? "published" : null)),
197
197
  scanner_origin: "GitHub Security Advisories",
198
198
  weakness_ids: cwes
199
- .map((value) => text(object(value)?.["cwe_id"]))
199
+ .map((value) => text(asRecord(value)?.["cwe_id"]))
200
200
  .filter((value) => value !== null),
201
201
  },
202
- }, target),
202
+ },
203
203
  };
204
204
  }
205
- function normalizeRecords(records, target = "cloud") {
205
+ /** Keep the repository from a retained collector export when SDK callers supply their own projection. */
206
+ export function retainedGitHubRepository({ evidence }, repositoryKey = cloudRepositoryUrlKey) {
207
+ const data = evidence.source_data;
208
+ if (!data?.["url"] || !data["repository"])
209
+ return;
210
+ let source;
211
+ if (data["source"] === "github-code-scanning" &&
212
+ data["number"] !== undefined &&
213
+ asRecord(data["alert"])?.["html_url"]) {
214
+ source = codeScanningSource(data);
215
+ }
216
+ else if (data["source"] === "github-security-advisory" &&
217
+ data["ghsaId"] &&
218
+ data["githubHost"] &&
219
+ data["selection"] &&
220
+ asRecord(data["advisory"])?.["html_url"]) {
221
+ source = advisorySource(data);
222
+ if (source.selection === "global") {
223
+ if (evidence.details?.repository)
224
+ throw new CodexSecurityError("Global advisory evidence cannot claim a source repository.");
225
+ return;
226
+ }
227
+ }
228
+ else
229
+ return;
230
+ const native = source.repository.url;
231
+ const projected = evidence.details?.repository?.url;
232
+ if (projected && repositoryKey(projected) !== repositoryKey(native))
233
+ throw new CodexSecurityError("The normalized repository does not match the original GitHub finding.");
234
+ return native;
235
+ }
236
+ function mapRecord(input) {
237
+ const record = asRecord(input);
238
+ if (!record)
239
+ throw new Error("GitHub finding must be an object.");
240
+ if (record["source"] === "github-code-scanning")
241
+ return codeScanningFinding(record);
242
+ if (record["source"] === "github-security-advisory")
243
+ return advisoryFinding(record);
244
+ throw new Error("Expected saved output from import github or import github-advisories; raw or incomplete API responses need an explicit mapping.");
245
+ }
246
+ function ownData(value, key) {
247
+ if (value && typeof value === "object" && !isProxy(value))
248
+ return Object.getOwnPropertyDescriptor(value, key)?.value;
249
+ }
250
+ function priorAdvisoryId(value) {
251
+ if (ownData(value, "source") !== "github-security-advisory")
252
+ return;
253
+ const id = text(ownData(value, "ghsaId"));
254
+ const host = text(ownData(value, "githubHost"))?.toLowerCase();
255
+ const selection = ownData(value, "selection");
256
+ const repository = text(ownData(value, "repository"));
257
+ if (id &&
258
+ GHSA_ID.test(id) &&
259
+ host &&
260
+ repository &&
261
+ githubRepositoryParts(repository) &&
262
+ (selection === "repository" || selection === "global"))
263
+ return advisorySourceId(host, selection, repository, id);
264
+ }
265
+ // Determine whether JSON can call a serializer without evaluating a getter.
266
+ function maySerialize(value) {
267
+ while (value && typeof value === "object") {
268
+ if (isProxy(value))
269
+ return true;
270
+ const field = Object.getOwnPropertyDescriptor(value, "toJSON");
271
+ if (field)
272
+ return (!Object.hasOwn(field, "value") || typeof field.value === "function");
273
+ value = Object.getPrototypeOf(value);
274
+ }
275
+ return false;
276
+ }
277
+ function codeOccurrencePrefix(value) {
278
+ const repository = ownData(value, "repository"), number = ownData(value, "number"), url = ownData(value, "url");
279
+ if (ownData(value, "source") !== "github-code-scanning" ||
280
+ typeof repository !== "string" ||
281
+ !githubRepositoryParts(repository) ||
282
+ typeof number !== "number" ||
283
+ !Number.isSafeInteger(number) ||
284
+ number <= 0 ||
285
+ typeof url !== "string")
286
+ return;
287
+ try {
288
+ return codeScanningPrefix(sourceUrl(url), repository, number);
289
+ }
290
+ catch {
291
+ /* No validated occurrence anchor. */
292
+ }
293
+ }
294
+ // The released reader measured the caller's source_data JSON before native capture.
295
+ function captureGitHubRecord(input, target) {
296
+ // Only plain records, arrays and standard Buffers have a reconstructable wire size.
297
+ let plainBuffers = [];
298
+ let hiddenFields = false;
299
+ let largeLocalRow = false;
300
+ const record = cloneWithoutGetters(input, (value) => {
301
+ const prototype = Object.getPrototypeOf(value);
302
+ if (target === "local" &&
303
+ ((Array.isArray(value) && value.length > 256 * 1024) ||
304
+ (prototype === Buffer.prototype &&
305
+ Buffer.isBuffer(value) &&
306
+ !Object.hasOwn(value, "byteLength") &&
307
+ value.byteLength > 256 * 1024))) {
308
+ largeLocalRow = true;
309
+ return false;
310
+ }
311
+ // Native capture drops non-enumerable fields the released vendor mapper could read.
312
+ if (!Array.isArray(value) &&
313
+ !ArrayBuffer.isView(value) &&
314
+ !isBoxedPrimitive(value) &&
315
+ !isDate(value) &&
316
+ Object.getOwnPropertyNames(value).some((key) => key !== "toJSON" &&
317
+ !Object.prototype.propertyIsEnumerable.call(value, key)))
318
+ hiddenFields = true;
319
+ if (!plainBuffers)
320
+ return;
321
+ if (Buffer.isBuffer(value)) {
322
+ if (prototype === Buffer.prototype &&
323
+ !Object.hasOwn(value, "toJSON") &&
324
+ !Object.hasOwn(value, "length") &&
325
+ !("_arr" in value))
326
+ plainBuffers.push(value);
327
+ else
328
+ plainBuffers = undefined;
329
+ }
330
+ else if ((prototype !== Object.prototype &&
331
+ prototype !== null &&
332
+ prototype !== Array.prototype) ||
333
+ maySerialize(value))
334
+ plainBuffers = undefined;
335
+ });
336
+ return {
337
+ record: asRecord(record),
338
+ hiddenFields,
339
+ plainBuffers,
340
+ largeLocalRow,
341
+ };
342
+ }
343
+ function normalizeRecords(records, target = "cloud", snapshot = false) {
206
344
  const result = {
207
345
  read: records.length,
208
346
  findings: [],
209
347
  excluded: [],
210
348
  };
349
+ const previous = snapshot
350
+ ? { read: records.length, findings: [], excluded: [] }
351
+ : undefined;
352
+ const checks = [];
353
+ const uncertainIds = new Set();
354
+ const unidentifiedRows = new Set();
355
+ let independentlyObserved = Infinity;
356
+ let ranRootSerializer = false;
357
+ let largeLocalSelection = false;
358
+ const potentialIds = [];
359
+ const prefixes = new Set();
211
360
  const identities = new Set();
212
- for (const [index, value] of records.entries()) {
213
- const record = object(value);
361
+ for (const [index, input] of records.entries()) {
362
+ const afterRootSerializer = ranRootSerializer;
363
+ const keySensitive = previous !== undefined && maySerialize(input);
364
+ ranRootSerializer ||= keySensitive;
365
+ let exported = input;
366
+ const capture = previous ? captureGitHubRecord(input, target) : undefined;
367
+ const before = capture?.record;
368
+ const priorPrefix = previous ? codeOccurrencePrefix(input) : undefined;
369
+ let priorId = previous ? priorAdvisoryId(input) : undefined;
370
+ let prefix = priorPrefix;
371
+ const rowIds = new Set();
372
+ let rowUncertain = false;
373
+ const priorRowCount = previous?.findings.length ?? 0;
374
+ function possible() {
375
+ rowUncertain = true;
376
+ // A caller getter can mutate a later row before its native evidence is seen.
377
+ independentlyObserved = Math.min(independentlyObserved, priorRowCount);
378
+ for (const id of rowIds)
379
+ uncertainIds.add(id);
380
+ if (prefix)
381
+ prefixes.add(prefix);
382
+ if (priorId)
383
+ uncertainIds.add(priorId);
384
+ else if (!priorPrefix)
385
+ unidentifiedRows.add(index);
386
+ }
387
+ // The old reader called a root serializer with "source_data" rather than its
388
+ // array index. That code could change a later occurrence before it was read.
389
+ if (afterRootSerializer) {
390
+ possible();
391
+ unidentifiedRows.add(index);
392
+ }
393
+ function retainPrevious(selection, id, evidence) {
394
+ selection.findings.push({ source_finding_id: id, evidence });
395
+ potentialIds.push(id);
396
+ checks.push(() => {
397
+ if (!isDeepStrictEqual(before, asRecord(cloneWithoutGetters(input))))
398
+ possible();
399
+ });
400
+ }
401
+ const exclusion = (record, reason) => ({
402
+ position: index + 1,
403
+ source_finding_id: text(asRecord(record)?.["url"]),
404
+ reason,
405
+ });
406
+ let possibleFreshId = false;
214
407
  try {
215
- if (!record)
216
- throw new Error("GitHub finding must be an object.");
217
- let finding;
218
- if (record["source"] === "github-code-scanning")
219
- finding = codeScanningFinding(record, target);
220
- else if (record["source"] === "github-security-advisory")
221
- finding = advisoryFinding(record, target);
222
- else
223
- throw new Error("Expected saved output from import github or import github-advisories; raw or incomplete API responses need an explicit mapping.");
224
- if (identities.has(finding.source_finding_id))
225
- throw new CodexSecurityError(`Duplicate source finding id ${JSON.stringify(finding.source_finding_id)}. Select each GitHub occurrence once.`);
226
- identities.add(finding.source_finding_id);
227
- result.findings.push(finding);
408
+ if (previous && capture) {
409
+ const source = exportedGitHubRecord(input, index, target, target === "local" && !capture.largeLocalRow);
410
+ exported = source.record;
411
+ prefix ??= codeOccurrencePrefix(exported);
412
+ // A serializer or Buffer can expand a native record that fit the approved request.
413
+ const oversizedLocalRow = target === "local" &&
414
+ (capture.largeLocalRow ||
415
+ (source.bytes > 256 * 1024 &&
416
+ (!before || capture.plainBuffers?.length === 0)));
417
+ if (oversizedLocalRow || !before) {
418
+ if (!oversizedLocalRow &&
419
+ source.previousInvalid &&
420
+ !source.skippedRawValue &&
421
+ canSnapshotWithoutGetters(input)) {
422
+ previous.excluded.push(exclusion(exported, errorMessage(source.previousInvalid)));
423
+ }
424
+ else if (target !== "local" &&
425
+ source.bytes + source.adjustment > 256 * 1024 &&
426
+ canSnapshotWithoutGetters(input) &&
427
+ !keySensitive) {
428
+ previous.excluded.push(exclusion(exported, "Evidence exceeds the Cloud limit of 256 KiB."));
429
+ }
430
+ else {
431
+ largeLocalSelection ||= oversizedLocalRow;
432
+ // An occurrence without independent native evidence can only stop a retry.
433
+ possible();
434
+ possibleFreshId = true;
435
+ }
436
+ }
437
+ else {
438
+ if (capture.hiddenFields || source.skippedRawValue)
439
+ possible();
440
+ try {
441
+ const row = mapRecord(before);
442
+ const knownOldId = row.source_finding_id;
443
+ priorId = knownOldId;
444
+ if (!afterRootSerializer)
445
+ unidentifiedRows.delete(index);
446
+ rowIds.add(knownOldId);
447
+ if (rowUncertain)
448
+ uncertainIds.add(knownOldId);
449
+ const evidence = validateExternalEvidenceFields(row.evidence, target);
450
+ if (source.previousInvalid)
451
+ throw source.previousInvalid;
452
+ if (keySensitive)
453
+ possible();
454
+ const reason = keySensitive || target === "local"
455
+ ? undefined
456
+ : previousGitHubExclusion(evidence, source.bytes, source.adjustment);
457
+ if (reason)
458
+ previous.excluded.push(exclusion(before, reason));
459
+ else
460
+ retainPrevious(previous, knownOldId, evidence);
461
+ }
462
+ catch (error) {
463
+ previous.excluded.push(exclusion(before, errorMessage(error)));
464
+ }
465
+ }
466
+ if (source.invalid)
467
+ throw source.invalid;
468
+ }
469
+ const mapped = mapRecord(exported), id = mapped.source_finding_id;
470
+ rowIds.add(id);
471
+ if (rowUncertain)
472
+ uncertainIds.add(id);
473
+ if (possibleFreshId)
474
+ potentialIds.push(id);
475
+ const evidence = validateExternalEvidence(mapped.evidence, target);
476
+ if (identities.has(id))
477
+ throw new CodexSecurityError(`Duplicate source finding id ${JSON.stringify(id)}. Select each GitHub occurrence once.`);
478
+ identities.add(id);
479
+ result.findings.push({ source_finding_id: id, evidence });
228
480
  }
229
481
  catch (error) {
230
482
  if (error instanceof CodexSecurityError)
231
483
  throw error;
232
- result.excluded.push({
233
- position: index + 1,
234
- source_finding_id: text(record?.["url"]),
235
- reason: errorMessage(error),
236
- });
484
+ const reason = errorMessage(error);
485
+ result.excluded.push(exclusion(snapshot && exported === input
486
+ ? { url: ownData(input, "url") }
487
+ : exported, reason));
488
+ if (previous && exported === input) {
489
+ if (error instanceof CloudEvidenceDepthError &&
490
+ before &&
491
+ // Extra Buffer fields were inspected by the old row validator, but
492
+ // structuredClone does not retain them as part of the typed array.
493
+ capture?.plainBuffers?.every((buffer) => Object.keys(buffer).length === buffer.length)) {
494
+ // Exported JSON can be deeper than an approved native snapshot.
495
+ // Retain only the independently observed, valid prior selection.
496
+ try {
497
+ const row = mapRecord(before);
498
+ const evidence = validateExternalEvidence(row.evidence, target);
499
+ const savedSource = JSON.stringify(evidence.source_data);
500
+ // structuredClone turns each Buffer into a Uint8Array. Reconstruct its
501
+ // original serialized size on detached data without running caller hooks.
502
+ const oldSource = JSON.stringify(evidence.source_data, (_key, value) => value instanceof Uint8Array
503
+ ? { type: "Buffer", data: [...value] }
504
+ : value);
505
+ validateExternalEvidenceJson(evidence, target, Buffer.byteLength(oldSource) - Buffer.byteLength(savedSource));
506
+ retainPrevious(previous, row.source_finding_id, evidence);
507
+ }
508
+ catch (priorError) {
509
+ previous.excluded.push(exclusion(before, errorMessage(priorError)));
510
+ }
511
+ continue;
512
+ }
513
+ // A serializer may throw at its array key while the old source_data
514
+ // key produced a valid record. Keep only evidence for refusing a match.
515
+ possible();
516
+ if (before)
517
+ try {
518
+ const id = mapRecord(before).source_finding_id;
519
+ priorId = id;
520
+ if (!afterRootSerializer)
521
+ unidentifiedRows.delete(index);
522
+ potentialIds.push(id);
523
+ uncertainIds.add(id);
524
+ }
525
+ catch {
526
+ /* No old identity. */
527
+ }
528
+ }
529
+ }
530
+ }
531
+ if (previous) {
532
+ for (const check of checks)
533
+ check();
534
+ const uncertain = independentlyObserved !== Infinity;
535
+ if (uncertain || !isDeepStrictEqual(previous.findings, result.findings)) {
536
+ const prior = { sourceFindingIds: potentialIds };
537
+ if (uncertain) {
538
+ prior.unprovenIdPrefixes = [...prefixes];
539
+ prior.uncertainFindingIds = [...uncertainIds];
540
+ if (unidentifiedRows.size)
541
+ prior.unprovenOccurrenceCount = unidentifiedRows.size;
542
+ if (!largeLocalSelection)
543
+ prior.knownFindings = previous.findings
544
+ .slice(0, independentlyObserved)
545
+ .filter((finding) => !uncertainIds.has(finding.source_finding_id));
546
+ }
547
+ else
548
+ prior.snapshot = previous;
549
+ rememberPreviousSelection(result, prior);
237
550
  }
238
551
  }
239
552
  return result;
240
553
  }
241
554
  /** Map selected code-scanning instances while retaining complete upstream evidence. */
242
555
  export function normalizeGitHubCodeScanningAlerts(alerts, target = "cloud") {
243
- return normalizeRecords(alerts, target);
556
+ return normalizeRecords(alerts, target, true);
244
557
  }
245
558
  /** Map advisory disclosures without asserting an installed vulnerable dependency. */
246
559
  export function normalizeGitHubAdvisories(advisories, target = "cloud") {
247
- return normalizeRecords(advisories, target);
560
+ return normalizeRecords(advisories, target, true);
248
561
  }
249
562
  /** Read unfiltered JSON/JSONL output saved by the read-only GitHub import commands. */
250
563
  export async function readGitHubFindings(path, target = "cloud") {