@openai/codex-security 0.8.3 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (658) hide show
  1. package/README.md +36 -746
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +7 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/baseline-auditor.md +18 -0
  26. package/_bundled_plugin/references/core-scan.md +5 -42
  27. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  28. package/_bundled_plugin/references/final-report.md +5 -3
  29. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  30. package/_bundled_plugin/references/focused-investigator.md +13 -0
  31. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  32. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  33. package/_bundled_plugin/references/scan-contract.md +27 -33
  34. package/_bundled_plugin/references/scan-prologue.md +2 -2
  35. package/_bundled_plugin/references/scan-runtime.md +4 -2
  36. package/_bundled_plugin/references/security-guidance.md +14 -1
  37. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  38. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  39. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  40. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  41. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  42. package/_bundled_plugin/scripts/deep_scan_workbench.py +192 -352
  43. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  44. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  45. package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
  46. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  47. package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
  48. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  49. package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
  50. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  51. package/_bundled_plugin/scripts/report_projection.py +81 -43
  52. package/_bundled_plugin/scripts/review_state.py +8 -2
  53. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  54. package/_bundled_plugin/scripts/snapshot_sqlite.py +9 -2
  55. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  56. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  57. package/_bundled_plugin/scripts/windows_scan_local_files.py +582 -20
  58. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  59. package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
  60. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  61. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  62. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  63. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  64. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  65. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  66. package/_bundled_plugin/scripts/workbench/storage.py +91 -7
  67. package/_bundled_plugin/scripts/workbench_cli.py +54 -14
  68. package/_bundled_plugin/scripts/workbench_constants.py +12 -0
  69. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  70. package/_bundled_plugin/scripts/workbench_db.py +562 -303
  71. package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +238 -41
  75. package/_bundled_plugin/scripts/workbench_progress.py +169 -4
  76. package/_bundled_plugin/scripts/workbench_publication.py +16 -13
  77. package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
  82. package/_bundled_plugin/scripts/workbench_schema.py +258 -63
  83. package/_bundled_plugin/scripts/workbench_setup.py +14 -2
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  85. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  86. package/_bundled_plugin/scripts/workbench_target.py +594 -136
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
  88. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
  90. package/_bundled_plugin/shared/workbench-migrations.json +100 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  93. package/_bundled_plugin/skills/fix-finding/SKILL.md +2 -1
  94. package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
  95. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  96. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  97. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  98. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +409 -0
  99. package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
  100. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  104. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  105. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  106. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  107. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  108. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  110. package/bin/codex-security.mjs +2 -2
  111. package/dist/api.d.ts +45 -5
  112. package/dist/api.d.ts.map +1 -1
  113. package/dist/api.js +1192 -427
  114. package/dist/api.js.map +1 -1
  115. package/dist/armorcode-findings.d.ts +9 -0
  116. package/dist/armorcode-findings.d.ts.map +1 -0
  117. package/dist/armorcode-findings.js +145 -0
  118. package/dist/armorcode-findings.js.map +1 -0
  119. package/dist/artifact-export.d.ts +2 -0
  120. package/dist/artifact-export.d.ts.map +1 -1
  121. package/dist/artifact-export.js +29 -13
  122. package/dist/artifact-export.js.map +1 -1
  123. package/dist/auth.d.ts +6 -2
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +37 -18
  126. package/dist/auth.js.map +1 -1
  127. package/dist/batch-cost.d.ts +18 -0
  128. package/dist/batch-cost.d.ts.map +1 -0
  129. package/dist/batch-cost.js +41 -0
  130. package/dist/batch-cost.js.map +1 -0
  131. package/dist/bedrock-oss-pricing.d.ts +6 -0
  132. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  133. package/dist/bedrock-oss-pricing.js +58 -0
  134. package/dist/bedrock-oss-pricing.js.map +1 -0
  135. package/dist/bedrock-pricing.d.ts +15 -0
  136. package/dist/bedrock-pricing.d.ts.map +1 -0
  137. package/dist/bedrock-pricing.js +117 -0
  138. package/dist/bedrock-pricing.js.map +1 -0
  139. package/dist/blackduck-findings.d.ts +1 -1
  140. package/dist/blackduck-findings.d.ts.map +1 -1
  141. package/dist/blackduck-findings.js +24 -22
  142. package/dist/blackduck-findings.js.map +1 -1
  143. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  144. package/dist/bulk-scan-discovery.js +4 -4
  145. package/dist/bulk-scan-discovery.js.map +1 -1
  146. package/dist/bundled-plugin.d.ts +4 -0
  147. package/dist/bundled-plugin.d.ts.map +1 -0
  148. package/dist/bundled-plugin.js +23 -0
  149. package/dist/bundled-plugin.js.map +1 -0
  150. package/dist/checkmarx-evidence.d.ts +19 -0
  151. package/dist/checkmarx-evidence.d.ts.map +1 -0
  152. package/dist/checkmarx-evidence.js +36 -0
  153. package/dist/checkmarx-evidence.js.map +1 -0
  154. package/dist/checkmarx-findings.d.ts +4 -0
  155. package/dist/checkmarx-findings.d.ts.map +1 -0
  156. package/dist/checkmarx-findings.js +27 -0
  157. package/dist/checkmarx-findings.js.map +1 -0
  158. package/dist/checkmarx-one.d.ts +4 -0
  159. package/dist/checkmarx-one.d.ts.map +1 -0
  160. package/dist/checkmarx-one.js +53 -0
  161. package/dist/checkmarx-one.js.map +1 -0
  162. package/dist/checkmarx-repository.d.ts +12 -0
  163. package/dist/checkmarx-repository.d.ts.map +1 -0
  164. package/dist/checkmarx-repository.js +181 -0
  165. package/dist/checkmarx-repository.js.map +1 -0
  166. package/dist/checkmarx-xml.d.ts +12 -0
  167. package/dist/checkmarx-xml.d.ts.map +1 -0
  168. package/dist/checkmarx-xml.js +196 -0
  169. package/dist/checkmarx-xml.js.map +1 -0
  170. package/dist/classify-scan-severity.d.ts +1 -1
  171. package/dist/classify-scan-severity.d.ts.map +1 -1
  172. package/dist/classify-scan-severity.js +11 -3
  173. package/dist/classify-scan-severity.js.map +1 -1
  174. package/dist/classify-severity-records.d.ts +1 -9
  175. package/dist/classify-severity-records.d.ts.map +1 -1
  176. package/dist/classify-severity-records.js +3 -13
  177. package/dist/classify-severity-records.js.map +1 -1
  178. package/dist/classify-severity.d.ts.map +1 -1
  179. package/dist/classify-severity.js +11 -10
  180. package/dist/classify-severity.js.map +1 -1
  181. package/dist/cli-argument.d.ts +4 -0
  182. package/dist/cli-argument.d.ts.map +1 -0
  183. package/dist/cli-argument.js +17 -0
  184. package/dist/cli-argument.js.map +1 -0
  185. package/dist/cli-help.d.ts +1 -1
  186. package/dist/cli-help.d.ts.map +1 -1
  187. package/dist/cli-help.js +71 -29
  188. package/dist/cli-help.js.map +1 -1
  189. package/dist/cli-hook.d.ts +3 -0
  190. package/dist/cli-hook.d.ts.map +1 -0
  191. package/dist/cli-hook.js +87 -0
  192. package/dist/cli-hook.js.map +1 -0
  193. package/dist/cli-integrations.d.ts +13 -0
  194. package/dist/cli-integrations.d.ts.map +1 -0
  195. package/dist/cli-integrations.js +333 -0
  196. package/dist/cli-integrations.js.map +1 -0
  197. package/dist/cli-mcp.d.ts +15 -0
  198. package/dist/cli-mcp.d.ts.map +1 -0
  199. package/dist/cli-mcp.js +178 -0
  200. package/dist/cli-mcp.js.map +1 -0
  201. package/dist/cli-token-view.d.ts +10 -0
  202. package/dist/cli-token-view.d.ts.map +1 -0
  203. package/dist/cli-token-view.js +41 -0
  204. package/dist/cli-token-view.js.map +1 -0
  205. package/dist/cli.d.ts +16 -8
  206. package/dist/cli.d.ts.map +1 -1
  207. package/dist/cli.js +3382 -2017
  208. package/dist/cli.js.map +1 -1
  209. package/dist/cloud-publish.d.ts.map +1 -1
  210. package/dist/cloud-publish.js +35 -33
  211. package/dist/cloud-publish.js.map +1 -1
  212. package/dist/codex-sdk-environment.d.ts +6 -0
  213. package/dist/codex-sdk-environment.d.ts.map +1 -1
  214. package/dist/codex-sdk-environment.js +19 -0
  215. package/dist/codex-sdk-environment.js.map +1 -1
  216. package/dist/command-words.d.ts +3 -0
  217. package/dist/command-words.d.ts.map +1 -0
  218. package/dist/command-words.js +46 -0
  219. package/dist/command-words.js.map +1 -0
  220. package/dist/component-scan.d.ts +19 -4
  221. package/dist/component-scan.d.ts.map +1 -1
  222. package/dist/component-scan.js +67 -9
  223. package/dist/component-scan.js.map +1 -1
  224. package/dist/config.d.ts +1 -1
  225. package/dist/config.d.ts.map +1 -1
  226. package/dist/config.js +130 -67
  227. package/dist/config.js.map +1 -1
  228. package/dist/continuum-findings.d.ts +1 -1
  229. package/dist/continuum-findings.d.ts.map +1 -1
  230. package/dist/continuum-findings.js +149 -19
  231. package/dist/continuum-findings.js.map +1 -1
  232. package/dist/contract-values.d.ts +2 -0
  233. package/dist/contract-values.d.ts.map +1 -1
  234. package/dist/contract-values.js +12 -9
  235. package/dist/contract-values.js.map +1 -1
  236. package/dist/cost-model.d.ts +13 -1
  237. package/dist/cost-model.d.ts.map +1 -1
  238. package/dist/cost-model.js +66 -112
  239. package/dist/cost-model.js.map +1 -1
  240. package/dist/cost.d.ts +42 -3
  241. package/dist/cost.d.ts.map +1 -1
  242. package/dist/cost.js +484 -149
  243. package/dist/cost.js.map +1 -1
  244. package/dist/custom-publish.d.ts +4 -0
  245. package/dist/custom-publish.d.ts.map +1 -1
  246. package/dist/custom-publish.js +40 -3
  247. package/dist/custom-publish.js.map +1 -1
  248. package/dist/custom-validation-prompt.d.ts +1 -1
  249. package/dist/custom-validation-prompt.d.ts.map +1 -1
  250. package/dist/custom-validation-prompt.js +29 -19
  251. package/dist/custom-validation-prompt.js.map +1 -1
  252. package/dist/deduplication/local.d.ts +4 -2
  253. package/dist/deduplication/local.d.ts.map +1 -1
  254. package/dist/deduplication/local.js +9 -2
  255. package/dist/deduplication/local.js.map +1 -1
  256. package/dist/deduplication/refusal.d.ts.map +1 -1
  257. package/dist/deduplication/refusal.js +26 -5
  258. package/dist/deduplication/refusal.js.map +1 -1
  259. package/dist/deduplication/scan.d.ts +5 -0
  260. package/dist/deduplication/scan.d.ts.map +1 -1
  261. package/dist/deduplication/scan.js +24 -7
  262. package/dist/deduplication/scan.js.map +1 -1
  263. package/dist/deep-config.d.ts +0 -1
  264. package/dist/deep-config.d.ts.map +1 -1
  265. package/dist/deep-config.js +22 -33
  266. package/dist/deep-config.js.map +1 -1
  267. package/dist/deep-scan-defaults.d.ts +2 -0
  268. package/dist/deep-scan-defaults.d.ts.map +1 -1
  269. package/dist/deep-scan-defaults.js +28 -1
  270. package/dist/deep-scan-defaults.js.map +1 -1
  271. package/dist/deep-scan.d.ts +2 -0
  272. package/dist/deep-scan.d.ts.map +1 -1
  273. package/dist/deep-scan.js +44 -19
  274. package/dist/deep-scan.js.map +1 -1
  275. package/dist/default-severity-rubric.d.ts +1 -1
  276. package/dist/default-severity-rubric.d.ts.map +1 -1
  277. package/dist/default-severity-rubric.js +1 -1
  278. package/dist/default-severity-rubric.js.map +1 -1
  279. package/dist/endor-findings.d.ts +3 -1
  280. package/dist/endor-findings.d.ts.map +1 -1
  281. package/dist/endor-findings.js +86 -45
  282. package/dist/endor-findings.js.map +1 -1
  283. package/dist/errors.d.ts +4 -2
  284. package/dist/errors.d.ts.map +1 -1
  285. package/dist/errors.js +15 -4
  286. package/dist/errors.js.map +1 -1
  287. package/dist/executable-path.d.ts +3 -0
  288. package/dist/executable-path.d.ts.map +1 -1
  289. package/dist/executable-path.js +26 -0
  290. package/dist/executable-path.js.map +1 -1
  291. package/dist/external-findings-import.d.ts +5 -3
  292. package/dist/external-findings-import.d.ts.map +1 -1
  293. package/dist/external-findings-import.js +19 -7
  294. package/dist/external-findings-import.js.map +1 -1
  295. package/dist/external-findings-local.d.ts +69 -5
  296. package/dist/external-findings-local.d.ts.map +1 -1
  297. package/dist/external-findings-local.js +537 -108
  298. package/dist/external-findings-local.js.map +1 -1
  299. package/dist/external-findings-publish.d.ts +13 -6
  300. package/dist/external-findings-publish.d.ts.map +1 -1
  301. package/dist/external-findings-publish.js +895 -1142
  302. package/dist/external-findings-publish.js.map +1 -1
  303. package/dist/external-findings-read.d.ts +21 -2
  304. package/dist/external-findings-read.d.ts.map +1 -1
  305. package/dist/external-findings-read.js +130 -68
  306. package/dist/external-findings-read.js.map +1 -1
  307. package/dist/external-findings.d.ts +15 -3
  308. package/dist/external-findings.d.ts.map +1 -1
  309. package/dist/external-findings.js +54 -2
  310. package/dist/external-findings.js.map +1 -1
  311. package/dist/external-import-contract.d.ts +8 -12
  312. package/dist/external-import-contract.d.ts.map +1 -1
  313. package/dist/external-import-contract.js +51 -184
  314. package/dist/external-import-contract.js.map +1 -1
  315. package/dist/external-import-models.d.ts +1 -1
  316. package/dist/external-import-models.d.ts.map +1 -1
  317. package/dist/external-import-models.js.map +1 -1
  318. package/dist/feedback.d.ts.map +1 -1
  319. package/dist/feedback.js +5 -4
  320. package/dist/feedback.js.map +1 -1
  321. package/dist/finding-prompt.d.ts +5 -0
  322. package/dist/finding-prompt.d.ts.map +1 -0
  323. package/dist/finding-prompt.js +32 -0
  324. package/dist/finding-prompt.js.map +1 -0
  325. package/dist/findings-client.d.ts +1 -0
  326. package/dist/findings-client.d.ts.map +1 -1
  327. package/dist/findings-client.js +27 -3
  328. package/dist/findings-client.js.map +1 -1
  329. package/dist/github-advisories.d.ts.map +1 -1
  330. package/dist/github-advisories.js +0 -2
  331. package/dist/github-advisories.js.map +1 -1
  332. package/dist/github-dependabot-findings.d.ts.map +1 -1
  333. package/dist/github-dependabot-findings.js +18 -8
  334. package/dist/github-dependabot-findings.js.map +1 -1
  335. package/dist/github-findings.d.ts +4 -1
  336. package/dist/github-findings.d.ts.map +1 -1
  337. package/dist/github-findings.js +73 -316
  338. package/dist/github-findings.js.map +1 -1
  339. package/dist/hosted-git-remotes.d.ts +5 -0
  340. package/dist/hosted-git-remotes.d.ts.map +1 -0
  341. package/dist/hosted-git-remotes.js +285 -0
  342. package/dist/hosted-git-remotes.js.map +1 -0
  343. package/dist/hosted-git-repository.d.ts +28 -0
  344. package/dist/hosted-git-repository.d.ts.map +1 -0
  345. package/dist/hosted-git-repository.js +222 -0
  346. package/dist/hosted-git-repository.js.map +1 -0
  347. package/dist/hosted-remediation.d.ts +1 -0
  348. package/dist/hosted-remediation.d.ts.map +1 -1
  349. package/dist/hosted-remediation.js +23 -3
  350. package/dist/hosted-remediation.js.map +1 -1
  351. package/dist/hosted-scan-protocol.js +2 -2
  352. package/dist/hosted-scan-protocol.js.map +1 -1
  353. package/dist/hosted-scan.d.ts.map +1 -1
  354. package/dist/hosted-scan.js +16 -11
  355. package/dist/hosted-scan.js.map +1 -1
  356. package/dist/hosted-scanner-http.d.ts +21 -0
  357. package/dist/hosted-scanner-http.d.ts.map +1 -0
  358. package/dist/hosted-scanner-http.js +204 -0
  359. package/dist/hosted-scanner-http.js.map +1 -0
  360. package/dist/import-scan.d.ts.map +1 -1
  361. package/dist/import-scan.js +3 -0
  362. package/dist/import-scan.js.map +1 -1
  363. package/dist/index.d.ts +21 -9
  364. package/dist/index.d.ts.map +1 -1
  365. package/dist/index.js +12 -3
  366. package/dist/index.js.map +1 -1
  367. package/dist/inspector-findings.d.ts.map +1 -1
  368. package/dist/inspector-findings.js +52 -86
  369. package/dist/inspector-findings.js.map +1 -1
  370. package/dist/knowledge-base.d.ts +1 -1
  371. package/dist/knowledge-base.d.ts.map +1 -1
  372. package/dist/knowledge-base.js +102 -32
  373. package/dist/knowledge-base.js.map +1 -1
  374. package/dist/linear.d.ts +11 -0
  375. package/dist/linear.d.ts.map +1 -1
  376. package/dist/linear.js.map +1 -1
  377. package/dist/local-git-metadata.d.ts +5 -2
  378. package/dist/local-git-metadata.d.ts.map +1 -1
  379. package/dist/local-git-metadata.js +8 -5
  380. package/dist/local-git-metadata.js.map +1 -1
  381. package/dist/multiscan.d.ts +10 -4
  382. package/dist/multiscan.d.ts.map +1 -1
  383. package/dist/multiscan.js +217 -102
  384. package/dist/multiscan.js.map +1 -1
  385. package/dist/native-json-findings.d.ts +2 -1
  386. package/dist/native-json-findings.d.ts.map +1 -1
  387. package/dist/native-json-findings.js +12 -2
  388. package/dist/native-json-findings.js.map +1 -1
  389. package/dist/opengrep-findings.d.ts +5 -2
  390. package/dist/opengrep-findings.d.ts.map +1 -1
  391. package/dist/opengrep-findings.js +54 -33
  392. package/dist/opengrep-findings.js.map +1 -1
  393. package/dist/operation-telemetry.d.ts +104 -0
  394. package/dist/operation-telemetry.d.ts.map +1 -0
  395. package/dist/operation-telemetry.js +293 -0
  396. package/dist/operation-telemetry.js.map +1 -0
  397. package/dist/plugin-python-probe.d.ts +4 -0
  398. package/dist/plugin-python-probe.d.ts.map +1 -0
  399. package/dist/plugin-python-probe.js +10 -0
  400. package/dist/plugin-python-probe.js.map +1 -0
  401. package/dist/private-finding-import.d.ts +99 -9
  402. package/dist/private-finding-import.d.ts.map +1 -1
  403. package/dist/private-finding-import.js +116 -152
  404. package/dist/private-finding-import.js.map +1 -1
  405. package/dist/project-config.d.ts.map +1 -1
  406. package/dist/project-config.js +53 -13
  407. package/dist/project-config.js.map +1 -1
  408. package/dist/prompt-files.d.ts +7 -2
  409. package/dist/prompt-files.d.ts.map +1 -1
  410. package/dist/prompt-files.js +42 -20
  411. package/dist/prompt-files.js.map +1 -1
  412. package/dist/provider-profile.d.ts +1 -1
  413. package/dist/provider-profile.d.ts.map +1 -1
  414. package/dist/provider-profile.js +12 -10
  415. package/dist/provider-profile.js.map +1 -1
  416. package/dist/publication-telemetry.d.ts +45 -0
  417. package/dist/publication-telemetry.d.ts.map +1 -0
  418. package/dist/publication-telemetry.js +50 -0
  419. package/dist/publication-telemetry.js.map +1 -0
  420. package/dist/publication.d.ts +1 -1
  421. package/dist/publication.d.ts.map +1 -1
  422. package/dist/publication.js.map +1 -1
  423. package/dist/publish.d.ts +4 -0
  424. package/dist/publish.d.ts.map +1 -1
  425. package/dist/publish.js +42 -2
  426. package/dist/publish.js.map +1 -1
  427. package/dist/record.d.ts +1 -5
  428. package/dist/record.d.ts.map +1 -1
  429. package/dist/record.js +3 -51
  430. package/dist/record.js.map +1 -1
  431. package/dist/remediation.d.ts +1 -4
  432. package/dist/remediation.d.ts.map +1 -1
  433. package/dist/remediation.js +6 -8
  434. package/dist/remediation.js.map +1 -1
  435. package/dist/request-metadata.d.ts +3 -0
  436. package/dist/request-metadata.d.ts.map +1 -1
  437. package/dist/request-metadata.js +9 -0
  438. package/dist/request-metadata.js.map +1 -1
  439. package/dist/result.d.ts +4 -0
  440. package/dist/result.d.ts.map +1 -1
  441. package/dist/result.js +1 -1
  442. package/dist/result.js.map +1 -1
  443. package/dist/retry-windows-rename.d.ts +8 -0
  444. package/dist/retry-windows-rename.d.ts.map +1 -0
  445. package/dist/retry-windows-rename.js +24 -0
  446. package/dist/retry-windows-rename.js.map +1 -0
  447. package/dist/runtime.d.ts +54 -6
  448. package/dist/runtime.d.ts.map +1 -1
  449. package/dist/runtime.js +1084 -256
  450. package/dist/runtime.js.map +1 -1
  451. package/dist/saved-scan-bootstrap.d.ts +7 -1
  452. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  453. package/dist/saved-scan-bootstrap.js +269 -114
  454. package/dist/saved-scan-bootstrap.js.map +1 -1
  455. package/dist/scan-activity.d.ts.map +1 -1
  456. package/dist/scan-activity.js +141 -56
  457. package/dist/scan-activity.js.map +1 -1
  458. package/dist/scan-archive-path.d.ts +2 -0
  459. package/dist/scan-archive-path.d.ts.map +1 -0
  460. package/dist/scan-archive-path.js +5 -0
  461. package/dist/scan-archive-path.js.map +1 -0
  462. package/dist/scan-comparison.d.ts +10 -5
  463. package/dist/scan-comparison.d.ts.map +1 -1
  464. package/dist/scan-comparison.js +66 -17
  465. package/dist/scan-comparison.js.map +1 -1
  466. package/dist/scan-dashboard.d.ts +7 -6
  467. package/dist/scan-dashboard.d.ts.map +1 -1
  468. package/dist/scan-dashboard.js +92 -43
  469. package/dist/scan-dashboard.js.map +1 -1
  470. package/dist/scan-executor.d.ts +10 -1
  471. package/dist/scan-executor.d.ts.map +1 -1
  472. package/dist/scan-executor.js +24 -2
  473. package/dist/scan-executor.js.map +1 -1
  474. package/dist/scan-history-renderer.d.ts +1 -0
  475. package/dist/scan-history-renderer.d.ts.map +1 -1
  476. package/dist/scan-history-renderer.js +34 -28
  477. package/dist/scan-history-renderer.js.map +1 -1
  478. package/dist/scan-logs.d.ts +12 -0
  479. package/dist/scan-logs.d.ts.map +1 -1
  480. package/dist/scan-logs.js +131 -78
  481. package/dist/scan-logs.js.map +1 -1
  482. package/dist/scan-measurement.d.ts +26 -0
  483. package/dist/scan-measurement.d.ts.map +1 -0
  484. package/dist/scan-measurement.js +77 -0
  485. package/dist/scan-measurement.js.map +1 -0
  486. package/dist/scan-progress.d.ts +1 -0
  487. package/dist/scan-progress.d.ts.map +1 -1
  488. package/dist/scan-progress.js +3 -0
  489. package/dist/scan-progress.js.map +1 -1
  490. package/dist/scan-sessions.d.ts.map +1 -1
  491. package/dist/scan-sessions.js +4 -1
  492. package/dist/scan-sessions.js.map +1 -1
  493. package/dist/scan-settings.d.ts +1 -1
  494. package/dist/scan-settings.d.ts.map +1 -1
  495. package/dist/scan-settings.js +1 -24
  496. package/dist/scan-settings.js.map +1 -1
  497. package/dist/scanner-import.d.ts +25 -13
  498. package/dist/scanner-import.d.ts.map +1 -1
  499. package/dist/scanner-import.js +216 -97
  500. package/dist/scanner-import.js.map +1 -1
  501. package/dist/scanner-repository-url.d.ts +4 -1
  502. package/dist/scanner-repository-url.d.ts.map +1 -1
  503. package/dist/scanner-repository-url.js +10 -6
  504. package/dist/scanner-repository-url.js.map +1 -1
  505. package/dist/security-policy.d.ts +1 -1
  506. package/dist/security-policy.d.ts.map +1 -1
  507. package/dist/security-policy.js +26 -6
  508. package/dist/security-policy.js.map +1 -1
  509. package/dist/semgrep-findings.d.ts +6 -3
  510. package/dist/semgrep-findings.d.ts.map +1 -1
  511. package/dist/semgrep-findings.js +72 -42
  512. package/dist/semgrep-findings.js.map +1 -1
  513. package/dist/semgrep-guardian-findings.d.ts +38 -0
  514. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  515. package/dist/semgrep-guardian-findings.js +165 -0
  516. package/dist/semgrep-guardian-findings.js.map +1 -0
  517. package/dist/semgrep-platform-collector.d.ts +26 -0
  518. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  519. package/dist/semgrep-platform-collector.js +108 -0
  520. package/dist/semgrep-platform-collector.js.map +1 -0
  521. package/dist/semgrep-platform-findings.d.ts +157 -6
  522. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  523. package/dist/semgrep-platform-findings.js +766 -103
  524. package/dist/semgrep-platform-findings.js.map +1 -1
  525. package/dist/server/api.d.ts +1 -1
  526. package/dist/server/api.d.ts.map +1 -1
  527. package/dist/server/api.js.map +1 -1
  528. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  529. package/dist/server/embedding-tokenizer.d.ts +2 -0
  530. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  531. package/dist/server/embedding-tokenizer.js +322 -0
  532. package/dist/server/embedding-tokenizer.js.map +6 -0
  533. package/dist/server/embeddings.d.ts +16 -2
  534. package/dist/server/embeddings.d.ts.map +1 -1
  535. package/dist/server/embeddings.js +35 -5
  536. package/dist/server/embeddings.js.map +1 -1
  537. package/dist/session-lines.d.ts +5 -0
  538. package/dist/session-lines.d.ts.map +1 -0
  539. package/dist/session-lines.js +60 -0
  540. package/dist/session-lines.js.map +1 -0
  541. package/dist/severity-review.d.ts +3 -1
  542. package/dist/severity-review.d.ts.map +1 -1
  543. package/dist/severity-review.js +3 -2
  544. package/dist/severity-review.js.map +1 -1
  545. package/dist/skill-authentication.d.ts +1 -0
  546. package/dist/skill-authentication.d.ts.map +1 -1
  547. package/dist/skill-authentication.js +1 -0
  548. package/dist/skill-authentication.js.map +1 -1
  549. package/dist/snyk-findings.d.ts +9 -2
  550. package/dist/snyk-findings.d.ts.map +1 -1
  551. package/dist/snyk-findings.js +90 -70
  552. package/dist/snyk-findings.js.map +1 -1
  553. package/dist/snyk-rest-findings.d.ts +59 -0
  554. package/dist/snyk-rest-findings.d.ts.map +1 -0
  555. package/dist/snyk-rest-findings.js +879 -0
  556. package/dist/snyk-rest-findings.js.map +1 -0
  557. package/dist/snyk-token-origin.d.ts +4 -0
  558. package/dist/snyk-token-origin.d.ts.map +1 -0
  559. package/dist/snyk-token-origin.js +82 -0
  560. package/dist/snyk-token-origin.js.map +1 -0
  561. package/dist/sonar-collector.d.ts.map +1 -1
  562. package/dist/sonar-collector.js +0 -3
  563. package/dist/sonar-collector.js.map +1 -1
  564. package/dist/sonar-findings.d.ts +1 -1
  565. package/dist/sonar-findings.d.ts.map +1 -1
  566. package/dist/sonar-findings.js +2 -4
  567. package/dist/sonar-findings.js.map +1 -1
  568. package/dist/sonar-import.d.ts +3 -0
  569. package/dist/sonar-import.d.ts.map +1 -1
  570. package/dist/sonar-import.js +30 -34
  571. package/dist/sonar-import.js.map +1 -1
  572. package/dist/stored-finding-projection.d.ts +6 -0
  573. package/dist/stored-finding-projection.d.ts.map +1 -0
  574. package/dist/stored-finding-projection.js +104 -0
  575. package/dist/stored-finding-projection.js.map +1 -0
  576. package/dist/stored-findings-publication.d.ts +23 -0
  577. package/dist/stored-findings-publication.d.ts.map +1 -0
  578. package/dist/stored-findings-publication.js +169 -0
  579. package/dist/stored-findings-publication.js.map +1 -0
  580. package/dist/target-drift.d.ts +9 -0
  581. package/dist/target-drift.d.ts.map +1 -0
  582. package/dist/target-drift.js +27 -0
  583. package/dist/target-drift.js.map +1 -0
  584. package/dist/targets.d.ts +8 -1
  585. package/dist/targets.d.ts.map +1 -1
  586. package/dist/targets.js +131 -42
  587. package/dist/targets.js.map +1 -1
  588. package/dist/tenable-findings.d.ts +6 -0
  589. package/dist/tenable-findings.d.ts.map +1 -0
  590. package/dist/tenable-findings.js +122 -0
  591. package/dist/tenable-findings.js.map +1 -0
  592. package/dist/terminal-stream.d.ts +13 -0
  593. package/dist/terminal-stream.d.ts.map +1 -0
  594. package/dist/terminal-stream.js +35 -0
  595. package/dist/terminal-stream.js.map +1 -0
  596. package/dist/trivy-findings.d.ts +19 -0
  597. package/dist/trivy-findings.d.ts.map +1 -0
  598. package/dist/trivy-findings.js +424 -0
  599. package/dist/trivy-findings.js.map +1 -0
  600. package/dist/trivy-import.d.ts +19 -0
  601. package/dist/trivy-import.d.ts.map +1 -0
  602. package/dist/trivy-import.js +151 -0
  603. package/dist/trivy-import.js.map +1 -0
  604. package/dist/trusted-executable.d.ts +6 -0
  605. package/dist/trusted-executable.d.ts.map +1 -1
  606. package/dist/trusted-executable.js +140 -37
  607. package/dist/trusted-executable.js.map +1 -1
  608. package/dist/validation-records.js +1 -1
  609. package/dist/validation-records.js.map +1 -1
  610. package/dist/veracode-findings.d.ts +1 -1
  611. package/dist/veracode-findings.d.ts.map +1 -1
  612. package/dist/veracode-findings.js +19 -6
  613. package/dist/veracode-findings.js.map +1 -1
  614. package/dist/version.d.ts +3 -1
  615. package/dist/version.d.ts.map +1 -1
  616. package/dist/version.js +184 -32
  617. package/dist/version.js.map +1 -1
  618. package/dist/vertex-pricing.d.ts +8 -0
  619. package/dist/vertex-pricing.d.ts.map +1 -0
  620. package/dist/vertex-pricing.js +20 -0
  621. package/dist/vertex-pricing.js.map +1 -0
  622. package/dist/windows-path.d.ts +1 -0
  623. package/dist/windows-path.d.ts.map +1 -1
  624. package/dist/windows-path.js +26 -1
  625. package/dist/windows-path.js.map +1 -1
  626. package/dist/wiz-findings.d.ts +6 -2
  627. package/dist/wiz-findings.d.ts.map +1 -1
  628. package/dist/wiz-findings.js +65 -89
  629. package/dist/wiz-findings.js.map +1 -1
  630. package/docs/classify-severity-records.md +27 -12
  631. package/docs/cli.md +853 -639
  632. package/docs/dedupe-records.md +44 -24
  633. package/docs/findings-service.md +84 -44
  634. package/docs/hosted-remediation.md +27 -11
  635. package/docs/hosted-scans.md +50 -42
  636. package/docs/sdk.md +903 -0
  637. package/docs/telemetry.md +236 -0
  638. package/docs/validate-records.md +78 -44
  639. package/package.json +23 -16
  640. package/schemas/external-findings.schema.json +4 -1
  641. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  642. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  643. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  644. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  645. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  646. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  647. package/dist/external-imports-feature.d.ts +0 -6
  648. package/dist/external-imports-feature.d.ts.map +0 -1
  649. package/dist/external-imports-feature.js +0 -51
  650. package/dist/external-imports-feature.js.map +0 -1
  651. package/dist/finding-normalization.d.ts +0 -5
  652. package/dist/finding-normalization.d.ts.map +0 -1
  653. package/dist/finding-normalization.js +0 -155
  654. package/dist/finding-normalization.js.map +0 -1
  655. package/dist/reader-selection.d.ts +0 -13
  656. package/dist/reader-selection.d.ts.map +0 -1
  657. package/dist/reader-selection.js +0 -81
  658. package/dist/reader-selection.js.map +0 -1
@@ -1,14 +1,17 @@
1
1
  """Progress transition helpers for the Codex Security workbench."""
2
2
 
3
3
  import argparse
4
+ import json
5
+ import os
4
6
  import sqlite3
5
7
  import sys
6
8
  from pathlib import Path
7
9
  from typing import Any
8
10
 
9
11
  sys.path.insert(0, str(Path(__file__).resolve().parent))
10
- from deep_scan_workbench import require_current_coordinator
11
- from workbench.handoff import require_current_continuation
12
+ from deep_scan_workbench import independent_review_progress, require_current_coordinator
13
+ from finalize_scan_contract import open_scan_local_file_descriptor
14
+ from workbench.handoff import require_current_continuation, require_tokenless_scan_owner
12
15
  from workbench_constants import PHASES
13
16
  from workbench_validation import optional_text, require_uuid, user_context_argument
14
17
 
@@ -16,6 +19,7 @@ from workbench_validation import optional_text, require_uuid, user_context_argum
16
19
  def reportable_count(
17
20
  current_phase: str, requested_phase: str | None, count: int | None
18
21
  ) -> int | None:
22
+ """Default a missing count to zero on entering validation or a later phase from an earlier phase."""
19
23
  if count is None and requested_phase in PHASES[3:] and current_phase in PHASES[:3]:
20
24
  return 0
21
25
  return count
@@ -26,6 +30,7 @@ def update_context(
26
30
  connection: sqlite3.Connection,
27
31
  args: argparse.Namespace,
28
32
  ) -> dict[str, Any]:
33
+ """Update user context on a running scan and return the refreshed scan context in the same workbench."""
29
34
  scan_id = require_uuid(args.scan_id, "scan-id")
30
35
  context = user_context_argument(args)
31
36
  connection.execute("BEGIN IMMEDIATE")
@@ -67,20 +72,178 @@ def update_context(
67
72
  return wb.scan_context(connection, scan_id)
68
73
 
69
74
 
75
+ def scan_progress_result(
76
+ connection: sqlite3.Connection, scan: sqlite3.Row
77
+ ) -> tuple[dict[str, Any], str]:
78
+ independent_reviews = (
79
+ independent_review_progress(
80
+ connection, scan["id"], parent_running=scan["status"] == "running"
81
+ )
82
+ if scan["mode"] == "deep"
83
+ else None
84
+ )
85
+ progress_result = {
86
+ "candidates": {"reportable": scan["reportable_findings_count"]},
87
+ "coverage": {
88
+ "closedRows": scan["review_items_completed"],
89
+ "filesTotal": scan["scope_file_count"],
90
+ "worklistRows": scan["review_items_total"],
91
+ },
92
+ "phase": scan["phase"],
93
+ "phaseProgress": {
94
+ "completed": scan["phase_items_completed"],
95
+ "total": scan["phase_items_total"],
96
+ "unit": scan["phase_progress_unit"],
97
+ },
98
+ "preflightProgress": {
99
+ "completed": scan["preflight_checks_completed"],
100
+ "total": scan["preflight_checks_total"],
101
+ },
102
+ "preflightIssues": json.loads(scan["preflight_issues_json"]),
103
+ "reviewPass": scan["deep_review_pass"],
104
+ "status": "canceled" if scan["canceled_at"] else scan["status"],
105
+ "updatedAt": scan["progress_updated_at"],
106
+ }
107
+ review_updated_at = ""
108
+ if independent_reviews is not None:
109
+ review_updated_at = str(independent_reviews.pop("updatedAt"))
110
+ progress_result["independentReviews"] = independent_reviews
111
+ return progress_result, review_updated_at
112
+
113
+
114
+ def model_progress(wb: Any, connection: sqlite3.Connection, scan_id: str) -> dict[str, Any]:
115
+ scan = wb.scan_history.scan_with_progress(connection, scan_id)
116
+ progress, _ = scan_progress_result(connection, scan)
117
+ result = {"scanId": scan["id"], "progress": progress, "userContext": scan["user_context"]}
118
+ if warnings := json.loads(scan["completion_warnings_json"]):
119
+ result["warnings"] = warnings
120
+ return result
121
+
122
+
123
+ def deep_preflight(scan: sqlite3.Row) -> bool:
124
+ return scan["mode"] == "deep" and scan["phase"] == "preflight" and scan["canceled_at"] is None
125
+
126
+
127
+ def reported_scope_file_count(wb: Any, scan: sqlite3.Row) -> int | None:
128
+ """Read the scoped helper's optional progress count, independently of scan evidence."""
129
+ if (
130
+ scan["mode"] != "standard"
131
+ or scan["launch_kind"] not in (None, "scan")
132
+ or not scan["recipe_json"]
133
+ ):
134
+ return None
135
+ try:
136
+ recipe = json.loads(scan["recipe_json"])
137
+ target = recipe.get("target") if isinstance(recipe, dict) else None
138
+ if not isinstance(target, dict) or target.get("kind") != "paths":
139
+ return None
140
+ repositories = (scan["target_path"], recipe.get("repository"))
141
+ largest_count = 2**53 - 1 # The SDK reports this value as a JavaScript safe integer.
142
+ maximum = (
143
+ max(
144
+ len(json.dumps({"scanId": scan["id"], "repository": repo, "count": largest_count}))
145
+ for repo in repositories
146
+ if isinstance(repo, str)
147
+ )
148
+ + 1
149
+ ) # The helper includes a trailing newline.
150
+ scan_dir = wb.require_canonical_scan_directory(Path(scan["scan_dir"]))
151
+ descriptor = open_scan_local_file_descriptor(
152
+ scan_dir, "scoped-source-input.receipt.json", "Scoped inventory count"
153
+ )
154
+ with os.fdopen(descriptor, "rb") as stream:
155
+ data = stream.read(maximum + 1)
156
+ if len(data) > maximum:
157
+ return None
158
+ report = json.loads(data)
159
+ if (
160
+ isinstance(report, dict)
161
+ and report.get("scanId") == scan["id"]
162
+ and isinstance(report.get("repository"), str)
163
+ and report["repository"] in repositories
164
+ and type(count := report.get("count")) is int
165
+ and 0 <= count <= largest_count
166
+ ):
167
+ return count
168
+ except (OSError, ValueError, RecursionError, SystemExit):
169
+ # An unreadable optional report leaves the stored estimate in place so the scan can continue.
170
+ pass
171
+ return None
172
+
173
+
174
+ def refresh_scope_file_count(
175
+ wb: Any, connection: sqlite3.Connection, scan_id: str, claim_token: str | None
176
+ ) -> dict[str, int | None]:
177
+ scan = wb.require_scan(connection, scan_id)
178
+ if scan["status"] != "running":
179
+ return {"scopeFileCount": None}
180
+ ownership_error = "Scan updates are owned by another continuation."
181
+ require_current_continuation(scan, claim_token, error_message=ownership_error)
182
+ count = reported_scope_file_count(wb, scan)
183
+ if count is None:
184
+ return {"scopeFileCount": None}
185
+ timeout = int(connection.execute("PRAGMA busy_timeout").fetchone()[0])
186
+ try:
187
+ connection.execute("PRAGMA busy_timeout = 0")
188
+ with connection:
189
+ connection.execute("BEGIN IMMEDIATE")
190
+ current = wb.require_scan(connection, scan_id)
191
+ if current["status"] != "running" or current["scan_dir"] != scan["scan_dir"]:
192
+ return {"scopeFileCount": None}
193
+ require_current_continuation(current, claim_token, error_message=ownership_error)
194
+ connection.execute(
195
+ "UPDATE scan_progress SET scope_file_count = ?, updated_at = ? WHERE scan_id = ?",
196
+ (count, wb.now(), scan_id),
197
+ )
198
+ except sqlite3.OperationalError as exc:
199
+ if not wb.sqlite_busy(exc):
200
+ raise
201
+ return {"scopeFileCount": None, "retry": True}
202
+ finally:
203
+ connection.execute(f"PRAGMA busy_timeout = {timeout}")
204
+ return {"scopeFileCount": count}
205
+
206
+
70
207
  def update_progress(
71
208
  wb: Any,
72
209
  connection: sqlite3.Connection,
73
210
  args: argparse.Namespace,
74
211
  ) -> dict[str, Any]:
212
+ """Record phase and review counters for a running scan and return its updated context.
213
+
214
+ Check continuation and coordinator ownership where applicable. A new phase
215
+ starts with fresh phase counters. A new Deep Scan review pass must start
216
+ with zero completed items. Invalid progress raises SystemExit.
217
+ """
75
218
  scan_id = require_uuid(args.scan_id, "scan-id")
219
+ if args.refresh_scope_file_count:
220
+ return refresh_scope_file_count(wb, connection, scan_id, args.claim_token)
76
221
  model = optional_text(args.model, maximum=200)
77
222
  reasoning_effort = optional_text(args.reasoning_effort, maximum=32)
78
- connection.execute("BEGIN IMMEDIATE")
79
223
  with connection:
224
+ scan = None
225
+ if args.model_update:
226
+ connection.execute("BEGIN")
227
+ scan = wb.require_scan(connection, scan_id)
228
+ if not deep_preflight(scan):
229
+ connection.rollback()
230
+ scan = None
231
+ if scan is None:
232
+ # Reread under the writer lock before applying any progress change.
233
+ wb.begin_immediate_with_retry(connection)
234
+ scan = wb.require_scan(connection, scan_id)
80
235
  timestamp = wb.now()
81
- scan = wb.require_scan(connection, scan_id)
236
+ require_tokenless_scan_owner(connection, scan, getattr(args, "model_thread_id", None))
82
237
  if scan["status"] != "running":
83
238
  raise SystemExit("Only a running scan can update progress.")
239
+ if args.model_update and deep_preflight(scan):
240
+ if scan["handoff_claim_token"] is not None:
241
+ require_current_continuation(
242
+ scan,
243
+ args.claim_token,
244
+ error_message="Scan updates are owned by another continuation.",
245
+ )
246
+ return {"scan": model_progress(wb, connection, scan_id), "deepPreflight": True}
84
247
  if scan["mode"] == "deep":
85
248
  coordinator = connection.execute(
86
249
  "SELECT * FROM deep_scan_runs WHERE scan_id = ?", (scan_id,)
@@ -195,6 +358,8 @@ def update_progress(
195
358
  f"UPDATE scan_progress SET {', '.join(updates)}, updated_at = ? WHERE scan_id = ?",
196
359
  (*values, timestamp, scan["id"]),
197
360
  )
361
+ if args.model_update:
362
+ return {"scan": model_progress(wb, connection, scan_id)}
198
363
  return wb.scan_context(connection, scan["id"])
199
364
 
200
365
 
@@ -12,7 +12,6 @@ import sys
12
12
  from contextlib import closing
13
13
  from pathlib import Path
14
14
  from typing import Any
15
- from urllib.parse import quote
16
15
 
17
16
  # Some plugin hosts launch Python with safe-path isolation enabled.
18
17
  sys.path.insert(0, str(Path(__file__).resolve().parent))
@@ -27,10 +26,13 @@ from finalize_scan_contract import (
27
26
  write_export_output,
28
27
  write_sarif_projection,
29
28
  )
29
+ from snapshot_sqlite import readonly_sqlite_uri
30
30
  from validate_scan_contract import validate_contract
31
+ from workbench_constants import PRIMARY_FINDING_LOCATION_SQL
31
32
 
32
33
 
33
34
  def destination_key(destination: Any) -> str:
35
+ """Encode exact provider-specific destination IDs into a stable key for matching issue receipts."""
34
36
  if not isinstance(destination, dict):
35
37
  raise SystemExit("Finding issues require an exact tracker destination.")
36
38
  kind = destination.get("type")
@@ -59,6 +61,12 @@ def verify_publication_history(
59
61
  scan_directory: str,
60
62
  findings: list[dict[str, Any]],
61
63
  ) -> None:
64
+ """Require publication input to match the completed scan in local history.
65
+
66
+ Check the exact scan ID, directory, pinned manifest digest when present,
67
+ and the complete set of occurrence-to-finding associations. Raise
68
+ SystemExit if any of these disagree.
69
+ """
62
70
  try:
63
71
  scan = db.require_scan(connection, scan_id)
64
72
  except SystemExit as exc:
@@ -109,6 +117,7 @@ def inspect_issue_receipts(
109
117
  key: str,
110
118
  finding_ids: list[str],
111
119
  ) -> list[dict[str, Any]]:
120
+ """Return receipts for the selected findings and destination, including receipts from older Linear tables."""
112
121
  tables = {
113
122
  row[0] for row in connection.execute("SELECT name FROM sqlite_master WHERE type = 'table'")
114
123
  }
@@ -132,6 +141,7 @@ def inspect_issue_receipts(
132
141
 
133
142
 
134
143
  def validate_issue_receipts(receipts: Any, selected: dict[str, str]) -> list[dict[str, Any]]:
144
+ """Return receipts bound to the selected finding occurrences or raise SystemExit on invalid receipt data."""
135
145
  if not isinstance(receipts, list):
136
146
  raise SystemExit("Finding issue receipts must be an array.")
137
147
  for receipt in receipts:
@@ -216,9 +226,8 @@ def finding_issues(db: Any, payload: Any) -> dict[str, Any]:
216
226
  except PermissionError:
217
227
  pass # Let SQLite report the open failure used by the host's state fallback.
218
228
  if payload["action"] == "inspect":
219
- database_uri = f"file:{quote(str(path), safe='')}?mode=ro"
220
229
  try:
221
- connection = sqlite3.connect(database_uri, uri=True, timeout=5)
230
+ connection = sqlite3.connect(readonly_sqlite_uri(path), uri=True, timeout=5)
222
231
  except sqlite3.OperationalError as exc:
223
232
  if str(exc) == "unable to open database file":
224
233
  exc._codex_security_state_unavailable = True
@@ -367,6 +376,7 @@ def write_csv_export(
367
376
  scan: sqlite3.Row,
368
377
  findings_document: dict[str, Any],
369
378
  ) -> Path:
379
+ """Write indexed findings to exports/findings.csv, adding candidate IDs for Deep Scans, and return its path."""
370
380
  scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
371
381
  output = io.StringIO(newline="")
372
382
  writer = csv.writer(output)
@@ -412,7 +422,7 @@ def write_csv_export(
412
422
 
413
423
  def finding_export_rows(connection: sqlite3.Connection, scan_id: str) -> sqlite3.Cursor:
414
424
  return connection.execute(
415
- """
425
+ f"""
416
426
  SELECT
417
427
  occurrences.id AS occurrence_id,
418
428
  occurrences.finding_id,
@@ -430,15 +440,8 @@ def finding_export_rows(connection: sqlite3.Connection, scan_id: str) -> sqlite3
430
440
  FROM finding_occurrences AS occurrences
431
441
  LEFT JOIN finding_triage AS triage ON triage.occurrence_id = occurrences.id
432
442
  LEFT JOIN finding_locations AS locations
433
- ON locations.occurrence_id = occurrences.id
434
- AND locations.sort_order = (
435
- SELECT primary_location.sort_order
436
- FROM finding_locations AS primary_location
437
- WHERE primary_location.occurrence_id = occurrences.id
438
- ORDER BY
439
- CASE WHEN primary_location.role = 'root_control' THEN 0 ELSE 1 END,
440
- primary_location.sort_order
441
- LIMIT 1
443
+ ON locations.id = (
444
+ SELECT id {PRIMARY_FINDING_LOCATION_SQL}
442
445
  )
443
446
  WHERE occurrences.scan_id = ?
444
447
  ORDER BY occurrences.created_at, occurrences.id
@@ -11,7 +11,7 @@ import re
11
11
  import sqlite3
12
12
  import sys
13
13
  from collections.abc import Callable
14
- from contextlib import ExitStack, suppress
14
+ from contextlib import AbstractContextManager, ExitStack, suppress
15
15
  from datetime import datetime, timedelta, timezone
16
16
  from pathlib import Path
17
17
  from typing import Any, BinaryIO
@@ -30,7 +30,11 @@ from finalize_scan_contract import (
30
30
  stage_scan_local_bytes,
31
31
  )
32
32
  from posix_scan_local_files import managed_fd
33
- from workbench_constants import CLAIM_LEASE_SECONDS, DELIVERED_ACTION_LEASE_SECONDS
33
+ from workbench_constants import (
34
+ CLAIM_LEASE_SECONDS,
35
+ DELIVERED_ACTION_LEASE_SECONDS,
36
+ PATCH_PREVIEW_BYTES,
37
+ )
34
38
  from workbench_target import git_command, git_output
35
39
  from workbench_validation import optional_text, require_occurrence, require_uuid
36
40
 
@@ -46,7 +50,144 @@ COMMANDS = {
46
50
  SCAN_STATUS_ERROR = "Remediation is available only for successfully completed scans."
47
51
 
48
52
 
53
+ def patch_artifact_preview(
54
+ scan_dir: Path,
55
+ relative_path: str | None,
56
+ expected_digest: str | None,
57
+ open_scan_file: Callable[[Path, str], AbstractContextManager[BinaryIO]],
58
+ ) -> tuple[str | None, dict[str, int | bool] | None]:
59
+ if relative_path is None or expected_digest is None:
60
+ return None, None
61
+ digest = hashlib.sha256()
62
+ preview = bytearray()
63
+ additions = 0
64
+ deletions = 0
65
+ file_count = 0
66
+ old_headers = 0
67
+ new_headers = 0
68
+ at_line_start = True
69
+ try:
70
+ with open_scan_file(scan_dir, relative_path) as patch:
71
+ while chunk := patch.readline(1024 * 1024):
72
+ digest.update(chunk)
73
+ if len(preview) <= PATCH_PREVIEW_BYTES:
74
+ preview.extend(chunk[: PATCH_PREVIEW_BYTES + 1 - len(preview)])
75
+ if at_line_start:
76
+ if chunk.startswith(b"diff --git "):
77
+ file_count += 1
78
+ elif chunk.startswith(b"+++ "):
79
+ new_headers += 1
80
+ elif chunk.startswith(b"--- "):
81
+ old_headers += 1
82
+ elif chunk.startswith(b"+"):
83
+ additions += 1
84
+ elif chunk.startswith(b"-"):
85
+ deletions += 1
86
+ at_line_start = chunk.endswith(b"\n")
87
+ except SystemExit:
88
+ return None, None
89
+ if f"sha256:{digest.hexdigest()}" != expected_digest:
90
+ return None, None
91
+ preview_truncated = len(preview) > PATCH_PREVIEW_BYTES
92
+ preview_text = preview[:PATCH_PREVIEW_BYTES].decode("utf-8", errors="replace")
93
+ if preview_truncated:
94
+ preview_text = f"{preview_text}\n... patch preview truncated ..."
95
+ return preview_text, {
96
+ "additions": additions,
97
+ "deletions": deletions,
98
+ "fileCount": file_count or min(old_headers, new_headers),
99
+ "previewTruncated": preview_truncated,
100
+ }
101
+
102
+
103
+ def reverse_reviewed_patch(
104
+ target: Path,
105
+ checkout: Path,
106
+ metadata: Path | None,
107
+ pinned_metadata: Path | None,
108
+ patch_digest: str,
109
+ pins: ExitStack,
110
+ patch: Path,
111
+ pathspec: str | None,
112
+ ) -> tuple[Path | None, Path | None]:
113
+ """Reverse reviewed bytes and select the Git references for subsequent content snapshots."""
114
+
115
+ arguments = ["--reverse", "--whitespace=nowarn"]
116
+ if pathspec is None:
117
+ arguments.append("--no-index")
118
+ elif pathspec != ".":
119
+ arguments.append(f"--directory={pathspec}")
120
+ arguments.append(str(patch))
121
+
122
+ def reverse(*, git_dir: Path | None, check: bool = False):
123
+ return git_command(
124
+ checkout,
125
+ "apply",
126
+ *(["--check"] if check else []),
127
+ *arguments,
128
+ text=False,
129
+ git_dir=git_dir,
130
+ work_tree=checkout if git_dir else None,
131
+ environment_overrides={"LC_ALL": "C", "LANGUAGE": "C"} if check else None,
132
+ )
133
+
134
+ applied = reverse(git_dir=metadata)
135
+ short = None
136
+ diagnostic = b"fatal: '$GIT_DIR' too big"
137
+ if (
138
+ os.name == "nt"
139
+ and metadata is not None
140
+ and applied.returncode == 128
141
+ and not applied.stdout
142
+ and b"GIT_DIR" in applied.stderr
143
+ ):
144
+ # Confirm translated messages without applying the reverse patch twice.
145
+ failure = (
146
+ applied
147
+ if diagnostic in applied.stderr.splitlines()
148
+ else reverse(git_dir=metadata, check=True)
149
+ )
150
+ if (
151
+ failure.returncode == 128
152
+ and not failure.stdout
153
+ and diagnostic in failure.stderr.splitlines()
154
+ ):
155
+ short = prepare_replay_gitfile(checkout, pinned_metadata, patch_digest, pins)
156
+ applied = reverse(git_dir=short)
157
+ if applied.returncode != 0:
158
+ raise SystemExit(
159
+ "The selected checkout does not contain the reviewed remediation patch. Apply exactly that patch before recording it as applied."
160
+ )
161
+ replay_root = None
162
+ if pathspec is None and short is not None:
163
+ selected_root = git_output(target, "rev-parse", "--show-toplevel")
164
+ if selected_root and Path(selected_root).samefile(target):
165
+ replay_root = short
166
+ return short, replay_root
167
+
168
+
169
+ def prepare_replay_gitfile(
170
+ checkout: Path, pinned_metadata: Path | None, patch_digest: str, pins: ExitStack
171
+ ) -> Path:
172
+ """Retain the verified patch and short metadata reference through the final snapshot."""
173
+ if pinned_metadata is None:
174
+ raise SystemExit(
175
+ "Could not bind the selected Windows Git directory and private patch replay directory."
176
+ )
177
+ from windows_scan_local_files import open_read_fd, pinned_replay_gitfile
178
+
179
+ try:
180
+ short = pins.enter_context(pinned_replay_gitfile(checkout, pinned_metadata))
181
+ fd = open_read_fd(checkout.parent, "reviewed.patch", "reviewed remediation patch")
182
+ patch = pins.enter_context(os.fdopen(fd, "rb"))
183
+ matching_patch_metadata(patch, patch_digest)
184
+ except (OSError, ValueError) as exc:
185
+ raise SystemExit(f"Could not verify the reviewed patch replay: {exc}") from exc
186
+ return short
187
+
188
+
49
189
  def require_available(connection: sqlite3.Connection, args: Any, require_scan: Any) -> None:
190
+ """Require a successfully completed scan for commands that act on a remediation request."""
50
191
  if args.command not in COMMANDS:
51
192
  return
52
193
  occurrence = require_occurrence(connection, args.occurrence_id)
@@ -57,6 +198,7 @@ def require_available(connection: sqlite3.Connection, args: Any, require_scan: A
57
198
  def require_request(
58
199
  connection: sqlite3.Connection, request_id: str, occurrence: sqlite3.Row
59
200
  ) -> sqlite3.Row:
201
+ """Return the request row or raise SystemExit if the request is missing or belongs to a different occurrence."""
60
202
  current = connection.execute(
61
203
  "SELECT * FROM finding_remediation_attempts WHERE request_id = ?",
62
204
  (request_id,),
@@ -67,6 +209,7 @@ def require_request(
67
209
 
68
210
 
69
211
  def latest_attempt(connection: sqlite3.Connection, occurrence_id: str) -> sqlite3.Row | None:
212
+ """Return the newest remediation attempt for the occurrence, breaking timestamp ties by insertion order."""
70
213
  return connection.execute(
71
214
  """
72
215
  SELECT * FROM finding_remediation_attempts
@@ -344,6 +487,12 @@ def patch_metadata(
344
487
  patch: bytes | None,
345
488
  resolve_path: Callable[[str], str],
346
489
  ) -> tuple[str | None, str | None]:
490
+ """Resolve a remediation attempt’s patch path and SHA-256 digest.
491
+
492
+ For newly generated bytes, compute the digest and use the existing or
493
+ request-specific path. For a referenced patch, validate the supplied path
494
+ and digest. Raise SystemExit if either conflicts with a previously reviewed value.
495
+ """
347
496
  path = args.patch_path
348
497
  digest = args.patch_digest
349
498
  if patch is not None:
@@ -371,6 +520,7 @@ def patch_metadata(
371
520
  def same_file_version(
372
521
  original: tuple[os.stat_result, int], current: tuple[os.stat_result, int]
373
522
  ) -> bool:
523
+ """Compare file identity, size, modification time, and the platform-specific change-time token."""
374
524
  before, before_change = original
375
525
  after, after_change = current
376
526
  return (
@@ -382,6 +532,7 @@ def same_file_version(
382
532
 
383
533
 
384
534
  def file_digest_and_version(source: BinaryIO, label: str) -> tuple[str, tuple[os.stat_result, int]]:
535
+ """Hash the remaining stream bytes and return their digest and file version, raising SystemExit if the file changes."""
385
536
  before = scan_local_file_version(source.fileno())
386
537
  digest = hashlib.sha256()
387
538
  for chunk in iter(lambda: source.read(1024 * 1024), b""):
@@ -393,6 +544,7 @@ def file_digest_and_version(source: BinaryIO, label: str) -> tuple[str, tuple[os
393
544
 
394
545
 
395
546
  def matching_patch_metadata(source: BinaryIO, expected_digest: str) -> tuple[os.stat_result, int]:
547
+ """Return the stable patch version or raise SystemExit if its bytes differ from expected_digest."""
396
548
  digest, version = file_digest_and_version(source, "scan-local patch")
397
549
  if digest != expected_digest:
398
550
  raise SystemExit("Patch digest does not match the scan-local patch file.")
@@ -402,6 +554,7 @@ def matching_patch_metadata(source: BinaryIO, expected_digest: str) -> tuple[os.
402
554
  def patch_manifest_version(
403
555
  db: Any, scan: sqlite3.Row, scan_dir: Path
404
556
  ) -> tuple[str, tuple[os.stat_result, int]]:
557
+ """Verify the sealed scan manifest and return its byte digest and file version, including for legacy scans."""
405
558
  manifest_path = db.ARTIFACTS["manifest"]
406
559
  expected = scan["seal_manifest_digest"]
407
560
  if expected is None: