@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
@@ -33,8 +33,9 @@ def get_scan_feedback(connection: sqlite3.Connection, scan: sqlite3.Row) -> dict
33
33
  locations.relative_path, locations.start_line, locations.end_line, locations.role,
34
34
  ROW_NUMBER() OVER (
35
35
  PARTITION BY findings.id
36
- ORDER BY COALESCE(triage.updated_at, source_scans.completed_at) DESC,
37
- source_scans.completed_at DESC,
36
+ ORDER BY
37
+ julianday(upper(COALESCE(triage.updated_at, source_scans.completed_at))) DESC,
38
+ julianday(upper(source_scans.completed_at)) DESC,
38
39
  source_scans.id DESC, occurrences.id DESC
39
40
  ) AS decision_rank
40
41
  FROM finding_occurrences AS occurrences
@@ -60,7 +61,9 @@ def get_scan_feedback(connection: sqlite3.Connection, scan: sqlite3.Row) -> dict
60
61
  AND close_reason = 'false_positive'
61
62
  AND note IS NOT NULL
62
63
  AND trim(note) != ''
63
- ORDER BY updated_at DESC, source_completed_at DESC, source_scan_id DESC, finding_id DESC
64
+ ORDER BY julianday(upper(updated_at)) DESC,
65
+ julianday(upper(source_completed_at)) DESC,
66
+ source_scan_id DESC, finding_id DESC
64
67
  LIMIT 50
65
68
  """,
66
69
  (scan["target_id"], scan["id"]),
@@ -5,8 +5,15 @@ from __future__ import annotations
5
5
  import argparse
6
6
  import json
7
7
  import sqlite3
8
+ from decimal import Decimal
8
9
  from typing import Any
9
10
 
11
+ # Tag numbers so 10 and 10.0 compare equally without treating true as 1.
12
+ _finding_json = json.JSONDecoder(
13
+ parse_int=lambda value: (Decimal(value),),
14
+ parse_float=lambda value: (Decimal(value),),
15
+ )
16
+
10
17
 
11
18
  def upsert_finding(
12
19
  connection: sqlite3.Connection,
@@ -14,6 +21,17 @@ def upsert_finding(
14
21
  timestamp: str,
15
22
  repository_id: str | None = None,
16
23
  ) -> None:
24
+ current = connection.execute(
25
+ "SELECT details_json FROM findings WHERE id = ?", (finding["findingId"],)
26
+ ).fetchone()
27
+ details = json.dumps(finding, allow_nan=False, sort_keys=True)
28
+ # Preserve unchanged text without conflating JSON booleans and numbers.
29
+ if (
30
+ current is not None
31
+ and current["details_json"] is not None
32
+ and _finding_json.decode(current["details_json"]) == _finding_json.decode(details)
33
+ ):
34
+ details = current["details_json"]
17
35
  connection.execute(
18
36
  """
19
37
  INSERT INTO findings (
@@ -34,7 +52,7 @@ def upsert_finding(
34
52
  finding["ruleId"],
35
53
  finding["identity"]["anchor"],
36
54
  finding["identity"].get("instance"),
37
- json.dumps(finding, allow_nan=False, sort_keys=True),
55
+ details,
38
56
  timestamp,
39
57
  timestamp,
40
58
  ),
@@ -11,7 +11,7 @@ from pathlib import Path
11
11
  from typing import Any
12
12
 
13
13
  sys.path.insert(0, str(Path(__file__).resolve().parent))
14
- from workbench_target import directory_content_digest, git_output, git_revision
14
+ from workbench_target import directory_content_digest, git_bytes, git_revision
15
15
 
16
16
  WORKFLOW_BINDINGS = {
17
17
  "repositoryPath": "repository_path",
@@ -124,14 +124,28 @@ def finding_workflow(
124
124
  return {"workflow": read_workflow(connection, workflow_id)}
125
125
  if payload["action"] == "source":
126
126
  target = Path(payload["repository"]).resolve(strict=True)
127
+ private_paths = payload.get("privateStatePaths", [])
128
+ if not isinstance(private_paths, list) or any(
129
+ not isinstance(path, str) or not Path(path).is_absolute() for path in private_paths
130
+ ):
131
+ raise SystemExit("Private runtime paths must be absolute paths.")
132
+ excluded = tuple(sorted({Path(path).resolve() for path in private_paths}))
133
+ excluded = tuple(path for path in excluded if path.is_relative_to(target))
134
+ if target in excluded:
135
+ raise SystemExit("Private runtime storage must not exclude the repository root.")
127
136
  return {
128
137
  "source": {
129
138
  "repository": str(target),
130
- "revision": git_revision(target),
139
+ "revision": "unversioned" if payload.get("gitDisabled") else git_revision(target),
131
140
  "refsDigest": hashlib.sha256(
132
- (git_output(target, "show-ref") or "").encode()
141
+ b""
142
+ if payload.get("gitDisabled")
143
+ else (git_bytes(target, "show-ref") or b"").strip()
133
144
  ).hexdigest(),
134
- "content": directory_content_digest(target, include_ignored=True),
145
+ "content": directory_content_digest(
146
+ target, excluded=excluded, include_ignored=True
147
+ ),
148
+ **({"privateStatePaths": [str(path) for path in excluded]} if excluded else {}),
135
149
  }
136
150
  }
137
151
  if payload["action"] == "get-review":
@@ -0,0 +1,136 @@
1
+ """Prepare and cache embeddings without publishing findings to an HTTP service."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import hashlib
7
+ import json
8
+ import math
9
+ import sqlite3
10
+ import sys
11
+ from pathlib import Path
12
+ from typing import Any
13
+
14
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
15
+ from workbench_finding_index import upsert_finding
16
+ from workbench_target_state import stable_target_id
17
+
18
+
19
+ def cache_key(space: str, document: str) -> str:
20
+ return hashlib.sha256(f"{space}\0{document}".encode()).hexdigest()
21
+
22
+
23
+ def local_dedupe(
24
+ connection: sqlite3.Connection, payload: dict[str, Any], timestamp: str
25
+ ) -> dict[str, Any]:
26
+ action = payload["action"]
27
+ try:
28
+ with connection:
29
+ connection.execute("BEGIN IMMEDIATE")
30
+ if action == "prepare":
31
+ return prepare(connection, payload, timestamp)
32
+ if action == "embed":
33
+ for entry in payload["entries"]:
34
+ row = connection.execute(
35
+ "SELECT details_json FROM findings WHERE id = ?", (entry["findingId"],)
36
+ ).fetchone()
37
+ if (
38
+ row is None
39
+ or cache_key(payload["space"], row["details_json"]) != entry["cacheKey"]
40
+ ):
41
+ raise ValueError("finding_changed")
42
+ embedding = entry["embedding"]
43
+ vector = embedding["vector"]
44
+ if (
45
+ embedding["model"] != payload["model"]
46
+ or len(vector) != payload["dimensions"]
47
+ or not all(isinstance(v, (int, float)) and math.isfinite(v) for v in vector)
48
+ or not math.isfinite(math.hypot(*vector))
49
+ or math.hypot(*vector) == 0
50
+ ):
51
+ raise ValueError("embedding_failed")
52
+ connection.execute(
53
+ "INSERT INTO local_finding_embeddings (finding_id, model, vector_json, cache_key) "
54
+ "VALUES (?, ?, ?, ?) ON CONFLICT(finding_id) DO UPDATE SET "
55
+ "model = excluded.model, vector_json = excluded.vector_json, "
56
+ "cache_key = excluded.cache_key",
57
+ (
58
+ entry["findingId"],
59
+ embedding["model"],
60
+ json.dumps(vector, allow_nan=False),
61
+ entry["cacheKey"],
62
+ ),
63
+ )
64
+ return {}
65
+ raise ValueError("invalid_request")
66
+ except sqlite3.IntegrityError:
67
+ return {"error": "finding_conflict"}
68
+ except ValueError as exc:
69
+ return {"error": str(exc)}
70
+
71
+
72
+ def prepare(
73
+ connection: sqlite3.Connection, payload: dict[str, Any], timestamp: str
74
+ ) -> dict[str, Any]:
75
+ # Artifact seals establish consistency, not permission to select another local corpus.
76
+ target = Path(payload["repositoryPath"]).resolve()
77
+ registered = connection.execute(
78
+ "SELECT id FROM security_targets WHERE current_path = ?", (str(target),)
79
+ ).fetchone()
80
+ target_id = registered["id"] if registered is not None else stable_target_id(target)
81
+ if (
82
+ payload["anchorRepositoryId"] != target_id
83
+ or payload.get("repositoryId", target_id) != target_id
84
+ ):
85
+ raise ValueError("target_mismatch")
86
+ if not payload["findings"]:
87
+ return {"cacheKeys": {}, "findingsToEmbed": []}
88
+ # A sealed historical scan selects logical IDs; never overwrite their current bodies.
89
+ for finding in payload["findings"]:
90
+ existing = connection.execute(
91
+ "SELECT fingerprint, rule_id, identity_anchor, identity_instance, details_json "
92
+ "FROM findings WHERE id = ?",
93
+ (finding["findingId"],),
94
+ ).fetchone()
95
+ identity = (
96
+ finding["fingerprints"]["primary"],
97
+ finding["ruleId"],
98
+ finding["identity"]["anchor"],
99
+ finding["identity"].get("instance"),
100
+ )
101
+ if existing is not None and tuple(existing)[:4] != identity:
102
+ raise sqlite3.IntegrityError("Conflicting finding identity")
103
+ if existing is None or existing["details_json"] is None:
104
+ upsert_finding(connection, finding, timestamp, payload["anchorRepositoryId"])
105
+ else:
106
+ connection.execute(
107
+ "INSERT OR IGNORE INTO finding_repositories (repository_id, finding_id) VALUES (?, ?)",
108
+ (payload["anchorRepositoryId"], finding["findingId"]),
109
+ )
110
+ repository_id = payload.get("repositoryId")
111
+ rows = connection.execute(
112
+ "SELECT findings.id, findings.details_json, embeddings.cache_key FROM findings "
113
+ "LEFT JOIN local_finding_embeddings AS embeddings ON findings.id = embeddings.finding_id "
114
+ + (
115
+ "WHERE EXISTS (SELECT 1 FROM finding_repositories WHERE finding_id = findings.id "
116
+ "AND repository_id = ?) "
117
+ if repository_id is not None
118
+ else ""
119
+ )
120
+ + "ORDER BY findings.created_at, findings.id",
121
+ (repository_id,) if repository_id is not None else (),
122
+ )
123
+ cache_keys = {}
124
+ findings_to_embed = []
125
+ for row in rows:
126
+ if row["details_json"] is None:
127
+ raise ValueError("finding_not_indexed")
128
+ key = cache_key(payload["space"], row["details_json"])
129
+ cache_keys[row["id"]] = key
130
+ if key != row["cache_key"]:
131
+ findings_to_embed.append(json.loads(row["details_json"]))
132
+ return {"cacheKeys": cache_keys, "findingsToEmbed": findings_to_embed}
133
+
134
+
135
+ if __name__ == "__main__":
136
+ argparse.ArgumentParser(description=__doc__).parse_args()
@@ -13,7 +13,7 @@ from typing import Any
13
13
  sys.path.insert(0, str(Path(__file__).resolve().parent))
14
14
  import workbench_scan_history as scan_history
15
15
  from workbench_constants import FINDING_SUMMARY_BYTES, FINDING_TITLE_BYTES, FINDINGS_PAGE_MAX
16
- from workbench_validation import bounded_output_text
16
+ from workbench_validation import bounded_output_text, timestamp_key
17
17
 
18
18
 
19
19
  def list_global_findings(
@@ -101,7 +101,7 @@ def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]
101
101
 
102
102
  latest_scan_by_target = dict(
103
103
  connection.execute(
104
- "SELECT target_id, id FROM scans WHERE status = 'complete' ORDER BY started_at, id"
104
+ "SELECT target_id, id FROM scans WHERE status = 'complete' ORDER BY julianday(upper(started_at)), id"
105
105
  )
106
106
  )
107
107
 
@@ -118,7 +118,7 @@ def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]
118
118
  scans.target_id,
119
119
  targets.current_path AS target_path,
120
120
  scans.scope,
121
- MAX(scans.updated_at, COALESCE(triage.updated_at, '')) AS updated_at,
121
+ scans.updated_at,
122
122
  triage.status AS decision_status,
123
123
  triage.close_reason,
124
124
  triage.updated_at AS decision_updated_at,
@@ -143,33 +143,46 @@ def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]
143
143
 
144
144
  findings = []
145
145
  for occurrences in grouped.values():
146
- latest = max(occurrences, key=lambda row: (row["created_at"], row["occurrence_id"]))
146
+ latest = max(
147
+ occurrences,
148
+ key=lambda row: (timestamp_key(row["created_at"]), row["occurrence_id"]),
149
+ )
147
150
  decision = max(
148
151
  (row for row in occurrences if row["decision_status"] is not None),
149
- key=lambda row: (row["decision_updated_at"], row["occurrence_id"]),
152
+ key=lambda row: (timestamp_key(row["decision_updated_at"]), row["occurrence_id"]),
150
153
  default=None,
151
154
  )
152
155
  status = decision["decision_status"] if decision is not None else "open"
153
156
  if (
154
157
  status == "closed"
155
158
  and decision["close_reason"] == "already_fixed"
156
- and latest["created_at"] > decision["decision_updated_at"]
159
+ and timestamp_key(latest["created_at"]) > timestamp_key(decision["decision_updated_at"])
157
160
  ):
158
161
  status = "open"
159
- scans = sorted({(row["scan_started_at"], row["scan_id"]) for row in occurrences})
162
+ scans = sorted(
163
+ {(row["scan_started_at"], row["scan_id"]) for row in occurrences},
164
+ key=lambda scan: (timestamp_key(scan[0]), scan[1]),
165
+ )
160
166
  findings.append(
161
167
  {
162
168
  **dict(latest),
163
- "confirmed_in_latest_scan": latest_scan_by_target.get(latest["target_id"])
164
- == latest["scan_id"],
169
+ "confirmed_in_latest_scan": any(
170
+ row["scan_id"] == latest_scan_by_target.get(row["target_id"])
171
+ for row in occurrences
172
+ ),
165
173
  "known_since": scans[0][0],
166
174
  "known_scan_ids": [scan_id for _, scan_id in scans],
167
175
  "matched_finding_ids": sorted({row["finding_id"] for row in occurrences}),
168
176
  "occurrence_count": len(occurrences),
169
177
  "status": status,
170
- "updated_at": max(
171
- latest["updated_at"],
172
- decision["decision_updated_at"] if decision is not None else "",
178
+ "updated_at": (
179
+ max(
180
+ latest["updated_at"],
181
+ decision["decision_updated_at"],
182
+ key=lambda value: (timestamp_key(value), value),
183
+ )
184
+ if decision is not None
185
+ else latest["updated_at"]
173
186
  ),
174
187
  }
175
188
  )
@@ -179,7 +192,7 @@ def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]
179
192
  key=lambda finding: (
180
193
  finding["status"] == "open",
181
194
  -scan_history.SEVERITY_ORDER.get(finding["severity"], 5),
182
- finding["created_at"],
195
+ timestamp_key(finding["created_at"]),
183
196
  ),
184
197
  reverse=True,
185
198
  )
@@ -196,7 +209,7 @@ def list_repositories(
196
209
 
197
210
  latest_scan_by_target: dict[str, dict[str, Any]] = {}
198
211
  for row in connection.execute(
199
- "SELECT id, target_id FROM scans ORDER BY started_at DESC, id DESC"
212
+ "SELECT id, target_id FROM scans ORDER BY julianday(upper(started_at)) DESC, id DESC"
200
213
  ):
201
214
  latest_scan_by_target.setdefault(row["target_id"], scans_by_id[row["id"]])
202
215
 
@@ -5,7 +5,7 @@ import json
5
5
  import sqlite3
6
6
  import sys
7
7
  from pathlib import Path
8
- from typing import Any, Callable
8
+ from typing import Any
9
9
 
10
10
  sys.path.insert(0, str(Path(__file__).resolve().parent))
11
11
  from deep_scan_workbench import require_current_coordinator
@@ -37,7 +37,6 @@ def preflight_issues_json(value: str | None) -> str | None:
37
37
  raise SystemExit(
38
38
  f"Preflight issues must be an array of at most {MAX_PREFLIGHT_ISSUES} objects."
39
39
  )
40
- normalized: list[dict[str, str]] = []
41
40
  expected_keys = {"capability", "reason", "severity", "status"}
42
41
  for index, issue in enumerate(payload):
43
42
  label = f"{index + 1}"
@@ -49,17 +48,9 @@ def preflight_issues_json(value: str | None) -> str | None:
49
48
  status = issue.get("status")
50
49
  if severity not in {"block", "warn"} or status not in {"fail", "unknown"}:
51
50
  raise SystemExit(f"Preflight issue {label} has an invalid severity or status.")
52
- normalized.append(
53
- {
54
- "capability": _preflight_issue_text(
55
- issue.get("capability"), 128, f"{label} capability"
56
- ),
57
- "reason": _preflight_issue_text(issue.get("reason"), 1200, f"{label} reason"),
58
- "severity": severity,
59
- "status": status,
60
- }
61
- )
62
- return json.dumps(normalized, ensure_ascii=True, separators=(",", ":"), sort_keys=True)
51
+ for field, maximum in (("capability", 128), ("reason", 1200)):
52
+ issue[field] = _preflight_issue_text(issue.get(field), maximum, f"{label} {field}")
53
+ return json.dumps(payload, ensure_ascii=True, separators=(",", ":"), sort_keys=True)
63
54
 
64
55
 
65
56
  def reportable_count(
@@ -71,22 +62,18 @@ def reportable_count(
71
62
 
72
63
 
73
64
  def update_context(
65
+ wb: Any,
74
66
  connection: sqlite3.Connection,
75
67
  args: argparse.Namespace,
76
- *,
77
- now: Callable[[], str],
78
- require_scan: Callable[[sqlite3.Connection, str], sqlite3.Row],
79
- require_workspace: Callable[[sqlite3.Connection, str], sqlite3.Row],
80
- scan_context: Callable[[sqlite3.Connection, str], dict[str, Any]],
81
68
  ) -> dict[str, Any]:
82
69
  scan_id = require_uuid(args.scan_id, "scan-id")
83
70
  context = user_context_argument(args)
84
71
  connection.execute("BEGIN IMMEDIATE")
85
72
  with connection:
86
- scan = require_scan(connection, scan_id)
73
+ scan = wb.require_scan(connection, scan_id)
87
74
  if scan["status"] != "running" or scan["canceled_at"] is not None:
88
75
  raise SystemExit("Only a running scan can update context.")
89
- workspace = require_workspace(connection, scan["workspace_id"])
76
+ workspace = wb.require_workspace(connection, scan["workspace_id"])
90
77
  if args.workspace_id is not None:
91
78
  if args.claim_token is not None:
92
79
  raise SystemExit("claim-token is only valid with thread-id.")
@@ -102,7 +89,7 @@ def update_context(
102
89
  args.claim_token,
103
90
  error_message="Scan context updates are owned by another continuation.",
104
91
  )
105
- timestamp = now()
92
+ timestamp = wb.now()
106
93
  connection.execute(
107
94
  "UPDATE scans SET user_context = ?, updated_at = ? WHERE id = ?",
108
95
  (context, timestamp, scan["id"]),
@@ -117,42 +104,13 @@ def update_context(
117
104
  "UPDATE workspaces SET updated_at = ? WHERE id = ?",
118
105
  (timestamp, workspace["id"]),
119
106
  )
120
- return scan_context(connection, scan_id)
121
-
122
-
123
- def update(
124
- connection: sqlite3.Connection,
125
- args: argparse.Namespace,
126
- now: Callable[[], str],
127
- require_scan: Callable[[sqlite3.Connection, str], sqlite3.Row],
128
- require_workspace: Callable[[sqlite3.Connection, str], sqlite3.Row],
129
- scan_context: Callable[[sqlite3.Connection, str], dict[str, Any]],
130
- ) -> dict[str, Any]:
131
- if args.command == "update-scan-context":
132
- return update_context(
133
- connection,
134
- args,
135
- now=now,
136
- require_scan=require_scan,
137
- require_workspace=require_workspace,
138
- scan_context=scan_context,
139
- )
140
- return update_progress(
141
- connection,
142
- args,
143
- now=now,
144
- require_scan=require_scan,
145
- scan_context=scan_context,
146
- )
107
+ return wb.scan_context(connection, scan_id)
147
108
 
148
109
 
149
110
  def update_progress(
111
+ wb: Any,
150
112
  connection: sqlite3.Connection,
151
113
  args: argparse.Namespace,
152
- *,
153
- now: Callable[[], str],
154
- require_scan: Callable[[sqlite3.Connection, str], sqlite3.Row],
155
- scan_context: Callable[[sqlite3.Connection, str], dict[str, Any]],
156
114
  ) -> dict[str, Any]:
157
115
  scan_id = require_uuid(args.scan_id, "scan-id")
158
116
  model = optional_text(args.model, maximum=200)
@@ -163,8 +121,8 @@ def update_progress(
163
121
  serialized_preflight_issues = preflight_issues_json(preflight_issues)
164
122
  connection.execute("BEGIN IMMEDIATE")
165
123
  with connection:
166
- timestamp = now()
167
- scan = require_scan(connection, scan_id)
124
+ timestamp = wb.now()
125
+ scan = wb.require_scan(connection, scan_id)
168
126
  if scan["status"] != "running":
169
127
  raise SystemExit("Only a running scan can update progress.")
170
128
  if scan["mode"] == "deep":
@@ -274,7 +232,7 @@ def update_progress(
274
232
  completed = progress["review_items_completed"]
275
233
  if completed > total:
276
234
  raise SystemExit("Completed review items cannot exceed total review items.")
277
- updated = connection.execute(
235
+ connection.execute(
278
236
  """
279
237
  UPDATE scans
280
238
  SET phase = COALESCE(?, phase), model = COALESCE(?, model),
@@ -283,13 +241,11 @@ def update_progress(
283
241
  """,
284
242
  (args.phase, model, reasoning_effort, timestamp, scan["id"]),
285
243
  )
286
- if updated.rowcount != 1:
287
- raise SystemExit("Only a running scan can update progress.")
288
244
  connection.execute(
289
245
  f"UPDATE scan_progress SET {', '.join(updates)}, updated_at = ? WHERE scan_id = ?",
290
246
  (*values, timestamp, scan["id"]),
291
247
  )
292
- return scan_context(connection, scan["id"])
248
+ return wb.scan_context(connection, scan["id"])
293
249
 
294
250
 
295
251
  if __name__ == "__main__":