@openai/codex-security 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (484) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +4 -0
  4. package/_bundled_plugin/.mcp.json +2 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +556 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +2 -2
  25. package/_bundled_plugin/references/config-preflight.md +0 -4
  26. package/_bundled_plugin/references/core-scan.md +21 -9
  27. package/_bundled_plugin/references/final-report.md +11 -13
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +1 -2
  31. package/_bundled_plugin/references/scan-contract.md +9 -4
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +1 -1
  36. package/_bundled_plugin/schemas/coverage.schema.json +43 -170
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +159 -567
  40. package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
  41. package/_bundled_plugin/schemas/scan-manifest.schema.json +78 -220
  42. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  43. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  44. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  45. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  46. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  47. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  48. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  49. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  50. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  51. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  52. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +321 -237
  54. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  56. package/_bundled_plugin/scripts/generate_rank_input.py +115 -926
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  60. package/_bundled_plugin/scripts/report_projection.py +150 -183
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  63. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  64. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  65. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  66. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  67. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  68. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +102 -184
  70. package/_bundled_plugin/scripts/workbench_db.py +463 -464
  71. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  74. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  75. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  76. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  77. package/_bundled_plugin/scripts/workbench_publication.py +234 -289
  78. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  79. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  80. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  81. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  82. package/_bundled_plugin/scripts/workbench_scan_usage.py +194 -42
  83. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  85. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  86. package/_bundled_plugin/scripts/workbench_validation.py +31 -28
  87. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  88. package/_bundled_plugin/shared/workbench-migrations.json +414 -0
  89. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  90. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  92. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  93. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  94. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  95. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  96. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  97. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  98. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  99. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +15 -1
  100. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  101. package/_bundled_plugin/skills/track-findings/SKILL.md +48 -176
  102. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  103. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  104. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  105. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  106. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  107. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  108. package/bin/codex-security.mjs +9 -2
  109. package/dist/api.d.ts +63 -10
  110. package/dist/api.d.ts.map +1 -1
  111. package/dist/api.js +1015 -383
  112. package/dist/api.js.map +1 -1
  113. package/dist/artifact-export.d.ts +1 -1
  114. package/dist/artifact-export.d.ts.map +1 -1
  115. package/dist/artifact-export.js +28 -13
  116. package/dist/artifact-export.js.map +1 -1
  117. package/dist/auth.d.ts +2 -6
  118. package/dist/auth.d.ts.map +1 -1
  119. package/dist/auth.js +19 -9
  120. package/dist/auth.js.map +1 -1
  121. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  122. package/dist/bulk-scan-discovery.js +1 -0
  123. package/dist/bulk-scan-discovery.js.map +1 -1
  124. package/dist/classify-severity.d.ts +26 -9
  125. package/dist/classify-severity.d.ts.map +1 -1
  126. package/dist/classify-severity.js +13 -30
  127. package/dist/classify-severity.js.map +1 -1
  128. package/dist/cli-help.d.ts.map +1 -1
  129. package/dist/cli-help.js +17 -13
  130. package/dist/cli-help.js.map +1 -1
  131. package/dist/cli-signals.d.ts +8 -0
  132. package/dist/cli-signals.d.ts.map +1 -0
  133. package/dist/cli-signals.js +28 -0
  134. package/dist/cli-signals.js.map +1 -0
  135. package/dist/cli.d.ts +4 -3
  136. package/dist/cli.d.ts.map +1 -1
  137. package/dist/cli.js +1102 -905
  138. package/dist/cli.js.map +1 -1
  139. package/dist/cloud-publish.d.ts.map +1 -1
  140. package/dist/cloud-publish.js +10 -9
  141. package/dist/cloud-publish.js.map +1 -1
  142. package/dist/codeowners.d.ts +19 -0
  143. package/dist/codeowners.d.ts.map +1 -0
  144. package/dist/codeowners.js +138 -0
  145. package/dist/codeowners.js.map +1 -0
  146. package/dist/codex-sdk-environment.d.ts +1 -0
  147. package/dist/codex-sdk-environment.d.ts.map +1 -1
  148. package/dist/codex-sdk-environment.js +40 -2
  149. package/dist/codex-sdk-environment.js.map +1 -1
  150. package/dist/component-plan.d.ts +2 -5
  151. package/dist/component-plan.d.ts.map +1 -1
  152. package/dist/component-plan.js +39 -31
  153. package/dist/component-plan.js.map +1 -1
  154. package/dist/component-scan.d.ts +6 -5
  155. package/dist/component-scan.d.ts.map +1 -1
  156. package/dist/component-scan.js +25 -36
  157. package/dist/component-scan.js.map +1 -1
  158. package/dist/config.d.ts.map +1 -1
  159. package/dist/config.js +64 -74
  160. package/dist/config.js.map +1 -1
  161. package/dist/contract.d.ts +16 -3
  162. package/dist/contract.d.ts.map +1 -1
  163. package/dist/contract.js +91 -255
  164. package/dist/contract.js.map +1 -1
  165. package/dist/cost-model.d.ts +13 -6
  166. package/dist/cost-model.d.ts.map +1 -1
  167. package/dist/cost-model.js +14 -4
  168. package/dist/cost-model.js.map +1 -1
  169. package/dist/cost.d.ts +10 -2
  170. package/dist/cost.d.ts.map +1 -1
  171. package/dist/cost.js +102 -104
  172. package/dist/cost.js.map +1 -1
  173. package/dist/custom-validation-prompt.d.ts.map +1 -1
  174. package/dist/custom-validation-prompt.js +6 -5
  175. package/dist/custom-validation-prompt.js.map +1 -1
  176. package/dist/custom-validation.d.ts +1 -2
  177. package/dist/custom-validation.d.ts.map +1 -1
  178. package/dist/custom-validation.js +9 -3
  179. package/dist/custom-validation.js.map +1 -1
  180. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  181. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  182. package/dist/deduplication/checkpointed-review.js +23 -9
  183. package/dist/deduplication/checkpointed-review.js.map +1 -1
  184. package/dist/deduplication/codex-review.d.ts +8 -6
  185. package/dist/deduplication/codex-review.d.ts.map +1 -1
  186. package/dist/deduplication/codex-review.js +128 -19
  187. package/dist/deduplication/codex-review.js.map +1 -1
  188. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  189. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  190. package/dist/deduplication/deduplication-prompts.js +18 -4
  191. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  192. package/dist/deduplication/deduplication-reviewer.d.ts +27 -5
  193. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  194. package/dist/deduplication/deduplication-reviewer.js +58 -48
  195. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  196. package/dist/deduplication/deduplication.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication.js +19 -51
  198. package/dist/deduplication/deduplication.js.map +1 -1
  199. package/dist/deduplication/diagnostics.d.ts +17 -0
  200. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  201. package/dist/deduplication/diagnostics.js +5 -0
  202. package/dist/deduplication/diagnostics.js.map +1 -0
  203. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  204. package/dist/deduplication/finding-schema.js +7 -1
  205. package/dist/deduplication/finding-schema.js.map +1 -1
  206. package/dist/deduplication/local.d.ts +31 -0
  207. package/dist/deduplication/local.d.ts.map +1 -0
  208. package/dist/deduplication/local.js +166 -0
  209. package/dist/deduplication/local.js.map +1 -0
  210. package/dist/deduplication/records-protocol.d.ts +3 -8
  211. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  212. package/dist/deduplication/records-protocol.js +11 -184
  213. package/dist/deduplication/records-protocol.js.map +1 -1
  214. package/dist/deduplication/records.d.ts +186 -11
  215. package/dist/deduplication/records.d.ts.map +1 -1
  216. package/dist/deduplication/records.js +10 -18
  217. package/dist/deduplication/records.js.map +1 -1
  218. package/dist/deduplication/scan.d.ts +9 -3
  219. package/dist/deduplication/scan.d.ts.map +1 -1
  220. package/dist/deduplication/scan.js +158 -39
  221. package/dist/deduplication/scan.js.map +1 -1
  222. package/dist/deep-config.d.ts +2 -1
  223. package/dist/deep-config.d.ts.map +1 -1
  224. package/dist/deep-config.js +4 -4
  225. package/dist/deep-config.js.map +1 -1
  226. package/dist/deep-progress.d.ts +17 -1
  227. package/dist/deep-progress.d.ts.map +1 -1
  228. package/dist/deep-progress.js +19 -17
  229. package/dist/deep-progress.js.map +1 -1
  230. package/dist/deep-scan.d.ts +20 -0
  231. package/dist/deep-scan.d.ts.map +1 -0
  232. package/dist/deep-scan.js +113 -0
  233. package/dist/deep-scan.js.map +1 -0
  234. package/dist/errors.d.ts +2 -0
  235. package/dist/errors.d.ts.map +1 -1
  236. package/dist/errors.js +2 -0
  237. package/dist/errors.js.map +1 -1
  238. package/dist/executable-path.d.ts +2 -0
  239. package/dist/executable-path.d.ts.map +1 -0
  240. package/dist/executable-path.js +12 -0
  241. package/dist/executable-path.js.map +1 -0
  242. package/dist/feedback.d.ts +1 -4
  243. package/dist/feedback.d.ts.map +1 -1
  244. package/dist/feedback.js +54 -22
  245. package/dist/feedback.js.map +1 -1
  246. package/dist/finding-catalogue.d.ts.map +1 -1
  247. package/dist/finding-catalogue.js +4 -8
  248. package/dist/finding-catalogue.js.map +1 -1
  249. package/dist/finding-normalization.d.ts +5 -0
  250. package/dist/finding-normalization.d.ts.map +1 -0
  251. package/dist/finding-normalization.js +120 -0
  252. package/dist/finding-normalization.js.map +1 -0
  253. package/dist/finding-retrieval.d.ts +9 -0
  254. package/dist/finding-retrieval.d.ts.map +1 -1
  255. package/dist/finding-retrieval.js.map +1 -1
  256. package/dist/finding-workflow.d.ts +13 -8
  257. package/dist/finding-workflow.d.ts.map +1 -1
  258. package/dist/finding-workflow.js +14 -6
  259. package/dist/finding-workflow.js.map +1 -1
  260. package/dist/findings-client.d.ts +2 -1
  261. package/dist/findings-client.d.ts.map +1 -1
  262. package/dist/findings-client.js +36 -9
  263. package/dist/findings-client.js.map +1 -1
  264. package/dist/findings-errors.d.ts +16 -0
  265. package/dist/findings-errors.d.ts.map +1 -0
  266. package/dist/findings-errors.js +24 -0
  267. package/dist/findings-errors.js.map +1 -0
  268. package/dist/findings-import.d.ts +1 -1
  269. package/dist/findings-import.d.ts.map +1 -1
  270. package/dist/findings-import.js +12 -30
  271. package/dist/findings-import.js.map +1 -1
  272. package/dist/github.d.ts.map +1 -1
  273. package/dist/github.js +7 -1
  274. package/dist/github.js.map +1 -1
  275. package/dist/host-protocol.d.ts +19 -0
  276. package/dist/host-protocol.d.ts.map +1 -0
  277. package/dist/host-protocol.js +270 -0
  278. package/dist/host-protocol.js.map +1 -0
  279. package/dist/hosted-scan-protocol.d.ts +4 -0
  280. package/dist/hosted-scan-protocol.d.ts.map +1 -0
  281. package/dist/hosted-scan-protocol.js +25 -0
  282. package/dist/hosted-scan-protocol.js.map +1 -0
  283. package/dist/hosted-scan.d.ts +117 -0
  284. package/dist/hosted-scan.d.ts.map +1 -0
  285. package/dist/hosted-scan.js +260 -0
  286. package/dist/hosted-scan.js.map +1 -0
  287. package/dist/import-scan.d.ts.map +1 -1
  288. package/dist/import-scan.js +48 -38
  289. package/dist/import-scan.js.map +1 -1
  290. package/dist/index.d.ts +11 -4
  291. package/dist/index.d.ts.map +1 -1
  292. package/dist/index.js +2 -1
  293. package/dist/index.js.map +1 -1
  294. package/dist/knowledge-base.d.ts +7 -1
  295. package/dist/knowledge-base.d.ts.map +1 -1
  296. package/dist/knowledge-base.js +114 -46
  297. package/dist/knowledge-base.js.map +1 -1
  298. package/dist/linear.d.ts.map +1 -1
  299. package/dist/linear.js +2 -7
  300. package/dist/linear.js.map +1 -1
  301. package/dist/mock-scan.d.ts.map +1 -1
  302. package/dist/mock-scan.js +0 -1
  303. package/dist/mock-scan.js.map +1 -1
  304. package/dist/models.d.ts +0 -2
  305. package/dist/models.d.ts.map +1 -1
  306. package/dist/models.js.map +1 -1
  307. package/dist/multiscan.d.ts +9 -3
  308. package/dist/multiscan.d.ts.map +1 -1
  309. package/dist/multiscan.js +240 -135
  310. package/dist/multiscan.js.map +1 -1
  311. package/dist/owner-evidence.d.ts +10 -2
  312. package/dist/owner-evidence.d.ts.map +1 -1
  313. package/dist/owner-evidence.js +67 -8
  314. package/dist/owner-evidence.js.map +1 -1
  315. package/dist/patch-tui.d.ts.map +1 -1
  316. package/dist/patch-tui.js +3 -2
  317. package/dist/patch-tui.js.map +1 -1
  318. package/dist/project-config.js +3 -3
  319. package/dist/project-config.js.map +1 -1
  320. package/dist/provider-profile.d.ts +21 -0
  321. package/dist/provider-profile.d.ts.map +1 -0
  322. package/dist/provider-profile.js +133 -0
  323. package/dist/provider-profile.js.map +1 -0
  324. package/dist/publication-events.d.ts +6 -8
  325. package/dist/publication-events.d.ts.map +1 -1
  326. package/dist/publication-events.js +25 -50
  327. package/dist/publication-events.js.map +1 -1
  328. package/dist/publication-store.d.ts.map +1 -1
  329. package/dist/publication-store.js +95 -109
  330. package/dist/publication-store.js.map +1 -1
  331. package/dist/publication.d.ts +1 -4
  332. package/dist/publication.d.ts.map +1 -1
  333. package/dist/publication.js +2 -13
  334. package/dist/publication.js.map +1 -1
  335. package/dist/publish.d.ts +1 -5
  336. package/dist/publish.d.ts.map +1 -1
  337. package/dist/publish.js +109 -160
  338. package/dist/publish.js.map +1 -1
  339. package/dist/request-metadata.d.ts +9 -0
  340. package/dist/request-metadata.d.ts.map +1 -0
  341. package/dist/request-metadata.js +13 -0
  342. package/dist/request-metadata.js.map +1 -0
  343. package/dist/runtime.d.ts +20 -6
  344. package/dist/runtime.d.ts.map +1 -1
  345. package/dist/runtime.js +407 -148
  346. package/dist/runtime.js.map +1 -1
  347. package/dist/saved-scan-bootstrap.d.ts +14 -0
  348. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  349. package/dist/saved-scan-bootstrap.js +261 -0
  350. package/dist/saved-scan-bootstrap.js.map +1 -0
  351. package/dist/saved-scan.d.ts +1 -1
  352. package/dist/saved-scan.d.ts.map +1 -1
  353. package/dist/saved-scan.js +6 -12
  354. package/dist/saved-scan.js.map +1 -1
  355. package/dist/scan-activity.js +11 -8
  356. package/dist/scan-activity.js.map +1 -1
  357. package/dist/scan-comparison.d.ts +28 -15
  358. package/dist/scan-comparison.d.ts.map +1 -1
  359. package/dist/scan-comparison.js +276 -281
  360. package/dist/scan-comparison.js.map +1 -1
  361. package/dist/scan-dashboard.d.ts +3 -0
  362. package/dist/scan-dashboard.d.ts.map +1 -1
  363. package/dist/scan-dashboard.js +345 -77
  364. package/dist/scan-dashboard.js.map +1 -1
  365. package/dist/scan-executor.d.ts +104 -0
  366. package/dist/scan-executor.d.ts.map +1 -0
  367. package/dist/scan-executor.js +62 -0
  368. package/dist/scan-executor.js.map +1 -0
  369. package/dist/scan-history-renderer.d.ts.map +1 -1
  370. package/dist/scan-history-renderer.js +54 -13
  371. package/dist/scan-history-renderer.js.map +1 -1
  372. package/dist/scan-inputs.d.ts +6 -0
  373. package/dist/scan-inputs.d.ts.map +1 -0
  374. package/dist/scan-inputs.js +71 -0
  375. package/dist/scan-inputs.js.map +1 -0
  376. package/dist/scan-logs.d.ts +2 -3
  377. package/dist/scan-logs.d.ts.map +1 -1
  378. package/dist/scan-logs.js +12 -6
  379. package/dist/scan-logs.js.map +1 -1
  380. package/dist/scan-sessions.d.ts +4 -0
  381. package/dist/scan-sessions.d.ts.map +1 -1
  382. package/dist/scan-sessions.js +17 -0
  383. package/dist/scan-sessions.js.map +1 -1
  384. package/dist/scan-skill-paths.d.ts +8 -0
  385. package/dist/scan-skill-paths.d.ts.map +1 -0
  386. package/dist/scan-skill-paths.js +47 -0
  387. package/dist/scan-skill-paths.js.map +1 -0
  388. package/dist/security-policy-cli.d.ts.map +1 -1
  389. package/dist/security-policy-cli.js +7 -27
  390. package/dist/security-policy-cli.js.map +1 -1
  391. package/dist/security-policy.d.ts +9 -5
  392. package/dist/security-policy.d.ts.map +1 -1
  393. package/dist/security-policy.js +33 -14
  394. package/dist/security-policy.js.map +1 -1
  395. package/dist/server/api.d.ts +0 -1
  396. package/dist/server/api.d.ts.map +1 -1
  397. package/dist/server/api.js +0 -1
  398. package/dist/server/api.js.map +1 -1
  399. package/dist/server/embeddings.d.ts +3 -1
  400. package/dist/server/embeddings.d.ts.map +1 -1
  401. package/dist/server/embeddings.js +10 -3
  402. package/dist/server/embeddings.js.map +1 -1
  403. package/dist/server/errors.d.ts +5 -2
  404. package/dist/server/errors.d.ts.map +1 -1
  405. package/dist/server/errors.js +7 -0
  406. package/dist/server/errors.js.map +1 -1
  407. package/dist/server/sqlite-store.d.ts +0 -2
  408. package/dist/server/sqlite-store.d.ts.map +1 -1
  409. package/dist/server/sqlite-store.js +54 -44
  410. package/dist/server/sqlite-store.js.map +1 -1
  411. package/dist/server/storage.d.ts +0 -2
  412. package/dist/server/storage.d.ts.map +1 -1
  413. package/dist/server/storage.js.map +1 -1
  414. package/dist/severity-store.js +19 -24
  415. package/dist/severity-store.js.map +1 -1
  416. package/dist/standalone-validation-prompt.d.ts +2 -0
  417. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  418. package/dist/standalone-validation-prompt.js +10 -0
  419. package/dist/standalone-validation-prompt.js.map +1 -0
  420. package/dist/suggest-owners.d.ts +4 -2
  421. package/dist/suggest-owners.d.ts.map +1 -1
  422. package/dist/suggest-owners.js +11 -5
  423. package/dist/suggest-owners.js.map +1 -1
  424. package/dist/targets.d.ts +11 -0
  425. package/dist/targets.d.ts.map +1 -1
  426. package/dist/targets.js +123 -72
  427. package/dist/targets.js.map +1 -1
  428. package/dist/trusted-executable.d.ts +2 -2
  429. package/dist/trusted-executable.d.ts.map +1 -1
  430. package/dist/trusted-executable.js +8 -6
  431. package/dist/trusted-executable.js.map +1 -1
  432. package/dist/value.js +7 -0
  433. package/dist/value.js.map +1 -1
  434. package/dist/version.js.map +1 -1
  435. package/dist/workbench-arguments.d.ts +3 -0
  436. package/dist/workbench-arguments.d.ts.map +1 -0
  437. package/dist/workbench-arguments.js +15 -0
  438. package/dist/workbench-arguments.js.map +1 -0
  439. package/dist/worker-progress.d.ts +44 -11
  440. package/dist/worker-progress.d.ts.map +1 -1
  441. package/dist/worker-progress.js +48 -49
  442. package/dist/worker-progress.js.map +1 -1
  443. package/docs/cli.md +1788 -0
  444. package/docs/findings-service.md +402 -0
  445. package/docs/hosted-scans.md +242 -0
  446. package/package.json +23 -22
  447. package/schemas/hosted-scan-v2.fixture.json +145 -0
  448. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  449. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  450. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  451. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  452. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  453. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  454. package/dist/server/dashboard/app.css +0 -2
  455. package/dist/server/dashboard/app.js +0 -66
  456. package/dist/server/dashboard/index.html +0 -18
  457. package/dist/server/dashboard-types.d.ts +0 -48
  458. package/dist/server/dashboard-types.d.ts.map +0 -1
  459. package/dist/server/dashboard-types.js +0 -2
  460. package/dist/server/dashboard-types.js.map +0 -1
  461. package/dist/server/dashboard.d.ts +0 -6
  462. package/dist/server/dashboard.d.ts.map +0 -1
  463. package/dist/server/dashboard.js +0 -59
  464. package/dist/server/dashboard.js.map +0 -1
  465. package/dist/server/index.d.ts +0 -2
  466. package/dist/server/index.d.ts.map +0 -1
  467. package/dist/server/index.js +0 -6
  468. package/dist/server/index.js.map +0 -1
  469. package/dist/server/routes.d.ts +0 -7
  470. package/dist/server/routes.d.ts.map +0 -1
  471. package/dist/server/routes.js +0 -98
  472. package/dist/server/routes.js.map +0 -1
  473. package/dist/server/serve.d.ts +0 -2
  474. package/dist/server/serve.d.ts.map +0 -1
  475. package/dist/server/serve.js +0 -28
  476. package/dist/server/serve.js.map +0 -1
  477. package/dist/server/server.d.ts +0 -10
  478. package/dist/server/server.d.ts.map +0 -1
  479. package/dist/server/server.js +0 -16
  480. package/dist/server/server.js.map +0 -1
  481. package/dist/server/validation.d.ts +0 -17
  482. package/dist/server/validation.d.ts.map +0 -1
  483. package/dist/server/validation.js +0 -53
  484. package/dist/server/validation.js.map +0 -1
@@ -1,10 +1,11 @@
1
- """Validate, record, and export findings from completed scans."""
1
+ """Validate, record, and export findings from sealed scans."""
2
2
 
3
3
  from __future__ import annotations
4
4
 
5
5
  import argparse
6
6
  import csv
7
7
  import io
8
+ import json
8
9
  import os
9
10
  import sqlite3
10
11
  import sys
@@ -17,6 +18,7 @@ from urllib.parse import quote
17
18
  sys.path.insert(0, str(Path(__file__).resolve().parent))
18
19
  from finalize_scan_contract import (
19
20
  ContractError,
21
+ SealedArtifactError,
20
22
  build_threat_model_export,
21
23
  csv_cell,
22
24
  finalize_scan,
@@ -24,92 +26,51 @@ from finalize_scan_contract import (
24
26
  finding_csv_columns,
25
27
  write_export_output,
26
28
  write_sarif_projection,
27
- write_scan_local_bytes,
28
29
  )
30
+ from validate_scan_contract import validate_contract
29
31
 
30
32
 
31
- def linear_publication_input(
32
- db: Any,
33
- args: argparse.Namespace,
34
- *,
35
- recording: bool,
36
- ) -> tuple[dict[str, Any], dict[str, str], list[dict[str, str]]]:
37
- payload = db.read_json_object(Path(args.input_file))
38
- required = {"scanId", "scanDirectory", "destination", "findings"}
39
- if recording:
40
- required.add("publications")
41
- if set(payload) != required:
42
- raise SystemExit("Linear publication input contains unexpected or missing fields.")
43
-
44
- scan_id = payload["scanId"]
45
- scan_directory = payload["scanDirectory"]
46
- destination = payload["destination"]
47
- findings = payload["findings"]
48
- if not isinstance(scan_id, str) or not isinstance(scan_directory, str):
49
- raise SystemExit("Linear publication input must identify the exact completed scan.")
50
- if (
51
- not isinstance(destination, dict)
52
- or not {"type", "teamId"}.issubset(destination)
53
- or not set(destination).issubset({"type", "teamId", "projectId"})
54
- or destination.get("type") != "linear"
55
- or not isinstance(destination.get("teamId"), str)
56
- or not destination["teamId"].strip()
57
- or (
58
- "projectId" in destination
59
- and (
60
- not isinstance(destination["projectId"], str)
61
- or not destination["projectId"].strip()
62
- )
63
- )
64
- ):
65
- raise SystemExit(
66
- "Linear publication input must identify the exact team and optional project."
67
- )
68
- if not isinstance(findings, list):
69
- raise SystemExit("Linear publication input must include the planned scan findings.")
70
-
71
- seen_finding_ids: set[str] = set()
72
- seen_occurrence_ids: set[str] = set()
73
- for finding in findings:
74
- if (
75
- not isinstance(finding, dict)
76
- or set(finding) != {"findingId", "occurrenceId"}
77
- or not isinstance(finding.get("findingId"), str)
78
- or not finding["findingId"].strip()
79
- or not isinstance(finding.get("occurrenceId"), str)
80
- or not finding["occurrenceId"].strip()
81
- ):
82
- raise SystemExit("Linear publication input contains an invalid finding identity.")
83
- if (
84
- finding["findingId"] in seen_finding_ids
85
- or finding["occurrenceId"] in seen_occurrence_ids
86
- ):
87
- raise SystemExit("Linear publication input repeats a finding or occurrence.")
88
- seen_finding_ids.add(finding["findingId"])
89
- seen_occurrence_ids.add(finding["occurrenceId"])
90
-
91
- return payload, destination, findings
33
+ def destination_key(destination: Any) -> str:
34
+ if not isinstance(destination, dict):
35
+ raise SystemExit("Finding issues require an exact tracker destination.")
36
+ kind = destination.get("type")
37
+ if kind == "linear":
38
+ required, optional = {"type", "teamId"}, {"projectId"}
39
+ parts = [kind, destination.get("teamId"), destination.get("projectId")]
40
+ elif kind == "jira":
41
+ required, optional = {"type", "cloudId", "projectId"}, set()
42
+ parts = [kind, destination.get("cloudId"), destination.get("projectId")]
43
+ elif kind in {"github-issue", "github-advisory"}:
44
+ required, optional = {"type", "hostname", "repository"}, set()
45
+ parts = [kind, destination.get("hostname"), destination.get("repository")]
46
+ else:
47
+ raise SystemExit("Unsupported finding issue destination.")
48
+ if not required.issubset(destination) or not set(destination).issubset(required | optional):
49
+ raise SystemExit("Finding issues require the exact provider destination fields.")
50
+ if any(not isinstance(value, str) or not value.strip() for value in destination.values()):
51
+ raise SystemExit("Finding issue destination fields must be nonempty strings.")
52
+ return json.dumps(parts, ensure_ascii=False, separators=(",", ":"))
92
53
 
93
54
 
94
- def verify_linear_publication_scan(
55
+ def verify_publication_history(
95
56
  db: Any,
96
57
  connection: sqlite3.Connection,
97
- payload: dict[str, Any],
98
- findings: list[dict[str, str]],
99
- ) -> sqlite3.Row:
58
+ scan_id: str,
59
+ scan_directory: str,
60
+ findings: list[dict[str, Any]],
61
+ ) -> None:
100
62
  try:
101
- scan = db.require_scan(connection, payload["scanId"])
63
+ scan = db.require_scan(connection, scan_id)
102
64
  except SystemExit as exc:
103
65
  raise SystemExit(
104
66
  "The completed scan is not present in the local Codex Security scan-history database. "
105
67
  "Use the state directory where the scan was completed."
106
68
  ) from exc
107
- if scan["id"] != payload["scanId"]:
108
- raise SystemExit("Linear publication must use the exact completed scan identifier.")
69
+ if scan["id"] != scan_id:
70
+ raise SystemExit("Publication must use the exact completed scan identifier.")
109
71
  if scan["status"] != "complete":
110
72
  raise SystemExit("Only completed scans can publish findings to Linear.")
111
-
112
- requested_directory = db.require_canonical_scan_directory(Path(payload["scanDirectory"]))
73
+ requested_directory = db.require_canonical_scan_directory(Path(scan_directory))
113
74
  recorded_directory = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
114
75
  if os.path.normcase(requested_directory) != os.path.normcase(recorded_directory):
115
76
  raise SystemExit(
@@ -117,219 +78,217 @@ def verify_linear_publication_scan(
117
78
  )
118
79
  if "seal_manifest_digest" in scan.keys():
119
80
  db.require_recorded_manifest_digest(scan, recorded_directory)
120
-
121
81
  stored_findings = {
122
82
  row["id"]: row["finding_id"]
123
83
  for row in connection.execute(
124
- "SELECT id, finding_id FROM finding_occurrences WHERE scan_id = ?",
125
- (scan["id"],),
84
+ "SELECT id, finding_id FROM finding_occurrences WHERE scan_id = ?", (scan_id,)
126
85
  )
127
86
  }
128
- for finding in findings:
129
- if stored_findings.get(finding["occurrenceId"]) != finding["findingId"]:
130
- raise SystemExit(
131
- "A selected finding or occurrence does not belong to the completed scan "
132
- "in local Codex Security scan history."
133
- )
134
- if len(stored_findings) != len(findings):
87
+ expected = {finding["occurrenceId"]: finding["findingId"] for finding in findings}
88
+ if stored_findings != expected:
135
89
  raise SystemExit(
136
90
  "The completed scan findings do not exactly match local Codex Security scan history."
137
91
  )
138
- return scan
139
92
 
140
93
 
141
- def inspect_linear_publication(
142
- db: Any,
143
- args: argparse.Namespace,
144
- ) -> dict[str, Any]:
145
- payload, destination, findings = linear_publication_input(db, args, recording=False)
146
- database_uri = f"file:{quote(str(db.database_path()), safe='')}?mode=ro"
147
- with closing(sqlite3.connect(database_uri, uri=True, timeout=5)) as connection:
148
- connection.row_factory = sqlite3.Row
149
- connection.execute("BEGIN")
150
- scan = verify_linear_publication_scan(db, connection, payload, findings)
151
- recorded: dict[str, dict[str, str]] = {}
152
- if connection.execute(
153
- "SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'finding_publications'"
154
- ).fetchone():
155
- for row in connection.execute(
156
- """
157
- SELECT finding_id, occurrence_id, external_id, external_url
158
- FROM finding_publications
159
- WHERE scan_id = ? AND destination_type = ? AND team_id = ? AND project_id IS ?
160
- ORDER BY created_at, external_id
161
- """,
162
- (
163
- scan["id"],
164
- destination["type"],
165
- destination["teamId"],
166
- destination.get("projectId"),
167
- ),
168
- ):
169
- recorded.setdefault(
170
- row["occurrence_id"],
171
- {
172
- "findingId": row["finding_id"],
173
- "occurrenceId": row["occurrence_id"],
174
- "issueIdentifier": row["external_id"],
175
- **({"url": row["external_url"]} if row["external_url"] is not None else {}),
176
- },
177
- )
178
- return {
179
- "scanId": scan["id"],
180
- "destination": destination,
181
- "findingCount": len(findings),
182
- "recorded": [
183
- recorded[finding["occurrenceId"]]
184
- for finding in findings
185
- if finding["occurrenceId"] in recorded
186
- ],
187
- }
94
+ def issue_receipt(row: sqlite3.Row) -> dict[str, Any]:
95
+ return {
96
+ "scanId": row["scan_id"],
97
+ "findingId": row["finding_id"],
98
+ "occurrenceId": row["occurrence_id"],
99
+ "issueIdentifier": row["external_id"],
100
+ "operation": row["operation"],
101
+ **({"url": row["external_url"]} if row["external_url"] is not None else {}),
102
+ **({"readback": json.loads(row["readback_json"])} if row["readback_json"] else {}),
103
+ }
188
104
 
189
105
 
190
- def prepare_linear_publication(
191
- db: Any,
106
+ def inspect_issue_receipts(
192
107
  connection: sqlite3.Connection,
193
- args: argparse.Namespace,
194
- ) -> dict[str, Any]:
195
- payload, destination, findings = linear_publication_input(db, args, recording=False)
196
- connection.execute("BEGIN IMMEDIATE")
197
- with connection:
198
- scan = verify_linear_publication_scan(db, connection, payload, findings)
199
- result = {
200
- "scanId": scan["id"],
201
- "destination": destination,
202
- "findingCount": len(findings),
203
- }
204
- return result
108
+ destination: dict[str, str],
109
+ key: str,
110
+ finding_ids: list[str],
111
+ ) -> list[dict[str, Any]]:
112
+ tables = {
113
+ row[0] for row in connection.execute("SELECT name FROM sqlite_master WHERE type = 'table'")
114
+ }
115
+ selection = json.dumps(finding_ids)
116
+ if "finding_issue_receipts" in tables:
117
+ rows = connection.execute(
118
+ "SELECT * FROM finding_issue_receipts WHERE destination_key = ? "
119
+ "AND finding_id IN (SELECT value FROM json_each(?)) ORDER BY id",
120
+ (key, selection),
121
+ )
122
+ elif "finding_publications" in tables and destination["type"] == "linear":
123
+ rows = connection.execute(
124
+ "SELECT *, 'create' AS operation, NULL AS readback_json FROM finding_publications "
125
+ "WHERE destination_type = 'linear' AND team_id = ? AND project_id IS ? "
126
+ "AND finding_id IN (SELECT value FROM json_each(?)) ORDER BY id",
127
+ (destination["teamId"], destination.get("projectId"), selection),
128
+ )
129
+ else:
130
+ return []
131
+ return [issue_receipt(row) for row in rows]
205
132
 
206
133
 
207
- def record_linear_publications(
208
- db: Any,
209
- connection: sqlite3.Connection,
210
- args: argparse.Namespace,
211
- ) -> dict[str, Any]:
212
- payload, destination, findings = linear_publication_input(db, args, recording=True)
213
- publications = payload["publications"]
214
- if not isinstance(publications, list):
215
- raise SystemExit("Linear publication results must be an array.")
216
- planned = {finding["findingId"]: finding["occurrenceId"] for finding in findings}
217
- current: dict[str, dict[str, str]] = {}
218
- external_ids: set[str] = set()
219
- for publication in publications:
220
- if (
221
- not isinstance(publication, dict)
222
- or not {"findingId", "occurrenceId", "issueIdentifier"}.issubset(publication)
223
- or not set(publication).issubset(
224
- {"findingId", "occurrenceId", "issueIdentifier", "url"}
225
- )
226
- or not isinstance(publication.get("findingId"), str)
227
- or not isinstance(publication.get("occurrenceId"), str)
228
- or not isinstance(publication.get("issueIdentifier"), str)
229
- or not publication["issueIdentifier"].strip()
230
- or (
231
- "url" in publication
232
- and (not isinstance(publication["url"], str) or not publication["url"].strip())
233
- )
134
+ def validate_issue_receipts(receipts: Any, selected: dict[str, str]) -> list[dict[str, Any]]:
135
+ if not isinstance(receipts, list):
136
+ raise SystemExit("Finding issue receipts must be an array.")
137
+ for receipt in receipts:
138
+ if not isinstance(receipt, dict):
139
+ raise SystemExit("Each finding issue receipt must be an object.")
140
+ if any(
141
+ not isinstance(receipt.get(field), str) or not receipt[field].strip()
142
+ for field in ("findingId", "occurrenceId", "issueIdentifier")
234
143
  ):
235
- raise SystemExit("Linear publication results contain an invalid issue association.")
236
- finding_id = publication["findingId"]
237
- issue_identifier = publication["issueIdentifier"]
238
- if planned.get(finding_id) != publication["occurrenceId"]:
144
+ raise SystemExit("A finding issue receipt is missing its source or issue identity.")
145
+ if selected.get(receipt["findingId"]) != receipt["occurrenceId"]:
239
146
  raise SystemExit(
240
- "A created Linear issue does not match its planned finding and occurrence."
147
+ "A finding issue receipt does not belong to the selected sealed findings."
241
148
  )
242
- if finding_id in current or issue_identifier in external_ids:
243
- raise SystemExit("Linear publication results repeat a finding or issue identifier.")
244
- current[finding_id] = publication
245
- external_ids.add(issue_identifier)
246
-
247
- connection.execute("BEGIN IMMEDIATE")
248
- with connection:
249
- scan = verify_linear_publication_scan(db, connection, payload, findings)
250
- timestamp = db.now()
251
- for publication in publications:
252
- conflicting = connection.execute(
253
- """
254
- SELECT occurrence_id, external_url
255
- FROM finding_publications
256
- WHERE destination_type = ? AND team_id = ? AND project_id IS ?
257
- AND external_id = ?
258
- """,
259
- (
260
- destination["type"],
261
- destination["teamId"],
262
- destination.get("projectId"),
263
- publication["issueIdentifier"],
264
- ),
265
- ).fetchone()
266
- if (
267
- conflicting is not None
268
- and conflicting["occurrence_id"] != publication["occurrenceId"]
269
- ):
270
- raise SystemExit(
271
- "This Linear issue is already associated with a different finding."
272
- )
149
+ if receipt.get("operation") not in {"create", "update", "reuse"}:
150
+ raise SystemExit("A finding issue receipt requires create, update, or reuse.")
151
+ if "url" in receipt and (not isinstance(receipt["url"], str) or not receipt["url"].strip()):
152
+ raise SystemExit("A finding issue URL must be a nonempty string when supplied.")
153
+ if "readback" in receipt:
154
+ readback = receipt["readback"]
273
155
  if (
274
- conflicting is not None
275
- and "url" in publication
276
- and conflicting["external_url"] != publication["url"]
156
+ not isinstance(readback, dict)
157
+ or readback.get("status") not in {"verified", "failed"}
158
+ or ("error" in readback and not isinstance(readback["error"], str))
277
159
  ):
278
- raise SystemExit("This Linear issue is already associated with a different URL.")
160
+ raise SystemExit("A finding issue readback requires verified or failed status.")
161
+ return receipts
279
162
 
280
- connection.execute(
281
- """
282
- INSERT INTO finding_publications (
283
- scan_id, finding_id, occurrence_id, destination_type,
284
- team_id, project_id, external_id, external_url, created_at
285
- ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
286
- ON CONFLICT DO NOTHING
287
- """,
288
- (
289
- scan["id"],
290
- publication["findingId"],
291
- publication["occurrenceId"],
292
- destination["type"],
293
- destination["teamId"],
294
- destination.get("projectId"),
295
- publication["issueIdentifier"],
296
- publication.get("url"),
297
- timestamp,
298
- ),
299
- )
300
163
 
301
- created = []
302
- for finding in findings:
303
- publication = current.get(finding["findingId"])
304
- if publication is None:
305
- continue
306
- row = connection.execute(
307
- """
308
- SELECT finding_id, occurrence_id, external_id, external_url
309
- FROM finding_publications
310
- WHERE scan_id = ? AND occurrence_id = ? AND destination_type = ?
311
- AND team_id = ? AND project_id IS ? AND external_id = ?
312
- """,
313
- (
314
- scan["id"],
315
- publication["occurrenceId"],
316
- destination["type"],
317
- destination["teamId"],
318
- destination.get("projectId"),
319
- publication["issueIdentifier"],
320
- ),
321
- ).fetchone()
322
- if row is None:
323
- raise SystemExit("A created Linear issue could not be read from scan history.")
324
- created.append(
325
- {
326
- "findingId": row["finding_id"],
327
- "occurrenceId": row["occurrence_id"],
328
- "issueIdentifier": row["external_id"],
329
- **({"url": row["external_url"]} if row["external_url"] is not None else {}),
330
- }
331
- )
332
- result = {"scanId": scan["id"], "destination": destination, "created": created}
164
+ def finding_issues(db: Any, payload: Any) -> dict[str, Any]:
165
+ if not isinstance(payload, dict) or payload.get("action") not in {
166
+ "inspect",
167
+ "prepare",
168
+ "record",
169
+ }:
170
+ raise SystemExit("Finding issues require inspect, prepare, or record action.")
171
+ if not isinstance(payload.get("scanDirectory"), str):
172
+ raise SystemExit("Finding issues require a sealed scan directory.")
173
+ require_history = payload.get("requireHistory", False)
174
+ if not isinstance(require_history, bool):
175
+ raise SystemExit("requireHistory must be a boolean.")
176
+ key = destination_key(payload.get("destination"))
177
+ try:
178
+ validated = validate_contract(Path(payload["scanDirectory"]))
179
+ except (OSError, ValueError, RecursionError) as exc:
180
+ raise SystemExit(f"Finding issue source validation failed: {exc}") from exc
181
+ scan_id = validated["manifest"]["scan"]["id"]
182
+ if "expectedScanId" in payload and payload["expectedScanId"] != scan_id:
183
+ raise SystemExit("Scan artifacts do not match the selected scan identifier.")
184
+ findings = validated["findings"]["findings"]
185
+ available = {finding["findingId"]: finding["occurrenceId"] for finding in findings}
186
+ finding_ids = payload.get("findingIds", list(available))
187
+ if not isinstance(finding_ids, list) or any(
188
+ not isinstance(finding_id, str) or finding_id not in available for finding_id in finding_ids
189
+ ):
190
+ raise SystemExit("Selected finding IDs must belong to the sealed scan.")
191
+ selected = {finding_id: available[finding_id] for finding_id in finding_ids}
192
+ receipts = (
193
+ validate_issue_receipts(payload.get("receipts"), selected)
194
+ if payload["action"] == "record"
195
+ else []
196
+ )
197
+ result = {
198
+ "scanId": scan_id,
199
+ "destination": payload["destination"],
200
+ "findingCount": len(selected),
201
+ "storeExists": True,
202
+ "receipts": [],
203
+ }
204
+ path = db.database_path()
205
+ if payload["action"] == "inspect" or require_history:
206
+ try:
207
+ path.stat()
208
+ except FileNotFoundError:
209
+ if require_history:
210
+ raise SystemExit(
211
+ "Cannot publish findings because the local Codex Security scan-history database "
212
+ "does not exist. Use the state directory where this scan was completed."
213
+ ) from None
214
+ result["storeExists"] = False
215
+ return result
216
+ except PermissionError:
217
+ pass # Let SQLite report the open failure used by the host's state fallback.
218
+ if payload["action"] == "inspect":
219
+ database_uri = f"file:{quote(str(path), safe='')}?mode=ro"
220
+ try:
221
+ connection = sqlite3.connect(database_uri, uri=True, timeout=5)
222
+ except sqlite3.OperationalError as exc:
223
+ if str(exc) == "unable to open database file":
224
+ exc._codex_security_state_unavailable = True
225
+ raise
226
+ connection.row_factory = sqlite3.Row
227
+ else:
228
+ connection = db.connect()
229
+ with closing(connection):
230
+ connection.execute("BEGIN" if payload["action"] == "inspect" else "BEGIN IMMEDIATE")
231
+ with connection:
232
+ if require_history:
233
+ verify_publication_history(db, connection, scan_id, validated["scanDir"], findings)
234
+ if payload["action"] == "inspect":
235
+ result["receipts"] = inspect_issue_receipts(
236
+ connection, payload["destination"], key, list(selected)
237
+ )
238
+ elif payload["action"] == "record":
239
+ timestamp = db.now()
240
+ for receipt in receipts:
241
+ conflicting = connection.execute(
242
+ "SELECT 1 FROM finding_issue_receipts "
243
+ "WHERE destination_key = ? AND external_id = ? AND finding_id != ? LIMIT 1",
244
+ (key, receipt["issueIdentifier"], receipt["findingId"]),
245
+ ).fetchone()
246
+ if conflicting is not None:
247
+ raise SystemExit(
248
+ "The issue identifier is already associated with another finding "
249
+ "in this destination."
250
+ )
251
+ readback = (
252
+ json.dumps(receipt["readback"], ensure_ascii=False)
253
+ if "readback" in receipt
254
+ else None
255
+ )
256
+ connection.execute(
257
+ """
258
+ INSERT INTO finding_issue_receipts (
259
+ scan_id, finding_id, occurrence_id, destination_key,
260
+ external_id, external_url, operation, readback_json, created_at, updated_at
261
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
262
+ ON CONFLICT (occurrence_id, destination_key, external_id, operation)
263
+ DO UPDATE SET
264
+ external_url = COALESCE(external_url, excluded.external_url),
265
+ readback_json = COALESCE(excluded.readback_json, readback_json),
266
+ updated_at = excluded.updated_at
267
+ """,
268
+ (
269
+ scan_id,
270
+ receipt["findingId"],
271
+ receipt["occurrenceId"],
272
+ key,
273
+ receipt["issueIdentifier"],
274
+ receipt.get("url"),
275
+ receipt["operation"],
276
+ readback,
277
+ timestamp,
278
+ timestamp,
279
+ ),
280
+ )
281
+ row = connection.execute(
282
+ "SELECT * FROM finding_issue_receipts WHERE occurrence_id = ? "
283
+ "AND destination_key = ? AND external_id = ? AND operation = ?",
284
+ (
285
+ receipt["occurrenceId"],
286
+ key,
287
+ receipt["issueIdentifier"],
288
+ receipt["operation"],
289
+ ),
290
+ ).fetchone()
291
+ result["receipts"].append(issue_receipt(row))
333
292
  return result
334
293
 
335
294
 
@@ -423,41 +382,27 @@ def write_csv_export(
423
382
  candidate_id = finding_candidate_id(finding)
424
383
  if isinstance(occurrence_id, str) and isinstance(candidate_id, str):
425
384
  candidate_ids_by_occurrence[occurrence_id] = candidate_id
426
- writer.writerow(finding_csv_columns(deep_scan))
385
+ columns = finding_csv_columns(deep_scan)
386
+ writer.writerow(columns)
427
387
  for row in finding_export_rows(connection, scan["id"]):
428
- writer.writerow(
429
- (
430
- csv_cell(row["occurrence_id"]),
431
- csv_cell(row["finding_id"]),
432
- *(
433
- (csv_cell(candidate_ids_by_occurrence.get(row["occurrence_id"])),)
434
- if deep_scan
435
- else ()
436
- ),
437
- csv_cell(row["title"]),
438
- csv_cell(row["summary"]),
439
- csv_cell(row["severity"]),
440
- csv_cell(row["confidence"]),
441
- csv_cell(row["status"]),
442
- csv_cell(row["close_reason"]),
443
- csv_cell(row["note"]),
444
- csv_cell(row["remediation"]),
445
- csv_cell(row["relative_path"]),
446
- row["start_line"],
447
- row["end_line"],
448
- )
449
- )
388
+ values = dict(row)
389
+ values["path"] = row["relative_path"]
390
+ values["candidate_id"] = candidate_ids_by_occurrence.get(row["occurrence_id"])
391
+ writer.writerow(csv_cell(values[column]) for column in columns)
392
+ destination = scan_dir / "exports" / "findings.csv"
450
393
  try:
451
- write_scan_local_bytes(
394
+ write_export_output(
452
395
  scan_dir,
453
- "exports/findings.csv",
396
+ destination,
397
+ "csv",
454
398
  output.getvalue().encode("utf-8"),
455
399
  )
400
+ except SealedArtifactError as exc:
401
+ raise SystemExit(str(exc)) from exc
456
402
  except ContractError as exc:
457
403
  raise SystemExit(
458
404
  "exports: expected a regular directory inside the scan directory."
459
405
  ) from exc
460
- destination = scan_dir / "exports" / "findings.csv"
461
406
  path = db.available_artifact_path(scan_dir, destination)
462
407
  if path is None:
463
408
  raise SystemExit("findings.csv: expected a regular file inside the scan directory.")
@@ -34,6 +34,18 @@ def require_available(connection: sqlite3.Connection, args: Any, require_scan: A
34
34
  raise SystemExit(SCAN_STATUS_ERROR)
35
35
 
36
36
 
37
+ def require_request(
38
+ connection: sqlite3.Connection, request_id: str, occurrence: sqlite3.Row
39
+ ) -> sqlite3.Row:
40
+ current = connection.execute(
41
+ "SELECT * FROM finding_remediation_attempts WHERE request_id = ?",
42
+ (request_id,),
43
+ ).fetchone()
44
+ if current is None or current["occurrence_id"] != occurrence["id"]:
45
+ raise SystemExit("Codex Security finding remediation request not found.")
46
+ return current
47
+
48
+
37
49
  def remediation_claim_is_active(remediation: sqlite3.Row) -> bool:
38
50
  if remediation["pending_action_claim_token"] is None:
39
51
  return False