@openai/codex-security 0.8.2 → 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 (375) hide show
  1. package/README.md +43 -61
  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/darwin-arm64/unix.node +0 -0
  7. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  13. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  14. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +46 -12
  15. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  16. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  17. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  18. package/_bundled_plugin/references/artifact-storage.md +1 -1
  19. package/_bundled_plugin/references/core-scan.md +14 -5
  20. package/_bundled_plugin/references/default-severity-rubric.md +28 -0
  21. package/_bundled_plugin/references/finding-detail-fields.md +1 -0
  22. package/_bundled_plugin/references/threat-model.md +1 -0
  23. package/_bundled_plugin/scripts/deep_scan_workbench.py +23 -112
  24. package/_bundled_plugin/scripts/finalize_scan_contract.py +167 -153
  25. package/_bundled_plugin/scripts/finding_preview.py +5 -29
  26. package/_bundled_plugin/scripts/posix_scan_local_files.py +187 -0
  27. package/_bundled_plugin/scripts/report_projection.py +87 -136
  28. package/_bundled_plugin/scripts/validate_scan_contract.py +2 -6
  29. package/_bundled_plugin/scripts/windows_scan_local_files.py +212 -55
  30. package/_bundled_plugin/scripts/workbench/retained_coverage.py +8 -24
  31. package/_bundled_plugin/scripts/workbench/saved_coverage.py +143 -231
  32. package/_bundled_plugin/scripts/workbench_cli.py +102 -13
  33. package/_bundled_plugin/scripts/workbench_constants.py +9 -0
  34. package/_bundled_plugin/scripts/workbench_db.py +186 -360
  35. package/_bundled_plugin/scripts/workbench_finding_workflows.py +86 -4
  36. package/_bundled_plugin/scripts/workbench_native_indexes.py +17 -21
  37. package/_bundled_plugin/scripts/workbench_remediation.py +495 -11
  38. package/_bundled_plugin/scripts/workbench_scan_history.py +22 -25
  39. package/_bundled_plugin/scripts/workbench_scan_start.py +1 -1
  40. package/_bundled_plugin/scripts/workbench_scan_usage.py +25 -52
  41. package/_bundled_plugin/scripts/workbench_schema.py +1 -1
  42. package/_bundled_plugin/scripts/workbench_setup.py +239 -0
  43. package/_bundled_plugin/scripts/workbench_source_scopes.py +15 -23
  44. package/_bundled_plugin/scripts/workbench_target.py +213 -20
  45. package/_bundled_plugin/scripts/workbench_validation.py +1 -9
  46. package/_bundled_plugin/shared/workbench-history-repairs.json +7 -0
  47. package/_bundled_plugin/shared/workbench-migrations.json +19 -0
  48. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  49. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  50. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  51. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  52. package/_bundled_plugin/skills/cloud-findings/SKILL.md +2 -0
  53. package/_bundled_plugin/skills/fix-finding/SKILL.md +18 -1
  54. package/_bundled_plugin/skills/publish-findings/SKILL.md +64 -35
  55. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +2 -21
  56. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +14 -8
  57. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  58. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  59. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -4
  60. package/dist/api.d.ts +6 -1
  61. package/dist/api.d.ts.map +1 -1
  62. package/dist/api.js +411 -160
  63. package/dist/api.js.map +1 -1
  64. package/dist/auth.js +6 -1
  65. package/dist/auth.js.map +1 -1
  66. package/dist/blackduck-findings.d.ts +8 -0
  67. package/dist/blackduck-findings.d.ts.map +1 -0
  68. package/dist/blackduck-findings.js +305 -0
  69. package/dist/blackduck-findings.js.map +1 -0
  70. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  71. package/dist/bulk-scan-discovery.js +51 -36
  72. package/dist/bulk-scan-discovery.js.map +1 -1
  73. package/dist/classify-severity-records.d.ts +5 -0
  74. package/dist/classify-severity-records.d.ts.map +1 -1
  75. package/dist/classify-severity-records.js +6 -8
  76. package/dist/classify-severity-records.js.map +1 -1
  77. package/dist/classify-severity.d.ts +4 -1
  78. package/dist/classify-severity.d.ts.map +1 -1
  79. package/dist/classify-severity.js +28 -9
  80. package/dist/classify-severity.js.map +1 -1
  81. package/dist/cli.d.ts +3 -0
  82. package/dist/cli.d.ts.map +1 -1
  83. package/dist/cli.js +608 -258
  84. package/dist/cli.js.map +1 -1
  85. package/dist/codex-prompt.d.ts +2 -0
  86. package/dist/codex-prompt.d.ts.map +1 -1
  87. package/dist/codex-prompt.js +6 -0
  88. package/dist/codex-prompt.js.map +1 -1
  89. package/dist/component-scan.d.ts.map +1 -1
  90. package/dist/component-scan.js +6 -5
  91. package/dist/component-scan.js.map +1 -1
  92. package/dist/config.d.ts +2 -1
  93. package/dist/config.d.ts.map +1 -1
  94. package/dist/config.js +162 -40
  95. package/dist/config.js.map +1 -1
  96. package/dist/continuum-findings.d.ts +7 -0
  97. package/dist/continuum-findings.d.ts.map +1 -0
  98. package/dist/continuum-findings.js +157 -0
  99. package/dist/continuum-findings.js.map +1 -0
  100. package/dist/contract-values.d.ts +28 -0
  101. package/dist/contract-values.d.ts.map +1 -0
  102. package/dist/contract-values.js +75 -0
  103. package/dist/contract-values.js.map +1 -0
  104. package/dist/contract.d.ts +2 -20
  105. package/dist/contract.d.ts.map +1 -1
  106. package/dist/contract.js +58 -669
  107. package/dist/contract.js.map +1 -1
  108. package/dist/cost-model.d.ts.map +1 -1
  109. package/dist/cost-model.js +1 -4
  110. package/dist/cost-model.js.map +1 -1
  111. package/dist/cost.d.ts +19 -1
  112. package/dist/cost.d.ts.map +1 -1
  113. package/dist/cost.js +2120 -39
  114. package/dist/cost.js.map +1 -1
  115. package/dist/custom-validation-prompt.d.ts +1 -1
  116. package/dist/custom-validation-prompt.d.ts.map +1 -1
  117. package/dist/custom-validation-prompt.js +5 -0
  118. package/dist/custom-validation-prompt.js.map +1 -1
  119. package/dist/custom-validation.d.ts +2 -0
  120. package/dist/custom-validation.d.ts.map +1 -1
  121. package/dist/custom-validation.js +4 -0
  122. package/dist/custom-validation.js.map +1 -1
  123. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  124. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  125. package/dist/deduplication/deduplication-prompts.js +2 -2
  126. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  127. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  128. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  129. package/dist/deduplication/deduplication-reviewer.js +11 -4
  130. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  131. package/dist/deduplication/deduplication.js.map +1 -1
  132. package/dist/deduplication/finding-schema.d.ts +19 -1
  133. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  134. package/dist/deduplication/finding-schema.js +25 -0
  135. package/dist/deduplication/finding-schema.js.map +1 -1
  136. package/dist/deduplication/local.d.ts.map +1 -1
  137. package/dist/deduplication/local.js +3 -8
  138. package/dist/deduplication/local.js.map +1 -1
  139. package/dist/deduplication/records.d.ts +8 -2
  140. package/dist/deduplication/records.d.ts.map +1 -1
  141. package/dist/deduplication/records.js +36 -8
  142. package/dist/deduplication/records.js.map +1 -1
  143. package/dist/deep-scan.d.ts +11 -0
  144. package/dist/deep-scan.d.ts.map +1 -1
  145. package/dist/deep-scan.js +235 -4
  146. package/dist/deep-scan.js.map +1 -1
  147. package/dist/default-severity-rubric.d.ts +1 -2
  148. package/dist/default-severity-rubric.d.ts.map +1 -1
  149. package/dist/default-severity-rubric.js +2 -66
  150. package/dist/default-severity-rubric.js.map +1 -1
  151. package/dist/endor-findings.d.ts.map +1 -1
  152. package/dist/endor-findings.js +7 -37
  153. package/dist/endor-findings.js.map +1 -1
  154. package/dist/errors.js +1 -1
  155. package/dist/errors.js.map +1 -1
  156. package/dist/external-findings-import.d.ts.map +1 -1
  157. package/dist/external-findings-import.js +5 -11
  158. package/dist/external-findings-import.js.map +1 -1
  159. package/dist/external-findings-local.d.ts +9 -0
  160. package/dist/external-findings-local.d.ts.map +1 -1
  161. package/dist/external-findings-local.js +325 -179
  162. package/dist/external-findings-local.js.map +1 -1
  163. package/dist/external-findings-publish.d.ts +12 -0
  164. package/dist/external-findings-publish.d.ts.map +1 -1
  165. package/dist/external-findings-publish.js +1202 -214
  166. package/dist/external-findings-publish.js.map +1 -1
  167. package/dist/external-findings-read.d.ts +8 -0
  168. package/dist/external-findings-read.d.ts.map +1 -1
  169. package/dist/external-findings-read.js +65 -54
  170. package/dist/external-findings-read.js.map +1 -1
  171. package/dist/external-findings.d.ts +2 -0
  172. package/dist/external-findings.d.ts.map +1 -1
  173. package/dist/external-findings.js +111 -0
  174. package/dist/external-findings.js.map +1 -1
  175. package/dist/external-import-contract.d.ts +29 -1
  176. package/dist/external-import-contract.d.ts.map +1 -1
  177. package/dist/external-import-contract.js +314 -44
  178. package/dist/external-import-contract.js.map +1 -1
  179. package/dist/external-import-models.d.ts +1 -1
  180. package/dist/external-import-models.d.ts.map +1 -1
  181. package/dist/external-import-models.js.map +1 -1
  182. package/dist/finding-normalization.d.ts +1 -1
  183. package/dist/finding-normalization.d.ts.map +1 -1
  184. package/dist/finding-normalization.js +46 -11
  185. package/dist/finding-normalization.js.map +1 -1
  186. package/dist/finding-retrieval.d.ts +3 -3
  187. package/dist/finding-retrieval.d.ts.map +1 -1
  188. package/dist/finding-retrieval.js.map +1 -1
  189. package/dist/finding-workflow.d.ts +6 -1
  190. package/dist/finding-workflow.d.ts.map +1 -1
  191. package/dist/finding-workflow.js +2 -2
  192. package/dist/finding-workflow.js.map +1 -1
  193. package/dist/git-remote.d.ts +4 -0
  194. package/dist/git-remote.d.ts.map +1 -1
  195. package/dist/git-remote.js +20 -0
  196. package/dist/git-remote.js.map +1 -1
  197. package/dist/github-advisories.d.ts +3 -12
  198. package/dist/github-advisories.d.ts.map +1 -1
  199. package/dist/github-advisories.js +9 -29
  200. package/dist/github-advisories.js.map +1 -1
  201. package/dist/github-dependabot-findings.d.ts.map +1 -1
  202. package/dist/github-dependabot-findings.js +7 -16
  203. package/dist/github-dependabot-findings.js.map +1 -1
  204. package/dist/github-findings.d.ts.map +1 -1
  205. package/dist/github-findings.js +344 -56
  206. package/dist/github-findings.js.map +1 -1
  207. package/dist/github.d.ts +17 -7
  208. package/dist/github.d.ts.map +1 -1
  209. package/dist/github.js +43 -30
  210. package/dist/github.js.map +1 -1
  211. package/dist/host-protocol.d.ts +2 -2
  212. package/dist/host-protocol.d.ts.map +1 -1
  213. package/dist/host-protocol.js.map +1 -1
  214. package/dist/host-records-protocol.d.ts +10 -11
  215. package/dist/host-records-protocol.d.ts.map +1 -1
  216. package/dist/host-records-protocol.js +69 -9
  217. package/dist/host-records-protocol.js.map +1 -1
  218. package/dist/hosted-scan.d.ts +15 -0
  219. package/dist/hosted-scan.d.ts.map +1 -1
  220. package/dist/hosted-scan.js +55 -33
  221. package/dist/hosted-scan.js.map +1 -1
  222. package/dist/index.d.ts +7 -0
  223. package/dist/index.d.ts.map +1 -1
  224. package/dist/index.js +6 -0
  225. package/dist/index.js.map +1 -1
  226. package/dist/inspector-findings.d.ts.map +1 -1
  227. package/dist/inspector-findings.js +13 -18
  228. package/dist/inspector-findings.js.map +1 -1
  229. package/dist/knowledge-base.js +18 -5
  230. package/dist/knowledge-base.js.map +1 -1
  231. package/dist/local-git-metadata.d.ts +5 -0
  232. package/dist/local-git-metadata.d.ts.map +1 -0
  233. package/dist/local-git-metadata.js +131 -0
  234. package/dist/local-git-metadata.js.map +1 -0
  235. package/dist/multiscan.d.ts.map +1 -1
  236. package/dist/multiscan.js +22 -12
  237. package/dist/multiscan.js.map +1 -1
  238. package/dist/opengrep-findings.d.ts.map +1 -1
  239. package/dist/opengrep-findings.js +34 -20
  240. package/dist/opengrep-findings.js.map +1 -1
  241. package/dist/patch-tui.d.ts.map +1 -1
  242. package/dist/patch-tui.js +90 -35
  243. package/dist/patch-tui.js.map +1 -1
  244. package/dist/private-finding-import.d.ts +246 -0
  245. package/dist/private-finding-import.d.ts.map +1 -0
  246. package/dist/private-finding-import.js +387 -0
  247. package/dist/private-finding-import.js.map +1 -0
  248. package/dist/project-config.d.ts.map +1 -1
  249. package/dist/project-config.js +2 -2
  250. package/dist/project-config.js.map +1 -1
  251. package/dist/provider-profile.d.ts +10 -2
  252. package/dist/provider-profile.d.ts.map +1 -1
  253. package/dist/provider-profile.js +72 -10
  254. package/dist/provider-profile.js.map +1 -1
  255. package/dist/publication.js +7 -1
  256. package/dist/publication.js.map +1 -1
  257. package/dist/reader-selection.d.ts +13 -0
  258. package/dist/reader-selection.d.ts.map +1 -0
  259. package/dist/reader-selection.js +81 -0
  260. package/dist/reader-selection.js.map +1 -0
  261. package/dist/record.d.ts +6 -1
  262. package/dist/record.d.ts.map +1 -1
  263. package/dist/record.js +53 -2
  264. package/dist/record.js.map +1 -1
  265. package/dist/remediation.d.ts +5 -0
  266. package/dist/remediation.d.ts.map +1 -1
  267. package/dist/remediation.js +30 -0
  268. package/dist/remediation.js.map +1 -1
  269. package/dist/result.d.ts +2 -0
  270. package/dist/result.d.ts.map +1 -1
  271. package/dist/result.js +3 -1
  272. package/dist/result.js.map +1 -1
  273. package/dist/runtime.d.ts +2 -1
  274. package/dist/runtime.d.ts.map +1 -1
  275. package/dist/runtime.js +95 -52
  276. package/dist/runtime.js.map +1 -1
  277. package/dist/scan-activity.js +40 -17
  278. package/dist/scan-activity.js.map +1 -1
  279. package/dist/scan-comparison.d.ts +1 -1
  280. package/dist/scan-comparison.d.ts.map +1 -1
  281. package/dist/scan-comparison.js +11 -13
  282. package/dist/scan-comparison.js.map +1 -1
  283. package/dist/scan-dashboard.d.ts +1 -0
  284. package/dist/scan-dashboard.d.ts.map +1 -1
  285. package/dist/scan-dashboard.js +16 -37
  286. package/dist/scan-dashboard.js.map +1 -1
  287. package/dist/scan-executor.d.ts +2 -0
  288. package/dist/scan-executor.d.ts.map +1 -1
  289. package/dist/scan-executor.js.map +1 -1
  290. package/dist/scan-history-renderer.d.ts.map +1 -1
  291. package/dist/scan-history-renderer.js +22 -9
  292. package/dist/scan-history-renderer.js.map +1 -1
  293. package/dist/scan-logs.d.ts.map +1 -1
  294. package/dist/scan-logs.js +5 -5
  295. package/dist/scan-logs.js.map +1 -1
  296. package/dist/scanner-import.d.ts +46 -6
  297. package/dist/scanner-import.d.ts.map +1 -1
  298. package/dist/scanner-import.js +208 -42
  299. package/dist/scanner-import.js.map +1 -1
  300. package/dist/scanner-repository-url.d.ts +14 -0
  301. package/dist/scanner-repository-url.d.ts.map +1 -0
  302. package/dist/scanner-repository-url.js +67 -0
  303. package/dist/scanner-repository-url.js.map +1 -0
  304. package/dist/semgrep-findings.d.ts.map +1 -1
  305. package/dist/semgrep-findings.js +20 -48
  306. package/dist/semgrep-findings.js.map +1 -1
  307. package/dist/semgrep-platform-findings.d.ts +12 -0
  308. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  309. package/dist/semgrep-platform-findings.js +198 -0
  310. package/dist/semgrep-platform-findings.js.map +1 -0
  311. package/dist/severity-rubric.d.ts +20 -0
  312. package/dist/severity-rubric.d.ts.map +1 -0
  313. package/dist/severity-rubric.js +73 -0
  314. package/dist/severity-rubric.js.map +1 -0
  315. package/dist/severity-store.js +15 -5
  316. package/dist/severity-store.js.map +1 -1
  317. package/dist/snyk-findings.d.ts.map +1 -1
  318. package/dist/snyk-findings.js +21 -20
  319. package/dist/snyk-findings.js.map +1 -1
  320. package/dist/sonar-collector.d.ts +16 -0
  321. package/dist/sonar-collector.d.ts.map +1 -0
  322. package/dist/sonar-collector.js +383 -0
  323. package/dist/sonar-collector.js.map +1 -0
  324. package/dist/sonar-findings.d.ts +49 -0
  325. package/dist/sonar-findings.d.ts.map +1 -0
  326. package/dist/sonar-findings.js +288 -0
  327. package/dist/sonar-findings.js.map +1 -0
  328. package/dist/sonar-import.d.ts +111 -0
  329. package/dist/sonar-import.d.ts.map +1 -0
  330. package/dist/sonar-import.js +279 -0
  331. package/dist/sonar-import.js.map +1 -0
  332. package/dist/suggest-owners.d.ts.map +1 -1
  333. package/dist/suggest-owners.js +2 -1
  334. package/dist/suggest-owners.js.map +1 -1
  335. package/dist/targets.d.ts +3 -0
  336. package/dist/targets.d.ts.map +1 -1
  337. package/dist/targets.js +18 -12
  338. package/dist/targets.js.map +1 -1
  339. package/dist/terminal-columns.d.ts +4 -0
  340. package/dist/terminal-columns.d.ts.map +1 -0
  341. package/dist/terminal-columns.js +19 -0
  342. package/dist/terminal-columns.js.map +1 -0
  343. package/dist/validation-records.d.ts +0 -3
  344. package/dist/validation-records.d.ts.map +1 -1
  345. package/dist/validation-records.js +0 -16
  346. package/dist/validation-records.js.map +1 -1
  347. package/dist/veracode-findings.d.ts +7 -0
  348. package/dist/veracode-findings.d.ts.map +1 -0
  349. package/dist/veracode-findings.js +371 -0
  350. package/dist/veracode-findings.js.map +1 -0
  351. package/dist/windows-path.d.ts.map +1 -1
  352. package/dist/windows-path.js +1 -0
  353. package/dist/windows-path.js.map +1 -1
  354. package/dist/wiz-csv.d.ts +2 -2
  355. package/dist/wiz-csv.d.ts.map +1 -1
  356. package/dist/wiz-csv.js +1 -3
  357. package/dist/wiz-csv.js.map +1 -1
  358. package/dist/wiz-findings.d.ts +10 -2
  359. package/dist/wiz-findings.d.ts.map +1 -1
  360. package/dist/wiz-findings.js +88 -49
  361. package/dist/wiz-findings.js.map +1 -1
  362. package/docs/classify-severity-records.md +1 -1
  363. package/docs/cli.md +310 -477
  364. package/docs/dedupe-records.md +10 -0
  365. package/docs/findings-service.md +21 -8
  366. package/docs/hosted-scans.md +16 -1
  367. package/package.json +8 -9
  368. package/schemas/external-findings.schema.json +12 -1
  369. package/schemas/hosted-scan-v2.fixture.json +16 -1
  370. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  371. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  372. package/dist/deduplication/records-protocol.d.ts +0 -4
  373. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  374. package/dist/deduplication/records-protocol.js +0 -49
  375. 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: