@openai/codex-security 0.8.3 → 0.10.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 (658) hide show
  1. package/README.md +36 -746
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +7 -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 +5 -2
  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/baseline-auditor.md +18 -0
  26. package/_bundled_plugin/references/core-scan.md +5 -42
  27. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  28. package/_bundled_plugin/references/final-report.md +5 -3
  29. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  30. package/_bundled_plugin/references/focused-investigator.md +13 -0
  31. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  32. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  33. package/_bundled_plugin/references/scan-contract.md +27 -33
  34. package/_bundled_plugin/references/scan-prologue.md +2 -2
  35. package/_bundled_plugin/references/scan-runtime.md +4 -2
  36. package/_bundled_plugin/references/security-guidance.md +14 -1
  37. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  38. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  39. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  40. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  41. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  42. package/_bundled_plugin/scripts/deep_scan_workbench.py +192 -352
  43. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  44. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  45. package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
  46. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  47. package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
  48. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  49. package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
  50. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  51. package/_bundled_plugin/scripts/report_projection.py +81 -43
  52. package/_bundled_plugin/scripts/review_state.py +8 -2
  53. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  54. package/_bundled_plugin/scripts/snapshot_sqlite.py +9 -2
  55. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  56. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  57. package/_bundled_plugin/scripts/windows_scan_local_files.py +582 -20
  58. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  59. package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
  60. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  61. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  62. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  63. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  64. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  65. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  66. package/_bundled_plugin/scripts/workbench/storage.py +91 -7
  67. package/_bundled_plugin/scripts/workbench_cli.py +54 -14
  68. package/_bundled_plugin/scripts/workbench_constants.py +12 -0
  69. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  70. package/_bundled_plugin/scripts/workbench_db.py +562 -303
  71. package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +238 -41
  75. package/_bundled_plugin/scripts/workbench_progress.py +169 -4
  76. package/_bundled_plugin/scripts/workbench_publication.py +16 -13
  77. package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
  82. package/_bundled_plugin/scripts/workbench_schema.py +258 -63
  83. package/_bundled_plugin/scripts/workbench_setup.py +14 -2
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  85. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  86. package/_bundled_plugin/scripts/workbench_target.py +594 -136
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
  88. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
  90. package/_bundled_plugin/shared/workbench-migrations.json +100 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  93. package/_bundled_plugin/skills/fix-finding/SKILL.md +2 -1
  94. package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
  95. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  96. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  97. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  98. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +409 -0
  99. package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
  100. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  104. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  105. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  106. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  107. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  108. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  110. package/bin/codex-security.mjs +2 -2
  111. package/dist/api.d.ts +45 -5
  112. package/dist/api.d.ts.map +1 -1
  113. package/dist/api.js +1192 -427
  114. package/dist/api.js.map +1 -1
  115. package/dist/armorcode-findings.d.ts +9 -0
  116. package/dist/armorcode-findings.d.ts.map +1 -0
  117. package/dist/armorcode-findings.js +145 -0
  118. package/dist/armorcode-findings.js.map +1 -0
  119. package/dist/artifact-export.d.ts +2 -0
  120. package/dist/artifact-export.d.ts.map +1 -1
  121. package/dist/artifact-export.js +29 -13
  122. package/dist/artifact-export.js.map +1 -1
  123. package/dist/auth.d.ts +6 -2
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +37 -18
  126. package/dist/auth.js.map +1 -1
  127. package/dist/batch-cost.d.ts +18 -0
  128. package/dist/batch-cost.d.ts.map +1 -0
  129. package/dist/batch-cost.js +41 -0
  130. package/dist/batch-cost.js.map +1 -0
  131. package/dist/bedrock-oss-pricing.d.ts +6 -0
  132. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  133. package/dist/bedrock-oss-pricing.js +58 -0
  134. package/dist/bedrock-oss-pricing.js.map +1 -0
  135. package/dist/bedrock-pricing.d.ts +15 -0
  136. package/dist/bedrock-pricing.d.ts.map +1 -0
  137. package/dist/bedrock-pricing.js +117 -0
  138. package/dist/bedrock-pricing.js.map +1 -0
  139. package/dist/blackduck-findings.d.ts +1 -1
  140. package/dist/blackduck-findings.d.ts.map +1 -1
  141. package/dist/blackduck-findings.js +24 -22
  142. package/dist/blackduck-findings.js.map +1 -1
  143. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  144. package/dist/bulk-scan-discovery.js +4 -4
  145. package/dist/bulk-scan-discovery.js.map +1 -1
  146. package/dist/bundled-plugin.d.ts +4 -0
  147. package/dist/bundled-plugin.d.ts.map +1 -0
  148. package/dist/bundled-plugin.js +23 -0
  149. package/dist/bundled-plugin.js.map +1 -0
  150. package/dist/checkmarx-evidence.d.ts +19 -0
  151. package/dist/checkmarx-evidence.d.ts.map +1 -0
  152. package/dist/checkmarx-evidence.js +36 -0
  153. package/dist/checkmarx-evidence.js.map +1 -0
  154. package/dist/checkmarx-findings.d.ts +4 -0
  155. package/dist/checkmarx-findings.d.ts.map +1 -0
  156. package/dist/checkmarx-findings.js +27 -0
  157. package/dist/checkmarx-findings.js.map +1 -0
  158. package/dist/checkmarx-one.d.ts +4 -0
  159. package/dist/checkmarx-one.d.ts.map +1 -0
  160. package/dist/checkmarx-one.js +53 -0
  161. package/dist/checkmarx-one.js.map +1 -0
  162. package/dist/checkmarx-repository.d.ts +12 -0
  163. package/dist/checkmarx-repository.d.ts.map +1 -0
  164. package/dist/checkmarx-repository.js +181 -0
  165. package/dist/checkmarx-repository.js.map +1 -0
  166. package/dist/checkmarx-xml.d.ts +12 -0
  167. package/dist/checkmarx-xml.d.ts.map +1 -0
  168. package/dist/checkmarx-xml.js +196 -0
  169. package/dist/checkmarx-xml.js.map +1 -0
  170. package/dist/classify-scan-severity.d.ts +1 -1
  171. package/dist/classify-scan-severity.d.ts.map +1 -1
  172. package/dist/classify-scan-severity.js +11 -3
  173. package/dist/classify-scan-severity.js.map +1 -1
  174. package/dist/classify-severity-records.d.ts +1 -9
  175. package/dist/classify-severity-records.d.ts.map +1 -1
  176. package/dist/classify-severity-records.js +3 -13
  177. package/dist/classify-severity-records.js.map +1 -1
  178. package/dist/classify-severity.d.ts.map +1 -1
  179. package/dist/classify-severity.js +11 -10
  180. package/dist/classify-severity.js.map +1 -1
  181. package/dist/cli-argument.d.ts +4 -0
  182. package/dist/cli-argument.d.ts.map +1 -0
  183. package/dist/cli-argument.js +17 -0
  184. package/dist/cli-argument.js.map +1 -0
  185. package/dist/cli-help.d.ts +1 -1
  186. package/dist/cli-help.d.ts.map +1 -1
  187. package/dist/cli-help.js +71 -29
  188. package/dist/cli-help.js.map +1 -1
  189. package/dist/cli-hook.d.ts +3 -0
  190. package/dist/cli-hook.d.ts.map +1 -0
  191. package/dist/cli-hook.js +87 -0
  192. package/dist/cli-hook.js.map +1 -0
  193. package/dist/cli-integrations.d.ts +13 -0
  194. package/dist/cli-integrations.d.ts.map +1 -0
  195. package/dist/cli-integrations.js +333 -0
  196. package/dist/cli-integrations.js.map +1 -0
  197. package/dist/cli-mcp.d.ts +15 -0
  198. package/dist/cli-mcp.d.ts.map +1 -0
  199. package/dist/cli-mcp.js +178 -0
  200. package/dist/cli-mcp.js.map +1 -0
  201. package/dist/cli-token-view.d.ts +10 -0
  202. package/dist/cli-token-view.d.ts.map +1 -0
  203. package/dist/cli-token-view.js +41 -0
  204. package/dist/cli-token-view.js.map +1 -0
  205. package/dist/cli.d.ts +16 -8
  206. package/dist/cli.d.ts.map +1 -1
  207. package/dist/cli.js +3382 -2017
  208. package/dist/cli.js.map +1 -1
  209. package/dist/cloud-publish.d.ts.map +1 -1
  210. package/dist/cloud-publish.js +35 -33
  211. package/dist/cloud-publish.js.map +1 -1
  212. package/dist/codex-sdk-environment.d.ts +6 -0
  213. package/dist/codex-sdk-environment.d.ts.map +1 -1
  214. package/dist/codex-sdk-environment.js +19 -0
  215. package/dist/codex-sdk-environment.js.map +1 -1
  216. package/dist/command-words.d.ts +3 -0
  217. package/dist/command-words.d.ts.map +1 -0
  218. package/dist/command-words.js +46 -0
  219. package/dist/command-words.js.map +1 -0
  220. package/dist/component-scan.d.ts +19 -4
  221. package/dist/component-scan.d.ts.map +1 -1
  222. package/dist/component-scan.js +67 -9
  223. package/dist/component-scan.js.map +1 -1
  224. package/dist/config.d.ts +1 -1
  225. package/dist/config.d.ts.map +1 -1
  226. package/dist/config.js +130 -67
  227. package/dist/config.js.map +1 -1
  228. package/dist/continuum-findings.d.ts +1 -1
  229. package/dist/continuum-findings.d.ts.map +1 -1
  230. package/dist/continuum-findings.js +149 -19
  231. package/dist/continuum-findings.js.map +1 -1
  232. package/dist/contract-values.d.ts +2 -0
  233. package/dist/contract-values.d.ts.map +1 -1
  234. package/dist/contract-values.js +12 -9
  235. package/dist/contract-values.js.map +1 -1
  236. package/dist/cost-model.d.ts +13 -1
  237. package/dist/cost-model.d.ts.map +1 -1
  238. package/dist/cost-model.js +66 -112
  239. package/dist/cost-model.js.map +1 -1
  240. package/dist/cost.d.ts +42 -3
  241. package/dist/cost.d.ts.map +1 -1
  242. package/dist/cost.js +484 -149
  243. package/dist/cost.js.map +1 -1
  244. package/dist/custom-publish.d.ts +4 -0
  245. package/dist/custom-publish.d.ts.map +1 -1
  246. package/dist/custom-publish.js +40 -3
  247. package/dist/custom-publish.js.map +1 -1
  248. package/dist/custom-validation-prompt.d.ts +1 -1
  249. package/dist/custom-validation-prompt.d.ts.map +1 -1
  250. package/dist/custom-validation-prompt.js +29 -19
  251. package/dist/custom-validation-prompt.js.map +1 -1
  252. package/dist/deduplication/local.d.ts +4 -2
  253. package/dist/deduplication/local.d.ts.map +1 -1
  254. package/dist/deduplication/local.js +9 -2
  255. package/dist/deduplication/local.js.map +1 -1
  256. package/dist/deduplication/refusal.d.ts.map +1 -1
  257. package/dist/deduplication/refusal.js +26 -5
  258. package/dist/deduplication/refusal.js.map +1 -1
  259. package/dist/deduplication/scan.d.ts +5 -0
  260. package/dist/deduplication/scan.d.ts.map +1 -1
  261. package/dist/deduplication/scan.js +24 -7
  262. package/dist/deduplication/scan.js.map +1 -1
  263. package/dist/deep-config.d.ts +0 -1
  264. package/dist/deep-config.d.ts.map +1 -1
  265. package/dist/deep-config.js +22 -33
  266. package/dist/deep-config.js.map +1 -1
  267. package/dist/deep-scan-defaults.d.ts +2 -0
  268. package/dist/deep-scan-defaults.d.ts.map +1 -1
  269. package/dist/deep-scan-defaults.js +28 -1
  270. package/dist/deep-scan-defaults.js.map +1 -1
  271. package/dist/deep-scan.d.ts +2 -0
  272. package/dist/deep-scan.d.ts.map +1 -1
  273. package/dist/deep-scan.js +44 -19
  274. package/dist/deep-scan.js.map +1 -1
  275. package/dist/default-severity-rubric.d.ts +1 -1
  276. package/dist/default-severity-rubric.d.ts.map +1 -1
  277. package/dist/default-severity-rubric.js +1 -1
  278. package/dist/default-severity-rubric.js.map +1 -1
  279. package/dist/endor-findings.d.ts +3 -1
  280. package/dist/endor-findings.d.ts.map +1 -1
  281. package/dist/endor-findings.js +86 -45
  282. package/dist/endor-findings.js.map +1 -1
  283. package/dist/errors.d.ts +4 -2
  284. package/dist/errors.d.ts.map +1 -1
  285. package/dist/errors.js +15 -4
  286. package/dist/errors.js.map +1 -1
  287. package/dist/executable-path.d.ts +3 -0
  288. package/dist/executable-path.d.ts.map +1 -1
  289. package/dist/executable-path.js +26 -0
  290. package/dist/executable-path.js.map +1 -1
  291. package/dist/external-findings-import.d.ts +5 -3
  292. package/dist/external-findings-import.d.ts.map +1 -1
  293. package/dist/external-findings-import.js +19 -7
  294. package/dist/external-findings-import.js.map +1 -1
  295. package/dist/external-findings-local.d.ts +69 -5
  296. package/dist/external-findings-local.d.ts.map +1 -1
  297. package/dist/external-findings-local.js +537 -108
  298. package/dist/external-findings-local.js.map +1 -1
  299. package/dist/external-findings-publish.d.ts +13 -6
  300. package/dist/external-findings-publish.d.ts.map +1 -1
  301. package/dist/external-findings-publish.js +895 -1142
  302. package/dist/external-findings-publish.js.map +1 -1
  303. package/dist/external-findings-read.d.ts +21 -2
  304. package/dist/external-findings-read.d.ts.map +1 -1
  305. package/dist/external-findings-read.js +130 -68
  306. package/dist/external-findings-read.js.map +1 -1
  307. package/dist/external-findings.d.ts +15 -3
  308. package/dist/external-findings.d.ts.map +1 -1
  309. package/dist/external-findings.js +54 -2
  310. package/dist/external-findings.js.map +1 -1
  311. package/dist/external-import-contract.d.ts +8 -12
  312. package/dist/external-import-contract.d.ts.map +1 -1
  313. package/dist/external-import-contract.js +51 -184
  314. package/dist/external-import-contract.js.map +1 -1
  315. package/dist/external-import-models.d.ts +1 -1
  316. package/dist/external-import-models.d.ts.map +1 -1
  317. package/dist/external-import-models.js.map +1 -1
  318. package/dist/feedback.d.ts.map +1 -1
  319. package/dist/feedback.js +5 -4
  320. package/dist/feedback.js.map +1 -1
  321. package/dist/finding-prompt.d.ts +5 -0
  322. package/dist/finding-prompt.d.ts.map +1 -0
  323. package/dist/finding-prompt.js +32 -0
  324. package/dist/finding-prompt.js.map +1 -0
  325. package/dist/findings-client.d.ts +1 -0
  326. package/dist/findings-client.d.ts.map +1 -1
  327. package/dist/findings-client.js +27 -3
  328. package/dist/findings-client.js.map +1 -1
  329. package/dist/github-advisories.d.ts.map +1 -1
  330. package/dist/github-advisories.js +0 -2
  331. package/dist/github-advisories.js.map +1 -1
  332. package/dist/github-dependabot-findings.d.ts.map +1 -1
  333. package/dist/github-dependabot-findings.js +18 -8
  334. package/dist/github-dependabot-findings.js.map +1 -1
  335. package/dist/github-findings.d.ts +4 -1
  336. package/dist/github-findings.d.ts.map +1 -1
  337. package/dist/github-findings.js +73 -316
  338. package/dist/github-findings.js.map +1 -1
  339. package/dist/hosted-git-remotes.d.ts +5 -0
  340. package/dist/hosted-git-remotes.d.ts.map +1 -0
  341. package/dist/hosted-git-remotes.js +285 -0
  342. package/dist/hosted-git-remotes.js.map +1 -0
  343. package/dist/hosted-git-repository.d.ts +28 -0
  344. package/dist/hosted-git-repository.d.ts.map +1 -0
  345. package/dist/hosted-git-repository.js +222 -0
  346. package/dist/hosted-git-repository.js.map +1 -0
  347. package/dist/hosted-remediation.d.ts +1 -0
  348. package/dist/hosted-remediation.d.ts.map +1 -1
  349. package/dist/hosted-remediation.js +23 -3
  350. package/dist/hosted-remediation.js.map +1 -1
  351. package/dist/hosted-scan-protocol.js +2 -2
  352. package/dist/hosted-scan-protocol.js.map +1 -1
  353. package/dist/hosted-scan.d.ts.map +1 -1
  354. package/dist/hosted-scan.js +16 -11
  355. package/dist/hosted-scan.js.map +1 -1
  356. package/dist/hosted-scanner-http.d.ts +21 -0
  357. package/dist/hosted-scanner-http.d.ts.map +1 -0
  358. package/dist/hosted-scanner-http.js +204 -0
  359. package/dist/hosted-scanner-http.js.map +1 -0
  360. package/dist/import-scan.d.ts.map +1 -1
  361. package/dist/import-scan.js +3 -0
  362. package/dist/import-scan.js.map +1 -1
  363. package/dist/index.d.ts +21 -9
  364. package/dist/index.d.ts.map +1 -1
  365. package/dist/index.js +12 -3
  366. package/dist/index.js.map +1 -1
  367. package/dist/inspector-findings.d.ts.map +1 -1
  368. package/dist/inspector-findings.js +52 -86
  369. package/dist/inspector-findings.js.map +1 -1
  370. package/dist/knowledge-base.d.ts +1 -1
  371. package/dist/knowledge-base.d.ts.map +1 -1
  372. package/dist/knowledge-base.js +102 -32
  373. package/dist/knowledge-base.js.map +1 -1
  374. package/dist/linear.d.ts +11 -0
  375. package/dist/linear.d.ts.map +1 -1
  376. package/dist/linear.js.map +1 -1
  377. package/dist/local-git-metadata.d.ts +5 -2
  378. package/dist/local-git-metadata.d.ts.map +1 -1
  379. package/dist/local-git-metadata.js +8 -5
  380. package/dist/local-git-metadata.js.map +1 -1
  381. package/dist/multiscan.d.ts +10 -4
  382. package/dist/multiscan.d.ts.map +1 -1
  383. package/dist/multiscan.js +217 -102
  384. package/dist/multiscan.js.map +1 -1
  385. package/dist/native-json-findings.d.ts +2 -1
  386. package/dist/native-json-findings.d.ts.map +1 -1
  387. package/dist/native-json-findings.js +12 -2
  388. package/dist/native-json-findings.js.map +1 -1
  389. package/dist/opengrep-findings.d.ts +5 -2
  390. package/dist/opengrep-findings.d.ts.map +1 -1
  391. package/dist/opengrep-findings.js +54 -33
  392. package/dist/opengrep-findings.js.map +1 -1
  393. package/dist/operation-telemetry.d.ts +104 -0
  394. package/dist/operation-telemetry.d.ts.map +1 -0
  395. package/dist/operation-telemetry.js +293 -0
  396. package/dist/operation-telemetry.js.map +1 -0
  397. package/dist/plugin-python-probe.d.ts +4 -0
  398. package/dist/plugin-python-probe.d.ts.map +1 -0
  399. package/dist/plugin-python-probe.js +10 -0
  400. package/dist/plugin-python-probe.js.map +1 -0
  401. package/dist/private-finding-import.d.ts +99 -9
  402. package/dist/private-finding-import.d.ts.map +1 -1
  403. package/dist/private-finding-import.js +116 -152
  404. package/dist/private-finding-import.js.map +1 -1
  405. package/dist/project-config.d.ts.map +1 -1
  406. package/dist/project-config.js +53 -13
  407. package/dist/project-config.js.map +1 -1
  408. package/dist/prompt-files.d.ts +7 -2
  409. package/dist/prompt-files.d.ts.map +1 -1
  410. package/dist/prompt-files.js +42 -20
  411. package/dist/prompt-files.js.map +1 -1
  412. package/dist/provider-profile.d.ts +1 -1
  413. package/dist/provider-profile.d.ts.map +1 -1
  414. package/dist/provider-profile.js +12 -10
  415. package/dist/provider-profile.js.map +1 -1
  416. package/dist/publication-telemetry.d.ts +45 -0
  417. package/dist/publication-telemetry.d.ts.map +1 -0
  418. package/dist/publication-telemetry.js +50 -0
  419. package/dist/publication-telemetry.js.map +1 -0
  420. package/dist/publication.d.ts +1 -1
  421. package/dist/publication.d.ts.map +1 -1
  422. package/dist/publication.js.map +1 -1
  423. package/dist/publish.d.ts +4 -0
  424. package/dist/publish.d.ts.map +1 -1
  425. package/dist/publish.js +42 -2
  426. package/dist/publish.js.map +1 -1
  427. package/dist/record.d.ts +1 -5
  428. package/dist/record.d.ts.map +1 -1
  429. package/dist/record.js +3 -51
  430. package/dist/record.js.map +1 -1
  431. package/dist/remediation.d.ts +1 -4
  432. package/dist/remediation.d.ts.map +1 -1
  433. package/dist/remediation.js +6 -8
  434. package/dist/remediation.js.map +1 -1
  435. package/dist/request-metadata.d.ts +3 -0
  436. package/dist/request-metadata.d.ts.map +1 -1
  437. package/dist/request-metadata.js +9 -0
  438. package/dist/request-metadata.js.map +1 -1
  439. package/dist/result.d.ts +4 -0
  440. package/dist/result.d.ts.map +1 -1
  441. package/dist/result.js +1 -1
  442. package/dist/result.js.map +1 -1
  443. package/dist/retry-windows-rename.d.ts +8 -0
  444. package/dist/retry-windows-rename.d.ts.map +1 -0
  445. package/dist/retry-windows-rename.js +24 -0
  446. package/dist/retry-windows-rename.js.map +1 -0
  447. package/dist/runtime.d.ts +54 -6
  448. package/dist/runtime.d.ts.map +1 -1
  449. package/dist/runtime.js +1084 -256
  450. package/dist/runtime.js.map +1 -1
  451. package/dist/saved-scan-bootstrap.d.ts +7 -1
  452. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  453. package/dist/saved-scan-bootstrap.js +269 -114
  454. package/dist/saved-scan-bootstrap.js.map +1 -1
  455. package/dist/scan-activity.d.ts.map +1 -1
  456. package/dist/scan-activity.js +141 -56
  457. package/dist/scan-activity.js.map +1 -1
  458. package/dist/scan-archive-path.d.ts +2 -0
  459. package/dist/scan-archive-path.d.ts.map +1 -0
  460. package/dist/scan-archive-path.js +5 -0
  461. package/dist/scan-archive-path.js.map +1 -0
  462. package/dist/scan-comparison.d.ts +10 -5
  463. package/dist/scan-comparison.d.ts.map +1 -1
  464. package/dist/scan-comparison.js +66 -17
  465. package/dist/scan-comparison.js.map +1 -1
  466. package/dist/scan-dashboard.d.ts +7 -6
  467. package/dist/scan-dashboard.d.ts.map +1 -1
  468. package/dist/scan-dashboard.js +92 -43
  469. package/dist/scan-dashboard.js.map +1 -1
  470. package/dist/scan-executor.d.ts +10 -1
  471. package/dist/scan-executor.d.ts.map +1 -1
  472. package/dist/scan-executor.js +24 -2
  473. package/dist/scan-executor.js.map +1 -1
  474. package/dist/scan-history-renderer.d.ts +1 -0
  475. package/dist/scan-history-renderer.d.ts.map +1 -1
  476. package/dist/scan-history-renderer.js +34 -28
  477. package/dist/scan-history-renderer.js.map +1 -1
  478. package/dist/scan-logs.d.ts +12 -0
  479. package/dist/scan-logs.d.ts.map +1 -1
  480. package/dist/scan-logs.js +131 -78
  481. package/dist/scan-logs.js.map +1 -1
  482. package/dist/scan-measurement.d.ts +26 -0
  483. package/dist/scan-measurement.d.ts.map +1 -0
  484. package/dist/scan-measurement.js +77 -0
  485. package/dist/scan-measurement.js.map +1 -0
  486. package/dist/scan-progress.d.ts +1 -0
  487. package/dist/scan-progress.d.ts.map +1 -1
  488. package/dist/scan-progress.js +3 -0
  489. package/dist/scan-progress.js.map +1 -1
  490. package/dist/scan-sessions.d.ts.map +1 -1
  491. package/dist/scan-sessions.js +4 -1
  492. package/dist/scan-sessions.js.map +1 -1
  493. package/dist/scan-settings.d.ts +1 -1
  494. package/dist/scan-settings.d.ts.map +1 -1
  495. package/dist/scan-settings.js +1 -24
  496. package/dist/scan-settings.js.map +1 -1
  497. package/dist/scanner-import.d.ts +25 -13
  498. package/dist/scanner-import.d.ts.map +1 -1
  499. package/dist/scanner-import.js +216 -97
  500. package/dist/scanner-import.js.map +1 -1
  501. package/dist/scanner-repository-url.d.ts +4 -1
  502. package/dist/scanner-repository-url.d.ts.map +1 -1
  503. package/dist/scanner-repository-url.js +10 -6
  504. package/dist/scanner-repository-url.js.map +1 -1
  505. package/dist/security-policy.d.ts +1 -1
  506. package/dist/security-policy.d.ts.map +1 -1
  507. package/dist/security-policy.js +26 -6
  508. package/dist/security-policy.js.map +1 -1
  509. package/dist/semgrep-findings.d.ts +6 -3
  510. package/dist/semgrep-findings.d.ts.map +1 -1
  511. package/dist/semgrep-findings.js +72 -42
  512. package/dist/semgrep-findings.js.map +1 -1
  513. package/dist/semgrep-guardian-findings.d.ts +38 -0
  514. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  515. package/dist/semgrep-guardian-findings.js +165 -0
  516. package/dist/semgrep-guardian-findings.js.map +1 -0
  517. package/dist/semgrep-platform-collector.d.ts +26 -0
  518. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  519. package/dist/semgrep-platform-collector.js +108 -0
  520. package/dist/semgrep-platform-collector.js.map +1 -0
  521. package/dist/semgrep-platform-findings.d.ts +157 -6
  522. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  523. package/dist/semgrep-platform-findings.js +766 -103
  524. package/dist/semgrep-platform-findings.js.map +1 -1
  525. package/dist/server/api.d.ts +1 -1
  526. package/dist/server/api.d.ts.map +1 -1
  527. package/dist/server/api.js.map +1 -1
  528. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  529. package/dist/server/embedding-tokenizer.d.ts +2 -0
  530. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  531. package/dist/server/embedding-tokenizer.js +322 -0
  532. package/dist/server/embedding-tokenizer.js.map +6 -0
  533. package/dist/server/embeddings.d.ts +16 -2
  534. package/dist/server/embeddings.d.ts.map +1 -1
  535. package/dist/server/embeddings.js +35 -5
  536. package/dist/server/embeddings.js.map +1 -1
  537. package/dist/session-lines.d.ts +5 -0
  538. package/dist/session-lines.d.ts.map +1 -0
  539. package/dist/session-lines.js +60 -0
  540. package/dist/session-lines.js.map +1 -0
  541. package/dist/severity-review.d.ts +3 -1
  542. package/dist/severity-review.d.ts.map +1 -1
  543. package/dist/severity-review.js +3 -2
  544. package/dist/severity-review.js.map +1 -1
  545. package/dist/skill-authentication.d.ts +1 -0
  546. package/dist/skill-authentication.d.ts.map +1 -1
  547. package/dist/skill-authentication.js +1 -0
  548. package/dist/skill-authentication.js.map +1 -1
  549. package/dist/snyk-findings.d.ts +9 -2
  550. package/dist/snyk-findings.d.ts.map +1 -1
  551. package/dist/snyk-findings.js +90 -70
  552. package/dist/snyk-findings.js.map +1 -1
  553. package/dist/snyk-rest-findings.d.ts +59 -0
  554. package/dist/snyk-rest-findings.d.ts.map +1 -0
  555. package/dist/snyk-rest-findings.js +879 -0
  556. package/dist/snyk-rest-findings.js.map +1 -0
  557. package/dist/snyk-token-origin.d.ts +4 -0
  558. package/dist/snyk-token-origin.d.ts.map +1 -0
  559. package/dist/snyk-token-origin.js +82 -0
  560. package/dist/snyk-token-origin.js.map +1 -0
  561. package/dist/sonar-collector.d.ts.map +1 -1
  562. package/dist/sonar-collector.js +0 -3
  563. package/dist/sonar-collector.js.map +1 -1
  564. package/dist/sonar-findings.d.ts +1 -1
  565. package/dist/sonar-findings.d.ts.map +1 -1
  566. package/dist/sonar-findings.js +2 -4
  567. package/dist/sonar-findings.js.map +1 -1
  568. package/dist/sonar-import.d.ts +3 -0
  569. package/dist/sonar-import.d.ts.map +1 -1
  570. package/dist/sonar-import.js +30 -34
  571. package/dist/sonar-import.js.map +1 -1
  572. package/dist/stored-finding-projection.d.ts +6 -0
  573. package/dist/stored-finding-projection.d.ts.map +1 -0
  574. package/dist/stored-finding-projection.js +104 -0
  575. package/dist/stored-finding-projection.js.map +1 -0
  576. package/dist/stored-findings-publication.d.ts +23 -0
  577. package/dist/stored-findings-publication.d.ts.map +1 -0
  578. package/dist/stored-findings-publication.js +169 -0
  579. package/dist/stored-findings-publication.js.map +1 -0
  580. package/dist/target-drift.d.ts +9 -0
  581. package/dist/target-drift.d.ts.map +1 -0
  582. package/dist/target-drift.js +27 -0
  583. package/dist/target-drift.js.map +1 -0
  584. package/dist/targets.d.ts +8 -1
  585. package/dist/targets.d.ts.map +1 -1
  586. package/dist/targets.js +131 -42
  587. package/dist/targets.js.map +1 -1
  588. package/dist/tenable-findings.d.ts +6 -0
  589. package/dist/tenable-findings.d.ts.map +1 -0
  590. package/dist/tenable-findings.js +122 -0
  591. package/dist/tenable-findings.js.map +1 -0
  592. package/dist/terminal-stream.d.ts +13 -0
  593. package/dist/terminal-stream.d.ts.map +1 -0
  594. package/dist/terminal-stream.js +35 -0
  595. package/dist/terminal-stream.js.map +1 -0
  596. package/dist/trivy-findings.d.ts +19 -0
  597. package/dist/trivy-findings.d.ts.map +1 -0
  598. package/dist/trivy-findings.js +424 -0
  599. package/dist/trivy-findings.js.map +1 -0
  600. package/dist/trivy-import.d.ts +19 -0
  601. package/dist/trivy-import.d.ts.map +1 -0
  602. package/dist/trivy-import.js +151 -0
  603. package/dist/trivy-import.js.map +1 -0
  604. package/dist/trusted-executable.d.ts +6 -0
  605. package/dist/trusted-executable.d.ts.map +1 -1
  606. package/dist/trusted-executable.js +140 -37
  607. package/dist/trusted-executable.js.map +1 -1
  608. package/dist/validation-records.js +1 -1
  609. package/dist/validation-records.js.map +1 -1
  610. package/dist/veracode-findings.d.ts +1 -1
  611. package/dist/veracode-findings.d.ts.map +1 -1
  612. package/dist/veracode-findings.js +19 -6
  613. package/dist/veracode-findings.js.map +1 -1
  614. package/dist/version.d.ts +3 -1
  615. package/dist/version.d.ts.map +1 -1
  616. package/dist/version.js +184 -32
  617. package/dist/version.js.map +1 -1
  618. package/dist/vertex-pricing.d.ts +8 -0
  619. package/dist/vertex-pricing.d.ts.map +1 -0
  620. package/dist/vertex-pricing.js +20 -0
  621. package/dist/vertex-pricing.js.map +1 -0
  622. package/dist/windows-path.d.ts +1 -0
  623. package/dist/windows-path.d.ts.map +1 -1
  624. package/dist/windows-path.js +26 -1
  625. package/dist/windows-path.js.map +1 -1
  626. package/dist/wiz-findings.d.ts +6 -2
  627. package/dist/wiz-findings.d.ts.map +1 -1
  628. package/dist/wiz-findings.js +65 -89
  629. package/dist/wiz-findings.js.map +1 -1
  630. package/docs/classify-severity-records.md +27 -12
  631. package/docs/cli.md +853 -639
  632. package/docs/dedupe-records.md +44 -24
  633. package/docs/findings-service.md +84 -44
  634. package/docs/hosted-remediation.md +27 -11
  635. package/docs/hosted-scans.md +50 -42
  636. package/docs/sdk.md +903 -0
  637. package/docs/telemetry.md +236 -0
  638. package/docs/validate-records.md +78 -44
  639. package/package.json +23 -16
  640. package/schemas/external-findings.schema.json +4 -1
  641. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  642. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  643. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  644. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  645. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  646. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  647. package/dist/external-imports-feature.d.ts +0 -6
  648. package/dist/external-imports-feature.d.ts.map +0 -1
  649. package/dist/external-imports-feature.js +0 -51
  650. package/dist/external-imports-feature.js.map +0 -1
  651. package/dist/finding-normalization.d.ts +0 -5
  652. package/dist/finding-normalization.d.ts.map +0 -1
  653. package/dist/finding-normalization.js +0 -155
  654. package/dist/finding-normalization.js.map +0 -1
  655. package/dist/reader-selection.d.ts +0 -13
  656. package/dist/reader-selection.d.ts.map +0 -1
  657. package/dist/reader-selection.js +0 -81
  658. package/dist/reader-selection.js.map +0 -1
@@ -15,24 +15,64 @@ 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
  )
20
+ from workbench_native_indexes import _indexed_findings, _legacy_generations
21
+ from workbench_target_state import RepositoryIdentityCache
19
22
  from workbench_validation import bounded_output_text
20
23
 
21
24
 
22
25
  def get_scan_feedback(connection: sqlite3.Connection, scan: sqlite3.Row) -> dict[str, Any]:
26
+ """Return reviewed false-positive decisions from other completed scans of the same target.
27
+
28
+ For each finding, include the latest decision only if it closes the finding as a
29
+ false positive with a nonblank reason. Prefer the root-control location in its preview.
30
+ """
31
+ identities = RepositoryIdentityCache(connection)
32
+ scope = identities.scope_for_scan(scan)
33
+ if not scope.available:
34
+ return {"scanId": scan["id"], "targetId": scan["target_id"], "falsePositives": []}
35
+
36
+ legacy_generations = _legacy_generations(connection, identities)
37
+ indexed_findings = {
38
+ occurrence_id: finding
39
+ for finding in _indexed_findings(
40
+ connection,
41
+ identities=identities,
42
+ scan_scope=scope,
43
+ legacy_generations=legacy_generations,
44
+ )
45
+ for occurrence_id in finding["matched_occurrence_ids"]
46
+ }
47
+ source_filter, source_values = scope.sql(
48
+ "source_scans", supports_generation=identities.supports_generation
49
+ )
50
+ source_generation = (
51
+ "source_scans.repository_generation" if identities.supports_generation else "NULL"
52
+ )
53
+ legacy_generation = legacy_generations.get(scope.target_id)
54
+ decision_generation = (
55
+ f"COALESCE({source_generation}, ?)" if legacy_generation is not None else source_generation
56
+ )
57
+ decision_values = (
58
+ (legacy_generation, legacy_generation) if legacy_generation is not None else ()
59
+ )
23
60
  rows = connection.execute(
24
- """
61
+ f"""
25
62
  WITH ranked_decisions AS (
26
- SELECT findings.id AS finding_id, findings.fingerprint, findings.rule_id,
63
+ SELECT occurrences.id AS occurrence_id, findings.id AS finding_id, findings.fingerprint, findings.rule_id,
27
64
  findings.identity_anchor, findings.identity_instance, occurrences.title,
28
65
  occurrences.summary, COALESCE(triage.status, 'open') AS triage_status,
29
66
  triage.close_reason, triage.note,
30
67
  COALESCE(triage.updated_at, source_scans.completed_at) AS updated_at,
31
68
  source_scans.id AS source_scan_id,
69
+ source_scans.target_id,
70
+ {source_generation} AS repository_generation,
32
71
  source_scans.completed_at AS source_completed_at,
33
72
  locations.relative_path, locations.start_line, locations.end_line, locations.role,
34
73
  ROW_NUMBER() OVER (
35
- PARTITION BY findings.id
74
+ PARTITION BY findings.id, {decision_generation},
75
+ CASE WHEN {decision_generation} IS NULL THEN source_scans.target_id END
36
76
  ORDER BY
37
77
  julianday(upper(COALESCE(triage.updated_at, source_scans.completed_at))) DESC,
38
78
  julianday(upper(source_scans.completed_at)) DESC,
@@ -43,14 +83,9 @@ def get_scan_feedback(connection: sqlite3.Connection, scan: sqlite3.Row) -> dict
43
83
  JOIN scans AS source_scans ON source_scans.id = occurrences.scan_id
44
84
  LEFT JOIN finding_triage AS triage ON triage.occurrence_id = occurrences.id
45
85
  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
86
+ SELECT id {PRIMARY_FINDING_LOCATION_SQL}
52
87
  )
53
- WHERE source_scans.target_id = ?
88
+ WHERE {source_filter}
54
89
  AND source_scans.id != ?
55
90
  AND source_scans.status = 'complete'
56
91
  )
@@ -65,10 +100,21 @@ def get_scan_feedback(connection: sqlite3.Connection, scan: sqlite3.Row) -> dict
65
100
  julianday(upper(source_completed_at)) DESC,
66
101
  source_scan_id DESC, finding_id DESC
67
102
  """,
68
- (scan["target_id"], scan["id"]),
103
+ (*decision_values, *source_values, scan["id"]),
69
104
  )
70
105
  false_positives = []
106
+ reviewed_components: set[str] = set()
71
107
  for row in rows:
108
+ finding = indexed_findings.get(row["occurrence_id"])
109
+ if (
110
+ finding is None
111
+ or finding["status"] != "closed"
112
+ or finding["close_reason"] != "false_positive"
113
+ or finding["occurrence_id"] in reviewed_components
114
+ ):
115
+ continue
116
+ reviewed_components.add(finding["occurrence_id"])
117
+
72
118
  identity = {"anchor": row["identity_anchor"]}
73
119
  if row["identity_instance"] is not None:
74
120
  identity["instance"] = row["identity_instance"]
@@ -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"]
@@ -95,6 +95,7 @@ def _recorded_cost(value: str | None) -> dict[str, Any] | None:
95
95
 
96
96
 
97
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."""
98
99
  row = connection.execute(
99
100
  """SELECT w.*, s.cost_json FROM finding_workflows AS w
100
101
  LEFT JOIN scans AS s ON s.id = w.scan_id AND s.scan_dir = w.scan_dir
@@ -128,6 +129,7 @@ def read_workflow(connection: sqlite3.Connection, workflow_id: str) -> dict[str,
128
129
 
129
130
 
130
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."""
131
133
  values = {"id": state["id"]}
132
134
  values.update({column: state.get(field) for field, column in WORKFLOW_BINDINGS.items()})
133
135
  scope = state.get("scope", {})
@@ -160,6 +162,7 @@ def save_workflow(connection: sqlite3.Connection, state: dict[str, Any], timesta
160
162
 
161
163
 
162
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."""
163
166
  for field, value in binding.items():
164
167
  if field not in WORKFLOW_BINDINGS and field != "scope":
165
168
  raise SystemExit("Unknown workflow binding.")
@@ -206,6 +209,7 @@ def register_workflow_scan(
206
209
  def finding_workflow(
207
210
  connection: sqlite3.Connection, payload: dict[str, Any], timestamp: str
208
211
  ) -> dict[str, Any]:
212
+ """Dispatch a workflow request by ID and return its state, source snapshot, or review as the action specifies."""
209
213
  workflow_id = payload["id"]
210
214
  if not isinstance(workflow_id, str) or not workflow_id.strip():
211
215
  raise SystemExit("workflowId must be a nonempty string.")
@@ -5,6 +5,7 @@ import os
5
5
  import sqlite3
6
6
  import sys
7
7
  from collections.abc import Iterator
8
+ from functools import cache
8
9
  from itertools import islice
9
10
  from pathlib import Path
10
11
  from typing import Any
@@ -12,7 +13,17 @@ from typing import Any
12
13
  # Some plugin hosts launch Python with safe-path isolation enabled.
13
14
  sys.path.insert(0, str(Path(__file__).resolve().parent))
14
15
  import workbench_scan_history as scan_history
15
- from workbench_constants import FINDING_SUMMARY_BYTES, FINDING_TITLE_BYTES, FINDINGS_PAGE_MAX
16
+ from workbench_constants import (
17
+ FINDING_SUMMARY_BYTES,
18
+ FINDING_TITLE_BYTES,
19
+ FINDINGS_PAGE_MAX,
20
+ PRIMARY_FINDING_LOCATION_SQL,
21
+ )
22
+ from workbench_target_state import (
23
+ RepositoryIdentityCache,
24
+ RepositoryScanScope,
25
+ scan_repository_group,
26
+ )
16
27
  from workbench_validation import bounded_output_text, timestamp_key
17
28
 
18
29
 
@@ -20,13 +31,25 @@ def list_global_findings(
20
31
  connection: sqlite3.Connection,
21
32
  args: argparse.Namespace,
22
33
  ) -> dict[str, Any]:
34
+ """Return a page of indexed findings after applying the requested filters, with nextOffset for continuation."""
23
35
  limit = min(args.limit, FINDINGS_PAGE_MAX)
24
36
  query = args.query.strip().casefold() if args.query else ""
37
+ identities = RepositoryIdentityCache(connection)
38
+ repository = getattr(args, "repository", None)
39
+ requested = None
40
+ if repository is not None:
41
+ repository = identities.history_path(str(Path(repository).expanduser().absolute()))
42
+ requested = identities.for_path(repository)
43
+ scan_scope = identities.scope_for_path(repository)
44
+ else:
45
+ scan_scope = None if args.target_id is None else identities.scope(args.target_id)
46
+ target = identities.targets.get(args.target_id)
47
+ if identities.supports_identity and target is not None:
48
+ requested = identities.for_row(target)
25
49
  findings = (
26
50
  row
27
- for row in _indexed_findings(connection)
28
- if (args.target_id is None or row["target_id"] == args.target_id)
29
- and (args.severity is None or row["severity"] == args.severity)
51
+ for row in _indexed_findings(connection, identities=identities, scan_scope=scan_scope)
52
+ if (args.severity is None or row["severity"] == args.severity)
30
53
  and (args.status is None or row["status"] == args.status)
31
54
  and (
32
55
  not query
@@ -71,43 +94,151 @@ def list_global_findings(
71
94
  "limit": limit,
72
95
  "nextOffset": args.offset + limit if has_more else None,
73
96
  "offset": args.offset,
97
+ "projectionAvailable": requested is None or requested.ownership_matches,
74
98
  }
75
99
 
76
100
 
77
- def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]]:
78
- parents: dict[tuple[str, str], tuple[str, str]] = {}
101
+ def _legacy_generations(
102
+ connection: sqlite3.Connection, identities: RepositoryIdentityCache
103
+ ) -> dict[str, str]:
104
+ return (
105
+ {
106
+ row["target_id"]: row["generation"]
107
+ for row in connection.execute(
108
+ "SELECT target_id, MIN(repository_generation) AS generation FROM scans "
109
+ "WHERE repository_generation IS NOT NULL GROUP BY target_id "
110
+ "HAVING COUNT(DISTINCT repository_generation) = 1"
111
+ )
112
+ }
113
+ if identities.supports_generation
114
+ else {}
115
+ )
116
+
117
+
118
+ def _indexed_findings(
119
+ connection: sqlite3.Connection,
120
+ *,
121
+ identities: RepositoryIdentityCache | None = None,
122
+ scan_scope: RepositoryScanScope | None = None,
123
+ legacy_generations: dict[str, str] | None = None,
124
+ ) -> Iterator[dict[str, Any]]:
125
+ identities = identities or RepositoryIdentityCache(connection)
126
+
127
+ def scope_sql(alias: str) -> tuple[str, tuple[str, ...]]:
128
+ return (
129
+ scan_scope.sql(alias, supports_generation=identities.supports_generation)
130
+ if scan_scope is not None
131
+ else ("1", ())
132
+ )
133
+
134
+ def generation_sql(alias: str) -> str:
135
+ return f"{alias}.repository_generation" if identities.supports_generation else "NULL"
136
+
137
+ if legacy_generations is None:
138
+ legacy_generations = _legacy_generations(connection, identities)
139
+
140
+ def repository_group(scan: sqlite3.Row | dict) -> tuple[str, str]:
141
+ identity = scan_repository_group(scan)
142
+ generation = legacy_generations.get(scan["target_id"])
143
+ return (
144
+ ("repository", generation)
145
+ if identity[0] == "target" and generation is not None
146
+ else identity
147
+ )
148
+
149
+ target_filter, target_values = scope_sql("scans")
150
+ before_filter, before_values = scope_sql("before_scans")
151
+ after_filter, after_values = scope_sql("after_scans")
152
+ parents: dict[tuple[tuple[str, str], str], tuple[tuple[str, str], str]] = {}
79
153
 
80
- def group(identity: tuple[str, str]) -> tuple[str, str]:
154
+ def group(identity: tuple[tuple[str, str], str]) -> tuple[tuple[str, str], str]:
81
155
  while identity in parents:
82
156
  identity = parents[identity]
83
157
  return identity
84
158
 
85
159
  for match in connection.execute(
86
- """
87
- SELECT before_scans.target_id, before.finding_id AS before_finding_id,
160
+ f"""
161
+ SELECT before_scans.target_id AS before_target_id,
162
+ after_scans.target_id AS after_target_id,
163
+ {generation_sql("before_scans")} AS before_generation,
164
+ {generation_sql("after_scans")} AS after_generation,
165
+ before.finding_id AS before_finding_id,
88
166
  after.finding_id AS after_finding_id
89
167
  FROM scan_comparison_matches AS matches
90
168
  JOIN finding_occurrences AS before ON before.id = matches.before_occurrence_id
91
169
  JOIN scans AS before_scans ON before_scans.id = before.scan_id
170
+ JOIN security_targets AS before_targets ON before_targets.id = before_scans.target_id
92
171
  JOIN finding_occurrences AS after ON after.id = matches.after_occurrence_id
93
172
  JOIN scans AS after_scans ON after_scans.id = after.scan_id
94
- WHERE before_scans.target_id = after_scans.target_id
95
- """
173
+ JOIN security_targets AS after_targets ON after_targets.id = after_scans.target_id
174
+ WHERE {before_filter} AND {after_filter}
175
+ """,
176
+ (*before_values, *after_values),
96
177
  ):
97
- before = group((match["target_id"], match["before_finding_id"]))
98
- after = group((match["target_id"], match["after_finding_id"]))
178
+ if match["before_target_id"] != match["after_target_id"] and (
179
+ match["before_generation"] is None or match["after_generation"] is None
180
+ ):
181
+ continue
182
+ before_repository = repository_group(
183
+ {
184
+ "target_id": match["before_target_id"],
185
+ "repository_generation": match["before_generation"],
186
+ }
187
+ )
188
+ after_repository = repository_group(
189
+ {
190
+ "target_id": match["after_target_id"],
191
+ "repository_generation": match["after_generation"],
192
+ }
193
+ )
194
+ if before_repository != after_repository and (
195
+ match["before_target_id"] != match["after_target_id"]
196
+ or match["before_generation"] is not None
197
+ and match["after_generation"] is not None
198
+ ):
199
+ continue
200
+ before = group(
201
+ (
202
+ before_repository,
203
+ match["before_finding_id"],
204
+ )
205
+ )
206
+ after = group(
207
+ (
208
+ after_repository,
209
+ match["after_finding_id"],
210
+ )
211
+ )
99
212
  if before != after:
100
213
  parents[after] = before
101
214
 
102
- latest_scan_by_target = dict(
215
+ completion_column = (
216
+ "scans.completion_sequence" if "completion_sequence" in identities.scan_columns else "NULL"
217
+ )
218
+ completed_at_column = (
219
+ "scans.completed_at" if "completed_at" in identities.scan_columns else "NULL"
220
+ )
221
+ completed_scans = sorted(
103
222
  connection.execute(
104
- "SELECT target_id, id FROM scans WHERE status = 'complete' ORDER BY julianday(upper(started_at)), id"
105
- )
223
+ f"""
224
+ SELECT scans.target_id, scans.id, scans.started_at,
225
+ {generation_sql("scans")} AS repository_generation,
226
+ {completed_at_column} AS completed_at,
227
+ {completion_column} AS completion_sequence
228
+ FROM scans
229
+ JOIN security_targets AS targets ON targets.id = scans.target_id
230
+ WHERE scans.status = 'complete' AND {target_filter}
231
+ """,
232
+ target_values,
233
+ ),
234
+ key=scan_history._scan_completion_order,
106
235
  )
236
+ latest_scan_by_repository = {repository_group(row): row for row in completed_scans}
237
+ selected_latest_scan_id = completed_scans[-1]["id"] if completed_scans else None
107
238
 
108
- grouped: dict[tuple[str, str], list[sqlite3.Row]] = {}
239
+ grouped: dict[tuple[tuple[str, str], str], list[sqlite3.Row]] = {}
109
240
  for row in connection.execute(
110
- """
241
+ f"""
111
242
  SELECT
112
243
  occurrences.id AS occurrence_id,
113
244
  occurrences.finding_id,
@@ -116,6 +247,7 @@ def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]
116
247
  scans.id AS scan_id,
117
248
  scans.started_at AS scan_started_at,
118
249
  scans.target_id,
250
+ {generation_sql("scans")} AS repository_generation,
119
251
  targets.current_path AS target_path,
120
252
  scans.scope,
121
253
  scans.updated_at,
@@ -124,22 +256,41 @@ def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]
124
256
  triage.updated_at AS decision_updated_at,
125
257
  occurrences.title,
126
258
  occurrences.summary,
127
- (
128
- SELECT locations.relative_path
129
- FROM finding_locations AS locations
130
- WHERE locations.occurrence_id = occurrences.id
131
- ORDER BY
132
- CASE WHEN locations.role = 'root_control' THEN 0 ELSE 1 END,
133
- locations.sort_order
134
- LIMIT 1
135
- ) AS location_path
259
+ (SELECT relative_path {PRIMARY_FINDING_LOCATION_SQL}) AS location_path
136
260
  FROM finding_occurrences AS occurrences
137
261
  JOIN scans ON scans.id = occurrences.scan_id
138
262
  JOIN security_targets AS targets ON targets.id = scans.target_id
139
263
  LEFT JOIN finding_triage AS triage ON triage.occurrence_id = occurrences.id
264
+ WHERE {target_filter}
140
265
  """,
266
+ target_values,
141
267
  ):
142
- grouped.setdefault(group((row["target_id"], row["finding_id"])), []).append(row)
268
+ grouped.setdefault(
269
+ group(
270
+ (
271
+ repository_group(row),
272
+ row["finding_id"],
273
+ )
274
+ ),
275
+ [],
276
+ ).append(row)
277
+
278
+ # Global comparisons do not bind legacy history across current targets. A scoped
279
+ # projection already admits only its own target's legacy rows and decisions.
280
+ for identity, occurrences in list(grouped.items()):
281
+ current_targets = {
282
+ row["target_id"] for row in occurrences if row["repository_generation"] is not None
283
+ }
284
+ if len(current_targets) <= 1 or scan_scope is not None:
285
+ continue
286
+ current = []
287
+ for row in occurrences:
288
+ if row["repository_generation"] is None:
289
+ legacy_identity = (scan_repository_group(row), identity[1])
290
+ grouped.setdefault(legacy_identity, []).append(row)
291
+ else:
292
+ current.append(row)
293
+ grouped[identity] = current
143
294
 
144
295
  findings = []
145
296
  for occurrences in grouped.values():
@@ -163,16 +314,33 @@ def _indexed_findings(connection: sqlite3.Connection) -> Iterator[dict[str, Any]
163
314
  {(row["scan_started_at"], row["scan_id"]) for row in occurrences},
164
315
  key=lambda scan: (timestamp_key(scan[0]), scan[1]),
165
316
  )
317
+ component_latest_scan = max(
318
+ (
319
+ latest_scan_by_repository[repository]
320
+ for repository in {repository_group(row) for row in occurrences}
321
+ if repository in latest_scan_by_repository
322
+ ),
323
+ key=scan_history._scan_completion_order,
324
+ default=None,
325
+ )
326
+ latest_scan_id = (
327
+ selected_latest_scan_id
328
+ if scan_scope is not None
329
+ else component_latest_scan["id"]
330
+ if component_latest_scan is not None
331
+ else None
332
+ )
166
333
  findings.append(
167
334
  {
168
335
  **dict(latest),
336
+ "close_reason": decision["close_reason"] if decision is not None else None,
169
337
  "confirmed_in_latest_scan": any(
170
- row["scan_id"] == latest_scan_by_target.get(row["target_id"])
171
- for row in occurrences
338
+ row["scan_id"] == latest_scan_id for row in occurrences
172
339
  ),
173
340
  "known_since": scans[0][0],
174
341
  "known_scan_ids": [scan_id for _, scan_id in scans],
175
342
  "matched_finding_ids": sorted({row["finding_id"] for row in occurrences}),
343
+ "matched_occurrence_ids": sorted({row["occurrence_id"] for row in occurrences}),
176
344
  "occurrence_count": len(occurrences),
177
345
  "status": status,
178
346
  "updated_at": (
@@ -203,7 +371,9 @@ def list_repositories(
203
371
  connection: sqlite3.Connection,
204
372
  args: argparse.Namespace | None = None,
205
373
  ) -> dict[str, Any]:
374
+ """Return tracked targets with scan summaries, finding counts, and current checkout availability."""
206
375
  by_target: dict[str, dict[str, Any]] = {}
376
+ latest_rows: dict[str, sqlite3.Row] = {}
207
377
  for row in connection.execute(
208
378
  f"""
209
379
  SELECT targets.id AS repository_id, targets.display_name, targets.current_path,
@@ -212,28 +382,54 @@ def list_repositories(
212
382
  LEFT JOIN scans ON scans.target_id = targets.id
213
383
  AND scans.id IN (SELECT scan_id FROM scan_progress)
214
384
  LEFT JOIN scan_progress AS progress ON progress.scan_id = scans.id
385
+ LEFT JOIN scan_lifecycles AS lifecycle ON lifecycle.scan_id = scans.id
215
386
  ORDER BY julianday(upper(scans.started_at)) DESC, scans.id DESC, targets.id
216
387
  """
217
388
  ).fetchall():
218
- scan = scan_history.scan_summary(row) if row["id"] is not None else None
219
389
  target_id = row["repository_id"]
220
390
  if target_id not in by_target:
221
391
  by_target[target_id] = {
222
392
  "displayName": row["display_name"],
223
- "latestScan": scan,
393
+ "latestScan": None,
224
394
  "openFindingsCount": 0,
225
395
  "scanCount": 0,
226
396
  "targetId": target_id,
227
397
  "targetPath": row["current_path"],
228
398
  }
229
- if scan is not None:
230
- by_target[target_id]["scanCount"] += 1
399
+ if row["id"] is None:
400
+ continue
401
+ repository = by_target[target_id]
402
+ scan = scan_history.scan_summary(row)
403
+ repository["scanCount"] += 1
404
+ previous = latest_rows.get(target_id)
405
+ if previous is None or (
406
+ previous["status"] == row["status"] == "complete"
407
+ and scan_history._scan_completion_order(row)
408
+ > scan_history._scan_completion_order(previous)
409
+ ):
410
+ latest_rows[target_id] = row
411
+ repository["latestScan"] = scan
412
+
413
+ identities = RepositoryIdentityCache(connection)
414
+ legacy_generations = _legacy_generations(connection, identities)
415
+
416
+ @cache
417
+ def open_findings_count(target_id: str) -> int:
418
+ if not by_target[target_id]["scanCount"]:
419
+ return 0
420
+ scope = identities.scope(target_id)
421
+ if not scope.available:
422
+ return 0
423
+ return sum(
424
+ row["status"] == "open"
425
+ for row in _indexed_findings(
426
+ connection,
427
+ identities=identities,
428
+ scan_scope=scope,
429
+ legacy_generations=legacy_generations,
430
+ )
431
+ )
231
432
 
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
433
  repositories = list(by_target.values())
238
434
  pagination = {}
239
435
  if args is not None:
@@ -244,15 +440,15 @@ def list_repositories(
244
440
  if (args.target_id is None or repository["targetId"] == args.target_id)
245
441
  and (args.status != "scanned" or repository["scanCount"] > 0)
246
442
  and (args.status != "not_scanned" or repository["scanCount"] == 0)
247
- and (args.status != "open_findings" or repository["openFindingsCount"] > 0)
248
443
  and (
249
444
  not query
250
445
  or query in repository["displayName"].casefold()
251
446
  or query in repository["targetPath"].casefold()
252
447
  )
448
+ and (args.status != "open_findings" or open_findings_count(repository["targetId"]) > 0)
253
449
  ]
254
450
  if args.limit is not None or args.offset:
255
- limit = min(args.limit or FINDINGS_PAGE_MAX, FINDINGS_PAGE_MAX)
451
+ limit = args.limit or FINDINGS_PAGE_MAX
256
452
  end = args.offset + limit
257
453
  pagination = {
258
454
  "limit": limit,
@@ -261,6 +457,7 @@ def list_repositories(
261
457
  }
262
458
  repositories = repositories[args.offset : end]
263
459
  for repository in repositories:
460
+ repository["openFindingsCount"] = open_findings_count(repository["targetId"])
264
461
  path = os.path.expanduser(repository["targetPath"])
265
462
  try:
266
463
  repository["checkoutAvailable"] = Path(path).is_absolute() and os.path.isdir(