@openai/codex-security 0.8.2 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -8,6 +8,7 @@ import os
8
8
  import sqlite3
9
9
  import sys
10
10
  from collections.abc import Iterable, Iterator
11
+ from functools import cache
11
12
  from itertools import chain
12
13
  from pathlib import Path, PurePosixPath
13
14
  from typing import Any, Callable
@@ -24,7 +25,7 @@ from finalize_scan_contract import (
24
25
  )
25
26
  from report_projection import SEVERITY_ORDER
26
27
  from review_state import review_state
27
- from workbench_constants import ARTIFACTS, FINDINGS_PAGE_MAX
28
+ from workbench_constants import ARTIFACTS, FINDINGS_PAGE_MAX, PRIMARY_FINDING_LOCATION_SQL
28
29
  from workbench_scan_start import scan_target_identity
29
30
  from workbench_scan_usage import stored_scan_cost_fields
30
31
  from workbench_source_scopes import public_scan_recipe
@@ -42,6 +43,7 @@ def rename_scan(connection: sqlite3.Connection, scan: sqlite3.Row, name: str) ->
42
43
 
43
44
 
44
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."""
45
47
  if scan["recipe_json"] is None:
46
48
  raise SystemExit("This scan does not have a saved launch recipe.")
47
49
  return {
@@ -54,6 +56,7 @@ def scan_recipe(scan: sqlite3.Row) -> dict[str, Any]:
54
56
  def preserve_sealed_completion(
55
57
  binding: dict[str, Any], manifest: dict[str, Any] | None
56
58
  ) -> dict[str, Any]:
59
+ """Copy the original timestamps and producer version from a sealed manifest into binding, then return it."""
57
60
  manifest_scan = manifest.get("scan") if manifest is not None else None
58
61
  if isinstance(manifest_scan, dict) and manifest_scan.get("sealedAt") is not None:
59
62
  # Keep the original producer; finalization still validates schema, seal and owner.
@@ -71,6 +74,7 @@ def cli_scan_resume(
71
74
  scan: sqlite3.Row,
72
75
  workspace: sqlite3.Row,
73
76
  ) -> dict[str, Any]:
77
+ scan = scan_with_progress(connection, scan["id"])
74
78
  if scan["mode"] != "deep" or scan["recipe_json"] is None:
75
79
  raise SystemExit("Resume requires a Deep Scan with a saved CLI launch recipe.")
76
80
  if scan["status"] != "running" or scan["canceled_at"] is not None:
@@ -108,15 +112,13 @@ def cli_scan_resume(
108
112
  raise SystemExit("Cannot resume: the original checkout revision or contents changed.")
109
113
  recipe = wb.parse_scan_recipe(scan["recipe_json"], repository)
110
114
  scan_dir = wb.require_canonical_scan_directory(Path(scan["scan_dir"]))
111
- progress = connection.execute(
112
- "SELECT scope_file_count FROM scan_progress WHERE scan_id = ?", (scan["id"],)
113
- ).fetchone()
114
115
  result = {
115
116
  "contract": wb.scan_contract(scan),
117
+ "lifecycle": json.loads(scan["lifecycle_json"]),
116
118
  "recipe": recipe,
117
119
  "scanDir": str(scan_dir),
118
120
  "scanId": scan["id"],
119
- "scopeFileCount": progress["scope_file_count"],
121
+ "scopeFileCount": scan["scope_file_count"],
120
122
  "startedAt": scan["started_at"],
121
123
  "targetId": scan["target_id"],
122
124
  "targetRevision": scan["target_revision"],
@@ -147,6 +149,7 @@ def cli_scan_resume(
147
149
  def coverage_summary_for_history(
148
150
  wb: Any, scan: sqlite3.Row, canonical_scan_directory: Callable[[Path], Path]
149
151
  ) -> dict[str, Any]:
152
+ """Return the coverage mode and path filters for history after verifying the sealed scan data."""
150
153
  scan_dir = canonical_scan_directory(Path(scan["scan_dir"]))
151
154
  coverage_ref = "coverage.json"
152
155
  try:
@@ -215,7 +218,7 @@ def _same_repository(
215
218
  before: sqlite3.Row,
216
219
  after: sqlite3.Row,
217
220
  *,
218
- after_identity: tuple[str | None, tuple[str, str] | None] | None = None,
221
+ after_git: Callable[..., str | None] | None = None,
219
222
  ) -> bool:
220
223
  if before["target_id"] is not None and before["target_id"] == after["target_id"]:
221
224
  return True
@@ -223,28 +226,23 @@ def _same_repository(
223
226
  after_target = Path(after["target_path"])
224
227
  if before_target.resolve() == after_target.resolve():
225
228
  return True
226
- before_git_dir = git_output(
227
- before_target, "rev-parse", "--path-format=absolute", "--git-common-dir"
228
- )
229
- after_git_dir = (
230
- git_output(after_target, "rev-parse", "--path-format=absolute", "--git-common-dir")
231
- if after_identity is None
232
- else after_identity[0]
233
- )
229
+ common_dir = ("rev-parse", "--path-format=absolute", "--git-common-dir")
230
+ after_git = after_git or git_output
231
+ before_git_dir = git_output(before_target, *common_dir)
234
232
  if (
235
233
  before_git_dir is not None
236
- and after_git_dir is not None
234
+ and (after_git_dir := after_git(after_target, *common_dir)) is not None
237
235
  and Path(before_git_dir).resolve() == Path(after_git_dir).resolve()
238
236
  ):
239
237
  return True
240
- before_origin = _repository_origin(before_target)
241
- return before_origin is not None and before_origin == (
242
- _repository_origin(after_target) if after_identity is None else after_identity[1]
238
+ origin = ("remote", "get-url", "origin")
239
+ before_origin = _repository_origin(git_output(before_target, *origin))
240
+ return before_origin is not None and before_origin == _repository_origin(
241
+ after_git(after_target, *origin)
243
242
  )
244
243
 
245
244
 
246
- def _repository_origin(target: Path) -> tuple[str, str] | None:
247
- remote = git_output(target, "remote", "get-url", "origin")
245
+ def _repository_origin(remote: str | None) -> tuple[str, str] | None:
248
246
  if remote is None:
249
247
  return None
250
248
  if "://" in remote:
@@ -272,6 +270,7 @@ def _repository_origin(target: Path) -> tuple[str, str] | None:
272
270
 
273
271
  SCAN_SUMMARY_COLUMNS = """
274
272
  scans.*,
273
+ lifecycle.snapshot AS lifecycle_json,
275
274
  progress.reportable_findings_count,
276
275
  progress.scope_file_count,
277
276
  progress.review_items_completed,
@@ -287,15 +286,36 @@ SCAN_SUMMARY_QUERY = f"""
287
286
  SELECT {SCAN_SUMMARY_COLUMNS}
288
287
  FROM scans
289
288
  JOIN scan_progress AS progress ON progress.scan_id = scans.id
289
+ JOIN scan_lifecycles AS lifecycle ON lifecycle.scan_id = scans.id
290
290
  """
291
291
 
292
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
+
293
311
  def scan_summary(row: sqlite3.Row) -> dict[str, Any]:
294
312
  return {
295
313
  "completedAt": row["completed_at"],
314
+ "logCompletedAt": row["log_completed_at"],
296
315
  "continuationThreadId": row["continuation_thread_id"],
297
316
  **stored_scan_cost_fields(row["cost_json"]),
298
317
  "findingCount": row["finding_count"],
318
+ "lifecycle": json.loads(row["lifecycle_json"]),
299
319
  "handoffStatus": row["handoff_status"],
300
320
  "mode": row["mode"],
301
321
  "model": row["model"],
@@ -352,16 +372,13 @@ def list_scans(
352
372
  """,
353
373
  (str(repository), str(repository)),
354
374
  ).fetchone()
355
- requested_identity = (
356
- git_output(repository, "rev-parse", "--path-format=absolute", "--git-common-dir"),
357
- _repository_origin(repository),
358
- )
375
+ requested_git = cache(git_output)
359
376
  related_target_ids = [
360
377
  target["target_id"]
361
378
  for target in connection.execute(
362
379
  "SELECT id AS target_id, current_path AS target_path FROM security_targets"
363
380
  )
364
- if _same_repository(target, requested_repository, after_identity=requested_identity)
381
+ if _same_repository(target, requested_repository, after_git=requested_git)
365
382
  ]
366
383
  repository_clauses = ["scans.target_path = ?"]
367
384
  values.append(str(repository))
@@ -408,7 +425,7 @@ def list_scans(
408
425
  values.extend((query, query, query, query, query))
409
426
  where = f"WHERE {' AND '.join(clauses)}" if clauses else ""
410
427
  paginated = args is not None and (args.limit is not None or args.offset != 0)
411
- 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
412
429
  pagination = "LIMIT ? OFFSET ?" if paginated else ""
413
430
  if limit is not None:
414
431
  values.extend((limit + 1, args.offset))
@@ -437,6 +454,61 @@ def list_scans(
437
454
  return result
438
455
 
439
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
+
440
512
  def list_unmatched_scan_pairs(
441
513
  connection: sqlite3.Connection,
442
514
  args: argparse.Namespace,
@@ -452,11 +524,15 @@ def list_unmatched_scan_pairs(
452
524
  """,
453
525
  (str(repository), str(repository)),
454
526
  ).fetchone()
455
- selected = [
456
- scan
457
- for scan in connection.execute("SELECT * FROM scans WHERE status = 'complete'")
458
- if _same_repository(scan, requested)
459
- ]
527
+ selected = []
528
+ requested_git = cache(git_output)
529
+ membership: dict[tuple[str | None, str], bool] = {}
530
+ for scan in connection.execute("SELECT * FROM scans WHERE status = 'complete'"):
531
+ target = (scan["target_id"], scan["target_path"])
532
+ if target not in membership:
533
+ membership[target] = _same_repository(scan, requested, after_git=requested_git)
534
+ if membership[target]:
535
+ selected.append(scan)
460
536
 
461
537
  selected.sort(key=lambda scan: (timestamp_key(scan["started_at"]), scan["id"]))
462
538
 
@@ -475,6 +551,7 @@ def list_unmatched_scan_pairs(
475
551
  batches = []
476
552
  skipped = 0
477
553
  matching_findings: dict[str, list[dict[str, Any]]] = {}
554
+ sites: dict[str, _FindingSites] = {}
478
555
  known_links: list[sqlite3.Row] | None = None
479
556
  for index, (selected_index, after) in enumerate(available):
480
557
  previous = [
@@ -507,6 +584,7 @@ def list_unmatched_scan_pairs(
507
584
  "afterScanId": after["id"],
508
585
  "beforeScans": [
509
586
  {
587
+ **_cross_mode_context(before, after, matching_findings, sites),
510
588
  "findings": matching_findings[before["id"]],
511
589
  "scanId": before["id"],
512
590
  }
@@ -581,6 +659,7 @@ def compare_scans(
581
659
  include_matching_inputs: bool = False,
582
660
  require_matches: bool = False,
583
661
  ) -> dict[str, Any]:
662
+ """Compare completed scans of the same repository, returning finding groups and any inputs needed for matching."""
584
663
  before = require_scan(connection, args.before_scan_id)
585
664
  after = require_scan(connection, args.after_scan_id)
586
665
  if before["id"] == after["id"]:
@@ -614,9 +693,7 @@ def compare_scans(
614
693
  after_findings = _scan_findings(connection, after["id"])
615
694
  matches = json.loads(cached["result_json"]) if cached is not None else None
616
695
  saved_matches = matches["matches"] if matches is not None else []
617
- occurrences = {
618
- row["id"]: row for row in chain(before_findings.values(), after_findings.values())
619
- }
696
+ occurrences = before_findings | after_findings
620
697
  aliases = _confirmed_finding_aliases(connection, occurrences)
621
698
  groups = _finding_groups(before_findings, after_findings, saved_matches, aliases)
622
699
  uncertain = (
@@ -635,17 +712,8 @@ def compare_scans(
635
712
  }
636
713
 
637
714
  for previous_rows, current_rows, match_reason in groups:
638
- previous = (
639
- min(previous_rows, key=lambda row: SEVERITY_ORDER[row["severity"]])
640
- if previous_rows
641
- else None
642
- )
643
- current = (
644
- min(current_rows, key=lambda row: SEVERITY_ORDER[row["severity"]])
645
- if current_rows
646
- else None
647
- )
648
- 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"]])
649
717
  item = {
650
718
  "findingId": selected["finding_id"],
651
719
  "path": selected["relative_path"],
@@ -656,18 +724,12 @@ def compare_scans(
656
724
  uncertain_reason = next(
657
725
  (
658
726
  uncertain[(side, row["id"])]
659
- for row in current_rows or previous_rows
727
+ for row in selected_rows
660
728
  if (side, row["id"]) in uncertain
661
729
  ),
662
730
  None,
663
731
  )
664
- if previous is None:
665
- if uncertain_reason is None:
666
- status = "new"
667
- else:
668
- status = "unknown"
669
- item["reason"] = uncertain_reason
670
- elif current is not None:
732
+ if previous_rows and current_rows:
671
733
  status = (
672
734
  "reopened"
673
735
  if any(
@@ -682,6 +744,8 @@ def compare_scans(
682
744
  elif uncertain_reason is not None:
683
745
  status = "unknown"
684
746
  item["reason"] = uncertain_reason
747
+ elif current_rows:
748
+ status = "new"
685
749
  elif not all(
686
750
  scan_covers_path(
687
751
  after,
@@ -702,17 +766,17 @@ def compare_scans(
702
766
  status = "not_observed"
703
767
  item["reason"] = "Not observed in the later scan; remediation has not been verified."
704
768
  if len(previous_rows) == 1:
705
- item["beforeOccurrenceId"] = previous["id"]
769
+ item["beforeOccurrenceId"] = previous_rows[0]["id"]
706
770
  elif previous_rows:
707
771
  item["beforeOccurrenceIds"] = [row["id"] for row in previous_rows]
708
772
  if len(current_rows) == 1:
709
- item["afterOccurrenceId"] = current["id"]
773
+ item["afterOccurrenceId"] = current_rows[0]["id"]
710
774
  elif current_rows:
711
775
  item["afterOccurrenceIds"] = [row["id"] for row in current_rows]
712
- if current is not None:
776
+ if current_rows:
713
777
  item["triage"] = {
714
- "closeReason": current["close_reason"],
715
- "status": current["triage_status"],
778
+ "closeReason": selected["close_reason"],
779
+ "status": selected["triage_status"],
716
780
  }
717
781
  item["status"] = status
718
782
  findings.append(item)
@@ -755,10 +819,15 @@ def compare_scans(
755
819
  ],
756
820
  known_scan_ids,
757
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
+ }
758
826
  result["matchingCached"] = cached is not None
759
827
  result["matchingInputs"] = {
760
- "before": [_matching_input(row) for row in before_findings.values()],
761
- "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, {}),
762
831
  **({"knownFindingGroups": known_groups} if known_groups else {}),
763
832
  }
764
833
  return result
@@ -781,8 +850,10 @@ def save_scan_comparison(
781
850
  if not _same_repository(before, after):
782
851
  raise SystemExit("Semantic scan comparisons require the same repository target.")
783
852
  read_coverage(after)
784
- before_findings = _scan_findings(connection, before["id"])
785
- 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
+ }
786
857
  matches_json = (
787
858
  sys.stdin.read() if getattr(args, "matches_json_stdin", False) else args.matches_json
788
859
  )
@@ -800,10 +871,6 @@ def save_scan_comparison(
800
871
  not isinstance(payload.get(key, []), list) for key in ("matches", "uncertain", "related")
801
872
  ):
802
873
  raise SystemExit("Scan comparison matches must contain matches and uncertain arrays.")
803
- allowed = {
804
- "before": {row["id"] for row in before_findings.values()},
805
- "after": {row["id"] for row in after_findings.values()},
806
- }
807
874
  consumed: dict[str, dict[str, int]] = {"before": {}, "after": {}}
808
875
  for group, match in enumerate(payload["matches"]):
809
876
  if (
@@ -1098,10 +1165,7 @@ def _finding_groups(
1098
1165
  matches: list[dict[str, Any]],
1099
1166
  aliases: dict[str, str],
1100
1167
  ) -> list[tuple[list[sqlite3.Row], list[sqlite3.Row], str | None]]:
1101
- rows = {
1102
- side: {row["id"]: row for row in findings.values()}
1103
- for side, findings in (("before", before_findings), ("after", after_findings))
1104
- }
1168
+ rows = {"before": before_findings, "after": after_findings}
1105
1169
  groups: dict[str, tuple[list[sqlite3.Row], list[sqlite3.Row], list[str]]] = {}
1106
1170
 
1107
1171
  def group(row: sqlite3.Row) -> tuple[list[sqlite3.Row], list[sqlite3.Row], list[str]]:
@@ -1229,25 +1293,19 @@ def finding_occurrence_conditions(
1229
1293
 
1230
1294
 
1231
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."""
1232
1297
  rows = connection.execute(
1233
- """
1298
+ f"""
1234
1299
  SELECT occurrences.*,
1235
1300
  COALESCE(triage.status, 'open') AS triage_status, triage.close_reason,
1236
- (
1237
- SELECT locations.relative_path
1238
- FROM finding_locations AS locations
1239
- WHERE locations.occurrence_id = occurrences.id
1240
- ORDER BY CASE WHEN locations.role = 'root_control' THEN 0 ELSE 1 END,
1241
- locations.sort_order
1242
- LIMIT 1
1243
- ) AS relative_path
1301
+ (SELECT relative_path {PRIMARY_FINDING_LOCATION_SQL}) AS relative_path
1244
1302
  FROM finding_occurrences AS occurrences
1245
1303
  LEFT JOIN finding_triage AS triage ON triage.occurrence_id = occurrences.id
1246
1304
  WHERE occurrences.scan_id = ?
1247
1305
  """,
1248
1306
  (scan_id,),
1249
1307
  )
1250
- return {row["finding_id"]: row for row in rows}
1308
+ return {row["id"]: row for row in rows}
1251
1309
 
1252
1310
 
1253
1311
  def scan_covers_path(
@@ -1257,6 +1315,7 @@ def scan_covers_path(
1257
1315
  path: str | None,
1258
1316
  coverage: dict[str, Any],
1259
1317
  ) -> bool:
1318
+ """Check whether a completed scan of this target included the path after applying all recorded exclusions."""
1260
1319
  if scan["status"] != "complete" or scan["target_id"] != target_id:
1261
1320
  return False
1262
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
@@ -233,23 +281,29 @@ def insert_running_scan(
233
281
  source_scopes: dict[str, Any],
234
282
  target_root: Path,
235
283
  target_summary: str | None,
236
- scope_file_count: int,
284
+ scope_file_count: int | None,
237
285
  timestamp: str,
238
286
  handoff_status: str = "pending",
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(