@openai/codex-security 0.8.2 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -8,7 +8,7 @@ import json
8
8
  import os
9
9
  import re
10
10
  import stat
11
- from collections.abc import Iterator
11
+ from collections.abc import Iterable, Iterator
12
12
  from functools import partial
13
13
  from pathlib import Path
14
14
  from typing import Any
@@ -56,23 +56,30 @@ def _source_digests(value: Any, error: str) -> dict[str, str]:
56
56
  return value
57
57
 
58
58
 
59
- def _retained_source_state(value: Any) -> tuple[dict[str, str], str | None]:
60
- if isinstance(value, dict) and isinstance(value.get("sources"), dict):
61
- sources = _source_digests(
62
- value["sources"], "Saved stopped-scan source digests are malformed."
63
- )
64
- model_source = value.get("threatModelSource")
65
- if "threatModelSource" in value and (
66
- not isinstance(model_source, str) or model_source not in sources
67
- ):
68
- raise ContractError("Saved stopped-scan model source is outside its checkpoint set.")
69
- return sources, model_source
70
- return _source_digests(value, "Saved stopped-scan source digests are malformed."), None
59
+ def _retained_source_state(raw: str | None) -> dict[str, Any]:
60
+ """Decode stopped-scan sources, preserving the distinction between absent and frozen empty."""
61
+ if raw is None:
62
+ return {}
63
+ state = json.loads(raw)
64
+ if not isinstance(state, dict) or not isinstance(state.get("sources"), dict):
65
+ state = {"sources": state} # Legacy rows store only the path-to-digest map.
66
+ sources = _source_digests(state["sources"], "Saved stopped-scan source digests are malformed.")
67
+ model_source = state.get("threatModelSource")
68
+ if "threatModelSource" in state and (
69
+ not isinstance(model_source, str) or model_source not in sources
70
+ ):
71
+ raise ContractError("Saved stopped-scan model source is outside its checkpoint set.")
72
+ return state
71
73
 
72
74
 
73
75
  def _retained_checkpoint_state(
74
76
  scan: Any,
75
77
  ) -> tuple[dict[str, str | None] | None, dict[str, Any] | None]:
78
+ """Return selected checkpoint heads and any pending recovery record.
79
+
80
+ Older scans can store the head map directly. Recovery records also bind
81
+ the selection to a sealed manifest digest. A conflicting digest raises ContractError.
82
+ """
76
83
  raw = scan["retained_checkpoint_heads_json"]
77
84
  if raw is None:
78
85
  return None, None
@@ -125,6 +132,7 @@ def _checkpoint_paths(scan_dir: Path, directory: str) -> list[str]:
125
132
 
126
133
 
127
134
  def _checkpoint_head_directory(relative: str) -> Path | None:
135
+ """Return the owner directory of a current or archived checkpoint head path, or None for another file."""
128
136
  path = Path(relative)
129
137
  if path.name == "checkpoint-head.json":
130
138
  return path.parent
@@ -162,6 +170,7 @@ def _capture_saved_source(
162
170
  checkpoint_heads: dict[str, str | None] | None = None,
163
171
  expected_digest: str | None = None,
164
172
  ) -> dict[str, tuple[str, int]]:
173
+ """Capture digests and observation times for a saved source and its selected checkpoint or receipt inputs."""
165
174
  if not snapshot_head or Path(relative).name != "checkpoint-head.json":
166
175
  _, digest, observed = _read_saved_result(scan_dir, relative, scan_id, kind=kind)
167
176
  return capture_receipt_checkpoints(
@@ -241,14 +250,18 @@ def _read_saved_result(
241
250
  return draft, _digest(draft), int(observed)
242
251
  if draft.get("scanId") != scan_id:
243
252
  raise ContractError("checkpoint belongs to a different scan")
244
- if not _is_source_order_snapshot(relative) and (
245
- not isinstance(draft.get("findings"), list)
246
- or not isinstance(
247
- draft.get("reviewState", draft.get("coverage", {} if kind == "dedup" else None)), dict
248
- )
253
+ if _is_source_order_snapshot(relative):
254
+ return draft, _digest(draft), metadata.st_mtime_ns
255
+ if not isinstance(draft.get("findings"), list) or not isinstance(
256
+ draft.get("reviewState", draft.get("coverage", {} if kind == "dedup" else None)), dict
249
257
  ):
250
258
  raise ContractError("checkpoint has no semantic findings or coverage")
251
259
  digest = _digest(draft)
260
+ if kind == "dedup" and normalize_review:
261
+ # The host keeps grouping state in iteration checkpoints for resume only.
262
+ for finding in draft["findings"]:
263
+ if isinstance(finding, dict) and isinstance(finding.get("provenance"), dict):
264
+ finding["provenance"].pop("deepScanRepairGroups", None)
252
265
  if normalize_review and "coverage" in draft and "reviewState" not in draft:
253
266
  draft["reviewState"] = draft.pop("coverage")
254
267
  return draft, digest, metadata.st_mtime_ns
@@ -388,6 +401,7 @@ def _restore_checkpoint_head(
388
401
  sources: dict[str, str],
389
402
  relative: str,
390
403
  ) -> None:
404
+ """Restore the prior selection for a checkpoint directory, allowing legacy evidence with no selected head."""
391
405
  path = Path(relative)
392
406
  if path.name != "checkpoint-head.json":
393
407
  return
@@ -639,25 +653,10 @@ def _require_current_deep_publication(
639
653
  raise SystemExit("Deep Scan is terminal; drafts cannot replace its publication.")
640
654
  return
641
655
 
642
- # Match the durable reducer sequence used by coordinator recovery.
643
- def reducer_order(worker: Any) -> tuple[int, str]:
644
- match = re.fullmatch(r"dedup-([0-9]+)", Path(worker["prompt_path"]).parent.name)
645
- return (int(match[1]) if match else 0, worker["id"])
646
-
647
- reducer = max(
648
- (
649
- worker
650
- for worker in connection.execute(
651
- "SELECT * FROM deep_scan_workers WHERE scan_id = ?", (scan_id,)
652
- )
653
- if worker["kind"] == "dedup"
654
- and worker["status"] == "succeeded"
655
- and worker["result_manifest_path"]
656
- ),
657
- key=reducer_order,
658
- default=None,
656
+ iteration = _latest_iteration(
657
+ connection.execute("SELECT * FROM deep_scan_workers WHERE scan_id = ?", (scan_id,))
659
658
  )
660
- selected_result = reducer["result_manifest_path"] if reducer is not None else None
659
+ selected_result = iteration["result_manifest_path"] if iteration is not None else None
661
660
  if publication["resultPath"] != selected_result:
662
661
  raise SystemExit("Deep Scan aggregate belongs to a superseded publication selection.")
663
662
 
@@ -666,7 +665,15 @@ if __name__ == "__main__":
666
665
  argparse.ArgumentParser(description=__doc__).parse_args()
667
666
 
668
667
 
669
- def _latest_successful_reducer(workers: list[Any]) -> Any | None:
668
+ def _iteration_order(worker: Any) -> tuple[int, str, str]:
669
+ result = worker["result_manifest_path"]
670
+ output = Path(result).parent if result else Path(worker["artifact_dir"])
671
+ label = output.parent.name if output.name == "output" else output.name
672
+ match = re.fullmatch(r"dedup-([0-9]+)", label)
673
+ return (int(match[1]) if match else 0, worker["completed_at"] or "", worker["id"])
674
+
675
+
676
+ def _latest_iteration(workers: Iterable[Any]) -> Any | None:
670
677
  return max(
671
678
  (
672
679
  worker
@@ -675,7 +682,7 @@ def _latest_successful_reducer(workers: list[Any]) -> Any | None:
675
682
  and worker["status"] == "succeeded"
676
683
  and worker["result_manifest_path"]
677
684
  ),
678
- key=lambda worker: (worker["completed_at"] or "", worker["id"]),
685
+ key=_iteration_order,
679
686
  default=None,
680
687
  )
681
688
 
@@ -695,7 +702,7 @@ def _worker_outputs(scan_dir: Path, worker: Any) -> list[tuple[str, int]]:
695
702
 
696
703
 
697
704
  def _saved_result_paths(scan_dir: Path, workers: list[Any]) -> Iterator[tuple[str, str | None]]:
698
- latest_reducer = _latest_successful_reducer(workers)
705
+ iteration = _latest_iteration(workers)
699
706
  yield "checkpoint-head.json", None
700
707
  for directory in ("checkpoint-heads", "checkpoints"):
701
708
  yield from ((path, None) for path in _checkpoint_paths(scan_dir, directory))
@@ -719,7 +726,7 @@ def _saved_result_paths(scan_dir: Path, workers: list[Any]) -> Iterator[tuple[st
719
726
  yield from ((path, worker["kind"]) for path in checkpoint_paths)
720
727
  if worker["result_manifest_path"] and (
721
728
  worker["kind"] == "discovery"
722
- or (latest_reducer is not None and worker["id"] == latest_reducer["id"])
729
+ or (iteration is not None and worker["id"] == iteration["id"])
723
730
  ):
724
731
  try:
725
732
  yield (
@@ -3,10 +3,17 @@
3
3
  from __future__ import annotations
4
4
 
5
5
  import os
6
+ import sqlite3
7
+ import tempfile
6
8
  from pathlib import Path
9
+ from typing import Any
10
+
11
+ if os.name == "nt":
12
+ import windows_scan_local_files as windows_files
7
13
 
8
14
 
9
15
  def state_dir(*, canonical: bool = True) -> Path:
16
+ """Return the workbench state path, resolving symlinks unless canonical is false."""
10
17
  configured = os.environ.get("CODEX_SECURITY_STATE_DIR")
11
18
  if configured:
12
19
  path = Path(configured).expanduser()
@@ -19,15 +26,72 @@ def state_dir(*, canonical: bool = True) -> Path:
19
26
 
20
27
 
21
28
  def resolve_scan_root(scan_root: str | None) -> Path:
29
+ """Resolve an explicit scan output root, defaulting to the scans directory under workbench state."""
22
30
  return Path(scan_root).expanduser().resolve() if scan_root else state_dir() / "scans"
23
31
 
24
32
 
25
- def create_private_directory(path: Path) -> None:
33
+ def worker_usage_directory(scan_id: str) -> Path:
34
+ """Bind host-observed receipts beneath the persistent protected native home."""
35
+ return state_dir() / "codex-home" / "worker-usage" / scan_id
36
+
37
+
38
+ def archived_deep_path(scan_dir: Path, value: str | None) -> str | None:
39
+ """Resolve old archive rows that still name the original sibling output."""
40
+ if value is None or ".previous-" not in scan_dir.name:
41
+ return value
42
+ path = Path(value)
43
+ if not path.is_relative_to(scan_dir.parent):
44
+ return value
45
+ parts = path.relative_to(scan_dir.parent).parts
46
+ if not parts or ".." in parts or not scan_dir.name.startswith(f"{parts[0]}.previous-"):
47
+ return value
48
+ # Keep missing files inside the archive too. Never follow the replacement scan's output.
49
+ return str(scan_dir.joinpath(*parts[1:]))
50
+
51
+
52
+ def saved_deep_workers(connection: sqlite3.Connection, scan: sqlite3.Row) -> list[Any]:
53
+ workers = connection.execute(
54
+ "SELECT * FROM deep_scan_workers WHERE scan_id = ? ORDER BY created_at, id",
55
+ (scan["id"],),
56
+ ).fetchall()
57
+ scan_dir = Path(scan["scan_dir"])
58
+ if ".previous-" not in scan_dir.name:
59
+ return workers
60
+ return [
61
+ {
62
+ **worker,
63
+ **{
64
+ key: archived_deep_path(scan_dir, worker[key])
65
+ for key in ("artifact_dir", "prompt_path", "result_manifest_path")
66
+ },
67
+ }
68
+ for worker in workers
69
+ ]
70
+
71
+
72
+ def create_private_directory(path: Path, *, scan_output: bool = False) -> None:
26
73
  """Create missing directories privately without changing existing permissions."""
27
- try:
28
- path.mkdir(mode=0o700, exist_ok=True)
29
- except FileNotFoundError:
30
- if path.parent == path:
31
- raise
32
- create_private_directory(path.parent)
74
+ if path.parent != path and not path.parent.is_dir():
75
+ create_private_directory(path.parent, scan_output=scan_output)
76
+ if os.name != "nt":
33
77
  path.mkdir(mode=0o700, exist_ok=True)
78
+ elif not path.is_dir():
79
+ windows_files.create_private_directory(path, exist_ok=True, scan_output=scan_output)
80
+ elif scan_output:
81
+ windows_files.require_windows_output_path(path)
82
+
83
+
84
+ def create_private_temporary_directory(parent: Path, *, prefix: str) -> Path:
85
+ """Create a unique private child without inheriting a permissive Windows DACL."""
86
+ if os.name != "nt":
87
+ return Path(tempfile.mkdtemp(prefix=prefix, dir=parent)).resolve()
88
+
89
+ import secrets
90
+
91
+ for _ in range(100):
92
+ path = parent / f"{prefix}{secrets.token_hex(4)}"
93
+ try:
94
+ return windows_files.create_private_directory(path, exist_ok=False, scan_output=True)
95
+ except FileExistsError:
96
+ continue
97
+ raise FileExistsError(f"Could not create a unique directory beneath {parent}.")
@@ -8,7 +8,6 @@ from pathlib import Path
8
8
 
9
9
  # Some plugin hosts launch Python with safe-path isolation enabled.
10
10
  sys.path.insert(0, str(Path(__file__).resolve().parent))
11
- import deep_scan_workbench as deep_scan
12
11
  from workbench_constants import (
13
12
  DIFF_TARGET_KINDS,
14
13
  EXPORT_FORMATS,
@@ -24,13 +23,25 @@ from workbench_constants import (
24
23
  )
25
24
 
26
25
 
26
+ def non_negative_int(value: str) -> int:
27
+ parsed = int(value)
28
+ if parsed < 0:
29
+ raise argparse.ArgumentTypeError("expected a non-negative integer")
30
+ return parsed
31
+
32
+
27
33
  def add_user_context(parser: argparse.ArgumentParser, *, required: bool = False) -> None:
28
34
  context = parser.add_mutually_exclusive_group(required=required)
29
35
  context.add_argument("--user-context")
30
36
  context.add_argument("--user-context-stdin", action="store_true")
31
37
 
32
38
 
33
- def parse_args(description: str) -> argparse.Namespace:
39
+ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.Namespace:
40
+ """Parse the workbench command line into the namespace consumed by its dispatcher.
41
+
42
+ For a full command, read UTF-8 user context from stdin when requested. In
43
+ inspection mode, recognized inspection arguments return before that read.
44
+ """
34
45
  parser = argparse.ArgumentParser(description=description)
35
46
  subparsers = parser.add_subparsers(dest="command", required=True)
36
47
 
@@ -82,6 +93,12 @@ def parse_args(description: str) -> argparse.Namespace:
82
93
  diff_parser.add_argument("--diff-head-revision")
83
94
  diff_parser.add_argument("--diff-content-digest")
84
95
 
96
+ if inspection_only:
97
+ # Unknown arguments use the full parser below for its normal usage diagnostic.
98
+ args, unknown = parser.parse_known_args()
99
+ if not unknown:
100
+ return args
101
+
85
102
  start_headless_standard_scan = add_command(
86
103
  "start-headless-standard-scan", "--thread-id", "--target-path", "--scope"
87
104
  )
@@ -99,14 +116,97 @@ def parse_args(description: str) -> argparse.Namespace:
99
116
  diff_content_digest=None,
100
117
  )
101
118
 
102
- deep_scan.register_subcommands(subparsers, positive_int)
119
+ begin_deep_scan = add_command("begin-deep-scan", "--thread-id")
120
+ begin_deep_scan.add_argument("--model-thread-id")
121
+ begin_target = begin_deep_scan.add_mutually_exclusive_group(required=True)
122
+ begin_target.add_argument("--scan-id")
123
+ begin_target.add_argument("--target-path")
124
+ begin_deep_scan.add_argument("--scope", default=".")
125
+ add_user_context(begin_deep_scan)
126
+ begin_deep_scan.add_argument("--scan-root")
127
+ begin_deep_scan.add_argument("--claim-token")
128
+ begin_deep_scan.add_argument("--model")
129
+ begin_deep_scan.add_argument("--reasoning-effort")
130
+ begin_deep_scan.add_argument("--service-tier")
131
+ begin_deep_scan.add_argument("--available-parallelism", type=positive_int)
132
+ begin_deep_scan.add_argument("--deep-scan-project-json")
133
+ begin_deep_scan.add_argument("--project-config-path")
134
+ begin_deep_scan.add_argument("--join-only", action="store_true")
135
+ begin_deep_scan.add_argument("--workflow-version", default="deep-security-scan/v1")
136
+
137
+ add_command("get-deep-scan", "--scan-id", "--thread-id")
138
+
139
+ add_command("acknowledge-deep-scan-result", "--scan-id")
140
+
141
+ claim_coordinator = add_command("claim-deep-scan-coordinator", "--scan-id", "--thread-id")
142
+ claim_coordinator.add_argument("--claim-token")
143
+ claim_coordinator.add_argument("--coordinator-generation", type=positive_int)
144
+
145
+ upsert_deep_worker = add_command("upsert-deep-scan-worker", "--scan-id", "--worker-id")
146
+ upsert_deep_worker.add_argument(
147
+ "--kind", choices=("setup", "discovery", "dedup"), required=True
148
+ )
149
+ upsert_deep_worker.add_argument(
150
+ "--status", choices=("queued", "running", "succeeded", "failed", "canceled"), required=True
151
+ )
152
+ upsert_deep_worker.add_argument("--prompt-path", required=True)
153
+ upsert_deep_worker.add_argument("--artifact-dir", required=True)
154
+ upsert_deep_worker.add_argument("--result-manifest-path")
155
+ upsert_deep_worker.add_argument("--attempt", type=non_negative_int)
156
+ upsert_deep_worker.add_argument("--sdk-thread-id")
157
+ upsert_deep_worker.add_argument("--error-message")
158
+ upsert_deep_worker.add_argument("--terminal-failure", action="store_true")
159
+ upsert_deep_worker.add_argument(
160
+ "--replaceable-failure-kind",
161
+ choices=("policy_refusal", "transient_error", "invalid_discovery_artifacts"),
162
+ )
163
+ upsert_deep_worker.add_argument("--coordinator-generation", type=positive_int)
164
+
165
+ iteration = add_command(
166
+ "record-deep-scan-iteration", "--scan-id", "--worker-id", "--result-manifest-path"
167
+ )
168
+ iteration.add_argument("--input-worker-id", action="append", required=True)
169
+ iteration.add_argument("--no-new-streak", type=non_negative_int, required=True)
170
+ iteration.add_argument("--consecutive-errors", type=non_negative_int, required=True)
171
+ iteration.add_argument("--coordinator-generation", type=positive_int)
172
+
173
+ finish_deep_scan = add_command("finish-deep-scan", "--scan-id")
174
+ finish_deep_scan.add_argument(
175
+ "--terminal-reason", choices=("saturated", "capped"), required=True
176
+ )
177
+ finish_deep_scan.add_argument("--manifest-path", required=True)
178
+ finish_deep_scan.add_argument("--staged-manifest-path")
179
+ finish_deep_scan.add_argument("--omitted-worker-id", action="append", default=[])
180
+ finish_deep_scan.add_argument("--coordinator-generation", type=positive_int)
181
+
182
+ fail_deep_scan = add_command("fail-deep-scan", "--scan-id", "--message")
183
+ fail_deep_scan.add_argument("--manifest-path")
184
+ fail_deep_scan.add_argument("--staged-manifest-path")
185
+ fail_deep_scan.add_argument(
186
+ "--deep-status", choices=("failed", "interrupted"), default="failed"
187
+ )
188
+ fail_deep_scan.add_argument("--coordinator-generation", type=positive_int)
189
+
190
+ publication_failure = add_command(
191
+ "record-deep-scan-publication-failure", "--scan-id", "--message"
192
+ )
193
+ publication_failure.add_argument("--coordinator-generation", type=positive_int)
103
194
 
104
195
  get_scan = add_command("get-scan", "--scan-id")
105
- get_scan.add_argument("--occurrence-id")
196
+ get_scan.add_argument("--model-thread-id")
197
+ get_scan.add_argument("--context-claim-token")
198
+ get_scan.add_argument("--request-id")
199
+ get_scan.add_argument("--action-token")
200
+ detail = get_scan.add_mutually_exclusive_group()
201
+ detail.add_argument("--occurrence-id")
202
+ detail.add_argument("--progress-only", action="store_true")
106
203
  get_scan.add_argument("--check-target", action="store_true")
107
204
 
108
205
  add_command("rename-scan", "--scan-id", "--name")
109
206
 
207
+ read_scan_usage = add_command("read-scan-usage", "--scan-id", "--thread-id")
208
+ read_scan_usage.add_argument("--validation-thread-id")
209
+
110
210
  add_command("get-scan-feedback", "--scan-id")
111
211
 
112
212
  update_scan_context = add_command("update-scan-context", "--scan-id")
@@ -123,7 +223,7 @@ def parse_args(description: str) -> argparse.Namespace:
123
223
  list_scans.add_argument("--mode", choices=MODES)
124
224
  list_scans.add_argument("--repository")
125
225
  list_scans.add_argument("--scan-root")
126
- list_scans.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
226
+ list_scans.add_argument("--offset", type=non_negative_int, default=0)
127
227
  list_scans.add_argument("--limit", type=positive_int)
128
228
 
129
229
  list_unmatched_scan_pairs = add_command("list-unmatched-scan-pairs", "--repository")
@@ -171,30 +271,31 @@ def parse_args(description: str) -> argparse.Namespace:
171
271
  list_global_findings.add_argument("--severity", choices=FINDING_SEVERITIES)
172
272
  list_global_findings.add_argument("--status", choices=FINDING_STATUSES)
173
273
  list_global_findings.add_argument("--target-id")
174
- list_global_findings.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
274
+ list_global_findings.add_argument("--offset", type=non_negative_int, default=0)
175
275
  list_global_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
176
276
  list_repositories = subparsers.add_parser("list-repositories")
177
277
  list_repositories.add_argument("--query")
178
278
  list_repositories.add_argument("--target-id")
179
279
  list_repositories.add_argument("--status", choices=("scanned", "not_scanned", "open_findings"))
180
- list_repositories.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
280
+ list_repositories.add_argument("--offset", type=non_negative_int, default=0)
181
281
  list_repositories.add_argument("--limit", type=positive_int)
182
282
 
183
283
  list_findings = add_command("list-findings", "--scan-id")
184
284
  list_findings.add_argument("--query")
185
285
  list_findings.add_argument("--severity", choices=FINDING_SEVERITIES)
186
286
  list_findings.add_argument("--status", choices=FINDING_STATUSES)
187
- list_findings.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
287
+ list_findings.add_argument("--offset", type=non_negative_int, default=0)
188
288
  list_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
189
289
 
190
290
  update_progress = add_command("update-progress", "--scan-id")
291
+ update_progress.add_argument("--model-thread-id")
191
292
  update_progress.add_argument("--phase", choices=PHASES)
192
- update_progress.add_argument("--phase-items-total", type=deep_scan.non_negative_int)
193
- update_progress.add_argument("--phase-items-completed", type=deep_scan.non_negative_int)
293
+ update_progress.add_argument("--phase-items-total", type=non_negative_int)
294
+ update_progress.add_argument("--phase-items-completed", type=non_negative_int)
194
295
  update_progress.add_argument("--phase-progress-unit", choices=PHASE_PROGRESS_UNITS)
195
- update_progress.add_argument("--review-items-total", type=deep_scan.non_negative_int)
196
- update_progress.add_argument("--review-items-completed", type=deep_scan.non_negative_int)
197
- update_progress.add_argument("--reportable-findings-count", type=deep_scan.non_negative_int)
296
+ update_progress.add_argument("--review-items-total", type=non_negative_int)
297
+ update_progress.add_argument("--review-items-completed", type=non_negative_int)
298
+ update_progress.add_argument("--reportable-findings-count", type=non_negative_int)
198
299
  update_progress.add_argument("--deep-review-pass", type=positive_int)
199
300
  update_progress.add_argument("--claim-token")
200
301
  update_progress.add_argument("--coordinator-generation", type=positive_int)
@@ -205,6 +306,7 @@ def parse_args(description: str) -> argparse.Namespace:
205
306
  prepare_scan_completion.add_argument("--claim-token")
206
307
 
207
308
  complete_scan = add_command("complete-scan", "--scan-id")
309
+ complete_scan.add_argument("--model-thread-id")
208
310
  complete_scan.add_argument("--claim-token")
209
311
  complete_scan.add_argument("--cost-json")
210
312
  complete_scan.add_argument("--thread-id")
@@ -224,8 +326,10 @@ def parse_args(description: str) -> argparse.Namespace:
224
326
 
225
327
  cancel_scan = add_command("cancel-scan", "--scan-id")
226
328
  cancel_scan.add_argument("--thread-id")
329
+ cancel_scan.add_argument("--cost-json")
227
330
 
228
331
  fail_scan = add_command("fail-scan", "--scan-id", "--message")
332
+ fail_scan.add_argument("--model-thread-id")
229
333
  fail_scan.add_argument("--claim-token")
230
334
  fail_scan.add_argument("--cost-json")
231
335
 
@@ -241,11 +345,13 @@ def parse_args(description: str) -> argparse.Namespace:
241
345
  recover_scan.add_argument("--scan-id", required=True, help="ID of the stopped scan to recover.")
242
346
 
243
347
  write_scan_draft = add_command("write-scan-draft", "--scan-id", "--draft-path")
348
+ write_scan_draft.add_argument("--model-thread-id")
244
349
  write_scan_draft.add_argument("--checkpoint-path")
245
350
  write_scan_draft.add_argument("--expected-draft-digest")
246
351
  write_scan_draft.add_argument("--claim-token")
247
352
 
248
353
  save_scan_artifact = add_command("save-scan-artifact", "--scan-id", "--artifact-path")
354
+ save_scan_artifact.add_argument("--model-thread-id")
249
355
  save_scan_artifact.add_argument("--claim-token")
250
356
 
251
357
  for command in ("save-artifact", "read-artifact"):
@@ -294,7 +400,9 @@ def parse_args(description: str) -> argparse.Namespace:
294
400
  set_finding_remediation.add_argument(
295
401
  "--state", choices=REMEDIATION_UPDATE_STATES, required=True
296
402
  )
403
+ set_finding_remediation.add_argument("--assigned-finding", action="store_true")
297
404
  set_finding_remediation.add_argument("--summary")
405
+ set_finding_remediation.add_argument("--patch-stdin", action="store_true")
298
406
  set_finding_remediation.add_argument("--patch-path")
299
407
  set_finding_remediation.add_argument("--patch-digest")
300
408
  set_finding_remediation.add_argument("--base-revision")
@@ -311,7 +419,6 @@ def parse_args(description: str) -> argparse.Namespace:
311
419
 
312
420
  subparsers.add_parser("database-info")
313
421
  subparsers.add_parser("finding-workflow")
314
- subparsers.add_parser("local-dedupe")
315
422
  args = parser.parse_args()
316
423
  if getattr(args, "user_context_stdin", False):
317
424
  args.user_context = sys.stdin.buffer.read().decode("utf-8")
@@ -36,6 +36,14 @@ FINDING_ATTACK_PATH_PREVIEW_BYTES = 4_000
36
36
  FINDING_CODE_EVIDENCE_LIMIT = 4
37
37
  FINDING_CODE_EVIDENCE_SNIPPET_BYTES = 1_500
38
38
  FINDING_EVIDENCE_EXCERPT_BYTES = 8_000
39
+ FINDING_LOCATION_ORDER_SQL = "CASE WHEN role = 'root_control' THEN 0 ELSE 1 END, sort_order"
40
+ # The outer query binds finding_occurrences as occurrences.
41
+ PRIMARY_FINDING_LOCATION_SQL = f"""
42
+ FROM finding_locations
43
+ WHERE occurrence_id = occurrences.id
44
+ ORDER BY {FINDING_LOCATION_ORDER_SQL}
45
+ LIMIT 1
46
+ """
39
47
  FINDING_LOCATIONS_LIMIT = 8
40
48
  FINDING_TITLE_BYTES = 512
41
49
  FINDING_SUMMARY_BYTES = 2_000
@@ -62,7 +70,18 @@ EMPTY_GIT_TREES = {
62
70
  }
63
71
 
64
72
 
73
+ def optional_text(value: str | None, *, maximum: int | None = None) -> str | None:
74
+ """Strip surrounding whitespace, return None for blank text, and enforce the character limit."""
75
+ if value is None:
76
+ return None
77
+ normalized = value.strip()
78
+ if maximum is not None and len(normalized) > maximum:
79
+ raise SystemExit(f"Text value must be no longer than {maximum} characters.")
80
+ return normalized or None
81
+
82
+
65
83
  def positive_int(value: str) -> int:
84
+ """Parse a CLI count and reject values below one with an argparse validation error."""
66
85
  parsed = int(value)
67
86
  if parsed < 1:
68
87
  raise argparse.ArgumentTypeError("expected a positive integer")
@@ -10,6 +10,7 @@ from typing import Any
10
10
 
11
11
  from finalize_scan_contract import (
12
12
  ContractError,
13
+ MissingScanLocalFileError,
13
14
  _require_portable_relative_path,
14
15
  _require_str,
15
16
  _validate_schema_node,
@@ -108,6 +109,7 @@ def retain_recorded_receipt_ownership(
108
109
  def resolve_coverage_receipts(
109
110
  scan_dir: Path, item: dict[str, Any], worker: Any, relative: str
110
111
  ) -> Any:
112
+ """Qualify worker receipt references relative to their source checkpoint for use in parent coverage."""
111
113
  refs = item.get("receiptRefs", [])
112
114
  if not isinstance(refs, list):
113
115
  return refs
@@ -397,9 +399,7 @@ def _generic_surface_updates(
397
399
  for ref in previous_refs if isinstance(previous_refs, list) else []:
398
400
  if ref not in refs:
399
401
  failure = receipt_error(ref) if repaired else None
400
- replaceable = failure is not None and isinstance(
401
- failure.__cause__, FileNotFoundError
402
- )
402
+ replaceable = isinstance(failure, MissingScanLocalFileError)
403
403
  if repaired and isinstance(ref, str):
404
404
  try:
405
405
  normalized = _require_portable_relative_path(