@openai/codex-security 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (484) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +4 -0
  4. package/_bundled_plugin/.mcp.json +2 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
  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/permission-profile-preflight.mjs +556 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +2 -2
  25. package/_bundled_plugin/references/config-preflight.md +0 -4
  26. package/_bundled_plugin/references/core-scan.md +21 -9
  27. package/_bundled_plugin/references/final-report.md +11 -13
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +1 -2
  31. package/_bundled_plugin/references/scan-contract.md +9 -4
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +1 -1
  36. package/_bundled_plugin/schemas/coverage.schema.json +43 -170
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +159 -567
  40. package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
  41. package/_bundled_plugin/schemas/scan-manifest.schema.json +78 -220
  42. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  43. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  44. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  45. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  46. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  47. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  48. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  49. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  50. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  51. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  52. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +321 -237
  54. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  56. package/_bundled_plugin/scripts/generate_rank_input.py +115 -926
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  60. package/_bundled_plugin/scripts/report_projection.py +150 -183
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  63. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  64. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  65. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  66. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  67. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  68. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +102 -184
  70. package/_bundled_plugin/scripts/workbench_db.py +463 -464
  71. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  74. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  75. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  76. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  77. package/_bundled_plugin/scripts/workbench_publication.py +234 -289
  78. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  79. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  80. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  81. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  82. package/_bundled_plugin/scripts/workbench_scan_usage.py +194 -42
  83. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  85. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  86. package/_bundled_plugin/scripts/workbench_validation.py +31 -28
  87. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  88. package/_bundled_plugin/shared/workbench-migrations.json +414 -0
  89. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  90. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  92. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  93. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  94. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  95. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  96. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  97. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  98. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  99. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +15 -1
  100. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  101. package/_bundled_plugin/skills/track-findings/SKILL.md +48 -176
  102. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  103. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  104. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  105. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  106. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  107. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  108. package/bin/codex-security.mjs +9 -2
  109. package/dist/api.d.ts +63 -10
  110. package/dist/api.d.ts.map +1 -1
  111. package/dist/api.js +1015 -383
  112. package/dist/api.js.map +1 -1
  113. package/dist/artifact-export.d.ts +1 -1
  114. package/dist/artifact-export.d.ts.map +1 -1
  115. package/dist/artifact-export.js +28 -13
  116. package/dist/artifact-export.js.map +1 -1
  117. package/dist/auth.d.ts +2 -6
  118. package/dist/auth.d.ts.map +1 -1
  119. package/dist/auth.js +19 -9
  120. package/dist/auth.js.map +1 -1
  121. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  122. package/dist/bulk-scan-discovery.js +1 -0
  123. package/dist/bulk-scan-discovery.js.map +1 -1
  124. package/dist/classify-severity.d.ts +26 -9
  125. package/dist/classify-severity.d.ts.map +1 -1
  126. package/dist/classify-severity.js +13 -30
  127. package/dist/classify-severity.js.map +1 -1
  128. package/dist/cli-help.d.ts.map +1 -1
  129. package/dist/cli-help.js +17 -13
  130. package/dist/cli-help.js.map +1 -1
  131. package/dist/cli-signals.d.ts +8 -0
  132. package/dist/cli-signals.d.ts.map +1 -0
  133. package/dist/cli-signals.js +28 -0
  134. package/dist/cli-signals.js.map +1 -0
  135. package/dist/cli.d.ts +4 -3
  136. package/dist/cli.d.ts.map +1 -1
  137. package/dist/cli.js +1102 -905
  138. package/dist/cli.js.map +1 -1
  139. package/dist/cloud-publish.d.ts.map +1 -1
  140. package/dist/cloud-publish.js +10 -9
  141. package/dist/cloud-publish.js.map +1 -1
  142. package/dist/codeowners.d.ts +19 -0
  143. package/dist/codeowners.d.ts.map +1 -0
  144. package/dist/codeowners.js +138 -0
  145. package/dist/codeowners.js.map +1 -0
  146. package/dist/codex-sdk-environment.d.ts +1 -0
  147. package/dist/codex-sdk-environment.d.ts.map +1 -1
  148. package/dist/codex-sdk-environment.js +40 -2
  149. package/dist/codex-sdk-environment.js.map +1 -1
  150. package/dist/component-plan.d.ts +2 -5
  151. package/dist/component-plan.d.ts.map +1 -1
  152. package/dist/component-plan.js +39 -31
  153. package/dist/component-plan.js.map +1 -1
  154. package/dist/component-scan.d.ts +6 -5
  155. package/dist/component-scan.d.ts.map +1 -1
  156. package/dist/component-scan.js +25 -36
  157. package/dist/component-scan.js.map +1 -1
  158. package/dist/config.d.ts.map +1 -1
  159. package/dist/config.js +64 -74
  160. package/dist/config.js.map +1 -1
  161. package/dist/contract.d.ts +16 -3
  162. package/dist/contract.d.ts.map +1 -1
  163. package/dist/contract.js +91 -255
  164. package/dist/contract.js.map +1 -1
  165. package/dist/cost-model.d.ts +13 -6
  166. package/dist/cost-model.d.ts.map +1 -1
  167. package/dist/cost-model.js +14 -4
  168. package/dist/cost-model.js.map +1 -1
  169. package/dist/cost.d.ts +10 -2
  170. package/dist/cost.d.ts.map +1 -1
  171. package/dist/cost.js +102 -104
  172. package/dist/cost.js.map +1 -1
  173. package/dist/custom-validation-prompt.d.ts.map +1 -1
  174. package/dist/custom-validation-prompt.js +6 -5
  175. package/dist/custom-validation-prompt.js.map +1 -1
  176. package/dist/custom-validation.d.ts +1 -2
  177. package/dist/custom-validation.d.ts.map +1 -1
  178. package/dist/custom-validation.js +9 -3
  179. package/dist/custom-validation.js.map +1 -1
  180. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  181. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  182. package/dist/deduplication/checkpointed-review.js +23 -9
  183. package/dist/deduplication/checkpointed-review.js.map +1 -1
  184. package/dist/deduplication/codex-review.d.ts +8 -6
  185. package/dist/deduplication/codex-review.d.ts.map +1 -1
  186. package/dist/deduplication/codex-review.js +128 -19
  187. package/dist/deduplication/codex-review.js.map +1 -1
  188. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  189. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  190. package/dist/deduplication/deduplication-prompts.js +18 -4
  191. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  192. package/dist/deduplication/deduplication-reviewer.d.ts +27 -5
  193. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  194. package/dist/deduplication/deduplication-reviewer.js +58 -48
  195. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  196. package/dist/deduplication/deduplication.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication.js +19 -51
  198. package/dist/deduplication/deduplication.js.map +1 -1
  199. package/dist/deduplication/diagnostics.d.ts +17 -0
  200. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  201. package/dist/deduplication/diagnostics.js +5 -0
  202. package/dist/deduplication/diagnostics.js.map +1 -0
  203. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  204. package/dist/deduplication/finding-schema.js +7 -1
  205. package/dist/deduplication/finding-schema.js.map +1 -1
  206. package/dist/deduplication/local.d.ts +31 -0
  207. package/dist/deduplication/local.d.ts.map +1 -0
  208. package/dist/deduplication/local.js +166 -0
  209. package/dist/deduplication/local.js.map +1 -0
  210. package/dist/deduplication/records-protocol.d.ts +3 -8
  211. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  212. package/dist/deduplication/records-protocol.js +11 -184
  213. package/dist/deduplication/records-protocol.js.map +1 -1
  214. package/dist/deduplication/records.d.ts +186 -11
  215. package/dist/deduplication/records.d.ts.map +1 -1
  216. package/dist/deduplication/records.js +10 -18
  217. package/dist/deduplication/records.js.map +1 -1
  218. package/dist/deduplication/scan.d.ts +9 -3
  219. package/dist/deduplication/scan.d.ts.map +1 -1
  220. package/dist/deduplication/scan.js +158 -39
  221. package/dist/deduplication/scan.js.map +1 -1
  222. package/dist/deep-config.d.ts +2 -1
  223. package/dist/deep-config.d.ts.map +1 -1
  224. package/dist/deep-config.js +4 -4
  225. package/dist/deep-config.js.map +1 -1
  226. package/dist/deep-progress.d.ts +17 -1
  227. package/dist/deep-progress.d.ts.map +1 -1
  228. package/dist/deep-progress.js +19 -17
  229. package/dist/deep-progress.js.map +1 -1
  230. package/dist/deep-scan.d.ts +20 -0
  231. package/dist/deep-scan.d.ts.map +1 -0
  232. package/dist/deep-scan.js +113 -0
  233. package/dist/deep-scan.js.map +1 -0
  234. package/dist/errors.d.ts +2 -0
  235. package/dist/errors.d.ts.map +1 -1
  236. package/dist/errors.js +2 -0
  237. package/dist/errors.js.map +1 -1
  238. package/dist/executable-path.d.ts +2 -0
  239. package/dist/executable-path.d.ts.map +1 -0
  240. package/dist/executable-path.js +12 -0
  241. package/dist/executable-path.js.map +1 -0
  242. package/dist/feedback.d.ts +1 -4
  243. package/dist/feedback.d.ts.map +1 -1
  244. package/dist/feedback.js +54 -22
  245. package/dist/feedback.js.map +1 -1
  246. package/dist/finding-catalogue.d.ts.map +1 -1
  247. package/dist/finding-catalogue.js +4 -8
  248. package/dist/finding-catalogue.js.map +1 -1
  249. package/dist/finding-normalization.d.ts +5 -0
  250. package/dist/finding-normalization.d.ts.map +1 -0
  251. package/dist/finding-normalization.js +120 -0
  252. package/dist/finding-normalization.js.map +1 -0
  253. package/dist/finding-retrieval.d.ts +9 -0
  254. package/dist/finding-retrieval.d.ts.map +1 -1
  255. package/dist/finding-retrieval.js.map +1 -1
  256. package/dist/finding-workflow.d.ts +13 -8
  257. package/dist/finding-workflow.d.ts.map +1 -1
  258. package/dist/finding-workflow.js +14 -6
  259. package/dist/finding-workflow.js.map +1 -1
  260. package/dist/findings-client.d.ts +2 -1
  261. package/dist/findings-client.d.ts.map +1 -1
  262. package/dist/findings-client.js +36 -9
  263. package/dist/findings-client.js.map +1 -1
  264. package/dist/findings-errors.d.ts +16 -0
  265. package/dist/findings-errors.d.ts.map +1 -0
  266. package/dist/findings-errors.js +24 -0
  267. package/dist/findings-errors.js.map +1 -0
  268. package/dist/findings-import.d.ts +1 -1
  269. package/dist/findings-import.d.ts.map +1 -1
  270. package/dist/findings-import.js +12 -30
  271. package/dist/findings-import.js.map +1 -1
  272. package/dist/github.d.ts.map +1 -1
  273. package/dist/github.js +7 -1
  274. package/dist/github.js.map +1 -1
  275. package/dist/host-protocol.d.ts +19 -0
  276. package/dist/host-protocol.d.ts.map +1 -0
  277. package/dist/host-protocol.js +270 -0
  278. package/dist/host-protocol.js.map +1 -0
  279. package/dist/hosted-scan-protocol.d.ts +4 -0
  280. package/dist/hosted-scan-protocol.d.ts.map +1 -0
  281. package/dist/hosted-scan-protocol.js +25 -0
  282. package/dist/hosted-scan-protocol.js.map +1 -0
  283. package/dist/hosted-scan.d.ts +117 -0
  284. package/dist/hosted-scan.d.ts.map +1 -0
  285. package/dist/hosted-scan.js +260 -0
  286. package/dist/hosted-scan.js.map +1 -0
  287. package/dist/import-scan.d.ts.map +1 -1
  288. package/dist/import-scan.js +48 -38
  289. package/dist/import-scan.js.map +1 -1
  290. package/dist/index.d.ts +11 -4
  291. package/dist/index.d.ts.map +1 -1
  292. package/dist/index.js +2 -1
  293. package/dist/index.js.map +1 -1
  294. package/dist/knowledge-base.d.ts +7 -1
  295. package/dist/knowledge-base.d.ts.map +1 -1
  296. package/dist/knowledge-base.js +114 -46
  297. package/dist/knowledge-base.js.map +1 -1
  298. package/dist/linear.d.ts.map +1 -1
  299. package/dist/linear.js +2 -7
  300. package/dist/linear.js.map +1 -1
  301. package/dist/mock-scan.d.ts.map +1 -1
  302. package/dist/mock-scan.js +0 -1
  303. package/dist/mock-scan.js.map +1 -1
  304. package/dist/models.d.ts +0 -2
  305. package/dist/models.d.ts.map +1 -1
  306. package/dist/models.js.map +1 -1
  307. package/dist/multiscan.d.ts +9 -3
  308. package/dist/multiscan.d.ts.map +1 -1
  309. package/dist/multiscan.js +240 -135
  310. package/dist/multiscan.js.map +1 -1
  311. package/dist/owner-evidence.d.ts +10 -2
  312. package/dist/owner-evidence.d.ts.map +1 -1
  313. package/dist/owner-evidence.js +67 -8
  314. package/dist/owner-evidence.js.map +1 -1
  315. package/dist/patch-tui.d.ts.map +1 -1
  316. package/dist/patch-tui.js +3 -2
  317. package/dist/patch-tui.js.map +1 -1
  318. package/dist/project-config.js +3 -3
  319. package/dist/project-config.js.map +1 -1
  320. package/dist/provider-profile.d.ts +21 -0
  321. package/dist/provider-profile.d.ts.map +1 -0
  322. package/dist/provider-profile.js +133 -0
  323. package/dist/provider-profile.js.map +1 -0
  324. package/dist/publication-events.d.ts +6 -8
  325. package/dist/publication-events.d.ts.map +1 -1
  326. package/dist/publication-events.js +25 -50
  327. package/dist/publication-events.js.map +1 -1
  328. package/dist/publication-store.d.ts.map +1 -1
  329. package/dist/publication-store.js +95 -109
  330. package/dist/publication-store.js.map +1 -1
  331. package/dist/publication.d.ts +1 -4
  332. package/dist/publication.d.ts.map +1 -1
  333. package/dist/publication.js +2 -13
  334. package/dist/publication.js.map +1 -1
  335. package/dist/publish.d.ts +1 -5
  336. package/dist/publish.d.ts.map +1 -1
  337. package/dist/publish.js +109 -160
  338. package/dist/publish.js.map +1 -1
  339. package/dist/request-metadata.d.ts +9 -0
  340. package/dist/request-metadata.d.ts.map +1 -0
  341. package/dist/request-metadata.js +13 -0
  342. package/dist/request-metadata.js.map +1 -0
  343. package/dist/runtime.d.ts +20 -6
  344. package/dist/runtime.d.ts.map +1 -1
  345. package/dist/runtime.js +407 -148
  346. package/dist/runtime.js.map +1 -1
  347. package/dist/saved-scan-bootstrap.d.ts +14 -0
  348. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  349. package/dist/saved-scan-bootstrap.js +261 -0
  350. package/dist/saved-scan-bootstrap.js.map +1 -0
  351. package/dist/saved-scan.d.ts +1 -1
  352. package/dist/saved-scan.d.ts.map +1 -1
  353. package/dist/saved-scan.js +6 -12
  354. package/dist/saved-scan.js.map +1 -1
  355. package/dist/scan-activity.js +11 -8
  356. package/dist/scan-activity.js.map +1 -1
  357. package/dist/scan-comparison.d.ts +28 -15
  358. package/dist/scan-comparison.d.ts.map +1 -1
  359. package/dist/scan-comparison.js +276 -281
  360. package/dist/scan-comparison.js.map +1 -1
  361. package/dist/scan-dashboard.d.ts +3 -0
  362. package/dist/scan-dashboard.d.ts.map +1 -1
  363. package/dist/scan-dashboard.js +345 -77
  364. package/dist/scan-dashboard.js.map +1 -1
  365. package/dist/scan-executor.d.ts +104 -0
  366. package/dist/scan-executor.d.ts.map +1 -0
  367. package/dist/scan-executor.js +62 -0
  368. package/dist/scan-executor.js.map +1 -0
  369. package/dist/scan-history-renderer.d.ts.map +1 -1
  370. package/dist/scan-history-renderer.js +54 -13
  371. package/dist/scan-history-renderer.js.map +1 -1
  372. package/dist/scan-inputs.d.ts +6 -0
  373. package/dist/scan-inputs.d.ts.map +1 -0
  374. package/dist/scan-inputs.js +71 -0
  375. package/dist/scan-inputs.js.map +1 -0
  376. package/dist/scan-logs.d.ts +2 -3
  377. package/dist/scan-logs.d.ts.map +1 -1
  378. package/dist/scan-logs.js +12 -6
  379. package/dist/scan-logs.js.map +1 -1
  380. package/dist/scan-sessions.d.ts +4 -0
  381. package/dist/scan-sessions.d.ts.map +1 -1
  382. package/dist/scan-sessions.js +17 -0
  383. package/dist/scan-sessions.js.map +1 -1
  384. package/dist/scan-skill-paths.d.ts +8 -0
  385. package/dist/scan-skill-paths.d.ts.map +1 -0
  386. package/dist/scan-skill-paths.js +47 -0
  387. package/dist/scan-skill-paths.js.map +1 -0
  388. package/dist/security-policy-cli.d.ts.map +1 -1
  389. package/dist/security-policy-cli.js +7 -27
  390. package/dist/security-policy-cli.js.map +1 -1
  391. package/dist/security-policy.d.ts +9 -5
  392. package/dist/security-policy.d.ts.map +1 -1
  393. package/dist/security-policy.js +33 -14
  394. package/dist/security-policy.js.map +1 -1
  395. package/dist/server/api.d.ts +0 -1
  396. package/dist/server/api.d.ts.map +1 -1
  397. package/dist/server/api.js +0 -1
  398. package/dist/server/api.js.map +1 -1
  399. package/dist/server/embeddings.d.ts +3 -1
  400. package/dist/server/embeddings.d.ts.map +1 -1
  401. package/dist/server/embeddings.js +10 -3
  402. package/dist/server/embeddings.js.map +1 -1
  403. package/dist/server/errors.d.ts +5 -2
  404. package/dist/server/errors.d.ts.map +1 -1
  405. package/dist/server/errors.js +7 -0
  406. package/dist/server/errors.js.map +1 -1
  407. package/dist/server/sqlite-store.d.ts +0 -2
  408. package/dist/server/sqlite-store.d.ts.map +1 -1
  409. package/dist/server/sqlite-store.js +54 -44
  410. package/dist/server/sqlite-store.js.map +1 -1
  411. package/dist/server/storage.d.ts +0 -2
  412. package/dist/server/storage.d.ts.map +1 -1
  413. package/dist/server/storage.js.map +1 -1
  414. package/dist/severity-store.js +19 -24
  415. package/dist/severity-store.js.map +1 -1
  416. package/dist/standalone-validation-prompt.d.ts +2 -0
  417. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  418. package/dist/standalone-validation-prompt.js +10 -0
  419. package/dist/standalone-validation-prompt.js.map +1 -0
  420. package/dist/suggest-owners.d.ts +4 -2
  421. package/dist/suggest-owners.d.ts.map +1 -1
  422. package/dist/suggest-owners.js +11 -5
  423. package/dist/suggest-owners.js.map +1 -1
  424. package/dist/targets.d.ts +11 -0
  425. package/dist/targets.d.ts.map +1 -1
  426. package/dist/targets.js +123 -72
  427. package/dist/targets.js.map +1 -1
  428. package/dist/trusted-executable.d.ts +2 -2
  429. package/dist/trusted-executable.d.ts.map +1 -1
  430. package/dist/trusted-executable.js +8 -6
  431. package/dist/trusted-executable.js.map +1 -1
  432. package/dist/value.js +7 -0
  433. package/dist/value.js.map +1 -1
  434. package/dist/version.js.map +1 -1
  435. package/dist/workbench-arguments.d.ts +3 -0
  436. package/dist/workbench-arguments.d.ts.map +1 -0
  437. package/dist/workbench-arguments.js +15 -0
  438. package/dist/workbench-arguments.js.map +1 -0
  439. package/dist/worker-progress.d.ts +44 -11
  440. package/dist/worker-progress.d.ts.map +1 -1
  441. package/dist/worker-progress.js +48 -49
  442. package/dist/worker-progress.js.map +1 -1
  443. package/docs/cli.md +1788 -0
  444. package/docs/findings-service.md +402 -0
  445. package/docs/hosted-scans.md +242 -0
  446. package/package.json +23 -22
  447. package/schemas/hosted-scan-v2.fixture.json +145 -0
  448. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  449. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  450. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  451. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  452. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  453. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  454. package/dist/server/dashboard/app.css +0 -2
  455. package/dist/server/dashboard/app.js +0 -66
  456. package/dist/server/dashboard/index.html +0 -18
  457. package/dist/server/dashboard-types.d.ts +0 -48
  458. package/dist/server/dashboard-types.d.ts.map +0 -1
  459. package/dist/server/dashboard-types.js +0 -2
  460. package/dist/server/dashboard-types.js.map +0 -1
  461. package/dist/server/dashboard.d.ts +0 -6
  462. package/dist/server/dashboard.d.ts.map +0 -1
  463. package/dist/server/dashboard.js +0 -59
  464. package/dist/server/dashboard.js.map +0 -1
  465. package/dist/server/index.d.ts +0 -2
  466. package/dist/server/index.d.ts.map +0 -1
  467. package/dist/server/index.js +0 -6
  468. package/dist/server/index.js.map +0 -1
  469. package/dist/server/routes.d.ts +0 -7
  470. package/dist/server/routes.d.ts.map +0 -1
  471. package/dist/server/routes.js +0 -98
  472. package/dist/server/routes.js.map +0 -1
  473. package/dist/server/serve.d.ts +0 -2
  474. package/dist/server/serve.d.ts.map +0 -1
  475. package/dist/server/serve.js +0 -28
  476. package/dist/server/serve.js.map +0 -1
  477. package/dist/server/server.d.ts +0 -10
  478. package/dist/server/server.d.ts.map +0 -1
  479. package/dist/server/server.js +0 -16
  480. package/dist/server/server.js.map +0 -1
  481. package/dist/server/validation.d.ts +0 -17
  482. package/dist/server/validation.d.ts.map +0 -1
  483. package/dist/server/validation.js +0 -53
  484. package/dist/server/validation.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"finding-workflow.js","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { isAbsolute, relative, sep } from \"node:path\";\nimport type { JsonObject } from \"./config.js\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport type { FindingSearchScope } from \"./finding-retrieval.js\";\nimport {\n bundledPluginRoot,\n canonicalizeModelSafePath,\n codexSecurityStateDirectory,\n workbenchEnvironment,\n resolvePluginPython,\n runWorkbench,\n type WorkbenchCommandOptions,\n} from \"./runtime.js\";\n\nexport type WorkflowStage = \"scan\" | \"publish\" | \"dedupe\";\nexport interface WorkflowBinding {\n repositoryPath?: string;\n scanRequestDigest?: string;\n scanId?: string;\n scanDir?: string;\n artifactDigest?: string;\n destination?: string;\n scope?: FindingSearchScope;\n}\nexport interface WorkflowState extends WorkflowBinding {\n id: string;\n stages: Record<\n WorkflowStage,\n {\n status: \"pending\" | \"running\" | \"failed\" | \"completed\";\n result?: unknown;\n error?: string;\n pendingWrite?: { groups: string[][] };\n }\n >;\n}\n\nexport function workflowDigest(value: unknown): string {\n const json = JSON.stringify(value, (_key, item: unknown) =>\n item !== null && typeof item === \"object\" && !Array.isArray(item)\n ? Object.fromEntries(\n Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n )\n : item,\n );\n return createHash(\"sha256\").update(json).digest(\"hex\");\n}\n\nexport function workflowDestination(url: string): string {\n const route = \"v1/bulk/findings\";\n const destination = new URL(route, url.endsWith(\"/\") ? url : `${url}/`);\n destination.username = \"\";\n destination.password = \"\";\n return destination.href.slice(0, -route.length);\n}\n\n/** State lives in the workbench database, never in sealed scan artifacts. */\nexport class FindingWorkflow {\n private options?: Promise<WorkbenchCommandOptions>;\n\n constructor(\n readonly id: string,\n private readonly environment: NodeJS.ProcessEnv = process.env,\n private readonly workbench: typeof runWorkbench = runWorkbench,\n private readonly pythonPath?: string,\n ) {\n if (!id.trim())\n throw new CodexSecurityError(\"workflowId must be a nonempty string.\");\n }\n\n async protectArtifacts(scanDir: string): Promise<void> {\n const path = relative(\n await canonicalizeModelSafePath(scanDir),\n await canonicalizeModelSafePath(\n codexSecurityStateDirectory(this.environment),\n ),\n );\n if (\n path === \"\" ||\n (!isAbsolute(path) && path !== \"..\" && !path.startsWith(`..${sep}`))\n ) {\n throw new CodexSecurityError(\n \"Workflow state must be outside the sealed scan artifacts.\",\n );\n }\n }\n\n async get(): Promise<WorkflowState | null> {\n return (await this.command({ action: \"get\" })) as WorkflowState | null;\n }\n\n async bind(binding: WorkflowBinding): Promise<WorkflowState> {\n return (await this.command({ action: \"bind\", binding }))!;\n }\n\n async begin(stage: WorkflowStage): Promise<WorkflowState> {\n return (await this.command({ action: \"begin\", stage }))!;\n }\n\n async complete(\n stage: WorkflowStage,\n result: unknown,\n ): Promise<WorkflowState> {\n return (await this.command({ action: \"complete\", stage, result }))!;\n }\n\n async fail(stage: WorkflowStage, error: unknown): Promise<void> {\n await this.command({\n action: \"fail\",\n stage,\n error: errorMessage(error),\n }).catch(() => undefined);\n }\n\n async run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T> {\n const state = await this.begin(stage);\n if (state.stages[stage].status === \"completed\")\n return state.stages[stage].result as T;\n try {\n const result = await operation();\n await this.complete(stage, result);\n return result;\n } catch (error) {\n await this.fail(stage, error);\n throw error;\n }\n }\n\n async registeredScan(scanId: string): Promise<JsonObject> {\n const context = await this.call([\"get-scan\", \"--scan-id\", scanId]);\n return context[\"scan\"] as JsonObject;\n }\n\n async sourceSnapshot(repository: string): Promise<JsonObject> {\n return (await this.request({ action: \"source\", repository }))[\n \"source\"\n ] as JsonObject;\n }\n\n async getReview(key: string): Promise<unknown> {\n return (await this.request({ action: \"get-review\", key }))[\"review\"];\n }\n\n async saveReview(\n key: string,\n binding: object,\n result: unknown,\n ): Promise<void> {\n await this.request({ action: \"save-review\", key, binding, result });\n }\n\n async prepareDedupe(\n result: unknown,\n pendingWrite: { groups: string[][] },\n ): Promise<void> {\n await this.command({\n action: \"prepare-dedupe\",\n stage: \"dedupe\",\n result,\n pendingWrite,\n });\n }\n\n private async command(payload: object): Promise<WorkflowState | null> {\n const result = await this.request(payload);\n return result[\"workflow\"] as unknown as WorkflowState | null;\n }\n\n private async request(payload: object): Promise<JsonObject> {\n return await this.call(\n [\"finding-workflow\"],\n JSON.stringify({ id: this.id, ...payload }),\n );\n }\n\n private async call(\n args: readonly string[],\n input?: string,\n ): Promise<JsonObject> {\n this.options ??= (async () => ({\n pluginRoot: await bundledPluginRoot(),\n python: await resolvePluginPython({\n environment: this.environment,\n configuredPath: this.pythonPath,\n }),\n environment: workbenchEnvironment(this.environment),\n failureMessage: \"Could not save or resume the findings workflow\",\n }))();\n return await this.workbench(await this.options, args, input);\n }\n}\n"]}
1
+ {"version":3,"file":"finding-workflow.js","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { isAbsolute, relative, sep } from \"node:path\";\nimport type { JsonObject } from \"./config.js\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { findingsBaseUrl } from \"./findings-client.js\";\nimport type { FindingSearchScope } from \"./finding-retrieval.js\";\nimport {\n bundledPluginRoot,\n canonicalizeModelSafePath,\n codexSecurityStateDirectory,\n workbenchEnvironment,\n resolvePluginPython,\n runWorkbench,\n type WorkbenchCommandOptions,\n} from \"./runtime.js\";\n\nexport type WorkflowStage = \"scan\" | \"publish\" | \"dedupe\";\nexport interface WorkflowBinding {\n repositoryPath?: string;\n scanRequestDigest?: string;\n scanId?: string;\n scanDir?: string;\n artifactDigest?: string;\n destination?: string;\n scope?: FindingSearchScope;\n}\nexport interface WorkflowState extends WorkflowBinding {\n id: string;\n stages: Record<\n WorkflowStage,\n {\n status: \"pending\" | \"running\" | \"failed\" | \"completed\";\n result?: unknown;\n error?: string;\n pendingWrite?: DedupePendingWrite;\n }\n >;\n}\n\nexport interface DedupePendingWrite {\n groups: string[][];\n local?: { inputDigest: string; source: JsonObject; gitDisabled?: boolean };\n}\n\nexport function workflowDigest(value: unknown): string {\n const json = JSON.stringify(value, (_key, item: unknown) =>\n item !== null && typeof item === \"object\" && !Array.isArray(item)\n ? Object.fromEntries(\n Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n )\n : item,\n );\n return createHash(\"sha256\").update(json).digest(\"hex\");\n}\n\nexport function workflowDestination(url: string): string {\n const destination = findingsBaseUrl(url);\n destination.username = \"\";\n destination.password = \"\";\n return destination.href;\n}\n\n/** State lives in the workbench database, never in sealed scan artifacts. */\nexport class FindingWorkflow {\n private options?: Promise<WorkbenchCommandOptions>;\n\n constructor(\n readonly id: string,\n private readonly environment: NodeJS.ProcessEnv = process.env,\n private readonly workbench: typeof runWorkbench = runWorkbench,\n private readonly pythonPath?: string,\n private readonly protectedRoot?: string,\n ) {\n if (!id.trim())\n throw new CodexSecurityError(\"workflowId must be a nonempty string.\");\n }\n\n async protectArtifacts(scanDir: string): Promise<void> {\n const path = relative(\n await canonicalizeModelSafePath(scanDir),\n await canonicalizeModelSafePath(\n codexSecurityStateDirectory(this.environment),\n ),\n );\n if (\n path === \"\" ||\n (!isAbsolute(path) && path !== \"..\" && !path.startsWith(`..${sep}`))\n ) {\n throw new CodexSecurityError(\n \"Workflow state must be outside the sealed scan artifacts.\",\n );\n }\n }\n\n async get(): Promise<WorkflowState | null> {\n return (await this.command({ action: \"get\" })) as WorkflowState | null;\n }\n\n async bind(binding: WorkflowBinding): Promise<WorkflowState> {\n return (await this.command({ action: \"bind\", binding }))!;\n }\n\n async begin(stage: WorkflowStage): Promise<WorkflowState> {\n return (await this.command({ action: \"begin\", stage }))!;\n }\n\n async complete(\n stage: WorkflowStage,\n result: unknown,\n ): Promise<WorkflowState> {\n return (await this.command({ action: \"complete\", stage, result }))!;\n }\n\n async fail(stage: WorkflowStage, error: unknown): Promise<void> {\n await this.command({\n action: \"fail\",\n stage,\n error: errorMessage(error),\n }).catch(() => undefined);\n }\n\n async run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T> {\n const state = await this.begin(stage);\n if (state.stages[stage].status === \"completed\")\n return state.stages[stage].result as T;\n try {\n const result = await operation();\n await this.complete(stage, result);\n return result;\n } catch (error) {\n await this.fail(stage, error);\n throw error;\n }\n }\n\n async registeredScan(scanId: string): Promise<JsonObject> {\n const context = await this.call([\"get-scan\", \"--scan-id\", scanId]);\n return context[\"scan\"] as JsonObject;\n }\n\n async sourceSnapshot(\n repository: string,\n gitDisabled = false,\n privateStatePaths: readonly string[] = [],\n ): Promise<JsonObject> {\n return (\n await this.request({\n action: \"source\",\n repository,\n ...(gitDisabled ? { gitDisabled } : {}),\n ...(privateStatePaths.length ? { privateStatePaths } : {}),\n })\n )[\"source\"] as JsonObject;\n }\n\n async getReview(key: string): Promise<unknown> {\n return (await this.request({ action: \"get-review\", key }))[\"review\"];\n }\n\n async saveReview(\n key: string,\n binding: object,\n result: unknown,\n ): Promise<void> {\n await this.request({ action: \"save-review\", key, binding, result });\n }\n\n async prepareDedupe(\n result: unknown,\n pendingWrite: DedupePendingWrite,\n ): Promise<void> {\n await this.command({\n action: \"prepare-dedupe\",\n stage: \"dedupe\",\n result,\n pendingWrite,\n });\n }\n\n private async command(payload: object): Promise<WorkflowState | null> {\n const result = await this.request(payload);\n return result[\"workflow\"] as unknown as WorkflowState | null;\n }\n\n private async request(payload: object): Promise<JsonObject> {\n return await this.call(\n [\"finding-workflow\"],\n JSON.stringify({ id: this.id, ...payload }),\n );\n }\n\n private async call(\n args: readonly string[],\n input?: string,\n ): Promise<JsonObject> {\n this.options ??= (async () => ({\n pluginRoot: await bundledPluginRoot(),\n python: await resolvePluginPython({\n environment: this.environment,\n configuredPath: this.pythonPath,\n protectedRoot: this.protectedRoot,\n }),\n environment: workbenchEnvironment(this.environment),\n failureMessage: \"Could not save or resume the findings workflow\",\n }))();\n return await this.workbench(await this.options, args, input);\n }\n}\n"]}
@@ -2,11 +2,12 @@ import { waitForRetry } from "./deduplication/retry.js";
2
2
  import type { Finding } from "./models.js";
3
3
  import type { FindingNeighborhood, FindingSearchScope } from "./finding-retrieval.js";
4
4
  export type FindingsRequest = (url: URL, init: RequestInit) => Promise<Response>;
5
+ export declare function findingsBaseUrl(value: string): URL;
5
6
  export declare class FindingsClient {
6
- private readonly url;
7
7
  private readonly signal?;
8
8
  private readonly request;
9
9
  private readonly retries;
10
+ private readonly url;
10
11
  constructor(url: string, signal?: AbortSignal | undefined, request?: FindingsRequest, retries?: {
11
12
  wait?: typeof waitForRetry;
12
13
  random?: () => number;
@@ -1 +1 @@
1
- {"version":3,"file":"findings-client.d.ts","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AAmBvB,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,YACmB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,YAAA,EACpB,OAAO,GAAE,eAAuB,EAChC,OAAO,GAAE;QACxB,IAAI,CAAC,EAAE,OAAO,YAAY,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;KAClB,EACJ;IAEE,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAuB9B;IAEK,OAAO,CACX,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;IAEK,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;YAEa,KAAK;IAsBnB,OAAO,CAAC,QAAQ;YAIF,IAAI;CAiBnB"}
1
+ {"version":3,"file":"findings-client.d.ts","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AA+CvB,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAMlD;AAED,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,YACE,GAAG,EAAE,MAAM,EACM,MAAM,CAAC,EAAE,WAAW,YAAA,EACpB,OAAO,GAAE,eAAuB,EAChC,OAAO,GAAE;QACxB,IAAI,CAAC,EAAE,OAAO,YAAY,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;KAClB,EAGP;IAEK,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAsB9B;IAEK,OAAO,CACX,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;IAEK,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;YAEa,KAAK;IAsBnB,OAAO,CAAC,QAAQ;YAIF,IAAI;CAgBnB"}
@@ -1,12 +1,33 @@
1
1
  import { CodexSecurityError } from "./errors.js";
2
+ import { parseFindingsErrorResponse, } from "./findings-errors.js";
2
3
  import { retryDelay, waitForRetry } from "./deduplication/retry.js";
3
4
  class FindingsHttpError extends CodexSecurityError {
4
5
  status;
5
6
  retryAfter;
6
- constructor(message, status, retryAfter) {
7
+ code;
8
+ constructor(message, status, retryAfter, code) {
7
9
  super(message);
8
10
  this.status = status;
9
11
  this.retryAfter = retryAfter;
12
+ this.code = code;
13
+ }
14
+ static async fromResponse(response, message, signal) {
15
+ // Service errors are JSON; other gateway bodies need not finish to report HTTP failure.
16
+ const mediaType = response.headers
17
+ .get("Content-Type")
18
+ ?.split(";", 1)[0]
19
+ ?.trim()
20
+ .toLowerCase();
21
+ let body;
22
+ if (mediaType === "application/json" || mediaType?.endsWith("+json")) {
23
+ body = await response.json().catch(() => undefined);
24
+ }
25
+ else {
26
+ void response.body?.cancel().catch(() => undefined);
27
+ }
28
+ signal?.throwIfAborted();
29
+ const error = parseFindingsErrorResponse(body);
30
+ return new FindingsHttpError(error?.message ? `${message} ${error.message}` : message, response.status, response.headers.get("Retry-After"), error?.error);
10
31
  }
11
32
  }
12
33
  function isRetryable(error) {
@@ -15,16 +36,24 @@ function isRetryable(error) {
15
36
  // Fetch rejects network failures with TypeError; JSON truncation can produce SyntaxError.
16
37
  return error instanceof TypeError || error instanceof SyntaxError;
17
38
  }
39
+ export function findingsBaseUrl(value) {
40
+ const url = new URL(value);
41
+ if (!url.pathname.endsWith("/"))
42
+ url.pathname += "/";
43
+ url.search = "";
44
+ url.hash = "";
45
+ return url;
46
+ }
18
47
  export class FindingsClient {
19
- url;
20
48
  signal;
21
49
  request;
22
50
  retries;
51
+ url;
23
52
  constructor(url, signal, request = fetch, retries = {}) {
24
- this.url = url;
25
53
  this.signal = signal;
26
54
  this.request = request;
27
55
  this.retries = retries;
56
+ this.url = findingsBaseUrl(url);
28
57
  }
29
58
  async potentialDuplicates(findingId, scope) {
30
59
  const url = this.endpoint(`v1/finding/${encodeURIComponent(findingId)}/potential-duplicates`);
@@ -35,10 +64,9 @@ export class FindingsClient {
35
64
  return await this.retry(async () => {
36
65
  const response = await this.request(url, { signal: this.signal });
37
66
  if (!response.ok) {
38
- await response.body?.cancel().catch(() => undefined);
39
- throw new FindingsHttpError(`Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${response.status === 404
67
+ throw await FindingsHttpError.fromResponse(response, `Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${response.status === 404
40
68
  ? " Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating."
41
- : ""}`, response.status, response.headers.get("Retry-After"));
69
+ : ""}`, this.signal);
42
70
  }
43
71
  return (await response.json());
44
72
  });
@@ -86,7 +114,7 @@ export class FindingsClient {
86
114
  }
87
115
  }
88
116
  endpoint(path) {
89
- return new URL(path, this.url.endsWith("/") ? this.url : `${this.url}/`);
117
+ return new URL(path, this.url);
90
118
  }
91
119
  async post(path, body) {
92
120
  const response = await this.request(this.endpoint(path), {
@@ -96,8 +124,7 @@ export class FindingsClient {
96
124
  signal: this.signal,
97
125
  });
98
126
  if (!response.ok) {
99
- await response.body?.cancel().catch(() => undefined);
100
- throw new FindingsHttpError(`Findings API POST /${path} failed (HTTP ${response.status}).`, response.status, response.headers.get("Retry-After"));
127
+ throw await FindingsHttpError.fromResponse(response, `Findings API POST /${path} failed (HTTP ${response.status}).`, this.signal);
101
128
  }
102
129
  return await response.json();
103
130
  }
@@ -1 +1 @@
1
- {"version":3,"file":"findings-client.js","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport { retryDelay, waitForRetry } from \"./deduplication/retry.js\";\nimport type { Finding } from \"./models.js\";\nimport type {\n FindingNeighborhood,\n FindingSearchScope,\n} from \"./finding-retrieval.js\";\n\nexport type FindingsRequest = (\n url: URL,\n init: RequestInit,\n) => Promise<Response>;\n\nclass FindingsHttpError extends CodexSecurityError {\n constructor(\n message: string,\n readonly status: number,\n readonly retryAfter: string | null,\n ) {\n super(message);\n }\n}\n\nfunction isRetryable(error: unknown): boolean {\n if (error instanceof FindingsHttpError)\n return [408, 429, 500, 502, 503, 504].includes(error.status);\n // Fetch rejects network failures with TypeError; JSON truncation can produce SyntaxError.\n return error instanceof TypeError || error instanceof SyntaxError;\n}\n\nexport class FindingsClient {\n constructor(\n private readonly url: string,\n private readonly signal?: AbortSignal,\n private readonly request: FindingsRequest = fetch,\n private readonly retries: {\n wait?: typeof waitForRetry;\n random?: () => number;\n } = {},\n ) {}\n\n async potentialDuplicates(\n findingId: string,\n scope: FindingSearchScope,\n ): Promise<FindingNeighborhood> {\n const url = this.endpoint(\n `v1/finding/${encodeURIComponent(findingId)}/potential-duplicates`,\n );\n if (scope.allRepositories === true)\n url.searchParams.set(\"allRepositories\", \"true\");\n else url.searchParams.set(\"repositoryId\", scope.repositoryId);\n return await this.retry(async () => {\n const response = await this.request(url, { signal: this.signal });\n if (!response.ok) {\n await response.body?.cancel().catch(() => undefined);\n throw new FindingsHttpError(\n `Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${\n response.status === 404\n ? \" Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating.\"\n : \"\"\n }`,\n response.status,\n response.headers.get(\"Retry-After\"),\n );\n }\n return (await response.json()) as FindingNeighborhood;\n });\n }\n\n async publish(\n findings: readonly Finding[],\n repositoryId: string,\n ): Promise<string[]> {\n const receipt = await this.post(\"v1/bulk/findings\", {\n findings,\n repositoryId,\n });\n const expected = new Set(findings.map((finding) => finding.findingId));\n if (\n !Array.isArray(receipt) ||\n receipt.length !== findings.length ||\n new Set(receipt).size !== expected.size ||\n receipt.some((id) => !expected.has(id))\n ) {\n throw new CodexSecurityError(\n \"The findings API did not acknowledge all published finding IDs. Check the service before retrying.\",\n );\n }\n return receipt as string[];\n }\n\n async storeDedupeGroups(groups: readonly string[][]): Promise<void> {\n if (groups.length === 0) return;\n await this.retry(() => this.post(\"v1/dedupe-groups\", { groups }));\n }\n\n private async retry<T>(operation: () => Promise<T>): Promise<T> {\n for (let attempt = 1; ; attempt++) {\n this.signal?.throwIfAborted();\n try {\n return await operation();\n } catch (error) {\n this.signal?.throwIfAborted();\n if (attempt === 3 || !isRetryable(error)) throw error;\n let delay = retryDelay(attempt, this.retries.random);\n if (error instanceof FindingsHttpError && error.retryAfter !== null) {\n const seconds = Number(error.retryAfter);\n const serverDelay = Number.isFinite(seconds)\n ? seconds * 1000\n : Date.parse(error.retryAfter) - Date.now();\n if (Number.isFinite(serverDelay))\n delay = Math.max(delay, serverDelay);\n }\n await (this.retries.wait ?? waitForRetry)(delay, this.signal);\n }\n }\n }\n\n private endpoint(path: string): URL {\n return new URL(path, this.url.endsWith(\"/\") ? this.url : `${this.url}/`);\n }\n\n private async post(path: string, body: unknown): Promise<unknown> {\n const response = await this.request(this.endpoint(path), {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(body),\n signal: this.signal,\n });\n if (!response.ok) {\n await response.body?.cancel().catch(() => undefined);\n throw new FindingsHttpError(\n `Findings API POST /${path} failed (HTTP ${response.status}).`,\n response.status,\n response.headers.get(\"Retry-After\"),\n );\n }\n return await response.json();\n }\n}\n"]}
1
+ {"version":3,"file":"findings-client.js","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport {\n parseFindingsErrorResponse,\n type FindingsErrorCode,\n} from \"./findings-errors.js\";\nimport { retryDelay, waitForRetry } from \"./deduplication/retry.js\";\nimport type { Finding } from \"./models.js\";\nimport type {\n FindingNeighborhood,\n FindingSearchScope,\n} from \"./finding-retrieval.js\";\n\nexport type FindingsRequest = (\n url: URL,\n init: RequestInit,\n) => Promise<Response>;\n\nclass FindingsHttpError extends CodexSecurityError {\n constructor(\n message: string,\n readonly status: number,\n readonly retryAfter: string | null,\n readonly code?: FindingsErrorCode,\n ) {\n super(message);\n }\n\n static async fromResponse(\n response: Response,\n message: string,\n signal?: AbortSignal,\n ): Promise<FindingsHttpError> {\n // Service errors are JSON; other gateway bodies need not finish to report HTTP failure.\n const mediaType = response.headers\n .get(\"Content-Type\")\n ?.split(\";\", 1)[0]\n ?.trim()\n .toLowerCase();\n let body: unknown;\n if (mediaType === \"application/json\" || mediaType?.endsWith(\"+json\")) {\n body = await response.json().catch(() => undefined);\n } else {\n void response.body?.cancel().catch(() => undefined);\n }\n signal?.throwIfAborted();\n const error = parseFindingsErrorResponse(body);\n return new FindingsHttpError(\n error?.message ? `${message} ${error.message}` : message,\n response.status,\n response.headers.get(\"Retry-After\"),\n error?.error,\n );\n }\n}\n\nfunction isRetryable(error: unknown): boolean {\n if (error instanceof FindingsHttpError)\n return [408, 429, 500, 502, 503, 504].includes(error.status);\n // Fetch rejects network failures with TypeError; JSON truncation can produce SyntaxError.\n return error instanceof TypeError || error instanceof SyntaxError;\n}\n\nexport function findingsBaseUrl(value: string): URL {\n const url = new URL(value);\n if (!url.pathname.endsWith(\"/\")) url.pathname += \"/\";\n url.search = \"\";\n url.hash = \"\";\n return url;\n}\n\nexport class FindingsClient {\n private readonly url: URL;\n constructor(\n url: string,\n private readonly signal?: AbortSignal,\n private readonly request: FindingsRequest = fetch,\n private readonly retries: {\n wait?: typeof waitForRetry;\n random?: () => number;\n } = {},\n ) {\n this.url = findingsBaseUrl(url);\n }\n\n async potentialDuplicates(\n findingId: string,\n scope: FindingSearchScope,\n ): Promise<FindingNeighborhood> {\n const url = this.endpoint(\n `v1/finding/${encodeURIComponent(findingId)}/potential-duplicates`,\n );\n if (scope.allRepositories === true)\n url.searchParams.set(\"allRepositories\", \"true\");\n else url.searchParams.set(\"repositoryId\", scope.repositoryId);\n return await this.retry(async () => {\n const response = await this.request(url, { signal: this.signal });\n if (!response.ok) {\n throw await FindingsHttpError.fromResponse(\n response,\n `Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${\n response.status === 404\n ? \" Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating.\"\n : \"\"\n }`,\n this.signal,\n );\n }\n return (await response.json()) as FindingNeighborhood;\n });\n }\n\n async publish(\n findings: readonly Finding[],\n repositoryId: string,\n ): Promise<string[]> {\n const receipt = await this.post(\"v1/bulk/findings\", {\n findings,\n repositoryId,\n });\n const expected = new Set(findings.map((finding) => finding.findingId));\n if (\n !Array.isArray(receipt) ||\n receipt.length !== findings.length ||\n new Set(receipt).size !== expected.size ||\n receipt.some((id) => !expected.has(id))\n ) {\n throw new CodexSecurityError(\n \"The findings API did not acknowledge all published finding IDs. Check the service before retrying.\",\n );\n }\n return receipt as string[];\n }\n\n async storeDedupeGroups(groups: readonly string[][]): Promise<void> {\n if (groups.length === 0) return;\n await this.retry(() => this.post(\"v1/dedupe-groups\", { groups }));\n }\n\n private async retry<T>(operation: () => Promise<T>): Promise<T> {\n for (let attempt = 1; ; attempt++) {\n this.signal?.throwIfAborted();\n try {\n return await operation();\n } catch (error) {\n this.signal?.throwIfAborted();\n if (attempt === 3 || !isRetryable(error)) throw error;\n let delay = retryDelay(attempt, this.retries.random);\n if (error instanceof FindingsHttpError && error.retryAfter !== null) {\n const seconds = Number(error.retryAfter);\n const serverDelay = Number.isFinite(seconds)\n ? seconds * 1000\n : Date.parse(error.retryAfter) - Date.now();\n if (Number.isFinite(serverDelay))\n delay = Math.max(delay, serverDelay);\n }\n await (this.retries.wait ?? waitForRetry)(delay, this.signal);\n }\n }\n }\n\n private endpoint(path: string): URL {\n return new URL(path, this.url);\n }\n\n private async post(path: string, body: unknown): Promise<unknown> {\n const response = await this.request(this.endpoint(path), {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(body),\n signal: this.signal,\n });\n if (!response.ok) {\n throw await FindingsHttpError.fromResponse(\n response,\n `Findings API POST /${path} failed (HTTP ${response.status}).`,\n this.signal,\n );\n }\n return await response.json();\n }\n}\n"]}
@@ -0,0 +1,16 @@
1
+ export declare const FINDINGS_ERROR_STATUS: {
2
+ readonly invalid_request: 400;
3
+ readonly finding_conflict: 409;
4
+ readonly embedding_unavailable: 503;
5
+ readonly embedding_failed: 502;
6
+ readonly finding_not_indexed: 404;
7
+ readonly not_found: 404;
8
+ readonly internal_error: 500;
9
+ };
10
+ export type FindingsErrorCode = keyof typeof FINDINGS_ERROR_STATUS;
11
+ export interface FindingsErrorResponse {
12
+ error: FindingsErrorCode;
13
+ message?: string;
14
+ }
15
+ export declare function parseFindingsErrorResponse(value: unknown): FindingsErrorResponse | undefined;
16
+ //# sourceMappingURL=findings-errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"findings-errors.d.ts","sourceRoot":"","sources":["../src/findings-errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;aAChC,eAAe,EAAE,GAAG;aACpB,gBAAgB,EAAE,GAAG;aACrB,qBAAqB,EAAE,GAAG;aAC1B,gBAAgB,EAAE,GAAG;aACrB,mBAAmB,EAAE,GAAG;aACxB,SAAS,EAAE,GAAG;aACd,cAAc,EAAE,GAAG;CACX,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,qBAAqB,GAAG,SAAS,CAenC"}
@@ -0,0 +1,24 @@
1
+ export const FINDINGS_ERROR_STATUS = {
2
+ invalid_request: 400,
3
+ finding_conflict: 409,
4
+ embedding_unavailable: 503,
5
+ embedding_failed: 502,
6
+ finding_not_indexed: 404,
7
+ not_found: 404,
8
+ internal_error: 500,
9
+ };
10
+ export function parseFindingsErrorResponse(value) {
11
+ if (typeof value !== "object" ||
12
+ value === null ||
13
+ !("error" in value) ||
14
+ typeof value.error !== "string" ||
15
+ !Object.hasOwn(FINDINGS_ERROR_STATUS, value.error) ||
16
+ ("message" in value && typeof value.message !== "string")) {
17
+ return undefined;
18
+ }
19
+ return {
20
+ error: value.error,
21
+ ...("message" in value ? { message: value.message } : {}),
22
+ };
23
+ }
24
+ //# sourceMappingURL=findings-errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"findings-errors.js","sourceRoot":"","sources":["../src/findings-errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,GAAG;IACrB,qBAAqB,EAAE,GAAG;IAC1B,gBAAgB,EAAE,GAAG;IACrB,mBAAmB,EAAE,GAAG;IACxB,SAAS,EAAE,GAAG;IACd,cAAc,EAAE,GAAG;CACX,CAAC;AASX,MAAM,UAAU,0BAA0B,CACxC,KAAc;IAEd,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC;QACnB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC;QAClD,CAAC,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,EACzD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAA0B;QACvC,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC","sourcesContent":["export const FINDINGS_ERROR_STATUS = {\n invalid_request: 400,\n finding_conflict: 409,\n embedding_unavailable: 503,\n embedding_failed: 502,\n finding_not_indexed: 404,\n not_found: 404,\n internal_error: 500,\n} as const;\n\nexport type FindingsErrorCode = keyof typeof FINDINGS_ERROR_STATUS;\n\nexport interface FindingsErrorResponse {\n error: FindingsErrorCode;\n message?: string;\n}\n\nexport function parseFindingsErrorResponse(\n value: unknown,\n): FindingsErrorResponse | undefined {\n if (\n typeof value !== \"object\" ||\n value === null ||\n !(\"error\" in value) ||\n typeof value.error !== \"string\" ||\n !Object.hasOwn(FINDINGS_ERROR_STATUS, value.error) ||\n (\"message\" in value && typeof value.message !== \"string\")\n ) {\n return undefined;\n }\n return {\n error: value.error as FindingsErrorCode,\n ...(\"message\" in value ? { message: value.message as string } : {}),\n };\n}\n"]}
@@ -39,6 +39,6 @@ type CsvFindingRow = z.infer<typeof csvFindingRowSchema>;
39
39
  export declare function parseImportedFindings(source: string, format: FindingsImportFormat, pluginRoot: string): Promise<Finding[]>;
40
40
  export declare function bindImportedFindings(findings: Finding[], format: FindingsImportFormat, scanId: string, targetId: string): Finding[];
41
41
  export declare function parseFindingsCsv(source: string): CsvFindingRow[];
42
- export declare function csvRowFinding(row: CsvFindingRow, scanId: string): Finding;
42
+ export declare function csvRowFinding(row: CsvFindingRow): Finding;
43
43
  export {};
44
44
  //# sourceMappingURL=findings-import.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"findings-import.d.ts","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,aAAa,CAAC;AAE7D,eAAO,MAAM,aAAa,8BAA8B,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,CAAC;AAKlD,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkFrB,CAAC;AACL,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAOzD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,EAAE,CAAC,CA6DpB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,EAAE,CAuCX;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAsDhE;AAMD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAsDzE"}
1
+ {"version":3,"file":"findings-import.d.ts","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,aAAa,CAAC;AAE7D,eAAO,MAAM,aAAa,8BAA8B,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,CAAC;AAKlD,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkFrB,CAAC;AACL,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAOzD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,EAAE,CAAC,CAsDpB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,EAAE,CA6BX;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAiDhE;AAMD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAmDzD"}
@@ -1,10 +1,11 @@
1
- import { sha256Text as sha256 } from "./contract.js";
1
+ import { isRecord } from "./record.js";
2
+ import { deriveFindingIdentity, sha256Text as sha256 } from "./contract.js";
2
3
  import { readFile } from "node:fs/promises";
3
4
  import { isAbsolute, join, posix } from "node:path";
4
5
  import Ajv2020 from "ajv/dist/2020.js";
5
6
  import { z } from "incur";
6
7
  import Papa from "papaparse";
7
- import { CodexSecurityError } from "./errors.js";
8
+ import { CodexSecurityError, errorMessage } from "./errors.js";
8
9
  export const CSV_TARGET_ID = "codex-security-csv-import";
9
10
  // Match the Python exporter's str.lstrip(), including its extra C0 separators.
10
11
  const EXPORTED_CSV_ESCAPE = /^'(?:['\t\r\n]|[\p{White_Space}\u001c-\u001f]*[=+\-@=+-@])/u;
@@ -86,11 +87,7 @@ const CSV_COLUMNS = Object.keys(csvFindingRowSchema.shape);
86
87
  const REQUIRED_CSV_COLUMNS = CSV_COLUMNS.filter((column) => !csvFindingRowSchema.shape[column].isOptional());
87
88
  export async function parseImportedFindings(source, format, pluginRoot) {
88
89
  if (format === "csv") {
89
- return parseFindingsCsv(source).map((row) => ({
90
- ...csvRowFinding(row, "import"),
91
- findingId: row.finding_id,
92
- occurrenceId: row.occurrence_id,
93
- }));
90
+ return parseFindingsCsv(source).map(csvRowFinding);
94
91
  }
95
92
  let payload;
96
93
  try {
@@ -99,13 +96,9 @@ export async function parseImportedFindings(source, format, pluginRoot) {
99
96
  payload = JSON.parse(source.replace(/^\uFEFF/u, ""));
100
97
  }
101
98
  catch (error) {
102
- throw new CodexSecurityError("Findings JSON could not be parsed.", {
103
- cause: error,
104
- });
99
+ throw new CodexSecurityError(`Findings JSON could not be parsed. ${errorMessage(error)}`, { cause: error });
105
100
  }
106
- if (payload === null ||
107
- typeof payload !== "object" ||
108
- Array.isArray(payload)) {
101
+ if (!isRecord(payload)) {
109
102
  throw new CodexSecurityError("Findings JSON must contain a findings document or an object with a findings array.");
110
103
  }
111
104
  const hasDocumentMetadata = ["documentType", "schemaVersion", "scanId"].some((key) => Object.hasOwn(payload, key));
@@ -134,22 +127,14 @@ export async function parseImportedFindings(source, format, pluginRoot) {
134
127
  }
135
128
  export function bindImportedFindings(findings, format, scanId, targetId) {
136
129
  return findings.map((finding) => {
137
- const ruleId = `import.${format}`;
138
- const anchor = finding.occurrenceId;
139
- const fingerprint = `codex-security/v1:sha256:${sha256(["codex-security/v1", targetId, ruleId, anchor, ""].join("\0"))}`;
140
130
  // A source report path names another scan's artifact. Preserve it as
141
131
  // provenance without treating the imported path as permission to read it.
142
132
  const { writeup, ...content } = finding;
143
133
  return {
144
134
  ...content,
145
- findingId: `csf_${sha256(fingerprint).slice(0, 24)}`,
146
- occurrenceId: `occ_${sha256([scanId, fingerprint].join("\0")).slice(0, 24)}`,
147
- ruleId,
148
- identity: { anchor },
149
- fingerprints: {
150
- algorithm: "codex-security/v1",
151
- primary: fingerprint,
152
- },
135
+ ...deriveFindingIdentity(scanId, targetId, `import.${format}`, {
136
+ anchor: finding.occurrenceId,
137
+ }),
153
138
  provenance: { source: `${format}_import` },
154
139
  extensions: {
155
140
  ...finding.extensions,
@@ -192,9 +177,6 @@ export function parseFindingsCsv(source) {
192
177
  new Set(headers).size !== headers.length) {
193
178
  throw new CodexSecurityError(`Findings CSV must use the Codex Security export columns: ${REQUIRED_CSV_COLUMNS.join(", ")} (candidate_id is optional).`);
194
179
  }
195
- if (rows.length === 0) {
196
- throw new CodexSecurityError("Findings CSV must contain at least one finding.");
197
- }
198
180
  const occurrenceIds = new Set();
199
181
  return rows.map((record, index) => {
200
182
  const rowNumber = index + 2;
@@ -213,13 +195,13 @@ export function parseFindingsCsv(source) {
213
195
  function decodeExportedCsvCell(value) {
214
196
  return EXPORTED_CSV_ESCAPE.test(value) ? value.slice(1) : value;
215
197
  }
216
- export function csvRowFinding(row, scanId) {
198
+ export function csvRowFinding(row) {
217
199
  const ruleId = "import.csv";
218
200
  const anchor = row.occurrence_id;
219
201
  const fingerprint = `codex-security/v1:sha256:${sha256(["codex-security/v1", CSV_TARGET_ID, ruleId, anchor, ""].join("\0"))}`;
220
202
  return {
221
- findingId: `csf_${sha256(fingerprint).slice(0, 24)}`,
222
- occurrenceId: `occ_${sha256([scanId, fingerprint].join("\0")).slice(0, 24)}`,
203
+ findingId: row.finding_id,
204
+ occurrenceId: row.occurrence_id,
223
205
  ruleId,
224
206
  identity: { anchor },
225
207
  fingerprints: {
@@ -1 +1 @@
1
- {"version":3,"file":"findings-import.js","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"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","sourcesContent":["import { sha256Text as sha256 } from \"./contract.js\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, posix } from \"node:path\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport { z } from \"incur\";\nimport Papa from \"papaparse\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport type { Finding, FindingsDocument } from \"./models.js\";\n\nexport const CSV_TARGET_ID = \"codex-security-csv-import\";\nexport type FindingsImportFormat = \"csv\" | \"json\";\n\n// Match the Python exporter's str.lstrip(), including its extra C0 separators.\nconst EXPORTED_CSV_ESCAPE =\n /^'(?:['\\t\\r\\n]|[\\p{White_Space}\\u001c-\\u001f]*[=+\\-@=+-@])/u;\nconst csvFindingRowSchema = z\n .object({\n occurrence_id: z.string().regex(/^occ_[a-f0-9]{24}$/u, {\n error: \"has an invalid occurrence_id\",\n }),\n finding_id: z.string().regex(/^csf_[a-f0-9]{24}$/u, {\n error: \"has an invalid finding_id\",\n }),\n candidate_id: z\n .string()\n .optional()\n .transform((value) =>\n value === undefined || value.trim() === \"\" ? undefined : value,\n ),\n title: requiredCsvText(\"title\"),\n summary: requiredCsvText(\"summary\"),\n severity: z.enum([\"critical\", \"high\", \"medium\", \"low\", \"informational\"], {\n error: \"has an invalid severity\",\n }),\n confidence: z.enum([\"high\", \"medium\", \"low\"], {\n error: \"has an invalid confidence\",\n }),\n status: z.enum([\"open\", \"closed\"], {\n error: \"has an invalid status\",\n }),\n close_reason: z\n .union(\n [\n z.literal(\"\"),\n z.enum([\"already_fixed\", \"wont_fix\", \"false_positive\"]),\n ],\n { error: \"has an invalid close_reason\" },\n )\n .transform((value) => (value === \"\" ? undefined : value)),\n note: z\n .string()\n .transform((value) => (value.trim() === \"\" ? undefined : value)),\n remediation: requiredCsvText(\"remediation\"),\n path: z.string().refine(safeFindingPath, {\n error: \"has an invalid path\",\n }),\n start_line: z\n .string()\n .refine(validCsvLine, { error: \"has an invalid start_line\" })\n .transform(Number),\n end_line: z\n .string()\n .refine((value) => value === \"\" || validCsvLine(value), {\n error: \"has an invalid end_line\",\n })\n .transform((value) => (value === \"\" ? undefined : Number(value))),\n })\n .superRefine((row, context) => {\n if (\n (row.status === \"open\" && row.close_reason !== undefined) ||\n (row.status === \"closed\" && row.close_reason === undefined)\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"close_reason\"],\n message: \"has an invalid close_reason\",\n });\n }\n if (\n row.status === \"closed\" &&\n (row.close_reason === \"false_positive\" ||\n row.close_reason === \"wont_fix\") &&\n row.note === undefined\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"note\"],\n message: \"requires a note for its close_reason\",\n });\n }\n if (row.end_line !== undefined && row.end_line < row.start_line) {\n context.addIssue({\n code: \"custom\",\n path: [\"end_line\"],\n message: \"has end_line before start_line\",\n });\n }\n });\ntype CsvFindingRow = z.infer<typeof csvFindingRowSchema>;\ntype CsvColumn = keyof typeof csvFindingRowSchema.shape;\nconst CSV_COLUMNS = Object.keys(csvFindingRowSchema.shape) as CsvColumn[];\nconst REQUIRED_CSV_COLUMNS = CSV_COLUMNS.filter(\n (column) => !csvFindingRowSchema.shape[column].isOptional(),\n);\n\nexport async function parseImportedFindings(\n source: string,\n format: FindingsImportFormat,\n pluginRoot: string,\n): Promise<Finding[]> {\n if (format === \"csv\") {\n return parseFindingsCsv(source).map((row) => ({\n ...csvRowFinding(row, \"import\"),\n findingId: row.finding_id,\n occurrenceId: row.occurrence_id,\n }));\n }\n\n let payload: unknown;\n try {\n // Exported findings files often start with a UTF-8 byte order mark, which\n // the CSV parser already skips.\n payload = JSON.parse(source.replace(/^\\uFEFF/u, \"\"));\n } catch (error) {\n throw new CodexSecurityError(\"Findings JSON could not be parsed.\", {\n cause: error,\n });\n }\n if (\n payload === null ||\n typeof payload !== \"object\" ||\n Array.isArray(payload)\n ) {\n throw new CodexSecurityError(\n \"Findings JSON must contain a findings document or an object with a findings array.\",\n );\n }\n const hasDocumentMetadata = [\"documentType\", \"schemaVersion\", \"scanId\"].some(\n (key) => Object.hasOwn(payload, key),\n );\n const document = hasDocumentMetadata\n ? payload\n : {\n documentType: \"codex-security.findings\",\n schemaVersion: \"1.0\",\n scanId: \"import\",\n ...payload,\n };\n const schema = JSON.parse(\n await readFile(join(pluginRoot, \"schemas\", \"findings.schema.json\"), \"utf8\"),\n );\n const validate = new Ajv2020({ strict: false }).compile<FindingsDocument>(\n schema,\n );\n if (!validate(document)) {\n const error = validate.errors?.[0];\n throw new CodexSecurityError(\n `Findings JSON does not match the Codex Security findings schema${error ? ` at ${error.instancePath || \"/\"}: ${error.message}` : \"\"}.`,\n );\n }\n const occurrenceIds = new Set<string>();\n for (const [index, finding] of document.findings.entries()) {\n if (occurrenceIds.has(finding.occurrenceId)) {\n throw new CodexSecurityError(\n `Findings JSON finding ${index + 1} has a duplicate occurrenceId.`,\n );\n }\n occurrenceIds.add(finding.occurrenceId);\n }\n return document.findings;\n}\n\nexport function bindImportedFindings(\n findings: Finding[],\n format: FindingsImportFormat,\n scanId: string,\n targetId: string,\n): Finding[] {\n return findings.map((finding) => {\n const ruleId = `import.${format}`;\n const anchor = finding.occurrenceId;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", targetId, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n // A source report path names another scan's artifact. Preserve it as\n // provenance without treating the imported path as permission to read it.\n const { writeup, ...content } = finding;\n return {\n ...content,\n findingId: `csf_${sha256(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256([scanId, fingerprint].join(\"\\0\")).slice(0, 24)}`,\n ruleId,\n identity: { anchor },\n fingerprints: {\n algorithm: \"codex-security/v1\",\n primary: fingerprint,\n },\n provenance: { source: `${format}_import` },\n extensions: {\n ...finding.extensions,\n import: {\n format,\n sourceFindingId: finding.findingId,\n sourceOccurrenceId: finding.occurrenceId,\n sourceRuleId: finding.ruleId,\n sourceIdentity: finding.identity,\n sourceFingerprints: finding.fingerprints,\n sourceProvenance: finding.provenance,\n ...(writeup === undefined ? {} : { sourceWriteup: writeup }),\n ...(finding.extensions?.[\"import\"] === undefined\n ? {}\n : { previousImport: finding.extensions[\"import\"] }),\n },\n },\n };\n });\n}\n\nexport function parseFindingsCsv(source: string): CsvFindingRow[] {\n const {\n data: rows,\n errors,\n meta,\n } = Papa.parse<Record<string, string>>(source, {\n header: true,\n delimiter: \",\",\n skipEmptyLines: \"greedy\",\n transform: decodeExportedCsvCell,\n });\n const fieldMismatch = errors.find(\n (error) => error.code === \"TooFewFields\" || error.code === \"TooManyFields\",\n );\n if (fieldMismatch?.row !== undefined) {\n throw csvRowError(fieldMismatch.row + 2, \"must match the header columns\");\n }\n if (errors.length > 0) {\n throw new CodexSecurityError(\n `Findings CSV could not be parsed: ${errors[0]!.message}`,\n );\n }\n const headers = meta.fields;\n const allowed = new Set<string>(CSV_COLUMNS);\n if (\n headers === undefined ||\n !REQUIRED_CSV_COLUMNS.every((name) => headers.includes(name)) ||\n headers.some((name) => !allowed.has(name)) ||\n new Set(headers).size !== headers.length\n ) {\n throw new CodexSecurityError(\n `Findings CSV must use the Codex Security export columns: ${REQUIRED_CSV_COLUMNS.join(\", \")} (candidate_id is optional).`,\n );\n }\n if (rows.length === 0) {\n throw new CodexSecurityError(\n \"Findings CSV must contain at least one finding.\",\n );\n }\n\n const occurrenceIds = new Set<string>();\n return rows.map((record, index) => {\n const rowNumber = index + 2;\n const parsed = csvFindingRowSchema.safeParse(record);\n if (!parsed.success) {\n throw csvRowError(rowNumber, parsed.error.issues[0]!.message);\n }\n const row = parsed.data;\n if (occurrenceIds.has(row.occurrence_id)) {\n throw csvRowError(rowNumber, \"has a duplicate occurrence_id\");\n }\n occurrenceIds.add(row.occurrence_id);\n return row;\n });\n}\n\nfunction decodeExportedCsvCell(value: string): string {\n return EXPORTED_CSV_ESCAPE.test(value) ? value.slice(1) : value;\n}\n\nexport function csvRowFinding(row: CsvFindingRow, scanId: string): Finding {\n const ruleId = \"import.csv\";\n const anchor = row.occurrence_id;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", CSV_TARGET_ID, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n return {\n findingId: `csf_${sha256(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256([scanId, fingerprint].join(\"\\0\")).slice(\n 0,\n 24,\n )}`,\n ruleId,\n identity: { anchor },\n fingerprints: {\n algorithm: \"codex-security/v1\",\n primary: fingerprint,\n },\n title: row.title,\n summary: row.summary,\n severity: { level: row.severity },\n confidence: {\n level: row.confidence,\n rationale: \"Imported from a Codex Security findings CSV.\",\n },\n taxonomy: { category: \"imported\", cwe: [] },\n locations: [\n {\n path: row.path,\n startLine: row.start_line,\n ...(row.end_line === undefined ? {} : { endLine: row.end_line }),\n },\n ],\n remediation: row.remediation,\n validation: {\n method: \"Source-reported CSV import metadata\",\n status: row.status,\n summary: [\n `Source finding ID: ${row.finding_id}`,\n `Source occurrence ID: ${row.occurrence_id}`,\n `Source status: ${row.status}`,\n ...(row.close_reason === undefined\n ? []\n : [`Source close reason: ${row.close_reason}`]),\n ...(row.note === undefined ? [] : [`Source note: ${row.note}`]),\n ].join(\"\\n\"),\n },\n provenance: { source: \"csv_import\" },\n extensions: {\n ...(row.candidate_id === undefined\n ? {}\n : { candidateId: row.candidate_id }),\n },\n };\n}\n\nfunction requiredCsvText(column: string) {\n return z.string().refine((value) => value.trim().length > 0, {\n error: `requires ${column}`,\n });\n}\n\nfunction validCsvLine(value: string): boolean {\n if (!/^[1-9]\\d*$/u.test(value)) return false;\n return Number.isSafeInteger(Number(value));\n}\n\nfunction safeFindingPath(value: string): boolean {\n if (\n value.trim().length === 0 ||\n value === \".\" ||\n isAbsolute(value) ||\n /^[A-Za-z]:/u.test(value) ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001F]/u.test(value) ||\n value.split(\"/\").includes(\"..\")\n ) {\n return false;\n }\n const normalized = posix.normalize(value).replace(/\\/+$/u, \"\");\n return normalized !== \".\" && !normalized.startsWith(\"../\");\n}\n\nfunction csvRowError(rowNumber: number, detail: string): CodexSecurityError {\n return new CodexSecurityError(`Findings CSV row ${rowNumber} ${detail}.`);\n}\n"]}
1
+ {"version":3,"file":"findings-import.js","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRecord } from \"./record.js\";\nimport { deriveFindingIdentity, sha256Text as sha256 } from \"./contract.js\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, posix } from \"node:path\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport { z } from \"incur\";\nimport Papa from \"papaparse\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport type { Finding, FindingsDocument } from \"./models.js\";\n\nexport const CSV_TARGET_ID = \"codex-security-csv-import\";\nexport type FindingsImportFormat = \"csv\" | \"json\";\n\n// Match the Python exporter's str.lstrip(), including its extra C0 separators.\nconst EXPORTED_CSV_ESCAPE =\n /^'(?:['\\t\\r\\n]|[\\p{White_Space}\\u001c-\\u001f]*[=+\\-@=+-@])/u;\nconst csvFindingRowSchema = z\n .object({\n occurrence_id: z.string().regex(/^occ_[a-f0-9]{24}$/u, {\n error: \"has an invalid occurrence_id\",\n }),\n finding_id: z.string().regex(/^csf_[a-f0-9]{24}$/u, {\n error: \"has an invalid finding_id\",\n }),\n candidate_id: z\n .string()\n .optional()\n .transform((value) =>\n value === undefined || value.trim() === \"\" ? undefined : value,\n ),\n title: requiredCsvText(\"title\"),\n summary: requiredCsvText(\"summary\"),\n severity: z.enum([\"critical\", \"high\", \"medium\", \"low\", \"informational\"], {\n error: \"has an invalid severity\",\n }),\n confidence: z.enum([\"high\", \"medium\", \"low\"], {\n error: \"has an invalid confidence\",\n }),\n status: z.enum([\"open\", \"closed\"], {\n error: \"has an invalid status\",\n }),\n close_reason: z\n .union(\n [\n z.literal(\"\"),\n z.enum([\"already_fixed\", \"wont_fix\", \"false_positive\"]),\n ],\n { error: \"has an invalid close_reason\" },\n )\n .transform((value) => (value === \"\" ? undefined : value)),\n note: z\n .string()\n .transform((value) => (value.trim() === \"\" ? undefined : value)),\n remediation: requiredCsvText(\"remediation\"),\n path: z.string().refine(safeFindingPath, {\n error: \"has an invalid path\",\n }),\n start_line: z\n .string()\n .refine(validCsvLine, { error: \"has an invalid start_line\" })\n .transform(Number),\n end_line: z\n .string()\n .refine((value) => value === \"\" || validCsvLine(value), {\n error: \"has an invalid end_line\",\n })\n .transform((value) => (value === \"\" ? undefined : Number(value))),\n })\n .superRefine((row, context) => {\n if (\n (row.status === \"open\" && row.close_reason !== undefined) ||\n (row.status === \"closed\" && row.close_reason === undefined)\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"close_reason\"],\n message: \"has an invalid close_reason\",\n });\n }\n if (\n row.status === \"closed\" &&\n (row.close_reason === \"false_positive\" ||\n row.close_reason === \"wont_fix\") &&\n row.note === undefined\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"note\"],\n message: \"requires a note for its close_reason\",\n });\n }\n if (row.end_line !== undefined && row.end_line < row.start_line) {\n context.addIssue({\n code: \"custom\",\n path: [\"end_line\"],\n message: \"has end_line before start_line\",\n });\n }\n });\ntype CsvFindingRow = z.infer<typeof csvFindingRowSchema>;\ntype CsvColumn = keyof typeof csvFindingRowSchema.shape;\nconst CSV_COLUMNS = Object.keys(csvFindingRowSchema.shape) as CsvColumn[];\nconst REQUIRED_CSV_COLUMNS = CSV_COLUMNS.filter(\n (column) => !csvFindingRowSchema.shape[column].isOptional(),\n);\n\nexport async function parseImportedFindings(\n source: string,\n format: FindingsImportFormat,\n pluginRoot: string,\n): Promise<Finding[]> {\n if (format === \"csv\") {\n return parseFindingsCsv(source).map(csvRowFinding);\n }\n\n let payload: unknown;\n try {\n // Exported findings files often start with a UTF-8 byte order mark, which\n // the CSV parser already skips.\n payload = JSON.parse(source.replace(/^\\uFEFF/u, \"\"));\n } catch (error) {\n throw new CodexSecurityError(\n `Findings JSON could not be parsed. ${errorMessage(error)}`,\n { cause: error },\n );\n }\n if (!isRecord(payload)) {\n throw new CodexSecurityError(\n \"Findings JSON must contain a findings document or an object with a findings array.\",\n );\n }\n const hasDocumentMetadata = [\"documentType\", \"schemaVersion\", \"scanId\"].some(\n (key) => Object.hasOwn(payload, key),\n );\n const document = hasDocumentMetadata\n ? payload\n : {\n documentType: \"codex-security.findings\",\n schemaVersion: \"1.0\",\n scanId: \"import\",\n ...payload,\n };\n const schema = JSON.parse(\n await readFile(join(pluginRoot, \"schemas\", \"findings.schema.json\"), \"utf8\"),\n );\n const validate = new Ajv2020({ strict: false }).compile<FindingsDocument>(\n schema,\n );\n if (!validate(document)) {\n const error = validate.errors?.[0];\n throw new CodexSecurityError(\n `Findings JSON does not match the Codex Security findings schema${error ? ` at ${error.instancePath || \"/\"}: ${error.message}` : \"\"}.`,\n );\n }\n const occurrenceIds = new Set<string>();\n for (const [index, finding] of document.findings.entries()) {\n if (occurrenceIds.has(finding.occurrenceId)) {\n throw new CodexSecurityError(\n `Findings JSON finding ${index + 1} has a duplicate occurrenceId.`,\n );\n }\n occurrenceIds.add(finding.occurrenceId);\n }\n return document.findings;\n}\n\nexport function bindImportedFindings(\n findings: Finding[],\n format: FindingsImportFormat,\n scanId: string,\n targetId: string,\n): Finding[] {\n return findings.map((finding) => {\n // A source report path names another scan's artifact. Preserve it as\n // provenance without treating the imported path as permission to read it.\n const { writeup, ...content } = finding;\n return {\n ...content,\n ...deriveFindingIdentity(scanId, targetId, `import.${format}`, {\n anchor: finding.occurrenceId,\n }),\n provenance: { source: `${format}_import` },\n extensions: {\n ...finding.extensions,\n import: {\n format,\n sourceFindingId: finding.findingId,\n sourceOccurrenceId: finding.occurrenceId,\n sourceRuleId: finding.ruleId,\n sourceIdentity: finding.identity,\n sourceFingerprints: finding.fingerprints,\n sourceProvenance: finding.provenance,\n ...(writeup === undefined ? {} : { sourceWriteup: writeup }),\n ...(finding.extensions?.[\"import\"] === undefined\n ? {}\n : { previousImport: finding.extensions[\"import\"] }),\n },\n },\n };\n });\n}\n\nexport function parseFindingsCsv(source: string): CsvFindingRow[] {\n const {\n data: rows,\n errors,\n meta,\n } = Papa.parse<Record<string, string>>(source, {\n header: true,\n delimiter: \",\",\n skipEmptyLines: \"greedy\",\n transform: decodeExportedCsvCell,\n });\n const fieldMismatch = errors.find(\n (error) => error.code === \"TooFewFields\" || error.code === \"TooManyFields\",\n );\n if (fieldMismatch?.row !== undefined) {\n throw csvRowError(fieldMismatch.row + 2, \"must match the header columns\");\n }\n if (errors.length > 0) {\n throw new CodexSecurityError(\n `Findings CSV could not be parsed: ${errors[0]!.message}`,\n );\n }\n const headers = meta.fields;\n const allowed = new Set<string>(CSV_COLUMNS);\n if (\n headers === undefined ||\n !REQUIRED_CSV_COLUMNS.every((name) => headers.includes(name)) ||\n headers.some((name) => !allowed.has(name)) ||\n new Set(headers).size !== headers.length\n ) {\n throw new CodexSecurityError(\n `Findings CSV must use the Codex Security export columns: ${REQUIRED_CSV_COLUMNS.join(\", \")} (candidate_id is optional).`,\n );\n }\n\n const occurrenceIds = new Set<string>();\n return rows.map((record, index) => {\n const rowNumber = index + 2;\n const parsed = csvFindingRowSchema.safeParse(record);\n if (!parsed.success) {\n throw csvRowError(rowNumber, parsed.error.issues[0]!.message);\n }\n const row = parsed.data;\n if (occurrenceIds.has(row.occurrence_id)) {\n throw csvRowError(rowNumber, \"has a duplicate occurrence_id\");\n }\n occurrenceIds.add(row.occurrence_id);\n return row;\n });\n}\n\nfunction decodeExportedCsvCell(value: string): string {\n return EXPORTED_CSV_ESCAPE.test(value) ? value.slice(1) : value;\n}\n\nexport function csvRowFinding(row: CsvFindingRow): Finding {\n const ruleId = \"import.csv\";\n const anchor = row.occurrence_id;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", CSV_TARGET_ID, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n return {\n findingId: row.finding_id,\n occurrenceId: row.occurrence_id,\n ruleId,\n identity: { anchor },\n fingerprints: {\n algorithm: \"codex-security/v1\",\n primary: fingerprint,\n },\n title: row.title,\n summary: row.summary,\n severity: { level: row.severity },\n confidence: {\n level: row.confidence,\n rationale: \"Imported from a Codex Security findings CSV.\",\n },\n taxonomy: { category: \"imported\", cwe: [] },\n locations: [\n {\n path: row.path,\n startLine: row.start_line,\n ...(row.end_line === undefined ? {} : { endLine: row.end_line }),\n },\n ],\n remediation: row.remediation,\n validation: {\n method: \"Source-reported CSV import metadata\",\n status: row.status,\n summary: [\n `Source finding ID: ${row.finding_id}`,\n `Source occurrence ID: ${row.occurrence_id}`,\n `Source status: ${row.status}`,\n ...(row.close_reason === undefined\n ? []\n : [`Source close reason: ${row.close_reason}`]),\n ...(row.note === undefined ? [] : [`Source note: ${row.note}`]),\n ].join(\"\\n\"),\n },\n provenance: { source: \"csv_import\" },\n extensions: {\n ...(row.candidate_id === undefined\n ? {}\n : { candidateId: row.candidate_id }),\n },\n };\n}\n\nfunction requiredCsvText(column: string) {\n return z.string().refine((value) => value.trim().length > 0, {\n error: `requires ${column}`,\n });\n}\n\nfunction validCsvLine(value: string): boolean {\n if (!/^[1-9]\\d*$/u.test(value)) return false;\n return Number.isSafeInteger(Number(value));\n}\n\nfunction safeFindingPath(value: string): boolean {\n if (\n value.trim().length === 0 ||\n value === \".\" ||\n isAbsolute(value) ||\n /^[A-Za-z]:/u.test(value) ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001F]/u.test(value) ||\n value.split(\"/\").includes(\"..\")\n ) {\n return false;\n }\n const normalized = posix.normalize(value).replace(/\\/+$/u, \"\");\n return normalized !== \".\" && !normalized.startsWith(\"../\");\n}\n\nfunction csvRowError(rowNumber: number, detail: string): CodexSecurityError {\n return new CodexSecurityError(`Findings CSV row ${rowNumber} ${detail}.`);\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAKxC,KAAK,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB,YAC9B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,OAAO,EACP,KAAK,CACG,CAAC;AAEX,MAAM,WAAW,+BAA+B;IAC9C,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sDAAsD;IACtD,KAAK,CAAC,EAAE,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7C,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,sBAAsB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,UAAU,wBAAwB;IAChC,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,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACjB,GACL,OAAO,CAAC,OAAO,CAAC,CAyClB;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,+BAA+B,EACxC,YAAY,GAAE,wBAA6B,GAC1C,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAwI5C;AAED,iBAAe,gBAAgB,CAC7B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAYrB"}
package/dist/github.js CHANGED
@@ -33,7 +33,13 @@ export async function createAuthenticatedGitHub(host, options = {}) {
33
33
  }
34
34
  return new Octokit({
35
35
  auth: token,
36
- ...(host === "github.com" ? {} : { baseUrl: `https://${host}/api/v3` }),
36
+ ...(host === "github.com"
37
+ ? {}
38
+ : {
39
+ baseUrl: host.toLowerCase().endsWith(".ghe.com")
40
+ ? `https://api.${host}`
41
+ : `https://${host}/api/v3`,
42
+ }),
37
43
  });
38
44
  }
39
45
  export async function importGitHubCodeScanningAlerts(options, dependencies = {}) {
@@ -1 +1 @@
1
- {"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile as execFileCallback } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { Octokit } from \"@octokit/core\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { resolveTrustedExecutable } from \"./trusted-executable.js\";\n\nconst execFile = promisify(execFileCallback);\ntype GitHubAlert = Awaited<ReturnType<typeof fetchGitHubAlert>>;\n\nexport const GITHUB_ALERT_STATES = [\n \"open\",\n \"closed\",\n \"dismissed\",\n \"fixed\",\n \"all\",\n] as const;\n\nexport interface GitHubCodeScanningImportOptions {\n /** GitHub repository in OWNER/REPO form. */\n repository: string;\n /** Exact alert numbers, regardless of state. Omit to list matching alerts. */\n alertNumbers?: readonly number[];\n /** State used when listing alerts (default: open). */\n state?: (typeof GITHUB_ALERT_STATES)[number];\n /** Git reference to inspect; omitted lists the default branch. */\n ref?: string;\n /** Defaults to GH_HOST or github.com. */\n githubHost?: string;\n /** Omit to use the authenticated GitHub CLI, including its token environment. */\n githubToken?: string;\n signal?: AbortSignal;\n}\n\nexport interface ImportedGitHubCodeScanningAlert {\n source: \"github-code-scanning\";\n repository: string;\n number: number;\n url: string;\n /** Upstream evidence, not a validated or sealed Codex Security finding. */\n alert: GitHubAlert;\n}\n\ninterface GitHubImportDependencies {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n createGitHub?: (host: string, signal?: AbortSignal) => Promise<Octokit>;\n}\n\nexport async function createAuthenticatedGitHub(\n host: string,\n options: {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n token?: string;\n signal?: AbortSignal;\n } = {},\n): Promise<Octokit> {\n options.signal?.throwIfAborted();\n let token = options.token;\n if (token === undefined) {\n const trusted = await resolveTrustedExecutable(\n \"gh\",\n options.environment ?? process.env,\n options.currentDirectory ?? process.cwd(),\n );\n if (trusted === null) {\n throw new CodexSecurityError(\n \"GitHub CLI is required. Install gh and sign in first.\",\n );\n }\n try {\n const { stdout } = await execFile(\n trusted.executable,\n [\"auth\", \"token\", \"--hostname\", host],\n { env: trusted.environment, signal: options.signal },\n );\n token = stdout.trim();\n } catch {\n options.signal?.throwIfAborted();\n throw new CodexSecurityError(\n \"GitHub sign-in is required. Run 'gh auth login' first.\",\n );\n }\n }\n if (token.trim().length === 0) {\n throw new CodexSecurityError(\"GitHub access token must not be empty.\");\n }\n return new Octokit({\n auth: token,\n ...(host === \"github.com\" ? {} : { baseUrl: `https://${host}/api/v3` }),\n });\n}\n\nexport async function importGitHubCodeScanningAlerts(\n options: GitHubCodeScanningImportOptions,\n dependencies: GitHubImportDependencies = {},\n): Promise<ImportedGitHubCodeScanningAlert[]> {\n options.signal?.throwIfAborted();\n const repository = options.repository.trim();\n const parts = /^([a-z0-9_.-]+)\\/([a-z0-9_.-]+)$/iu.exec(repository);\n if (\n parts === null ||\n parts.slice(1).some((part) => /^\\.{1,2}$/u.test(part))\n ) {\n throw new CodexSecurityError(\"GitHub repository must be OWNER/REPO.\");\n }\n const owner = parts[1]!;\n const repo = parts[2]!;\n const numbers = [...new Set(options.alertNumbers ?? [])];\n if (numbers.some((number) => !Number.isSafeInteger(number) || number < 1)) {\n throw new CodexSecurityError(\n \"GitHub alert numbers must be positive integers.\",\n );\n }\n const state = options.state ?? \"open\";\n if (!GITHUB_ALERT_STATES.includes(state)) {\n throw new CodexSecurityError(\"GitHub alert state is invalid.\");\n }\n if (numbers.length > 0 && state !== \"open\") {\n throw new CodexSecurityError(\n \"--github-state only filters lists; use it without --github-alert.\",\n );\n }\n const ref = options.ref?.trim();\n if (ref === \"\") {\n throw new CodexSecurityError(\"GitHub reference must not be empty.\");\n }\n const environment = dependencies.environment ?? process.env;\n const host =\n options.githubHost?.trim() ??\n (environment[\"GH_HOST\"]?.trim() || \"github.com\");\n if (host.length === 0) {\n throw new CodexSecurityError(\"GitHub host must not be empty.\");\n }\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 selected = new Map<number, GitHubAlert[\"most_recent_instance\"]>();\n if (numbers.length === 0 || ref !== undefined) {\n let page = 1;\n while (true) {\n options.signal?.throwIfAborted();\n // Octokit's list route omits GitHub's \"closed\" state.\n const response = await github.request<\n Pick<GitHubAlert, \"number\" | \"most_recent_instance\">[]\n >({\n method: \"GET\",\n url: \"/repos/{owner}/{repo}/code-scanning/alerts\",\n owner,\n repo,\n per_page: 100,\n page,\n ref,\n state: numbers.length > 0 || state === \"all\" ? undefined : state,\n request: { signal: options.signal, redirect: \"error\" },\n });\n for (const alert of response.data) {\n if (numbers.length === 0 || numbers.includes(alert.number)) {\n selected.set(alert.number, alert.most_recent_instance);\n }\n }\n if (\n !response.headers.link?.includes('rel=\"next\"') ||\n (numbers.length > 0 && selected.size === numbers.length)\n )\n break;\n page += 1;\n }\n if (numbers.some((number) => !selected.has(number))) {\n throw new CodexSecurityError(\n \"One or more selected GitHub alerts were not found on the requested reference.\",\n );\n }\n }\n const alerts: ImportedGitHubCodeScanningAlert[] = [];\n for (const number of numbers.length > 0 ? numbers : selected.keys()) {\n options.signal?.throwIfAborted();\n const alert = await fetchGitHubAlert(\n github,\n owner,\n repo,\n number,\n options.signal,\n );\n // Detail requests use the default branch; retain the listed ref's evidence.\n const instance = selected.get(number);\n alerts.push({\n source: \"github-code-scanning\",\n repository,\n number,\n url: alert.html_url,\n alert:\n instance === undefined\n ? alert\n : { ...alert, most_recent_instance: instance },\n });\n }\n return alerts;\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 code scanning access. Check repository permissions, code scanning availability, and API rate limits.\",\n );\n }\n if (status === 404) {\n throw new CodexSecurityError(\n \"GitHub repository or code scanning alert was not found or is not accessible.\",\n );\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 code scanning request failed${typeof status === \"number\" ? ` (HTTP ${status})` : \"\"}: ${errorMessage(error)}`,\n );\n }\n}\n\nasync function fetchGitHubAlert(\n github: Octokit,\n owner: string,\n repo: string,\n alertNumber: number,\n signal?: AbortSignal,\n) {\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/code-scanning/alerts/{alert_number}\",\n {\n owner,\n repo,\n alert_number: alertNumber,\n request: { signal, redirect: \"error\" },\n },\n );\n return response.data;\n}\n"]}
1
+ {"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile as execFileCallback } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { Octokit } from \"@octokit/core\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { resolveTrustedExecutable } from \"./trusted-executable.js\";\n\nconst execFile = promisify(execFileCallback);\ntype GitHubAlert = Awaited<ReturnType<typeof fetchGitHubAlert>>;\n\nexport const GITHUB_ALERT_STATES = [\n \"open\",\n \"closed\",\n \"dismissed\",\n \"fixed\",\n \"all\",\n] as const;\n\nexport interface GitHubCodeScanningImportOptions {\n /** GitHub repository in OWNER/REPO form. */\n repository: string;\n /** Exact alert numbers, regardless of state. Omit to list matching alerts. */\n alertNumbers?: readonly number[];\n /** State used when listing alerts (default: open). */\n state?: (typeof GITHUB_ALERT_STATES)[number];\n /** Git reference to inspect; omitted lists the default branch. */\n ref?: string;\n /** Defaults to GH_HOST or github.com. */\n githubHost?: string;\n /** Omit to use the authenticated GitHub CLI, including its token environment. */\n githubToken?: string;\n signal?: AbortSignal;\n}\n\nexport interface ImportedGitHubCodeScanningAlert {\n source: \"github-code-scanning\";\n repository: string;\n number: number;\n url: string;\n /** Upstream evidence, not a validated or sealed Codex Security finding. */\n alert: GitHubAlert;\n}\n\ninterface GitHubImportDependencies {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n createGitHub?: (host: string, signal?: AbortSignal) => Promise<Octokit>;\n}\n\nexport async function createAuthenticatedGitHub(\n host: string,\n options: {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n token?: string;\n signal?: AbortSignal;\n } = {},\n): Promise<Octokit> {\n options.signal?.throwIfAborted();\n let token = options.token;\n if (token === undefined) {\n const trusted = await resolveTrustedExecutable(\n \"gh\",\n options.environment ?? process.env,\n options.currentDirectory ?? process.cwd(),\n );\n if (trusted === null) {\n throw new CodexSecurityError(\n \"GitHub CLI is required. Install gh and sign in first.\",\n );\n }\n try {\n const { stdout } = await execFile(\n trusted.executable,\n [\"auth\", \"token\", \"--hostname\", host],\n { env: trusted.environment, signal: options.signal },\n );\n token = stdout.trim();\n } catch {\n options.signal?.throwIfAborted();\n throw new CodexSecurityError(\n \"GitHub sign-in is required. Run 'gh auth login' first.\",\n );\n }\n }\n if (token.trim().length === 0) {\n throw new CodexSecurityError(\"GitHub access token must not be empty.\");\n }\n return new Octokit({\n auth: token,\n ...(host === \"github.com\"\n ? {}\n : {\n baseUrl: host.toLowerCase().endsWith(\".ghe.com\")\n ? `https://api.${host}`\n : `https://${host}/api/v3`,\n }),\n });\n}\n\nexport async function importGitHubCodeScanningAlerts(\n options: GitHubCodeScanningImportOptions,\n dependencies: GitHubImportDependencies = {},\n): Promise<ImportedGitHubCodeScanningAlert[]> {\n options.signal?.throwIfAborted();\n const repository = options.repository.trim();\n const parts = /^([a-z0-9_.-]+)\\/([a-z0-9_.-]+)$/iu.exec(repository);\n if (\n parts === null ||\n parts.slice(1).some((part) => /^\\.{1,2}$/u.test(part))\n ) {\n throw new CodexSecurityError(\"GitHub repository must be OWNER/REPO.\");\n }\n const owner = parts[1]!;\n const repo = parts[2]!;\n const numbers = [...new Set(options.alertNumbers ?? [])];\n if (numbers.some((number) => !Number.isSafeInteger(number) || number < 1)) {\n throw new CodexSecurityError(\n \"GitHub alert numbers must be positive integers.\",\n );\n }\n const state = options.state ?? \"open\";\n if (!GITHUB_ALERT_STATES.includes(state)) {\n throw new CodexSecurityError(\"GitHub alert state is invalid.\");\n }\n if (numbers.length > 0 && state !== \"open\") {\n throw new CodexSecurityError(\n \"--github-state only filters lists; use it without --github-alert.\",\n );\n }\n const ref = options.ref?.trim();\n if (ref === \"\") {\n throw new CodexSecurityError(\"GitHub reference must not be empty.\");\n }\n const environment = dependencies.environment ?? process.env;\n const host =\n options.githubHost?.trim() ??\n (environment[\"GH_HOST\"]?.trim() || \"github.com\");\n if (host.length === 0) {\n throw new CodexSecurityError(\"GitHub host must not be empty.\");\n }\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 selected = new Map<number, GitHubAlert[\"most_recent_instance\"]>();\n if (numbers.length === 0 || ref !== undefined) {\n let page = 1;\n while (true) {\n options.signal?.throwIfAborted();\n // Octokit's list route omits GitHub's \"closed\" state.\n const response = await github.request<\n Pick<GitHubAlert, \"number\" | \"most_recent_instance\">[]\n >({\n method: \"GET\",\n url: \"/repos/{owner}/{repo}/code-scanning/alerts\",\n owner,\n repo,\n per_page: 100,\n page,\n ref,\n state: numbers.length > 0 || state === \"all\" ? undefined : state,\n request: { signal: options.signal, redirect: \"error\" },\n });\n for (const alert of response.data) {\n if (numbers.length === 0 || numbers.includes(alert.number)) {\n selected.set(alert.number, alert.most_recent_instance);\n }\n }\n if (\n !response.headers.link?.includes('rel=\"next\"') ||\n (numbers.length > 0 && selected.size === numbers.length)\n )\n break;\n page += 1;\n }\n if (numbers.some((number) => !selected.has(number))) {\n throw new CodexSecurityError(\n \"One or more selected GitHub alerts were not found on the requested reference.\",\n );\n }\n }\n const alerts: ImportedGitHubCodeScanningAlert[] = [];\n for (const number of numbers.length > 0 ? numbers : selected.keys()) {\n options.signal?.throwIfAborted();\n const alert = await fetchGitHubAlert(\n github,\n owner,\n repo,\n number,\n options.signal,\n );\n // Detail requests use the default branch; retain the listed ref's evidence.\n const instance = selected.get(number);\n alerts.push({\n source: \"github-code-scanning\",\n repository,\n number,\n url: alert.html_url,\n alert:\n instance === undefined\n ? alert\n : { ...alert, most_recent_instance: instance },\n });\n }\n return alerts;\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 code scanning access. Check repository permissions, code scanning availability, and API rate limits.\",\n );\n }\n if (status === 404) {\n throw new CodexSecurityError(\n \"GitHub repository or code scanning alert was not found or is not accessible.\",\n );\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 code scanning request failed${typeof status === \"number\" ? ` (HTTP ${status})` : \"\"}: ${errorMessage(error)}`,\n );\n }\n}\n\nasync function fetchGitHubAlert(\n github: Octokit,\n owner: string,\n repo: string,\n alertNumber: number,\n signal?: AbortSignal,\n) {\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/code-scanning/alerts/{alert_number}\",\n {\n owner,\n repo,\n alert_number: alertNumber,\n request: { signal, redirect: \"error\" },\n },\n );\n return response.data;\n}\n"]}