@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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@openai/codex-security",
3
- "version": "0.2.0",
3
+ "version": "0.4.0",
4
4
  "description": "TypeScript SDK and CLI for Codex Security",
5
5
  "license": "Apache-2.0",
6
6
  "author": "OpenAI",
@@ -28,10 +28,12 @@
28
28
  "import": "./dist/index.js",
29
29
  "default": "./dist/index.js"
30
30
  },
31
- "./schemas/project-config.schema.json": "./schemas/project-config.schema.json"
31
+ "./schemas/project-config.schema.json": "./schemas/project-config.schema.json",
32
+ "./schemas/hosted-scan-v2.fixture.json": "./schemas/hosted-scan-v2.fixture.json"
32
33
  },
33
34
  "bin": {
34
- "codex-security": "./bin/codex-security.mjs"
35
+ "codex-security": "./bin/codex-security.mjs",
36
+ "cs": "./bin/codex-security.mjs"
35
37
  },
36
38
  "files": [
37
39
  "bin",
@@ -40,7 +42,10 @@
40
42
  "_bundled_plugin",
41
43
  "LICENSE",
42
44
  "README.md",
43
- "docs/dedupe-records.md"
45
+ "docs/cli.md",
46
+ "docs/findings-service.md",
47
+ "docs/dedupe-records.md",
48
+ "docs/hosted-scans.md"
44
49
  ],
45
50
  "publishConfig": {
46
51
  "access": "public",
@@ -49,64 +54,60 @@
49
54
  ]
50
55
  },
51
56
  "dependencies": {
52
- "@inquirer/prompts": "8.7.2",
53
- "@linear/sdk": "97.0.0",
57
+ "@inquirer/prompts": "8.7.3",
58
+ "@linear/sdk": "97.1.0",
54
59
  "@octokit/core": "7.0.8",
55
- "@openai/codex": "0.162.0-alpha.15",
56
- "@openai/codex-sdk": "0.162.0-alpha.15",
60
+ "@openai/codex": "0.163.0",
61
+ "@openai/codex-sdk": "0.163.0",
57
62
  "ajv": "8.20.0",
58
63
  "fflate": "0.8.3",
59
- "incur": "0.5.1",
60
- "ink": "7.1.1",
64
+ "incur": "0.7.0",
65
+ "ink": "8.0.0",
61
66
  "js-tiktoken": "1.0.21",
62
67
  "papaparse": "5.7.0",
63
- "pdfjs-dist": "6.3.289",
68
+ "pdfjs-dist": "6.4.299",
64
69
  "react": "19.3.0",
65
70
  "semver": "7.8.5",
66
71
  "smol-toml": "1.9.0",
72
+ "string-width": "8.3.0",
73
+ "strip-ansi": "7.2.0",
67
74
  "yaml": "2.9.1",
68
75
  "yauzl": "3.4.0",
69
76
  "zod": "4.6.5"
70
77
  },
71
78
  "devDependencies": {
72
- "@openai/apps-sdk-ui": "0.2.2",
73
79
  "@stryker-mutator/core": "10.0.0",
74
- "@tailwindcss/postcss": "4.3.3",
75
80
  "@types/bun": "1.4.2",
76
- "@types/node": "26.6.3",
81
+ "@types/node": "26.6.4",
77
82
  "@types/papaparse": "5.5.2",
78
83
  "@types/react": "19.3.0",
79
- "@types/react-dom": "19.3.0",
80
84
  "@types/semver": "7.8.0",
81
85
  "@types/yauzl": "3.4.0",
82
86
  "esbuild": "0.28.2",
83
87
  "fast-check": "4.10.2",
84
88
  "ink-testing-library": "4.0.0",
85
89
  "json-schema-to-typescript": "16.0.0",
90
+ "json5": "2.2.3",
86
91
  "minimatch": "10.2.6",
87
- "postcss": "8.5.28",
88
92
  "prettier": "3.9.9",
89
- "react-dom": "19.3.0",
90
93
  "saxes": "6.0.0",
91
- "tailwindcss": "4.3.3",
92
94
  "typescript": "7.0.2"
93
95
  },
94
- "gitHead": "4949af70fcfadff154f6e8fdf100faa5bf2f8169",
96
+ "gitHead": "559b492b22bb457aea8ff88c1bd41aacc2cec8bf",
95
97
  "scripts": {
96
98
  "audit:prod": "pnpm audit --prod --audit-level high",
97
99
  "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
98
- "build": "node --run clean && node scripts/generate-deep-defaults.mjs && tsc -p tsconfig.build.json && node scripts/generate-project-config-schema.mjs && node scripts/build-dashboard.mjs",
100
+ "build": "node --run clean && node scripts/generate-deep-defaults.mjs && tsc -p tsconfig.build.json && node scripts/generate-project-config-schema.mjs",
99
101
  "build:ci": "tsc -p tsconfig.ci.json",
100
102
  "build:evals": "node --run build && tsc -p ../../evals/tsconfig.json",
101
103
  "build:examples": "tsc -p tsconfig.examples.json",
102
104
  "build:plugin": "node scripts/build-plugin.mjs",
103
105
  "check:plugin-source": "node scripts/check-plugin-source.mjs",
104
106
  "check:package": "node scripts/check-package.mjs",
105
- "format": "prettier --check --ignore-path .gitignore --ignore-path .prettierignore \"**/*.{cjs,mjs,js,ts,mts,tsx,json,md}\" \"../../.github/scripts/*.mts\" \"../../examples/custom-validation/*.{mts,md}\" \"../../plugins/codex-security/native/*.{mts,md}\" \"../../evals/{deep-reducer,secret-discovery}/*.mts\" \"../../evals/triage-finding/{assertions,scripts,sastbench/assertions,sastbench/scripts}/*.mts\" \"../../evals/triage-finding/types.ts\" \"../../evals/tsconfig.json\"",
107
+ "format": "prettier --check --ignore-path .gitignore --ignore-path .prettierignore \"**/*.{cjs,mjs,js,ts,mts,tsx,json}\" \"../../.github/scripts/*.mts\" \"../../examples/custom-validation/*.mts\" \"../../plugins/codex-security/native/*.mts\" \"../../evals/{deep-reducer,secret-discovery}/*.mts\" \"../../evals/triage-finding/{assertions,scripts,sastbench/assertions,sastbench/scripts}/*.mts\" \"../../evals/triage-finding/types.ts\" \"../../evals/tsconfig.json\" && node scripts/check-markdown.mjs",
106
108
  "generate:models": "node scripts/generate-models.cjs",
107
109
  "generate:models:check": "node scripts/generate-models.cjs --check",
108
110
  "lint": "tsc --noEmit",
109
- "start:server": "node dist/server/index.js",
110
111
  "test": "node --run build:plugin && bun test --timeout 30000 ./tests-ts",
111
112
  "test:ci": "node -e \"require('node:fs').mkdirSync('reports',{recursive:true})\" && pnpm run test --coverage --coverage-reporter=text --coverage-reporter=lcov --reporter=junit --reporter-outfile=reports/junit.xml",
112
113
  "test:mcp": "node --run build:plugin && pnpm --dir ../../plugins/codex-security/mcp-app run test:mcp",
@@ -0,0 +1,145 @@
1
+ {
2
+ "run": {
3
+ "jsonrpc": "2.0",
4
+ "id": "run",
5
+ "method": "run",
6
+ "params": {
7
+ "version": 2,
8
+ "repository": "/workspace/repository",
9
+ "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
10
+ "scope": {
11
+ "paths": ["service-a", "service-b"]
12
+ },
13
+ "outputDirectory": "/scan/output",
14
+ "stateDirectory": "/scan/state",
15
+ "model": "fixture-model",
16
+ "reasoningEffort": "medium",
17
+ "identity": {
18
+ "runId": "run-1",
19
+ "attemptId": "attempt-1",
20
+ "buildId": "fixture-build"
21
+ }
22
+ }
23
+ },
24
+ "execution": {
25
+ "jsonrpc": "2.0",
26
+ "id": "request-1",
27
+ "method": "execution.run",
28
+ "params": {
29
+ "version": 2,
30
+ "repository": "/workspace/repository",
31
+ "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
32
+ "scope": {
33
+ "paths": ["service-a", "service-b"]
34
+ },
35
+ "identity": {
36
+ "runId": "run-1",
37
+ "attemptId": "attempt-1",
38
+ "buildId": "fixture-build"
39
+ },
40
+ "model": "fixture-model",
41
+ "reasoningEffort": "medium",
42
+ "requestId": "request-1",
43
+ "scanId": "scan-1",
44
+ "prompt": "Scan the selected paths.",
45
+ "runtime": {
46
+ "pluginRoot": "/opt/runtime/cli/_bundled_plugin",
47
+ "pluginVersion": "0.1.95",
48
+ "stateDirectory": "/scan/state",
49
+ "outputDirectory": "/scan/output",
50
+ "environment": {
51
+ "CODEX_SECURITY_STATE_DIR": "/scan/state",
52
+ "CODEX_SECURITY_CONFIG_PATH": "/scan/tmp/config-preflight.toml",
53
+ "CODEX_SECURITY_TARGET_PATHS_FILE": "/scan/tmp/target-paths.json"
54
+ }
55
+ }
56
+ }
57
+ },
58
+ "progress": {
59
+ "jsonrpc": "2.0",
60
+ "method": "execution.progress",
61
+ "params": {
62
+ "requestId": "request-1",
63
+ "event": {
64
+ "type": "progress",
65
+ "progress": {
66
+ "phase": "discovery",
67
+ "filesCompleted": 1,
68
+ "filesTotal": 2
69
+ }
70
+ }
71
+ }
72
+ },
73
+ "response": {
74
+ "jsonrpc": "2.0",
75
+ "id": "request-1",
76
+ "result": {
77
+ "requestId": "request-1",
78
+ "status": "completed",
79
+ "sessionId": "session-1",
80
+ "usage": {
81
+ "input_tokens": 12,
82
+ "output_tokens": 6,
83
+ "cached_input_tokens": 0
84
+ }
85
+ }
86
+ },
87
+ "terminal": {
88
+ "jsonrpc": "2.0",
89
+ "id": "run",
90
+ "result": {
91
+ "version": 2,
92
+ "repository": "/workspace/repository",
93
+ "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
94
+ "scope": {
95
+ "paths": ["service-a", "service-b"]
96
+ },
97
+ "identity": {
98
+ "runId": "run-1",
99
+ "attemptId": "attempt-1",
100
+ "buildId": "fixture-build"
101
+ },
102
+ "outputDirectory": "/scan/output",
103
+ "status": "completed",
104
+ "scanId": "scan-1",
105
+ "pluginVersion": "0.1.95",
106
+ "provenance": {
107
+ "cliVersion": "0.2.0",
108
+ "pluginVersion": "0.1.95",
109
+ "buildId": "fixture-build"
110
+ },
111
+ "execution": {
112
+ "requestId": "request-1",
113
+ "status": "completed",
114
+ "sessionId": "session-1",
115
+ "usage": {
116
+ "input_tokens": 12,
117
+ "output_tokens": 6,
118
+ "cached_input_tokens": 0
119
+ }
120
+ },
121
+ "artifacts": [
122
+ {
123
+ "path": "scan-manifest.json",
124
+ "sha256": "1111111111111111111111111111111111111111111111111111111111111111",
125
+ "bytes": 1024
126
+ },
127
+ {
128
+ "path": "findings.json",
129
+ "sha256": "2222222222222222222222222222222222222222222222222222222222222222",
130
+ "bytes": 256
131
+ },
132
+ {
133
+ "path": "coverage.json",
134
+ "sha256": "3333333333333333333333333333333333333333333333333333333333333333",
135
+ "bytes": 512
136
+ },
137
+ {
138
+ "path": "report.md",
139
+ "sha256": "4444444444444444444444444444444444444444444444444444444444444444",
140
+ "bytes": 768
141
+ }
142
+ ]
143
+ }
144
+ }
145
+ }
@@ -1,18 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "codex-security://schemas/tools/worker-threat-model.schema.json",
4
- "$defs": {
5
- "recordWorkerThreatModelInput": {
6
- "type": "object",
7
- "properties": {
8
- "content": {
9
- "type": "string",
10
- "minLength": 1,
11
- "pattern": "\\S"
12
- }
13
- },
14
- "required": ["content"],
15
- "additionalProperties": false
16
- }
17
- }
18
- }
@@ -1,159 +0,0 @@
1
- """Read-only dashboard projections for stored findings and duplicate groups."""
2
-
3
- from __future__ import annotations
4
-
5
- import argparse
6
- import json
7
- import sqlite3
8
- import sys
9
- from pathlib import Path
10
- from typing import Any
11
-
12
- sys.path.insert(0, str(Path(__file__).resolve().parent))
13
- from workbench_findings import list_dedupe_groups
14
-
15
- FINDING_RECORDS = """
16
- SELECT findings.id, json_extract(details_json, '$.title') AS title,
17
- COALESCE(repositories.ids, '[]') AS repositoryIds,
18
- json_extract(details_json, '$.severity.level') AS severity,
19
- findings.created_at AS createdAt, findings.updated_at AS updatedAt
20
- FROM findings LEFT JOIN (
21
- SELECT finding_id, json_group_array(repository_id) AS ids
22
- FROM finding_repositories GROUP BY finding_id
23
- ) AS repositories ON repositories.finding_id = findings.id
24
- WHERE details_json IS NOT NULL
25
- """
26
-
27
- GROUP_RECORDS = """
28
- SELECT groups.id, groups.id AS title,
29
- (SELECT json_group_array(DISTINCT repository_id)
30
- FROM finding_dedupe_group_members AS members
31
- JOIN finding_repositories ON finding_repositories.finding_id = members.finding_id
32
- WHERE members.group_id = groups.id) AS repositoryIds,
33
- groups.created_at AS createdAt, groups.created_at AS updatedAt,
34
- (SELECT COUNT(*) FROM finding_dedupe_group_members WHERE group_id = groups.id) AS memberCount
35
- FROM finding_dedupe_groups AS groups
36
- """
37
-
38
- RECORDS = {
39
- "findings": FINDING_RECORDS,
40
- "groups": GROUP_RECORDS,
41
- }
42
-
43
- SORT_COLUMNS = {
44
- "activity": "updatedAt",
45
- "newest": "createdAt",
46
- "title": "casefold(title)",
47
- "repository": "casefold(repository_label(repositoryIds))",
48
- "severity": "CASE severity WHEN 'informational' THEN 0 WHEN 'low' THEN 1 "
49
- "WHEN 'medium' THEN 2 WHEN 'high' THEN 3 WHEN 'critical' THEN 4 END",
50
- "members": "memberCount",
51
- }
52
-
53
-
54
- def repository_ids(value: str) -> list[str]:
55
- return sorted(json.loads(value), key=lambda name: (name.casefold(), name))
56
-
57
-
58
- def item(row: sqlite3.Row) -> dict[str, Any]:
59
- result = dict(row)
60
- result["repositoryIds"] = repository_ids(result["repositoryIds"])
61
- return result
62
-
63
-
64
- def detail(connection: sqlite3.Connection, view: str, selected: dict[str, Any]) -> dict[str, Any]:
65
- result: dict[str, Any] = {"item": selected}
66
- selected_id = selected["id"]
67
- if view == "findings":
68
- result["finding"] = json.loads(
69
- connection.execute(
70
- "SELECT details_json FROM findings WHERE id = ?",
71
- (selected_id,),
72
- ).fetchone()[0]
73
- )
74
- result["groups"] = list_dedupe_groups(connection, selected_id)["groups"]
75
- else:
76
- result["group"] = {
77
- "groupId": selected_id,
78
- "createdAt": selected["createdAt"],
79
- "findingIds": [
80
- r[0]
81
- for r in connection.execute(
82
- "SELECT finding_id FROM finding_dedupe_group_members WHERE group_id = ? ORDER BY finding_id",
83
- (selected_id,),
84
- )
85
- ],
86
- }
87
- return result
88
-
89
-
90
- def dashboard(connection: sqlite3.Connection, query: dict[str, Any]) -> dict[str, Any]:
91
- """One snapshot, no artifact reads, model calls, or writes."""
92
- view = query["view"]
93
- records = RECORDS[view]
94
- connection.create_function("casefold", 1, str.casefold, deterministic=True)
95
- connection.create_function(
96
- "repository_label", 1, lambda value: ", ".join(repository_ids(value)), deterministic=True
97
- )
98
- clauses: list[str] = []
99
- values: list[Any] = []
100
- if query.get("query"):
101
- columns = ["id", "title", "repositoryIds"]
102
- clauses.append(
103
- "("
104
- + " OR ".join(f"instr(casefold(COALESCE({c}, '')), casefold(?)) > 0" for c in columns)
105
- + ")"
106
- )
107
- values.extend([query["query"]] * len(columns))
108
- if query.get("repository"):
109
- clauses.append("EXISTS (SELECT 1 FROM json_each(repositoryIds) WHERE value = ?)")
110
- values.append(query["repository"])
111
- where = " WHERE " + " AND ".join(clauses) if clauses else ""
112
- direction = {"asc": "ASC", "desc": "DESC"}[query.get("direction", "desc")]
113
- order = f"{SORT_COLUMNS[query['sort']]} {direction}"
114
- if view == "findings" and query["sort"] == "activity":
115
- order += f", {SORT_COLUMNS['severity']} DESC"
116
- order += ", id"
117
- connection.execute("BEGIN")
118
- with connection:
119
- repositories = connection.execute("""
120
- SELECT DISTINCT repository_id AS id, repository_id AS label
121
- FROM finding_repositories ORDER BY repository_id
122
- """).fetchall()
123
- total = connection.execute(f"SELECT COUNT(*) FROM ({records}) {where}", values).fetchone()[
124
- 0
125
- ]
126
- rows = connection.execute(
127
- f"SELECT * FROM ({records}) {where} ORDER BY {order} LIMIT ? OFFSET ?",
128
- (*values, query["limit"], query["offset"]),
129
- ).fetchall()
130
- selected = (
131
- connection.execute(
132
- f"SELECT * FROM ({records}) WHERE id = ?",
133
- (query["id"],),
134
- ).fetchone()
135
- if query.get("id")
136
- else None
137
- )
138
- next_offset = query["offset"] + len(rows)
139
- return {
140
- "overview": {
141
- "findings": connection.execute(
142
- "SELECT COUNT(*) FROM findings WHERE details_json IS NOT NULL"
143
- ).fetchone()[0],
144
- "groups": connection.execute(
145
- "SELECT COUNT(*) FROM finding_dedupe_groups"
146
- ).fetchone()[0],
147
- },
148
- "repositories": [dict(row) for row in repositories],
149
- "items": [item(row) for row in rows],
150
- "total": total,
151
- "limit": query["limit"],
152
- "offset": query["offset"],
153
- "nextOffset": next_offset if next_offset < total else None,
154
- "detail": detail(connection, view, item(selected)) if selected is not None else None,
155
- }
156
-
157
-
158
- if __name__ == "__main__":
159
- argparse.ArgumentParser(description=__doc__).parse_args()
@@ -1,221 +0,0 @@
1
- """Storage operations for complete findings imported without a scan."""
2
-
3
- from __future__ import annotations
4
-
5
- import argparse
6
- import hashlib
7
- import json
8
- import math
9
- import sqlite3
10
- import sys
11
- from pathlib import Path
12
- from typing import Any
13
-
14
- sys.path.insert(0, str(Path(__file__).resolve().parent))
15
- from workbench_finding_index import upsert_finding
16
-
17
-
18
- def store_findings(
19
- connection: sqlite3.Connection,
20
- entries: list[dict[str, Any]],
21
- timestamp: str,
22
- repository_id: str | None = None,
23
- ) -> dict[str, Any]:
24
- try:
25
- with connection:
26
- connection.execute("BEGIN IMMEDIATE")
27
- for entry in entries:
28
- finding = entry["finding"]
29
- embedding = entry["embedding"]
30
- identity = (
31
- finding["fingerprints"]["primary"],
32
- finding["ruleId"],
33
- finding["identity"]["anchor"],
34
- finding["identity"].get("instance"),
35
- )
36
- current = connection.execute(
37
- "SELECT fingerprint, rule_id, identity_anchor, identity_instance "
38
- "FROM findings WHERE id = ?",
39
- (finding["findingId"],),
40
- ).fetchone()
41
- if current is not None and tuple(current) != identity:
42
- raise sqlite3.IntegrityError("The stored finding identity cannot be replaced.")
43
- upsert_finding(connection, finding, timestamp, repository_id)
44
- connection.execute(
45
- """
46
- INSERT INTO finding_embeddings (finding_id, model, vector_json)
47
- VALUES (?, ?, ?)
48
- ON CONFLICT(finding_id) DO UPDATE SET
49
- model = excluded.model, vector_json = excluded.vector_json
50
- """,
51
- (
52
- finding["findingId"],
53
- embedding["model"],
54
- json.dumps(embedding["vector"], allow_nan=False),
55
- ),
56
- )
57
- except sqlite3.IntegrityError:
58
- return {"error": "finding_conflict"}
59
- return {"findingIds": [entry["finding"]["findingId"] for entry in entries]}
60
-
61
-
62
- def list_stored_findings(
63
- connection: sqlite3.Connection, *, limit: int, offset: int
64
- ) -> dict[str, Any]:
65
- connection.execute("BEGIN")
66
- with connection:
67
- total = connection.execute(
68
- "SELECT COUNT(*) FROM findings WHERE details_json IS NOT NULL"
69
- ).fetchone()[0]
70
- rows = connection.execute(
71
- """
72
- SELECT details_json FROM findings WHERE details_json IS NOT NULL
73
- ORDER BY created_at, id LIMIT ? OFFSET ?
74
- """,
75
- (limit, offset),
76
- ).fetchall()
77
- next_offset = offset + len(rows)
78
- return {
79
- "findings": [json.loads(row["details_json"]) for row in rows],
80
- "limit": limit,
81
- "offset": offset,
82
- "total": total,
83
- "nextOffset": next_offset if next_offset < total else None,
84
- }
85
-
86
-
87
- def find_potential_duplicates(
88
- connection: sqlite3.Connection, finding_id: str, repository_id: str | None
89
- ) -> dict[str, Any]:
90
- """Rank IDs and vectors in the requested scope before loading finding documents."""
91
- connection.execute("BEGIN")
92
- with connection:
93
- if repository_id is None:
94
- source = "finding_embeddings AS embeddings"
95
- predicate = ""
96
- scope_parameters: tuple[str, ...] = ()
97
- else:
98
- source = (
99
- "finding_repositories AS repositories JOIN finding_embeddings AS embeddings "
100
- "ON embeddings.finding_id = repositories.finding_id"
101
- )
102
- predicate = "repositories.repository_id = ? AND "
103
- scope_parameters = (repository_id,)
104
- anchor = connection.execute(
105
- f"SELECT embeddings.model, embeddings.vector_json FROM {source} "
106
- f"WHERE {predicate}embeddings.finding_id = ?",
107
- (*scope_parameters, finding_id),
108
- ).fetchone()
109
- if anchor is None:
110
- return {"error": "finding_not_indexed"}
111
- rows = connection.execute(
112
- f"SELECT embeddings.finding_id, embeddings.vector_json FROM {source} "
113
- "JOIN findings ON findings.id = embeddings.finding_id "
114
- f"WHERE {predicate}embeddings.model = ? AND embeddings.finding_id != ? "
115
- "ORDER BY findings.created_at, findings.id",
116
- (*scope_parameters, anchor["model"], finding_id),
117
- )
118
- ranked: list[tuple[str, float]] = []
119
- try:
120
- vector = normalized_vector(json.loads(anchor["vector_json"]))
121
- for row in rows:
122
- candidate = json.loads(row["vector_json"])
123
- if len(candidate) != len(vector):
124
- continue
125
- other = normalized_vector(candidate)
126
- similarity = sum(left * right for left, right in zip(vector, other))
127
- if similarity >= 0.55:
128
- ranked.append((row["finding_id"], similarity))
129
- except ValueError:
130
- return {"error": "embedding_failed"}
131
- # Stable sorting retains insertion-time / finding-ID order for ties.
132
- ranked.sort(key=lambda candidate: candidate[1], reverse=True)
133
- selected_ids = [finding_id, *(candidate[0] for candidate in ranked[:50])]
134
- documents = {
135
- row["id"]: json.loads(row["details_json"])
136
- for row in connection.execute(
137
- "SELECT id, details_json FROM findings WHERE id IN ("
138
- + ",".join("?" for _ in selected_ids)
139
- + ")",
140
- selected_ids,
141
- )
142
- }
143
- return {
144
- "finding": documents[finding_id],
145
- "potentialDuplicates": [documents[id] for id in selected_ids[1:]],
146
- }
147
-
148
-
149
- def store_dedupe_groups(
150
- connection: sqlite3.Connection, groups: list[list[str]], timestamp: str
151
- ) -> dict[str, Any]:
152
- """Persist reviewed sets independently, including overlapping groups, in one transaction."""
153
- stored: dict[str, dict[str, Any]] = {}
154
- try:
155
- with connection:
156
- connection.execute("BEGIN IMMEDIATE")
157
- for group in groups:
158
- members = sorted(set(group))
159
- # Membership, not input order, identifies a group on retries.
160
- group_id = (
161
- "fdg_"
162
- + hashlib.sha256(
163
- json.dumps(members, ensure_ascii=True, separators=(",", ":")).encode(
164
- "utf-8"
165
- )
166
- ).hexdigest()
167
- )
168
- connection.execute(
169
- "INSERT INTO finding_dedupe_groups (id, created_at) VALUES (?, ?) "
170
- "ON CONFLICT(id) DO NOTHING",
171
- (group_id, timestamp),
172
- )
173
- connection.executemany(
174
- "INSERT INTO finding_dedupe_group_members (group_id, finding_id) VALUES (?, ?) "
175
- "ON CONFLICT(group_id, finding_id) DO NOTHING",
176
- ((group_id, finding_id) for finding_id in members),
177
- )
178
- created_at = connection.execute(
179
- "SELECT created_at FROM finding_dedupe_groups WHERE id = ?", (group_id,)
180
- ).fetchone()[0]
181
- stored[group_id] = {
182
- "groupId": group_id,
183
- "findingIds": members,
184
- "createdAt": created_at,
185
- }
186
- except sqlite3.IntegrityError:
187
- return {"error": "finding_conflict"}
188
- return {"groups": list(stored.values())}
189
-
190
-
191
- def list_dedupe_groups(connection: sqlite3.Connection, finding_id: str) -> dict[str, Any]:
192
- groups: dict[str, dict[str, Any]] = {}
193
- rows = connection.execute(
194
- """
195
- SELECT groups.id, groups.created_at, members.finding_id
196
- FROM finding_dedupe_group_members AS matched
197
- JOIN finding_dedupe_groups AS groups ON groups.id = matched.group_id
198
- JOIN finding_dedupe_group_members AS members ON members.group_id = groups.id
199
- WHERE matched.finding_id = ?
200
- ORDER BY groups.created_at, groups.id, members.finding_id
201
- """,
202
- (finding_id,),
203
- )
204
- for row in rows:
205
- group = groups.setdefault(
206
- row["id"],
207
- {"groupId": row["id"], "findingIds": [], "createdAt": row["created_at"]},
208
- )
209
- group["findingIds"].append(row["finding_id"])
210
- return {"groups": list(groups.values())}
211
-
212
-
213
- def normalized_vector(vector: list[float]) -> list[float]:
214
- norm = math.hypot(*vector)
215
- if norm == 0 or not math.isfinite(norm):
216
- raise ValueError("A stored embedding cannot be compared.")
217
- return [value / norm for value in vector]
218
-
219
-
220
- if __name__ == "__main__":
221
- argparse.ArgumentParser(description=__doc__).parse_args()