@openai/codex-security 0.8.3 → 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 (534) hide show
  1. package/README.md +192 -151
  2. package/_bundled_plugin/.mcp.json +5 -1
  3. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  4. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  5. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  6. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  7. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  8. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  9. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  10. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/package.json +1 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  20. package/_bundled_plugin/mcp/server.mjs +2 -11
  21. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  22. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  23. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  24. package/_bundled_plugin/references/final-report.md +5 -3
  25. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  26. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  27. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  28. package/_bundled_plugin/references/scan-contract.md +27 -33
  29. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  30. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  31. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  32. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  33. package/_bundled_plugin/scripts/deep_scan_workbench.py +165 -342
  34. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  35. package/_bundled_plugin/scripts/finalize_scan_contract.py +153 -227
  36. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  37. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  38. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  39. package/_bundled_plugin/scripts/posix_scan_local_files.py +11 -0
  40. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  41. package/_bundled_plugin/scripts/report_projection.py +81 -43
  42. package/_bundled_plugin/scripts/review_state.py +8 -2
  43. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  44. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  45. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  46. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  47. package/_bundled_plugin/scripts/windows_scan_local_files.py +388 -17
  48. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  49. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  50. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  51. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  52. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  53. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  54. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  55. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  56. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  57. package/_bundled_plugin/scripts/workbench_cli.py +30 -12
  58. package/_bundled_plugin/scripts/workbench_constants.py +10 -0
  59. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  60. package/_bundled_plugin/scripts/workbench_db.py +369 -137
  61. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  62. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  63. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  64. package/_bundled_plugin/scripts/workbench_native_indexes.py +12 -12
  65. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  66. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  67. package/_bundled_plugin/scripts/workbench_remediation.py +13 -0
  68. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  69. package/_bundled_plugin/scripts/workbench_scan_history.py +117 -55
  70. package/_bundled_plugin/scripts/workbench_scan_start.py +83 -24
  71. package/_bundled_plugin/scripts/workbench_scan_usage.py +644 -68
  72. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  73. package/_bundled_plugin/scripts/workbench_setup.py +13 -1
  74. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  75. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  76. package/_bundled_plugin/scripts/workbench_target.py +127 -56
  77. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  78. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  79. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -23
  80. package/_bundled_plugin/shared/workbench-migrations.json +34 -0
  81. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  82. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  83. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -1
  84. package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -25
  85. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  86. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  87. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  88. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  89. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  90. package/dist/api.d.ts +39 -4
  91. package/dist/api.d.ts.map +1 -1
  92. package/dist/api.js +774 -292
  93. package/dist/api.js.map +1 -1
  94. package/dist/auth.d.ts.map +1 -1
  95. package/dist/auth.js +4 -6
  96. package/dist/auth.js.map +1 -1
  97. package/dist/bedrock-oss-pricing.d.ts +6 -0
  98. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  99. package/dist/bedrock-oss-pricing.js +58 -0
  100. package/dist/bedrock-oss-pricing.js.map +1 -0
  101. package/dist/bedrock-pricing.d.ts +15 -0
  102. package/dist/bedrock-pricing.d.ts.map +1 -0
  103. package/dist/bedrock-pricing.js +117 -0
  104. package/dist/bedrock-pricing.js.map +1 -0
  105. package/dist/blackduck-findings.d.ts.map +1 -1
  106. package/dist/blackduck-findings.js +35 -20
  107. package/dist/blackduck-findings.js.map +1 -1
  108. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  109. package/dist/bulk-scan-discovery.js +4 -4
  110. package/dist/bulk-scan-discovery.js.map +1 -1
  111. package/dist/checkmarx-evidence.d.ts +19 -0
  112. package/dist/checkmarx-evidence.d.ts.map +1 -0
  113. package/dist/checkmarx-evidence.js +36 -0
  114. package/dist/checkmarx-evidence.js.map +1 -0
  115. package/dist/checkmarx-findings.d.ts +4 -0
  116. package/dist/checkmarx-findings.d.ts.map +1 -0
  117. package/dist/checkmarx-findings.js +27 -0
  118. package/dist/checkmarx-findings.js.map +1 -0
  119. package/dist/checkmarx-one.d.ts +4 -0
  120. package/dist/checkmarx-one.d.ts.map +1 -0
  121. package/dist/checkmarx-one.js +53 -0
  122. package/dist/checkmarx-one.js.map +1 -0
  123. package/dist/checkmarx-repository.d.ts +12 -0
  124. package/dist/checkmarx-repository.d.ts.map +1 -0
  125. package/dist/checkmarx-repository.js +181 -0
  126. package/dist/checkmarx-repository.js.map +1 -0
  127. package/dist/checkmarx-xml.d.ts +12 -0
  128. package/dist/checkmarx-xml.d.ts.map +1 -0
  129. package/dist/checkmarx-xml.js +196 -0
  130. package/dist/checkmarx-xml.js.map +1 -0
  131. package/dist/classify-severity-records.d.ts +1 -9
  132. package/dist/classify-severity-records.d.ts.map +1 -1
  133. package/dist/classify-severity-records.js +3 -13
  134. package/dist/classify-severity-records.js.map +1 -1
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +2 -4
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli.d.ts +11 -5
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1734 -1238
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.js +2 -2
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/component-scan.d.ts +16 -3
  145. package/dist/component-scan.d.ts.map +1 -1
  146. package/dist/component-scan.js +27 -2
  147. package/dist/component-scan.js.map +1 -1
  148. package/dist/config.d.ts.map +1 -1
  149. package/dist/config.js +100 -66
  150. package/dist/config.js.map +1 -1
  151. package/dist/continuum-findings.d.ts.map +1 -1
  152. package/dist/continuum-findings.js +80 -12
  153. package/dist/continuum-findings.js.map +1 -1
  154. package/dist/contract-values.d.ts +2 -0
  155. package/dist/contract-values.d.ts.map +1 -1
  156. package/dist/contract-values.js +12 -9
  157. package/dist/contract-values.js.map +1 -1
  158. package/dist/cost-model.d.ts +13 -1
  159. package/dist/cost-model.d.ts.map +1 -1
  160. package/dist/cost-model.js +66 -112
  161. package/dist/cost-model.js.map +1 -1
  162. package/dist/cost.d.ts +42 -3
  163. package/dist/cost.d.ts.map +1 -1
  164. package/dist/cost.js +483 -104
  165. package/dist/cost.js.map +1 -1
  166. package/dist/custom-publish.d.ts +4 -0
  167. package/dist/custom-publish.d.ts.map +1 -1
  168. package/dist/custom-publish.js +40 -3
  169. package/dist/custom-publish.js.map +1 -1
  170. package/dist/deduplication/local.d.ts +2 -2
  171. package/dist/deduplication/local.d.ts.map +1 -1
  172. package/dist/deduplication/local.js +2 -2
  173. package/dist/deduplication/local.js.map +1 -1
  174. package/dist/deduplication/refusal.d.ts.map +1 -1
  175. package/dist/deduplication/refusal.js +25 -5
  176. package/dist/deduplication/refusal.js.map +1 -1
  177. package/dist/deduplication/scan.d.ts +3 -0
  178. package/dist/deduplication/scan.d.ts.map +1 -1
  179. package/dist/deduplication/scan.js +1 -1
  180. package/dist/deduplication/scan.js.map +1 -1
  181. package/dist/deep-config.d.ts +0 -1
  182. package/dist/deep-config.d.ts.map +1 -1
  183. package/dist/deep-config.js +22 -33
  184. package/dist/deep-config.js.map +1 -1
  185. package/dist/deep-scan-defaults.d.ts +2 -0
  186. package/dist/deep-scan-defaults.d.ts.map +1 -1
  187. package/dist/deep-scan-defaults.js +28 -1
  188. package/dist/deep-scan-defaults.js.map +1 -1
  189. package/dist/deep-scan.d.ts +2 -0
  190. package/dist/deep-scan.d.ts.map +1 -1
  191. package/dist/deep-scan.js +28 -4
  192. package/dist/deep-scan.js.map +1 -1
  193. package/dist/default-severity-rubric.d.ts +1 -1
  194. package/dist/default-severity-rubric.d.ts.map +1 -1
  195. package/dist/default-severity-rubric.js +1 -1
  196. package/dist/default-severity-rubric.js.map +1 -1
  197. package/dist/endor-findings.d.ts +3 -1
  198. package/dist/endor-findings.d.ts.map +1 -1
  199. package/dist/endor-findings.js +103 -45
  200. package/dist/endor-findings.js.map +1 -1
  201. package/dist/errors.d.ts +1 -1
  202. package/dist/errors.d.ts.map +1 -1
  203. package/dist/errors.js +8 -1
  204. package/dist/errors.js.map +1 -1
  205. package/dist/external-findings-import.d.ts +5 -3
  206. package/dist/external-findings-import.d.ts.map +1 -1
  207. package/dist/external-findings-import.js +7 -6
  208. package/dist/external-findings-import.js.map +1 -1
  209. package/dist/external-findings-local.d.ts +7 -5
  210. package/dist/external-findings-local.d.ts.map +1 -1
  211. package/dist/external-findings-local.js +337 -89
  212. package/dist/external-findings-local.js.map +1 -1
  213. package/dist/external-findings-publish.d.ts +8 -6
  214. package/dist/external-findings-publish.d.ts.map +1 -1
  215. package/dist/external-findings-publish.js +1318 -258
  216. package/dist/external-findings-publish.js.map +1 -1
  217. package/dist/external-findings-read.d.ts +20 -2
  218. package/dist/external-findings-read.d.ts.map +1 -1
  219. package/dist/external-findings-read.js +148 -66
  220. package/dist/external-findings-read.js.map +1 -1
  221. package/dist/external-findings.d.ts +15 -3
  222. package/dist/external-findings.d.ts.map +1 -1
  223. package/dist/external-findings.js +42 -1
  224. package/dist/external-findings.js.map +1 -1
  225. package/dist/external-import-contract.d.ts +5 -1
  226. package/dist/external-import-contract.d.ts.map +1 -1
  227. package/dist/external-import-contract.js +23 -9
  228. package/dist/external-import-contract.js.map +1 -1
  229. package/dist/external-import-models.d.ts +1 -1
  230. package/dist/external-import-models.d.ts.map +1 -1
  231. package/dist/external-import-models.js.map +1 -1
  232. package/dist/feedback.d.ts.map +1 -1
  233. package/dist/feedback.js +5 -4
  234. package/dist/feedback.js.map +1 -1
  235. package/dist/finding-prompt.d.ts +5 -0
  236. package/dist/finding-prompt.d.ts.map +1 -0
  237. package/dist/finding-prompt.js +32 -0
  238. package/dist/finding-prompt.js.map +1 -0
  239. package/dist/findings-client.d.ts +1 -0
  240. package/dist/findings-client.d.ts.map +1 -1
  241. package/dist/findings-client.js +27 -3
  242. package/dist/findings-client.js.map +1 -1
  243. package/dist/github-advisories.d.ts.map +1 -1
  244. package/dist/github-advisories.js +0 -2
  245. package/dist/github-advisories.js.map +1 -1
  246. package/dist/github-dependabot-findings.d.ts.map +1 -1
  247. package/dist/github-dependabot-findings.js +15 -4
  248. package/dist/github-dependabot-findings.js.map +1 -1
  249. package/dist/github-findings.d.ts +4 -1
  250. package/dist/github-findings.d.ts.map +1 -1
  251. package/dist/github-findings.js +55 -30
  252. package/dist/github-findings.js.map +1 -1
  253. package/dist/hosted-git-remotes.d.ts +5 -0
  254. package/dist/hosted-git-remotes.d.ts.map +1 -0
  255. package/dist/hosted-git-remotes.js +285 -0
  256. package/dist/hosted-git-remotes.js.map +1 -0
  257. package/dist/hosted-git-repository.d.ts +28 -0
  258. package/dist/hosted-git-repository.d.ts.map +1 -0
  259. package/dist/hosted-git-repository.js +222 -0
  260. package/dist/hosted-git-repository.js.map +1 -0
  261. package/dist/hosted-scan-protocol.js +2 -2
  262. package/dist/hosted-scan-protocol.js.map +1 -1
  263. package/dist/hosted-scan.d.ts.map +1 -1
  264. package/dist/hosted-scan.js +16 -11
  265. package/dist/hosted-scan.js.map +1 -1
  266. package/dist/hosted-scanner-http.d.ts +21 -0
  267. package/dist/hosted-scanner-http.d.ts.map +1 -0
  268. package/dist/hosted-scanner-http.js +204 -0
  269. package/dist/hosted-scanner-http.js.map +1 -0
  270. package/dist/hosted-scanner-v1.d.ts +6 -0
  271. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  272. package/dist/hosted-scanner-v1.js +60 -0
  273. package/dist/hosted-scanner-v1.js.map +1 -0
  274. package/dist/import-scan.d.ts.map +1 -1
  275. package/dist/import-scan.js +3 -0
  276. package/dist/import-scan.js.map +1 -1
  277. package/dist/index.d.ts +18 -7
  278. package/dist/index.d.ts.map +1 -1
  279. package/dist/index.js +10 -2
  280. package/dist/index.js.map +1 -1
  281. package/dist/inspector-findings.d.ts.map +1 -1
  282. package/dist/inspector-findings.js +47 -65
  283. package/dist/inspector-findings.js.map +1 -1
  284. package/dist/knowledge-base.d.ts.map +1 -1
  285. package/dist/knowledge-base.js +68 -5
  286. package/dist/knowledge-base.js.map +1 -1
  287. package/dist/local-git-metadata.d.ts +1 -1
  288. package/dist/local-git-metadata.d.ts.map +1 -1
  289. package/dist/local-git-metadata.js +1 -2
  290. package/dist/local-git-metadata.js.map +1 -1
  291. package/dist/multiscan.d.ts +6 -4
  292. package/dist/multiscan.d.ts.map +1 -1
  293. package/dist/multiscan.js +138 -65
  294. package/dist/multiscan.js.map +1 -1
  295. package/dist/native-json-findings.d.ts +2 -1
  296. package/dist/native-json-findings.d.ts.map +1 -1
  297. package/dist/native-json-findings.js +12 -2
  298. package/dist/native-json-findings.js.map +1 -1
  299. package/dist/opengrep-findings.d.ts +1 -0
  300. package/dist/opengrep-findings.d.ts.map +1 -1
  301. package/dist/opengrep-findings.js +17 -13
  302. package/dist/opengrep-findings.js.map +1 -1
  303. package/dist/operation-telemetry.d.ts +104 -0
  304. package/dist/operation-telemetry.d.ts.map +1 -0
  305. package/dist/operation-telemetry.js +293 -0
  306. package/dist/operation-telemetry.js.map +1 -0
  307. package/dist/plugin-python-probe.d.ts +4 -0
  308. package/dist/plugin-python-probe.d.ts.map +1 -0
  309. package/dist/plugin-python-probe.js +10 -0
  310. package/dist/plugin-python-probe.js.map +1 -0
  311. package/dist/private-finding-import.d.ts +97 -2
  312. package/dist/private-finding-import.d.ts.map +1 -1
  313. package/dist/private-finding-import.js +58 -34
  314. package/dist/private-finding-import.js.map +1 -1
  315. package/dist/provider-profile.d.ts +1 -1
  316. package/dist/provider-profile.d.ts.map +1 -1
  317. package/dist/provider-profile.js +8 -1
  318. package/dist/provider-profile.js.map +1 -1
  319. package/dist/publication-telemetry.d.ts +45 -0
  320. package/dist/publication-telemetry.d.ts.map +1 -0
  321. package/dist/publication-telemetry.js +50 -0
  322. package/dist/publication-telemetry.js.map +1 -0
  323. package/dist/publish.d.ts +4 -0
  324. package/dist/publish.d.ts.map +1 -1
  325. package/dist/publish.js +42 -2
  326. package/dist/publish.js.map +1 -1
  327. package/dist/reader-selection.d.ts +2 -0
  328. package/dist/reader-selection.d.ts.map +1 -1
  329. package/dist/reader-selection.js +8 -0
  330. package/dist/reader-selection.js.map +1 -1
  331. package/dist/remediation.d.ts +1 -4
  332. package/dist/remediation.d.ts.map +1 -1
  333. package/dist/remediation.js +3 -7
  334. package/dist/remediation.js.map +1 -1
  335. package/dist/request-metadata.d.ts +3 -0
  336. package/dist/request-metadata.d.ts.map +1 -1
  337. package/dist/request-metadata.js +9 -0
  338. package/dist/request-metadata.js.map +1 -1
  339. package/dist/result.d.ts +4 -0
  340. package/dist/result.d.ts.map +1 -1
  341. package/dist/result.js +1 -1
  342. package/dist/result.js.map +1 -1
  343. package/dist/retry-windows-rename.d.ts +8 -0
  344. package/dist/retry-windows-rename.d.ts.map +1 -0
  345. package/dist/retry-windows-rename.js +24 -0
  346. package/dist/retry-windows-rename.js.map +1 -0
  347. package/dist/runtime.d.ts +20 -0
  348. package/dist/runtime.d.ts.map +1 -1
  349. package/dist/runtime.js +313 -110
  350. package/dist/runtime.js.map +1 -1
  351. package/dist/saved-scan-bootstrap.d.ts +1 -0
  352. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  353. package/dist/saved-scan-bootstrap.js +18 -15
  354. package/dist/saved-scan-bootstrap.js.map +1 -1
  355. package/dist/scan-activity.d.ts.map +1 -1
  356. package/dist/scan-activity.js +141 -56
  357. package/dist/scan-activity.js.map +1 -1
  358. package/dist/scan-comparison.d.ts +10 -5
  359. package/dist/scan-comparison.d.ts.map +1 -1
  360. package/dist/scan-comparison.js +60 -15
  361. package/dist/scan-comparison.js.map +1 -1
  362. package/dist/scan-dashboard.d.ts +6 -6
  363. package/dist/scan-dashboard.d.ts.map +1 -1
  364. package/dist/scan-dashboard.js +75 -42
  365. package/dist/scan-dashboard.js.map +1 -1
  366. package/dist/scan-executor.d.ts +10 -1
  367. package/dist/scan-executor.d.ts.map +1 -1
  368. package/dist/scan-executor.js +22 -2
  369. package/dist/scan-executor.js.map +1 -1
  370. package/dist/scan-history-renderer.d.ts.map +1 -1
  371. package/dist/scan-history-renderer.js +9 -19
  372. package/dist/scan-history-renderer.js.map +1 -1
  373. package/dist/scan-logs.d.ts +12 -0
  374. package/dist/scan-logs.d.ts.map +1 -1
  375. package/dist/scan-logs.js +106 -77
  376. package/dist/scan-logs.js.map +1 -1
  377. package/dist/scan-measurement.d.ts +26 -0
  378. package/dist/scan-measurement.d.ts.map +1 -0
  379. package/dist/scan-measurement.js +77 -0
  380. package/dist/scan-measurement.js.map +1 -0
  381. package/dist/scan-progress.d.ts +1 -0
  382. package/dist/scan-progress.d.ts.map +1 -1
  383. package/dist/scan-progress.js +3 -0
  384. package/dist/scan-progress.js.map +1 -1
  385. package/dist/scan-sessions.d.ts.map +1 -1
  386. package/dist/scan-sessions.js +4 -1
  387. package/dist/scan-sessions.js.map +1 -1
  388. package/dist/scan-settings.d.ts +1 -1
  389. package/dist/scan-settings.d.ts.map +1 -1
  390. package/dist/scan-settings.js +1 -24
  391. package/dist/scan-settings.js.map +1 -1
  392. package/dist/scanner-import.d.ts +20 -2
  393. package/dist/scanner-import.d.ts.map +1 -1
  394. package/dist/scanner-import.js +200 -8
  395. package/dist/scanner-import.js.map +1 -1
  396. package/dist/scanner-repository-url.d.ts +4 -1
  397. package/dist/scanner-repository-url.d.ts.map +1 -1
  398. package/dist/scanner-repository-url.js +10 -6
  399. package/dist/scanner-repository-url.js.map +1 -1
  400. package/dist/security-policy.d.ts +1 -1
  401. package/dist/security-policy.d.ts.map +1 -1
  402. package/dist/security-policy.js.map +1 -1
  403. package/dist/semgrep-findings.d.ts +6 -3
  404. package/dist/semgrep-findings.d.ts.map +1 -1
  405. package/dist/semgrep-findings.js +107 -43
  406. package/dist/semgrep-findings.js.map +1 -1
  407. package/dist/semgrep-guardian-findings.d.ts +38 -0
  408. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  409. package/dist/semgrep-guardian-findings.js +165 -0
  410. package/dist/semgrep-guardian-findings.js.map +1 -0
  411. package/dist/semgrep-platform-collector.d.ts +26 -0
  412. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  413. package/dist/semgrep-platform-collector.js +108 -0
  414. package/dist/semgrep-platform-collector.js.map +1 -0
  415. package/dist/semgrep-platform-findings.d.ts +207 -6
  416. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  417. package/dist/semgrep-platform-findings.js +983 -103
  418. package/dist/semgrep-platform-findings.js.map +1 -1
  419. package/dist/semgrep-platform-v1.d.ts +6 -0
  420. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  421. package/dist/semgrep-platform-v1.js +83 -0
  422. package/dist/semgrep-platform-v1.js.map +1 -0
  423. package/dist/server/api.d.ts +1 -1
  424. package/dist/server/api.d.ts.map +1 -1
  425. package/dist/server/api.js.map +1 -1
  426. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  427. package/dist/server/embedding-tokenizer.d.ts +2 -0
  428. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  429. package/dist/server/embedding-tokenizer.js +322 -0
  430. package/dist/server/embedding-tokenizer.js.map +6 -0
  431. package/dist/server/embeddings.d.ts +16 -2
  432. package/dist/server/embeddings.d.ts.map +1 -1
  433. package/dist/server/embeddings.js +35 -5
  434. package/dist/server/embeddings.js.map +1 -1
  435. package/dist/session-lines.d.ts +5 -0
  436. package/dist/session-lines.d.ts.map +1 -0
  437. package/dist/session-lines.js +60 -0
  438. package/dist/session-lines.js.map +1 -0
  439. package/dist/severity-review.d.ts +3 -1
  440. package/dist/severity-review.d.ts.map +1 -1
  441. package/dist/severity-review.js +3 -2
  442. package/dist/severity-review.js.map +1 -1
  443. package/dist/skill-authentication.d.ts +1 -0
  444. package/dist/skill-authentication.d.ts.map +1 -1
  445. package/dist/skill-authentication.js +1 -0
  446. package/dist/skill-authentication.js.map +1 -1
  447. package/dist/snyk-findings.d.ts +7 -2
  448. package/dist/snyk-findings.d.ts.map +1 -1
  449. package/dist/snyk-findings.js +93 -70
  450. package/dist/snyk-findings.js.map +1 -1
  451. package/dist/snyk-rest-findings.d.ts +76 -0
  452. package/dist/snyk-rest-findings.d.ts.map +1 -0
  453. package/dist/snyk-rest-findings.js +1051 -0
  454. package/dist/snyk-rest-findings.js.map +1 -0
  455. package/dist/snyk-rest-v1.d.ts +28 -0
  456. package/dist/snyk-rest-v1.d.ts.map +1 -0
  457. package/dist/snyk-rest-v1.js +132 -0
  458. package/dist/snyk-rest-v1.js.map +1 -0
  459. package/dist/snyk-token-origin.d.ts +4 -0
  460. package/dist/snyk-token-origin.d.ts.map +1 -0
  461. package/dist/snyk-token-origin.js +82 -0
  462. package/dist/snyk-token-origin.js.map +1 -0
  463. package/dist/sonar-collector.d.ts.map +1 -1
  464. package/dist/sonar-collector.js +0 -3
  465. package/dist/sonar-collector.js.map +1 -1
  466. package/dist/sonar-import.d.ts.map +1 -1
  467. package/dist/sonar-import.js +2 -4
  468. package/dist/sonar-import.js.map +1 -1
  469. package/dist/target-drift.d.ts +9 -0
  470. package/dist/target-drift.d.ts.map +1 -0
  471. package/dist/target-drift.js +27 -0
  472. package/dist/target-drift.js.map +1 -0
  473. package/dist/targets.d.ts +2 -0
  474. package/dist/targets.d.ts.map +1 -1
  475. package/dist/targets.js +56 -20
  476. package/dist/targets.js.map +1 -1
  477. package/dist/tenable-findings.d.ts +9 -0
  478. package/dist/tenable-findings.d.ts.map +1 -0
  479. package/dist/tenable-findings.js +122 -0
  480. package/dist/tenable-findings.js.map +1 -0
  481. package/dist/terminal-stream.d.ts +13 -0
  482. package/dist/terminal-stream.d.ts.map +1 -0
  483. package/dist/terminal-stream.js +35 -0
  484. package/dist/terminal-stream.js.map +1 -0
  485. package/dist/trivy-findings.d.ts +19 -0
  486. package/dist/trivy-findings.d.ts.map +1 -0
  487. package/dist/trivy-findings.js +435 -0
  488. package/dist/trivy-findings.js.map +1 -0
  489. package/dist/trivy-import.d.ts +19 -0
  490. package/dist/trivy-import.d.ts.map +1 -0
  491. package/dist/trivy-import.js +151 -0
  492. package/dist/trivy-import.js.map +1 -0
  493. package/dist/validation-records.js +1 -1
  494. package/dist/validation-records.js.map +1 -1
  495. package/dist/veracode-findings.d.ts +2 -0
  496. package/dist/veracode-findings.d.ts.map +1 -1
  497. package/dist/veracode-findings.js +49 -11
  498. package/dist/veracode-findings.js.map +1 -1
  499. package/dist/vertex-pricing.d.ts +8 -0
  500. package/dist/vertex-pricing.d.ts.map +1 -0
  501. package/dist/vertex-pricing.js +20 -0
  502. package/dist/vertex-pricing.js.map +1 -0
  503. package/dist/windows-path.d.ts +1 -0
  504. package/dist/windows-path.d.ts.map +1 -1
  505. package/dist/windows-path.js +26 -1
  506. package/dist/windows-path.js.map +1 -1
  507. package/dist/wiz-findings.d.ts +4 -0
  508. package/dist/wiz-findings.d.ts.map +1 -1
  509. package/dist/wiz-findings.js +57 -3
  510. package/dist/wiz-findings.js.map +1 -1
  511. package/docs/classify-severity-records.md +27 -12
  512. package/docs/cli.md +497 -550
  513. package/docs/dedupe-records.md +44 -24
  514. package/docs/findings-service.md +66 -39
  515. package/docs/hosted-remediation.md +14 -7
  516. package/docs/hosted-scans.md +50 -42
  517. package/docs/telemetry.md +236 -0
  518. package/docs/validate-records.md +78 -44
  519. package/package.json +18 -15
  520. package/schemas/external-findings.schema.json +3 -1
  521. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  522. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  523. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  524. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  525. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  526. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  527. package/dist/external-imports-feature.d.ts +0 -6
  528. package/dist/external-imports-feature.d.ts.map +0 -1
  529. package/dist/external-imports-feature.js +0 -51
  530. package/dist/external-imports-feature.js.map +0 -1
  531. package/dist/finding-normalization.d.ts +0 -5
  532. package/dist/finding-normalization.d.ts.map +0 -1
  533. package/dist/finding-normalization.js +0 -155
  534. package/dist/finding-normalization.js.map +0 -1
@@ -25,7 +25,7 @@ from finalize_scan_contract import (
25
25
  )
26
26
  from report_projection import SEVERITY_ORDER
27
27
  from review_state import review_state
28
- from workbench_constants import ARTIFACTS, FINDINGS_PAGE_MAX
28
+ from workbench_constants import ARTIFACTS, FINDINGS_PAGE_MAX, PRIMARY_FINDING_LOCATION_SQL
29
29
  from workbench_scan_start import scan_target_identity
30
30
  from workbench_scan_usage import stored_scan_cost_fields
31
31
  from workbench_source_scopes import public_scan_recipe
@@ -43,6 +43,7 @@ def rename_scan(connection: sqlite3.Connection, scan: sqlite3.Row, name: str) ->
43
43
 
44
44
 
45
45
  def scan_recipe(scan: sqlite3.Row) -> dict[str, Any]:
46
+ """Return the public launch recipe with its scan and parent IDs, raising SystemExit if the recipe was never saved."""
46
47
  if scan["recipe_json"] is None:
47
48
  raise SystemExit("This scan does not have a saved launch recipe.")
48
49
  return {
@@ -55,6 +56,7 @@ def scan_recipe(scan: sqlite3.Row) -> dict[str, Any]:
55
56
  def preserve_sealed_completion(
56
57
  binding: dict[str, Any], manifest: dict[str, Any] | None
57
58
  ) -> dict[str, Any]:
59
+ """Copy the original timestamps and producer version from a sealed manifest into binding, then return it."""
58
60
  manifest_scan = manifest.get("scan") if manifest is not None else None
59
61
  if isinstance(manifest_scan, dict) and manifest_scan.get("sealedAt") is not None:
60
62
  # Keep the original producer; finalization still validates schema, seal and owner.
@@ -72,6 +74,7 @@ def cli_scan_resume(
72
74
  scan: sqlite3.Row,
73
75
  workspace: sqlite3.Row,
74
76
  ) -> dict[str, Any]:
77
+ scan = scan_with_progress(connection, scan["id"])
75
78
  if scan["mode"] != "deep" or scan["recipe_json"] is None:
76
79
  raise SystemExit("Resume requires a Deep Scan with a saved CLI launch recipe.")
77
80
  if scan["status"] != "running" or scan["canceled_at"] is not None:
@@ -109,15 +112,13 @@ def cli_scan_resume(
109
112
  raise SystemExit("Cannot resume: the original checkout revision or contents changed.")
110
113
  recipe = wb.parse_scan_recipe(scan["recipe_json"], repository)
111
114
  scan_dir = wb.require_canonical_scan_directory(Path(scan["scan_dir"]))
112
- progress = connection.execute(
113
- "SELECT scope_file_count FROM scan_progress WHERE scan_id = ?", (scan["id"],)
114
- ).fetchone()
115
115
  result = {
116
116
  "contract": wb.scan_contract(scan),
117
+ "lifecycle": json.loads(scan["lifecycle_json"]),
117
118
  "recipe": recipe,
118
119
  "scanDir": str(scan_dir),
119
120
  "scanId": scan["id"],
120
- "scopeFileCount": progress["scope_file_count"],
121
+ "scopeFileCount": scan["scope_file_count"],
121
122
  "startedAt": scan["started_at"],
122
123
  "targetId": scan["target_id"],
123
124
  "targetRevision": scan["target_revision"],
@@ -148,6 +149,7 @@ def cli_scan_resume(
148
149
  def coverage_summary_for_history(
149
150
  wb: Any, scan: sqlite3.Row, canonical_scan_directory: Callable[[Path], Path]
150
151
  ) -> dict[str, Any]:
152
+ """Return the coverage mode and path filters for history after verifying the sealed scan data."""
151
153
  scan_dir = canonical_scan_directory(Path(scan["scan_dir"]))
152
154
  coverage_ref = "coverage.json"
153
155
  try:
@@ -268,6 +270,7 @@ def _repository_origin(remote: str | None) -> tuple[str, str] | None:
268
270
 
269
271
  SCAN_SUMMARY_COLUMNS = """
270
272
  scans.*,
273
+ lifecycle.snapshot AS lifecycle_json,
271
274
  progress.reportable_findings_count,
272
275
  progress.scope_file_count,
273
276
  progress.review_items_completed,
@@ -283,15 +286,36 @@ SCAN_SUMMARY_QUERY = f"""
283
286
  SELECT {SCAN_SUMMARY_COLUMNS}
284
287
  FROM scans
285
288
  JOIN scan_progress AS progress ON progress.scan_id = scans.id
289
+ JOIN scan_lifecycles AS lifecycle ON lifecycle.scan_id = scans.id
286
290
  """
287
291
 
288
292
 
293
+ def scan_with_progress(connection: sqlite3.Connection, scan_id: str) -> sqlite3.Row:
294
+ return connection.execute(
295
+ """
296
+ SELECT scans.*, lifecycle.snapshot AS lifecycle_json, progress.updated_at AS progress_updated_at,
297
+ progress.scope_file_count, progress.reportable_findings_count,
298
+ progress.review_items_total, progress.review_items_completed, progress.deep_review_pass,
299
+ progress.phase_items_total, progress.phase_items_completed, progress.phase_progress_unit,
300
+ progress.preflight_checks_total, progress.preflight_checks_completed,
301
+ progress.preflight_issues_json
302
+ FROM scans
303
+ JOIN scan_progress AS progress ON progress.scan_id = scans.id
304
+ JOIN scan_lifecycles AS lifecycle ON lifecycle.scan_id = scans.id
305
+ WHERE scans.id = ?
306
+ """,
307
+ (scan_id,),
308
+ ).fetchone()
309
+
310
+
289
311
  def scan_summary(row: sqlite3.Row) -> dict[str, Any]:
290
312
  return {
291
313
  "completedAt": row["completed_at"],
314
+ "logCompletedAt": row["log_completed_at"],
292
315
  "continuationThreadId": row["continuation_thread_id"],
293
316
  **stored_scan_cost_fields(row["cost_json"]),
294
317
  "findingCount": row["finding_count"],
318
+ "lifecycle": json.loads(row["lifecycle_json"]),
295
319
  "handoffStatus": row["handoff_status"],
296
320
  "mode": row["mode"],
297
321
  "model": row["model"],
@@ -401,7 +425,7 @@ def list_scans(
401
425
  values.extend((query, query, query, query, query))
402
426
  where = f"WHERE {' AND '.join(clauses)}" if clauses else ""
403
427
  paginated = args is not None and (args.limit is not None or args.offset != 0)
404
- limit = min(args.limit or FINDINGS_PAGE_MAX, FINDINGS_PAGE_MAX) if paginated else None
428
+ limit = (args.limit or FINDINGS_PAGE_MAX) if paginated else None
405
429
  pagination = "LIMIT ? OFFSET ?" if paginated else ""
406
430
  if limit is not None:
407
431
  values.extend((limit + 1, args.offset))
@@ -430,6 +454,61 @@ def list_scans(
430
454
  return result
431
455
 
432
456
 
457
+ _FindingSites = dict[tuple[str, str | None, PurePosixPath, int, int], dict[str, Any] | None]
458
+ # Match the first location shown by compactFinding in finding-catalogue.ts.
459
+ _COMPARISON_LOCATION_RANK = {"root_control": 0, "expected_control": 1, "concrete_implementation": 1}
460
+
461
+
462
+ def _unique_finding_sites(findings: list[dict[str, Any]]) -> _FindingSites:
463
+ sites = {}
464
+ for finding in findings:
465
+ if not finding.get("locations"):
466
+ return {}
467
+ location = min(
468
+ finding["locations"],
469
+ key=lambda site: _COMPARISON_LOCATION_RANK.get(site.get("role"), 2),
470
+ )
471
+ key = (
472
+ finding["ruleId"],
473
+ finding["identity"].get("instance"),
474
+ PurePosixPath(location["path"]),
475
+ location["startLine"],
476
+ location.get("endLine", location["startLine"]),
477
+ )
478
+ sites[key] = None if key in sites else finding
479
+ return sites
480
+
481
+
482
+ def _cross_mode_context(
483
+ before: sqlite3.Row,
484
+ after: sqlite3.Row,
485
+ findings: dict[str, list[dict[str, Any]]],
486
+ sites: dict[str, _FindingSites],
487
+ ) -> dict[str, Any]:
488
+ # Different repository subdirectories can share both the Git revision and clean digest.
489
+ if (
490
+ {before["mode"], after["mode"]} != {"standard", "deep"}
491
+ or before["target_id"] is None
492
+ or before["target_id"] != after["target_id"]
493
+ or before["target_revision"] != after["target_revision"]
494
+ or before["target_snapshot_digest"] is None
495
+ or before["target_snapshot_digest"] != after["target_snapshot_digest"]
496
+ or not findings[before["id"]]
497
+ or not findings[after["id"]]
498
+ ):
499
+ return {}
500
+ for scan_id in (before["id"], after["id"]):
501
+ if scan_id not in sites:
502
+ sites[scan_id] = _unique_finding_sites(findings[scan_id])
503
+ later = sites[after["id"]]
504
+ occurrences = []
505
+ for site, old in sites[before["id"]].items():
506
+ new = later.get(site)
507
+ if old and new and old["identity"]["anchor"] != new["identity"]["anchor"]:
508
+ occurrences.extend((old["occurrenceId"], new["occurrenceId"]))
509
+ return {"crossModeOccurrenceIds": occurrences} if occurrences else {}
510
+
511
+
433
512
  def list_unmatched_scan_pairs(
434
513
  connection: sqlite3.Connection,
435
514
  args: argparse.Namespace,
@@ -472,6 +551,7 @@ def list_unmatched_scan_pairs(
472
551
  batches = []
473
552
  skipped = 0
474
553
  matching_findings: dict[str, list[dict[str, Any]]] = {}
554
+ sites: dict[str, _FindingSites] = {}
475
555
  known_links: list[sqlite3.Row] | None = None
476
556
  for index, (selected_index, after) in enumerate(available):
477
557
  previous = [
@@ -504,6 +584,7 @@ def list_unmatched_scan_pairs(
504
584
  "afterScanId": after["id"],
505
585
  "beforeScans": [
506
586
  {
587
+ **_cross_mode_context(before, after, matching_findings, sites),
507
588
  "findings": matching_findings[before["id"]],
508
589
  "scanId": before["id"],
509
590
  }
@@ -578,6 +659,7 @@ def compare_scans(
578
659
  include_matching_inputs: bool = False,
579
660
  require_matches: bool = False,
580
661
  ) -> dict[str, Any]:
662
+ """Compare completed scans of the same repository, returning finding groups and any inputs needed for matching."""
581
663
  before = require_scan(connection, args.before_scan_id)
582
664
  after = require_scan(connection, args.after_scan_id)
583
665
  if before["id"] == after["id"]:
@@ -611,9 +693,7 @@ def compare_scans(
611
693
  after_findings = _scan_findings(connection, after["id"])
612
694
  matches = json.loads(cached["result_json"]) if cached is not None else None
613
695
  saved_matches = matches["matches"] if matches is not None else []
614
- occurrences = {
615
- row["id"]: row for row in chain(before_findings.values(), after_findings.values())
616
- }
696
+ occurrences = before_findings | after_findings
617
697
  aliases = _confirmed_finding_aliases(connection, occurrences)
618
698
  groups = _finding_groups(before_findings, after_findings, saved_matches, aliases)
619
699
  uncertain = (
@@ -632,17 +712,8 @@ def compare_scans(
632
712
  }
633
713
 
634
714
  for previous_rows, current_rows, match_reason in groups:
635
- previous = (
636
- min(previous_rows, key=lambda row: SEVERITY_ORDER[row["severity"]])
637
- if previous_rows
638
- else None
639
- )
640
- current = (
641
- min(current_rows, key=lambda row: SEVERITY_ORDER[row["severity"]])
642
- if current_rows
643
- else None
644
- )
645
- selected = current if current is not None else previous
715
+ selected_rows = current_rows or previous_rows
716
+ selected = min(selected_rows, key=lambda row: SEVERITY_ORDER[row["severity"]])
646
717
  item = {
647
718
  "findingId": selected["finding_id"],
648
719
  "path": selected["relative_path"],
@@ -653,18 +724,12 @@ def compare_scans(
653
724
  uncertain_reason = next(
654
725
  (
655
726
  uncertain[(side, row["id"])]
656
- for row in current_rows or previous_rows
727
+ for row in selected_rows
657
728
  if (side, row["id"]) in uncertain
658
729
  ),
659
730
  None,
660
731
  )
661
- if previous is None:
662
- if uncertain_reason is None:
663
- status = "new"
664
- else:
665
- status = "unknown"
666
- item["reason"] = uncertain_reason
667
- elif current is not None:
732
+ if previous_rows and current_rows:
668
733
  status = (
669
734
  "reopened"
670
735
  if any(
@@ -679,6 +744,8 @@ def compare_scans(
679
744
  elif uncertain_reason is not None:
680
745
  status = "unknown"
681
746
  item["reason"] = uncertain_reason
747
+ elif current_rows:
748
+ status = "new"
682
749
  elif not all(
683
750
  scan_covers_path(
684
751
  after,
@@ -699,17 +766,17 @@ def compare_scans(
699
766
  status = "not_observed"
700
767
  item["reason"] = "Not observed in the later scan; remediation has not been verified."
701
768
  if len(previous_rows) == 1:
702
- item["beforeOccurrenceId"] = previous["id"]
769
+ item["beforeOccurrenceId"] = previous_rows[0]["id"]
703
770
  elif previous_rows:
704
771
  item["beforeOccurrenceIds"] = [row["id"] for row in previous_rows]
705
772
  if len(current_rows) == 1:
706
- item["afterOccurrenceId"] = current["id"]
773
+ item["afterOccurrenceId"] = current_rows[0]["id"]
707
774
  elif current_rows:
708
775
  item["afterOccurrenceIds"] = [row["id"] for row in current_rows]
709
- if current is not None:
776
+ if current_rows:
710
777
  item["triage"] = {
711
- "closeReason": current["close_reason"],
712
- "status": current["triage_status"],
778
+ "closeReason": selected["close_reason"],
779
+ "status": selected["triage_status"],
713
780
  }
714
781
  item["status"] = status
715
782
  findings.append(item)
@@ -752,10 +819,15 @@ def compare_scans(
752
819
  ],
753
820
  known_scan_ids,
754
821
  )
822
+ inputs = {
823
+ before["id"]: [_matching_input(row) for row in before_findings.values()],
824
+ after["id"]: [_matching_input(row) for row in after_findings.values()],
825
+ }
755
826
  result["matchingCached"] = cached is not None
756
827
  result["matchingInputs"] = {
757
- "before": [_matching_input(row) for row in before_findings.values()],
758
- "after": [_matching_input(row) for row in after_findings.values()],
828
+ "before": inputs[before["id"]],
829
+ "after": inputs[after["id"]],
830
+ **_cross_mode_context(before, after, inputs, {}),
759
831
  **({"knownFindingGroups": known_groups} if known_groups else {}),
760
832
  }
761
833
  return result
@@ -778,8 +850,10 @@ def save_scan_comparison(
778
850
  if not _same_repository(before, after):
779
851
  raise SystemExit("Semantic scan comparisons require the same repository target.")
780
852
  read_coverage(after)
781
- before_findings = _scan_findings(connection, before["id"])
782
- after_findings = _scan_findings(connection, after["id"])
853
+ allowed = {
854
+ "before": set(_scan_findings(connection, before["id"])),
855
+ "after": set(_scan_findings(connection, after["id"])),
856
+ }
783
857
  matches_json = (
784
858
  sys.stdin.read() if getattr(args, "matches_json_stdin", False) else args.matches_json
785
859
  )
@@ -797,10 +871,6 @@ def save_scan_comparison(
797
871
  not isinstance(payload.get(key, []), list) for key in ("matches", "uncertain", "related")
798
872
  ):
799
873
  raise SystemExit("Scan comparison matches must contain matches and uncertain arrays.")
800
- allowed = {
801
- "before": {row["id"] for row in before_findings.values()},
802
- "after": {row["id"] for row in after_findings.values()},
803
- }
804
874
  consumed: dict[str, dict[str, int]] = {"before": {}, "after": {}}
805
875
  for group, match in enumerate(payload["matches"]):
806
876
  if (
@@ -1095,10 +1165,7 @@ def _finding_groups(
1095
1165
  matches: list[dict[str, Any]],
1096
1166
  aliases: dict[str, str],
1097
1167
  ) -> list[tuple[list[sqlite3.Row], list[sqlite3.Row], str | None]]:
1098
- rows = {
1099
- side: {row["id"]: row for row in findings.values()}
1100
- for side, findings in (("before", before_findings), ("after", after_findings))
1101
- }
1168
+ rows = {"before": before_findings, "after": after_findings}
1102
1169
  groups: dict[str, tuple[list[sqlite3.Row], list[sqlite3.Row], list[str]]] = {}
1103
1170
 
1104
1171
  def group(row: sqlite3.Row) -> tuple[list[sqlite3.Row], list[sqlite3.Row], list[str]]:
@@ -1226,25 +1293,19 @@ def finding_occurrence_conditions(
1226
1293
 
1227
1294
 
1228
1295
  def _scan_findings(connection: sqlite3.Connection, scan_id: str) -> dict[str, sqlite3.Row]:
1296
+ """Index one scan's finding rows by the occurrence IDs used in comparisons."""
1229
1297
  rows = connection.execute(
1230
- """
1298
+ f"""
1231
1299
  SELECT occurrences.*,
1232
1300
  COALESCE(triage.status, 'open') AS triage_status, triage.close_reason,
1233
- (
1234
- SELECT locations.relative_path
1235
- FROM finding_locations AS locations
1236
- WHERE locations.occurrence_id = occurrences.id
1237
- ORDER BY CASE WHEN locations.role = 'root_control' THEN 0 ELSE 1 END,
1238
- locations.sort_order
1239
- LIMIT 1
1240
- ) AS relative_path
1301
+ (SELECT relative_path {PRIMARY_FINDING_LOCATION_SQL}) AS relative_path
1241
1302
  FROM finding_occurrences AS occurrences
1242
1303
  LEFT JOIN finding_triage AS triage ON triage.occurrence_id = occurrences.id
1243
1304
  WHERE occurrences.scan_id = ?
1244
1305
  """,
1245
1306
  (scan_id,),
1246
1307
  )
1247
- return {row["finding_id"]: row for row in rows}
1308
+ return {row["id"]: row for row in rows}
1248
1309
 
1249
1310
 
1250
1311
  def scan_covers_path(
@@ -1254,6 +1315,7 @@ def scan_covers_path(
1254
1315
  path: str | None,
1255
1316
  coverage: dict[str, Any],
1256
1317
  ) -> bool:
1318
+ """Check whether a completed scan of this target included the path after applying all recorded exclusions."""
1257
1319
  if scan["status"] != "complete" or scan["target_id"] != target_id:
1258
1320
  return False
1259
1321
  if not isinstance(path, str) or not path:
@@ -19,17 +19,18 @@ from typing import Any
19
19
  sys.path.insert(0, str(Path(__file__).resolve().parent))
20
20
  from filesystem_identity import serialize_filesystem_identity
21
21
  from finalize_scan_contract import write_scan_local_bytes
22
- from workbench.storage import state_dir
22
+ from workbench.storage import create_private_temporary_directory, state_dir
23
23
  from workbench_feedback import get_scan_feedback
24
24
  from workbench_target import (
25
25
  directory_content_digest,
26
26
  git_revision,
27
27
  worktree_content_digest,
28
28
  )
29
- from workbench_validation import optional_text
29
+ from workbench_validation import optional_text, read_json_object
30
30
 
31
31
 
32
32
  def safe_segment(value: str) -> str:
33
+ """Normalize a filename segment, falling back to ``scan`` for an empty result."""
33
34
  segment = re.sub(r"[^\w.-]", "-", value)
34
35
  if segment != value:
35
36
  segment = segment.strip("-")
@@ -37,15 +38,32 @@ def safe_segment(value: str) -> str:
37
38
 
38
39
 
39
40
  def compact_timestamp() -> str:
41
+ """Return the current UTC time in YYYYMMDDTHHMMSSZ format."""
40
42
  return datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
41
43
 
42
44
 
45
+ def loaded_plugin_version() -> str:
46
+ """Read the required version string from the loaded plugin's manifest."""
47
+ manifest = read_json_object(
48
+ Path(__file__).resolve().parents[1] / ".codex-plugin" / "plugin.json"
49
+ )
50
+ version = manifest.get("version")
51
+ if not isinstance(version, str) or not version:
52
+ raise SystemExit("plugin.json: expected a nonempty Codex Security plugin version.")
53
+ return version
54
+
55
+
43
56
  def scan_target_identity(
44
57
  target: Path,
45
58
  diff_target: dict[str, str] | None,
46
59
  *,
47
60
  metadata: os.stat_result | None = None,
48
61
  ) -> tuple[str, str | None, int | str, int | str]:
62
+ """Return revision, content digest, device ID, and inode for scan registration.
63
+
64
+ An explicit diff uses its head revision and a None digest. Other targets use
65
+ the worktree or directory digest. Device and inode use the SQLite-safe representation.
66
+ """
49
67
  if metadata is None:
50
68
  metadata = target.stat()
51
69
  revision = diff_target["headRevision"] if diff_target else git_revision(target)
@@ -67,6 +85,7 @@ def scan_target_identity(
67
85
  def scan_diff_identity(
68
86
  diff_target: dict[str, str] | None,
69
87
  ) -> tuple[str | None, str | None, str | None, str | None]:
88
+ """Return kind, base, head, and optional digest in database order, or four nulls."""
70
89
  if diff_target is None:
71
90
  return (None, None, None, None)
72
91
  return (
@@ -78,6 +97,7 @@ def scan_diff_identity(
78
97
 
79
98
 
80
99
  def stored_diff_target(row: sqlite3.Row) -> dict[str, str] | None:
100
+ """Rebuild the diff target from a scan row, or return None for a full scan."""
81
101
  if not row["diff_target_kind"]:
82
102
  return None
83
103
  target = {
@@ -100,6 +120,7 @@ def archive_scan(
100
120
  *,
101
121
  before_archive: Callable[[], None] | None = None,
102
122
  ) -> Iterator[Path | None]:
123
+ """Yield the archive directory while preparing the original scan path for reuse."""
103
124
  archived_scan_dir = (
104
125
  canonical_directory(Path(args.archived_scan_dir).expanduser())
105
126
  if args.archived_scan_dir is not None
@@ -129,12 +150,12 @@ def archive_scan(
129
150
  if previous_scan is None and not (args.archive_existing and has_contents):
130
151
  yield archived_scan_dir
131
152
  return
132
- artifacts = (
153
+ has_artifacts = (
133
154
  connection.execute(
134
- "SELECT kind, path FROM scan_artifacts WHERE scan_id = ?", (previous_scan["id"],)
135
- ).fetchall()
155
+ "SELECT 1 FROM scan_artifacts WHERE scan_id = ? LIMIT 1", (previous_scan["id"],)
156
+ ).fetchone()
136
157
  if previous_scan is not None
137
- else []
158
+ else None
138
159
  )
139
160
  moved = False
140
161
  try:
@@ -152,7 +173,7 @@ def archive_scan(
152
173
  raise SystemExit(
153
174
  "Cannot archive output containing the workbench state or active database."
154
175
  )
155
- if artifacts and not has_contents:
176
+ if has_artifacts and not has_contents:
156
177
  raise SystemExit(
157
178
  "The archived scan directory is required to preserve existing scan artifacts."
158
179
  )
@@ -189,15 +210,42 @@ def archive_scan(
189
210
  str(scan_dir),
190
211
  ),
191
212
  )
192
- for artifact in artifacts:
193
- try:
194
- relative_path = Path(artifact["path"]).relative_to(scan_dir)
195
- except ValueError:
196
- continue
197
- connection.execute(
198
- "UPDATE scan_artifacts SET path = ? WHERE scan_id = ? AND kind = ?",
199
- (str(archived_scan_dir / relative_path), previous_scan["id"], artifact["kind"]),
200
- )
213
+
214
+ def archive_path(value: str | None) -> str | None:
215
+ if value is None or not Path(value).is_relative_to(scan_dir):
216
+ return value
217
+ return str(archived_scan_dir / Path(value).relative_to(scan_dir))
218
+
219
+ connection.create_function("archive_path", 1, archive_path)
220
+ try:
221
+ for table, columns in (
222
+ ("scan_artifacts", ("path",)),
223
+ ("deep_scan_workers", ("prompt_path", "artifact_dir", "result_manifest_path")),
224
+ (
225
+ "deep_scan_runs",
226
+ (
227
+ "manifest_path",
228
+ "canonical_inventory_path",
229
+ "canonical_finding_report_path",
230
+ "canonical_candidates_path",
231
+ "dedupe_report_path",
232
+ "seed_research_path",
233
+ "work_ledger_path",
234
+ "raw_candidates_path",
235
+ "coverage_ledger_path",
236
+ "findings_dir",
237
+ ),
238
+ ),
239
+ ):
240
+ assignments = ", ".join(
241
+ f"{column} = archive_path({column})" for column in columns
242
+ )
243
+ connection.execute(
244
+ f"UPDATE {table} SET {assignments} WHERE scan_id = ?",
245
+ (previous_scan["id"],),
246
+ )
247
+ finally:
248
+ connection.create_function("archive_path", 1, None)
201
249
  # The caller commits registration before leaving this context. Older SDKs
202
250
  # supplied an already-moved directory; only restore moves we own.
203
251
  yield archived_scan_dir
@@ -239,17 +287,23 @@ def insert_running_scan(
239
287
  model: str | None = None,
240
288
  reasoning_effort: str | None = None,
241
289
  scan_dir: Path | None = None,
290
+ surface: str | None = "plugin",
291
+ package_version: str | None = None,
292
+ launch_kind: str = "scan",
242
293
  ) -> str:
243
294
  revision = target_identity[0]
244
295
  native_scan = scan_dir is None
245
296
  user_context = optional_text(workspace["user_context"])
297
+ try:
298
+ plugin_version = loaded_plugin_version()
299
+ except SystemExit:
300
+ # Missing version attribution must not prevent scan registration.
301
+ plugin_version = None
246
302
  if scan_dir is None:
247
- scan_dir = Path(
248
- tempfile.mkdtemp(
249
- prefix=f"{safe_segment(revision)}_{compact_timestamp()}_",
250
- dir=target_root,
251
- )
252
- ).resolve()
303
+ scan_dir = create_private_temporary_directory(
304
+ target_root,
305
+ prefix=f"{safe_segment(revision)}_{compact_timestamp()}_",
306
+ )
253
307
  connection.execute(
254
308
  """
255
309
  INSERT INTO scans (
@@ -257,9 +311,10 @@ def insert_running_scan(
257
311
  target_device, target_inode, source_scopes_json, scope, mode, user_context,
258
312
  deep_scan_owner_thread_id, diff_target_kind, diff_base_revision,
259
313
  diff_head_revision, diff_content_digest, target_summary, scan_dir, model,
260
- reasoning_effort, status, phase, handoff_status, started_at, created_at, updated_at
314
+ reasoning_effort, status, phase, handoff_status, started_at, created_at, updated_at,
315
+ launch_surface, launch_package_version, launch_plugin_version, launch_kind
261
316
  ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?,
262
- 'running', 'preflight', ?, ?, ?, ?)
317
+ 'running', 'preflight', ?, ?, ?, ?, ?, ?, ?, ?)
263
318
  """,
264
319
  (
265
320
  scan_id,
@@ -281,6 +336,10 @@ def insert_running_scan(
281
336
  timestamp,
282
337
  timestamp,
283
338
  timestamp,
339
+ surface,
340
+ package_version,
341
+ plugin_version,
342
+ launch_kind,
284
343
  ),
285
344
  )
286
345
  connection.execute(