@openai/codex-security 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (463) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +2 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +563 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +2 -2
  25. package/_bundled_plugin/references/config-preflight.md +0 -4
  26. package/_bundled_plugin/references/core-scan.md +21 -9
  27. package/_bundled_plugin/references/final-report.md +10 -12
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +1 -2
  31. package/_bundled_plugin/references/scan-contract.md +9 -4
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +1 -1
  36. package/_bundled_plugin/schemas/coverage.schema.json +1 -47
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +71 -192
  40. package/_bundled_plugin/schemas/scan-manifest.schema.json +18 -45
  41. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  42. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  43. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  44. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  45. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  46. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  47. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  48. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  49. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  52. package/_bundled_plugin/scripts/finalize_scan_contract.py +315 -232
  53. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  54. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  55. package/_bundled_plugin/scripts/generate_rank_input.py +99 -829
  56. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  58. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  59. package/_bundled_plugin/scripts/report_projection.py +117 -172
  60. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  61. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  62. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  63. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  64. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  65. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  66. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  67. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  68. package/_bundled_plugin/scripts/workbench_cli.py +94 -179
  69. package/_bundled_plugin/scripts/workbench_db.py +427 -463
  70. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  71. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  72. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  73. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  75. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  76. package/_bundled_plugin/scripts/workbench_publication.py +33 -57
  77. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +23 -34
  82. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  83. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  84. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  85. package/_bundled_plugin/scripts/workbench_validation.py +16 -27
  86. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  87. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  88. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  89. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  90. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  91. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  93. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  94. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  95. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  96. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  97. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  98. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  99. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  100. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +1 -1
  101. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  102. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  103. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  104. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  105. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  106. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  107. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  108. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  110. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  111. package/bin/codex-security.mjs +9 -2
  112. package/dist/api.d.ts +60 -10
  113. package/dist/api.d.ts.map +1 -1
  114. package/dist/api.js +803 -380
  115. package/dist/api.js.map +1 -1
  116. package/dist/artifact-export.d.ts +1 -1
  117. package/dist/artifact-export.d.ts.map +1 -1
  118. package/dist/artifact-export.js +28 -13
  119. package/dist/artifact-export.js.map +1 -1
  120. package/dist/auth.d.ts +2 -6
  121. package/dist/auth.d.ts.map +1 -1
  122. package/dist/auth.js +19 -9
  123. package/dist/auth.js.map +1 -1
  124. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  125. package/dist/bulk-scan-discovery.js +1 -0
  126. package/dist/bulk-scan-discovery.js.map +1 -1
  127. package/dist/classify-severity.d.ts +26 -9
  128. package/dist/classify-severity.d.ts.map +1 -1
  129. package/dist/classify-severity.js +13 -30
  130. package/dist/classify-severity.js.map +1 -1
  131. package/dist/cli-help.d.ts.map +1 -1
  132. package/dist/cli-help.js +17 -13
  133. package/dist/cli-help.js.map +1 -1
  134. package/dist/cli-signals.d.ts +8 -0
  135. package/dist/cli-signals.d.ts.map +1 -0
  136. package/dist/cli-signals.js +28 -0
  137. package/dist/cli-signals.js.map +1 -0
  138. package/dist/cli.d.ts +4 -3
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1087 -900
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.d.ts.map +1 -1
  143. package/dist/cloud-publish.js +10 -9
  144. package/dist/cloud-publish.js.map +1 -1
  145. package/dist/codeowners.d.ts +19 -0
  146. package/dist/codeowners.d.ts.map +1 -0
  147. package/dist/codeowners.js +138 -0
  148. package/dist/codeowners.js.map +1 -0
  149. package/dist/codex-sdk-environment.d.ts +1 -0
  150. package/dist/codex-sdk-environment.d.ts.map +1 -1
  151. package/dist/codex-sdk-environment.js +40 -2
  152. package/dist/codex-sdk-environment.js.map +1 -1
  153. package/dist/component-plan.d.ts +2 -5
  154. package/dist/component-plan.d.ts.map +1 -1
  155. package/dist/component-plan.js +38 -30
  156. package/dist/component-plan.js.map +1 -1
  157. package/dist/component-scan.d.ts +6 -5
  158. package/dist/component-scan.d.ts.map +1 -1
  159. package/dist/component-scan.js +23 -35
  160. package/dist/component-scan.js.map +1 -1
  161. package/dist/config.d.ts.map +1 -1
  162. package/dist/config.js +64 -74
  163. package/dist/config.js.map +1 -1
  164. package/dist/contract.d.ts +15 -3
  165. package/dist/contract.d.ts.map +1 -1
  166. package/dist/contract.js +87 -252
  167. package/dist/contract.js.map +1 -1
  168. package/dist/cost-model.d.ts +13 -6
  169. package/dist/cost-model.d.ts.map +1 -1
  170. package/dist/cost-model.js +14 -4
  171. package/dist/cost-model.js.map +1 -1
  172. package/dist/cost.d.ts +10 -2
  173. package/dist/cost.d.ts.map +1 -1
  174. package/dist/cost.js +102 -104
  175. package/dist/cost.js.map +1 -1
  176. package/dist/custom-validation-prompt.d.ts.map +1 -1
  177. package/dist/custom-validation-prompt.js +6 -5
  178. package/dist/custom-validation-prompt.js.map +1 -1
  179. package/dist/custom-validation.d.ts +1 -2
  180. package/dist/custom-validation.d.ts.map +1 -1
  181. package/dist/custom-validation.js +9 -3
  182. package/dist/custom-validation.js.map +1 -1
  183. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  184. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  185. package/dist/deduplication/checkpointed-review.js +23 -9
  186. package/dist/deduplication/checkpointed-review.js.map +1 -1
  187. package/dist/deduplication/codex-review.d.ts +7 -1
  188. package/dist/deduplication/codex-review.d.ts.map +1 -1
  189. package/dist/deduplication/codex-review.js +126 -17
  190. package/dist/deduplication/codex-review.js.map +1 -1
  191. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  192. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  193. package/dist/deduplication/deduplication-prompts.js +18 -4
  194. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  195. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  196. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication-reviewer.js +57 -47
  198. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  199. package/dist/deduplication/deduplication.d.ts.map +1 -1
  200. package/dist/deduplication/deduplication.js +19 -51
  201. package/dist/deduplication/deduplication.js.map +1 -1
  202. package/dist/deduplication/diagnostics.d.ts +17 -0
  203. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  204. package/dist/deduplication/diagnostics.js +5 -0
  205. package/dist/deduplication/diagnostics.js.map +1 -0
  206. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  207. package/dist/deduplication/finding-schema.js +7 -1
  208. package/dist/deduplication/finding-schema.js.map +1 -1
  209. package/dist/deduplication/local.d.ts +31 -0
  210. package/dist/deduplication/local.d.ts.map +1 -0
  211. package/dist/deduplication/local.js +166 -0
  212. package/dist/deduplication/local.js.map +1 -0
  213. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  214. package/dist/deduplication/records-protocol.js +11 -24
  215. package/dist/deduplication/records-protocol.js.map +1 -1
  216. package/dist/deduplication/records.d.ts +186 -11
  217. package/dist/deduplication/records.d.ts.map +1 -1
  218. package/dist/deduplication/records.js +10 -18
  219. package/dist/deduplication/records.js.map +1 -1
  220. package/dist/deduplication/scan.d.ts +9 -3
  221. package/dist/deduplication/scan.d.ts.map +1 -1
  222. package/dist/deduplication/scan.js +158 -39
  223. package/dist/deduplication/scan.js.map +1 -1
  224. package/dist/deep-config.d.ts +2 -1
  225. package/dist/deep-config.d.ts.map +1 -1
  226. package/dist/deep-config.js +4 -4
  227. package/dist/deep-config.js.map +1 -1
  228. package/dist/deep-progress.d.ts +2 -0
  229. package/dist/deep-progress.d.ts.map +1 -1
  230. package/dist/deep-progress.js +13 -10
  231. package/dist/deep-progress.js.map +1 -1
  232. package/dist/deep-scan.d.ts +20 -0
  233. package/dist/deep-scan.d.ts.map +1 -0
  234. package/dist/deep-scan.js +113 -0
  235. package/dist/deep-scan.js.map +1 -0
  236. package/dist/errors.d.ts +2 -0
  237. package/dist/errors.d.ts.map +1 -1
  238. package/dist/errors.js +2 -0
  239. package/dist/errors.js.map +1 -1
  240. package/dist/feedback.d.ts.map +1 -1
  241. package/dist/feedback.js +53 -21
  242. package/dist/feedback.js.map +1 -1
  243. package/dist/finding-catalogue.d.ts.map +1 -1
  244. package/dist/finding-catalogue.js +4 -8
  245. package/dist/finding-catalogue.js.map +1 -1
  246. package/dist/finding-normalization.d.ts +5 -0
  247. package/dist/finding-normalization.d.ts.map +1 -0
  248. package/dist/finding-normalization.js +120 -0
  249. package/dist/finding-normalization.js.map +1 -0
  250. package/dist/finding-retrieval.d.ts +9 -0
  251. package/dist/finding-retrieval.d.ts.map +1 -1
  252. package/dist/finding-retrieval.js.map +1 -1
  253. package/dist/finding-workflow.d.ts +13 -8
  254. package/dist/finding-workflow.d.ts.map +1 -1
  255. package/dist/finding-workflow.js +14 -6
  256. package/dist/finding-workflow.js.map +1 -1
  257. package/dist/findings-client.d.ts +2 -1
  258. package/dist/findings-client.d.ts.map +1 -1
  259. package/dist/findings-client.js +36 -9
  260. package/dist/findings-client.js.map +1 -1
  261. package/dist/findings-errors.d.ts +16 -0
  262. package/dist/findings-errors.d.ts.map +1 -0
  263. package/dist/findings-errors.js +24 -0
  264. package/dist/findings-errors.js.map +1 -0
  265. package/dist/findings-import.d.ts +1 -1
  266. package/dist/findings-import.d.ts.map +1 -1
  267. package/dist/findings-import.js +12 -30
  268. package/dist/findings-import.js.map +1 -1
  269. package/dist/github.d.ts.map +1 -1
  270. package/dist/github.js +7 -1
  271. package/dist/github.js.map +1 -1
  272. package/dist/import-scan.d.ts.map +1 -1
  273. package/dist/import-scan.js +48 -38
  274. package/dist/import-scan.js.map +1 -1
  275. package/dist/index.d.ts +8 -4
  276. package/dist/index.d.ts.map +1 -1
  277. package/dist/index.js +1 -1
  278. package/dist/index.js.map +1 -1
  279. package/dist/knowledge-base.d.ts +7 -1
  280. package/dist/knowledge-base.d.ts.map +1 -1
  281. package/dist/knowledge-base.js +114 -46
  282. package/dist/knowledge-base.js.map +1 -1
  283. package/dist/linear.d.ts.map +1 -1
  284. package/dist/linear.js +2 -7
  285. package/dist/linear.js.map +1 -1
  286. package/dist/mock-scan.d.ts.map +1 -1
  287. package/dist/mock-scan.js +0 -1
  288. package/dist/mock-scan.js.map +1 -1
  289. package/dist/models.d.ts +0 -2
  290. package/dist/models.d.ts.map +1 -1
  291. package/dist/models.js.map +1 -1
  292. package/dist/multiscan.d.ts +9 -3
  293. package/dist/multiscan.d.ts.map +1 -1
  294. package/dist/multiscan.js +193 -126
  295. package/dist/multiscan.js.map +1 -1
  296. package/dist/owner-evidence.d.ts +10 -2
  297. package/dist/owner-evidence.d.ts.map +1 -1
  298. package/dist/owner-evidence.js +67 -8
  299. package/dist/owner-evidence.js.map +1 -1
  300. package/dist/patch-tui.d.ts.map +1 -1
  301. package/dist/patch-tui.js +3 -2
  302. package/dist/patch-tui.js.map +1 -1
  303. package/dist/project-config.js +3 -3
  304. package/dist/project-config.js.map +1 -1
  305. package/dist/provider-profile.d.ts +21 -0
  306. package/dist/provider-profile.d.ts.map +1 -0
  307. package/dist/provider-profile.js +133 -0
  308. package/dist/provider-profile.js.map +1 -0
  309. package/dist/publication-events.d.ts +6 -8
  310. package/dist/publication-events.d.ts.map +1 -1
  311. package/dist/publication-events.js +25 -50
  312. package/dist/publication-events.js.map +1 -1
  313. package/dist/publication-store.d.ts.map +1 -1
  314. package/dist/publication-store.js +40 -64
  315. package/dist/publication-store.js.map +1 -1
  316. package/dist/publication.d.ts +1 -2
  317. package/dist/publication.d.ts.map +1 -1
  318. package/dist/publication.js +2 -8
  319. package/dist/publication.js.map +1 -1
  320. package/dist/publish.d.ts +1 -5
  321. package/dist/publish.d.ts.map +1 -1
  322. package/dist/publish.js +109 -160
  323. package/dist/publish.js.map +1 -1
  324. package/dist/request-metadata.d.ts +9 -0
  325. package/dist/request-metadata.d.ts.map +1 -0
  326. package/dist/request-metadata.js +13 -0
  327. package/dist/request-metadata.js.map +1 -0
  328. package/dist/runtime.d.ts +15 -4
  329. package/dist/runtime.d.ts.map +1 -1
  330. package/dist/runtime.js +430 -138
  331. package/dist/runtime.js.map +1 -1
  332. package/dist/saved-scan-bootstrap.d.ts +14 -0
  333. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  334. package/dist/saved-scan-bootstrap.js +261 -0
  335. package/dist/saved-scan-bootstrap.js.map +1 -0
  336. package/dist/saved-scan.d.ts +1 -1
  337. package/dist/saved-scan.d.ts.map +1 -1
  338. package/dist/saved-scan.js +6 -12
  339. package/dist/saved-scan.js.map +1 -1
  340. package/dist/scan-activity.js +11 -8
  341. package/dist/scan-activity.js.map +1 -1
  342. package/dist/scan-comparison.d.ts +28 -15
  343. package/dist/scan-comparison.d.ts.map +1 -1
  344. package/dist/scan-comparison.js +276 -281
  345. package/dist/scan-comparison.js.map +1 -1
  346. package/dist/scan-dashboard.d.ts +3 -0
  347. package/dist/scan-dashboard.d.ts.map +1 -1
  348. package/dist/scan-dashboard.js +345 -77
  349. package/dist/scan-dashboard.js.map +1 -1
  350. package/dist/scan-history-renderer.d.ts.map +1 -1
  351. package/dist/scan-history-renderer.js +54 -13
  352. package/dist/scan-history-renderer.js.map +1 -1
  353. package/dist/scan-inputs.d.ts +6 -0
  354. package/dist/scan-inputs.d.ts.map +1 -0
  355. package/dist/scan-inputs.js +71 -0
  356. package/dist/scan-inputs.js.map +1 -0
  357. package/dist/scan-logs.d.ts +2 -3
  358. package/dist/scan-logs.d.ts.map +1 -1
  359. package/dist/scan-logs.js +12 -6
  360. package/dist/scan-logs.js.map +1 -1
  361. package/dist/scan-sessions.d.ts +4 -0
  362. package/dist/scan-sessions.d.ts.map +1 -1
  363. package/dist/scan-sessions.js +17 -0
  364. package/dist/scan-sessions.js.map +1 -1
  365. package/dist/scan-skill-paths.d.ts +8 -0
  366. package/dist/scan-skill-paths.d.ts.map +1 -0
  367. package/dist/scan-skill-paths.js +47 -0
  368. package/dist/scan-skill-paths.js.map +1 -0
  369. package/dist/security-policy-cli.d.ts.map +1 -1
  370. package/dist/security-policy-cli.js +7 -27
  371. package/dist/security-policy-cli.js.map +1 -1
  372. package/dist/security-policy.d.ts +9 -5
  373. package/dist/security-policy.d.ts.map +1 -1
  374. package/dist/security-policy.js +33 -14
  375. package/dist/security-policy.js.map +1 -1
  376. package/dist/server/api.d.ts +0 -1
  377. package/dist/server/api.d.ts.map +1 -1
  378. package/dist/server/api.js +0 -1
  379. package/dist/server/api.js.map +1 -1
  380. package/dist/server/embeddings.d.ts +3 -1
  381. package/dist/server/embeddings.d.ts.map +1 -1
  382. package/dist/server/embeddings.js +10 -3
  383. package/dist/server/embeddings.js.map +1 -1
  384. package/dist/server/errors.d.ts +5 -2
  385. package/dist/server/errors.d.ts.map +1 -1
  386. package/dist/server/errors.js +7 -0
  387. package/dist/server/errors.js.map +1 -1
  388. package/dist/server/sqlite-store.d.ts +0 -2
  389. package/dist/server/sqlite-store.d.ts.map +1 -1
  390. package/dist/server/sqlite-store.js +54 -44
  391. package/dist/server/sqlite-store.js.map +1 -1
  392. package/dist/server/storage.d.ts +0 -2
  393. package/dist/server/storage.d.ts.map +1 -1
  394. package/dist/server/storage.js.map +1 -1
  395. package/dist/severity-store.js +19 -24
  396. package/dist/severity-store.js.map +1 -1
  397. package/dist/standalone-validation-prompt.d.ts +2 -0
  398. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  399. package/dist/standalone-validation-prompt.js +10 -0
  400. package/dist/standalone-validation-prompt.js.map +1 -0
  401. package/dist/suggest-owners.d.ts +4 -2
  402. package/dist/suggest-owners.d.ts.map +1 -1
  403. package/dist/suggest-owners.js +11 -5
  404. package/dist/suggest-owners.js.map +1 -1
  405. package/dist/targets.d.ts +11 -0
  406. package/dist/targets.d.ts.map +1 -1
  407. package/dist/targets.js +106 -47
  408. package/dist/targets.js.map +1 -1
  409. package/dist/trusted-executable.d.ts +2 -2
  410. package/dist/trusted-executable.d.ts.map +1 -1
  411. package/dist/trusted-executable.js +8 -6
  412. package/dist/trusted-executable.js.map +1 -1
  413. package/dist/value.js +7 -0
  414. package/dist/value.js.map +1 -1
  415. package/dist/version.js.map +1 -1
  416. package/dist/workbench-arguments.d.ts +3 -0
  417. package/dist/workbench-arguments.d.ts.map +1 -0
  418. package/dist/workbench-arguments.js +15 -0
  419. package/dist/workbench-arguments.js.map +1 -0
  420. package/dist/worker-progress.d.ts +1 -0
  421. package/dist/worker-progress.d.ts.map +1 -1
  422. package/dist/worker-progress.js +27 -12
  423. package/dist/worker-progress.js.map +1 -1
  424. package/docs/cli.md +1778 -0
  425. package/docs/findings-service.md +402 -0
  426. package/package.json +18 -19
  427. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  428. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  429. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  430. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  431. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  432. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  433. package/dist/server/dashboard/app.css +0 -2
  434. package/dist/server/dashboard/app.js +0 -66
  435. package/dist/server/dashboard/index.html +0 -18
  436. package/dist/server/dashboard-types.d.ts +0 -48
  437. package/dist/server/dashboard-types.d.ts.map +0 -1
  438. package/dist/server/dashboard-types.js +0 -2
  439. package/dist/server/dashboard-types.js.map +0 -1
  440. package/dist/server/dashboard.d.ts +0 -6
  441. package/dist/server/dashboard.d.ts.map +0 -1
  442. package/dist/server/dashboard.js +0 -59
  443. package/dist/server/dashboard.js.map +0 -1
  444. package/dist/server/index.d.ts +0 -2
  445. package/dist/server/index.d.ts.map +0 -1
  446. package/dist/server/index.js +0 -6
  447. package/dist/server/index.js.map +0 -1
  448. package/dist/server/routes.d.ts +0 -7
  449. package/dist/server/routes.d.ts.map +0 -1
  450. package/dist/server/routes.js +0 -98
  451. package/dist/server/routes.js.map +0 -1
  452. package/dist/server/serve.d.ts +0 -2
  453. package/dist/server/serve.d.ts.map +0 -1
  454. package/dist/server/serve.js +0 -28
  455. package/dist/server/serve.js.map +0 -1
  456. package/dist/server/server.d.ts +0 -10
  457. package/dist/server/server.d.ts.map +0 -1
  458. package/dist/server/server.js +0 -16
  459. package/dist/server/server.js.map +0 -1
  460. package/dist/server/validation.d.ts +0 -17
  461. package/dist/server/validation.d.ts.map +0 -1
  462. package/dist/server/validation.js +0 -53
  463. package/dist/server/validation.js.map +0 -1
@@ -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
@@ -710,19 +710,7 @@ def _merge_tied_parent_observations(
710
710
  coverage["resolvedDeferred"] = list(closures.values())
711
711
  if current.get("complete") is False or previous.get("complete") is False:
712
712
  merged["complete"] = False
713
- if (
714
- coverage.get("deferred")
715
- or merged.get("complete") is False
716
- or (
717
- isinstance(coverage.get("surfaces"), list)
718
- and any(
719
- isinstance(row, dict) and row.get("disposition") == "needs_follow_up"
720
- for row in coverage["surfaces"]
721
- )
722
- )
723
- or previous["coverage"].get("completeness") == "partial"
724
- ):
725
- coverage["completeness"] = "partial"
713
+ coverage.pop("completeness", None)
726
714
  return merged
727
715
 
728
716
 
@@ -890,7 +878,7 @@ def preserve_parent_head_on_error(scan_dir: Path) -> Iterator[None]:
890
878
  }
891
879
  try:
892
880
  yield
893
- except ContractError:
881
+ except BaseException:
894
882
  if previous is None:
895
883
  _remove_scan_local_file_if_exists(scan_dir, "checkpoint-head.json")
896
884
  else:
@@ -1294,7 +1282,6 @@ def merge_saved_results(
1294
1282
  copy.deepcopy(parent["coverage"])
1295
1283
  if parent and parent["coverage"]
1296
1284
  else {
1297
- "completeness": "partial",
1298
1285
  "mode": binding["coverageMode"],
1299
1286
  "inventoryStrategy": "diff"
1300
1287
  if binding["coverageMode"] in {"commit", "branch_diff", "working_tree"}
@@ -1702,17 +1689,6 @@ def merge_saved_results(
1702
1689
  and source_order[relative] >= accepted_order
1703
1690
  and any(isinstance(row, dict) for row in deferred_rows[relative])
1704
1691
  )
1705
- if (
1706
- (relative != "parent" or not parent_is_canonical)
1707
- and not superseded
1708
- and not selected_coverage_superseded
1709
- and (
1710
- draft.get("complete") is False
1711
- or draft["coverage"].get("completeness") != "complete"
1712
- )
1713
- and coverage.get("completeness") in {"complete", "unknown"}
1714
- ):
1715
- coverage["completeness"] = "partial"
1716
1692
  skip_superseded_findings = (
1717
1693
  superseded
1718
1694
  and not stopped
@@ -1818,7 +1794,6 @@ def merge_saved_results(
1818
1794
  for location in locations
1819
1795
  ):
1820
1796
  warnings.append(f"Skipped out-of-scope finding from {relative}.")
1821
- coverage["completeness"] = "partial"
1822
1797
  continue
1823
1798
  provenance = finding.setdefault("provenance", {"source": "local_plugin"})
1824
1799
  if not isinstance(provenance, dict):
@@ -2022,8 +1997,7 @@ def merge_saved_results(
2022
1997
  used.add(item["id"])
2023
1998
  if field == "surfaces":
2024
1999
  item.setdefault("receiptRefs", [])
2025
- if stopped or any(warning not in initial_warnings for warning in warnings):
2026
- coverage["completeness"] = "partial"
2000
+ coverage.pop("completeness", None)
2027
2001
  if stopped:
2028
2002
  if not isinstance(coverage.get("deferred"), list):
2029
2003
  coverage["deferred"] = []
@@ -2039,16 +2013,16 @@ def coverage_for_comparison(db: Any, scan: Any) -> dict[str, Any]:
2039
2013
  scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
2040
2014
  db.require_recorded_manifest_digest(scan, scan_dir)
2041
2015
  try:
2042
- _, _, manifest, _, coverage, was_sealed, _ = _prepare_scan_finalization(scan_dir)
2016
+ prepared = _prepare_scan_finalization(scan_dir)
2043
2017
  except ContractError as exc:
2044
2018
  raise SystemExit(str(exc)) from exc
2045
- if not was_sealed or manifest["scan"]["id"] != scan["id"]:
2019
+ if not prepared.was_sealed or prepared.manifest["scan"]["id"] != scan["id"]:
2046
2020
  raise SystemExit("Only sealed scans can be compared.")
2047
- return coverage
2021
+ return prepared.coverage
2048
2022
 
2049
2023
 
2050
- def _snapshot_published_outputs(scan_dir: Path) -> dict[str, bytes | None]:
2051
- snapshots: dict[str, bytes | None] = {}
2024
+ def _snapshot_published_outputs(scan_dir: Path) -> dict[str, tuple[bytes, os.stat_result] | None]:
2025
+ snapshots: dict[str, tuple[bytes, os.stat_result] | None] = {}
2052
2026
  for relative in _PUBLISHED_OUTPUTS:
2053
2027
  descriptor = -1
2054
2028
  try:
@@ -2057,7 +2031,8 @@ def _snapshot_published_outputs(scan_dir: Path) -> dict[str, bytes | None]:
2057
2031
  )
2058
2032
  with os.fdopen(descriptor, "rb") as handle:
2059
2033
  descriptor = -1
2060
- snapshots[relative] = handle.read()
2034
+ metadata = os.fstat(handle.fileno())
2035
+ snapshots[relative] = (handle.read(), metadata)
2061
2036
  except ContractError:
2062
2037
  path = scan_dir / relative
2063
2038
  if path.exists() or path.is_symlink():
@@ -2072,14 +2047,80 @@ def _snapshot_published_outputs(scan_dir: Path) -> dict[str, bytes | None]:
2072
2047
  return snapshots
2073
2048
 
2074
2049
 
2075
- def _restore_published_outputs(scan_dir: Path, snapshots: dict[str, bytes | None]) -> None:
2076
- for relative, contents in snapshots.items():
2077
- if contents is None:
2050
+ def _restore_published_outputs(
2051
+ scan_dir: Path, snapshots: dict[str, tuple[bytes, os.stat_result] | None]
2052
+ ) -> None:
2053
+ for relative, snapshot in snapshots.items():
2054
+ if snapshot is None:
2078
2055
  path = scan_dir / relative
2079
2056
  if path.exists() or path.is_symlink():
2080
2057
  _remove_scan_local_file_if_exists(scan_dir, relative)
2081
2058
  else:
2059
+ contents, metadata = snapshot
2082
2060
  write_scan_local_bytes(scan_dir, relative, contents)
2061
+ # Saved-result selection uses mtime; rollback must preserve its ordering.
2062
+ os.utime(scan_dir / relative, ns=(metadata.st_atime_ns, metadata.st_mtime_ns))
2063
+
2064
+
2065
+ @contextmanager
2066
+ def preserve_deep_deadline_draft(db: Any, connection: Any, scan: Any) -> Iterator[None]:
2067
+ """Recover a settled, zero-accepted Deep deadline without sealing the parent."""
2068
+ scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
2069
+ snapshots = _snapshot_published_outputs(scan_dir)
2070
+ warnings = json.loads(scan["completion_warnings_json"])
2071
+ binding = db.workbench_completion_binding(scan, db.now())
2072
+ with preserve_parent_head_on_error(scan_dir):
2073
+ try:
2074
+ documents = merge_saved_results(
2075
+ scan_dir,
2076
+ scan["id"],
2077
+ binding,
2078
+ connection.execute(
2079
+ "SELECT * FROM deep_scan_workers WHERE scan_id = ? ORDER BY created_at, id",
2080
+ (scan["id"],),
2081
+ ).fetchall(),
2082
+ warnings,
2083
+ stopped=True,
2084
+ reason=(
2085
+ "The configured discovery time limit elapsed before any source review completed. "
2086
+ "Saved findings and pending review were preserved without a completed reduction."
2087
+ ),
2088
+ )
2089
+ if documents is None:
2090
+ raise ContractError("Deep Scan deadline has no saved parent draft.")
2091
+ documents[0]["scan"].pop("complete", None)
2092
+ # Validate recovered evidence against the current finding contract,
2093
+ # scope, source lineage, and receipts before admitting this draft.
2094
+ prepared = _prepare_scan_finalization(
2095
+ scan_dir,
2096
+ expected_coverage_mode=db.expected_coverage_mode(scan),
2097
+ completion_binding=binding,
2098
+ recover_unsealed=True,
2099
+ draft_documents=documents,
2100
+ )
2101
+ warnings.extend(prepared.warnings)
2102
+ manifest, findings, coverage = prepared.manifest, prepared.findings, prepared.coverage
2103
+ manifest["scan"].pop("sealedAt", None)
2104
+ manifest["scan"].pop("artifacts", None)
2105
+ checkpoint = _parent_scan_draft(scan["id"], manifest["scan"], findings, coverage)
2106
+ contents = _encoded(checkpoint)
2107
+ name = f"{hashlib.sha256(contents).hexdigest()}.json"
2108
+ write_scan_local_bytes(scan_dir, f"checkpoints/{name}", contents)
2109
+ write_scan_local_bytes(scan_dir, "checkpoint-head.json", _encoded({"checkpoint": name}))
2110
+ for filename, document in (
2111
+ ("findings.json", findings),
2112
+ ("coverage.json", coverage),
2113
+ ("scan-manifest.json", manifest),
2114
+ ):
2115
+ write_scan_local_bytes(scan_dir, filename, _encoded(document))
2116
+ connection.execute(
2117
+ "UPDATE scans SET completion_warnings_json = ? WHERE id = ?",
2118
+ (json.dumps(list(dict.fromkeys(warnings))), scan["id"]),
2119
+ )
2120
+ yield
2121
+ except BaseException:
2122
+ _restore_published_outputs(scan_dir, snapshots)
2123
+ raise
2083
2124
 
2084
2125
 
2085
2126
  def preserve_scan_results_locked(
@@ -2272,9 +2313,11 @@ def preserve_scan_results_locked(
2272
2313
  scan_dir,
2273
2314
  expected_coverage_mode=db.expected_coverage_mode(scan),
2274
2315
  completion_binding=binding,
2275
- completion_warnings=warnings,
2316
+ recover_unsealed=True,
2276
2317
  draft_documents=documents,
2318
+ finding_scope=db.requested_finding_scope(scan) if scan["mode"] == "deep" else None,
2277
2319
  )
2320
+ warnings.extend(prepared.warnings)
2278
2321
  snapshots = _snapshot_published_outputs(scan_dir)
2279
2322
  try:
2280
2323
  manifest, findings, _ = _write_prepared_scan_finalization(
@@ -2386,6 +2429,66 @@ def save_scan_artifact(db: Any, connection: Any, args: Any) -> dict[str, Any]:
2386
2429
  return {"scanId": scan_id, "path": str(scan_dir / output)}
2387
2430
 
2388
2431
 
2432
+ def _require_current_deep_publication(
2433
+ db: Any, connection: Any, scan: Any, draft: dict[str, Any]
2434
+ ) -> None:
2435
+ scan_id = scan["id"]
2436
+ run = connection.execute(
2437
+ "SELECT * FROM deep_scan_runs WHERE scan_id = ?", (scan_id,)
2438
+ ).fetchone()
2439
+ publication = draft.get("deepScanPublication")
2440
+ if (
2441
+ publication is None
2442
+ and draft["manifest"]["scan"].get("complete") is False
2443
+ and (run is None or run["status"] == "running")
2444
+ ):
2445
+ return
2446
+ if run is None:
2447
+ run = db.deep_scan.require_deep_scan_run(connection, scan_id)
2448
+ # Finished discovery-only runs hand remaining publication back to the parent.
2449
+ if (
2450
+ publication is None
2451
+ and run["status"] != "running"
2452
+ and run["manifest_path"] != str(Path(scan["scan_dir"]) / "scan-manifest.json")
2453
+ ):
2454
+ return
2455
+ db.deep_scan.require_current_coordinator(
2456
+ run,
2457
+ argparse.Namespace(
2458
+ coordinator_generation=publication.get("coordinatorGeneration") if publication else None
2459
+ ),
2460
+ )
2461
+ # Once finish selects the canonical parent, only completion may replay it.
2462
+ if publication is None:
2463
+ if run["status"] != "running" and run["manifest_path"] == str(
2464
+ Path(scan["scan_dir"]) / "scan-manifest.json"
2465
+ ):
2466
+ raise SystemExit("Deep Scan is terminal; drafts cannot replace its publication.")
2467
+ return
2468
+
2469
+ # Match the durable reducer sequence used by coordinator recovery.
2470
+ def reducer_order(worker: Any) -> tuple[int, str]:
2471
+ match = re.fullmatch(r"dedup-([0-9]+)", Path(worker["prompt_path"]).parent.name)
2472
+ return (int(match[1]) if match else 0, worker["id"])
2473
+
2474
+ reducer = max(
2475
+ (
2476
+ worker
2477
+ for worker in connection.execute(
2478
+ "SELECT * FROM deep_scan_workers WHERE scan_id = ?", (scan_id,)
2479
+ )
2480
+ if worker["kind"] == "dedup"
2481
+ and worker["status"] == "succeeded"
2482
+ and worker["result_manifest_path"]
2483
+ ),
2484
+ key=reducer_order,
2485
+ default=None,
2486
+ )
2487
+ selected_result = reducer["result_manifest_path"] if reducer is not None else None
2488
+ if publication["resultPath"] != selected_result:
2489
+ raise SystemExit("Deep Scan aggregate belongs to a superseded publication selection.")
2490
+
2491
+
2389
2492
  def write_scan_draft(db: Any, connection: Any, args: Any) -> dict[str, Any]:
2390
2493
  scan_id = db.require_uuid(args.scan_id, "scan-id")
2391
2494
  with db.scan_completion_lock(scan_id):
@@ -2420,6 +2523,8 @@ def write_scan_draft(db: Any, connection: Any, args: Any) -> dict[str, Any]:
2420
2523
  _populate_unsealed_manifest_envelope(manifest, manifest["scan"], binding)
2421
2524
  _populate_unsealed_artifact_envelope(manifest, findings, coverage, binding)
2422
2525
  _validate_completion_binding(manifest, findings, coverage, binding)
2526
+ checkpoint = manifest["scan"]
2527
+ checkpoint_contents = None
2423
2528
  if args.checkpoint_path is not None:
2424
2529
  try:
2425
2530
  checkpoint_relative = Path(args.checkpoint_path).relative_to(scan_dir).as_posix()
@@ -2436,18 +2541,36 @@ def write_scan_draft(db: Any, connection: Any, args: Any) -> dict[str, Any]:
2436
2541
  )
2437
2542
  if checkpoint.get("scanId") != scan_id:
2438
2543
  raise SystemExit("Staged scan checkpoint belongs to another scan.")
2544
+ checkpoint_only = (
2545
+ scan["mode"] == "deep"
2546
+ and draft.get("deepScanPublication") is None
2547
+ and checkpoint.get("complete") is False
2548
+ and connection.execute(
2549
+ "SELECT 1 FROM deep_scan_runs WHERE scan_id = ? "
2550
+ "AND status = 'running' AND manifest_path = ?",
2551
+ (scan_id, str(scan_dir / "scan-manifest.json")),
2552
+ ).fetchone()
2553
+ is not None
2554
+ )
2555
+ if scan["mode"] == "deep" and not checkpoint_only:
2556
+ _require_current_deep_publication(db, connection, scan, draft)
2557
+ if checkpoint_contents is not None:
2439
2558
  checkpoint_digest = hashlib.sha256(checkpoint_contents).hexdigest()
2440
2559
  write_scan_local_bytes(
2441
2560
  scan_dir,
2442
2561
  f"checkpoints/{checkpoint_digest}.json",
2443
2562
  checkpoint_contents,
2444
2563
  )
2564
+ if checkpoint_only:
2565
+ return {"scanId": scan_id, "status": "draft_written"}
2445
2566
  checkpoint = _parent_scan_draft(scan_id, manifest["scan"], findings, coverage)
2446
2567
  checkpoint_contents = _encoded(checkpoint)
2447
2568
  checkpoint_name = f"{hashlib.sha256(checkpoint_contents).hexdigest()}.json"
2448
2569
  checkpoint_relative = f"checkpoints/{checkpoint_name}"
2449
2570
  if not (scan_dir / checkpoint_relative).exists():
2450
2571
  write_scan_local_bytes(scan_dir, checkpoint_relative, checkpoint_contents)
2572
+ if checkpoint_only:
2573
+ return {"scanId": scan_id, "status": "draft_written"}
2451
2574
  write_scan_local_bytes(
2452
2575
  scan_dir, "checkpoint-head.json", _encoded({"checkpoint": checkpoint_name})
2453
2576
  )
@@ -2461,6 +2584,14 @@ def write_scan_draft(db: Any, connection: Any, args: Any) -> dict[str, Any]:
2461
2584
  filename,
2462
2585
  (json.dumps(document, allow_nan=False, indent=2) + "\n").encode(),
2463
2586
  )
2587
+ if scan["mode"] == "deep" and manifest["scan"].get("complete") is not False:
2588
+ # Select the accepted final publication before releasing the write lock.
2589
+ with connection:
2590
+ connection.execute(
2591
+ "UPDATE deep_scan_runs SET manifest_path = ? "
2592
+ "WHERE scan_id = ? AND status = 'running'",
2593
+ (str(scan_dir / "scan-manifest.json"), scan_id),
2594
+ )
2464
2595
  model_warning = write_threat_model_projection_if_possible(scan_dir, manifest)
2465
2596
  # Accepted Standard drafts are evidence of review or report assembly,
2466
2597
  # even when the parent omitted its explicit progress call.
@@ -2526,7 +2657,7 @@ def fail_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
2526
2657
  scan_id = db.require_uuid(args.scan_id, "scan-id")
2527
2658
  cost_json = db.parse_scan_cost(args.cost_json)
2528
2659
  connection.execute("BEGIN IMMEDIATE")
2529
- try:
2660
+ with connection:
2530
2661
  timestamp = db.now()
2531
2662
  scan = db.require_scan(connection, scan_id)
2532
2663
  if scan["status"] == "failed":
@@ -2558,10 +2689,6 @@ def fail_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
2558
2689
  )
2559
2690
  if progress_updated.rowcount != 1:
2560
2691
  raise SystemExit("Codex Security scan progress not found.")
2561
- connection.commit()
2562
- except BaseException:
2563
- connection.rollback()
2564
- raise
2565
2692
  preserve_stopped_results_after_transition(db, connection, scan["id"])
2566
2693
  return db.scan_context(connection, scan["id"])
2567
2694
 
@@ -2575,7 +2702,7 @@ def cancel_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
2575
2702
  scan_id = db.require_uuid(args.scan_id, "scan-id")
2576
2703
  thread_id = db.optional_text(args.thread_id, maximum=512)
2577
2704
  connection.execute("BEGIN IMMEDIATE")
2578
- try:
2705
+ with connection:
2579
2706
  timestamp = db.now()
2580
2707
  scan = db.require_scan(connection, scan_id)
2581
2708
  workspace = db.require_workspace(connection, scan["workspace_id"])
@@ -2604,10 +2731,6 @@ def cancel_scan_locked(db: Any, connection: Any, args: Any) -> dict[str, Any]:
2604
2731
  )
2605
2732
  if progress_updated.rowcount != 1:
2606
2733
  raise SystemExit("Codex Security scan progress not found.")
2607
- connection.commit()
2608
- except BaseException:
2609
- connection.rollback()
2610
- raise
2611
2734
  preserve_stopped_results_after_transition(db, connection, scan["id"])
2612
2735
  return db.workspace_state(connection, scan["workspace_id"])
2613
2736
 
@@ -20,7 +20,16 @@ from workbench_constants import ARTIFACTS, FINDINGS_PAGE_MAX
20
20
  from workbench_scan_start import scan_target_identity
21
21
  from workbench_scan_usage import stored_scan_cost_fields
22
22
  from workbench_target import git_output, require_scan_target_identity
23
- from workbench_validation import reject_non_finite_json
23
+ from workbench_validation import reject_non_finite_json, timestamp_key
24
+
25
+
26
+ def rename_scan(connection: sqlite3.Connection, scan: sqlite3.Row, name: str) -> dict[str, Any]:
27
+ name = name.strip()
28
+ if not name:
29
+ raise SystemExit("Scan name cannot be empty.")
30
+ connection.execute("UPDATE scans SET name = ? WHERE id = ?", (name, scan["id"]))
31
+ connection.commit()
32
+ return {"scanId": scan["id"], "name": name}
24
33
 
25
34
 
26
35
  def scan_recipe(scan: sqlite3.Row) -> dict[str, Any]:
@@ -48,16 +57,10 @@ def preserve_sealed_completion(
48
57
 
49
58
 
50
59
  def cli_scan_resume(
60
+ wb: Any,
51
61
  connection: sqlite3.Connection,
52
62
  scan: sqlite3.Row,
53
63
  workspace: sqlite3.Row,
54
- *,
55
- parse_scan_recipe: Callable[[str, Path], dict[str, Any]],
56
- scan_contract: Callable[[sqlite3.Row], dict[str, Any]],
57
- require_scan_directory: Callable[[Path], Path],
58
- artifact_path: Callable[..., Path | None],
59
- read_json_object: Callable[[Path], dict[str, Any]],
60
- workbench_completion_binding: Callable[..., dict[str, Any]],
61
64
  ) -> dict[str, Any]:
62
65
  if scan["mode"] != "deep" or scan["recipe_json"] is None:
63
66
  raise SystemExit("Resume requires a Deep Scan with a saved CLI launch recipe.")
@@ -94,13 +97,13 @@ def cli_scan_resume(
94
97
  scan["target_inode"],
95
98
  ):
96
99
  raise SystemExit("Cannot resume: the original checkout revision or contents changed.")
97
- recipe = parse_scan_recipe(scan["recipe_json"], repository)
98
- scan_dir = require_scan_directory(Path(scan["scan_dir"]))
100
+ recipe = wb.parse_scan_recipe(scan["recipe_json"], repository)
101
+ scan_dir = wb.require_canonical_scan_directory(Path(scan["scan_dir"]))
99
102
  progress = connection.execute(
100
103
  "SELECT scope_file_count FROM scan_progress WHERE scan_id = ?", (scan["id"],)
101
104
  ).fetchone()
102
105
  result = {
103
- "contract": scan_contract(scan),
106
+ "contract": wb.scan_contract(scan),
104
107
  "recipe": recipe,
105
108
  "scanDir": str(scan_dir),
106
109
  "scanId": scan["id"],
@@ -114,16 +117,16 @@ def cli_scan_resume(
114
117
  # Active coordinators may still be writing drafts. Validate sealed results
115
118
  # before attaching to a coordinator that has finished.
116
119
  if run is not None and run["status"] == "succeeded":
117
- manifest_path = artifact_path(scan_dir, ARTIFACTS["manifest"], required=False)
120
+ manifest_path = wb.artifact_path(scan_dir, ARTIFACTS["manifest"], required=False)
118
121
  if manifest_path is not None:
119
- manifest = read_json_object(manifest_path)
122
+ manifest = wb.read_json_object(manifest_path)
120
123
  manifest_scan = manifest.get("scan")
121
124
  if isinstance(manifest_scan, dict) and (
122
125
  manifest_scan.get("sealedAt") is not None
123
126
  or manifest_scan.get("artifacts") is not None
124
127
  ):
125
128
  try:
126
- binding = workbench_completion_binding(scan, scan["started_at"], manifest)
129
+ binding = wb.workbench_completion_binding(scan, scan["started_at"], manifest)
127
130
  _prepare_scan_finalization(
128
131
  scan_dir,
129
132
  expected_coverage_mode=binding["coverageMode"],
@@ -201,6 +204,7 @@ def _repository_origin(target: Path) -> tuple[str, str] | None:
201
204
  def list_scans(
202
205
  connection: sqlite3.Connection, args: argparse.Namespace | None = None
203
206
  ) -> dict[str, Any]:
207
+ connection.create_function("casefold", 1, str.casefold, deterministic=True)
204
208
  if os.name == "nt":
205
209
  connection.create_function("codex_security_path_key", 1, _windows_path_key)
206
210
  clauses: list[str] = []
@@ -261,12 +265,13 @@ def list_scans(
261
265
  query = args.query.strip().casefold()
262
266
  if query:
263
267
  clauses.append(
264
- "(instr(lower(scans.target_path), ?) > 0 "
265
- "OR instr(lower(COALESCE(scans.target_summary, '')), ?) > 0 "
266
- "OR instr(lower(scans.scope), ?) > 0 "
267
- "OR instr(lower(scans.mode), ?) > 0)"
268
+ "(instr(casefold(scans.target_path), ?) > 0 "
269
+ "OR instr(casefold(COALESCE(scans.name, '')), ?) > 0 "
270
+ "OR instr(casefold(COALESCE(scans.target_summary, '')), ?) > 0 "
271
+ "OR instr(casefold(scans.scope), ?) > 0 "
272
+ "OR instr(casefold(scans.mode), ?) > 0)"
268
273
  )
269
- values.extend((query, query, query, query))
274
+ values.extend((query, query, query, query, query))
270
275
  where = f"WHERE {' AND '.join(clauses)}" if clauses else ""
271
276
  paginated = args is not None and (args.limit is not None or args.offset != 0)
272
277
  limit = min(args.limit or FINDINGS_PAGE_MAX, FINDINGS_PAGE_MAX) if paginated else None
@@ -292,8 +297,8 @@ def list_scans(
292
297
  {where}
293
298
  ORDER BY
294
299
  CASE WHEN scans.status = 'running' AND scans.canceled_at IS NULL THEN 0 ELSE 1 END,
295
- MAX(scans.updated_at, progress.updated_at) DESC,
296
- scans.started_at DESC,
300
+ MAX(julianday(upper(scans.updated_at)), julianday(upper(progress.updated_at))) DESC,
301
+ julianday(upper(scans.started_at)) DESC,
297
302
  scans.id
298
303
  {pagination}
299
304
  """,
@@ -309,6 +314,7 @@ def list_scans(
309
314
  "handoffStatus": row["handoff_status"],
310
315
  "mode": row["mode"],
311
316
  "model": row["model"],
317
+ "name": row["name"],
312
318
  "parentScanId": row["parent_scan_id"],
313
319
  "progress": {
314
320
  "candidates": {"reportable": row["reportable_findings_count"]},
@@ -331,7 +337,11 @@ def list_scans(
331
337
  "targetPath": row["target_path"],
332
338
  "targetRevision": row["target_revision"],
333
339
  "targetSummary": row["target_summary"],
334
- "updatedAt": max(row["updated_at"], row["progress_updated_at"]),
340
+ "updatedAt": max(
341
+ row["updated_at"],
342
+ row["progress_updated_at"],
343
+ key=lambda value: (timestamp_key(value), value),
344
+ ),
335
345
  **(
336
346
  {"warnings": json.loads(row["completion_warnings_json"])}
337
347
  if row["completion_warnings_json"] != "[]"
@@ -454,7 +464,7 @@ def _saved_finding_links(connection: sqlite3.Connection, scan_ids: set[str]) ->
454
464
  FROM scan_comparison_matches AS matches
455
465
  JOIN finding_occurrences AS before ON before.id = matches.before_occurrence_id
456
466
  JOIN finding_occurrences AS after ON after.id = matches.after_occurrence_id
457
- WHERE matches.before_scan_id IN ({placeholders})
467
+ WHERE matches.before_scan_id IN (SELECT value FROM json_each(?))
458
468
  ORDER BY matches.before_scan_id, after.scan_id, before.finding_id, after.finding_id
459
469
  """,
460
470
  sorted(scan_ids),
@@ -529,7 +539,6 @@ def compare_scans(
529
539
  backfill_finding_details(connection, before)
530
540
  backfill_finding_details(connection, after)
531
541
  after_coverage = read_coverage(after)
532
- comparable = after_coverage.get("completeness") == "complete"
533
542
  before_findings = _scan_findings(connection, before["id"])
534
543
  after_findings = _scan_findings(connection, after["id"])
535
544
  matches = json.loads(cached["result_json"]) if cached is not None else None
@@ -549,7 +558,10 @@ def compare_scans(
549
558
  else {}
550
559
  )
551
560
  findings: list[dict[str, Any]] = []
552
- summary = {status: 0 for status in ("new", "persisting", "resolved", "reopened", "unknown")}
561
+ summary = {
562
+ status: 0
563
+ for status in ("new", "persisting", "resolved", "not_observed", "reopened", "unknown")
564
+ }
553
565
 
554
566
  for previous_rows, current_rows, match_reason in groups:
555
567
  previous = (
@@ -599,9 +611,6 @@ def compare_scans(
599
611
  elif uncertain_reason is not None:
600
612
  status = "unknown"
601
613
  item["reason"] = uncertain_reason
602
- elif not comparable:
603
- status = "unknown"
604
- item["reason"] = "The later scan has incomplete coverage."
605
614
  elif not all(
606
615
  scan_covers_path(
607
616
  after,
@@ -613,8 +622,14 @@ def compare_scans(
613
622
  ):
614
623
  status = "unknown"
615
624
  item["reason"] = "The affected path was excluded or outside the later scope."
616
- else:
625
+ elif all(
626
+ row["triage_status"] == "closed" and row["close_reason"] == "already_fixed"
627
+ for row in previous_rows
628
+ ):
617
629
  status = "resolved"
630
+ else:
631
+ status = "not_observed"
632
+ item["reason"] = "Not observed in the later scan; remediation has not been verified."
618
633
  if len(previous_rows) == 1:
619
634
  item["beforeOccurrenceId"] = previous["id"]
620
635
  elif previous_rows:
@@ -635,8 +650,6 @@ def compare_scans(
635
650
  result = {
636
651
  "afterScanId": after["id"],
637
652
  "beforeScanId": before["id"],
638
- "comparable": comparable,
639
- "coverage": {"afterCompleteness": after_coverage.get("completeness")},
640
653
  "findings": findings,
641
654
  "repository": before["target_path"],
642
655
  "summary": summary,
@@ -822,14 +835,8 @@ def _rows_for_ids(
822
835
  connection: sqlite3.Connection, query: str, ids: Iterable[str]
823
836
  ) -> Iterator[sqlite3.Row]:
824
837
  values = tuple(dict.fromkeys(ids))
825
- getlimit = getattr(connection, "getlimit", None)
826
- # Python 3.10 lacks getlimit; 999 is SQLite's older host-parameter limit.
827
- limit = getlimit(sqlite3.SQLITE_LIMIT_VARIABLE_NUMBER) if getlimit else 999
828
- for start in range(0, len(values), limit):
829
- batch = values[start : start + limit]
830
- yield from connection.execute(
831
- query.format(placeholders=", ".join("?" for _ in batch)), batch
832
- )
838
+ if values:
839
+ yield from connection.execute(query, (json.dumps(values),))
833
840
 
834
841
 
835
842
  # Stable finding IDs already include the target identity. Follow their indexed
@@ -849,7 +856,7 @@ _LINKED_FINDINGS_SQL = f"""
849
856
  WITH RECURSIVE linked(finding_id) AS (
850
857
  SELECT occurrences.finding_id
851
858
  FROM finding_occurrences AS occurrences
852
- WHERE occurrences.id IN ({{placeholders}})
859
+ WHERE occurrences.id IN (SELECT value FROM json_each(?))
853
860
  UNION
854
861
  SELECT neighbor.finding_id
855
862
  {_FINDING_NEIGHBORS_SQL}
@@ -918,7 +925,7 @@ def finding_relations(
918
925
  for row in _rows_for_ids(
919
926
  connection,
920
927
  "SELECT id, finding_id, scan_id, title FROM finding_occurrences "
921
- "WHERE id IN ({placeholders})",
928
+ "WHERE id IN (SELECT value FROM json_each(?))",
922
929
  (pair[key] for pair in pairs for key in ("beforeOccurrenceId", "afterOccurrenceId")),
923
930
  )
924
931
  }
@@ -1087,9 +1094,13 @@ def finding_occurrence_rows(
1087
1094
  severity: str | None = None,
1088
1095
  status: str | None = None,
1089
1096
  ) -> list[sqlite3.Row]:
1097
+ connection.create_function("casefold", 1, str.casefold, deterministic=True)
1090
1098
  conditions, values = finding_occurrence_conditions(
1091
1099
  scan_id, query=query, severity=severity, status=status
1092
1100
  )
1101
+ severity_order = " ".join(
1102
+ f"WHEN '{level}' THEN {rank}" for level, rank in SEVERITY_ORDER.items()
1103
+ )
1093
1104
  return connection.execute(
1094
1105
  f"""
1095
1106
  SELECT
@@ -1106,14 +1117,7 @@ def finding_occurrence_rows(
1106
1117
  LEFT JOIN finding_triage AS triage ON triage.occurrence_id = occurrences.id
1107
1118
  WHERE {conditions}
1108
1119
  ORDER BY
1109
- CASE occurrences.severity
1110
- WHEN 'critical' THEN 0
1111
- WHEN 'high' THEN 1
1112
- WHEN 'medium' THEN 2
1113
- WHEN 'low' THEN 3
1114
- WHEN 'informational' THEN 4
1115
- ELSE 5
1116
- END,
1120
+ CASE occurrences.severity {severity_order} ELSE 5 END,
1117
1121
  occurrences.created_at,
1118
1122
  occurrences.id
1119
1123
  LIMIT ? OFFSET ?
@@ -1141,12 +1145,12 @@ def finding_occurrence_conditions(
1141
1145
  search = query.strip().casefold()
1142
1146
  if search:
1143
1147
  conditions.append(
1144
- "(instr(lower(occurrences.title), ?) > 0 "
1145
- "OR instr(lower(occurrences.summary), ?) > 0 "
1148
+ "(instr(casefold(occurrences.title), ?) > 0 "
1149
+ "OR instr(casefold(occurrences.summary), ?) > 0 "
1146
1150
  "OR EXISTS ("
1147
1151
  "SELECT 1 FROM finding_locations AS locations "
1148
1152
  "WHERE locations.occurrence_id = occurrences.id "
1149
- "AND instr(lower(locations.relative_path), ?) > 0))"
1153
+ "AND instr(casefold(locations.relative_path), ?) > 0))"
1150
1154
  )
1151
1155
  values.extend((search, search, search))
1152
1156
  return " AND ".join(conditions), values
@@ -1181,11 +1185,7 @@ def scan_covers_path(
1181
1185
  path: str | None,
1182
1186
  coverage: dict[str, Any],
1183
1187
  ) -> bool:
1184
- if (
1185
- scan["status"] != "complete"
1186
- or scan["target_id"] != target_id
1187
- or coverage.get("completeness") != "complete"
1188
- ):
1188
+ if scan["status"] != "complete" or scan["target_id"] != target_id:
1189
1189
  return False
1190
1190
  if not isinstance(path, str) or not path:
1191
1191
  return False