@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
@@ -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 (
@@ -2,11 +2,19 @@
2
2
 
3
3
  from __future__ import annotations
4
4
 
5
+ import hashlib
5
6
  import os
7
+ import sqlite3
8
+ import tempfile
6
9
  from pathlib import Path
10
+ from typing import Any
11
+
12
+ if os.name == "nt":
13
+ import windows_scan_local_files as windows_files
7
14
 
8
15
 
9
16
  def state_dir(*, canonical: bool = True) -> Path:
17
+ """Return the workbench state path, resolving symlinks unless canonical is false."""
10
18
  configured = os.environ.get("CODEX_SECURITY_STATE_DIR")
11
19
  if configured:
12
20
  path = Path(configured).expanduser()
@@ -19,15 +27,91 @@ def state_dir(*, canonical: bool = True) -> Path:
19
27
 
20
28
 
21
29
  def resolve_scan_root(scan_root: str | None) -> Path:
30
+ """Resolve an explicit scan output root, defaulting to the scans directory under workbench state."""
22
31
  return Path(scan_root).expanduser().resolve() if scan_root else state_dir() / "scans"
23
32
 
24
33
 
25
- def create_private_directory(path: Path) -> None:
34
+ def worker_usage_directory(scan_id: str) -> Path:
35
+ """Bind host-observed receipts beneath the persistent protected native home."""
36
+ return state_dir() / "codex-home" / "worker-usage" / scan_id
37
+
38
+
39
+ def short_archive_prefix(original_name: str) -> str:
40
+ """Bind a short archive name to the complete original filename."""
41
+ return f".previous-{hashlib.sha256(os.fsencode(original_name)).hexdigest()}-"
42
+
43
+
44
+ def archive_source_directory(archive: Path, source: Path) -> Path | None:
45
+ """Return the original sibling when the archived name identifies it."""
46
+ if not source.is_relative_to(archive.parent):
47
+ return None
48
+ parts = source.relative_to(archive.parent).parts
49
+ if not parts or ".." in parts:
50
+ return None
51
+ name = parts[0]
52
+ if archive.name.startswith(f"{name}.previous-") or (
53
+ archive.name.startswith(".previous-")
54
+ and archive.name.startswith(short_archive_prefix(name))
55
+ ):
56
+ return archive.parent / name
57
+ return None
58
+
59
+
60
+ def archived_deep_path(scan_dir: Path, value: str | None) -> str | None:
61
+ """Resolve old archive rows that still name the original sibling output."""
62
+ if value is None or ".previous-" not in scan_dir.name:
63
+ return value
64
+ path = Path(value)
65
+ original = archive_source_directory(scan_dir, path)
66
+ if original is None:
67
+ return value
68
+ # Keep missing files inside the archive too. Never follow the replacement scan's output.
69
+ return str(scan_dir / path.relative_to(original))
70
+
71
+
72
+ def saved_deep_workers(connection: sqlite3.Connection, scan: sqlite3.Row) -> list[Any]:
73
+ workers = connection.execute(
74
+ "SELECT * FROM deep_scan_workers WHERE scan_id = ? ORDER BY created_at, id",
75
+ (scan["id"],),
76
+ ).fetchall()
77
+ scan_dir = Path(scan["scan_dir"])
78
+ if ".previous-" not in scan_dir.name:
79
+ return workers
80
+ return [
81
+ {
82
+ **worker,
83
+ **{
84
+ key: archived_deep_path(scan_dir, worker[key])
85
+ for key in ("artifact_dir", "prompt_path", "result_manifest_path")
86
+ },
87
+ }
88
+ for worker in workers
89
+ ]
90
+
91
+
92
+ def create_private_directory(path: Path, *, scan_output: bool = False) -> None:
26
93
  """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)
94
+ if path.parent != path and not path.parent.is_dir():
95
+ create_private_directory(path.parent, scan_output=scan_output)
96
+ if os.name != "nt":
33
97
  path.mkdir(mode=0o700, exist_ok=True)
98
+ elif not path.is_dir():
99
+ windows_files.create_private_directory(path, exist_ok=True, scan_output=scan_output)
100
+ elif scan_output:
101
+ windows_files.require_windows_output_path(path)
102
+
103
+
104
+ def create_private_temporary_directory(parent: Path, *, prefix: str) -> Path:
105
+ """Create a unique private child without inheriting a permissive Windows DACL."""
106
+ if os.name != "nt":
107
+ return Path(tempfile.mkdtemp(prefix=prefix, dir=parent)).resolve()
108
+
109
+ import secrets
110
+
111
+ for _ in range(100):
112
+ path = parent / f"{prefix}{secrets.token_hex(4)}"
113
+ try:
114
+ return windows_files.create_private_directory(path, exist_ok=False, scan_output=True)
115
+ except FileExistsError:
116
+ continue
117
+ raise FileExistsError(f"Could not create a unique directory beneath {parent}.")
@@ -37,6 +37,11 @@ def add_user_context(parser: argparse.ArgumentParser, *, required: bool = False)
37
37
 
38
38
 
39
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
+ """
40
45
  parser = argparse.ArgumentParser(description=description)
41
46
  subparsers = parser.add_subparsers(dest="command", required=True)
42
47
 
@@ -112,6 +117,7 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
112
117
  )
113
118
 
114
119
  begin_deep_scan = add_command("begin-deep-scan", "--thread-id")
120
+ begin_deep_scan.add_argument("--model-thread-id")
115
121
  begin_target = begin_deep_scan.add_mutually_exclusive_group(required=True)
116
122
  begin_target.add_argument("--scan-id")
117
123
  begin_target.add_argument("--target-path")
@@ -149,24 +155,20 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
149
155
  upsert_deep_worker.add_argument("--attempt", type=non_negative_int)
150
156
  upsert_deep_worker.add_argument("--sdk-thread-id")
151
157
  upsert_deep_worker.add_argument("--error-message")
158
+ upsert_deep_worker.add_argument("--terminal-failure", action="store_true")
152
159
  upsert_deep_worker.add_argument(
153
160
  "--replaceable-failure-kind",
154
161
  choices=("policy_refusal", "transient_error", "invalid_discovery_artifacts"),
155
162
  )
156
163
  upsert_deep_worker.add_argument("--coordinator-generation", type=positive_int)
157
164
 
158
- claim_deep_dedup = add_command(
159
- "claim-deep-scan-dedup", "--scan-id", "--worker-id", "--prompt-path", "--artifact-dir"
160
- )
161
- claim_deep_dedup.add_argument("--input-worker-id", action="append", required=True)
162
- claim_deep_dedup.add_argument("--coordinator-generation", type=positive_int)
163
-
164
- commit_deep_dedup = add_command(
165
- "commit-deep-scan-dedup", "--scan-id", "--worker-id", "--result-manifest-path"
165
+ iteration = add_command(
166
+ "record-deep-scan-iteration", "--scan-id", "--worker-id", "--result-manifest-path"
166
167
  )
167
- commit_deep_dedup.add_argument("--candidate-ledger-path")
168
- commit_deep_dedup.add_argument("--new-findings-count", type=non_negative_int, required=True)
169
- commit_deep_dedup.add_argument("--coordinator-generation", type=positive_int)
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)
170
172
 
171
173
  finish_deep_scan = add_command("finish-deep-scan", "--scan-id")
172
174
  finish_deep_scan.add_argument(
@@ -191,11 +193,20 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
191
193
  publication_failure.add_argument("--coordinator-generation", type=positive_int)
192
194
 
193
195
  get_scan = add_command("get-scan", "--scan-id")
194
- 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")
195
203
  get_scan.add_argument("--check-target", action="store_true")
196
204
 
197
205
  add_command("rename-scan", "--scan-id", "--name")
198
206
 
207
+ read_scan_usage = add_command("read-scan-usage", "--scan-id", "--thread-id")
208
+ read_scan_usage.add_argument("--validation-thread-id")
209
+
199
210
  add_command("get-scan-feedback", "--scan-id")
200
211
 
201
212
  update_scan_context = add_command("update-scan-context", "--scan-id")
@@ -211,11 +222,15 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
211
222
  list_scans.add_argument("--status", choices=("running", "complete", "failed", "canceled"))
212
223
  list_scans.add_argument("--mode", choices=MODES)
213
224
  list_scans.add_argument("--repository")
225
+ list_scans.add_argument(
226
+ "--prefer-worktree", action="store_true", help="List scans from this checkout first."
227
+ )
214
228
  list_scans.add_argument("--scan-root")
215
229
  list_scans.add_argument("--offset", type=non_negative_int, default=0)
216
230
  list_scans.add_argument("--limit", type=positive_int)
217
231
 
218
232
  list_unmatched_scan_pairs = add_command("list-unmatched-scan-pairs", "--repository")
233
+ list_unmatched_scan_pairs.add_argument("--after-scan-id")
219
234
  list_unmatched_scan_pairs.add_argument("--force", action="store_true")
220
235
 
221
236
  register_cli_scan = add_command("register-cli-scan", "--scan-dir", "--repository")
@@ -231,7 +246,17 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
231
246
  )
232
247
  register_cli_scan.add_argument("--archived-scan-dir")
233
248
 
234
- add_command("set-scan-thread", "--scan-id", "--thread-id")
249
+ restore_cli_scan_archive = subparsers.add_parser("restore-cli-scan-archive")
250
+ restore_cli_scan_archive.add_argument("--scan-dir", required=True)
251
+ restore_cli_scan_archive.add_argument("--archived-scan-dir", required=True)
252
+ previous_scan = restore_cli_scan_archive.add_mutually_exclusive_group(required=True)
253
+ previous_scan.add_argument("--previous-scan-id")
254
+ previous_scan.add_argument("--previous-scan-absent", action="store_true")
255
+
256
+ set_scan_thread = subparsers.add_parser("set-scan-thread")
257
+ set_scan_thread.add_argument("--scan-id", required=True)
258
+ set_scan_thread.add_argument("--thread-id", required=True)
259
+ set_scan_thread.add_argument("--time-budget-started-at")
235
260
 
236
261
  set_scan_cost_limit = add_command("set-scan-cost-limit", "--scan-id")
237
262
  set_scan_cost_limit.add_argument("--max-cost-usd", required=True, type=float)
@@ -259,7 +284,9 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
259
284
  list_global_findings.add_argument("--query")
260
285
  list_global_findings.add_argument("--severity", choices=FINDING_SEVERITIES)
261
286
  list_global_findings.add_argument("--status", choices=FINDING_STATUSES)
262
- list_global_findings.add_argument("--target-id")
287
+ finding_repository = list_global_findings.add_mutually_exclusive_group()
288
+ finding_repository.add_argument("--target-id")
289
+ finding_repository.add_argument("--repository")
263
290
  list_global_findings.add_argument("--offset", type=non_negative_int, default=0)
264
291
  list_global_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
265
292
  list_repositories = subparsers.add_parser("list-repositories")
@@ -277,6 +304,11 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
277
304
  list_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
278
305
 
279
306
  update_progress = add_command("update-progress", "--scan-id")
307
+ update_progress.add_argument("--model-update", action="store_true")
308
+ update_progress.add_argument(
309
+ "--refresh-scope-file-count", action="store_true", help=argparse.SUPPRESS
310
+ )
311
+ update_progress.add_argument("--model-thread-id")
280
312
  update_progress.add_argument("--phase", choices=PHASES)
281
313
  update_progress.add_argument("--phase-items-total", type=non_negative_int)
282
314
  update_progress.add_argument("--phase-items-completed", type=non_negative_int)
@@ -294,6 +326,7 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
294
326
  prepare_scan_completion.add_argument("--claim-token")
295
327
 
296
328
  complete_scan = add_command("complete-scan", "--scan-id")
329
+ complete_scan.add_argument("--model-thread-id")
297
330
  complete_scan.add_argument("--claim-token")
298
331
  complete_scan.add_argument("--cost-json")
299
332
  complete_scan.add_argument("--thread-id")
@@ -313,8 +346,10 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
313
346
 
314
347
  cancel_scan = add_command("cancel-scan", "--scan-id")
315
348
  cancel_scan.add_argument("--thread-id")
349
+ cancel_scan.add_argument("--cost-json")
316
350
 
317
351
  fail_scan = add_command("fail-scan", "--scan-id", "--message")
352
+ fail_scan.add_argument("--model-thread-id")
318
353
  fail_scan.add_argument("--claim-token")
319
354
  fail_scan.add_argument("--cost-json")
320
355
 
@@ -330,11 +365,13 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
330
365
  recover_scan.add_argument("--scan-id", required=True, help="ID of the stopped scan to recover.")
331
366
 
332
367
  write_scan_draft = add_command("write-scan-draft", "--scan-id", "--draft-path")
368
+ write_scan_draft.add_argument("--model-thread-id")
333
369
  write_scan_draft.add_argument("--checkpoint-path")
334
370
  write_scan_draft.add_argument("--expected-draft-digest")
335
371
  write_scan_draft.add_argument("--claim-token")
336
372
 
337
373
  save_scan_artifact = add_command("save-scan-artifact", "--scan-id", "--artifact-path")
374
+ save_scan_artifact.add_argument("--model-thread-id")
338
375
  save_scan_artifact.add_argument("--claim-token")
339
376
 
340
377
  for command in ("save-artifact", "read-artifact"):
@@ -342,6 +379,8 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
342
379
 
343
380
  mark_handoff_delivered = add_command("mark-handoff-delivered", "--scan-id", "--claim-token")
344
381
  mark_handoff_delivered.add_argument("--thread-id")
382
+ mark_handoff_delivered.add_argument("--return-context", action="store_true")
383
+ mark_handoff_delivered.add_argument("--occurrence-id")
345
384
 
346
385
  claim_handoff_delivery = add_command("claim-handoff-delivery", "--scan-id", "--claim-token")
347
386
  claim_handoff_delivery.add_argument("--take-over-stale", action="store_true")
@@ -383,6 +422,7 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
383
422
  set_finding_remediation.add_argument(
384
423
  "--state", choices=REMEDIATION_UPDATE_STATES, required=True
385
424
  )
425
+ set_finding_remediation.add_argument("--assigned-finding", action="store_true")
386
426
  set_finding_remediation.add_argument("--summary")
387
427
  set_finding_remediation.add_argument("--patch-stdin", action="store_true")
388
428
  set_finding_remediation.add_argument("--patch-path")
@@ -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
@@ -50,6 +58,8 @@ GIT_REPOSITORY_ENVIRONMENT = (
50
58
  "GIT_COMMON_DIR",
51
59
  "GIT_DIR",
52
60
  "GIT_DISCOVERY_ACROSS_FILESYSTEM",
61
+ "GIT_GLOB_PATHSPECS",
62
+ "GIT_ICASE_PATHSPECS",
53
63
  "GIT_INDEX_FILE",
54
64
  "GIT_NAMESPACE",
55
65
  "GIT_OBJECT_DIRECTORY",
@@ -63,6 +73,7 @@ EMPTY_GIT_TREES = {
63
73
 
64
74
 
65
75
  def optional_text(value: str | None, *, maximum: int | None = None) -> str | None:
76
+ """Strip surrounding whitespace, return None for blank text, and enforce the character limit."""
66
77
  if value is None:
67
78
  return None
68
79
  normalized = value.strip()
@@ -72,6 +83,7 @@ def optional_text(value: str | None, *, maximum: int | None = None) -> str | Non
72
83
 
73
84
 
74
85
  def positive_int(value: str) -> int:
86
+ """Parse a CLI count and reject values below one with an argparse validation error."""
75
87
  parsed = int(value)
76
88
  if parsed < 1:
77
89
  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(