@openai/codex-security 0.8.2 → 0.9.1

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 (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  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/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -15,13 +15,19 @@ from workbench_constants import (
15
15
  FINDING_LOCATION_PATH_BYTES,
16
16
  FINDING_SUMMARY_BYTES,
17
17
  FINDING_TITLE_BYTES,
18
+ PRIMARY_FINDING_LOCATION_SQL,
18
19
  )
19
20
  from workbench_validation import bounded_output_text
20
21
 
21
22
 
22
23
  def get_scan_feedback(connection: sqlite3.Connection, scan: sqlite3.Row) -> dict[str, Any]:
24
+ """Return reviewed false-positive decisions from other completed scans of the same target.
25
+
26
+ For each finding, include the latest decision only if it closes the finding as a
27
+ false positive with a nonblank reason. Prefer the root-control location in its preview.
28
+ """
23
29
  rows = connection.execute(
24
- """
30
+ f"""
25
31
  WITH ranked_decisions AS (
26
32
  SELECT findings.id AS finding_id, findings.fingerprint, findings.rule_id,
27
33
  findings.identity_anchor, findings.identity_instance, occurrences.title,
@@ -43,12 +49,7 @@ def get_scan_feedback(connection: sqlite3.Connection, scan: sqlite3.Row) -> dict
43
49
  JOIN scans AS source_scans ON source_scans.id = occurrences.scan_id
44
50
  LEFT JOIN finding_triage AS triage ON triage.occurrence_id = occurrences.id
45
51
  JOIN finding_locations AS locations ON locations.id = (
46
- SELECT candidate.id
47
- FROM finding_locations AS candidate
48
- WHERE candidate.occurrence_id = occurrences.id
49
- ORDER BY CASE WHEN candidate.role = 'root_control' THEN 0 ELSE 1 END,
50
- candidate.sort_order
51
- LIMIT 1
52
+ SELECT id {PRIMARY_FINDING_LOCATION_SQL}
52
53
  )
53
54
  WHERE source_scans.target_id = ?
54
55
  AND source_scans.id != ?
@@ -70,6 +70,7 @@ def index_findings(
70
70
  document: dict[str, Any],
71
71
  timestamp: str,
72
72
  ) -> None:
73
+ """Index findings for this scan and write occurrence and ordered location rows in the caller’s transaction."""
73
74
  repository_id = connection.execute(
74
75
  "SELECT target_id FROM scans WHERE id = ?", (scan_id,)
75
76
  ).fetchone()["target_id"]
@@ -12,6 +12,7 @@ from pathlib import Path
12
12
  from typing import Any
13
13
 
14
14
  sys.path.insert(0, str(Path(__file__).resolve().parent))
15
+ from workbench_scan_usage import stored_scan_cost_fields
15
16
  from workbench_target import (
16
17
  UnreadableLocalFile,
17
18
  UnsupportedLocalFileType,
@@ -19,6 +20,7 @@ from workbench_target import (
19
20
  git_bytes,
20
21
  git_revision,
21
22
  )
23
+ from workbench_validation import _valid_legacy_scan_cost
22
24
 
23
25
  WORKFLOW_BINDINGS = {
24
26
  "repositoryPath": "repository_path",
@@ -31,13 +33,81 @@ WORKFLOW_BINDINGS = {
31
33
  WORKFLOW_STAGES = ("scan", "publish", "dedupe")
32
34
 
33
35
 
36
+ def _usable_cost_range(value: Any) -> bool:
37
+ if not isinstance(value, dict) or value.get("context") != "unknown" or "max" not in value:
38
+ return False
39
+ minimum, maximum = value.get("min"), value["max"]
40
+ return (
41
+ type(minimum) in (int, float)
42
+ and 0 <= minimum <= sys.float_info.max
43
+ and (
44
+ maximum is None
45
+ or type(maximum) in (int, float)
46
+ and minimum <= maximum <= sys.float_info.max
47
+ )
48
+ )
49
+
50
+
51
+ def _recorded_cost(value: str | None) -> dict[str, Any] | None:
52
+ """Recover the SDK cost fields that are usable from this historical receipt."""
53
+ try:
54
+ cost = stored_scan_cost_fields(value).get("cost")
55
+ except (TypeError, ValueError, RecursionError):
56
+ return None
57
+ if not _valid_legacy_scan_cost(cost):
58
+ return None
59
+
60
+ fields = (
61
+ "model",
62
+ "inputTokens",
63
+ "cachedInputTokens",
64
+ "cacheWriteInputTokens",
65
+ "outputTokens",
66
+ "estimatedUsd",
67
+ )
68
+ result = {field: cost[field] for field in fields}
69
+ if isinstance(cost.get("cacheWriteInputTokensReported"), bool):
70
+ result["cacheWriteInputTokensReported"] = cost["cacheWriteInputTokensReported"]
71
+ bounds = cost.get("estimatedUsdRange")
72
+ if _usable_cost_range(bounds):
73
+ result["estimatedUsdRange"] = {field: bounds[field] for field in ("min", "max", "context")}
74
+
75
+ pricing = cost.get("pricing")
76
+ if (
77
+ isinstance(pricing, dict)
78
+ and pricing.get("serviceTier") == "standard"
79
+ and pricing.get("context") == "short"
80
+ and isinstance(pricing.get("source"), str)
81
+ and isinstance(pricing.get("asOf"), str)
82
+ ):
83
+ details = {field: pricing[field] for field in ("source", "asOf", "serviceTier", "context")}
84
+ rate_keys = ("input", "cacheRead", "cacheWrite", "output")
85
+ for field in ("usdPerMillionTokens", "longContextUsdPerMillionTokens"):
86
+ rates = pricing.get(field)
87
+ if isinstance(rates, dict) and all(
88
+ type(rates.get(key)) in (int, float) and 0 <= rates[key] <= sys.float_info.max
89
+ for key in rate_keys
90
+ ):
91
+ details[field] = {key: rates[key] for key in rate_keys}
92
+ if "usdPerMillionTokens" in details:
93
+ result["pricing"] = details
94
+ return result
95
+
96
+
34
97
  def read_workflow(connection: sqlite3.Connection, workflow_id: str) -> dict[str, Any] | None:
98
+ """Return the stored stages, scope, and available scan cost, or None if the workflow ID is unknown."""
35
99
  row = connection.execute(
36
- "SELECT * FROM finding_workflows WHERE id = ?", (workflow_id,)
100
+ """SELECT w.*, s.cost_json FROM finding_workflows AS w
101
+ LEFT JOIN scans AS s ON s.id = w.scan_id AND s.scan_dir = w.scan_dir
102
+ AND s.status = 'complete'
103
+ WHERE w.id = ?""",
104
+ (workflow_id,),
37
105
  ).fetchone()
38
106
  if row is None:
39
107
  return None
40
108
  state = {"id": row["id"], "stages": {}}
109
+ if (cost := _recorded_cost(row["cost_json"])) is not None:
110
+ state["recordedCost"] = cost
41
111
  for field, column in WORKFLOW_BINDINGS.items():
42
112
  if row[column] is not None:
43
113
  state[field] = row[column]
@@ -59,6 +129,7 @@ def read_workflow(connection: sqlite3.Connection, workflow_id: str) -> dict[str,
59
129
 
60
130
 
61
131
  def save_workflow(connection: sqlite3.Connection, state: dict[str, Any], timestamp: str) -> None:
132
+ """Insert or update the workflow bindings, scope, stage statuses, and saved results in the caller’s connection."""
62
133
  values = {"id": state["id"]}
63
134
  values.update({column: state.get(field) for field, column in WORKFLOW_BINDINGS.items()})
64
135
  scope = state.get("scope", {})
@@ -91,6 +162,7 @@ def save_workflow(connection: sqlite3.Connection, state: dict[str, Any], timesta
91
162
 
92
163
 
93
164
  def bind_workflow(state: dict[str, Any], binding: dict[str, Any]) -> None:
165
+ """Add bindings to the supplied state in place, raising SystemExit for unknown or conflicting fields."""
94
166
  for field, value in binding.items():
95
167
  if field not in WORKFLOW_BINDINGS and field != "scope":
96
168
  raise SystemExit("Unknown workflow binding.")
@@ -113,9 +185,22 @@ def register_workflow_scan(
113
185
  raise SystemExit("The workflow scan is already complete.")
114
186
  previous = state.get("scanId")
115
187
  if previous is not None:
116
- row = connection.execute("SELECT status FROM scans WHERE id = ?", (previous,)).fetchone()
117
- if row is not None and row["status"] == "complete":
118
- raise SystemExit("Reuse the workflow's completed scan instead of registering another.")
188
+ row = connection.execute(
189
+ """SELECT saved.status, saved.recipe_json AS saved, attempt.recipe_json AS attempt
190
+ FROM scans AS saved JOIN scans AS attempt ON attempt.id = ? WHERE saved.id = ?""",
191
+ (scan_id, previous),
192
+ ).fetchone()
193
+ if row is not None:
194
+ if row["status"] == "complete":
195
+ raise SystemExit(
196
+ "Reuse the workflow's completed scan instead of registering another."
197
+ )
198
+ saved = json.loads(row["saved"] or "{}")
199
+ attempt = json.loads(row["attempt"] or "{}")
200
+ if saved.get("severityRubric") != attempt.get("severityRubric"):
201
+ raise SystemExit(
202
+ "Another attempt registered a different severity rubric. Retry this workflow to reuse its saved rubric."
203
+ )
119
204
  state["scanId"] = scan_id
120
205
  state["scanDir"] = scan_dir
121
206
  save_workflow(connection, state, timestamp)
@@ -124,6 +209,7 @@ def register_workflow_scan(
124
209
  def finding_workflow(
125
210
  connection: sqlite3.Connection, payload: dict[str, Any], timestamp: str
126
211
  ) -> dict[str, Any]:
212
+ """Dispatch a workflow request by ID and return its state, source snapshot, or review as the action specifies."""
127
213
  workflow_id = payload["id"]
128
214
  if not isinstance(workflow_id, str) or not workflow_id.strip():
129
215
  raise SystemExit("workflowId must be a nonempty string.")
@@ -4,7 +4,6 @@ import argparse
4
4
  import os
5
5
  import sqlite3
6
6
  import sys
7
- from collections import Counter
8
7
  from collections.abc import Iterator
9
8
  from itertools import islice
10
9
  from pathlib import Path
@@ -13,7 +12,12 @@ from typing import Any
13
12
  # Some plugin hosts launch Python with safe-path isolation enabled.
14
13
  sys.path.insert(0, str(Path(__file__).resolve().parent))
15
14
  import workbench_scan_history as scan_history
16
- from workbench_constants import FINDING_SUMMARY_BYTES, FINDING_TITLE_BYTES, FINDINGS_PAGE_MAX
15
+ from workbench_constants import (
16
+ FINDING_SUMMARY_BYTES,
17
+ FINDING_TITLE_BYTES,
18
+ FINDINGS_PAGE_MAX,
19
+ PRIMARY_FINDING_LOCATION_SQL,
20
+ )
17
21
  from workbench_validation import bounded_output_text, timestamp_key
18
22
 
19
23
 
@@ -21,6 +25,7 @@ def list_global_findings(
21
25
  connection: sqlite3.Connection,
22
26
  args: argparse.Namespace,
23
27
  ) -> dict[str, Any]:
28
+ """Return a page of indexed findings after applying the requested filters, with nextOffset for continuation."""
24
29
  limit = min(args.limit, FINDINGS_PAGE_MAX)
25
30
  query = args.query.strip().casefold() if args.query else ""
26
31
  findings = (
@@ -108,7 +113,7 @@ def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]
108
113
 
109
114
  grouped: dict[tuple[str, str], list[sqlite3.Row]] = {}
110
115
  for row in connection.execute(
111
- """
116
+ f"""
112
117
  SELECT
113
118
  occurrences.id AS occurrence_id,
114
119
  occurrences.finding_id,
@@ -125,15 +130,7 @@ def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]
125
130
  triage.updated_at AS decision_updated_at,
126
131
  occurrences.title,
127
132
  occurrences.summary,
128
- (
129
- SELECT locations.relative_path
130
- FROM finding_locations AS locations
131
- WHERE locations.occurrence_id = occurrences.id
132
- ORDER BY
133
- CASE WHEN locations.role = 'root_control' THEN 0 ELSE 1 END,
134
- locations.sort_order
135
- LIMIT 1
136
- ) AS location_path
133
+ (SELECT relative_path {PRIMARY_FINDING_LOCATION_SQL}) AS location_path
137
134
  FROM finding_occurrences AS occurrences
138
135
  JOIN scans ON scans.id = occurrences.scan_id
139
136
  JOIN security_targets AS targets ON targets.id = scans.target_id
@@ -204,8 +201,8 @@ def list_repositories(
204
201
  connection: sqlite3.Connection,
205
202
  args: argparse.Namespace | None = None,
206
203
  ) -> dict[str, Any]:
207
- scan_count_by_target = Counter()
208
- latest_by_target: dict[str, tuple[sqlite3.Row, dict[str, Any] | None]] = {}
204
+ """Return tracked targets with scan summaries, finding counts, and current checkout availability."""
205
+ by_target: dict[str, dict[str, Any]] = {}
209
206
  for row in connection.execute(
210
207
  f"""
211
208
  SELECT targets.id AS repository_id, targets.display_name, targets.current_path,
@@ -214,31 +211,30 @@ def list_repositories(
214
211
  LEFT JOIN scans ON scans.target_id = targets.id
215
212
  AND scans.id IN (SELECT scan_id FROM scan_progress)
216
213
  LEFT JOIN scan_progress AS progress ON progress.scan_id = scans.id
214
+ LEFT JOIN scan_lifecycles AS lifecycle ON lifecycle.scan_id = scans.id
217
215
  ORDER BY julianday(upper(scans.started_at)) DESC, scans.id DESC, targets.id
218
216
  """
219
217
  ).fetchall():
220
218
  scan = scan_history.scan_summary(row) if row["id"] is not None else None
221
219
  target_id = row["repository_id"]
220
+ if target_id not in by_target:
221
+ by_target[target_id] = {
222
+ "displayName": row["display_name"],
223
+ "latestScan": scan,
224
+ "openFindingsCount": 0,
225
+ "scanCount": 0,
226
+ "targetId": target_id,
227
+ "targetPath": row["current_path"],
228
+ }
222
229
  if scan is not None:
223
- scan_count_by_target[target_id] += 1
224
- latest_by_target.setdefault(target_id, (row, scan))
230
+ by_target[target_id]["scanCount"] += 1
225
231
 
226
- open_findings_by_target = Counter(
227
- row["target_id"] for row in _indexed_findings(connection) if row["status"] == "open"
228
- )
229
- repositories = [
230
- {
231
- "displayName": target["display_name"],
232
- "latestScan": latest_scan,
233
- "openFindingsCount": open_findings_by_target[target_id]
234
- if latest_scan is not None
235
- else 0,
236
- "scanCount": scan_count_by_target[target_id],
237
- "targetId": target_id,
238
- "targetPath": target["current_path"],
239
- }
240
- for target_id, (target, latest_scan) in latest_by_target.items()
241
- ]
232
+ # A writer can publish a target or its first scan after the repository query.
233
+ for finding in _indexed_findings(connection):
234
+ repository = by_target.get(finding["target_id"])
235
+ if finding["status"] == "open" and repository is not None and repository["scanCount"]:
236
+ repository["openFindingsCount"] += 1
237
+ repositories = list(by_target.values())
242
238
  pagination = {}
243
239
  if args is not None:
244
240
  query = args.query.strip().casefold() if args.query else ""
@@ -256,7 +252,7 @@ def list_repositories(
256
252
  )
257
253
  ]
258
254
  if args.limit is not None or args.offset:
259
- limit = min(args.limit or FINDINGS_PAGE_MAX, FINDINGS_PAGE_MAX)
255
+ limit = args.limit or FINDINGS_PAGE_MAX
260
256
  end = args.offset + limit
261
257
  pagination = {
262
258
  "limit": limit,
@@ -8,7 +8,7 @@ from typing import Any
8
8
 
9
9
  sys.path.insert(0, str(Path(__file__).resolve().parent))
10
10
  from deep_scan_workbench import require_current_coordinator
11
- from workbench.handoff import require_current_continuation
11
+ from workbench.handoff import require_current_continuation, require_tokenless_scan_owner
12
12
  from workbench_constants import PHASES
13
13
  from workbench_validation import optional_text, require_uuid, user_context_argument
14
14
 
@@ -16,6 +16,7 @@ from workbench_validation import optional_text, require_uuid, user_context_argum
16
16
  def reportable_count(
17
17
  current_phase: str, requested_phase: str | None, count: int | None
18
18
  ) -> int | None:
19
+ """Default a missing count to zero on entering validation or a later phase from an earlier phase."""
19
20
  if count is None and requested_phase in PHASES[3:] and current_phase in PHASES[:3]:
20
21
  return 0
21
22
  return count
@@ -26,6 +27,7 @@ def update_context(
26
27
  connection: sqlite3.Connection,
27
28
  args: argparse.Namespace,
28
29
  ) -> dict[str, Any]:
30
+ """Update user context on a running scan and return the refreshed scan context in the same workbench."""
29
31
  scan_id = require_uuid(args.scan_id, "scan-id")
30
32
  context = user_context_argument(args)
31
33
  connection.execute("BEGIN IMMEDIATE")
@@ -72,6 +74,12 @@ def update_progress(
72
74
  connection: sqlite3.Connection,
73
75
  args: argparse.Namespace,
74
76
  ) -> dict[str, Any]:
77
+ """Record phase and review counters for a running scan and return its updated context.
78
+
79
+ Check continuation and coordinator ownership where applicable. A new phase
80
+ starts with fresh phase counters. A new Deep Scan review pass must start
81
+ with zero completed items. Invalid progress raises SystemExit.
82
+ """
75
83
  scan_id = require_uuid(args.scan_id, "scan-id")
76
84
  model = optional_text(args.model, maximum=200)
77
85
  reasoning_effort = optional_text(args.reasoning_effort, maximum=32)
@@ -79,6 +87,7 @@ def update_progress(
79
87
  with connection:
80
88
  timestamp = wb.now()
81
89
  scan = wb.require_scan(connection, scan_id)
90
+ require_tokenless_scan_owner(connection, scan, getattr(args, "model_thread_id", None))
82
91
  if scan["status"] != "running":
83
92
  raise SystemExit("Only a running scan can update progress.")
84
93
  if scan["mode"] == "deep":
@@ -28,9 +28,11 @@ from finalize_scan_contract import (
28
28
  write_sarif_projection,
29
29
  )
30
30
  from validate_scan_contract import validate_contract
31
+ from workbench_constants import PRIMARY_FINDING_LOCATION_SQL
31
32
 
32
33
 
33
34
  def destination_key(destination: Any) -> str:
35
+ """Encode exact provider-specific destination IDs into a stable key for matching issue receipts."""
34
36
  if not isinstance(destination, dict):
35
37
  raise SystemExit("Finding issues require an exact tracker destination.")
36
38
  kind = destination.get("type")
@@ -59,6 +61,12 @@ def verify_publication_history(
59
61
  scan_directory: str,
60
62
  findings: list[dict[str, Any]],
61
63
  ) -> None:
64
+ """Require publication input to match the completed scan in local history.
65
+
66
+ Check the exact scan ID, directory, pinned manifest digest when present,
67
+ and the complete set of occurrence-to-finding associations. Raise
68
+ SystemExit if any of these disagree.
69
+ """
62
70
  try:
63
71
  scan = db.require_scan(connection, scan_id)
64
72
  except SystemExit as exc:
@@ -109,6 +117,7 @@ def inspect_issue_receipts(
109
117
  key: str,
110
118
  finding_ids: list[str],
111
119
  ) -> list[dict[str, Any]]:
120
+ """Return receipts for the selected findings and destination, including receipts from older Linear tables."""
112
121
  tables = {
113
122
  row[0] for row in connection.execute("SELECT name FROM sqlite_master WHERE type = 'table'")
114
123
  }
@@ -132,6 +141,7 @@ def inspect_issue_receipts(
132
141
 
133
142
 
134
143
  def validate_issue_receipts(receipts: Any, selected: dict[str, str]) -> list[dict[str, Any]]:
144
+ """Return receipts bound to the selected finding occurrences or raise SystemExit on invalid receipt data."""
135
145
  if not isinstance(receipts, list):
136
146
  raise SystemExit("Finding issue receipts must be an array.")
137
147
  for receipt in receipts:
@@ -367,6 +377,7 @@ def write_csv_export(
367
377
  scan: sqlite3.Row,
368
378
  findings_document: dict[str, Any],
369
379
  ) -> Path:
380
+ """Write indexed findings to exports/findings.csv, adding candidate IDs for Deep Scans, and return its path."""
370
381
  scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
371
382
  output = io.StringIO(newline="")
372
383
  writer = csv.writer(output)
@@ -412,7 +423,7 @@ def write_csv_export(
412
423
 
413
424
  def finding_export_rows(connection: sqlite3.Connection, scan_id: str) -> sqlite3.Cursor:
414
425
  return connection.execute(
415
- """
426
+ f"""
416
427
  SELECT
417
428
  occurrences.id AS occurrence_id,
418
429
  occurrences.finding_id,
@@ -430,15 +441,8 @@ def finding_export_rows(connection: sqlite3.Connection, scan_id: str) -> sqlite3
430
441
  FROM finding_occurrences AS occurrences
431
442
  LEFT JOIN finding_triage AS triage ON triage.occurrence_id = occurrences.id
432
443
  LEFT JOIN finding_locations AS locations
433
- ON locations.occurrence_id = occurrences.id
434
- AND locations.sort_order = (
435
- SELECT primary_location.sort_order
436
- FROM finding_locations AS primary_location
437
- WHERE primary_location.occurrence_id = occurrences.id
438
- ORDER BY
439
- CASE WHEN primary_location.role = 'root_control' THEN 0 ELSE 1 END,
440
- primary_location.sort_order
441
- LIMIT 1
444
+ ON locations.id = (
445
+ SELECT id {PRIMARY_FINDING_LOCATION_SQL}
442
446
  )
443
447
  WHERE occurrences.scan_id = ?
444
448
  ORDER BY occurrences.created_at, occurrences.id