@openai/codex-security 0.1.31 → 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 (514) hide show
  1. package/README.md +442 -2434
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +3 -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 +7 -214
  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 +5 -5
  25. package/_bundled_plugin/references/config-preflight.md +1 -5
  26. package/_bundled_plugin/references/core-scan.md +34 -10
  27. package/_bundled_plugin/references/final-report.md +13 -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 +3 -4
  31. package/_bundled_plugin/references/scan-contract.md +11 -6
  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 +2 -2
  36. package/_bundled_plugin/schemas/coverage.schema.json +23 -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 +83 -95
  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 +245 -356
  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 +29 -69
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +208 -363
  52. package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +733 -375
  54. package/_bundled_plugin/scripts/finding_preview.py +81 -91
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +48 -102
  56. package/_bundled_plugin/scripts/generate_rank_input.py +117 -888
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -6
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +43 -902
  60. package/_bundled_plugin/scripts/report_projection.py +143 -219
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +161 -0
  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 +59 -9
  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 +21 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +99 -190
  70. package/_bundled_plugin/scripts/workbench_constants.py +6 -14
  71. package/_bundled_plugin/scripts/workbench_db.py +524 -672
  72. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  73. package/_bundled_plugin/scripts/workbench_finding_index.py +20 -7
  74. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  75. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  76. package/_bundled_plugin/scripts/workbench_native_indexes.py +28 -18
  77. package/_bundled_plugin/scripts/workbench_progress.py +26 -92
  78. package/_bundled_plugin/scripts/workbench_publication.py +77 -116
  79. package/_bundled_plugin/scripts/workbench_remediation.py +14 -20
  80. package/_bundled_plugin/scripts/workbench_saved_results.py +1402 -263
  81. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  82. package/_bundled_plugin/scripts/workbench_scan_start.py +109 -52
  83. package/_bundled_plugin/scripts/workbench_scan_usage.py +30 -49
  84. package/_bundled_plugin/scripts/workbench_schema.py +71 -1370
  85. package/_bundled_plugin/scripts/workbench_source_excerpt.py +16 -7
  86. package/_bundled_plugin/scripts/workbench_target.py +526 -150
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
  88. package/_bundled_plugin/scripts/workbench_validation.py +19 -44
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  90. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  91. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  92. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  93. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  94. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  95. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +6 -6
  96. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  97. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  98. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  99. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  100. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  104. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  105. package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
  106. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  107. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  108. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  109. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  110. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  111. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  112. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  113. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  114. package/bin/codex-security.mjs +9 -2
  115. package/dist/api.d.ts +63 -15
  116. package/dist/api.d.ts.map +1 -1
  117. package/dist/api.js +970 -553
  118. package/dist/api.js.map +1 -1
  119. package/dist/artifact-export.d.ts +70 -0
  120. package/dist/artifact-export.d.ts.map +1 -0
  121. package/dist/artifact-export.js +292 -0
  122. package/dist/artifact-export.js.map +1 -0
  123. package/dist/auth.d.ts +2 -6
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +27 -12
  126. package/dist/auth.js.map +1 -1
  127. package/dist/bulk-scan-discovery.d.ts +1 -0
  128. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  129. package/dist/bulk-scan-discovery.js +9 -9
  130. package/dist/bulk-scan-discovery.js.map +1 -1
  131. package/dist/classify-scan-severity.d.ts.map +1 -1
  132. package/dist/classify-scan-severity.js +2 -5
  133. package/dist/classify-scan-severity.js.map +1 -1
  134. package/dist/classify-severity.d.ts +28 -17
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +16 -35
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli-help.d.ts +3 -0
  139. package/dist/cli-help.d.ts.map +1 -0
  140. package/dist/cli-help.js +285 -0
  141. package/dist/cli-help.js.map +1 -0
  142. package/dist/cli-signals.d.ts +8 -0
  143. package/dist/cli-signals.d.ts.map +1 -0
  144. package/dist/cli-signals.js +28 -0
  145. package/dist/cli-signals.js.map +1 -0
  146. package/dist/cli.d.ts +22 -24
  147. package/dist/cli.d.ts.map +1 -1
  148. package/dist/cli.js +1660 -1556
  149. package/dist/cli.js.map +1 -1
  150. package/dist/cloud-publish.d.ts.map +1 -1
  151. package/dist/cloud-publish.js +11 -17
  152. package/dist/cloud-publish.js.map +1 -1
  153. package/dist/codeowners.d.ts +19 -0
  154. package/dist/codeowners.d.ts.map +1 -0
  155. package/dist/codeowners.js +138 -0
  156. package/dist/codeowners.js.map +1 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +1 -2
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/codex-sdk-environment.d.ts +3 -0
  161. package/dist/codex-sdk-environment.d.ts.map +1 -0
  162. package/dist/codex-sdk-environment.js +68 -0
  163. package/dist/codex-sdk-environment.js.map +1 -0
  164. package/dist/component-plan.d.ts +2 -5
  165. package/dist/component-plan.d.ts.map +1 -1
  166. package/dist/component-plan.js +38 -34
  167. package/dist/component-plan.js.map +1 -1
  168. package/dist/component-scan.d.ts +7 -5
  169. package/dist/component-scan.d.ts.map +1 -1
  170. package/dist/component-scan.js +54 -44
  171. package/dist/component-scan.js.map +1 -1
  172. package/dist/config.d.ts.map +1 -1
  173. package/dist/config.js +93 -104
  174. package/dist/config.js.map +1 -1
  175. package/dist/contract.d.ts +15 -2
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +124 -348
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost-model.d.ts +13 -6
  180. package/dist/cost-model.d.ts.map +1 -1
  181. package/dist/cost-model.js +75 -34
  182. package/dist/cost-model.js.map +1 -1
  183. package/dist/cost.d.ts +10 -2
  184. package/dist/cost.d.ts.map +1 -1
  185. package/dist/cost.js +116 -134
  186. package/dist/cost.js.map +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +7 -6
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/custom-validation.d.ts +1 -2
  191. package/dist/custom-validation.d.ts.map +1 -1
  192. package/dist/custom-validation.js +23 -16
  193. package/dist/custom-validation.js.map +1 -1
  194. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  195. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  196. package/dist/deduplication/checkpointed-review.js +33 -20
  197. package/dist/deduplication/checkpointed-review.js.map +1 -1
  198. package/dist/deduplication/codex-review.d.ts +9 -1
  199. package/dist/deduplication/codex-review.d.ts.map +1 -1
  200. package/dist/deduplication/codex-review.js +129 -20
  201. package/dist/deduplication/codex-review.js.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  203. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  204. package/dist/deduplication/deduplication-prompts.js +18 -4
  205. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  207. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  208. package/dist/deduplication/deduplication-reviewer.js +59 -47
  209. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  210. package/dist/deduplication/deduplication.d.ts.map +1 -1
  211. package/dist/deduplication/deduplication.js +59 -113
  212. package/dist/deduplication/deduplication.js.map +1 -1
  213. package/dist/deduplication/diagnostics.d.ts +17 -0
  214. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  215. package/dist/deduplication/diagnostics.js +5 -0
  216. package/dist/deduplication/diagnostics.js.map +1 -0
  217. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  218. package/dist/deduplication/finding-schema.js +7 -1
  219. package/dist/deduplication/finding-schema.js.map +1 -1
  220. package/dist/deduplication/local.d.ts +31 -0
  221. package/dist/deduplication/local.d.ts.map +1 -0
  222. package/dist/deduplication/local.js +166 -0
  223. package/dist/deduplication/local.js.map +1 -0
  224. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  225. package/dist/deduplication/records-protocol.js +12 -28
  226. package/dist/deduplication/records-protocol.js.map +1 -1
  227. package/dist/deduplication/records.d.ts +188 -12
  228. package/dist/deduplication/records.d.ts.map +1 -1
  229. package/dist/deduplication/records.js +34 -24
  230. package/dist/deduplication/records.js.map +1 -1
  231. package/dist/deduplication/review.d.ts +7 -0
  232. package/dist/deduplication/review.d.ts.map +1 -1
  233. package/dist/deduplication/review.js.map +1 -1
  234. package/dist/deduplication/scan.d.ts +9 -3
  235. package/dist/deduplication/scan.d.ts.map +1 -1
  236. package/dist/deduplication/scan.js +159 -44
  237. package/dist/deduplication/scan.js.map +1 -1
  238. package/dist/deep-config.d.ts +2 -1
  239. package/dist/deep-config.d.ts.map +1 -1
  240. package/dist/deep-config.js +7 -23
  241. package/dist/deep-config.js.map +1 -1
  242. package/dist/deep-progress.d.ts +2 -1
  243. package/dist/deep-progress.d.ts.map +1 -1
  244. package/dist/deep-progress.js +32 -47
  245. package/dist/deep-progress.js.map +1 -1
  246. package/dist/deep-scan.d.ts +20 -0
  247. package/dist/deep-scan.d.ts.map +1 -0
  248. package/dist/deep-scan.js +113 -0
  249. package/dist/deep-scan.js.map +1 -0
  250. package/dist/errors.d.ts +5 -2
  251. package/dist/errors.d.ts.map +1 -1
  252. package/dist/errors.js +7 -7
  253. package/dist/errors.js.map +1 -1
  254. package/dist/feedback.d.ts.map +1 -1
  255. package/dist/feedback.js +53 -21
  256. package/dist/feedback.js.map +1 -1
  257. package/dist/finding-catalogue.d.ts.map +1 -1
  258. package/dist/finding-catalogue.js +26 -30
  259. package/dist/finding-catalogue.js.map +1 -1
  260. package/dist/finding-normalization.d.ts +5 -0
  261. package/dist/finding-normalization.d.ts.map +1 -0
  262. package/dist/finding-normalization.js +120 -0
  263. package/dist/finding-normalization.js.map +1 -0
  264. package/dist/finding-retrieval.d.ts +9 -0
  265. package/dist/finding-retrieval.d.ts.map +1 -1
  266. package/dist/finding-retrieval.js.map +1 -1
  267. package/dist/finding-workflow.d.ts +13 -8
  268. package/dist/finding-workflow.d.ts.map +1 -1
  269. package/dist/finding-workflow.js +18 -13
  270. package/dist/finding-workflow.js.map +1 -1
  271. package/dist/findings-client.d.ts +2 -1
  272. package/dist/findings-client.d.ts.map +1 -1
  273. package/dist/findings-client.js +36 -9
  274. package/dist/findings-client.js.map +1 -1
  275. package/dist/findings-errors.d.ts +16 -0
  276. package/dist/findings-errors.d.ts.map +1 -0
  277. package/dist/findings-errors.js +24 -0
  278. package/dist/findings-errors.js.map +1 -0
  279. package/dist/findings-import.d.ts +1 -1
  280. package/dist/findings-import.d.ts.map +1 -1
  281. package/dist/findings-import.js +16 -44
  282. package/dist/findings-import.js.map +1 -1
  283. package/dist/github.d.ts.map +1 -1
  284. package/dist/github.js +9 -4
  285. package/dist/github.js.map +1 -1
  286. package/dist/import-scan.d.ts.map +1 -1
  287. package/dist/import-scan.js +49 -39
  288. package/dist/import-scan.js.map +1 -1
  289. package/dist/index.d.ts +11 -5
  290. package/dist/index.d.ts.map +1 -1
  291. package/dist/index.js +2 -1
  292. package/dist/index.js.map +1 -1
  293. package/dist/knowledge-base.d.ts +7 -1
  294. package/dist/knowledge-base.d.ts.map +1 -1
  295. package/dist/knowledge-base.js +115 -47
  296. package/dist/knowledge-base.js.map +1 -1
  297. package/dist/linear.d.ts.map +1 -1
  298. package/dist/linear.js +4 -10
  299. package/dist/linear.js.map +1 -1
  300. package/dist/mock-scan.d.ts.map +1 -1
  301. package/dist/mock-scan.js +0 -1
  302. package/dist/mock-scan.js.map +1 -1
  303. package/dist/models.d.ts +24 -2
  304. package/dist/models.d.ts.map +1 -1
  305. package/dist/models.js.map +1 -1
  306. package/dist/multiscan.d.ts +9 -3
  307. package/dist/multiscan.d.ts.map +1 -1
  308. package/dist/multiscan.js +225 -153
  309. package/dist/multiscan.js.map +1 -1
  310. package/dist/owner-evidence.d.ts +10 -2
  311. package/dist/owner-evidence.d.ts.map +1 -1
  312. package/dist/owner-evidence.js +69 -14
  313. package/dist/owner-evidence.js.map +1 -1
  314. package/dist/patch-tui.d.ts.map +1 -1
  315. package/dist/patch-tui.js +5 -6
  316. package/dist/patch-tui.js.map +1 -1
  317. package/dist/project-config-schema.d.ts +10 -0
  318. package/dist/project-config-schema.d.ts.map +1 -1
  319. package/dist/project-config-schema.js +1 -0
  320. package/dist/project-config-schema.js.map +1 -1
  321. package/dist/project-config.d.ts +1 -0
  322. package/dist/project-config.d.ts.map +1 -1
  323. package/dist/project-config.js +5 -3
  324. package/dist/project-config.js.map +1 -1
  325. package/dist/prompt-files.d.ts +0 -1
  326. package/dist/prompt-files.d.ts.map +1 -1
  327. package/dist/prompt-files.js +2 -4
  328. package/dist/prompt-files.js.map +1 -1
  329. package/dist/provider-profile.d.ts +21 -0
  330. package/dist/provider-profile.d.ts.map +1 -0
  331. package/dist/provider-profile.js +133 -0
  332. package/dist/provider-profile.js.map +1 -0
  333. package/dist/publication-events.d.ts +6 -8
  334. package/dist/publication-events.d.ts.map +1 -1
  335. package/dist/publication-events.js +40 -79
  336. package/dist/publication-events.js.map +1 -1
  337. package/dist/publication-store.d.ts.map +1 -1
  338. package/dist/publication-store.js +48 -76
  339. package/dist/publication-store.js.map +1 -1
  340. package/dist/publication.d.ts +1 -2
  341. package/dist/publication.d.ts.map +1 -1
  342. package/dist/publication.js +7 -16
  343. package/dist/publication.js.map +1 -1
  344. package/dist/publish.d.ts +1 -5
  345. package/dist/publish.d.ts.map +1 -1
  346. package/dist/publish.js +138 -199
  347. package/dist/publish.js.map +1 -1
  348. package/dist/record.d.ts +2 -0
  349. package/dist/record.d.ts.map +1 -0
  350. package/dist/record.js +4 -0
  351. package/dist/record.js.map +1 -0
  352. package/dist/request-metadata.d.ts +9 -0
  353. package/dist/request-metadata.d.ts.map +1 -0
  354. package/dist/request-metadata.js +13 -0
  355. package/dist/request-metadata.js.map +1 -0
  356. package/dist/result.d.ts +4 -1
  357. package/dist/result.d.ts.map +1 -1
  358. package/dist/result.js +7 -0
  359. package/dist/result.js.map +1 -1
  360. package/dist/runtime.d.ts +25 -17
  361. package/dist/runtime.d.ts.map +1 -1
  362. package/dist/runtime.js +619 -255
  363. package/dist/runtime.js.map +1 -1
  364. package/dist/saved-scan-bootstrap.d.ts +14 -0
  365. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  366. package/dist/saved-scan-bootstrap.js +261 -0
  367. package/dist/saved-scan-bootstrap.js.map +1 -0
  368. package/dist/saved-scan.d.ts +1 -1
  369. package/dist/saved-scan.d.ts.map +1 -1
  370. package/dist/saved-scan.js +16 -32
  371. package/dist/saved-scan.js.map +1 -1
  372. package/dist/scan-activity.d.ts.map +1 -1
  373. package/dist/scan-activity.js +19 -30
  374. package/dist/scan-activity.js.map +1 -1
  375. package/dist/scan-comparison.d.ts +31 -18
  376. package/dist/scan-comparison.d.ts.map +1 -1
  377. package/dist/scan-comparison.js +307 -347
  378. package/dist/scan-comparison.js.map +1 -1
  379. package/dist/scan-dashboard.d.ts +3 -1
  380. package/dist/scan-dashboard.d.ts.map +1 -1
  381. package/dist/scan-dashboard.js +351 -92
  382. package/dist/scan-dashboard.js.map +1 -1
  383. package/dist/scan-history-renderer.d.ts.map +1 -1
  384. package/dist/scan-history-renderer.js +55 -15
  385. package/dist/scan-history-renderer.js.map +1 -1
  386. package/dist/scan-inputs.d.ts +6 -0
  387. package/dist/scan-inputs.d.ts.map +1 -0
  388. package/dist/scan-inputs.js +71 -0
  389. package/dist/scan-inputs.js.map +1 -0
  390. package/dist/scan-logs.d.ts +2 -3
  391. package/dist/scan-logs.d.ts.map +1 -1
  392. package/dist/scan-logs.js +14 -12
  393. package/dist/scan-logs.js.map +1 -1
  394. package/dist/scan-sessions.d.ts +4 -0
  395. package/dist/scan-sessions.d.ts.map +1 -1
  396. package/dist/scan-sessions.js +18 -3
  397. package/dist/scan-sessions.js.map +1 -1
  398. package/dist/scan-settings.d.ts +5 -0
  399. package/dist/scan-settings.d.ts.map +1 -1
  400. package/dist/scan-settings.js +4 -0
  401. package/dist/scan-settings.js.map +1 -1
  402. package/dist/scan-skill-paths.d.ts +8 -0
  403. package/dist/scan-skill-paths.d.ts.map +1 -0
  404. package/dist/scan-skill-paths.js +47 -0
  405. package/dist/scan-skill-paths.js.map +1 -0
  406. package/dist/security-policy-cli.d.ts.map +1 -1
  407. package/dist/security-policy-cli.js +15 -33
  408. package/dist/security-policy-cli.js.map +1 -1
  409. package/dist/security-policy.d.ts +17 -9
  410. package/dist/security-policy.d.ts.map +1 -1
  411. package/dist/security-policy.js +131 -98
  412. package/dist/security-policy.js.map +1 -1
  413. package/dist/server/api.d.ts +0 -1
  414. package/dist/server/api.d.ts.map +1 -1
  415. package/dist/server/api.js +0 -1
  416. package/dist/server/api.js.map +1 -1
  417. package/dist/server/embeddings.d.ts +3 -1
  418. package/dist/server/embeddings.d.ts.map +1 -1
  419. package/dist/server/embeddings.js +11 -3
  420. package/dist/server/embeddings.js.map +1 -1
  421. package/dist/server/errors.d.ts +5 -2
  422. package/dist/server/errors.d.ts.map +1 -1
  423. package/dist/server/errors.js +7 -0
  424. package/dist/server/errors.js.map +1 -1
  425. package/dist/server/sqlite-store.d.ts +0 -2
  426. package/dist/server/sqlite-store.d.ts.map +1 -1
  427. package/dist/server/sqlite-store.js +55 -55
  428. package/dist/server/sqlite-store.js.map +1 -1
  429. package/dist/server/storage.d.ts +0 -2
  430. package/dist/server/storage.d.ts.map +1 -1
  431. package/dist/server/storage.js.map +1 -1
  432. package/dist/severity-store.js +20 -32
  433. package/dist/severity-store.js.map +1 -1
  434. package/dist/standalone-validation-prompt.d.ts +2 -0
  435. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  436. package/dist/standalone-validation-prompt.js +10 -0
  437. package/dist/standalone-validation-prompt.js.map +1 -0
  438. package/dist/suggest-owners.d.ts +6 -5
  439. package/dist/suggest-owners.d.ts.map +1 -1
  440. package/dist/suggest-owners.js +15 -10
  441. package/dist/suggest-owners.js.map +1 -1
  442. package/dist/targets.d.ts +12 -0
  443. package/dist/targets.d.ts.map +1 -1
  444. package/dist/targets.js +124 -62
  445. package/dist/targets.js.map +1 -1
  446. package/dist/trusted-executable.d.ts +6 -1
  447. package/dist/trusted-executable.d.ts.map +1 -1
  448. package/dist/trusted-executable.js +28 -9
  449. package/dist/trusted-executable.js.map +1 -1
  450. package/dist/value.d.ts +2 -0
  451. package/dist/value.d.ts.map +1 -0
  452. package/dist/value.js +27 -0
  453. package/dist/value.js.map +1 -0
  454. package/dist/version.d.ts.map +1 -1
  455. package/dist/version.js +3 -6
  456. package/dist/version.js.map +1 -1
  457. package/dist/windows-path.d.ts.map +1 -1
  458. package/dist/windows-path.js +1 -2
  459. package/dist/windows-path.js.map +1 -1
  460. package/dist/workbench-arguments.d.ts +3 -0
  461. package/dist/workbench-arguments.d.ts.map +1 -0
  462. package/dist/workbench-arguments.js +15 -0
  463. package/dist/workbench-arguments.js.map +1 -0
  464. package/dist/worker-progress.d.ts +2 -0
  465. package/dist/worker-progress.d.ts.map +1 -1
  466. package/dist/worker-progress.js +40 -46
  467. package/dist/worker-progress.js.map +1 -1
  468. package/docs/cli.md +1778 -0
  469. package/docs/dedupe-records.md +24 -0
  470. package/docs/findings-service.md +402 -0
  471. package/package.json +23 -23
  472. package/schemas/project-config.schema.json +5 -0
  473. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  474. package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
  475. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  476. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  477. package/_bundled_plugin/scripts/workbench_severity.py +0 -119
  478. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  479. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  480. package/dist/server/dashboard/app.css +0 -2
  481. package/dist/server/dashboard/app.js +0 -66
  482. package/dist/server/dashboard/index.html +0 -18
  483. package/dist/server/dashboard-types.d.ts +0 -48
  484. package/dist/server/dashboard-types.d.ts.map +0 -1
  485. package/dist/server/dashboard-types.js +0 -2
  486. package/dist/server/dashboard-types.js.map +0 -1
  487. package/dist/server/dashboard.d.ts +0 -6
  488. package/dist/server/dashboard.d.ts.map +0 -1
  489. package/dist/server/dashboard.js +0 -59
  490. package/dist/server/dashboard.js.map +0 -1
  491. package/dist/server/findings-service.d.ts +0 -20
  492. package/dist/server/findings-service.d.ts.map +0 -1
  493. package/dist/server/findings-service.js +0 -31
  494. package/dist/server/findings-service.js.map +0 -1
  495. package/dist/server/index.d.ts +0 -2
  496. package/dist/server/index.d.ts.map +0 -1
  497. package/dist/server/index.js +0 -6
  498. package/dist/server/index.js.map +0 -1
  499. package/dist/server/routes.d.ts +0 -6
  500. package/dist/server/routes.d.ts.map +0 -1
  501. package/dist/server/routes.js +0 -86
  502. package/dist/server/routes.js.map +0 -1
  503. package/dist/server/serve.d.ts +0 -2
  504. package/dist/server/serve.d.ts.map +0 -1
  505. package/dist/server/serve.js +0 -28
  506. package/dist/server/serve.js.map +0 -1
  507. package/dist/server/server.d.ts +0 -10
  508. package/dist/server/server.d.ts.map +0 -1
  509. package/dist/server/server.js +0 -17
  510. package/dist/server/server.js.map +0 -1
  511. package/dist/server/validation.d.ts +0 -17
  512. package/dist/server/validation.d.ts.map +0 -1
  513. package/dist/server/validation.js +0 -53
  514. 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
  ),
@@ -52,15 +70,10 @@ def index_findings(
52
70
  document: dict[str, Any],
53
71
  timestamp: str,
54
72
  ) -> None:
55
- findings = document.get("findings")
56
- if not isinstance(findings, list):
57
- raise SystemExit("findings.json must contain a findings array.")
58
73
  repository_id = connection.execute(
59
74
  "SELECT target_id FROM scans WHERE id = ?", (scan_id,)
60
75
  ).fetchone()["target_id"]
61
- for finding in findings:
62
- if not isinstance(finding, dict):
63
- raise SystemExit("findings.json entries must be objects.")
76
+ for finding in document["findings"]:
64
77
  severity = finding["severity"]
65
78
  confidence = finding["confidence"]
66
79
  upsert_finding(connection, finding, timestamp, repository_id)
@@ -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
  )
@@ -192,14 +205,11 @@ def list_repositories(
192
205
  ) -> dict[str, Any]:
193
206
  scans = scan_history.list_scans(connection)["scans"]
194
207
  scans_by_id = {scan["scanId"]: scan for scan in scans}
195
- scan_count_by_target: dict[str, int] = {}
196
- for scan in scans:
197
- target_id = scan["targetId"]
198
- scan_count_by_target[target_id] = scan_count_by_target.get(target_id, 0) + 1
208
+ scan_count_by_target = dict(Counter(scan["targetId"] for scan in scans))
199
209
 
200
210
  latest_scan_by_target: dict[str, dict[str, Any]] = {}
201
211
  for row in connection.execute(
202
- "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"
203
213
  ):
204
214
  latest_scan_by_target.setdefault(row["target_id"], scans_by_id[row["id"]])
205
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
@@ -16,15 +16,12 @@ from workbench_validation import optional_text, require_uuid, user_context_argum
16
16
  MAX_PREFLIGHT_ISSUES = 32
17
17
 
18
18
 
19
- def _javascript_string_length(value: str) -> int:
20
- return len(value.encode("utf-16-le", errors="surrogatepass")) // 2
21
-
22
-
23
19
  def _preflight_issue_text(value: Any, maximum: int, label: str) -> str:
24
20
  if not isinstance(value, str):
25
21
  raise SystemExit(f"Preflight issue {label} must be text.")
26
22
  normalized = value.strip()
27
- if not normalized or _javascript_string_length(normalized) > maximum:
23
+ # Match JavaScript's UTF-16 code-unit length.
24
+ if not normalized or len(normalized.encode("utf-16-le", errors="surrogatepass")) // 2 > maximum:
28
25
  raise SystemExit(f"Preflight issue {label} must contain 1 to {maximum} characters.")
29
26
  return normalized
30
27
 
@@ -40,7 +37,6 @@ def preflight_issues_json(value: str | None) -> str | None:
40
37
  raise SystemExit(
41
38
  f"Preflight issues must be an array of at most {MAX_PREFLIGHT_ISSUES} objects."
42
39
  )
43
- normalized: list[dict[str, str]] = []
44
40
  expected_keys = {"capability", "reason", "severity", "status"}
45
41
  for index, issue in enumerate(payload):
46
42
  label = f"{index + 1}"
@@ -52,17 +48,9 @@ def preflight_issues_json(value: str | None) -> str | None:
52
48
  status = issue.get("status")
53
49
  if severity not in {"block", "warn"} or status not in {"fail", "unknown"}:
54
50
  raise SystemExit(f"Preflight issue {label} has an invalid severity or status.")
55
- normalized.append(
56
- {
57
- "capability": _preflight_issue_text(
58
- issue.get("capability"), 128, f"{label} capability"
59
- ),
60
- "reason": _preflight_issue_text(issue.get("reason"), 1200, f"{label} reason"),
61
- "severity": severity,
62
- "status": status,
63
- }
64
- )
65
- 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)
66
54
 
67
55
 
68
56
  def reportable_count(
@@ -74,22 +62,18 @@ def reportable_count(
74
62
 
75
63
 
76
64
  def update_context(
65
+ wb: Any,
77
66
  connection: sqlite3.Connection,
78
67
  args: argparse.Namespace,
79
- *,
80
- now: Callable[[], str],
81
- require_scan: Callable[[sqlite3.Connection, str], sqlite3.Row],
82
- require_workspace: Callable[[sqlite3.Connection, str], sqlite3.Row],
83
- scan_context: Callable[[sqlite3.Connection, str], dict[str, Any]],
84
68
  ) -> dict[str, Any]:
85
69
  scan_id = require_uuid(args.scan_id, "scan-id")
86
70
  context = user_context_argument(args)
87
71
  connection.execute("BEGIN IMMEDIATE")
88
- try:
89
- scan = require_scan(connection, scan_id)
72
+ with connection:
73
+ scan = wb.require_scan(connection, scan_id)
90
74
  if scan["status"] != "running" or scan["canceled_at"] is not None:
91
75
  raise SystemExit("Only a running scan can update context.")
92
- workspace = require_workspace(connection, scan["workspace_id"])
76
+ workspace = wb.require_workspace(connection, scan["workspace_id"])
93
77
  if args.workspace_id is not None:
94
78
  if args.claim_token is not None:
95
79
  raise SystemExit("claim-token is only valid with thread-id.")
@@ -105,7 +89,7 @@ def update_context(
105
89
  args.claim_token,
106
90
  error_message="Scan context updates are owned by another continuation.",
107
91
  )
108
- timestamp = now()
92
+ timestamp = wb.now()
109
93
  connection.execute(
110
94
  "UPDATE scans SET user_context = ?, updated_at = ? WHERE id = ?",
111
95
  (context, timestamp, scan["id"]),
@@ -120,46 +104,13 @@ def update_context(
120
104
  "UPDATE workspaces SET updated_at = ? WHERE id = ?",
121
105
  (timestamp, workspace["id"]),
122
106
  )
123
- connection.commit()
124
- except BaseException:
125
- connection.rollback()
126
- raise
127
- return scan_context(connection, scan_id)
128
-
129
-
130
- def update(
131
- connection: sqlite3.Connection,
132
- args: argparse.Namespace,
133
- now: Callable[[], str],
134
- require_scan: Callable[[sqlite3.Connection, str], sqlite3.Row],
135
- require_workspace: Callable[[sqlite3.Connection, str], sqlite3.Row],
136
- scan_context: Callable[[sqlite3.Connection, str], dict[str, Any]],
137
- ) -> dict[str, Any]:
138
- if args.command == "update-scan-context":
139
- return update_context(
140
- connection,
141
- args,
142
- now=now,
143
- require_scan=require_scan,
144
- require_workspace=require_workspace,
145
- scan_context=scan_context,
146
- )
147
- return update_progress(
148
- connection,
149
- args,
150
- now=now,
151
- require_scan=require_scan,
152
- scan_context=scan_context,
153
- )
107
+ return wb.scan_context(connection, scan_id)
154
108
 
155
109
 
156
110
  def update_progress(
111
+ wb: Any,
157
112
  connection: sqlite3.Connection,
158
113
  args: argparse.Namespace,
159
- *,
160
- now: Callable[[], str],
161
- require_scan: Callable[[sqlite3.Connection, str], sqlite3.Row],
162
- scan_context: Callable[[sqlite3.Connection, str], dict[str, Any]],
163
114
  ) -> dict[str, Any]:
164
115
  scan_id = require_uuid(args.scan_id, "scan-id")
165
116
  model = optional_text(args.model, maximum=200)
@@ -169,9 +120,9 @@ def update_progress(
169
120
  )
170
121
  serialized_preflight_issues = preflight_issues_json(preflight_issues)
171
122
  connection.execute("BEGIN IMMEDIATE")
172
- try:
173
- timestamp = now()
174
- scan = require_scan(connection, scan_id)
123
+ with connection:
124
+ timestamp = wb.now()
125
+ scan = wb.require_scan(connection, scan_id)
175
126
  if scan["status"] != "running":
176
127
  raise SystemExit("Only a running scan can update progress.")
177
128
  if scan["mode"] == "deep":
@@ -233,8 +184,12 @@ def update_progress(
233
184
  and args.phase_progress_unit != progress["phase_progress_unit"]
234
185
  ):
235
186
  raise SystemExit("Phase progress unit cannot change within a phase.")
236
- updates: list[str] = []
237
- values: list[Any] = []
187
+ updates: list[str] = [
188
+ "phase_items_total = ?",
189
+ "phase_items_completed = ?",
190
+ "phase_progress_unit = ?",
191
+ ]
192
+ values: list[Any] = [phase_total, phase_completed, phase_unit]
238
193
  if next_phase == "preflight" and scan["mode"] != "deep":
239
194
  updates.extend(["preflight_checks_total = ?", "preflight_checks_completed = ?"])
240
195
  values.extend([phase_total, phase_completed])
@@ -277,7 +232,7 @@ def update_progress(
277
232
  completed = progress["review_items_completed"]
278
233
  if completed > total:
279
234
  raise SystemExit("Completed review items cannot exceed total review items.")
280
- updated = connection.execute(
235
+ connection.execute(
281
236
  """
282
237
  UPDATE scans
283
238
  SET phase = COALESCE(?, phase), model = COALESCE(?, model),
@@ -286,32 +241,11 @@ def update_progress(
286
241
  """,
287
242
  (args.phase, model, reasoning_effort, timestamp, scan["id"]),
288
243
  )
289
- if updated.rowcount != 1:
290
- raise SystemExit("Only a running scan can update progress.")
291
- if updates:
292
- connection.execute(
293
- f"UPDATE scan_progress SET {', '.join(updates)}, updated_at = ? WHERE scan_id = ?",
294
- (*values, timestamp, scan["id"]),
295
- )
296
- else:
297
- connection.execute(
298
- "UPDATE scan_progress SET updated_at = ? WHERE scan_id = ?",
299
- (timestamp, scan["id"]),
300
- )
301
244
  connection.execute(
302
- """
303
- UPDATE scan_progress
304
- SET phase_items_total = ?, phase_items_completed = ?,
305
- phase_progress_unit = ?, updated_at = ?
306
- WHERE scan_id = ?
307
- """,
308
- (phase_total, phase_completed, phase_unit, timestamp, scan["id"]),
245
+ f"UPDATE scan_progress SET {', '.join(updates)}, updated_at = ? WHERE scan_id = ?",
246
+ (*values, timestamp, scan["id"]),
309
247
  )
310
- connection.commit()
311
- except BaseException:
312
- connection.rollback()
313
- raise
314
- return scan_context(connection, scan["id"])
248
+ return wb.scan_context(connection, scan["id"])
315
249
 
316
250
 
317
251
  if __name__ == "__main__":