@openai/codex-security 0.2.0 → 0.3.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 (463) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  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 +563 -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 +10 -12
  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 +1 -47
  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 +71 -192
  40. package/_bundled_plugin/schemas/scan-manifest.schema.json +18 -45
  41. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  42. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  43. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  44. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  45. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  46. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  47. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  48. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  49. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  52. package/_bundled_plugin/scripts/finalize_scan_contract.py +315 -232
  53. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  54. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  55. package/_bundled_plugin/scripts/generate_rank_input.py +99 -829
  56. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  58. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  59. package/_bundled_plugin/scripts/report_projection.py +117 -172
  60. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  61. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  62. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  63. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  64. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  65. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  66. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  67. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  68. package/_bundled_plugin/scripts/workbench_cli.py +94 -179
  69. package/_bundled_plugin/scripts/workbench_db.py +427 -463
  70. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  71. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  72. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  73. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  75. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  76. package/_bundled_plugin/scripts/workbench_publication.py +33 -57
  77. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +23 -34
  82. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  83. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  84. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  85. package/_bundled_plugin/scripts/workbench_validation.py +16 -27
  86. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  87. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  88. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  89. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  90. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  91. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  93. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  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-diff-scan/agents/openai.yaml +1 -1
  98. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  99. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  100. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +1 -1
  101. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  102. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  103. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  104. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  105. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  106. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  107. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  108. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  110. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  111. package/bin/codex-security.mjs +9 -2
  112. package/dist/api.d.ts +60 -10
  113. package/dist/api.d.ts.map +1 -1
  114. package/dist/api.js +803 -380
  115. package/dist/api.js.map +1 -1
  116. package/dist/artifact-export.d.ts +1 -1
  117. package/dist/artifact-export.d.ts.map +1 -1
  118. package/dist/artifact-export.js +28 -13
  119. package/dist/artifact-export.js.map +1 -1
  120. package/dist/auth.d.ts +2 -6
  121. package/dist/auth.d.ts.map +1 -1
  122. package/dist/auth.js +19 -9
  123. package/dist/auth.js.map +1 -1
  124. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  125. package/dist/bulk-scan-discovery.js +1 -0
  126. package/dist/bulk-scan-discovery.js.map +1 -1
  127. package/dist/classify-severity.d.ts +26 -9
  128. package/dist/classify-severity.d.ts.map +1 -1
  129. package/dist/classify-severity.js +13 -30
  130. package/dist/classify-severity.js.map +1 -1
  131. package/dist/cli-help.d.ts.map +1 -1
  132. package/dist/cli-help.js +17 -13
  133. package/dist/cli-help.js.map +1 -1
  134. package/dist/cli-signals.d.ts +8 -0
  135. package/dist/cli-signals.d.ts.map +1 -0
  136. package/dist/cli-signals.js +28 -0
  137. package/dist/cli-signals.js.map +1 -0
  138. package/dist/cli.d.ts +4 -3
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1087 -900
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.d.ts.map +1 -1
  143. package/dist/cloud-publish.js +10 -9
  144. package/dist/cloud-publish.js.map +1 -1
  145. package/dist/codeowners.d.ts +19 -0
  146. package/dist/codeowners.d.ts.map +1 -0
  147. package/dist/codeowners.js +138 -0
  148. package/dist/codeowners.js.map +1 -0
  149. package/dist/codex-sdk-environment.d.ts +1 -0
  150. package/dist/codex-sdk-environment.d.ts.map +1 -1
  151. package/dist/codex-sdk-environment.js +40 -2
  152. package/dist/codex-sdk-environment.js.map +1 -1
  153. package/dist/component-plan.d.ts +2 -5
  154. package/dist/component-plan.d.ts.map +1 -1
  155. package/dist/component-plan.js +38 -30
  156. package/dist/component-plan.js.map +1 -1
  157. package/dist/component-scan.d.ts +6 -5
  158. package/dist/component-scan.d.ts.map +1 -1
  159. package/dist/component-scan.js +23 -35
  160. package/dist/component-scan.js.map +1 -1
  161. package/dist/config.d.ts.map +1 -1
  162. package/dist/config.js +64 -74
  163. package/dist/config.js.map +1 -1
  164. package/dist/contract.d.ts +15 -3
  165. package/dist/contract.d.ts.map +1 -1
  166. package/dist/contract.js +87 -252
  167. package/dist/contract.js.map +1 -1
  168. package/dist/cost-model.d.ts +13 -6
  169. package/dist/cost-model.d.ts.map +1 -1
  170. package/dist/cost-model.js +14 -4
  171. package/dist/cost-model.js.map +1 -1
  172. package/dist/cost.d.ts +10 -2
  173. package/dist/cost.d.ts.map +1 -1
  174. package/dist/cost.js +102 -104
  175. package/dist/cost.js.map +1 -1
  176. package/dist/custom-validation-prompt.d.ts.map +1 -1
  177. package/dist/custom-validation-prompt.js +6 -5
  178. package/dist/custom-validation-prompt.js.map +1 -1
  179. package/dist/custom-validation.d.ts +1 -2
  180. package/dist/custom-validation.d.ts.map +1 -1
  181. package/dist/custom-validation.js +9 -3
  182. package/dist/custom-validation.js.map +1 -1
  183. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  184. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  185. package/dist/deduplication/checkpointed-review.js +23 -9
  186. package/dist/deduplication/checkpointed-review.js.map +1 -1
  187. package/dist/deduplication/codex-review.d.ts +7 -1
  188. package/dist/deduplication/codex-review.d.ts.map +1 -1
  189. package/dist/deduplication/codex-review.js +126 -17
  190. package/dist/deduplication/codex-review.js.map +1 -1
  191. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  192. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  193. package/dist/deduplication/deduplication-prompts.js +18 -4
  194. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  195. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  196. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication-reviewer.js +57 -47
  198. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  199. package/dist/deduplication/deduplication.d.ts.map +1 -1
  200. package/dist/deduplication/deduplication.js +19 -51
  201. package/dist/deduplication/deduplication.js.map +1 -1
  202. package/dist/deduplication/diagnostics.d.ts +17 -0
  203. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  204. package/dist/deduplication/diagnostics.js +5 -0
  205. package/dist/deduplication/diagnostics.js.map +1 -0
  206. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  207. package/dist/deduplication/finding-schema.js +7 -1
  208. package/dist/deduplication/finding-schema.js.map +1 -1
  209. package/dist/deduplication/local.d.ts +31 -0
  210. package/dist/deduplication/local.d.ts.map +1 -0
  211. package/dist/deduplication/local.js +166 -0
  212. package/dist/deduplication/local.js.map +1 -0
  213. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  214. package/dist/deduplication/records-protocol.js +11 -24
  215. package/dist/deduplication/records-protocol.js.map +1 -1
  216. package/dist/deduplication/records.d.ts +186 -11
  217. package/dist/deduplication/records.d.ts.map +1 -1
  218. package/dist/deduplication/records.js +10 -18
  219. package/dist/deduplication/records.js.map +1 -1
  220. package/dist/deduplication/scan.d.ts +9 -3
  221. package/dist/deduplication/scan.d.ts.map +1 -1
  222. package/dist/deduplication/scan.js +158 -39
  223. package/dist/deduplication/scan.js.map +1 -1
  224. package/dist/deep-config.d.ts +2 -1
  225. package/dist/deep-config.d.ts.map +1 -1
  226. package/dist/deep-config.js +4 -4
  227. package/dist/deep-config.js.map +1 -1
  228. package/dist/deep-progress.d.ts +2 -0
  229. package/dist/deep-progress.d.ts.map +1 -1
  230. package/dist/deep-progress.js +13 -10
  231. package/dist/deep-progress.js.map +1 -1
  232. package/dist/deep-scan.d.ts +20 -0
  233. package/dist/deep-scan.d.ts.map +1 -0
  234. package/dist/deep-scan.js +113 -0
  235. package/dist/deep-scan.js.map +1 -0
  236. package/dist/errors.d.ts +2 -0
  237. package/dist/errors.d.ts.map +1 -1
  238. package/dist/errors.js +2 -0
  239. package/dist/errors.js.map +1 -1
  240. package/dist/feedback.d.ts.map +1 -1
  241. package/dist/feedback.js +53 -21
  242. package/dist/feedback.js.map +1 -1
  243. package/dist/finding-catalogue.d.ts.map +1 -1
  244. package/dist/finding-catalogue.js +4 -8
  245. package/dist/finding-catalogue.js.map +1 -1
  246. package/dist/finding-normalization.d.ts +5 -0
  247. package/dist/finding-normalization.d.ts.map +1 -0
  248. package/dist/finding-normalization.js +120 -0
  249. package/dist/finding-normalization.js.map +1 -0
  250. package/dist/finding-retrieval.d.ts +9 -0
  251. package/dist/finding-retrieval.d.ts.map +1 -1
  252. package/dist/finding-retrieval.js.map +1 -1
  253. package/dist/finding-workflow.d.ts +13 -8
  254. package/dist/finding-workflow.d.ts.map +1 -1
  255. package/dist/finding-workflow.js +14 -6
  256. package/dist/finding-workflow.js.map +1 -1
  257. package/dist/findings-client.d.ts +2 -1
  258. package/dist/findings-client.d.ts.map +1 -1
  259. package/dist/findings-client.js +36 -9
  260. package/dist/findings-client.js.map +1 -1
  261. package/dist/findings-errors.d.ts +16 -0
  262. package/dist/findings-errors.d.ts.map +1 -0
  263. package/dist/findings-errors.js +24 -0
  264. package/dist/findings-errors.js.map +1 -0
  265. package/dist/findings-import.d.ts +1 -1
  266. package/dist/findings-import.d.ts.map +1 -1
  267. package/dist/findings-import.js +12 -30
  268. package/dist/findings-import.js.map +1 -1
  269. package/dist/github.d.ts.map +1 -1
  270. package/dist/github.js +7 -1
  271. package/dist/github.js.map +1 -1
  272. package/dist/import-scan.d.ts.map +1 -1
  273. package/dist/import-scan.js +48 -38
  274. package/dist/import-scan.js.map +1 -1
  275. package/dist/index.d.ts +8 -4
  276. package/dist/index.d.ts.map +1 -1
  277. package/dist/index.js +1 -1
  278. package/dist/index.js.map +1 -1
  279. package/dist/knowledge-base.d.ts +7 -1
  280. package/dist/knowledge-base.d.ts.map +1 -1
  281. package/dist/knowledge-base.js +114 -46
  282. package/dist/knowledge-base.js.map +1 -1
  283. package/dist/linear.d.ts.map +1 -1
  284. package/dist/linear.js +2 -7
  285. package/dist/linear.js.map +1 -1
  286. package/dist/mock-scan.d.ts.map +1 -1
  287. package/dist/mock-scan.js +0 -1
  288. package/dist/mock-scan.js.map +1 -1
  289. package/dist/models.d.ts +0 -2
  290. package/dist/models.d.ts.map +1 -1
  291. package/dist/models.js.map +1 -1
  292. package/dist/multiscan.d.ts +9 -3
  293. package/dist/multiscan.d.ts.map +1 -1
  294. package/dist/multiscan.js +193 -126
  295. package/dist/multiscan.js.map +1 -1
  296. package/dist/owner-evidence.d.ts +10 -2
  297. package/dist/owner-evidence.d.ts.map +1 -1
  298. package/dist/owner-evidence.js +67 -8
  299. package/dist/owner-evidence.js.map +1 -1
  300. package/dist/patch-tui.d.ts.map +1 -1
  301. package/dist/patch-tui.js +3 -2
  302. package/dist/patch-tui.js.map +1 -1
  303. package/dist/project-config.js +3 -3
  304. package/dist/project-config.js.map +1 -1
  305. package/dist/provider-profile.d.ts +21 -0
  306. package/dist/provider-profile.d.ts.map +1 -0
  307. package/dist/provider-profile.js +133 -0
  308. package/dist/provider-profile.js.map +1 -0
  309. package/dist/publication-events.d.ts +6 -8
  310. package/dist/publication-events.d.ts.map +1 -1
  311. package/dist/publication-events.js +25 -50
  312. package/dist/publication-events.js.map +1 -1
  313. package/dist/publication-store.d.ts.map +1 -1
  314. package/dist/publication-store.js +40 -64
  315. package/dist/publication-store.js.map +1 -1
  316. package/dist/publication.d.ts +1 -2
  317. package/dist/publication.d.ts.map +1 -1
  318. package/dist/publication.js +2 -8
  319. package/dist/publication.js.map +1 -1
  320. package/dist/publish.d.ts +1 -5
  321. package/dist/publish.d.ts.map +1 -1
  322. package/dist/publish.js +109 -160
  323. package/dist/publish.js.map +1 -1
  324. package/dist/request-metadata.d.ts +9 -0
  325. package/dist/request-metadata.d.ts.map +1 -0
  326. package/dist/request-metadata.js +13 -0
  327. package/dist/request-metadata.js.map +1 -0
  328. package/dist/runtime.d.ts +15 -4
  329. package/dist/runtime.d.ts.map +1 -1
  330. package/dist/runtime.js +430 -138
  331. package/dist/runtime.js.map +1 -1
  332. package/dist/saved-scan-bootstrap.d.ts +14 -0
  333. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  334. package/dist/saved-scan-bootstrap.js +261 -0
  335. package/dist/saved-scan-bootstrap.js.map +1 -0
  336. package/dist/saved-scan.d.ts +1 -1
  337. package/dist/saved-scan.d.ts.map +1 -1
  338. package/dist/saved-scan.js +6 -12
  339. package/dist/saved-scan.js.map +1 -1
  340. package/dist/scan-activity.js +11 -8
  341. package/dist/scan-activity.js.map +1 -1
  342. package/dist/scan-comparison.d.ts +28 -15
  343. package/dist/scan-comparison.d.ts.map +1 -1
  344. package/dist/scan-comparison.js +276 -281
  345. package/dist/scan-comparison.js.map +1 -1
  346. package/dist/scan-dashboard.d.ts +3 -0
  347. package/dist/scan-dashboard.d.ts.map +1 -1
  348. package/dist/scan-dashboard.js +345 -77
  349. package/dist/scan-dashboard.js.map +1 -1
  350. package/dist/scan-history-renderer.d.ts.map +1 -1
  351. package/dist/scan-history-renderer.js +54 -13
  352. package/dist/scan-history-renderer.js.map +1 -1
  353. package/dist/scan-inputs.d.ts +6 -0
  354. package/dist/scan-inputs.d.ts.map +1 -0
  355. package/dist/scan-inputs.js +71 -0
  356. package/dist/scan-inputs.js.map +1 -0
  357. package/dist/scan-logs.d.ts +2 -3
  358. package/dist/scan-logs.d.ts.map +1 -1
  359. package/dist/scan-logs.js +12 -6
  360. package/dist/scan-logs.js.map +1 -1
  361. package/dist/scan-sessions.d.ts +4 -0
  362. package/dist/scan-sessions.d.ts.map +1 -1
  363. package/dist/scan-sessions.js +17 -0
  364. package/dist/scan-sessions.js.map +1 -1
  365. package/dist/scan-skill-paths.d.ts +8 -0
  366. package/dist/scan-skill-paths.d.ts.map +1 -0
  367. package/dist/scan-skill-paths.js +47 -0
  368. package/dist/scan-skill-paths.js.map +1 -0
  369. package/dist/security-policy-cli.d.ts.map +1 -1
  370. package/dist/security-policy-cli.js +7 -27
  371. package/dist/security-policy-cli.js.map +1 -1
  372. package/dist/security-policy.d.ts +9 -5
  373. package/dist/security-policy.d.ts.map +1 -1
  374. package/dist/security-policy.js +33 -14
  375. package/dist/security-policy.js.map +1 -1
  376. package/dist/server/api.d.ts +0 -1
  377. package/dist/server/api.d.ts.map +1 -1
  378. package/dist/server/api.js +0 -1
  379. package/dist/server/api.js.map +1 -1
  380. package/dist/server/embeddings.d.ts +3 -1
  381. package/dist/server/embeddings.d.ts.map +1 -1
  382. package/dist/server/embeddings.js +10 -3
  383. package/dist/server/embeddings.js.map +1 -1
  384. package/dist/server/errors.d.ts +5 -2
  385. package/dist/server/errors.d.ts.map +1 -1
  386. package/dist/server/errors.js +7 -0
  387. package/dist/server/errors.js.map +1 -1
  388. package/dist/server/sqlite-store.d.ts +0 -2
  389. package/dist/server/sqlite-store.d.ts.map +1 -1
  390. package/dist/server/sqlite-store.js +54 -44
  391. package/dist/server/sqlite-store.js.map +1 -1
  392. package/dist/server/storage.d.ts +0 -2
  393. package/dist/server/storage.d.ts.map +1 -1
  394. package/dist/server/storage.js.map +1 -1
  395. package/dist/severity-store.js +19 -24
  396. package/dist/severity-store.js.map +1 -1
  397. package/dist/standalone-validation-prompt.d.ts +2 -0
  398. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  399. package/dist/standalone-validation-prompt.js +10 -0
  400. package/dist/standalone-validation-prompt.js.map +1 -0
  401. package/dist/suggest-owners.d.ts +4 -2
  402. package/dist/suggest-owners.d.ts.map +1 -1
  403. package/dist/suggest-owners.js +11 -5
  404. package/dist/suggest-owners.js.map +1 -1
  405. package/dist/targets.d.ts +11 -0
  406. package/dist/targets.d.ts.map +1 -1
  407. package/dist/targets.js +106 -47
  408. package/dist/targets.js.map +1 -1
  409. package/dist/trusted-executable.d.ts +2 -2
  410. package/dist/trusted-executable.d.ts.map +1 -1
  411. package/dist/trusted-executable.js +8 -6
  412. package/dist/trusted-executable.js.map +1 -1
  413. package/dist/value.js +7 -0
  414. package/dist/value.js.map +1 -1
  415. package/dist/version.js.map +1 -1
  416. package/dist/workbench-arguments.d.ts +3 -0
  417. package/dist/workbench-arguments.d.ts.map +1 -0
  418. package/dist/workbench-arguments.js +15 -0
  419. package/dist/workbench-arguments.js.map +1 -0
  420. package/dist/worker-progress.d.ts +1 -0
  421. package/dist/worker-progress.d.ts.map +1 -1
  422. package/dist/worker-progress.js +27 -12
  423. package/dist/worker-progress.js.map +1 -1
  424. package/docs/cli.md +1778 -0
  425. package/docs/findings-service.md +402 -0
  426. package/package.json +18 -19
  427. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  428. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  429. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  430. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  431. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  432. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  433. package/dist/server/dashboard/app.css +0 -2
  434. package/dist/server/dashboard/app.js +0 -66
  435. package/dist/server/dashboard/index.html +0 -18
  436. package/dist/server/dashboard-types.d.ts +0 -48
  437. package/dist/server/dashboard-types.d.ts.map +0 -1
  438. package/dist/server/dashboard-types.js +0 -2
  439. package/dist/server/dashboard-types.js.map +0 -1
  440. package/dist/server/dashboard.d.ts +0 -6
  441. package/dist/server/dashboard.d.ts.map +0 -1
  442. package/dist/server/dashboard.js +0 -59
  443. package/dist/server/dashboard.js.map +0 -1
  444. package/dist/server/index.d.ts +0 -2
  445. package/dist/server/index.d.ts.map +0 -1
  446. package/dist/server/index.js +0 -6
  447. package/dist/server/index.js.map +0 -1
  448. package/dist/server/routes.d.ts +0 -7
  449. package/dist/server/routes.d.ts.map +0 -1
  450. package/dist/server/routes.js +0 -98
  451. package/dist/server/routes.js.map +0 -1
  452. package/dist/server/serve.d.ts +0 -2
  453. package/dist/server/serve.d.ts.map +0 -1
  454. package/dist/server/serve.js +0 -28
  455. package/dist/server/serve.js.map +0 -1
  456. package/dist/server/server.d.ts +0 -10
  457. package/dist/server/server.d.ts.map +0 -1
  458. package/dist/server/server.js +0 -16
  459. package/dist/server/server.js.map +0 -1
  460. package/dist/server/validation.d.ts +0 -17
  461. package/dist/server/validation.d.ts.map +0 -1
  462. package/dist/server/validation.js +0 -53
  463. package/dist/server/validation.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"finding-catalogue.js","sourceRoot":"","sources":["../src/finding-catalogue.ts"],"names":[],"mappings":"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","sourcesContent":["export type ComparisonFinding = { occurrenceId: string } & Record<\n string,\n unknown\n>;\n\nexport interface CatalogueEntry {\n card: ComparisonFinding;\n occurrences: readonly ComparisonFinding[];\n}\n\nexport function groupFindings(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n occurrenceGroups: readonly (readonly string[])[] = [],\n): ComparisonFinding[][] {\n const { parents, root } = findingGroupRoots();\n const link = (first: string, second: string): void => {\n const previous = root(first);\n const current = root(second);\n if (previous !== current) parents.set(current, previous);\n };\n for (const [prefix, groups] of [\n [\"finding\", knownFindingGroups],\n [\"occurrence\", occurrenceGroups],\n ] as const) {\n for (const group of groups) {\n const identities =\n prefix === \"finding\"\n ? group.filter((identity) => identity.trim().length > 0)\n : group;\n const first = identities[0];\n if (first === undefined) continue;\n for (const value of identities.slice(1)) {\n link(`${prefix}:${first}`, `${prefix}:${value}`);\n }\n }\n }\n for (const finding of findings) {\n const findingId = finding[\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n link(`finding:${findingId}`, `occurrence:${finding.occurrenceId}`);\n }\n }\n\n return [\n ...Map.groupBy(findings, (finding) =>\n root(`occurrence:${finding.occurrenceId}`),\n ).values(),\n ];\n}\n\nexport function findingCatalogue(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n): Map<string, CatalogueEntry> {\n return new Map(\n groupFindings(findings, knownFindingGroups).map((occurrences) => {\n const latest = occurrences.at(-1)!;\n const card = compactFinding(latest);\n if (occurrences.length > 1) {\n const description = (finding: ComparisonFinding) => {\n const value: Record<string, unknown> = { ...compactFinding(finding) };\n delete value[\"occurrenceId\"];\n delete value[\"findingId\"];\n return value;\n };\n const current = description(latest);\n const seen = new Set<string>();\n const aliases = occurrences.slice(0, -1).flatMap((finding) => {\n const value = Object.fromEntries(\n Object.entries(description(finding)).filter(\n ([field, value]) =>\n JSON.stringify(value) !== JSON.stringify(current[field]),\n ),\n );\n if (Object.keys(value).length === 0) return [];\n const key = JSON.stringify(value);\n if (seen.has(key)) return [];\n seen.add(key);\n return [value];\n });\n card[\"occurrenceCount\"] = occurrences.length;\n if (aliases.length > 0) card[\"earlierDescriptions\"] = aliases;\n }\n const findingId = occurrences[0]![\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n card[\"issueId\"] = findingId;\n }\n return [latest.occurrenceId, { card, occurrences }];\n }),\n );\n}\n\nexport function compactFinding(finding: ComparisonFinding): ComparisonFinding {\n const rootCause = finding[\"rootCause\"] ?? finding[\"root_cause\"];\n const attackPath = record(finding[\"attackPath\"]);\n const dataFlow =\n attackPath?.[\"dataFlow\"] ??\n attackPath?.[\"data_flow\"] ??\n attackPath?.[\"dataflow\"];\n const locations = Array.isArray(finding[\"locations\"])\n ? finding[\"locations\"].flatMap((value) => {\n const location = record(value);\n return location === undefined ? [] : [location];\n })\n : [];\n let controls = locations.filter(\n (location) => location[\"role\"] === \"root_control\",\n );\n if (controls.length === 0) {\n controls = locations.filter((location) =>\n [\"expected_control\", \"concrete_implementation\"].includes(\n String(location[\"role\"]),\n ),\n );\n }\n if (controls.length === 0) controls = locations.slice(0, 1);\n\n return {\n occurrenceId: finding.occurrenceId,\n ...present({\n findingId: finding[\"findingId\"],\n title: finding[\"title\"],\n identity: pick(finding[\"identity\"], [\"anchor\", \"instance\"]),\n ruleId: finding[\"ruleId\"],\n taxonomy: pick(finding[\"taxonomy\"], [\"category\", \"cwe\"]),\n rootCause:\n (typeof rootCause === \"string\"\n ? rootCause\n : record(rootCause)?.[\"summary\"]) ?? finding[\"summary\"],\n remediation: finding[\"remediation\"],\n locations: controls.map((location) =>\n pick(location, [\"path\", \"startLine\", \"endLine\", \"role\"]),\n ),\n attackPath: present({\n dataFlow: pick(dataFlow, [\"source\", \"sink\"]),\n reachability: pick(attackPath?.[\"reachability\"], [\n \"attacker\",\n \"entrypoint\",\n ]),\n }),\n affectedComponent: finding[\"affectedComponent\"],\n boundaryCrossed: finding[\"boundaryCrossed\"],\n }),\n };\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === \"object\" && !Array.isArray(value)\n ? (value as Record<string, unknown>)\n : undefined;\n}\n\nfunction pick(value: unknown, fields: readonly string[]): unknown {\n if (typeof value === \"string\") return value;\n const object = record(value);\n return object === undefined\n ? undefined\n : present(\n Object.fromEntries(fields.map((field) => [field, object[field]])),\n );\n}\n\nfunction present(value: Record<string, unknown>): Record<string, unknown> {\n return Object.fromEntries(\n Object.entries(value).filter(\n ([, item]) =>\n item !== undefined &&\n item !== null &&\n item !== \"\" &&\n (!Array.isArray(item) || item.length > 0) &&\n (record(item) === undefined || Object.keys(item as object).length > 0),\n ),\n );\n}\n\n/** @internal */\nexport function findingGroupRoots() {\n const parents = new Map<string, string>();\n const root = (identity: string): string => {\n if (!parents.has(identity)) parents.set(identity, identity);\n const path: string[] = [];\n let current = identity;\n while (parents.get(current) !== current) {\n path.push(current);\n current = parents.get(current)!;\n }\n for (const item of path) parents.set(item, current);\n return current;\n };\n return { parents, root };\n}\n"]}
1
+ {"version":3,"file":"finding-catalogue.js","sourceRoot":"","sources":["../src/finding-catalogue.ts"],"names":[],"mappings":"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","sourcesContent":["export type ComparisonFinding = { occurrenceId: string } & Record<\n string,\n unknown\n>;\n\nexport interface CatalogueEntry {\n card: ComparisonFinding;\n occurrences: readonly ComparisonFinding[];\n}\n\nexport function groupFindings(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n occurrenceGroups: readonly (readonly string[])[] = [],\n): ComparisonFinding[][] {\n const { parents, root } = findingGroupRoots();\n const link = (first: string, second: string): void => {\n const previous = root(first);\n const current = root(second);\n if (previous !== current) parents.set(current, previous);\n };\n for (const [prefix, groups] of [\n [\"finding\", knownFindingGroups],\n [\"occurrence\", occurrenceGroups],\n ] as const) {\n for (const group of groups) {\n const identities =\n prefix === \"finding\"\n ? group.filter((identity) => identity.trim().length > 0)\n : group;\n const first = identities[0];\n if (first === undefined) continue;\n for (const value of identities.slice(1)) {\n link(`${prefix}:${first}`, `${prefix}:${value}`);\n }\n }\n }\n for (const finding of findings) {\n const findingId = finding[\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n link(`finding:${findingId}`, `occurrence:${finding.occurrenceId}`);\n }\n }\n\n return [\n ...Map.groupBy(findings, (finding) =>\n root(`occurrence:${finding.occurrenceId}`),\n ).values(),\n ];\n}\n\nexport function findingCatalogue(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n): Map<string, CatalogueEntry> {\n return new Map(\n groupFindings(findings, knownFindingGroups).map((occurrences) => {\n const latest = occurrences.at(-1)!;\n const card = compactFinding(latest);\n if (occurrences.length > 1) {\n const current = compactFinding(latest);\n const seen = new Set<string>();\n const aliases = occurrences.slice(0, -1).flatMap((finding) => {\n const value = Object.fromEntries(\n Object.entries(compactFinding(finding)).filter(\n ([field, value]) =>\n field !== \"occurrenceId\" &&\n field !== \"findingId\" &&\n JSON.stringify(value) !== JSON.stringify(current[field]),\n ),\n );\n if (Object.keys(value).length === 0) return [];\n const key = JSON.stringify(value);\n if (seen.has(key)) return [];\n seen.add(key);\n return [value];\n });\n card[\"occurrenceCount\"] = occurrences.length;\n if (aliases.length > 0) card[\"earlierDescriptions\"] = aliases;\n }\n const findingId = occurrences[0]![\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n card[\"issueId\"] = findingId;\n }\n return [latest.occurrenceId, { card, occurrences }];\n }),\n );\n}\n\nexport function compactFinding(finding: ComparisonFinding): ComparisonFinding {\n const rootCause = finding[\"rootCause\"] ?? finding[\"root_cause\"];\n const attackPath = record(finding[\"attackPath\"]);\n const dataFlow =\n attackPath?.[\"dataFlow\"] ??\n attackPath?.[\"data_flow\"] ??\n attackPath?.[\"dataflow\"];\n const locations = Array.isArray(finding[\"locations\"])\n ? finding[\"locations\"].flatMap((value) => {\n const location = record(value);\n return location === undefined ? [] : [location];\n })\n : [];\n let controls = locations.filter(\n (location) => location[\"role\"] === \"root_control\",\n );\n if (controls.length === 0) {\n controls = locations.filter((location) =>\n [\"expected_control\", \"concrete_implementation\"].includes(\n String(location[\"role\"]),\n ),\n );\n }\n if (controls.length === 0) controls = locations.slice(0, 1);\n\n return {\n occurrenceId: finding.occurrenceId,\n ...present({\n findingId: finding[\"findingId\"],\n title: finding[\"title\"],\n identity: pick(finding[\"identity\"], [\"anchor\", \"instance\"]),\n ruleId: finding[\"ruleId\"],\n taxonomy: pick(finding[\"taxonomy\"], [\"category\", \"cwe\"]),\n rootCause:\n (typeof rootCause === \"string\"\n ? rootCause\n : record(rootCause)?.[\"summary\"]) ?? finding[\"summary\"],\n remediation: finding[\"remediation\"],\n locations: controls.map((location) =>\n pick(location, [\"path\", \"startLine\", \"endLine\", \"role\"]),\n ),\n attackPath: present({\n dataFlow: pick(dataFlow, [\"source\", \"sink\"]),\n reachability: pick(attackPath?.[\"reachability\"], [\n \"attacker\",\n \"entrypoint\",\n ]),\n }),\n affectedComponent: finding[\"affectedComponent\"],\n boundaryCrossed: finding[\"boundaryCrossed\"],\n }),\n };\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === \"object\" && !Array.isArray(value)\n ? (value as Record<string, unknown>)\n : undefined;\n}\n\nfunction pick(value: unknown, fields: readonly string[]): unknown {\n if (typeof value === \"string\") return value;\n const object = record(value);\n return object === undefined\n ? undefined\n : present(\n Object.fromEntries(fields.map((field) => [field, object[field]])),\n );\n}\n\nfunction present(value: Record<string, unknown>): Record<string, unknown> {\n return Object.fromEntries(\n Object.entries(value).filter(\n ([, item]) =>\n item !== undefined &&\n item !== null &&\n item !== \"\" &&\n (!Array.isArray(item) || item.length > 0) &&\n (record(item) === undefined || Object.keys(item as object).length > 0),\n ),\n );\n}\n\n/** @internal */\nexport function findingGroupRoots() {\n const parents = new Map<string, string>();\n const root = (identity: string): string => {\n if (!parents.has(identity)) parents.set(identity, identity);\n const path: string[] = [];\n let current = identity;\n while (parents.get(current) !== current) {\n path.push(current);\n current = parents.get(current)!;\n }\n for (const item of path) parents.set(item, current);\n return current;\n };\n return { parents, root };\n}\n"]}
@@ -0,0 +1,5 @@
1
+ type JsonObject = Record<string, unknown>;
2
+ /** Compatibility for historical report reads; never use this to admit new writes. */
3
+ export declare function normalizePersistedFindingDetails(finding: JsonObject): void;
4
+ export {};
5
+ //# sourceMappingURL=finding-normalization.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"finding-normalization.d.ts","sourceRoot":"","sources":["../src/finding-normalization.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,qFAAqF;AACrF,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAkI1E"}
@@ -0,0 +1,120 @@
1
+ import { isRecord as isObject } from "./record.js";
2
+ /** Compatibility for historical report reads; never use this to admit new writes. */
3
+ export function normalizePersistedFindingDetails(finding) {
4
+ if (Array.isArray(finding["code_evidence"])) {
5
+ finding["code_evidence"] = finding["code_evidence"].filter((evidence) => isObject(evidence) &&
6
+ isNonEmptyString(evidence["id"]) &&
7
+ isNonEmptyString(evidence["code"]));
8
+ }
9
+ else if (finding["code_evidence"] !== null) {
10
+ delete finding["code_evidence"];
11
+ }
12
+ for (const [sectionName, listFields] of [
13
+ ["rootCause", ["evidenceRefs", "evidence_refs"]],
14
+ ["root_cause", ["evidenceRefs", "evidence_refs"]],
15
+ [
16
+ "validation",
17
+ [
18
+ "assertions",
19
+ "counterEvidence",
20
+ "evidence",
21
+ "evidenceRefs",
22
+ "evidence_refs",
23
+ "limitations",
24
+ ],
25
+ ],
26
+ [
27
+ "attackPath",
28
+ [
29
+ "assumptions",
30
+ "blindspots",
31
+ "controls",
32
+ "evidenceRefs",
33
+ "evidence_refs",
34
+ "limitations",
35
+ "preconditions",
36
+ "steps",
37
+ ],
38
+ ],
39
+ ]) {
40
+ const section = finding[sectionName];
41
+ if (!isObject(section))
42
+ continue;
43
+ normalizePersistedStringLists(section, listFields);
44
+ }
45
+ const legacyRootCause = finding["root_cause"];
46
+ if (isObject(legacyRootCause)) {
47
+ removeUnsupportedPersistedStrings(legacyRootCause, [
48
+ "summary",
49
+ "code",
50
+ "language",
51
+ ]);
52
+ }
53
+ else if (legacyRootCause !== null && typeof legacyRootCause !== "string") {
54
+ delete finding["root_cause"];
55
+ }
56
+ const validation = finding["validation"];
57
+ if (isObject(validation)) {
58
+ removeUnsupportedPersistedStrings(validation, ["method", "status", "summary", "disposition", "result"].filter((field) => !["status", "disposition", "result"].includes(field) ||
59
+ validation[field] !== null));
60
+ }
61
+ const attackPath = finding["attackPath"];
62
+ if (!isObject(attackPath))
63
+ return;
64
+ removeUnsupportedPersistedStrings(attackPath, ["summary"]);
65
+ for (const field of ["dataFlow", "data_flow", "dataflow", "reachability"]) {
66
+ const detail = attackPath[field];
67
+ if (!isObject(detail)) {
68
+ if (!isNonEmptyString(detail))
69
+ delete attackPath[field];
70
+ continue;
71
+ }
72
+ removeUnsupportedPersistedStrings(detail, [
73
+ "summary",
74
+ "source",
75
+ "sink",
76
+ "outcome",
77
+ ...(field === "reachability" ? ["attacker", "entrypoint"] : []),
78
+ ]);
79
+ normalizePersistedStringLists(detail, [
80
+ "evidenceRefs",
81
+ "evidence_refs",
82
+ "transformations",
83
+ ...(field === "reachability" ? ["preconditions"] : []),
84
+ ]);
85
+ }
86
+ for (const field of ["impact", "likelihood"]) {
87
+ const detail = attackPath[field];
88
+ if (isObject(detail)) {
89
+ removeUnsupportedPersistedStrings(detail, ["level", "rationale", "why"]);
90
+ }
91
+ else if (detail !== undefined &&
92
+ detail !== null &&
93
+ !isNonEmptyString(detail)) {
94
+ delete attackPath[field];
95
+ }
96
+ }
97
+ function normalizePersistedStringLists(section, fields) {
98
+ for (const field of fields) {
99
+ const value = section[field];
100
+ if (isNonEmptyString(value)) {
101
+ if (field !== "evidence")
102
+ section[field] = [value];
103
+ }
104
+ else if (Array.isArray(value))
105
+ section[field] = value.filter(isNonEmptyString);
106
+ else
107
+ delete section[field];
108
+ }
109
+ }
110
+ function removeUnsupportedPersistedStrings(section, fields) {
111
+ for (const field of fields) {
112
+ if (!isNonEmptyString(section[field]))
113
+ delete section[field];
114
+ }
115
+ }
116
+ function isNonEmptyString(value) {
117
+ return typeof value === "string" && value.length > 0;
118
+ }
119
+ }
120
+ //# sourceMappingURL=finding-normalization.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"finding-normalization.js","sourceRoot":"","sources":["../src/finding-normalization.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRecord as isObject } from \"./record.js\";\n\ntype JsonObject = Record<string, unknown>;\n\n/** Compatibility for historical report reads; never use this to admit new writes. */\nexport function normalizePersistedFindingDetails(finding: JsonObject): void {\n if (Array.isArray(finding[\"code_evidence\"])) {\n finding[\"code_evidence\"] = finding[\"code_evidence\"].filter(\n (evidence) =>\n isObject(evidence) &&\n isNonEmptyString(evidence[\"id\"]) &&\n isNonEmptyString(evidence[\"code\"]),\n );\n } else if (finding[\"code_evidence\"] !== null) {\n delete finding[\"code_evidence\"];\n }\n\n for (const [sectionName, listFields] of [\n [\"rootCause\", [\"evidenceRefs\", \"evidence_refs\"]],\n [\"root_cause\", [\"evidenceRefs\", \"evidence_refs\"]],\n [\n \"validation\",\n [\n \"assertions\",\n \"counterEvidence\",\n \"evidence\",\n \"evidenceRefs\",\n \"evidence_refs\",\n \"limitations\",\n ],\n ],\n [\n \"attackPath\",\n [\n \"assumptions\",\n \"blindspots\",\n \"controls\",\n \"evidenceRefs\",\n \"evidence_refs\",\n \"limitations\",\n \"preconditions\",\n \"steps\",\n ],\n ],\n ] satisfies Array<[string, string[]]>) {\n const section = finding[sectionName];\n if (!isObject(section)) continue;\n normalizePersistedStringLists(section, listFields);\n }\n\n const legacyRootCause = finding[\"root_cause\"];\n if (isObject(legacyRootCause)) {\n removeUnsupportedPersistedStrings(legacyRootCause, [\n \"summary\",\n \"code\",\n \"language\",\n ]);\n } else if (legacyRootCause !== null && typeof legacyRootCause !== \"string\") {\n delete finding[\"root_cause\"];\n }\n\n const validation = finding[\"validation\"];\n if (isObject(validation)) {\n removeUnsupportedPersistedStrings(\n validation,\n [\"method\", \"status\", \"summary\", \"disposition\", \"result\"].filter(\n (field) =>\n ![\"status\", \"disposition\", \"result\"].includes(field) ||\n validation[field] !== null,\n ),\n );\n }\n\n const attackPath = finding[\"attackPath\"];\n if (!isObject(attackPath)) return;\n removeUnsupportedPersistedStrings(attackPath, [\"summary\"]);\n for (const field of [\"dataFlow\", \"data_flow\", \"dataflow\", \"reachability\"]) {\n const detail = attackPath[field];\n if (!isObject(detail)) {\n if (!isNonEmptyString(detail)) delete attackPath[field];\n continue;\n }\n removeUnsupportedPersistedStrings(detail, [\n \"summary\",\n \"source\",\n \"sink\",\n \"outcome\",\n ...(field === \"reachability\" ? [\"attacker\", \"entrypoint\"] : []),\n ]);\n normalizePersistedStringLists(detail, [\n \"evidenceRefs\",\n \"evidence_refs\",\n \"transformations\",\n ...(field === \"reachability\" ? [\"preconditions\"] : []),\n ]);\n }\n for (const field of [\"impact\", \"likelihood\"]) {\n const detail = attackPath[field];\n if (isObject(detail)) {\n removeUnsupportedPersistedStrings(detail, [\"level\", \"rationale\", \"why\"]);\n } else if (\n detail !== undefined &&\n detail !== null &&\n !isNonEmptyString(detail)\n ) {\n delete attackPath[field];\n }\n }\n\n function normalizePersistedStringLists(\n section: JsonObject,\n fields: string[],\n ): void {\n for (const field of fields) {\n const value = section[field];\n if (isNonEmptyString(value)) {\n if (field !== \"evidence\") section[field] = [value];\n } else if (Array.isArray(value))\n section[field] = value.filter(isNonEmptyString);\n else delete section[field];\n }\n }\n\n function removeUnsupportedPersistedStrings(\n section: JsonObject,\n fields: string[],\n ): void {\n for (const field of fields) {\n if (!isNonEmptyString(section[field])) delete section[field];\n }\n }\n\n function isNonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0;\n }\n}\n"]}
@@ -6,8 +6,17 @@ export type FindingSearchScope = {
6
6
  allRepositories: true;
7
7
  repositoryId?: never;
8
8
  };
9
+ export interface FindingSourceSnapshot {
10
+ repositoryId: string | null;
11
+ revision: string;
12
+ snapshotDigest: string | null;
13
+ }
9
14
  export interface FindingNeighborhood {
10
15
  finding: Finding;
11
16
  potentialDuplicates: Finding[];
17
+ /** Saved storage associations, separate from model-authored finding content. */
18
+ repositoryIds?: Record<string, string[]>;
19
+ /** Present only when the current body matches its persisted scan occurrence. */
20
+ sourceSnapshots?: Record<string, FindingSourceSnapshot>;
12
21
  }
13
22
  //# sourceMappingURL=finding-retrieval.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"finding-retrieval.d.ts","sourceRoot":"","sources":["../src/finding-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAC1B;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,eAAe,EAAE,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,EAAE,CAAC;CAChC"}
1
+ {"version":3,"file":"finding-retrieval.d.ts","sourceRoot":"","sources":["../src/finding-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAC1B;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,eAAe,EAAE,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,EAAE,CAAC;IAC/B,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACzD"}
@@ -1 +1 @@
1
- {"version":3,"file":"finding-retrieval.js","sourceRoot":"","sources":["../src/finding-retrieval.ts"],"names":[],"mappings":"","sourcesContent":["import type { Finding } from \"./models.js\";\n\nexport type FindingSearchScope =\n | { repositoryId: string; allRepositories?: never }\n | { allRepositories: true; repositoryId?: never };\n\nexport interface FindingNeighborhood {\n finding: Finding;\n potentialDuplicates: Finding[];\n}\n"]}
1
+ {"version":3,"file":"finding-retrieval.js","sourceRoot":"","sources":["../src/finding-retrieval.ts"],"names":[],"mappings":"","sourcesContent":["import type { Finding } from \"./models.js\";\n\nexport type FindingSearchScope =\n | { repositoryId: string; allRepositories?: never }\n | { allRepositories: true; repositoryId?: never };\n\nexport interface FindingSourceSnapshot {\n repositoryId: string | null;\n revision: string;\n snapshotDigest: string | null;\n}\n\nexport interface FindingNeighborhood {\n finding: Finding;\n potentialDuplicates: Finding[];\n /** Saved storage associations, separate from model-authored finding content. */\n repositoryIds?: Record<string, string[]>;\n /** Present only when the current body matches its persisted scan occurrence. */\n sourceSnapshots?: Record<string, FindingSourceSnapshot>;\n}\n"]}
@@ -17,11 +17,17 @@ export interface WorkflowState extends WorkflowBinding {
17
17
  status: "pending" | "running" | "failed" | "completed";
18
18
  result?: unknown;
19
19
  error?: string;
20
- pendingWrite?: {
21
- groups: string[][];
22
- };
20
+ pendingWrite?: DedupePendingWrite;
23
21
  }>;
24
22
  }
23
+ export interface DedupePendingWrite {
24
+ groups: string[][];
25
+ local?: {
26
+ inputDigest: string;
27
+ source: JsonObject;
28
+ gitDisabled?: boolean;
29
+ };
30
+ }
25
31
  export declare function workflowDigest(value: unknown): string;
26
32
  export declare function workflowDestination(url: string): string;
27
33
  /** State lives in the workbench database, never in sealed scan artifacts. */
@@ -30,8 +36,9 @@ export declare class FindingWorkflow {
30
36
  private readonly environment;
31
37
  private readonly workbench;
32
38
  private readonly pythonPath?;
39
+ private readonly protectedRoot?;
33
40
  private options?;
34
- constructor(id: string, environment?: NodeJS.ProcessEnv, workbench?: typeof runWorkbench, pythonPath?: string | undefined);
41
+ constructor(id: string, environment?: NodeJS.ProcessEnv, workbench?: typeof runWorkbench, pythonPath?: string | undefined, protectedRoot?: string | undefined);
35
42
  protectArtifacts(scanDir: string): Promise<void>;
36
43
  get(): Promise<WorkflowState | null>;
37
44
  bind(binding: WorkflowBinding): Promise<WorkflowState>;
@@ -40,12 +47,10 @@ export declare class FindingWorkflow {
40
47
  fail(stage: WorkflowStage, error: unknown): Promise<void>;
41
48
  run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T>;
42
49
  registeredScan(scanId: string): Promise<JsonObject>;
43
- sourceSnapshot(repository: string): Promise<JsonObject>;
50
+ sourceSnapshot(repository: string, gitDisabled?: boolean, privateStatePaths?: readonly string[]): Promise<JsonObject>;
44
51
  getReview(key: string): Promise<unknown>;
45
52
  saveReview(key: string, binding: object, result: unknown): Promise<void>;
46
- prepareDedupe(result: unknown, pendingWrite: {
47
- groups: string[][];
48
- }): Promise<void>;
53
+ prepareDedupe(result: unknown, pendingWrite: DedupePendingWrite): Promise<void>;
49
54
  private command;
50
55
  private request;
51
56
  private call;
@@ -1 +1 @@
1
- {"version":3,"file":"finding-workflow.d.ts","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"finding-workflow.d.ts","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,7 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { isAbsolute, relative, sep } from "node:path";
3
3
  import { CodexSecurityError, errorMessage } from "./errors.js";
4
+ import { findingsBaseUrl } from "./findings-client.js";
4
5
  import { bundledPluginRoot, canonicalizeModelSafePath, codexSecurityStateDirectory, workbenchEnvironment, resolvePluginPython, runWorkbench, } from "./runtime.js";
5
6
  export function workflowDigest(value) {
6
7
  const json = JSON.stringify(value, (_key, item) => item !== null && typeof item === "object" && !Array.isArray(item)
@@ -9,11 +10,10 @@ export function workflowDigest(value) {
9
10
  return createHash("sha256").update(json).digest("hex");
10
11
  }
11
12
  export function workflowDestination(url) {
12
- const route = "v1/bulk/findings";
13
- const destination = new URL(route, url.endsWith("/") ? url : `${url}/`);
13
+ const destination = findingsBaseUrl(url);
14
14
  destination.username = "";
15
15
  destination.password = "";
16
- return destination.href.slice(0, -route.length);
16
+ return destination.href;
17
17
  }
18
18
  /** State lives in the workbench database, never in sealed scan artifacts. */
19
19
  export class FindingWorkflow {
@@ -21,12 +21,14 @@ export class FindingWorkflow {
21
21
  environment;
22
22
  workbench;
23
23
  pythonPath;
24
+ protectedRoot;
24
25
  options;
25
- constructor(id, environment = process.env, workbench = runWorkbench, pythonPath) {
26
+ constructor(id, environment = process.env, workbench = runWorkbench, pythonPath, protectedRoot) {
26
27
  this.id = id;
27
28
  this.environment = environment;
28
29
  this.workbench = workbench;
29
30
  this.pythonPath = pythonPath;
31
+ this.protectedRoot = protectedRoot;
30
32
  if (!id.trim())
31
33
  throw new CodexSecurityError("workflowId must be a nonempty string.");
32
34
  }
@@ -74,8 +76,13 @@ export class FindingWorkflow {
74
76
  const context = await this.call(["get-scan", "--scan-id", scanId]);
75
77
  return context["scan"];
76
78
  }
77
- async sourceSnapshot(repository) {
78
- return (await this.request({ action: "source", repository }))["source"];
79
+ async sourceSnapshot(repository, gitDisabled = false, privateStatePaths = []) {
80
+ return (await this.request({
81
+ action: "source",
82
+ repository,
83
+ ...(gitDisabled ? { gitDisabled } : {}),
84
+ ...(privateStatePaths.length ? { privateStatePaths } : {}),
85
+ }))["source"];
79
86
  }
80
87
  async getReview(key) {
81
88
  return (await this.request({ action: "get-review", key }))["review"];
@@ -104,6 +111,7 @@ export class FindingWorkflow {
104
111
  python: await resolvePluginPython({
105
112
  environment: this.environment,
106
113
  configuredPath: this.pythonPath,
114
+ protectedRoot: this.protectedRoot,
107
115
  }),
108
116
  environment: workbenchEnvironment(this.environment),
109
117
  failureMessage: "Could not save or resume the findings workflow",
@@ -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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,GAEb,MAAM,cAAc,CAAC;AA8BtB,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAa,EAAE,EAAE,CACzD,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/D,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACtE;QACH,CAAC,CAAC,IAAI,CACT,CAAC;IACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACzC,WAAW,CAAC,QAAQ,GAAG,EAAE,CAAC;IAC1B,WAAW,CAAC,QAAQ,GAAG,EAAE,CAAC;IAC1B,OAAO,WAAW,CAAC,IAAI,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAC7E,MAAM,OAAO,eAAe;IAIf,EAAE;IACM,WAAW;IACX,SAAS;IACT,UAAU;IACV,aAAa;IAPxB,OAAO,CAAoC;IAEnD,YACW,EAAU,EACF,WAAW,GAAsB,OAAO,CAAC,GAAG,EAC5C,SAAS,GAAwB,YAAY,EAC7C,UAAmB,EACnB,aAAsB;kBAJ9B,EAAE;2BACM,WAAW;yBACX,SAAS;0BACT,UAAU;6BACV,aAAa;QAE9B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;YACZ,MAAM,IAAI,kBAAkB,CAAC,uCAAuC,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,MAAM,IAAI,GAAG,QAAQ,CACnB,MAAM,yBAAyB,CAAC,OAAO,CAAC,EACxC,MAAM,yBAAyB,CAC7B,2BAA2B,CAAC,IAAI,CAAC,WAAW,CAAC,CAC9C,CACF,CAAC;QACF,IACE,IAAI,KAAK,EAAE;YACX,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,EACpE,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,2DAA2D,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAyB,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAwB;QACjC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAE,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAoB;QAC9B,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAE,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,KAAoB,EACpB,MAAe;QAEf,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAE,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAoB,EAAE,KAAc;QAC7C,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,MAAM,EAAE,MAAM;YACd,KAAK;YACL,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;SAC3B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,KAAoB,EAAE,SAA2B;QAC5D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,WAAW;YAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAW,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QACnE,OAAO,OAAO,CAAC,MAAM,CAAe,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,UAAkB,EAClB,WAAW,GAAG,KAAK,EACnB,iBAAiB,GAAsB,EAAE;QAEzC,OAAO,CACL,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,MAAM,EAAE,QAAQ;YAChB,UAAU;YACV,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D,CAAC,CACH,CAAC,QAAQ,CAAe,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,UAAU,CACd,GAAW,EACX,OAAe,EACf,MAAe;QAEf,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,MAAe,EACf,YAAgC;QAEhC,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,MAAM,EAAE,gBAAgB;YACxB,KAAK,EAAE,QAAQ;YACf,MAAM;YACN,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAAe;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,UAAU,CAAoC,CAAC;IAC/D,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAAe;QACnC,OAAO,MAAM,IAAI,CAAC,IAAI,CACpB,CAAC,kBAAkB,CAAC,EACpB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAC5C,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,IAAuB,EACvB,KAAc;QAEd,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC7B,UAAU,EAAE,MAAM,iBAAiB,EAAE;YACrC,MAAM,EAAE,MAAM,mBAAmB,CAAC;gBAChC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,cAAc,EAAE,IAAI,CAAC,UAAU;gBAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAC;YACF,WAAW,EAAE,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC;YACnD,cAAc,EAAE,gDAAgD;SACjE,CAAC,CAAC,EAAE,CAAC;QACN,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;CACF","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"}