@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
@@ -3,16 +3,36 @@
3
3
  from __future__ import annotations
4
4
 
5
5
  import argparse
6
+ import codecs
7
+ import hashlib
8
+ import io
9
+ import os
10
+ import re
6
11
  import sqlite3
7
12
  import sys
13
+ from collections.abc import Callable
14
+ from contextlib import ExitStack, suppress
8
15
  from datetime import datetime, timedelta, timezone
9
16
  from pathlib import Path
10
- from typing import Any
17
+ from typing import Any, BinaryIO
11
18
 
12
19
  # Some plugin hosts launch Python with safe-path isolation enabled.
13
20
  sys.path.insert(0, str(Path(__file__).resolve().parent))
21
+ from finalize_scan_contract import (
22
+ ContractError,
23
+ MissingScanLocalFileError,
24
+ _open_scan_local_directory,
25
+ _open_verified_scan_directory,
26
+ _read_scan_local_json_bytes,
27
+ _read_sealed_scan,
28
+ scan_local_file_version,
29
+ scan_root_identity,
30
+ stage_scan_local_bytes,
31
+ )
32
+ from posix_scan_local_files import managed_fd
14
33
  from workbench_constants import CLAIM_LEASE_SECONDS, DELIVERED_ACTION_LEASE_SECONDS
15
- from workbench_validation import require_occurrence, require_uuid
34
+ from workbench_target import git_command, git_output
35
+ from workbench_validation import optional_text, require_occurrence, require_uuid
16
36
 
17
37
  COMMANDS = {
18
38
  "request-finding-remediation",
@@ -27,6 +47,7 @@ SCAN_STATUS_ERROR = "Remediation is available only for successfully completed sc
27
47
 
28
48
 
29
49
  def require_available(connection: sqlite3.Connection, args: Any, require_scan: Any) -> None:
50
+ """Require a successfully completed scan for commands that act on a remediation request."""
30
51
  if args.command not in COMMANDS:
31
52
  return
32
53
  occurrence = require_occurrence(connection, args.occurrence_id)
@@ -37,6 +58,7 @@ def require_available(connection: sqlite3.Connection, args: Any, require_scan: A
37
58
  def require_request(
38
59
  connection: sqlite3.Connection, request_id: str, occurrence: sqlite3.Row
39
60
  ) -> sqlite3.Row:
61
+ """Return the request row or raise SystemExit if the request is missing or belongs to a different occurrence."""
40
62
  current = connection.execute(
41
63
  "SELECT * FROM finding_remediation_attempts WHERE request_id = ?",
42
64
  (request_id,),
@@ -46,6 +68,489 @@ def require_request(
46
68
  return current
47
69
 
48
70
 
71
+ def latest_attempt(connection: sqlite3.Connection, occurrence_id: str) -> sqlite3.Row | None:
72
+ """Return the newest remediation attempt for the occurrence, breaking timestamp ties by insertion order."""
73
+ return connection.execute(
74
+ """
75
+ SELECT * FROM finding_remediation_attempts
76
+ WHERE occurrence_id = ?
77
+ ORDER BY created_at DESC, rowid DESC
78
+ LIMIT 1
79
+ """,
80
+ (occurrence_id,),
81
+ ).fetchone()
82
+
83
+
84
+ _HUNK_HEADER = re.compile(rb"@@ -[0-9]+(?:,([0-9]+))? \+[0-9]+(?:,([0-9]+))? @@")
85
+ _QUOTED_GIT_PATH = rb'"((?:[^"\\]|\\(?:[abfnrtv"\\]|[0-3][0-7]{2}))*)"'
86
+ _SUBMODULE_SUMMARY_END = re.compile(
87
+ rb" (?:contains (?:modified|untracked) content|"
88
+ rb"[0-9a-f]+\.{2,3}[0-9a-f]+(?: \([a-z ]+\):?|:))$"
89
+ )
90
+ _SUBMODULE_ERROR = (
91
+ "A remediation patch cannot update Git submodules. Regenerate without gitlink changes."
92
+ )
93
+
94
+
95
+ def _git_path(field: bytes) -> bytes:
96
+ if quoted := re.match(_QUOTED_GIT_PATH + rb"(?:\t|$)", field):
97
+ return codecs.escape_decode(quoted[1])[0]
98
+ return field.partition(b"\t")[0]
99
+
100
+
101
+ def _matches_git_paths(header: bytes, old_field: bytes, new_field: bytes) -> bool:
102
+ old, new = _git_path(old_field), _git_path(new_field)
103
+ # Git strips one component from each path. Unquoted paths can contain
104
+ # spaces, so use the known preimage to locate the separator.
105
+ if quoted := re.match(_QUOTED_GIT_PATH + rb"(?= )", header):
106
+ split = quoted.end()
107
+ elif quoted := re.search(rb" " + _QUOTED_GIT_PATH + rb"$", header):
108
+ split = quoted.start()
109
+ elif old == b"/dev/null" and header.endswith(b" " + new):
110
+ split = len(header) - len(new) - 1
111
+ elif header.count(b" ") == 1:
112
+ split = header.index(b" ")
113
+ else:
114
+ # On a creation Git repeats the destination on the left of the header.
115
+ expected = new if old == b"/dev/null" else old
116
+ prefix, slash, suffix = expected.partition(b"/")
117
+ split = header.find(b"/") + 1 + len(suffix) if slash else len(prefix)
118
+ if split < 0 or header[split : split + 1] != b" ":
119
+ return False
120
+ for path, field in ((header[:split], old), (header[split + 1 :], new)):
121
+ if field != b"/dev/null" and _git_path(path).split(b"/", 1)[-1] != field.split(b"/", 1)[-1]:
122
+ return False
123
+ return True
124
+
125
+
126
+ def _patch_file_sections(patch: bytes, incomplete: str) -> tuple[bytes, int]:
127
+ mail = re.match(rb"From (?:[0-9a-f]{40}|[0-9a-f]{64}) Mon Sep 17 00:00:00 2001\r?\n", patch)
128
+ if mail:
129
+ first = re.search(rb"(?m)^diff --git [^\n]+\n", patch)
130
+ if first:
131
+ start = first.start()
132
+ # A commit message can quote a Git header. Look for format-patch's
133
+ # diffstat before the first hunk, where a deleted "--" can also
134
+ # look like the separator. Each run of indented lines is scanned once.
135
+ hunk = re.compile(rb"(?m)^@@ -").search(patch, start)
136
+ diffstat = re.compile(
137
+ rb"(?m)^---\r?\n(?: [^\n]*\n)+\r?\n(?=diff --git |Submodule )"
138
+ ).search(patch, 0, hunk.start() if hunk else len(patch))
139
+ if diffstat:
140
+ start = diffstat.end()
141
+ else:
142
+ # With --no-stat Git can retain a quoted header as the preimage of
143
+ # the first change. Ignore it only for the same in-place file edit.
144
+ file = re.compile(
145
+ rb"(?m)^diff --git [^\n]+\n(?=index |--- |@@ |old mode|new mode|new file|deleted file"
146
+ rb"|(?:dis)?similarity index|(?:rename|copy) |GIT binary patch|Binary files |Files |Only in )"
147
+ ).search(patch, start)
148
+ if (
149
+ file
150
+ and file[0] == first[0]
151
+ and patch.endswith((b"\n\n", b"\n\r\n"), 0, file.start())
152
+ and re.compile(
153
+ rb"(?:index [0-9a-f]+\.\.[0-9a-f]+ 100(?:644|755)|"
154
+ rb"old mode 100(?:644|755)\r?\nnew mode 100(?:644|755)\r?\n"
155
+ rb"index [0-9a-f]+\.\.[0-9a-f]+)\r?\n(?:--- |GIT binary patch)"
156
+ ).match(patch, file.end())
157
+ ):
158
+ start = file.start()
159
+ elif not patch.endswith((b"\n\n", b"\n\r\n"), 0, start):
160
+ # A leading submodule summary runs directly into the next file header.
161
+ summary = re.compile(rb"(?m)^Submodule ").search(patch, 0, start)
162
+ if summary:
163
+ start = summary.start()
164
+ patch = patch[start:]
165
+
166
+ sections = old_lines = new_lines = 0
167
+ git_paths = b""
168
+ pending_paths = None
169
+ submodule_summary = False
170
+ expect_hunk = False
171
+ stream = io.BytesIO(patch)
172
+ for raw_line in stream:
173
+ line = raw_line.removesuffix(b"\n").removesuffix(b"\r")
174
+ if old_lines or new_lines:
175
+ if line.startswith(b"\\ "): # No newline at end of file
176
+ continue
177
+ prefix = line[:1]
178
+ if prefix in (b"", b" ", b"-"):
179
+ old_lines -= 1
180
+ if prefix in (b"", b" ", b"+"):
181
+ new_lines -= 1
182
+ if prefix not in (b"", b" ", b"+", b"-") or old_lines < 0 or new_lines < 0:
183
+ raise SystemExit(incomplete)
184
+ expect_hunk = True
185
+ continue
186
+ if expect_hunk and line.startswith(b"\\ "): # No newline at end of file
187
+ continue
188
+ hunk = _HUNK_HEADER.match(line)
189
+ if expect_hunk and not hunk and re.match(rb"@@ -(?:[0-9]|$)", line):
190
+ raise SystemExit(incomplete)
191
+ expect_hunk = bool(sections) and line.startswith(b"+++ ")
192
+ if mail and sections and line == b"-- ":
193
+ patch = patch[: stream.tell() - len(raw_line)]
194
+ break
195
+ # Git writes the raw submodule name (possibly including newlines) before the
196
+ # status or object range. Neither log nor inline-diff headers can be replayed.
197
+ if line.startswith(b"Submodule "):
198
+ submodule_summary = True
199
+ if submodule_summary and _SUBMODULE_SUMMARY_END.search(line):
200
+ raise SystemExit(_SUBMODULE_ERROR)
201
+ if pending_paths:
202
+ if line.startswith(b"+++ ") and not _matches_git_paths(*pending_paths, line[4:]):
203
+ sections += 1
204
+ pending_paths = None
205
+ if line.startswith(b"diff --git "):
206
+ sections += 1
207
+ submodule_summary = False
208
+ git_paths = line.removeprefix(b"diff --git ")
209
+ continue
210
+ if line.startswith(b"--- "):
211
+ submodule_summary = False
212
+ # A Git header can introduce the same unified path pair. An
213
+ # unrelated pair starts a separate file even if Git ignores one.
214
+ if git_paths:
215
+ pending_paths = (git_paths, line[4:])
216
+ else:
217
+ sections += 1
218
+ git_paths = b""
219
+ continue
220
+ if git_paths:
221
+ if line.startswith(
222
+ (b"index ", b"old mode ", b"new mode ", b"new file mode ", b"deleted file mode ")
223
+ ):
224
+ if re.search(rb" 0*16[0-7]{4}(?:\s|$)", line):
225
+ raise SystemExit(_SUBMODULE_ERROR)
226
+ if not line.startswith(b"index ") and not re.fullmatch(rb".* [0-7]{6}[ \t]*", line):
227
+ raise SystemExit(incomplete)
228
+ continue
229
+ if line.startswith(
230
+ (
231
+ b"similarity index ",
232
+ b"dissimilarity index ",
233
+ b"rename from ",
234
+ b"rename to ",
235
+ b"copy from ",
236
+ b"copy to ",
237
+ )
238
+ ):
239
+ continue
240
+ git_paths = b""
241
+ if hunk:
242
+ old_lines = int(hunk[1] or b"1")
243
+ new_lines = int(hunk[2] or b"1")
244
+ elif (
245
+ line.startswith((b"Binary files ", b"Files "))
246
+ and line.endswith(b" differ")
247
+ and b" and " in line
248
+ ):
249
+ raise SystemExit(incomplete)
250
+ elif line.startswith(b"Only in ") and b": " in line:
251
+ raise SystemExit(incomplete)
252
+ if old_lines or new_lines:
253
+ raise SystemExit(incomplete)
254
+ return patch, sections
255
+
256
+
257
+ def require_valid_patch(target: Path, patch: bytes) -> None:
258
+ """Reject incomplete patches before recording the submitted bytes."""
259
+ incomplete = (
260
+ "The remediation patch omits file content. Generate a complete binary diff "
261
+ "with Git's --binary option."
262
+ )
263
+ # Git's numstat skips target-relative paths when run below the repository root.
264
+ root = git_output(target, "rev-parse", "--show-toplevel", offline=True)
265
+ directory = ("-C", root) if root else ()
266
+
267
+ def git(data: bytes, *arguments: str):
268
+ result = git_command(
269
+ target,
270
+ *directory,
271
+ *arguments,
272
+ text=False,
273
+ input_data=data,
274
+ environment_overrides={"LC_ALL": "C", "GIT_NO_REPLACE_OBJECTS": "1"},
275
+ offline=True,
276
+ )
277
+ if result.returncode == 127:
278
+ raise SystemExit(
279
+ "Validating a new remediation patch requires a trusted Git executable."
280
+ )
281
+ # Git may report a corrupt trailing binary block but return zero for an earlier file.
282
+ if result.returncode or re.search(rb"(?m)^error: ", result.stderr):
283
+ reason = result.stderr.decode(errors="replace").strip()
284
+ raise SystemExit(f"Could not parse the remediation patch: {reason}")
285
+ return result.stdout
286
+
287
+ # Parse every header and hunk, then skip checkout reads and repository clean filters.
288
+ apply = ("apply", "--no-index", "--whitespace=nowarn")
289
+ body, sections = _patch_file_sections(patch, incomplete)
290
+ git(patch, *apply, "--check", "--exclude=*", "-")
291
+ # Git silently ignores some incomplete sections when another file is valid.
292
+ # NUL termination gives one record per file, even for unusual pathnames.
293
+ if git(patch, *apply, "--numstat", "-z", "-").count(b"\0") != sections:
294
+ raise SystemExit(incomplete)
295
+
296
+ binary_oid_width = None
297
+ for header in re.finditer(
298
+ rb"(?m)^diff --git [^\n]+\n((?:(?!diff )[a-z][^\n]*(?:\n|\Z))*)",
299
+ body,
300
+ ):
301
+ metadata = header.group(1)
302
+ index = re.search(rb"(?m)^index ([^\s.]+)\.\.([^\s.]+)(?: [0-7]+[ \t]*)?\r?$", metadata)
303
+ binary = body.startswith((b"GIT binary patch\n", b"GIT binary patch\r\n"), header.end())
304
+ if not binary:
305
+ if index is None or re.compile(rb"(?:--- [^\n]*\n\+\+\+ [^\n]*\n)?@@ ").match(
306
+ body, header.end()
307
+ ):
308
+ continue
309
+ old, new = index.groups()
310
+ if metadata.startswith(b"deleted file mode ") and not new.strip(b"0"):
311
+ content_id = old
312
+ elif metadata.startswith(b"new file mode ") and not old.strip(b"0"):
313
+ content_id = new
314
+ else:
315
+ # Mode changes and renames can omit hunks only if
316
+ # their advertised blob contents are unchanged.
317
+ old, new = old.lower(), new.lower()
318
+ if not old.startswith(new) and not new.startswith(old):
319
+ raise SystemExit(incomplete)
320
+ continue
321
+ # Only an empty file can be added or deleted without a hunk.
322
+ empty_blobs = (
323
+ hashlib.sha1(b"blob 0\0", usedforsecurity=False).hexdigest().encode(),
324
+ hashlib.sha256(b"blob 0\0").hexdigest().encode(),
325
+ )
326
+ if not any(digest.startswith(content_id.lower()) for digest in empty_blobs):
327
+ raise SystemExit(incomplete)
328
+ continue
329
+ if index is None:
330
+ raise SystemExit("A binary patch requires an index line with full object IDs.")
331
+ old, new = index.groups()
332
+ if binary_oid_width is None:
333
+ binary_oid_width = len(git(b"", "hash-object", "--no-filters", "--stdin").strip())
334
+ if (
335
+ len(old) != binary_oid_width
336
+ or len(new) != binary_oid_width
337
+ or not re.fullmatch(rb"[0-9a-fA-F]+", old + new)
338
+ ):
339
+ raise SystemExit(
340
+ "A binary patch requires full object IDs in the selected target's Git object format."
341
+ )
342
+
343
+
344
+ def patch_metadata(
345
+ current: sqlite3.Row,
346
+ args: argparse.Namespace,
347
+ patch: bytes | None,
348
+ resolve_path: Callable[[str], str],
349
+ ) -> tuple[str | None, str | None]:
350
+ """Resolve a remediation attempt’s patch path and SHA-256 digest.
351
+
352
+ For newly generated bytes, compute the digest and use the existing or
353
+ request-specific path. For a referenced patch, validate the supplied path
354
+ and digest. Raise SystemExit if either conflicts with a previously reviewed value.
355
+ """
356
+ path = args.patch_path
357
+ digest = args.patch_digest
358
+ if patch is not None:
359
+ if args.state != "generated" or path is not None or digest is not None:
360
+ raise SystemExit("Supply patch only for generation, without a patch path or digest.")
361
+ path = current["patch_path"] or (
362
+ f"artifacts/remediation/{current['occurrence_id']}/{current['request_id']}/"
363
+ f"{current['pending_action_claim_token']}.patch"
364
+ )
365
+ digest = f"sha256:{hashlib.sha256(patch).hexdigest()}"
366
+ else:
367
+ if path is not None:
368
+ path = resolve_path(path)
369
+ if digest is not None:
370
+ digest = optional_text(digest, maximum=71)
371
+ if not re.fullmatch(r"sha256:[0-9a-f]{64}", digest or ""):
372
+ raise SystemExit("patch-digest must use sha256:<64 lowercase hex characters>.")
373
+ if path is not None and current["patch_path"] not in (None, path):
374
+ raise SystemExit("A remediation attempt cannot replace its reviewed patch path.")
375
+ if digest is not None and current["patch_digest"] not in (None, digest):
376
+ raise SystemExit("A remediation attempt cannot replace its reviewed patch digest.")
377
+ return path or current["patch_path"], digest or current["patch_digest"]
378
+
379
+
380
+ def same_file_version(
381
+ original: tuple[os.stat_result, int], current: tuple[os.stat_result, int]
382
+ ) -> bool:
383
+ """Compare file identity, size, modification time, and the platform-specific change-time token."""
384
+ before, before_change = original
385
+ after, after_change = current
386
+ return (
387
+ os.path.samestat(before, after)
388
+ and before.st_size == after.st_size
389
+ and before.st_mtime_ns == after.st_mtime_ns
390
+ and before_change == after_change
391
+ )
392
+
393
+
394
+ def file_digest_and_version(source: BinaryIO, label: str) -> tuple[str, tuple[os.stat_result, int]]:
395
+ """Hash the remaining stream bytes and return their digest and file version, raising SystemExit if the file changes."""
396
+ before = scan_local_file_version(source.fileno())
397
+ digest = hashlib.sha256()
398
+ for chunk in iter(lambda: source.read(1024 * 1024), b""):
399
+ digest.update(chunk)
400
+ after = scan_local_file_version(source.fileno())
401
+ if not same_file_version(before, after):
402
+ raise SystemExit(f"The {label} changed while it was being verified.")
403
+ return f"sha256:{digest.hexdigest()}", after
404
+
405
+
406
+ def matching_patch_metadata(source: BinaryIO, expected_digest: str) -> tuple[os.stat_result, int]:
407
+ """Return the stable patch version or raise SystemExit if its bytes differ from expected_digest."""
408
+ digest, version = file_digest_and_version(source, "scan-local patch")
409
+ if digest != expected_digest:
410
+ raise SystemExit("Patch digest does not match the scan-local patch file.")
411
+ return version
412
+
413
+
414
+ def patch_manifest_version(
415
+ db: Any, scan: sqlite3.Row, scan_dir: Path
416
+ ) -> tuple[str, tuple[os.stat_result, int]]:
417
+ """Verify the sealed scan manifest and return its byte digest and file version, including for legacy scans."""
418
+ manifest_path = db.ARTIFACTS["manifest"]
419
+ expected = scan["seal_manifest_digest"]
420
+ if expected is None:
421
+ # Historical manifests can have different JSON formatting. Bind their original bytes.
422
+ saved, raw = _read_scan_local_json_bytes(scan_dir, manifest_path, manifest_path)
423
+ manifest, _, _, _ = _read_sealed_scan(scan_dir, None, "remediation")
424
+ if saved != manifest:
425
+ raise SystemExit("The sealed scan manifest changed during validation.")
426
+ db.verify_manifest_binding(scan, manifest)
427
+ expected = f"sha256:{hashlib.sha256(raw).hexdigest()}"
428
+ with db.open_scan_local_file(scan_dir, manifest_path) as source:
429
+ digest, version = file_digest_and_version(source, "sealed scan manifest")
430
+ if digest != expected:
431
+ raise SystemExit("The sealed scan manifest changed after completion.")
432
+ return digest, version
433
+
434
+
435
+ def save_patch(
436
+ db: Any,
437
+ connection: sqlite3.Connection,
438
+ scan_id: str,
439
+ current: sqlite3.Row,
440
+ path: str,
441
+ digest: str,
442
+ patch: bytes,
443
+ record_update: Callable[[], None],
444
+ ) -> None:
445
+ def admit() -> Path:
446
+ record_update()
447
+ latest = db.require_scan(connection, scan_id)
448
+ directory = db.require_canonical_scan_directory(Path(latest["scan_dir"]))
449
+ if scan_root_identity(directory)[1] != identity:
450
+ raise SystemExit("The scan directory changed after seal validation.")
451
+ with db.open_scan_local_file(directory, db.ARTIFACTS["manifest"]) as named:
452
+ current_version = scan_local_file_version(named.fileno())
453
+ if latest["seal_manifest_digest"] not in (None, manifest_digest) or not same_file_version(
454
+ manifest_version, current_version
455
+ ):
456
+ raise SystemExit("The sealed scan manifest changed after completion.")
457
+ return directory
458
+
459
+ def prepare_saved_patch(directory: Path) -> tuple[os.stat_result, int]:
460
+ with db.open_scan_local_file(directory, path) as named:
461
+ version = matching_patch_metadata(named, digest)
462
+ if os.name == "posix":
463
+ # Persist the file and every directory entry before SQLite commits its path.
464
+ os.fsync(named.fileno())
465
+ with (
466
+ managed_fd(_open_verified_scan_directory(directory, identity)) as root,
467
+ managed_fd(
468
+ _open_scan_local_directory(
469
+ root, Path(path).parts[:-1], create=False, sync_parents=True
470
+ )
471
+ ) as parent,
472
+ ):
473
+ os.fsync(parent)
474
+ return version
475
+
476
+ def verify_name(directory: Path, expected: tuple[os.stat_result, int]) -> None:
477
+ with db.open_scan_local_file(directory, path) as named:
478
+ if not same_file_version(expected, scan_local_file_version(named.fileno())):
479
+ raise SystemExit("The scan-local patch changed during generation.")
480
+ if scan_root_identity(directory)[1] != identity:
481
+ raise SystemExit("The scan directory changed while saving the patch.")
482
+
483
+ existing = current["patch_path"] is not None
484
+ retried_directory = None
485
+ identity = None
486
+ while True:
487
+ scan = db.require_scan(connection, scan_id)
488
+ root_changed_during_validation = False
489
+ with ExitStack() as staging:
490
+ try:
491
+ scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
492
+ if identity is None:
493
+ scan_dir, root_identity = scan_root_identity(scan_dir)
494
+ manifest_digest, manifest_version = patch_manifest_version(db, scan, scan_dir)
495
+ root_changed_during_validation = (
496
+ scan_root_identity(scan_dir)[1] != root_identity
497
+ )
498
+ if root_changed_during_validation:
499
+ raise ContractError("The scan directory changed during seal validation.")
500
+ identity = root_identity
501
+ publish = None
502
+ if not existing:
503
+ with suppress(FileExistsError):
504
+ publish = staging.enter_context(
505
+ stage_scan_local_bytes(
506
+ scan_dir,
507
+ path,
508
+ patch,
509
+ expected_root_identity=identity,
510
+ owner_read_write=True,
511
+ )
512
+ )
513
+ if publish is None:
514
+ metadata = prepare_saved_patch(scan_dir)
515
+ except (ContractError, OSError, SystemExit) as exc:
516
+ # Archiving moves the directory before committing its new location.
517
+ with connection:
518
+ connection.execute("BEGIN IMMEDIATE")
519
+ directory = db.require_scan(connection, scan_id)["scan_dir"]
520
+ if directory == scan["scan_dir"]:
521
+ if directory == retried_directory:
522
+ raise
523
+ # Rollback can restore a missing file or the verified staging root.
524
+ cause: BaseException | None = exc
525
+ while cause and not isinstance(
526
+ cause, (FileNotFoundError, MissingScanLocalFileError)
527
+ ):
528
+ cause = cause.__cause__
529
+ if (
530
+ cause is None
531
+ and not root_changed_during_validation
532
+ and not (
533
+ isinstance(exc, ContractError)
534
+ and identity is not None
535
+ and scan_root_identity(Path(directory))[1] == identity
536
+ )
537
+ ):
538
+ raise
539
+ retried_directory = directory
540
+ continue
541
+ directory = admit()
542
+ if publish is not None:
543
+ with suppress(FileExistsError):
544
+ publish(directory)
545
+ # Keep the token's file, including a competing winner, if cancellation
546
+ # or interruption wins before final admission. Verify it outside SQLite.
547
+ connection.rollback()
548
+ existing = True
549
+ continue
550
+ verify_name(directory, metadata)
551
+ return
552
+
553
+
49
554
  def remediation_claim_is_active(remediation: sqlite3.Row) -> bool:
50
555
  if remediation["pending_action_claim_token"] is None:
51
556
  return False
@@ -173,15 +678,7 @@ def _cancel_generation(
173
678
  connection.execute(
174
679
  "DELETE FROM finding_remediation_attempts WHERE request_id = ?", (request_id,)
175
680
  )
176
- previous = connection.execute(
177
- """
178
- SELECT * FROM finding_remediation_attempts
179
- WHERE occurrence_id = ?
180
- ORDER BY created_at DESC, rowid DESC
181
- LIMIT 1
182
- """,
183
- (occurrence_id,),
184
- ).fetchone()
681
+ previous = latest_attempt(connection, occurrence_id)
185
682
  if previous is None or previous["state"] != "superseded":
186
683
  return
187
684
  restored_state = "applied" if previous["applied_content_digest"] is not None else "generated"