@openai/codex-security 0.2.0 → 0.4.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 (484) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +4 -0
  4. package/_bundled_plugin/.mcp.json +2 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
  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/permission-profile-preflight.mjs +556 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +2 -2
  25. package/_bundled_plugin/references/config-preflight.md +0 -4
  26. package/_bundled_plugin/references/core-scan.md +21 -9
  27. package/_bundled_plugin/references/final-report.md +11 -13
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +1 -2
  31. package/_bundled_plugin/references/scan-contract.md +9 -4
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +1 -1
  36. package/_bundled_plugin/schemas/coverage.schema.json +43 -170
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +159 -567
  40. package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
  41. package/_bundled_plugin/schemas/scan-manifest.schema.json +78 -220
  42. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  43. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  44. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  45. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  46. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  47. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  48. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  49. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  50. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  51. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  52. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +321 -237
  54. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  56. package/_bundled_plugin/scripts/generate_rank_input.py +115 -926
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  60. package/_bundled_plugin/scripts/report_projection.py +150 -183
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  63. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  64. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  65. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  66. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  67. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  68. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +102 -184
  70. package/_bundled_plugin/scripts/workbench_db.py +463 -464
  71. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  74. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  75. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  76. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  77. package/_bundled_plugin/scripts/workbench_publication.py +234 -289
  78. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  79. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  80. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  81. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  82. package/_bundled_plugin/scripts/workbench_scan_usage.py +194 -42
  83. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  85. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  86. package/_bundled_plugin/scripts/workbench_validation.py +31 -28
  87. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  88. package/_bundled_plugin/shared/workbench-migrations.json +414 -0
  89. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  90. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  92. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  93. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  94. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  95. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  96. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  97. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  98. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  99. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +15 -1
  100. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  101. package/_bundled_plugin/skills/track-findings/SKILL.md +48 -176
  102. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  103. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  104. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  105. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  106. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  107. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  108. package/bin/codex-security.mjs +9 -2
  109. package/dist/api.d.ts +63 -10
  110. package/dist/api.d.ts.map +1 -1
  111. package/dist/api.js +1015 -383
  112. package/dist/api.js.map +1 -1
  113. package/dist/artifact-export.d.ts +1 -1
  114. package/dist/artifact-export.d.ts.map +1 -1
  115. package/dist/artifact-export.js +28 -13
  116. package/dist/artifact-export.js.map +1 -1
  117. package/dist/auth.d.ts +2 -6
  118. package/dist/auth.d.ts.map +1 -1
  119. package/dist/auth.js +19 -9
  120. package/dist/auth.js.map +1 -1
  121. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  122. package/dist/bulk-scan-discovery.js +1 -0
  123. package/dist/bulk-scan-discovery.js.map +1 -1
  124. package/dist/classify-severity.d.ts +26 -9
  125. package/dist/classify-severity.d.ts.map +1 -1
  126. package/dist/classify-severity.js +13 -30
  127. package/dist/classify-severity.js.map +1 -1
  128. package/dist/cli-help.d.ts.map +1 -1
  129. package/dist/cli-help.js +17 -13
  130. package/dist/cli-help.js.map +1 -1
  131. package/dist/cli-signals.d.ts +8 -0
  132. package/dist/cli-signals.d.ts.map +1 -0
  133. package/dist/cli-signals.js +28 -0
  134. package/dist/cli-signals.js.map +1 -0
  135. package/dist/cli.d.ts +4 -3
  136. package/dist/cli.d.ts.map +1 -1
  137. package/dist/cli.js +1102 -905
  138. package/dist/cli.js.map +1 -1
  139. package/dist/cloud-publish.d.ts.map +1 -1
  140. package/dist/cloud-publish.js +10 -9
  141. package/dist/cloud-publish.js.map +1 -1
  142. package/dist/codeowners.d.ts +19 -0
  143. package/dist/codeowners.d.ts.map +1 -0
  144. package/dist/codeowners.js +138 -0
  145. package/dist/codeowners.js.map +1 -0
  146. package/dist/codex-sdk-environment.d.ts +1 -0
  147. package/dist/codex-sdk-environment.d.ts.map +1 -1
  148. package/dist/codex-sdk-environment.js +40 -2
  149. package/dist/codex-sdk-environment.js.map +1 -1
  150. package/dist/component-plan.d.ts +2 -5
  151. package/dist/component-plan.d.ts.map +1 -1
  152. package/dist/component-plan.js +39 -31
  153. package/dist/component-plan.js.map +1 -1
  154. package/dist/component-scan.d.ts +6 -5
  155. package/dist/component-scan.d.ts.map +1 -1
  156. package/dist/component-scan.js +25 -36
  157. package/dist/component-scan.js.map +1 -1
  158. package/dist/config.d.ts.map +1 -1
  159. package/dist/config.js +64 -74
  160. package/dist/config.js.map +1 -1
  161. package/dist/contract.d.ts +16 -3
  162. package/dist/contract.d.ts.map +1 -1
  163. package/dist/contract.js +91 -255
  164. package/dist/contract.js.map +1 -1
  165. package/dist/cost-model.d.ts +13 -6
  166. package/dist/cost-model.d.ts.map +1 -1
  167. package/dist/cost-model.js +14 -4
  168. package/dist/cost-model.js.map +1 -1
  169. package/dist/cost.d.ts +10 -2
  170. package/dist/cost.d.ts.map +1 -1
  171. package/dist/cost.js +102 -104
  172. package/dist/cost.js.map +1 -1
  173. package/dist/custom-validation-prompt.d.ts.map +1 -1
  174. package/dist/custom-validation-prompt.js +6 -5
  175. package/dist/custom-validation-prompt.js.map +1 -1
  176. package/dist/custom-validation.d.ts +1 -2
  177. package/dist/custom-validation.d.ts.map +1 -1
  178. package/dist/custom-validation.js +9 -3
  179. package/dist/custom-validation.js.map +1 -1
  180. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  181. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  182. package/dist/deduplication/checkpointed-review.js +23 -9
  183. package/dist/deduplication/checkpointed-review.js.map +1 -1
  184. package/dist/deduplication/codex-review.d.ts +8 -6
  185. package/dist/deduplication/codex-review.d.ts.map +1 -1
  186. package/dist/deduplication/codex-review.js +128 -19
  187. package/dist/deduplication/codex-review.js.map +1 -1
  188. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  189. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  190. package/dist/deduplication/deduplication-prompts.js +18 -4
  191. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  192. package/dist/deduplication/deduplication-reviewer.d.ts +27 -5
  193. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  194. package/dist/deduplication/deduplication-reviewer.js +58 -48
  195. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  196. package/dist/deduplication/deduplication.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication.js +19 -51
  198. package/dist/deduplication/deduplication.js.map +1 -1
  199. package/dist/deduplication/diagnostics.d.ts +17 -0
  200. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  201. package/dist/deduplication/diagnostics.js +5 -0
  202. package/dist/deduplication/diagnostics.js.map +1 -0
  203. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  204. package/dist/deduplication/finding-schema.js +7 -1
  205. package/dist/deduplication/finding-schema.js.map +1 -1
  206. package/dist/deduplication/local.d.ts +31 -0
  207. package/dist/deduplication/local.d.ts.map +1 -0
  208. package/dist/deduplication/local.js +166 -0
  209. package/dist/deduplication/local.js.map +1 -0
  210. package/dist/deduplication/records-protocol.d.ts +3 -8
  211. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  212. package/dist/deduplication/records-protocol.js +11 -184
  213. package/dist/deduplication/records-protocol.js.map +1 -1
  214. package/dist/deduplication/records.d.ts +186 -11
  215. package/dist/deduplication/records.d.ts.map +1 -1
  216. package/dist/deduplication/records.js +10 -18
  217. package/dist/deduplication/records.js.map +1 -1
  218. package/dist/deduplication/scan.d.ts +9 -3
  219. package/dist/deduplication/scan.d.ts.map +1 -1
  220. package/dist/deduplication/scan.js +158 -39
  221. package/dist/deduplication/scan.js.map +1 -1
  222. package/dist/deep-config.d.ts +2 -1
  223. package/dist/deep-config.d.ts.map +1 -1
  224. package/dist/deep-config.js +4 -4
  225. package/dist/deep-config.js.map +1 -1
  226. package/dist/deep-progress.d.ts +17 -1
  227. package/dist/deep-progress.d.ts.map +1 -1
  228. package/dist/deep-progress.js +19 -17
  229. package/dist/deep-progress.js.map +1 -1
  230. package/dist/deep-scan.d.ts +20 -0
  231. package/dist/deep-scan.d.ts.map +1 -0
  232. package/dist/deep-scan.js +113 -0
  233. package/dist/deep-scan.js.map +1 -0
  234. package/dist/errors.d.ts +2 -0
  235. package/dist/errors.d.ts.map +1 -1
  236. package/dist/errors.js +2 -0
  237. package/dist/errors.js.map +1 -1
  238. package/dist/executable-path.d.ts +2 -0
  239. package/dist/executable-path.d.ts.map +1 -0
  240. package/dist/executable-path.js +12 -0
  241. package/dist/executable-path.js.map +1 -0
  242. package/dist/feedback.d.ts +1 -4
  243. package/dist/feedback.d.ts.map +1 -1
  244. package/dist/feedback.js +54 -22
  245. package/dist/feedback.js.map +1 -1
  246. package/dist/finding-catalogue.d.ts.map +1 -1
  247. package/dist/finding-catalogue.js +4 -8
  248. package/dist/finding-catalogue.js.map +1 -1
  249. package/dist/finding-normalization.d.ts +5 -0
  250. package/dist/finding-normalization.d.ts.map +1 -0
  251. package/dist/finding-normalization.js +120 -0
  252. package/dist/finding-normalization.js.map +1 -0
  253. package/dist/finding-retrieval.d.ts +9 -0
  254. package/dist/finding-retrieval.d.ts.map +1 -1
  255. package/dist/finding-retrieval.js.map +1 -1
  256. package/dist/finding-workflow.d.ts +13 -8
  257. package/dist/finding-workflow.d.ts.map +1 -1
  258. package/dist/finding-workflow.js +14 -6
  259. package/dist/finding-workflow.js.map +1 -1
  260. package/dist/findings-client.d.ts +2 -1
  261. package/dist/findings-client.d.ts.map +1 -1
  262. package/dist/findings-client.js +36 -9
  263. package/dist/findings-client.js.map +1 -1
  264. package/dist/findings-errors.d.ts +16 -0
  265. package/dist/findings-errors.d.ts.map +1 -0
  266. package/dist/findings-errors.js +24 -0
  267. package/dist/findings-errors.js.map +1 -0
  268. package/dist/findings-import.d.ts +1 -1
  269. package/dist/findings-import.d.ts.map +1 -1
  270. package/dist/findings-import.js +12 -30
  271. package/dist/findings-import.js.map +1 -1
  272. package/dist/github.d.ts.map +1 -1
  273. package/dist/github.js +7 -1
  274. package/dist/github.js.map +1 -1
  275. package/dist/host-protocol.d.ts +19 -0
  276. package/dist/host-protocol.d.ts.map +1 -0
  277. package/dist/host-protocol.js +270 -0
  278. package/dist/host-protocol.js.map +1 -0
  279. package/dist/hosted-scan-protocol.d.ts +4 -0
  280. package/dist/hosted-scan-protocol.d.ts.map +1 -0
  281. package/dist/hosted-scan-protocol.js +25 -0
  282. package/dist/hosted-scan-protocol.js.map +1 -0
  283. package/dist/hosted-scan.d.ts +117 -0
  284. package/dist/hosted-scan.d.ts.map +1 -0
  285. package/dist/hosted-scan.js +260 -0
  286. package/dist/hosted-scan.js.map +1 -0
  287. package/dist/import-scan.d.ts.map +1 -1
  288. package/dist/import-scan.js +48 -38
  289. package/dist/import-scan.js.map +1 -1
  290. package/dist/index.d.ts +11 -4
  291. package/dist/index.d.ts.map +1 -1
  292. package/dist/index.js +2 -1
  293. package/dist/index.js.map +1 -1
  294. package/dist/knowledge-base.d.ts +7 -1
  295. package/dist/knowledge-base.d.ts.map +1 -1
  296. package/dist/knowledge-base.js +114 -46
  297. package/dist/knowledge-base.js.map +1 -1
  298. package/dist/linear.d.ts.map +1 -1
  299. package/dist/linear.js +2 -7
  300. package/dist/linear.js.map +1 -1
  301. package/dist/mock-scan.d.ts.map +1 -1
  302. package/dist/mock-scan.js +0 -1
  303. package/dist/mock-scan.js.map +1 -1
  304. package/dist/models.d.ts +0 -2
  305. package/dist/models.d.ts.map +1 -1
  306. package/dist/models.js.map +1 -1
  307. package/dist/multiscan.d.ts +9 -3
  308. package/dist/multiscan.d.ts.map +1 -1
  309. package/dist/multiscan.js +240 -135
  310. package/dist/multiscan.js.map +1 -1
  311. package/dist/owner-evidence.d.ts +10 -2
  312. package/dist/owner-evidence.d.ts.map +1 -1
  313. package/dist/owner-evidence.js +67 -8
  314. package/dist/owner-evidence.js.map +1 -1
  315. package/dist/patch-tui.d.ts.map +1 -1
  316. package/dist/patch-tui.js +3 -2
  317. package/dist/patch-tui.js.map +1 -1
  318. package/dist/project-config.js +3 -3
  319. package/dist/project-config.js.map +1 -1
  320. package/dist/provider-profile.d.ts +21 -0
  321. package/dist/provider-profile.d.ts.map +1 -0
  322. package/dist/provider-profile.js +133 -0
  323. package/dist/provider-profile.js.map +1 -0
  324. package/dist/publication-events.d.ts +6 -8
  325. package/dist/publication-events.d.ts.map +1 -1
  326. package/dist/publication-events.js +25 -50
  327. package/dist/publication-events.js.map +1 -1
  328. package/dist/publication-store.d.ts.map +1 -1
  329. package/dist/publication-store.js +95 -109
  330. package/dist/publication-store.js.map +1 -1
  331. package/dist/publication.d.ts +1 -4
  332. package/dist/publication.d.ts.map +1 -1
  333. package/dist/publication.js +2 -13
  334. package/dist/publication.js.map +1 -1
  335. package/dist/publish.d.ts +1 -5
  336. package/dist/publish.d.ts.map +1 -1
  337. package/dist/publish.js +109 -160
  338. package/dist/publish.js.map +1 -1
  339. package/dist/request-metadata.d.ts +9 -0
  340. package/dist/request-metadata.d.ts.map +1 -0
  341. package/dist/request-metadata.js +13 -0
  342. package/dist/request-metadata.js.map +1 -0
  343. package/dist/runtime.d.ts +20 -6
  344. package/dist/runtime.d.ts.map +1 -1
  345. package/dist/runtime.js +407 -148
  346. package/dist/runtime.js.map +1 -1
  347. package/dist/saved-scan-bootstrap.d.ts +14 -0
  348. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  349. package/dist/saved-scan-bootstrap.js +261 -0
  350. package/dist/saved-scan-bootstrap.js.map +1 -0
  351. package/dist/saved-scan.d.ts +1 -1
  352. package/dist/saved-scan.d.ts.map +1 -1
  353. package/dist/saved-scan.js +6 -12
  354. package/dist/saved-scan.js.map +1 -1
  355. package/dist/scan-activity.js +11 -8
  356. package/dist/scan-activity.js.map +1 -1
  357. package/dist/scan-comparison.d.ts +28 -15
  358. package/dist/scan-comparison.d.ts.map +1 -1
  359. package/dist/scan-comparison.js +276 -281
  360. package/dist/scan-comparison.js.map +1 -1
  361. package/dist/scan-dashboard.d.ts +3 -0
  362. package/dist/scan-dashboard.d.ts.map +1 -1
  363. package/dist/scan-dashboard.js +345 -77
  364. package/dist/scan-dashboard.js.map +1 -1
  365. package/dist/scan-executor.d.ts +104 -0
  366. package/dist/scan-executor.d.ts.map +1 -0
  367. package/dist/scan-executor.js +62 -0
  368. package/dist/scan-executor.js.map +1 -0
  369. package/dist/scan-history-renderer.d.ts.map +1 -1
  370. package/dist/scan-history-renderer.js +54 -13
  371. package/dist/scan-history-renderer.js.map +1 -1
  372. package/dist/scan-inputs.d.ts +6 -0
  373. package/dist/scan-inputs.d.ts.map +1 -0
  374. package/dist/scan-inputs.js +71 -0
  375. package/dist/scan-inputs.js.map +1 -0
  376. package/dist/scan-logs.d.ts +2 -3
  377. package/dist/scan-logs.d.ts.map +1 -1
  378. package/dist/scan-logs.js +12 -6
  379. package/dist/scan-logs.js.map +1 -1
  380. package/dist/scan-sessions.d.ts +4 -0
  381. package/dist/scan-sessions.d.ts.map +1 -1
  382. package/dist/scan-sessions.js +17 -0
  383. package/dist/scan-sessions.js.map +1 -1
  384. package/dist/scan-skill-paths.d.ts +8 -0
  385. package/dist/scan-skill-paths.d.ts.map +1 -0
  386. package/dist/scan-skill-paths.js +47 -0
  387. package/dist/scan-skill-paths.js.map +1 -0
  388. package/dist/security-policy-cli.d.ts.map +1 -1
  389. package/dist/security-policy-cli.js +7 -27
  390. package/dist/security-policy-cli.js.map +1 -1
  391. package/dist/security-policy.d.ts +9 -5
  392. package/dist/security-policy.d.ts.map +1 -1
  393. package/dist/security-policy.js +33 -14
  394. package/dist/security-policy.js.map +1 -1
  395. package/dist/server/api.d.ts +0 -1
  396. package/dist/server/api.d.ts.map +1 -1
  397. package/dist/server/api.js +0 -1
  398. package/dist/server/api.js.map +1 -1
  399. package/dist/server/embeddings.d.ts +3 -1
  400. package/dist/server/embeddings.d.ts.map +1 -1
  401. package/dist/server/embeddings.js +10 -3
  402. package/dist/server/embeddings.js.map +1 -1
  403. package/dist/server/errors.d.ts +5 -2
  404. package/dist/server/errors.d.ts.map +1 -1
  405. package/dist/server/errors.js +7 -0
  406. package/dist/server/errors.js.map +1 -1
  407. package/dist/server/sqlite-store.d.ts +0 -2
  408. package/dist/server/sqlite-store.d.ts.map +1 -1
  409. package/dist/server/sqlite-store.js +54 -44
  410. package/dist/server/sqlite-store.js.map +1 -1
  411. package/dist/server/storage.d.ts +0 -2
  412. package/dist/server/storage.d.ts.map +1 -1
  413. package/dist/server/storage.js.map +1 -1
  414. package/dist/severity-store.js +19 -24
  415. package/dist/severity-store.js.map +1 -1
  416. package/dist/standalone-validation-prompt.d.ts +2 -0
  417. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  418. package/dist/standalone-validation-prompt.js +10 -0
  419. package/dist/standalone-validation-prompt.js.map +1 -0
  420. package/dist/suggest-owners.d.ts +4 -2
  421. package/dist/suggest-owners.d.ts.map +1 -1
  422. package/dist/suggest-owners.js +11 -5
  423. package/dist/suggest-owners.js.map +1 -1
  424. package/dist/targets.d.ts +11 -0
  425. package/dist/targets.d.ts.map +1 -1
  426. package/dist/targets.js +123 -72
  427. package/dist/targets.js.map +1 -1
  428. package/dist/trusted-executable.d.ts +2 -2
  429. package/dist/trusted-executable.d.ts.map +1 -1
  430. package/dist/trusted-executable.js +8 -6
  431. package/dist/trusted-executable.js.map +1 -1
  432. package/dist/value.js +7 -0
  433. package/dist/value.js.map +1 -1
  434. package/dist/version.js.map +1 -1
  435. package/dist/workbench-arguments.d.ts +3 -0
  436. package/dist/workbench-arguments.d.ts.map +1 -0
  437. package/dist/workbench-arguments.js +15 -0
  438. package/dist/workbench-arguments.js.map +1 -0
  439. package/dist/worker-progress.d.ts +44 -11
  440. package/dist/worker-progress.d.ts.map +1 -1
  441. package/dist/worker-progress.js +48 -49
  442. package/dist/worker-progress.js.map +1 -1
  443. package/docs/cli.md +1788 -0
  444. package/docs/findings-service.md +402 -0
  445. package/docs/hosted-scans.md +242 -0
  446. package/package.json +23 -22
  447. package/schemas/hosted-scan-v2.fixture.json +145 -0
  448. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  449. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  450. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  451. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  452. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  453. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  454. package/dist/server/dashboard/app.css +0 -2
  455. package/dist/server/dashboard/app.js +0 -66
  456. package/dist/server/dashboard/index.html +0 -18
  457. package/dist/server/dashboard-types.d.ts +0 -48
  458. package/dist/server/dashboard-types.d.ts.map +0 -1
  459. package/dist/server/dashboard-types.js +0 -2
  460. package/dist/server/dashboard-types.js.map +0 -1
  461. package/dist/server/dashboard.d.ts +0 -6
  462. package/dist/server/dashboard.d.ts.map +0 -1
  463. package/dist/server/dashboard.js +0 -59
  464. package/dist/server/dashboard.js.map +0 -1
  465. package/dist/server/index.d.ts +0 -2
  466. package/dist/server/index.d.ts.map +0 -1
  467. package/dist/server/index.js +0 -6
  468. package/dist/server/index.js.map +0 -1
  469. package/dist/server/routes.d.ts +0 -7
  470. package/dist/server/routes.d.ts.map +0 -1
  471. package/dist/server/routes.js +0 -98
  472. package/dist/server/routes.js.map +0 -1
  473. package/dist/server/serve.d.ts +0 -2
  474. package/dist/server/serve.d.ts.map +0 -1
  475. package/dist/server/serve.js +0 -28
  476. package/dist/server/serve.js.map +0 -1
  477. package/dist/server/server.d.ts +0 -10
  478. package/dist/server/server.d.ts.map +0 -1
  479. package/dist/server/server.js +0 -16
  480. package/dist/server/server.js.map +0 -1
  481. package/dist/server/validation.d.ts +0 -17
  482. package/dist/server/validation.d.ts.map +0 -1
  483. package/dist/server/validation.js +0 -53
  484. package/dist/server/validation.js.map +0 -1
@@ -9,7 +9,6 @@ from pathlib import Path
9
9
  # Some plugin hosts launch Python with safe-path isolation enabled.
10
10
  sys.path.insert(0, str(Path(__file__).resolve().parent))
11
11
  import deep_scan_workbench as deep_scan
12
- from deep_scan_workbench import non_negative_int
13
12
  from workbench_constants import (
14
13
  DIFF_TARGET_KINDS,
15
14
  EXPORT_FORMATS,
@@ -35,11 +34,16 @@ def parse_args(description: str) -> argparse.Namespace:
35
34
  parser = argparse.ArgumentParser(description=description)
36
35
  subparsers = parser.add_subparsers(dest="command", required=True)
37
36
 
37
+ def add_command(name: str, *required: str) -> argparse.ArgumentParser:
38
+ command_parser = subparsers.add_parser(name)
39
+ for flag in required:
40
+ command_parser.add_argument(flag, required=True)
41
+ return command_parser
42
+
38
43
  resolve_scan_root = subparsers.add_parser("resolve-scan-root")
39
44
  resolve_scan_root.add_argument("--scan-root")
40
45
 
41
- create_workspace = subparsers.add_parser("create-workspace")
42
- create_workspace.add_argument("--workspace-id", required=True)
46
+ create_workspace = add_command("create-workspace", "--workspace-id")
43
47
  create_workspace.add_argument("--thread-id")
44
48
  create_workspace.add_argument("--target-path")
45
49
  create_workspace.add_argument("--target-title")
@@ -47,69 +51,44 @@ def parse_args(description: str) -> argparse.Namespace:
47
51
  add_user_context(create_workspace)
48
52
  create_workspace.add_argument("--scope")
49
53
  create_workspace.add_argument("--mode", choices=MODES, default="standard")
50
- create_workspace.add_argument("--diff-target-kind", choices=DIFF_TARGET_KINDS)
51
- create_workspace.add_argument("--diff-base-revision")
52
- create_workspace.add_argument("--diff-head-revision")
53
- create_workspace.add_argument("--diff-content-digest")
54
54
 
55
- get_workspace = subparsers.add_parser("get-workspace")
56
- get_workspace.add_argument("--workspace-id", required=True)
55
+ get_workspace = add_command("get-workspace", "--workspace-id")
57
56
  get_workspace.add_argument("--thread-id")
58
57
 
59
- inspect_target = subparsers.add_parser("inspect-target")
60
- inspect_target.add_argument("--target-path", required=True)
58
+ add_command("inspect-target", "--target-path")
61
59
 
62
- inspect_setup = subparsers.add_parser("inspect-setup")
63
- inspect_setup.add_argument("--target-path", required=True)
64
- inspect_setup.add_argument("--scope", required=True)
60
+ inspect_setup = add_command("inspect-setup", "--target-path", "--scope")
65
61
  inspect_setup.add_argument("--mode", choices=MODES, required=True)
66
- inspect_setup.add_argument("--diff-target-kind", choices=DIFF_TARGET_KINDS)
67
- inspect_setup.add_argument("--diff-base-revision")
68
- inspect_setup.add_argument("--diff-head-revision")
69
- inspect_setup.add_argument("--diff-content-digest")
70
-
71
- save_workspace = subparsers.add_parser("save-workspace")
72
- save_workspace.add_argument("--workspace-id", required=True)
73
- save_workspace.add_argument("--target-path", required=True)
74
- save_workspace.add_argument("--scope", required=True)
62
+
63
+ save_workspace = add_command("save-workspace", "--workspace-id", "--target-path", "--scope")
75
64
  save_workspace.add_argument("--mode", choices=MODES, required=True)
76
65
  save_workspace.add_argument("--target-summary")
77
66
  add_user_context(save_workspace)
78
- save_workspace.add_argument("--diff-target-kind", choices=DIFF_TARGET_KINDS)
79
- save_workspace.add_argument("--diff-base-revision")
80
- save_workspace.add_argument("--diff-head-revision")
81
- save_workspace.add_argument("--diff-content-digest")
82
-
83
- start_scan = subparsers.add_parser("start-scan")
84
- start_scan.add_argument("--workspace-id", required=True)
85
- start_scan.add_argument("--scan-root")
86
- start_scan.add_argument("--model")
87
- start_scan.add_argument("--reasoning-effort")
88
-
89
- start_prompt_only_scan = subparsers.add_parser("start-prompt-only-scan")
90
- start_prompt_only_scan.add_argument("--thread-id", required=True)
91
- start_prompt_only_scan.add_argument("--target-path", required=True)
92
- start_prompt_only_scan.add_argument("--scope", required=True)
67
+
68
+ start_scan = add_command("start-scan", "--workspace-id")
69
+
70
+ start_prompt_only_scan = add_command(
71
+ "start-prompt-only-scan", "--thread-id", "--target-path", "--scope"
72
+ )
93
73
  start_prompt_only_scan.add_argument("--mode", choices=("diff", "standard"), required=True)
94
74
  start_prompt_only_scan.add_argument("--target-summary")
95
75
  add_user_context(start_prompt_only_scan)
96
- start_prompt_only_scan.add_argument("--diff-target-kind", choices=DIFF_TARGET_KINDS)
97
- start_prompt_only_scan.add_argument("--diff-base-revision")
98
- start_prompt_only_scan.add_argument("--diff-head-revision")
99
- start_prompt_only_scan.add_argument("--diff-content-digest")
100
- start_prompt_only_scan.add_argument("--scan-root")
101
- start_prompt_only_scan.add_argument("--model")
102
- start_prompt_only_scan.add_argument("--reasoning-effort")
103
-
104
- start_headless_standard_scan = subparsers.add_parser("start-headless-standard-scan")
105
- start_headless_standard_scan.add_argument("--thread-id", required=True)
106
- start_headless_standard_scan.add_argument("--target-path", required=True)
107
- start_headless_standard_scan.add_argument("--scope", required=True)
76
+ # Place shared options after each command's preceding arguments to preserve help order.
77
+ for diff_parser in (create_workspace, inspect_setup, save_workspace, start_prompt_only_scan):
78
+ diff_parser.add_argument("--diff-target-kind", choices=DIFF_TARGET_KINDS)
79
+ diff_parser.add_argument("--diff-base-revision")
80
+ diff_parser.add_argument("--diff-head-revision")
81
+ diff_parser.add_argument("--diff-content-digest")
82
+
83
+ start_headless_standard_scan = add_command(
84
+ "start-headless-standard-scan", "--thread-id", "--target-path", "--scope"
85
+ )
108
86
  start_headless_standard_scan.add_argument("--target-summary")
109
87
  add_user_context(start_headless_standard_scan)
110
- start_headless_standard_scan.add_argument("--scan-root")
111
- start_headless_standard_scan.add_argument("--model")
112
- start_headless_standard_scan.add_argument("--reasoning-effort")
88
+ for scan_parser in (start_scan, start_prompt_only_scan, start_headless_standard_scan):
89
+ scan_parser.add_argument("--scan-root")
90
+ scan_parser.add_argument("--model")
91
+ scan_parser.add_argument("--reasoning-effort")
113
92
  start_headless_standard_scan.set_defaults(
114
93
  mode="standard",
115
94
  diff_target_kind=None,
@@ -120,15 +99,14 @@ def parse_args(description: str) -> argparse.Namespace:
120
99
 
121
100
  deep_scan.register_subcommands(subparsers, positive_int)
122
101
 
123
- get_scan = subparsers.add_parser("get-scan")
124
- get_scan.add_argument("--scan-id", required=True)
102
+ get_scan = add_command("get-scan", "--scan-id")
125
103
  get_scan.add_argument("--occurrence-id")
126
104
 
127
- get_scan_feedback = subparsers.add_parser("get-scan-feedback")
128
- get_scan_feedback.add_argument("--scan-id", required=True)
105
+ add_command("rename-scan", "--scan-id", "--name")
106
+
107
+ add_command("get-scan-feedback", "--scan-id")
129
108
 
130
- update_scan_context = subparsers.add_parser("update-scan-context")
131
- update_scan_context.add_argument("--scan-id", required=True)
109
+ update_scan_context = add_command("update-scan-context", "--scan-id")
132
110
  add_user_context(update_scan_context, required=True)
133
111
  update_scan_context_owner = update_scan_context.add_mutually_exclusive_group(required=True)
134
112
  update_scan_context_owner.add_argument("--workspace-id")
@@ -142,42 +120,36 @@ def parse_args(description: str) -> argparse.Namespace:
142
120
  list_scans.add_argument("--mode", choices=MODES)
143
121
  list_scans.add_argument("--repository")
144
122
  list_scans.add_argument("--scan-root")
145
- list_scans.add_argument("--offset", type=non_negative_int, default=0)
123
+ list_scans.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
146
124
  list_scans.add_argument("--limit", type=positive_int)
147
125
 
148
- list_unmatched_scan_pairs = subparsers.add_parser("list-unmatched-scan-pairs")
149
- list_unmatched_scan_pairs.add_argument("--repository", required=True)
126
+ list_unmatched_scan_pairs = add_command("list-unmatched-scan-pairs", "--repository")
150
127
  list_unmatched_scan_pairs.add_argument("--force", action="store_true")
151
128
 
152
- register_cli_scan = subparsers.add_parser("register-cli-scan")
153
- register_cli_scan.add_argument("--scan-dir", required=True)
154
- register_cli_scan.add_argument("--repository", required=True)
129
+ register_cli_scan = add_command("register-cli-scan", "--scan-dir", "--repository")
155
130
  recipe = register_cli_scan.add_mutually_exclusive_group(required=True)
156
131
  recipe.add_argument("--recipe-json")
157
132
  recipe.add_argument("--recipe-json-stdin", action="store_true")
158
133
  recipe.add_argument("--registration-json-stdin", action="store_true")
159
134
  register_cli_scan.add_argument("--parent-scan-id")
160
- register_cli_scan.add_argument("--archive-existing", action="store_true")
135
+ register_cli_scan.add_argument(
136
+ "--archive-existing",
137
+ action="store_true",
138
+ help="Archive output in the registration transaction. Supports cancellable archival preparation.",
139
+ )
161
140
  register_cli_scan.add_argument("--archived-scan-dir")
162
141
 
163
- set_scan_thread = subparsers.add_parser("set-scan-thread")
164
- set_scan_thread.add_argument("--scan-id", required=True)
165
- set_scan_thread.add_argument("--thread-id", required=True)
142
+ add_command("set-scan-thread", "--scan-id", "--thread-id")
166
143
 
167
- set_scan_cost_limit = subparsers.add_parser("set-scan-cost-limit")
168
- set_scan_cost_limit.add_argument("--scan-id", required=True)
144
+ set_scan_cost_limit = add_command("set-scan-cost-limit", "--scan-id")
169
145
  set_scan_cost_limit.add_argument("--max-cost-usd", required=True, type=float)
170
146
 
171
- get_scan_recipe = subparsers.add_parser("get-scan-recipe")
172
- get_scan_recipe.add_argument("--scan-id", required=True)
147
+ add_command("get-scan-recipe", "--scan-id")
173
148
 
174
- get_cli_scan_resume = subparsers.add_parser("get-cli-scan-resume")
175
- get_cli_scan_resume.add_argument("--scan-id", required=True)
149
+ get_cli_scan_resume = add_command("get-cli-scan-resume", "--scan-id")
176
150
  get_cli_scan_resume.add_argument("--allow-unavailable", action="store_true")
177
151
 
178
- compare_scans = subparsers.add_parser("compare-scans")
179
- compare_scans.add_argument("--before-scan-id", required=True)
180
- compare_scans.add_argument("--after-scan-id", required=True)
152
+ compare_scans = add_command("compare-scans", "--before-scan-id", "--after-scan-id")
181
153
  compare_scans.add_argument("--include-matching-inputs", action="store_true")
182
154
  compare_scans.add_argument("--require-matches", action="store_true")
183
155
 
@@ -196,68 +168,68 @@ def parse_args(description: str) -> argparse.Namespace:
196
168
  list_global_findings.add_argument("--severity", choices=FINDING_SEVERITIES)
197
169
  list_global_findings.add_argument("--status", choices=FINDING_STATUSES)
198
170
  list_global_findings.add_argument("--target-id")
199
- list_global_findings.add_argument("--offset", type=non_negative_int, default=0)
171
+ list_global_findings.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
200
172
  list_global_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
201
173
  list_repositories = subparsers.add_parser("list-repositories")
202
174
  list_repositories.add_argument("--query")
203
175
  list_repositories.add_argument("--target-id")
204
176
  list_repositories.add_argument("--status", choices=("scanned", "not_scanned", "open_findings"))
205
- list_repositories.add_argument("--offset", type=non_negative_int, default=0)
177
+ list_repositories.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
206
178
  list_repositories.add_argument("--limit", type=positive_int)
207
179
 
208
- list_findings = subparsers.add_parser("list-findings")
209
- list_findings.add_argument("--scan-id", required=True)
180
+ list_findings = add_command("list-findings", "--scan-id")
210
181
  list_findings.add_argument("--query")
211
182
  list_findings.add_argument("--severity", choices=FINDING_SEVERITIES)
212
183
  list_findings.add_argument("--status", choices=FINDING_STATUSES)
213
- list_findings.add_argument("--offset", type=non_negative_int, default=0)
184
+ list_findings.add_argument("--offset", type=deep_scan.non_negative_int, default=0)
214
185
  list_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
215
186
 
216
- update_progress = subparsers.add_parser("update-progress")
217
- update_progress.add_argument("--scan-id", required=True)
187
+ update_progress = add_command("update-progress", "--scan-id")
218
188
  update_progress.add_argument("--phase", choices=PHASES)
219
- update_progress.add_argument("--phase-items-total", type=non_negative_int)
220
- update_progress.add_argument("--phase-items-completed", type=non_negative_int)
189
+ update_progress.add_argument("--phase-items-total", type=deep_scan.non_negative_int)
190
+ update_progress.add_argument("--phase-items-completed", type=deep_scan.non_negative_int)
221
191
  update_progress.add_argument("--phase-progress-unit", choices=PHASE_PROGRESS_UNITS)
222
192
  preflight_issues = update_progress.add_mutually_exclusive_group()
223
193
  preflight_issues.add_argument("--preflight-issues-json")
224
194
  preflight_issues.add_argument("--preflight-issues-json-stdin", action="store_true")
225
- update_progress.add_argument("--review-items-total", type=non_negative_int)
226
- update_progress.add_argument("--review-items-completed", type=non_negative_int)
227
- update_progress.add_argument("--reportable-findings-count", type=non_negative_int)
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)
228
198
  update_progress.add_argument("--deep-review-pass", type=positive_int)
229
199
  update_progress.add_argument("--claim-token")
230
200
  update_progress.add_argument("--coordinator-generation", type=positive_int)
231
201
  update_progress.add_argument("--model")
232
202
  update_progress.add_argument("--reasoning-effort")
233
203
 
234
- prepare_scan_completion = subparsers.add_parser("prepare-scan-completion")
235
- prepare_scan_completion.add_argument("--scan-id", required=True)
204
+ prepare_scan_completion = add_command("prepare-scan-completion", "--scan-id")
236
205
  prepare_scan_completion.add_argument("--claim-token")
237
206
 
238
- complete_scan = subparsers.add_parser("complete-scan")
239
- complete_scan.add_argument("--scan-id", required=True)
207
+ complete_scan = add_command("complete-scan", "--scan-id")
240
208
  complete_scan.add_argument("--claim-token")
241
209
  complete_scan.add_argument("--cost-json")
242
210
  complete_scan.add_argument("--thread-id")
211
+ complete_scan.add_argument("--turn-id")
243
212
 
244
- complete_budget_exhausted_scan = subparsers.add_parser("complete-budget-exhausted-scan")
245
- complete_budget_exhausted_scan.add_argument("--scan-id", required=True)
246
- complete_budget_exhausted_scan.add_argument("--cost-json", required=True)
213
+ finalize_scan_usage = add_command(
214
+ "finalize-scan-usage", "--scan-id", "--thread-id", "--turn-id"
215
+ )
216
+ finalize_scan_usage.add_argument(
217
+ "--turn-status", choices=("completed", "interrupted", "failed"), default="completed"
218
+ )
219
+
220
+ complete_budget_exhausted_scan = add_command(
221
+ "complete-budget-exhausted-scan", "--scan-id", "--cost-json"
222
+ )
247
223
  complete_budget_exhausted_scan.add_argument("--message")
248
224
 
249
- cancel_scan = subparsers.add_parser("cancel-scan")
250
- cancel_scan.add_argument("--scan-id", required=True)
225
+ cancel_scan = add_command("cancel-scan", "--scan-id")
251
226
  cancel_scan.add_argument("--thread-id")
252
227
 
253
- fail_scan = subparsers.add_parser("fail-scan")
254
- fail_scan.add_argument("--scan-id", required=True)
255
- fail_scan.add_argument("--message", required=True)
228
+ fail_scan = add_command("fail-scan", "--scan-id", "--message")
256
229
  fail_scan.add_argument("--claim-token")
257
230
  fail_scan.add_argument("--cost-json")
258
231
 
259
- preserve_scan = subparsers.add_parser("preserve-scan-results")
260
- preserve_scan.add_argument("--scan-id", required=True)
232
+ preserve_scan = add_command("preserve-scan-results", "--scan-id")
261
233
  preserve_scan.add_argument("--thread-id")
262
234
  preserve_scan.add_argument("--claim-token")
263
235
  preserve_scan.add_argument("--coordinator-generation", type=positive_int)
@@ -268,56 +240,37 @@ def parse_args(description: str) -> argparse.Namespace:
268
240
  )
269
241
  recover_scan.add_argument("--scan-id", required=True, help="ID of the stopped scan to recover.")
270
242
 
271
- write_scan_draft = subparsers.add_parser("write-scan-draft")
272
- write_scan_draft.add_argument("--scan-id", required=True)
273
- write_scan_draft.add_argument("--draft-path", required=True)
243
+ write_scan_draft = add_command("write-scan-draft", "--scan-id", "--draft-path")
274
244
  write_scan_draft.add_argument("--checkpoint-path")
275
245
  write_scan_draft.add_argument("--expected-draft-digest")
276
246
  write_scan_draft.add_argument("--claim-token")
277
247
 
278
- save_scan_artifact = subparsers.add_parser("save-scan-artifact")
279
- save_scan_artifact.add_argument("--scan-id", required=True)
280
- save_scan_artifact.add_argument("--artifact-path", required=True)
248
+ save_scan_artifact = add_command("save-scan-artifact", "--scan-id", "--artifact-path")
281
249
  save_scan_artifact.add_argument("--claim-token")
282
250
 
283
251
  for command in ("save-artifact", "read-artifact"):
284
- artifact = subparsers.add_parser(command)
285
- artifact.add_argument("--artifact-root", required=True)
286
- artifact.add_argument("--artifact-path", required=True)
252
+ add_command(command, "--artifact-root", "--artifact-path")
287
253
 
288
- mark_handoff_delivered = subparsers.add_parser("mark-handoff-delivered")
289
- mark_handoff_delivered.add_argument("--scan-id", required=True)
290
- mark_handoff_delivered.add_argument("--claim-token", required=True)
254
+ mark_handoff_delivered = add_command("mark-handoff-delivered", "--scan-id", "--claim-token")
291
255
  mark_handoff_delivered.add_argument("--thread-id")
292
256
 
293
- claim_handoff_delivery = subparsers.add_parser("claim-handoff-delivery")
294
- claim_handoff_delivery.add_argument("--scan-id", required=True)
295
- claim_handoff_delivery.add_argument("--claim-token", required=True)
257
+ claim_handoff_delivery = add_command("claim-handoff-delivery", "--scan-id", "--claim-token")
296
258
  claim_handoff_delivery.add_argument("--take-over-stale", action="store_true")
297
259
 
298
- release_handoff_delivery = subparsers.add_parser("release-handoff-delivery")
299
- release_handoff_delivery.add_argument("--scan-id", required=True)
300
- release_handoff_delivery.add_argument("--claim-token", required=True)
260
+ add_command("release-handoff-delivery", "--scan-id", "--claim-token")
301
261
 
302
- attach_scan_continuation_thread = subparsers.add_parser("attach-scan-continuation-thread")
303
- attach_scan_continuation_thread.add_argument("--scan-id", required=True)
304
- attach_scan_continuation_thread.add_argument("--claim-token", required=True)
305
- attach_scan_continuation_thread.add_argument("--thread-id", required=True)
262
+ add_command("attach-scan-continuation-thread", "--scan-id", "--claim-token", "--thread-id")
306
263
 
307
- set_finding_triage = subparsers.add_parser("set-finding-triage")
308
- set_finding_triage.add_argument("--occurrence-id", required=True)
264
+ set_finding_triage = add_command("set-finding-triage", "--occurrence-id")
309
265
  set_finding_triage.add_argument("--status", choices=FINDING_STATUSES, required=True)
310
266
  set_finding_triage.add_argument("--close-reason", choices=FINDING_CLOSE_REASONS)
311
267
  set_finding_triage.add_argument("--note")
312
268
 
313
- request_finding_remediation = subparsers.add_parser("request-finding-remediation")
314
- request_finding_remediation.add_argument("--occurrence-id", required=True)
315
- request_finding_remediation.add_argument("--request-id", required=True)
316
- request_finding_remediation.add_argument("--action-token", required=True)
269
+ add_command("request-finding-remediation", "--occurrence-id", "--request-id", "--action-token")
317
270
 
318
- request_finding_remediation_action = subparsers.add_parser("request-finding-remediation-action")
319
- request_finding_remediation_action.add_argument("--occurrence-id", required=True)
320
- request_finding_remediation_action.add_argument("--request-id", required=True)
271
+ request_finding_remediation_action = add_command(
272
+ "request-finding-remediation-action", "--occurrence-id", "--request-id"
273
+ )
321
274
  request_finding_remediation_action.add_argument(
322
275
  "--expected-version", type=positive_int, required=True
323
276
  )
@@ -326,30 +279,17 @@ def parse_args(description: str) -> argparse.Namespace:
326
279
  )
327
280
  request_finding_remediation_action.add_argument("--action-token", required=True)
328
281
 
329
- claim_finding_remediation_resend = subparsers.add_parser("claim-finding-remediation-resend")
330
- claim_finding_remediation_resend.add_argument("--occurrence-id", required=True)
331
- claim_finding_remediation_resend.add_argument("--request-id", required=True)
332
- claim_finding_remediation_resend.add_argument("--action-token", required=True)
333
-
334
- mark_finding_remediation_delivered = subparsers.add_parser("mark-finding-remediation-delivered")
335
- mark_finding_remediation_delivered.add_argument("--occurrence-id", required=True)
336
- mark_finding_remediation_delivered.add_argument("--request-id", required=True)
337
- mark_finding_remediation_delivered.add_argument("--action-token", required=True)
338
-
339
- release_finding_remediation_claim = subparsers.add_parser("release-finding-remediation-claim")
340
- release_finding_remediation_claim.add_argument("--occurrence-id", required=True)
341
- release_finding_remediation_claim.add_argument("--request-id", required=True)
342
- release_finding_remediation_claim.add_argument("--action-token", required=True)
343
-
344
- cancel_remediation = subparsers.add_parser("cancel-finding-remediation-request")
345
- cancel_remediation.add_argument("--occurrence-id", required=True)
346
- cancel_remediation.add_argument("--request-id", required=True)
347
- cancel_remediation.add_argument("--action-token", required=True)
348
-
349
- set_finding_remediation = subparsers.add_parser("set-finding-remediation")
350
- set_finding_remediation.add_argument("--occurrence-id", required=True)
351
- set_finding_remediation.add_argument("--request-id", required=True)
352
- set_finding_remediation.add_argument("--action-token", required=True)
282
+ for command in (
283
+ "claim-finding-remediation-resend",
284
+ "mark-finding-remediation-delivered",
285
+ "release-finding-remediation-claim",
286
+ "cancel-finding-remediation-request",
287
+ ):
288
+ add_command(command, "--occurrence-id", "--request-id", "--action-token")
289
+
290
+ set_finding_remediation = add_command(
291
+ "set-finding-remediation", "--occurrence-id", "--request-id", "--action-token"
292
+ )
353
293
  set_finding_remediation.add_argument("--expected-version", type=positive_int, required=True)
354
294
  set_finding_remediation.add_argument(
355
295
  "--state", choices=REMEDIATION_UPDATE_STATES, required=True
@@ -360,40 +300,18 @@ def parse_args(description: str) -> argparse.Namespace:
360
300
  set_finding_remediation.add_argument("--base-revision")
361
301
  set_finding_remediation.add_argument("--verification-summary")
362
302
 
363
- export_findings = subparsers.add_parser("export-findings")
364
- export_findings.add_argument("--scan-id", required=True)
303
+ export_findings = add_command("export-findings", "--scan-id")
365
304
  export_findings.add_argument(
366
305
  "--artifact", choices=("findings", "threat-model"), default="findings"
367
306
  )
368
307
  export_findings.add_argument("--format", choices=(*EXPORT_FORMATS, "md"))
369
308
  export_findings.add_argument("--validate-only", action="store_true")
370
309
 
371
- for command in (
372
- "inspect-linear-publication",
373
- "prepare-linear-publication",
374
- "record-linear-publications",
375
- ):
376
- publication = subparsers.add_parser(command)
377
- publication.add_argument("--input-file", required=True)
310
+ subparsers.add_parser("finding-issues")
378
311
 
379
312
  subparsers.add_parser("database-info")
380
- subparsers.add_parser("dashboard")
381
313
  subparsers.add_parser("finding-workflow")
382
- subparsers.add_parser("severity-classification")
383
- severity = subparsers.add_parser("read-severity-classification")
384
- severity.add_argument("--scan-id", required=True)
385
- subparsers.add_parser("store-findings")
386
- subparsers.add_parser("store-dedupe-groups")
387
- dedupe_groups = subparsers.add_parser("list-dedupe-groups")
388
- dedupe_groups.add_argument("--finding-id", required=True)
389
- potential_duplicates = subparsers.add_parser("find-potential-duplicates")
390
- potential_duplicates.add_argument("--finding-id", required=True)
391
- scope = potential_duplicates.add_mutually_exclusive_group(required=True)
392
- scope.add_argument("--repository-id")
393
- scope.add_argument("--all-repositories", action="store_true")
394
- stored_findings = subparsers.add_parser("list-stored-findings")
395
- stored_findings.add_argument("--limit", type=positive_int, required=True)
396
- stored_findings.add_argument("--offset", type=non_negative_int, required=True)
314
+ subparsers.add_parser("local-dedupe")
397
315
  arguments = sys.argv[1:]
398
316
  if "--user-context-stdin" in arguments:
399
317
  if arguments.count("--user-context-stdin") != 1 or "--user-context" in arguments: