@openai/codex-security 0.8.2 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -8,6 +8,7 @@ from pathlib import Path
8
8
 
9
9
  _SHARED = Path(__file__).resolve().parents[1] / "shared"
10
10
  _HISTORY = json.loads((_SHARED / "workbench-migrations.json").read_text(encoding="utf-8"))
11
+ _STATEMENTS = {migration["version"]: migration["statements"] for migration in _HISTORY}
11
12
  _REPAIR_HISTORY = json.dumps(_HISTORY)
12
13
  _REPAIR_PLAN = json.loads((_SHARED / "workbench-history-repairs.json").read_text(encoding="utf-8"))
13
14
  MIGRATIONS = tuple(
@@ -52,6 +53,12 @@ def apply_migrations(
52
53
  *,
53
54
  immediate: bool = False,
54
55
  ) -> None:
56
+ """Apply missing schema versions and repair supported historical migrations.
57
+
58
+ Commit pending work on the connection before starting the migration transaction.
59
+ Set immediate to acquire the SQLite write lock up front. The backfill callback
60
+ links older scans and workspaces to stable targets when required.
61
+ """
55
62
  connection.commit()
56
63
  connection.execute("BEGIN IMMEDIATE" if immediate else "BEGIN")
57
64
  with connection:
@@ -71,12 +78,14 @@ def apply_migrations(
71
78
  should_backfill_targets = False
72
79
  for version, name, sql in migrations:
73
80
  if version == 6:
74
- repair_thread_scoped_workspaces_migration(connection)
81
+ # Preserve the original one-line index declaration in sqlite_schema.
82
+ for statement in _STATEMENTS[6]:
83
+ apply_repair_statement(connection, statement.replace("\n", " "))
75
84
  elif version == 16:
76
85
  should_backfill_targets = repair_stable_targets_migration(connection)
77
86
  elif version in applied:
78
- if version in (2, 12, 13, 26, 28, 31, 32, 42, 47, 50, 54, 55):
79
- repair_additive_migration(connection, version)
87
+ if version in (2, 12, 13, 26, 28, 31, 32, 42, 47, 50, 54, 55, 58, 59, 60, 61):
88
+ repair_schema(connection, version)
80
89
  elif version == 11:
81
90
  repair_deep_scan_migration(connection)
82
91
  else:
@@ -106,7 +115,7 @@ def normalize_pre_release_migrations(connection: sqlite3.Connection, timestamp:
106
115
  if operation == "error":
107
116
  raise SystemExit(value)
108
117
  if operation == "additive":
109
- repair_additive_migration(connection, value)
118
+ repair_schema(connection, value)
110
119
  elif operation == "column":
111
120
  add_migration_column(connection, value)
112
121
  else:
@@ -134,19 +143,10 @@ def repair_deep_scan_migration(connection: sqlite3.Connection) -> None:
134
143
  if not owner_column_missing and expected_objects <= existing_objects:
135
144
  return
136
145
 
137
- if owner_column_missing:
138
- add_column_if_missing(connection, "scans", "deep_scan_owner_thread_id", "TEXT")
139
- migration_sql = next(sql for version, _, sql in MIGRATIONS if version == 11)
140
- for statement in sql_statements(migration_sql):
141
- if statement.startswith("ALTER TABLE scans"):
142
- continue
146
+ for statement in _STATEMENTS[11]:
143
147
  if statement.startswith("UPDATE scans") and not owner_column_missing:
144
148
  continue
145
- for prefix in ("CREATE UNIQUE INDEX ", "CREATE INDEX ", "CREATE TABLE "):
146
- if statement.startswith(prefix):
147
- statement = statement.replace(prefix, f"{prefix}IF NOT EXISTS ", 1)
148
- break
149
- connection.execute(statement)
149
+ apply_repair_statement(connection, statement)
150
150
  if statement.startswith("UPDATE scans") and "continuation_thread_id" in scan_columns:
151
151
  connection.execute(
152
152
  "UPDATE scans SET deep_scan_owner_thread_id = continuation_thread_id "
@@ -156,28 +156,18 @@ def repair_deep_scan_migration(connection: sqlite3.Connection) -> None:
156
156
 
157
157
 
158
158
  def repair_deep_scan_failure_counter_migration(connection: sqlite3.Connection) -> None:
159
- threshold_column, count_column, _backfill = sql_statements(
160
- next(sql for version, _, sql in MIGRATIONS if version == 27)
161
- )
162
- columns = {row["name"] for row in connection.execute("PRAGMA table_info(deep_scan_runs)")}
163
- threshold_missing = "stop_after_consecutive_errors" not in columns
164
- add_migration_column(connection, threshold_column)
165
- if threshold_missing:
166
- connection.execute(
167
- "UPDATE deep_scan_runs SET stop_after_consecutive_errors = stop_after_no_new"
168
- )
169
- add_migration_column(connection, count_column)
170
-
171
-
172
- def repair_thread_scoped_workspaces_migration(connection: sqlite3.Connection) -> None:
173
- add_column_if_missing(connection, "workspaces", "thread_id", "TEXT")
174
- connection.execute(
175
- "CREATE INDEX IF NOT EXISTS workspaces_by_thread_and_updated_at "
176
- "ON workspaces(thread_id, updated_at DESC)"
177
- )
159
+ threshold, count, backfill = _STATEMENTS[27]
160
+ if add_migration_column(connection, threshold):
161
+ connection.execute(backfill)
162
+ add_migration_column(connection, count)
178
163
 
179
164
 
180
165
  def repair_stable_targets_migration(connection: sqlite3.Connection) -> bool:
166
+ """Repair a partial target-ID migration and return whether the schema required repair.
167
+
168
+ Create missing target tables, columns, and indexes. Clear scan references
169
+ to missing target records so they can be backfilled.
170
+ """
181
171
  workspace_columns = {row["name"] for row in connection.execute("PRAGMA table_info(workspaces)")}
182
172
  scan_columns = {row["name"] for row in connection.execute("PRAGMA table_info(scans)")}
183
173
  existing_objects = {
@@ -193,14 +183,7 @@ def repair_stable_targets_migration(connection: sqlite3.Connection) -> bool:
193
183
  ):
194
184
  return False
195
185
 
196
- migration_sql = next(sql for version, _, sql in MIGRATIONS if version == 16)
197
- for statement in sql_statements(migration_sql):
198
- if statement.startswith(("ALTER TABLE workspaces", "ALTER TABLE scans")):
199
- add_migration_column(connection, statement)
200
- continue
201
- statement = statement.replace("CREATE TABLE ", "CREATE TABLE IF NOT EXISTS ", 1)
202
- statement = statement.replace("CREATE INDEX ", "CREATE INDEX IF NOT EXISTS ", 1)
203
- connection.execute(statement)
186
+ repair_schema(connection, 16)
204
187
  connection.execute(
205
188
  """
206
189
  UPDATE scans
@@ -214,25 +197,31 @@ def repair_stable_targets_migration(connection: sqlite3.Connection) -> bool:
214
197
  return True
215
198
 
216
199
 
217
- def repair_additive_migration(connection: sqlite3.Connection, version: int) -> None:
218
- sql = next(sql for migration_version, _, sql in MIGRATIONS if migration_version == version)
219
- for statement in sql_statements(sql):
200
+ def repair_schema(connection: sqlite3.Connection, version: int) -> None:
201
+ for statement in _STATEMENTS[version]:
202
+ apply_repair_statement(connection, statement)
203
+
204
+
205
+ def apply_repair_statement(connection: sqlite3.Connection, statement: str) -> None:
206
+ if statement.startswith("ALTER TABLE "):
220
207
  add_migration_column(connection, statement)
208
+ return
209
+ for prefix in ("CREATE UNIQUE INDEX ", "CREATE INDEX ", "CREATE TABLE "):
210
+ if statement.startswith(prefix):
211
+ statement = statement.replace(prefix, f"{prefix}IF NOT EXISTS ", 1)
212
+ break
213
+ connection.execute(statement)
221
214
 
222
215
 
223
- def add_migration_column(connection: sqlite3.Connection, statement: str) -> None:
216
+ def add_migration_column(connection: sqlite3.Connection, statement: str) -> bool:
224
217
  _, _, table, _, _, column, definition = statement.removesuffix(";").split(None, 6)
218
+ columns = {row["name"] for row in connection.execute(f"PRAGMA table_info({table})")}
219
+ if column in columns:
220
+ return False
225
221
  # Preserve the compact declarations used by historical repairs, including CHECK errors.
226
222
  definition = " ".join(definition.split()).replace("( ", "(").replace(" )", ")")
227
- add_column_if_missing(connection, table, column, definition)
228
-
229
-
230
- def add_column_if_missing(
231
- connection: sqlite3.Connection, table: str, column: str, definition: str
232
- ) -> None:
233
- columns = {row["name"] for row in connection.execute(f"PRAGMA table_info({table})")}
234
- if column not in columns:
235
- connection.execute(f"ALTER TABLE {table} ADD COLUMN {column} {definition}")
223
+ connection.execute(f"ALTER TABLE {table} ADD COLUMN {column} {definition}")
224
+ return True
236
225
 
237
226
 
238
227
  def sql_statements(script: str) -> list[str]:
@@ -0,0 +1,251 @@
1
+ """Read-only target and setup inspection shared by the MCP server and workbench."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import json
7
+ import os
8
+ import sys
9
+ from pathlib import Path
10
+ from typing import Any
11
+
12
+ from deep_scan_config import resolve_deep_scan_setup
13
+ from workbench_cli import parse_args
14
+ from workbench_constants import DIFF_TARGET_KINDS, EMPTY_GIT_TREE, EMPTY_GIT_TREES, optional_text
15
+ from workbench_target import (
16
+ git_bytes,
17
+ git_output,
18
+ git_target_metadata,
19
+ require_git_worktree_head,
20
+ worktree_content_digest,
21
+ )
22
+
23
+
24
+ def require_target(value: str) -> Path:
25
+ """Return the resolved local directory or raise SystemExit if the supplied path is relative or missing."""
26
+ expanded = Path(value).expanduser()
27
+ if not expanded.is_absolute():
28
+ raise SystemExit("Scan target must be an absolute local directory path.")
29
+ target = expanded.resolve()
30
+ if not target.is_dir():
31
+ raise SystemExit(f"Scan target is not a readable local directory: {target}")
32
+ return target
33
+
34
+
35
+ def inspect_target(target: Path) -> dict[str, Any]:
36
+ """Return the target path, display name, and local Git metadata used by setup."""
37
+ return {
38
+ "displayName": target.name,
39
+ "targetMetadata": git_target_metadata(target),
40
+ "targetPath": str(target),
41
+ }
42
+
43
+
44
+ def resolve_git_commit(target: Path, revision: str, label: str) -> str:
45
+ """Resolve a revision to a local commit ID or raise SystemExit with the caller’s label."""
46
+ value = optional_text(revision, maximum=512)
47
+ if not value:
48
+ raise SystemExit(f"{label} is required.")
49
+ resolved = git_output(
50
+ target,
51
+ "rev-parse",
52
+ "--verify",
53
+ "--end-of-options",
54
+ f"{value}^{{commit}}",
55
+ )
56
+ if resolved is None:
57
+ raise SystemExit(f"{label} does not resolve to a local Git commit: {value}")
58
+ return resolved
59
+
60
+
61
+ def require_diff_target(
62
+ target: Path,
63
+ kind: str | None,
64
+ base_revision: str | None,
65
+ head_revision: str | None,
66
+ content_digest: str | None,
67
+ ) -> dict[str, str]:
68
+ """Resolve the selected Git change to its base and head commits.
69
+
70
+ For a working-tree selection, also return the current content digest and reject
71
+ changes since selection. Invalid or stale selections raise SystemExit.
72
+ """
73
+ current_head = require_review_changes_target(target)
74
+ if kind not in DIFF_TARGET_KINDS:
75
+ raise SystemExit("Choose which Git changes to review before starting a diff scan.")
76
+ if kind == "working_tree":
77
+ base = resolve_git_commit(target, base_revision or "HEAD", "Working-tree base")
78
+ head = resolve_git_commit(target, head_revision or current_head, "Working-tree HEAD")
79
+ current_digest = worktree_content_digest(target)
80
+ if base != current_head or head != current_head:
81
+ raise SystemExit(
82
+ "Repository HEAD changed after these working-tree changes were selected. "
83
+ "Select Uncommitted changes again."
84
+ )
85
+ if content_digest and content_digest != current_digest:
86
+ raise SystemExit(
87
+ "Working-tree contents changed after they were selected. "
88
+ "Select Uncommitted changes again."
89
+ )
90
+ return {
91
+ "kind": kind,
92
+ "baseRevision": current_head,
93
+ "headRevision": current_head,
94
+ "contentDigest": current_digest,
95
+ }
96
+ if kind == "commit":
97
+ head = resolve_git_commit(target, head_revision or "", "Commit")
98
+ commit = git_bytes(target, "cat-file", "-p", head)
99
+ if commit is None:
100
+ raise SystemExit(f"Commit is not available in the local checkout: {head}")
101
+ parent_line = next(
102
+ (
103
+ line
104
+ for line in commit.split(b"\n\n", 1)[0].splitlines()
105
+ if line.startswith(b"parent ")
106
+ ),
107
+ None,
108
+ )
109
+ if parent_line is None:
110
+ parent = EMPTY_GIT_TREES[git_output(target, "rev-parse", "--show-object-format")]
111
+ else:
112
+ parent = resolve_git_commit(
113
+ target,
114
+ parent_line.removeprefix(b"parent ").decode("ascii").strip(),
115
+ "Commit parent",
116
+ )
117
+ if base_revision and base_revision != parent:
118
+ supplied_base = (
119
+ base_revision
120
+ if base_revision == EMPTY_GIT_TREE
121
+ else resolve_git_commit(target, base_revision, "Commit base")
122
+ )
123
+ if supplied_base != parent:
124
+ raise SystemExit("Commit base revision must match the selected commit's parent.")
125
+ return {"kind": kind, "baseRevision": parent, "headRevision": head}
126
+ base = resolve_git_commit(target, base_revision or "", "Base revision")
127
+ head = resolve_git_commit(target, head_revision or "", "Head revision")
128
+ if base == head:
129
+ raise SystemExit("Base and head revisions must identify different commits.")
130
+ return {"kind": kind, "baseRevision": base, "headRevision": head}
131
+
132
+
133
+ def inspect_setup_values(
134
+ target_path: str,
135
+ scope: str,
136
+ mode: str,
137
+ diff_target_kind: str | None,
138
+ diff_base_revision: str | None,
139
+ diff_head_revision: str | None,
140
+ diff_content_digest: str | None,
141
+ ) -> dict[str, Any]:
142
+ """Validate the target, scope, and scan mode and return their normalized values and resolved diff target."""
143
+ target = require_target(target_path)
144
+ inspected = require_scannable_target(target)
145
+ normalized_scope = require_scope(scope, mode, target)
146
+ if mode == "diff" and normalized_scope != ".":
147
+ raise SystemExit("Review changes requires the whole target; use scope '.'.")
148
+ if mode != "diff" and any(
149
+ value is not None
150
+ for value in (
151
+ diff_target_kind,
152
+ diff_base_revision,
153
+ diff_head_revision,
154
+ diff_content_digest,
155
+ )
156
+ ):
157
+ raise SystemExit("A Git diff target requires Review changes mode.")
158
+ diff_target = (
159
+ require_diff_target(
160
+ target,
161
+ diff_target_kind,
162
+ diff_base_revision,
163
+ diff_head_revision,
164
+ diff_content_digest,
165
+ )
166
+ if mode == "diff"
167
+ else None
168
+ )
169
+ return {
170
+ "diffTarget": diff_target,
171
+ "scope": normalized_scope,
172
+ "target": inspected,
173
+ }
174
+
175
+
176
+ def require_review_changes_target(target: Path) -> str:
177
+ """Return the checked-out revision or raise SystemExit if target is not the worktree root."""
178
+ revision = require_git_worktree_head(target)
179
+ repository_root = git_output(target, "rev-parse", "--show-toplevel")
180
+ if repository_root is None or not Path(repository_root).samefile(target):
181
+ raise SystemExit(
182
+ "Review changes requires the checked-out Git repository root as the target."
183
+ )
184
+ return revision
185
+
186
+
187
+ def require_scannable_target(target: Path) -> dict[str, Any]:
188
+ """Return the inspected target metadata, rejecting a Git repository that has no checked-out worktree."""
189
+ inspected = inspect_target(target)
190
+ metadata = inspected["targetMetadata"]
191
+ if metadata["isGit"] and not metadata["isWorktree"]:
192
+ raise SystemExit(
193
+ "Codex Security requires a checked-out worktree, not a bare Git repository."
194
+ )
195
+ return inspected
196
+
197
+
198
+ def require_scope(scope: str, mode: str, target: Path) -> str:
199
+ """Return the existing scan directory relative to the target, requiring the whole repository for deep mode."""
200
+ value = scope if scope.strip() else "."
201
+ requested_scope = Path(value)
202
+ if "\\" in value and (os.name != "nt" or not requested_scope.is_absolute()):
203
+ raise SystemExit("Scan scope must use repository-relative POSIX paths.")
204
+ if ".." in requested_scope.parts:
205
+ raise SystemExit("Scan scope must stay inside the scanned target.")
206
+ try:
207
+ resolved_scope = (
208
+ requested_scope if requested_scope.is_absolute() else target / requested_scope
209
+ ).resolve()
210
+ relative_scope = resolved_scope.relative_to(target)
211
+ except (RuntimeError, ValueError) as exc:
212
+ raise SystemExit("Scan scope must stay inside the scanned target.") from exc
213
+ normalized = relative_scope.as_posix() or "."
214
+ if not normalized.strip():
215
+ normalized = "./" + normalized
216
+ if mode == "deep" and normalized != ".":
217
+ raise SystemExit("Deep Scan is repository-wide and cannot use a scoped path.")
218
+ if not resolved_scope.is_dir():
219
+ raise SystemExit("Scan scope must reference an existing directory inside the target.")
220
+ return normalized
221
+
222
+
223
+ def inspect_selected_setup(args: argparse.Namespace) -> dict[str, Any]:
224
+ inspected = inspect_setup_values(
225
+ args.target_path,
226
+ args.scope,
227
+ args.mode,
228
+ args.diff_target_kind,
229
+ args.diff_base_revision,
230
+ args.diff_head_revision,
231
+ args.diff_content_digest,
232
+ )
233
+ if args.mode == "deep":
234
+ inspected["deepScanConfig"] = resolve_deep_scan_setup(
235
+ project_json=args.deep_scan_project_json
236
+ )
237
+ elif args.deep_scan_project_json is not None:
238
+ raise SystemExit("Project Deep Scan settings require Deep Scan mode.")
239
+ return inspected
240
+
241
+
242
+ def inspect_command(args: argparse.Namespace) -> dict[str, Any]:
243
+ if args.command == "inspect-target":
244
+ return inspect_target(require_target(args.target_path))
245
+ return inspect_selected_setup(args)
246
+
247
+
248
+ def main() -> None:
249
+ sys.stdin.reconfigure(encoding="utf-8")
250
+ args = parse_args("Codex Security workbench persistence.", inspection_only=True)
251
+ print(json.dumps(inspect_command(args), allow_nan=False, sort_keys=True))
@@ -30,6 +30,18 @@ def finding_source_excerpt(
30
30
  locations: list[dict[str, Any]],
31
31
  scopes: list[str],
32
32
  ) -> str | None:
33
+ """Return numbered context from a finding location at the scanned Git revision.
34
+
35
+ Args:
36
+ scan: Saved scan row with its revision, snapshot digest, and scope metadata.
37
+ target: Local target directory in which to resolve the recorded Git objects.
38
+ locations: Displayed finding locations, using one-based line numbers.
39
+ scopes: Selected paths used to interpret saved source scopes.
40
+
41
+ Returns:
42
+ A bounded excerpt, or None when a location, scope, or local blob cannot
43
+ supply it. Root-control locations have priority.
44
+ """
33
45
  if target is None or not locations or scan["target_revision"] == "unversioned":
34
46
  return None
35
47
  snapshot = scan["target_snapshot_digest"]
@@ -116,6 +128,7 @@ def finding_source_excerpt(
116
128
 
117
129
 
118
130
  def scanned_source_text(repository: Path, object_id: str) -> str | None:
131
+ """Decode the locally available Git blob as UTF-8 with replacement, or return None on lookup failure."""
119
132
  try:
120
133
  content = offline_git_bytes(repository, "cat-file", "blob", object_id)
121
134
  except (OSError, RuntimeError, SystemExit):
@@ -17,7 +17,7 @@ from unicodedata import normalize
17
17
  sys.path.insert(0, str(Path(__file__).resolve().parent))
18
18
  from workbench_target import (
19
19
  clean_worktree_content_digest,
20
- git_bytes,
20
+ git_command,
21
21
  git_worktree_context,
22
22
  )
23
23
  from workbench_validation import reject_non_finite_json
@@ -26,6 +26,7 @@ OBJECT_ID = re.compile(r"(?:[0-9a-f]{40}|[0-9a-f]{64})\Z")
26
26
 
27
27
 
28
28
  def expected_target_kinds(scan: sqlite3.Row) -> list[str]:
29
+ """Return the manifest target kinds compatible with the stored scan mode, revision, and snapshot digest."""
29
30
  if scan["mode"] == "diff":
30
31
  return ["git_diff"]
31
32
  if scan["target_revision"] == "unversioned":
@@ -38,6 +39,7 @@ def expected_target_kinds(scan: sqlite3.Row) -> list[str]:
38
39
 
39
40
 
40
41
  def requested_scan_paths(scan: sqlite3.Row) -> list[str]:
42
+ """Return the explicit paths in the saved launch recipe, falling back to the scan’s original scope."""
41
43
  if "recipe_json" in scan.keys() and scan["recipe_json"] is not None:
42
44
  recipe = json.loads(scan["recipe_json"], parse_constant=reject_non_finite_json)
43
45
  target = recipe["target"]
@@ -47,6 +49,7 @@ def requested_scan_paths(scan: sqlite3.Row) -> list[str]:
47
49
 
48
50
 
49
51
  def public_scan_recipe(scan: sqlite3.Row) -> dict[str, Any]:
52
+ """Return the decoded launch recipe with the internal file-scope metadata removed."""
50
53
  recipe = json.loads(scan["recipe_json"], parse_constant=reject_non_finite_json)
51
54
  recipe.pop("_codexSecurityFileScopes", None)
52
55
  return recipe
@@ -62,6 +65,7 @@ def relative_path(value: str) -> PurePosixPath | None:
62
65
 
63
66
 
64
67
  def safe_source_path(target: Path, value: str) -> Path | None:
68
+ """Resolve a repository-relative POSIX path and return None if it is invalid or resolves outside the target."""
65
69
  parsed = relative_path(value)
66
70
  if parsed is None:
67
71
  return None
@@ -74,23 +78,20 @@ def safe_source_path(target: Path, value: str) -> Path | None:
74
78
 
75
79
 
76
80
  def offline_git_bytes(repository: Path, *arguments: str) -> bytes | None:
77
- names = ("GIT_NO_LAZY_FETCH", "GIT_ALLOW_PROTOCOL", "GIT_NO_REPLACE_OBJECTS")
78
- previous = {name: os.environ.get(name) for name in names}
79
- os.environ["GIT_NO_LAZY_FETCH"] = "1"
80
- os.environ["GIT_ALLOW_PROTOCOL"] = ""
81
- os.environ["GIT_NO_REPLACE_OBJECTS"] = "1"
82
- try:
83
- return git_bytes(repository, *arguments)
84
- finally:
85
- for name, value in previous.items():
86
- if value is None:
87
- os.environ.pop(name, None)
88
- else:
89
- os.environ[name] = value
81
+ """Return raw stdout for a successful offline Git command with replacement objects disabled, otherwise None."""
82
+ result = git_command(
83
+ repository,
84
+ *arguments,
85
+ text=False,
86
+ offline=True,
87
+ environment_overrides={"GIT_NO_REPLACE_OBJECTS": "1"},
88
+ )
89
+ return result.stdout if result.returncode == 0 else None
90
90
 
91
91
 
92
92
  @cache
93
93
  def tree_entries(repository: Path, tree: str) -> dict[str, tuple[tuple[str, str, str], ...]] | None:
94
+ """Index a Git tree by normalized name, retaining every original name, entry kind, and object ID in each group."""
94
95
  content = offline_git_bytes(repository, "ls-tree", "-z", tree)
95
96
  if content is None:
96
97
  return None
@@ -120,9 +121,7 @@ def tree_entries(repository: Path, tree: str) -> dict[str, tuple[tuple[str, str,
120
121
  return {name: tuple(matches) for name, matches in entries.items()}
121
122
 
122
123
 
123
- def exact_tree_path(
124
- repository: Path, tree: str, value: str, *, require_unambiguous: bool = False
125
- ) -> tuple[str, str, str] | None:
124
+ def exact_tree_path(repository: Path, tree: str, value: str) -> tuple[str, str, str] | None:
126
125
  path = relative_path(value)
127
126
  if path is None:
128
127
  return None
@@ -132,12 +131,11 @@ def exact_tree_path(
132
131
  return None
133
132
  entries = tree_entries(repository, object_id) or {}
134
133
  aliases = entries.get(normalized_path_component(name), ())
135
- if require_unambiguous and len(aliases) != 1:
134
+ if len(aliases) != 1:
136
135
  return None
137
- entry = next((entry for entry in aliases if entry[0] == name), None)
138
- if entry is None:
136
+ entry_name, kind, object_id = aliases[0]
137
+ if entry_name != name:
139
138
  return None
140
- _, kind, object_id = entry
141
139
  return path.as_posix(), kind, object_id
142
140
 
143
141
 
@@ -225,6 +223,12 @@ def capture_source_scopes(
225
223
  *,
226
224
  diff_target_kind: str | None = None,
227
225
  ) -> dict[str, Any]:
226
+ """Bind requested paths to the local Git objects that may supply excerpts later.
227
+
228
+ Return the revision and the file or tree IDs that can be verified locally.
229
+ A working-tree diff, dirty snapshot, or replacement ref leaves the scope list
230
+ empty. A path that cannot be bound adds no authority to read other paths.
231
+ """
228
232
  revision, snapshot = target_identity[:2]
229
233
  result: dict[str, Any] = {"version": 1, "revision": revision, "scopes": []}
230
234
  # HEAD cannot represent the uncommitted bytes reviewed by a working-tree scan.
@@ -275,6 +279,11 @@ def capture_source_scopes(
275
279
  def load_source_scopes(
276
280
  scan: sqlite3.Row, target: Path, requested: list[str]
277
281
  ) -> tuple[Path, str, list[dict[str, str]]] | None:
282
+ """Return the repository, tree ID, and valid source scopes, or None when none can be established.
283
+
284
+ Use saved object IDs for current records. For a legacy scan, reconstruct only
285
+ unambiguous entries from its original revision and respect any recorded file kinds.
286
+ """
278
287
  kind = scan["diff_target_kind"] if "diff_target_kind" in scan.keys() else None
279
288
  if kind == "working_tree" or (
280
289
  "mode" in scan.keys() and scan["mode"] == "diff" and kind not in ("commit", "range")
@@ -329,7 +338,7 @@ def load_source_scopes(
329
338
  repository, tree = context
330
339
  scopes = []
331
340
  for path in paths:
332
- entry = exact_tree_path(repository, tree, path, require_unambiguous=True)
341
+ entry = exact_tree_path(repository, tree, path)
333
342
  if entry is None or entry[1] not in {"file", "directory"}:
334
343
  continue
335
344
  kind = entry[1]
@@ -351,6 +360,7 @@ def load_source_scopes(
351
360
  def source_object_for_path(
352
361
  repository: Path, tree: str, target: Path, value: str, scope: dict[str, str]
353
362
  ) -> str | None:
363
+ """Return the Git blob ID for a file covered by the recorded scope, or None if the path cannot be verified."""
354
364
  path = relative_path(value)
355
365
  if path is None or safe_source_path(target, value) is None:
356
366
  return None
@@ -375,7 +385,7 @@ def source_object_for_path(
375
385
  if scope["kind"] == "file":
376
386
  return scope["objectId"] if not suffix else None
377
387
  relative = PurePosixPath(*suffix).as_posix()
378
- entry = exact_tree_path(repository, scope["objectId"], relative, require_unambiguous=True)
388
+ entry = exact_tree_path(repository, scope["objectId"], relative)
379
389
  if entry is None:
380
390
  selected = safe_source_path(target, scope["canonicalPath"])
381
391
  if selected is not None: