@openai/codex-security 0.8.1 → 0.8.3

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 (396) hide show
  1. package/README.md +45 -57
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +1 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  5. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  6. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +4 -4
  7. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  14. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  15. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +46 -12
  16. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  17. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  18. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  19. package/_bundled_plugin/references/artifact-storage.md +1 -1
  20. package/_bundled_plugin/references/core-scan.md +14 -5
  21. package/_bundled_plugin/references/default-severity-rubric.md +28 -0
  22. package/_bundled_plugin/references/finding-detail-fields.md +1 -0
  23. package/_bundled_plugin/references/threat-model.md +1 -0
  24. package/_bundled_plugin/scripts/deep_scan_workbench.py +23 -112
  25. package/_bundled_plugin/scripts/finalize_scan_contract.py +167 -153
  26. package/_bundled_plugin/scripts/finding_preview.py +5 -29
  27. package/_bundled_plugin/scripts/posix_scan_local_files.py +187 -0
  28. package/_bundled_plugin/scripts/report_projection.py +87 -136
  29. package/_bundled_plugin/scripts/validate_scan_contract.py +2 -6
  30. package/_bundled_plugin/scripts/windows_scan_local_files.py +212 -55
  31. package/_bundled_plugin/scripts/workbench/retained_coverage.py +8 -24
  32. package/_bundled_plugin/scripts/workbench/saved_coverage.py +143 -231
  33. package/_bundled_plugin/scripts/workbench_cli.py +102 -13
  34. package/_bundled_plugin/scripts/workbench_constants.py +9 -0
  35. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +0 -17
  36. package/_bundled_plugin/scripts/workbench_db.py +187 -363
  37. package/_bundled_plugin/scripts/workbench_finding_workflows.py +86 -4
  38. package/_bundled_plugin/scripts/workbench_native_indexes.py +17 -21
  39. package/_bundled_plugin/scripts/workbench_remediation.py +495 -11
  40. package/_bundled_plugin/scripts/workbench_saved_results.py +0 -66
  41. package/_bundled_plugin/scripts/workbench_scan_history.py +22 -25
  42. package/_bundled_plugin/scripts/workbench_scan_start.py +1 -1
  43. package/_bundled_plugin/scripts/workbench_scan_usage.py +25 -52
  44. package/_bundled_plugin/scripts/workbench_schema.py +1 -1
  45. package/_bundled_plugin/scripts/workbench_setup.py +239 -0
  46. package/_bundled_plugin/scripts/workbench_source_scopes.py +15 -23
  47. package/_bundled_plugin/scripts/workbench_target.py +120 -35
  48. package/_bundled_plugin/scripts/workbench_validation.py +1 -9
  49. package/_bundled_plugin/shared/workbench-history-repairs.json +7 -0
  50. package/_bundled_plugin/shared/workbench-migrations.json +19 -0
  51. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  52. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  53. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  54. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  55. package/_bundled_plugin/skills/cloud-findings/SKILL.md +2 -0
  56. package/_bundled_plugin/skills/fix-finding/SKILL.md +18 -1
  57. package/_bundled_plugin/skills/publish-findings/SKILL.md +68 -35
  58. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +2 -21
  59. package/_bundled_plugin/skills/resolve-dependency-alert/SKILL.md +18 -0
  60. package/_bundled_plugin/skills/resolve-dependency-alert/agents/openai.yaml +4 -0
  61. package/_bundled_plugin/skills/threat-model-visualize/SKILL.md +83 -0
  62. package/_bundled_plugin/skills/threat-model-visualize/agents/openai.yaml +4 -0
  63. package/_bundled_plugin/skills/threat-model-visualize/assets/context-reference-overview.svg +366 -0
  64. package/_bundled_plugin/skills/threat-model-visualize/assets/context-reference-path.svg +558 -0
  65. package/_bundled_plugin/skills/threat-model-visualize/assets/control-effects.js +85 -0
  66. package/_bundled_plugin/skills/threat-model-visualize/assets/explorer.css +17 -0
  67. package/_bundled_plugin/skills/threat-model-visualize/assets/explorer.html +38 -0
  68. package/_bundled_plugin/skills/threat-model-visualize/assets/explorer.js +372 -0
  69. package/_bundled_plugin/skills/threat-model-visualize/assets/route-paths.js +71 -0
  70. package/_bundled_plugin/skills/threat-model-visualize/assets/source-roles.js +47 -0
  71. package/_bundled_plugin/skills/threat-model-visualize/assets/svg-layout.js +149 -0
  72. package/_bundled_plugin/skills/threat-model-visualize/references/context-explorer.md +21 -0
  73. package/_bundled_plugin/skills/threat-model-visualize/references/view-model.md +49 -0
  74. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +569 -0
  75. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  76. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  77. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -4
  78. package/dist/api.d.ts +6 -1
  79. package/dist/api.d.ts.map +1 -1
  80. package/dist/api.js +414 -163
  81. package/dist/api.js.map +1 -1
  82. package/dist/auth.js +7 -2
  83. package/dist/auth.js.map +1 -1
  84. package/dist/blackduck-findings.d.ts +8 -0
  85. package/dist/blackduck-findings.d.ts.map +1 -0
  86. package/dist/blackduck-findings.js +305 -0
  87. package/dist/blackduck-findings.js.map +1 -0
  88. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  89. package/dist/bulk-scan-discovery.js +51 -36
  90. package/dist/bulk-scan-discovery.js.map +1 -1
  91. package/dist/classify-severity-records.d.ts +5 -0
  92. package/dist/classify-severity-records.d.ts.map +1 -1
  93. package/dist/classify-severity-records.js +6 -8
  94. package/dist/classify-severity-records.js.map +1 -1
  95. package/dist/classify-severity.d.ts +4 -1
  96. package/dist/classify-severity.d.ts.map +1 -1
  97. package/dist/classify-severity.js +28 -9
  98. package/dist/classify-severity.js.map +1 -1
  99. package/dist/cli.d.ts +3 -0
  100. package/dist/cli.d.ts.map +1 -1
  101. package/dist/cli.js +635 -266
  102. package/dist/cli.js.map +1 -1
  103. package/dist/codex-prompt.d.ts +2 -0
  104. package/dist/codex-prompt.d.ts.map +1 -1
  105. package/dist/codex-prompt.js +6 -0
  106. package/dist/codex-prompt.js.map +1 -1
  107. package/dist/component-scan.d.ts.map +1 -1
  108. package/dist/component-scan.js +6 -5
  109. package/dist/component-scan.js.map +1 -1
  110. package/dist/config.d.ts +2 -1
  111. package/dist/config.d.ts.map +1 -1
  112. package/dist/config.js +162 -40
  113. package/dist/config.js.map +1 -1
  114. package/dist/continuum-findings.d.ts +7 -0
  115. package/dist/continuum-findings.d.ts.map +1 -0
  116. package/dist/continuum-findings.js +157 -0
  117. package/dist/continuum-findings.js.map +1 -0
  118. package/dist/contract-values.d.ts +28 -0
  119. package/dist/contract-values.d.ts.map +1 -0
  120. package/dist/contract-values.js +75 -0
  121. package/dist/contract-values.js.map +1 -0
  122. package/dist/contract.d.ts +2 -20
  123. package/dist/contract.d.ts.map +1 -1
  124. package/dist/contract.js +58 -669
  125. package/dist/contract.js.map +1 -1
  126. package/dist/cost-model.d.ts.map +1 -1
  127. package/dist/cost-model.js +1 -4
  128. package/dist/cost-model.js.map +1 -1
  129. package/dist/cost.d.ts +19 -1
  130. package/dist/cost.d.ts.map +1 -1
  131. package/dist/cost.js +2120 -39
  132. package/dist/cost.js.map +1 -1
  133. package/dist/custom-validation-prompt.d.ts +1 -1
  134. package/dist/custom-validation-prompt.d.ts.map +1 -1
  135. package/dist/custom-validation-prompt.js +5 -0
  136. package/dist/custom-validation-prompt.js.map +1 -1
  137. package/dist/custom-validation.d.ts +2 -0
  138. package/dist/custom-validation.d.ts.map +1 -1
  139. package/dist/custom-validation.js +6 -2
  140. package/dist/custom-validation.js.map +1 -1
  141. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  142. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  143. package/dist/deduplication/deduplication-prompts.js +2 -2
  144. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  145. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  146. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  147. package/dist/deduplication/deduplication-reviewer.js +12 -5
  148. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  149. package/dist/deduplication/deduplication.js.map +1 -1
  150. package/dist/deduplication/finding-schema.d.ts +19 -1
  151. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  152. package/dist/deduplication/finding-schema.js +25 -0
  153. package/dist/deduplication/finding-schema.js.map +1 -1
  154. package/dist/deduplication/local.d.ts.map +1 -1
  155. package/dist/deduplication/local.js +3 -8
  156. package/dist/deduplication/local.js.map +1 -1
  157. package/dist/deduplication/records.d.ts +11 -3
  158. package/dist/deduplication/records.d.ts.map +1 -1
  159. package/dist/deduplication/records.js +48 -16
  160. package/dist/deduplication/records.js.map +1 -1
  161. package/dist/deep-scan.d.ts +11 -0
  162. package/dist/deep-scan.d.ts.map +1 -1
  163. package/dist/deep-scan.js +235 -4
  164. package/dist/deep-scan.js.map +1 -1
  165. package/dist/default-severity-rubric.d.ts +1 -2
  166. package/dist/default-severity-rubric.d.ts.map +1 -1
  167. package/dist/default-severity-rubric.js +2 -66
  168. package/dist/default-severity-rubric.js.map +1 -1
  169. package/dist/endor-findings.d.ts.map +1 -1
  170. package/dist/endor-findings.js +44 -89
  171. package/dist/endor-findings.js.map +1 -1
  172. package/dist/errors.js +1 -1
  173. package/dist/errors.js.map +1 -1
  174. package/dist/external-findings-import.d.ts.map +1 -1
  175. package/dist/external-findings-import.js +11 -15
  176. package/dist/external-findings-import.js.map +1 -1
  177. package/dist/external-findings-local.d.ts +12 -1
  178. package/dist/external-findings-local.d.ts.map +1 -1
  179. package/dist/external-findings-local.js +411 -184
  180. package/dist/external-findings-local.js.map +1 -1
  181. package/dist/external-findings-publish.d.ts +15 -1
  182. package/dist/external-findings-publish.d.ts.map +1 -1
  183. package/dist/external-findings-publish.js +1238 -226
  184. package/dist/external-findings-publish.js.map +1 -1
  185. package/dist/external-findings-read.d.ts +10 -0
  186. package/dist/external-findings-read.d.ts.map +1 -1
  187. package/dist/external-findings-read.js +71 -51
  188. package/dist/external-findings-read.js.map +1 -1
  189. package/dist/external-findings.d.ts +13 -0
  190. package/dist/external-findings.d.ts.map +1 -1
  191. package/dist/external-findings.js +124 -1
  192. package/dist/external-findings.js.map +1 -1
  193. package/dist/external-import-contract.d.ts +29 -1
  194. package/dist/external-import-contract.d.ts.map +1 -1
  195. package/dist/external-import-contract.js +314 -44
  196. package/dist/external-import-contract.js.map +1 -1
  197. package/dist/external-import-models.d.ts +1 -1
  198. package/dist/external-import-models.d.ts.map +1 -1
  199. package/dist/external-import-models.js.map +1 -1
  200. package/dist/finding-normalization.d.ts +1 -1
  201. package/dist/finding-normalization.d.ts.map +1 -1
  202. package/dist/finding-normalization.js +46 -11
  203. package/dist/finding-normalization.js.map +1 -1
  204. package/dist/finding-retrieval.d.ts +3 -3
  205. package/dist/finding-retrieval.d.ts.map +1 -1
  206. package/dist/finding-retrieval.js.map +1 -1
  207. package/dist/finding-workflow.d.ts +6 -1
  208. package/dist/finding-workflow.d.ts.map +1 -1
  209. package/dist/finding-workflow.js +2 -2
  210. package/dist/finding-workflow.js.map +1 -1
  211. package/dist/git-remote.d.ts +4 -0
  212. package/dist/git-remote.d.ts.map +1 -1
  213. package/dist/git-remote.js +20 -0
  214. package/dist/git-remote.js.map +1 -1
  215. package/dist/github-advisories.d.ts +3 -12
  216. package/dist/github-advisories.d.ts.map +1 -1
  217. package/dist/github-advisories.js +9 -29
  218. package/dist/github-advisories.js.map +1 -1
  219. package/dist/github-dependabot-findings.d.ts.map +1 -1
  220. package/dist/github-dependabot-findings.js +7 -16
  221. package/dist/github-dependabot-findings.js.map +1 -1
  222. package/dist/github-findings.d.ts.map +1 -1
  223. package/dist/github-findings.js +344 -56
  224. package/dist/github-findings.js.map +1 -1
  225. package/dist/github.d.ts +17 -7
  226. package/dist/github.d.ts.map +1 -1
  227. package/dist/github.js +43 -30
  228. package/dist/github.js.map +1 -1
  229. package/dist/host-protocol.d.ts +7 -2
  230. package/dist/host-protocol.d.ts.map +1 -1
  231. package/dist/host-protocol.js +27 -3
  232. package/dist/host-protocol.js.map +1 -1
  233. package/dist/host-records-protocol.d.ts +10 -11
  234. package/dist/host-records-protocol.d.ts.map +1 -1
  235. package/dist/host-records-protocol.js +69 -9
  236. package/dist/host-records-protocol.js.map +1 -1
  237. package/dist/hosted-scan.d.ts +15 -0
  238. package/dist/hosted-scan.d.ts.map +1 -1
  239. package/dist/hosted-scan.js +55 -33
  240. package/dist/hosted-scan.js.map +1 -1
  241. package/dist/index.d.ts +8 -0
  242. package/dist/index.d.ts.map +1 -1
  243. package/dist/index.js +7 -0
  244. package/dist/index.js.map +1 -1
  245. package/dist/inspector-findings.d.ts +9 -0
  246. package/dist/inspector-findings.d.ts.map +1 -0
  247. package/dist/inspector-findings.js +512 -0
  248. package/dist/inspector-findings.js.map +1 -0
  249. package/dist/knowledge-base.js +18 -5
  250. package/dist/knowledge-base.js.map +1 -1
  251. package/dist/local-git-metadata.d.ts +5 -0
  252. package/dist/local-git-metadata.d.ts.map +1 -0
  253. package/dist/local-git-metadata.js +131 -0
  254. package/dist/local-git-metadata.js.map +1 -0
  255. package/dist/multiscan.d.ts.map +1 -1
  256. package/dist/multiscan.js +22 -12
  257. package/dist/multiscan.js.map +1 -1
  258. package/dist/opengrep-findings.d.ts.map +1 -1
  259. package/dist/opengrep-findings.js +34 -20
  260. package/dist/opengrep-findings.js.map +1 -1
  261. package/dist/patch-tui.d.ts +1 -1
  262. package/dist/patch-tui.d.ts.map +1 -1
  263. package/dist/patch-tui.js +94 -36
  264. package/dist/patch-tui.js.map +1 -1
  265. package/dist/private-finding-import.d.ts +246 -0
  266. package/dist/private-finding-import.d.ts.map +1 -0
  267. package/dist/private-finding-import.js +387 -0
  268. package/dist/private-finding-import.js.map +1 -0
  269. package/dist/project-config.d.ts.map +1 -1
  270. package/dist/project-config.js +2 -2
  271. package/dist/project-config.js.map +1 -1
  272. package/dist/provider-profile.d.ts +10 -2
  273. package/dist/provider-profile.d.ts.map +1 -1
  274. package/dist/provider-profile.js +72 -10
  275. package/dist/provider-profile.js.map +1 -1
  276. package/dist/publication.js +7 -1
  277. package/dist/publication.js.map +1 -1
  278. package/dist/reader-selection.d.ts +13 -0
  279. package/dist/reader-selection.d.ts.map +1 -0
  280. package/dist/reader-selection.js +81 -0
  281. package/dist/reader-selection.js.map +1 -0
  282. package/dist/record.d.ts +6 -1
  283. package/dist/record.d.ts.map +1 -1
  284. package/dist/record.js +53 -2
  285. package/dist/record.js.map +1 -1
  286. package/dist/remediation.d.ts +5 -0
  287. package/dist/remediation.d.ts.map +1 -1
  288. package/dist/remediation.js +30 -0
  289. package/dist/remediation.js.map +1 -1
  290. package/dist/result.d.ts +2 -0
  291. package/dist/result.d.ts.map +1 -1
  292. package/dist/result.js +3 -1
  293. package/dist/result.js.map +1 -1
  294. package/dist/runtime.d.ts +5 -3
  295. package/dist/runtime.d.ts.map +1 -1
  296. package/dist/runtime.js +110 -57
  297. package/dist/runtime.js.map +1 -1
  298. package/dist/scan-activity.js +40 -17
  299. package/dist/scan-activity.js.map +1 -1
  300. package/dist/scan-comparison.d.ts +1 -1
  301. package/dist/scan-comparison.d.ts.map +1 -1
  302. package/dist/scan-comparison.js +11 -13
  303. package/dist/scan-comparison.js.map +1 -1
  304. package/dist/scan-dashboard.d.ts +1 -0
  305. package/dist/scan-dashboard.d.ts.map +1 -1
  306. package/dist/scan-dashboard.js +37 -48
  307. package/dist/scan-dashboard.js.map +1 -1
  308. package/dist/scan-executor.d.ts +2 -0
  309. package/dist/scan-executor.d.ts.map +1 -1
  310. package/dist/scan-executor.js.map +1 -1
  311. package/dist/scan-history-renderer.d.ts.map +1 -1
  312. package/dist/scan-history-renderer.js +22 -9
  313. package/dist/scan-history-renderer.js.map +1 -1
  314. package/dist/scan-logs.d.ts.map +1 -1
  315. package/dist/scan-logs.js +5 -5
  316. package/dist/scan-logs.js.map +1 -1
  317. package/dist/scanner-import.d.ts +48 -3
  318. package/dist/scanner-import.d.ts.map +1 -1
  319. package/dist/scanner-import.js +214 -39
  320. package/dist/scanner-import.js.map +1 -1
  321. package/dist/scanner-repository-url.d.ts +14 -0
  322. package/dist/scanner-repository-url.d.ts.map +1 -0
  323. package/dist/scanner-repository-url.js +67 -0
  324. package/dist/scanner-repository-url.js.map +1 -0
  325. package/dist/semgrep-findings.d.ts.map +1 -1
  326. package/dist/semgrep-findings.js +50 -88
  327. package/dist/semgrep-findings.js.map +1 -1
  328. package/dist/semgrep-platform-findings.d.ts +12 -0
  329. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  330. package/dist/semgrep-platform-findings.js +198 -0
  331. package/dist/semgrep-platform-findings.js.map +1 -0
  332. package/dist/severity-rubric.d.ts +20 -0
  333. package/dist/severity-rubric.d.ts.map +1 -0
  334. package/dist/severity-rubric.js +73 -0
  335. package/dist/severity-rubric.js.map +1 -0
  336. package/dist/severity-store.js +15 -5
  337. package/dist/severity-store.js.map +1 -1
  338. package/dist/snyk-findings.d.ts.map +1 -1
  339. package/dist/snyk-findings.js +97 -106
  340. package/dist/snyk-findings.js.map +1 -1
  341. package/dist/sonar-collector.d.ts +16 -0
  342. package/dist/sonar-collector.d.ts.map +1 -0
  343. package/dist/sonar-collector.js +383 -0
  344. package/dist/sonar-collector.js.map +1 -0
  345. package/dist/sonar-findings.d.ts +49 -0
  346. package/dist/sonar-findings.d.ts.map +1 -0
  347. package/dist/sonar-findings.js +288 -0
  348. package/dist/sonar-findings.js.map +1 -0
  349. package/dist/sonar-import.d.ts +111 -0
  350. package/dist/sonar-import.d.ts.map +1 -0
  351. package/dist/sonar-import.js +279 -0
  352. package/dist/sonar-import.js.map +1 -0
  353. package/dist/suggest-owners.d.ts.map +1 -1
  354. package/dist/suggest-owners.js +2 -1
  355. package/dist/suggest-owners.js.map +1 -1
  356. package/dist/targets.d.ts +3 -0
  357. package/dist/targets.d.ts.map +1 -1
  358. package/dist/targets.js +18 -12
  359. package/dist/targets.js.map +1 -1
  360. package/dist/terminal-columns.d.ts +4 -0
  361. package/dist/terminal-columns.d.ts.map +1 -0
  362. package/dist/terminal-columns.js +19 -0
  363. package/dist/terminal-columns.js.map +1 -0
  364. package/dist/validation-records.d.ts +0 -3
  365. package/dist/validation-records.d.ts.map +1 -1
  366. package/dist/validation-records.js +0 -16
  367. package/dist/validation-records.js.map +1 -1
  368. package/dist/veracode-findings.d.ts +7 -0
  369. package/dist/veracode-findings.d.ts.map +1 -0
  370. package/dist/veracode-findings.js +371 -0
  371. package/dist/veracode-findings.js.map +1 -0
  372. package/dist/windows-path.d.ts.map +1 -1
  373. package/dist/windows-path.js +1 -0
  374. package/dist/windows-path.js.map +1 -1
  375. package/dist/wiz-csv.d.ts +2 -2
  376. package/dist/wiz-csv.d.ts.map +1 -1
  377. package/dist/wiz-csv.js +1 -3
  378. package/dist/wiz-csv.js.map +1 -1
  379. package/dist/wiz-findings.d.ts +10 -2
  380. package/dist/wiz-findings.d.ts.map +1 -1
  381. package/dist/wiz-findings.js +88 -49
  382. package/dist/wiz-findings.js.map +1 -1
  383. package/docs/classify-severity-records.md +1 -1
  384. package/docs/cli.md +320 -481
  385. package/docs/dedupe-records.md +27 -4
  386. package/docs/findings-service.md +21 -8
  387. package/docs/hosted-scans.md +16 -1
  388. package/package.json +9 -10
  389. package/schemas/external-findings.schema.json +12 -1
  390. package/schemas/hosted-scan-v2.fixture.json +16 -1
  391. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  392. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  393. package/dist/deduplication/records-protocol.d.ts +0 -4
  394. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  395. package/dist/deduplication/records-protocol.js +0 -35
  396. package/dist/deduplication/records-protocol.js.map +0 -1
@@ -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,20 @@ 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:
34
40
  parser = argparse.ArgumentParser(description=description)
35
41
  subparsers = parser.add_subparsers(dest="command", required=True)
36
42
 
@@ -82,6 +88,12 @@ def parse_args(description: str) -> argparse.Namespace:
82
88
  diff_parser.add_argument("--diff-head-revision")
83
89
  diff_parser.add_argument("--diff-content-digest")
84
90
 
91
+ if inspection_only:
92
+ # Unknown arguments use the full parser below for its normal usage diagnostic.
93
+ args, unknown = parser.parse_known_args()
94
+ if not unknown:
95
+ return args
96
+
85
97
  start_headless_standard_scan = add_command(
86
98
  "start-headless-standard-scan", "--thread-id", "--target-path", "--scope"
87
99
  )
@@ -99,7 +111,84 @@ def parse_args(description: str) -> argparse.Namespace:
99
111
  diff_content_digest=None,
100
112
  )
101
113
 
102
- deep_scan.register_subcommands(subparsers, positive_int)
114
+ begin_deep_scan = add_command("begin-deep-scan", "--thread-id")
115
+ begin_target = begin_deep_scan.add_mutually_exclusive_group(required=True)
116
+ begin_target.add_argument("--scan-id")
117
+ begin_target.add_argument("--target-path")
118
+ begin_deep_scan.add_argument("--scope", default=".")
119
+ add_user_context(begin_deep_scan)
120
+ begin_deep_scan.add_argument("--scan-root")
121
+ begin_deep_scan.add_argument("--claim-token")
122
+ begin_deep_scan.add_argument("--model")
123
+ begin_deep_scan.add_argument("--reasoning-effort")
124
+ begin_deep_scan.add_argument("--service-tier")
125
+ begin_deep_scan.add_argument("--available-parallelism", type=positive_int)
126
+ begin_deep_scan.add_argument("--deep-scan-project-json")
127
+ begin_deep_scan.add_argument("--project-config-path")
128
+ begin_deep_scan.add_argument("--join-only", action="store_true")
129
+ begin_deep_scan.add_argument("--workflow-version", default="deep-security-scan/v1")
130
+
131
+ add_command("get-deep-scan", "--scan-id", "--thread-id")
132
+
133
+ add_command("acknowledge-deep-scan-result", "--scan-id")
134
+
135
+ claim_coordinator = add_command("claim-deep-scan-coordinator", "--scan-id", "--thread-id")
136
+ claim_coordinator.add_argument("--claim-token")
137
+ claim_coordinator.add_argument("--coordinator-generation", type=positive_int)
138
+
139
+ upsert_deep_worker = add_command("upsert-deep-scan-worker", "--scan-id", "--worker-id")
140
+ upsert_deep_worker.add_argument(
141
+ "--kind", choices=("setup", "discovery", "dedup"), required=True
142
+ )
143
+ upsert_deep_worker.add_argument(
144
+ "--status", choices=("queued", "running", "succeeded", "failed", "canceled"), required=True
145
+ )
146
+ upsert_deep_worker.add_argument("--prompt-path", required=True)
147
+ upsert_deep_worker.add_argument("--artifact-dir", required=True)
148
+ upsert_deep_worker.add_argument("--result-manifest-path")
149
+ upsert_deep_worker.add_argument("--attempt", type=non_negative_int)
150
+ upsert_deep_worker.add_argument("--sdk-thread-id")
151
+ upsert_deep_worker.add_argument("--error-message")
152
+ upsert_deep_worker.add_argument(
153
+ "--replaceable-failure-kind",
154
+ choices=("policy_refusal", "transient_error", "invalid_discovery_artifacts"),
155
+ )
156
+ upsert_deep_worker.add_argument("--coordinator-generation", type=positive_int)
157
+
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"
166
+ )
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)
170
+
171
+ finish_deep_scan = add_command("finish-deep-scan", "--scan-id")
172
+ finish_deep_scan.add_argument(
173
+ "--terminal-reason", choices=("saturated", "capped"), required=True
174
+ )
175
+ finish_deep_scan.add_argument("--manifest-path", required=True)
176
+ finish_deep_scan.add_argument("--staged-manifest-path")
177
+ finish_deep_scan.add_argument("--omitted-worker-id", action="append", default=[])
178
+ finish_deep_scan.add_argument("--coordinator-generation", type=positive_int)
179
+
180
+ fail_deep_scan = add_command("fail-deep-scan", "--scan-id", "--message")
181
+ fail_deep_scan.add_argument("--manifest-path")
182
+ fail_deep_scan.add_argument("--staged-manifest-path")
183
+ fail_deep_scan.add_argument(
184
+ "--deep-status", choices=("failed", "interrupted"), default="failed"
185
+ )
186
+ fail_deep_scan.add_argument("--coordinator-generation", type=positive_int)
187
+
188
+ publication_failure = add_command(
189
+ "record-deep-scan-publication-failure", "--scan-id", "--message"
190
+ )
191
+ publication_failure.add_argument("--coordinator-generation", type=positive_int)
103
192
 
104
193
  get_scan = add_command("get-scan", "--scan-id")
105
194
  get_scan.add_argument("--occurrence-id")
@@ -123,7 +212,7 @@ def parse_args(description: str) -> argparse.Namespace:
123
212
  list_scans.add_argument("--mode", choices=MODES)
124
213
  list_scans.add_argument("--repository")
125
214
  list_scans.add_argument("--scan-root")
126
- list_scans.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
215
+ list_scans.add_argument("--offset", type=non_negative_int, default=0)
127
216
  list_scans.add_argument("--limit", type=positive_int)
128
217
 
129
218
  list_unmatched_scan_pairs = add_command("list-unmatched-scan-pairs", "--repository")
@@ -171,30 +260,30 @@ def parse_args(description: str) -> argparse.Namespace:
171
260
  list_global_findings.add_argument("--severity", choices=FINDING_SEVERITIES)
172
261
  list_global_findings.add_argument("--status", choices=FINDING_STATUSES)
173
262
  list_global_findings.add_argument("--target-id")
174
- list_global_findings.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
263
+ list_global_findings.add_argument("--offset", type=non_negative_int, default=0)
175
264
  list_global_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
176
265
  list_repositories = subparsers.add_parser("list-repositories")
177
266
  list_repositories.add_argument("--query")
178
267
  list_repositories.add_argument("--target-id")
179
268
  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)
269
+ list_repositories.add_argument("--offset", type=non_negative_int, default=0)
181
270
  list_repositories.add_argument("--limit", type=positive_int)
182
271
 
183
272
  list_findings = add_command("list-findings", "--scan-id")
184
273
  list_findings.add_argument("--query")
185
274
  list_findings.add_argument("--severity", choices=FINDING_SEVERITIES)
186
275
  list_findings.add_argument("--status", choices=FINDING_STATUSES)
187
- list_findings.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
276
+ list_findings.add_argument("--offset", type=non_negative_int, default=0)
188
277
  list_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
189
278
 
190
279
  update_progress = add_command("update-progress", "--scan-id")
191
280
  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)
281
+ update_progress.add_argument("--phase-items-total", type=non_negative_int)
282
+ update_progress.add_argument("--phase-items-completed", type=non_negative_int)
194
283
  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)
284
+ update_progress.add_argument("--review-items-total", type=non_negative_int)
285
+ update_progress.add_argument("--review-items-completed", type=non_negative_int)
286
+ update_progress.add_argument("--reportable-findings-count", type=non_negative_int)
198
287
  update_progress.add_argument("--deep-review-pass", type=positive_int)
199
288
  update_progress.add_argument("--claim-token")
200
289
  update_progress.add_argument("--coordinator-generation", type=positive_int)
@@ -295,6 +384,7 @@ def parse_args(description: str) -> argparse.Namespace:
295
384
  "--state", choices=REMEDIATION_UPDATE_STATES, required=True
296
385
  )
297
386
  set_finding_remediation.add_argument("--summary")
387
+ set_finding_remediation.add_argument("--patch-stdin", action="store_true")
298
388
  set_finding_remediation.add_argument("--patch-path")
299
389
  set_finding_remediation.add_argument("--patch-digest")
300
390
  set_finding_remediation.add_argument("--base-revision")
@@ -311,7 +401,6 @@ def parse_args(description: str) -> argparse.Namespace:
311
401
 
312
402
  subparsers.add_parser("database-info")
313
403
  subparsers.add_parser("finding-workflow")
314
- subparsers.add_parser("local-dedupe")
315
404
  args = parser.parse_args()
316
405
  if getattr(args, "user_context_stdin", False):
317
406
  args.user_context = sys.stdin.buffer.read().decode("utf-8")
@@ -62,6 +62,15 @@ EMPTY_GIT_TREES = {
62
62
  }
63
63
 
64
64
 
65
+ def optional_text(value: str | None, *, maximum: int | None = None) -> str | None:
66
+ if value is None:
67
+ return None
68
+ normalized = value.strip()
69
+ if maximum is not None and len(normalized) > maximum:
70
+ raise SystemExit(f"Text value must be no longer than {maximum} characters.")
71
+ return normalized or None
72
+
73
+
65
74
  def positive_int(value: str) -> int:
66
75
  parsed = int(value)
67
76
  if parsed < 1:
@@ -4,7 +4,6 @@ from __future__ import annotations
4
4
 
5
5
  import copy
6
6
  import os
7
- import re
8
7
  from collections.abc import Callable, Sequence
9
8
  from pathlib import Path, PurePosixPath
10
9
  from typing import Any
@@ -20,22 +19,6 @@ from finalize_scan_contract import (
20
19
  from workbench.saved_coverage import _project_worker_coverage_row, _saved_coverage_id
21
20
 
22
21
 
23
- def _checkpoint_head_directory(relative: str) -> Path | None:
24
- path = Path(relative)
25
- if path.name == "checkpoint-head.json":
26
- return path.parent
27
- if path.parent.name == "checkpoint-heads":
28
- return path.parent.parent
29
- return None
30
-
31
-
32
- def _is_source_order_snapshot(relative: str) -> bool:
33
- path = Path(relative)
34
- return path.parent == Path("source-order") and bool(
35
- re.fullmatch(r"[0-9a-f]{64}\.json", path.name)
36
- )
37
-
38
-
39
22
  def capture_receipt_checkpoints(
40
23
  relative: str,
41
24
  kind: str | None,