@openai/codex-security 0.8.3 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (658) hide show
  1. package/README.md +36 -746
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +7 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/baseline-auditor.md +18 -0
  26. package/_bundled_plugin/references/core-scan.md +5 -42
  27. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  28. package/_bundled_plugin/references/final-report.md +5 -3
  29. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  30. package/_bundled_plugin/references/focused-investigator.md +13 -0
  31. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  32. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  33. package/_bundled_plugin/references/scan-contract.md +27 -33
  34. package/_bundled_plugin/references/scan-prologue.md +2 -2
  35. package/_bundled_plugin/references/scan-runtime.md +4 -2
  36. package/_bundled_plugin/references/security-guidance.md +14 -1
  37. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  38. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  39. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  40. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  41. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  42. package/_bundled_plugin/scripts/deep_scan_workbench.py +192 -352
  43. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  44. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  45. package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
  46. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  47. package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
  48. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  49. package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
  50. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  51. package/_bundled_plugin/scripts/report_projection.py +81 -43
  52. package/_bundled_plugin/scripts/review_state.py +8 -2
  53. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  54. package/_bundled_plugin/scripts/snapshot_sqlite.py +9 -2
  55. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  56. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  57. package/_bundled_plugin/scripts/windows_scan_local_files.py +582 -20
  58. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  59. package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
  60. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  61. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  62. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  63. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  64. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  65. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  66. package/_bundled_plugin/scripts/workbench/storage.py +91 -7
  67. package/_bundled_plugin/scripts/workbench_cli.py +54 -14
  68. package/_bundled_plugin/scripts/workbench_constants.py +12 -0
  69. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  70. package/_bundled_plugin/scripts/workbench_db.py +562 -303
  71. package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +238 -41
  75. package/_bundled_plugin/scripts/workbench_progress.py +169 -4
  76. package/_bundled_plugin/scripts/workbench_publication.py +16 -13
  77. package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
  82. package/_bundled_plugin/scripts/workbench_schema.py +258 -63
  83. package/_bundled_plugin/scripts/workbench_setup.py +14 -2
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  85. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  86. package/_bundled_plugin/scripts/workbench_target.py +594 -136
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
  88. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
  90. package/_bundled_plugin/shared/workbench-migrations.json +100 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  93. package/_bundled_plugin/skills/fix-finding/SKILL.md +2 -1
  94. package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
  95. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  96. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  97. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  98. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +409 -0
  99. package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
  100. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  104. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  105. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  106. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  107. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  108. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  110. package/bin/codex-security.mjs +2 -2
  111. package/dist/api.d.ts +45 -5
  112. package/dist/api.d.ts.map +1 -1
  113. package/dist/api.js +1192 -427
  114. package/dist/api.js.map +1 -1
  115. package/dist/armorcode-findings.d.ts +9 -0
  116. package/dist/armorcode-findings.d.ts.map +1 -0
  117. package/dist/armorcode-findings.js +145 -0
  118. package/dist/armorcode-findings.js.map +1 -0
  119. package/dist/artifact-export.d.ts +2 -0
  120. package/dist/artifact-export.d.ts.map +1 -1
  121. package/dist/artifact-export.js +29 -13
  122. package/dist/artifact-export.js.map +1 -1
  123. package/dist/auth.d.ts +6 -2
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +37 -18
  126. package/dist/auth.js.map +1 -1
  127. package/dist/batch-cost.d.ts +18 -0
  128. package/dist/batch-cost.d.ts.map +1 -0
  129. package/dist/batch-cost.js +41 -0
  130. package/dist/batch-cost.js.map +1 -0
  131. package/dist/bedrock-oss-pricing.d.ts +6 -0
  132. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  133. package/dist/bedrock-oss-pricing.js +58 -0
  134. package/dist/bedrock-oss-pricing.js.map +1 -0
  135. package/dist/bedrock-pricing.d.ts +15 -0
  136. package/dist/bedrock-pricing.d.ts.map +1 -0
  137. package/dist/bedrock-pricing.js +117 -0
  138. package/dist/bedrock-pricing.js.map +1 -0
  139. package/dist/blackduck-findings.d.ts +1 -1
  140. package/dist/blackduck-findings.d.ts.map +1 -1
  141. package/dist/blackduck-findings.js +24 -22
  142. package/dist/blackduck-findings.js.map +1 -1
  143. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  144. package/dist/bulk-scan-discovery.js +4 -4
  145. package/dist/bulk-scan-discovery.js.map +1 -1
  146. package/dist/bundled-plugin.d.ts +4 -0
  147. package/dist/bundled-plugin.d.ts.map +1 -0
  148. package/dist/bundled-plugin.js +23 -0
  149. package/dist/bundled-plugin.js.map +1 -0
  150. package/dist/checkmarx-evidence.d.ts +19 -0
  151. package/dist/checkmarx-evidence.d.ts.map +1 -0
  152. package/dist/checkmarx-evidence.js +36 -0
  153. package/dist/checkmarx-evidence.js.map +1 -0
  154. package/dist/checkmarx-findings.d.ts +4 -0
  155. package/dist/checkmarx-findings.d.ts.map +1 -0
  156. package/dist/checkmarx-findings.js +27 -0
  157. package/dist/checkmarx-findings.js.map +1 -0
  158. package/dist/checkmarx-one.d.ts +4 -0
  159. package/dist/checkmarx-one.d.ts.map +1 -0
  160. package/dist/checkmarx-one.js +53 -0
  161. package/dist/checkmarx-one.js.map +1 -0
  162. package/dist/checkmarx-repository.d.ts +12 -0
  163. package/dist/checkmarx-repository.d.ts.map +1 -0
  164. package/dist/checkmarx-repository.js +181 -0
  165. package/dist/checkmarx-repository.js.map +1 -0
  166. package/dist/checkmarx-xml.d.ts +12 -0
  167. package/dist/checkmarx-xml.d.ts.map +1 -0
  168. package/dist/checkmarx-xml.js +196 -0
  169. package/dist/checkmarx-xml.js.map +1 -0
  170. package/dist/classify-scan-severity.d.ts +1 -1
  171. package/dist/classify-scan-severity.d.ts.map +1 -1
  172. package/dist/classify-scan-severity.js +11 -3
  173. package/dist/classify-scan-severity.js.map +1 -1
  174. package/dist/classify-severity-records.d.ts +1 -9
  175. package/dist/classify-severity-records.d.ts.map +1 -1
  176. package/dist/classify-severity-records.js +3 -13
  177. package/dist/classify-severity-records.js.map +1 -1
  178. package/dist/classify-severity.d.ts.map +1 -1
  179. package/dist/classify-severity.js +11 -10
  180. package/dist/classify-severity.js.map +1 -1
  181. package/dist/cli-argument.d.ts +4 -0
  182. package/dist/cli-argument.d.ts.map +1 -0
  183. package/dist/cli-argument.js +17 -0
  184. package/dist/cli-argument.js.map +1 -0
  185. package/dist/cli-help.d.ts +1 -1
  186. package/dist/cli-help.d.ts.map +1 -1
  187. package/dist/cli-help.js +71 -29
  188. package/dist/cli-help.js.map +1 -1
  189. package/dist/cli-hook.d.ts +3 -0
  190. package/dist/cli-hook.d.ts.map +1 -0
  191. package/dist/cli-hook.js +87 -0
  192. package/dist/cli-hook.js.map +1 -0
  193. package/dist/cli-integrations.d.ts +13 -0
  194. package/dist/cli-integrations.d.ts.map +1 -0
  195. package/dist/cli-integrations.js +333 -0
  196. package/dist/cli-integrations.js.map +1 -0
  197. package/dist/cli-mcp.d.ts +15 -0
  198. package/dist/cli-mcp.d.ts.map +1 -0
  199. package/dist/cli-mcp.js +178 -0
  200. package/dist/cli-mcp.js.map +1 -0
  201. package/dist/cli-token-view.d.ts +10 -0
  202. package/dist/cli-token-view.d.ts.map +1 -0
  203. package/dist/cli-token-view.js +41 -0
  204. package/dist/cli-token-view.js.map +1 -0
  205. package/dist/cli.d.ts +16 -8
  206. package/dist/cli.d.ts.map +1 -1
  207. package/dist/cli.js +3382 -2017
  208. package/dist/cli.js.map +1 -1
  209. package/dist/cloud-publish.d.ts.map +1 -1
  210. package/dist/cloud-publish.js +35 -33
  211. package/dist/cloud-publish.js.map +1 -1
  212. package/dist/codex-sdk-environment.d.ts +6 -0
  213. package/dist/codex-sdk-environment.d.ts.map +1 -1
  214. package/dist/codex-sdk-environment.js +19 -0
  215. package/dist/codex-sdk-environment.js.map +1 -1
  216. package/dist/command-words.d.ts +3 -0
  217. package/dist/command-words.d.ts.map +1 -0
  218. package/dist/command-words.js +46 -0
  219. package/dist/command-words.js.map +1 -0
  220. package/dist/component-scan.d.ts +19 -4
  221. package/dist/component-scan.d.ts.map +1 -1
  222. package/dist/component-scan.js +67 -9
  223. package/dist/component-scan.js.map +1 -1
  224. package/dist/config.d.ts +1 -1
  225. package/dist/config.d.ts.map +1 -1
  226. package/dist/config.js +130 -67
  227. package/dist/config.js.map +1 -1
  228. package/dist/continuum-findings.d.ts +1 -1
  229. package/dist/continuum-findings.d.ts.map +1 -1
  230. package/dist/continuum-findings.js +149 -19
  231. package/dist/continuum-findings.js.map +1 -1
  232. package/dist/contract-values.d.ts +2 -0
  233. package/dist/contract-values.d.ts.map +1 -1
  234. package/dist/contract-values.js +12 -9
  235. package/dist/contract-values.js.map +1 -1
  236. package/dist/cost-model.d.ts +13 -1
  237. package/dist/cost-model.d.ts.map +1 -1
  238. package/dist/cost-model.js +66 -112
  239. package/dist/cost-model.js.map +1 -1
  240. package/dist/cost.d.ts +42 -3
  241. package/dist/cost.d.ts.map +1 -1
  242. package/dist/cost.js +484 -149
  243. package/dist/cost.js.map +1 -1
  244. package/dist/custom-publish.d.ts +4 -0
  245. package/dist/custom-publish.d.ts.map +1 -1
  246. package/dist/custom-publish.js +40 -3
  247. package/dist/custom-publish.js.map +1 -1
  248. package/dist/custom-validation-prompt.d.ts +1 -1
  249. package/dist/custom-validation-prompt.d.ts.map +1 -1
  250. package/dist/custom-validation-prompt.js +29 -19
  251. package/dist/custom-validation-prompt.js.map +1 -1
  252. package/dist/deduplication/local.d.ts +4 -2
  253. package/dist/deduplication/local.d.ts.map +1 -1
  254. package/dist/deduplication/local.js +9 -2
  255. package/dist/deduplication/local.js.map +1 -1
  256. package/dist/deduplication/refusal.d.ts.map +1 -1
  257. package/dist/deduplication/refusal.js +26 -5
  258. package/dist/deduplication/refusal.js.map +1 -1
  259. package/dist/deduplication/scan.d.ts +5 -0
  260. package/dist/deduplication/scan.d.ts.map +1 -1
  261. package/dist/deduplication/scan.js +24 -7
  262. package/dist/deduplication/scan.js.map +1 -1
  263. package/dist/deep-config.d.ts +0 -1
  264. package/dist/deep-config.d.ts.map +1 -1
  265. package/dist/deep-config.js +22 -33
  266. package/dist/deep-config.js.map +1 -1
  267. package/dist/deep-scan-defaults.d.ts +2 -0
  268. package/dist/deep-scan-defaults.d.ts.map +1 -1
  269. package/dist/deep-scan-defaults.js +28 -1
  270. package/dist/deep-scan-defaults.js.map +1 -1
  271. package/dist/deep-scan.d.ts +2 -0
  272. package/dist/deep-scan.d.ts.map +1 -1
  273. package/dist/deep-scan.js +44 -19
  274. package/dist/deep-scan.js.map +1 -1
  275. package/dist/default-severity-rubric.d.ts +1 -1
  276. package/dist/default-severity-rubric.d.ts.map +1 -1
  277. package/dist/default-severity-rubric.js +1 -1
  278. package/dist/default-severity-rubric.js.map +1 -1
  279. package/dist/endor-findings.d.ts +3 -1
  280. package/dist/endor-findings.d.ts.map +1 -1
  281. package/dist/endor-findings.js +86 -45
  282. package/dist/endor-findings.js.map +1 -1
  283. package/dist/errors.d.ts +4 -2
  284. package/dist/errors.d.ts.map +1 -1
  285. package/dist/errors.js +15 -4
  286. package/dist/errors.js.map +1 -1
  287. package/dist/executable-path.d.ts +3 -0
  288. package/dist/executable-path.d.ts.map +1 -1
  289. package/dist/executable-path.js +26 -0
  290. package/dist/executable-path.js.map +1 -1
  291. package/dist/external-findings-import.d.ts +5 -3
  292. package/dist/external-findings-import.d.ts.map +1 -1
  293. package/dist/external-findings-import.js +19 -7
  294. package/dist/external-findings-import.js.map +1 -1
  295. package/dist/external-findings-local.d.ts +69 -5
  296. package/dist/external-findings-local.d.ts.map +1 -1
  297. package/dist/external-findings-local.js +537 -108
  298. package/dist/external-findings-local.js.map +1 -1
  299. package/dist/external-findings-publish.d.ts +13 -6
  300. package/dist/external-findings-publish.d.ts.map +1 -1
  301. package/dist/external-findings-publish.js +895 -1142
  302. package/dist/external-findings-publish.js.map +1 -1
  303. package/dist/external-findings-read.d.ts +21 -2
  304. package/dist/external-findings-read.d.ts.map +1 -1
  305. package/dist/external-findings-read.js +130 -68
  306. package/dist/external-findings-read.js.map +1 -1
  307. package/dist/external-findings.d.ts +15 -3
  308. package/dist/external-findings.d.ts.map +1 -1
  309. package/dist/external-findings.js +54 -2
  310. package/dist/external-findings.js.map +1 -1
  311. package/dist/external-import-contract.d.ts +8 -12
  312. package/dist/external-import-contract.d.ts.map +1 -1
  313. package/dist/external-import-contract.js +51 -184
  314. package/dist/external-import-contract.js.map +1 -1
  315. package/dist/external-import-models.d.ts +1 -1
  316. package/dist/external-import-models.d.ts.map +1 -1
  317. package/dist/external-import-models.js.map +1 -1
  318. package/dist/feedback.d.ts.map +1 -1
  319. package/dist/feedback.js +5 -4
  320. package/dist/feedback.js.map +1 -1
  321. package/dist/finding-prompt.d.ts +5 -0
  322. package/dist/finding-prompt.d.ts.map +1 -0
  323. package/dist/finding-prompt.js +32 -0
  324. package/dist/finding-prompt.js.map +1 -0
  325. package/dist/findings-client.d.ts +1 -0
  326. package/dist/findings-client.d.ts.map +1 -1
  327. package/dist/findings-client.js +27 -3
  328. package/dist/findings-client.js.map +1 -1
  329. package/dist/github-advisories.d.ts.map +1 -1
  330. package/dist/github-advisories.js +0 -2
  331. package/dist/github-advisories.js.map +1 -1
  332. package/dist/github-dependabot-findings.d.ts.map +1 -1
  333. package/dist/github-dependabot-findings.js +18 -8
  334. package/dist/github-dependabot-findings.js.map +1 -1
  335. package/dist/github-findings.d.ts +4 -1
  336. package/dist/github-findings.d.ts.map +1 -1
  337. package/dist/github-findings.js +73 -316
  338. package/dist/github-findings.js.map +1 -1
  339. package/dist/hosted-git-remotes.d.ts +5 -0
  340. package/dist/hosted-git-remotes.d.ts.map +1 -0
  341. package/dist/hosted-git-remotes.js +285 -0
  342. package/dist/hosted-git-remotes.js.map +1 -0
  343. package/dist/hosted-git-repository.d.ts +28 -0
  344. package/dist/hosted-git-repository.d.ts.map +1 -0
  345. package/dist/hosted-git-repository.js +222 -0
  346. package/dist/hosted-git-repository.js.map +1 -0
  347. package/dist/hosted-remediation.d.ts +1 -0
  348. package/dist/hosted-remediation.d.ts.map +1 -1
  349. package/dist/hosted-remediation.js +23 -3
  350. package/dist/hosted-remediation.js.map +1 -1
  351. package/dist/hosted-scan-protocol.js +2 -2
  352. package/dist/hosted-scan-protocol.js.map +1 -1
  353. package/dist/hosted-scan.d.ts.map +1 -1
  354. package/dist/hosted-scan.js +16 -11
  355. package/dist/hosted-scan.js.map +1 -1
  356. package/dist/hosted-scanner-http.d.ts +21 -0
  357. package/dist/hosted-scanner-http.d.ts.map +1 -0
  358. package/dist/hosted-scanner-http.js +204 -0
  359. package/dist/hosted-scanner-http.js.map +1 -0
  360. package/dist/import-scan.d.ts.map +1 -1
  361. package/dist/import-scan.js +3 -0
  362. package/dist/import-scan.js.map +1 -1
  363. package/dist/index.d.ts +21 -9
  364. package/dist/index.d.ts.map +1 -1
  365. package/dist/index.js +12 -3
  366. package/dist/index.js.map +1 -1
  367. package/dist/inspector-findings.d.ts.map +1 -1
  368. package/dist/inspector-findings.js +52 -86
  369. package/dist/inspector-findings.js.map +1 -1
  370. package/dist/knowledge-base.d.ts +1 -1
  371. package/dist/knowledge-base.d.ts.map +1 -1
  372. package/dist/knowledge-base.js +102 -32
  373. package/dist/knowledge-base.js.map +1 -1
  374. package/dist/linear.d.ts +11 -0
  375. package/dist/linear.d.ts.map +1 -1
  376. package/dist/linear.js.map +1 -1
  377. package/dist/local-git-metadata.d.ts +5 -2
  378. package/dist/local-git-metadata.d.ts.map +1 -1
  379. package/dist/local-git-metadata.js +8 -5
  380. package/dist/local-git-metadata.js.map +1 -1
  381. package/dist/multiscan.d.ts +10 -4
  382. package/dist/multiscan.d.ts.map +1 -1
  383. package/dist/multiscan.js +217 -102
  384. package/dist/multiscan.js.map +1 -1
  385. package/dist/native-json-findings.d.ts +2 -1
  386. package/dist/native-json-findings.d.ts.map +1 -1
  387. package/dist/native-json-findings.js +12 -2
  388. package/dist/native-json-findings.js.map +1 -1
  389. package/dist/opengrep-findings.d.ts +5 -2
  390. package/dist/opengrep-findings.d.ts.map +1 -1
  391. package/dist/opengrep-findings.js +54 -33
  392. package/dist/opengrep-findings.js.map +1 -1
  393. package/dist/operation-telemetry.d.ts +104 -0
  394. package/dist/operation-telemetry.d.ts.map +1 -0
  395. package/dist/operation-telemetry.js +293 -0
  396. package/dist/operation-telemetry.js.map +1 -0
  397. package/dist/plugin-python-probe.d.ts +4 -0
  398. package/dist/plugin-python-probe.d.ts.map +1 -0
  399. package/dist/plugin-python-probe.js +10 -0
  400. package/dist/plugin-python-probe.js.map +1 -0
  401. package/dist/private-finding-import.d.ts +99 -9
  402. package/dist/private-finding-import.d.ts.map +1 -1
  403. package/dist/private-finding-import.js +116 -152
  404. package/dist/private-finding-import.js.map +1 -1
  405. package/dist/project-config.d.ts.map +1 -1
  406. package/dist/project-config.js +53 -13
  407. package/dist/project-config.js.map +1 -1
  408. package/dist/prompt-files.d.ts +7 -2
  409. package/dist/prompt-files.d.ts.map +1 -1
  410. package/dist/prompt-files.js +42 -20
  411. package/dist/prompt-files.js.map +1 -1
  412. package/dist/provider-profile.d.ts +1 -1
  413. package/dist/provider-profile.d.ts.map +1 -1
  414. package/dist/provider-profile.js +12 -10
  415. package/dist/provider-profile.js.map +1 -1
  416. package/dist/publication-telemetry.d.ts +45 -0
  417. package/dist/publication-telemetry.d.ts.map +1 -0
  418. package/dist/publication-telemetry.js +50 -0
  419. package/dist/publication-telemetry.js.map +1 -0
  420. package/dist/publication.d.ts +1 -1
  421. package/dist/publication.d.ts.map +1 -1
  422. package/dist/publication.js.map +1 -1
  423. package/dist/publish.d.ts +4 -0
  424. package/dist/publish.d.ts.map +1 -1
  425. package/dist/publish.js +42 -2
  426. package/dist/publish.js.map +1 -1
  427. package/dist/record.d.ts +1 -5
  428. package/dist/record.d.ts.map +1 -1
  429. package/dist/record.js +3 -51
  430. package/dist/record.js.map +1 -1
  431. package/dist/remediation.d.ts +1 -4
  432. package/dist/remediation.d.ts.map +1 -1
  433. package/dist/remediation.js +6 -8
  434. package/dist/remediation.js.map +1 -1
  435. package/dist/request-metadata.d.ts +3 -0
  436. package/dist/request-metadata.d.ts.map +1 -1
  437. package/dist/request-metadata.js +9 -0
  438. package/dist/request-metadata.js.map +1 -1
  439. package/dist/result.d.ts +4 -0
  440. package/dist/result.d.ts.map +1 -1
  441. package/dist/result.js +1 -1
  442. package/dist/result.js.map +1 -1
  443. package/dist/retry-windows-rename.d.ts +8 -0
  444. package/dist/retry-windows-rename.d.ts.map +1 -0
  445. package/dist/retry-windows-rename.js +24 -0
  446. package/dist/retry-windows-rename.js.map +1 -0
  447. package/dist/runtime.d.ts +54 -6
  448. package/dist/runtime.d.ts.map +1 -1
  449. package/dist/runtime.js +1084 -256
  450. package/dist/runtime.js.map +1 -1
  451. package/dist/saved-scan-bootstrap.d.ts +7 -1
  452. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  453. package/dist/saved-scan-bootstrap.js +269 -114
  454. package/dist/saved-scan-bootstrap.js.map +1 -1
  455. package/dist/scan-activity.d.ts.map +1 -1
  456. package/dist/scan-activity.js +141 -56
  457. package/dist/scan-activity.js.map +1 -1
  458. package/dist/scan-archive-path.d.ts +2 -0
  459. package/dist/scan-archive-path.d.ts.map +1 -0
  460. package/dist/scan-archive-path.js +5 -0
  461. package/dist/scan-archive-path.js.map +1 -0
  462. package/dist/scan-comparison.d.ts +10 -5
  463. package/dist/scan-comparison.d.ts.map +1 -1
  464. package/dist/scan-comparison.js +66 -17
  465. package/dist/scan-comparison.js.map +1 -1
  466. package/dist/scan-dashboard.d.ts +7 -6
  467. package/dist/scan-dashboard.d.ts.map +1 -1
  468. package/dist/scan-dashboard.js +92 -43
  469. package/dist/scan-dashboard.js.map +1 -1
  470. package/dist/scan-executor.d.ts +10 -1
  471. package/dist/scan-executor.d.ts.map +1 -1
  472. package/dist/scan-executor.js +24 -2
  473. package/dist/scan-executor.js.map +1 -1
  474. package/dist/scan-history-renderer.d.ts +1 -0
  475. package/dist/scan-history-renderer.d.ts.map +1 -1
  476. package/dist/scan-history-renderer.js +34 -28
  477. package/dist/scan-history-renderer.js.map +1 -1
  478. package/dist/scan-logs.d.ts +12 -0
  479. package/dist/scan-logs.d.ts.map +1 -1
  480. package/dist/scan-logs.js +131 -78
  481. package/dist/scan-logs.js.map +1 -1
  482. package/dist/scan-measurement.d.ts +26 -0
  483. package/dist/scan-measurement.d.ts.map +1 -0
  484. package/dist/scan-measurement.js +77 -0
  485. package/dist/scan-measurement.js.map +1 -0
  486. package/dist/scan-progress.d.ts +1 -0
  487. package/dist/scan-progress.d.ts.map +1 -1
  488. package/dist/scan-progress.js +3 -0
  489. package/dist/scan-progress.js.map +1 -1
  490. package/dist/scan-sessions.d.ts.map +1 -1
  491. package/dist/scan-sessions.js +4 -1
  492. package/dist/scan-sessions.js.map +1 -1
  493. package/dist/scan-settings.d.ts +1 -1
  494. package/dist/scan-settings.d.ts.map +1 -1
  495. package/dist/scan-settings.js +1 -24
  496. package/dist/scan-settings.js.map +1 -1
  497. package/dist/scanner-import.d.ts +25 -13
  498. package/dist/scanner-import.d.ts.map +1 -1
  499. package/dist/scanner-import.js +216 -97
  500. package/dist/scanner-import.js.map +1 -1
  501. package/dist/scanner-repository-url.d.ts +4 -1
  502. package/dist/scanner-repository-url.d.ts.map +1 -1
  503. package/dist/scanner-repository-url.js +10 -6
  504. package/dist/scanner-repository-url.js.map +1 -1
  505. package/dist/security-policy.d.ts +1 -1
  506. package/dist/security-policy.d.ts.map +1 -1
  507. package/dist/security-policy.js +26 -6
  508. package/dist/security-policy.js.map +1 -1
  509. package/dist/semgrep-findings.d.ts +6 -3
  510. package/dist/semgrep-findings.d.ts.map +1 -1
  511. package/dist/semgrep-findings.js +72 -42
  512. package/dist/semgrep-findings.js.map +1 -1
  513. package/dist/semgrep-guardian-findings.d.ts +38 -0
  514. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  515. package/dist/semgrep-guardian-findings.js +165 -0
  516. package/dist/semgrep-guardian-findings.js.map +1 -0
  517. package/dist/semgrep-platform-collector.d.ts +26 -0
  518. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  519. package/dist/semgrep-platform-collector.js +108 -0
  520. package/dist/semgrep-platform-collector.js.map +1 -0
  521. package/dist/semgrep-platform-findings.d.ts +157 -6
  522. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  523. package/dist/semgrep-platform-findings.js +766 -103
  524. package/dist/semgrep-platform-findings.js.map +1 -1
  525. package/dist/server/api.d.ts +1 -1
  526. package/dist/server/api.d.ts.map +1 -1
  527. package/dist/server/api.js.map +1 -1
  528. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  529. package/dist/server/embedding-tokenizer.d.ts +2 -0
  530. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  531. package/dist/server/embedding-tokenizer.js +322 -0
  532. package/dist/server/embedding-tokenizer.js.map +6 -0
  533. package/dist/server/embeddings.d.ts +16 -2
  534. package/dist/server/embeddings.d.ts.map +1 -1
  535. package/dist/server/embeddings.js +35 -5
  536. package/dist/server/embeddings.js.map +1 -1
  537. package/dist/session-lines.d.ts +5 -0
  538. package/dist/session-lines.d.ts.map +1 -0
  539. package/dist/session-lines.js +60 -0
  540. package/dist/session-lines.js.map +1 -0
  541. package/dist/severity-review.d.ts +3 -1
  542. package/dist/severity-review.d.ts.map +1 -1
  543. package/dist/severity-review.js +3 -2
  544. package/dist/severity-review.js.map +1 -1
  545. package/dist/skill-authentication.d.ts +1 -0
  546. package/dist/skill-authentication.d.ts.map +1 -1
  547. package/dist/skill-authentication.js +1 -0
  548. package/dist/skill-authentication.js.map +1 -1
  549. package/dist/snyk-findings.d.ts +9 -2
  550. package/dist/snyk-findings.d.ts.map +1 -1
  551. package/dist/snyk-findings.js +90 -70
  552. package/dist/snyk-findings.js.map +1 -1
  553. package/dist/snyk-rest-findings.d.ts +59 -0
  554. package/dist/snyk-rest-findings.d.ts.map +1 -0
  555. package/dist/snyk-rest-findings.js +879 -0
  556. package/dist/snyk-rest-findings.js.map +1 -0
  557. package/dist/snyk-token-origin.d.ts +4 -0
  558. package/dist/snyk-token-origin.d.ts.map +1 -0
  559. package/dist/snyk-token-origin.js +82 -0
  560. package/dist/snyk-token-origin.js.map +1 -0
  561. package/dist/sonar-collector.d.ts.map +1 -1
  562. package/dist/sonar-collector.js +0 -3
  563. package/dist/sonar-collector.js.map +1 -1
  564. package/dist/sonar-findings.d.ts +1 -1
  565. package/dist/sonar-findings.d.ts.map +1 -1
  566. package/dist/sonar-findings.js +2 -4
  567. package/dist/sonar-findings.js.map +1 -1
  568. package/dist/sonar-import.d.ts +3 -0
  569. package/dist/sonar-import.d.ts.map +1 -1
  570. package/dist/sonar-import.js +30 -34
  571. package/dist/sonar-import.js.map +1 -1
  572. package/dist/stored-finding-projection.d.ts +6 -0
  573. package/dist/stored-finding-projection.d.ts.map +1 -0
  574. package/dist/stored-finding-projection.js +104 -0
  575. package/dist/stored-finding-projection.js.map +1 -0
  576. package/dist/stored-findings-publication.d.ts +23 -0
  577. package/dist/stored-findings-publication.d.ts.map +1 -0
  578. package/dist/stored-findings-publication.js +169 -0
  579. package/dist/stored-findings-publication.js.map +1 -0
  580. package/dist/target-drift.d.ts +9 -0
  581. package/dist/target-drift.d.ts.map +1 -0
  582. package/dist/target-drift.js +27 -0
  583. package/dist/target-drift.js.map +1 -0
  584. package/dist/targets.d.ts +8 -1
  585. package/dist/targets.d.ts.map +1 -1
  586. package/dist/targets.js +131 -42
  587. package/dist/targets.js.map +1 -1
  588. package/dist/tenable-findings.d.ts +6 -0
  589. package/dist/tenable-findings.d.ts.map +1 -0
  590. package/dist/tenable-findings.js +122 -0
  591. package/dist/tenable-findings.js.map +1 -0
  592. package/dist/terminal-stream.d.ts +13 -0
  593. package/dist/terminal-stream.d.ts.map +1 -0
  594. package/dist/terminal-stream.js +35 -0
  595. package/dist/terminal-stream.js.map +1 -0
  596. package/dist/trivy-findings.d.ts +19 -0
  597. package/dist/trivy-findings.d.ts.map +1 -0
  598. package/dist/trivy-findings.js +424 -0
  599. package/dist/trivy-findings.js.map +1 -0
  600. package/dist/trivy-import.d.ts +19 -0
  601. package/dist/trivy-import.d.ts.map +1 -0
  602. package/dist/trivy-import.js +151 -0
  603. package/dist/trivy-import.js.map +1 -0
  604. package/dist/trusted-executable.d.ts +6 -0
  605. package/dist/trusted-executable.d.ts.map +1 -1
  606. package/dist/trusted-executable.js +140 -37
  607. package/dist/trusted-executable.js.map +1 -1
  608. package/dist/validation-records.js +1 -1
  609. package/dist/validation-records.js.map +1 -1
  610. package/dist/veracode-findings.d.ts +1 -1
  611. package/dist/veracode-findings.d.ts.map +1 -1
  612. package/dist/veracode-findings.js +19 -6
  613. package/dist/veracode-findings.js.map +1 -1
  614. package/dist/version.d.ts +3 -1
  615. package/dist/version.d.ts.map +1 -1
  616. package/dist/version.js +184 -32
  617. package/dist/version.js.map +1 -1
  618. package/dist/vertex-pricing.d.ts +8 -0
  619. package/dist/vertex-pricing.d.ts.map +1 -0
  620. package/dist/vertex-pricing.js +20 -0
  621. package/dist/vertex-pricing.js.map +1 -0
  622. package/dist/windows-path.d.ts +1 -0
  623. package/dist/windows-path.d.ts.map +1 -1
  624. package/dist/windows-path.js +26 -1
  625. package/dist/windows-path.js.map +1 -1
  626. package/dist/wiz-findings.d.ts +6 -2
  627. package/dist/wiz-findings.d.ts.map +1 -1
  628. package/dist/wiz-findings.js +65 -89
  629. package/dist/wiz-findings.js.map +1 -1
  630. package/docs/classify-severity-records.md +27 -12
  631. package/docs/cli.md +853 -639
  632. package/docs/dedupe-records.md +44 -24
  633. package/docs/findings-service.md +84 -44
  634. package/docs/hosted-remediation.md +27 -11
  635. package/docs/hosted-scans.md +50 -42
  636. package/docs/sdk.md +903 -0
  637. package/docs/telemetry.md +236 -0
  638. package/docs/validate-records.md +78 -44
  639. package/package.json +23 -16
  640. package/schemas/external-findings.schema.json +4 -1
  641. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  642. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  643. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  644. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  645. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  646. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  647. package/dist/external-imports-feature.d.ts +0 -6
  648. package/dist/external-imports-feature.d.ts.map +0 -1
  649. package/dist/external-imports-feature.js +0 -51
  650. package/dist/external-imports-feature.js.map +0 -1
  651. package/dist/finding-normalization.d.ts +0 -5
  652. package/dist/finding-normalization.d.ts.map +0 -1
  653. package/dist/finding-normalization.js +0 -155
  654. package/dist/finding-normalization.js.map +0 -1
  655. package/dist/reader-selection.d.ts +0 -13
  656. package/dist/reader-selection.d.ts.map +0 -1
  657. package/dist/reader-selection.js +0 -81
  658. package/dist/reader-selection.js.map +0 -1
@@ -8,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(
@@ -51,10 +52,25 @@ def apply_migrations(
51
52
  backfill_security_targets: Callable[[sqlite3.Connection], None],
52
53
  *,
53
54
  immediate: bool = False,
55
+ discovery_roots: tuple[Path, ...] = (),
54
56
  ) -> None:
57
+ """Apply missing schema versions and repair supported historical migrations.
58
+
59
+ Commit pending work on the connection before starting the migration transaction.
60
+ Set immediate to acquire the SQLite write lock up front. The backfill callback
61
+ links older scans and workspaces to stable targets when required.
62
+ """
63
+ from workbench_target import scoped_git_discovery
64
+
55
65
  connection.commit()
56
66
  connection.execute("BEGIN IMMEDIATE" if immediate else "BEGIN")
57
- with connection:
67
+ with (
68
+ connection,
69
+ scoped_git_discovery(
70
+ lambda: [*migration_target_paths(connection), *discovery_roots],
71
+ recorded_git_roots=lambda: recorded_git_checkout_roots(connection),
72
+ ),
73
+ ):
58
74
  connection.execute(
59
75
  """
60
76
  CREATE TABLE IF NOT EXISTS schema_migrations (
@@ -71,12 +87,39 @@ def apply_migrations(
71
87
  should_backfill_targets = False
72
88
  for version, name, sql in migrations:
73
89
  if version == 6:
74
- repair_thread_scoped_workspaces_migration(connection)
90
+ # Preserve the original one-line index declaration in sqlite_schema.
91
+ for statement in _STATEMENTS[6]:
92
+ apply_repair_statement(connection, statement.replace("\n", " "))
75
93
  elif version == 16:
76
94
  should_backfill_targets = repair_stable_targets_migration(connection)
95
+ elif version == 67:
96
+ should_backfill_targets = (
97
+ repair_repository_identity_migration(connection)
98
+ or version not in applied
99
+ or should_backfill_targets
100
+ )
77
101
  elif version in applied:
78
- if version in (2, 12, 13, 26, 28, 31, 32, 42, 47, 50, 54, 55, 58, 59, 60):
79
- repair_additive_migration(connection, version)
102
+ if version in (
103
+ 2,
104
+ 12,
105
+ 13,
106
+ 26,
107
+ 28,
108
+ 31,
109
+ 32,
110
+ 42,
111
+ 47,
112
+ 50,
113
+ 54,
114
+ 55,
115
+ 58,
116
+ 59,
117
+ 60,
118
+ 61,
119
+ 69,
120
+ 70,
121
+ ):
122
+ repair_schema(connection, version)
80
123
  elif version == 11:
81
124
  repair_deep_scan_migration(connection)
82
125
  else:
@@ -87,6 +130,10 @@ def apply_migrations(
87
130
  connection.execute(statement)
88
131
  if version == 38:
89
132
  migrate_finding_workflow_results(connection)
133
+ elif version == 68:
134
+ from workbench_target_state import upgrade_linux_repository_generations
135
+
136
+ upgrade_linux_repository_generations(connection)
90
137
  if version not in applied:
91
138
  connection.execute(
92
139
  "INSERT INTO schema_migrations (version, name, applied_at) VALUES (?, ?, ?)",
@@ -98,6 +145,65 @@ def apply_migrations(
98
145
  backfill_security_targets(connection)
99
146
 
100
147
 
148
+ def migration_target_paths(connection: sqlite3.Connection) -> list[Path]:
149
+ paths: set[Path] = set()
150
+ for table, column in (
151
+ ("security_targets", "current_path"),
152
+ ("workspaces", "target_path"),
153
+ ("scans", "target_path"),
154
+ ):
155
+ columns = {row["name"] for row in connection.execute(f"PRAGMA table_info({table})")}
156
+ if column in columns:
157
+ condition = (
158
+ " AND (target_path_unvalidated = 0 OR target_id IS NOT NULL)"
159
+ if table == "workspaces" and "target_path_unvalidated" in columns
160
+ else ""
161
+ )
162
+ paths.update(
163
+ Path(row[0])
164
+ for row in connection.execute(
165
+ f"SELECT DISTINCT {column} FROM {table} WHERE {column} IS NOT NULL{condition}"
166
+ )
167
+ )
168
+ return list(paths)
169
+
170
+
171
+ def recorded_git_checkout_roots(connection: sqlite3.Connection) -> set[Path] | None:
172
+ """Return saved boundaries, or None if any historical target lacks one."""
173
+ target_columns = {
174
+ row["name"] for row in connection.execute("PRAGMA table_info(security_targets)")
175
+ }
176
+ boundaries = (
177
+ {
178
+ Path(target): Path(root)
179
+ for target, root in connection.execute(
180
+ "SELECT current_path, git_checkout_root FROM security_targets "
181
+ "WHERE git_checkout_root IS NOT NULL"
182
+ )
183
+ }
184
+ if "git_checkout_root" in target_columns
185
+ else {}
186
+ )
187
+ # Even an unversioned scan may have come from an unborn Git checkout.
188
+ if any(path not in boundaries for path in migration_target_paths(connection)):
189
+ return None
190
+ roots = set(boundaries.values())
191
+ columns = {row["name"] for row in connection.execute("PRAGMA table_info(workspaces)")}
192
+ if "target_path_unvalidated" in columns:
193
+ saved = (
194
+ "rejected_checkout_roots_json" if "rejected_checkout_roots_json" in columns else "NULL"
195
+ )
196
+ for (root,) in connection.execute(
197
+ f"SELECT DISTINCT value FROM workspaces LEFT JOIN json_each({saved}) "
198
+ f"WHERE {saved} IS NOT NULL OR "
199
+ "(target_path IS NOT NULL AND target_path_unvalidated = 1 AND target_id IS NULL)"
200
+ ):
201
+ if root is None:
202
+ return None
203
+ roots.add(Path(root))
204
+ return roots
205
+
206
+
101
207
  def normalize_pre_release_migrations(connection: sqlite3.Connection, timestamp: str) -> None:
102
208
  for query in _REPAIR_PLAN:
103
209
  actions = connection.execute("\n".join(query), {"history": _REPAIR_HISTORY}).fetchall()
@@ -106,7 +212,7 @@ def normalize_pre_release_migrations(connection: sqlite3.Connection, timestamp:
106
212
  if operation == "error":
107
213
  raise SystemExit(value)
108
214
  if operation == "additive":
109
- repair_additive_migration(connection, value)
215
+ repair_schema(connection, value)
110
216
  elif operation == "column":
111
217
  add_migration_column(connection, value)
112
218
  else:
@@ -134,19 +240,10 @@ def repair_deep_scan_migration(connection: sqlite3.Connection) -> None:
134
240
  if not owner_column_missing and expected_objects <= existing_objects:
135
241
  return
136
242
 
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
243
+ for statement in _STATEMENTS[11]:
143
244
  if statement.startswith("UPDATE scans") and not owner_column_missing:
144
245
  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)
246
+ apply_repair_statement(connection, statement)
150
247
  if statement.startswith("UPDATE scans") and "continuation_thread_id" in scan_columns:
151
248
  connection.execute(
152
249
  "UPDATE scans SET deep_scan_owner_thread_id = continuation_thread_id "
@@ -156,28 +253,18 @@ def repair_deep_scan_migration(connection: sqlite3.Connection) -> None:
156
253
 
157
254
 
158
255
  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
- )
256
+ threshold, count, backfill = _STATEMENTS[27]
257
+ if add_migration_column(connection, threshold):
258
+ connection.execute(backfill)
259
+ add_migration_column(connection, count)
178
260
 
179
261
 
180
262
  def repair_stable_targets_migration(connection: sqlite3.Connection) -> bool:
263
+ """Repair a partial target-ID migration and return whether the schema required repair.
264
+
265
+ Create missing target tables, columns, and indexes. Clear scan references
266
+ to missing target records so they can be backfilled.
267
+ """
181
268
  workspace_columns = {row["name"] for row in connection.execute("PRAGMA table_info(workspaces)")}
182
269
  scan_columns = {row["name"] for row in connection.execute("PRAGMA table_info(scans)")}
183
270
  existing_objects = {
@@ -191,48 +278,156 @@ def repair_stable_targets_migration(connection: sqlite3.Connection) -> bool:
191
278
  and "target_id" in scan_columns
192
279
  and existing_objects == {"security_targets", "scans_by_target"}
193
280
  ):
194
- return False
281
+ validated_workspace = (
282
+ "workspace.target_path_unvalidated = 0 AND "
283
+ if "target_path_unvalidated" in workspace_columns
284
+ else ""
285
+ )
286
+ needs_backfill = bool(
287
+ connection.execute(
288
+ f"""
289
+ SELECT EXISTS (
290
+ SELECT 1 FROM workspaces AS workspace
291
+ WHERE ({validated_workspace}workspace.target_id IS NULL
292
+ AND workspace.target_path IS NOT NULL)
293
+ OR (
294
+ workspace.target_id IS NOT NULL
295
+ AND NOT EXISTS (
296
+ SELECT 1 FROM security_targets
297
+ WHERE security_targets.id = workspace.target_id
298
+ )
299
+ )
300
+ ) OR EXISTS (
301
+ SELECT 1 FROM scans AS scan
302
+ WHERE scan.target_id IS NULL
303
+ OR NOT EXISTS (
304
+ SELECT 1 FROM security_targets
305
+ WHERE security_targets.id = scan.target_id
306
+ )
307
+ )
308
+ """
309
+ ).fetchone()[0]
310
+ )
311
+ if not needs_backfill:
312
+ return False
313
+ else:
314
+ repair_schema(connection, 16)
315
+
316
+ for table in ("workspaces", "scans"):
317
+ connection.execute(
318
+ f"""
319
+ UPDATE {table}
320
+ SET target_id = NULL
321
+ WHERE target_id IS NOT NULL
322
+ AND NOT EXISTS (
323
+ SELECT 1 FROM security_targets
324
+ WHERE security_targets.id = {table}.target_id
325
+ )
326
+ """
327
+ )
328
+ return True
329
+
330
+
331
+ def repair_repository_identity_migration(connection: sqlite3.Connection) -> bool:
332
+ columns = {row["name"] for row in connection.execute("PRAGMA table_info(security_targets)")}
333
+ index_exists = connection.execute(
334
+ "SELECT 1 FROM sqlite_master WHERE type = 'index' "
335
+ "AND name = 'security_targets_by_repository_identity'"
336
+ ).fetchone()
337
+ identity_changed = "repository_identity" not in columns or index_exists is None
338
+ if (
339
+ "repository_identity" in columns
340
+ and connection.execute(
341
+ "SELECT 1 FROM schema_migrations WHERE version = 67 AND name = ?",
342
+ ("persist repository identities",),
343
+ ).fetchone()
344
+ is not None
345
+ and not any(
346
+ row["name"] == "repository_generation"
347
+ for row in connection.execute("PRAGMA table_info(scans)")
348
+ )
349
+ ):
350
+ from workbench_target_state import normalize_pre_release_repository_identities
195
351
 
196
- migration_sql = next(sql for version, _, sql in MIGRATIONS if version == 16)
352
+ normalize_pre_release_repository_identities(connection)
353
+ migration_sql = next(sql for version, _, sql in MIGRATIONS if version == 67)
197
354
  for statement in sql_statements(migration_sql):
198
- if statement.startswith(("ALTER TABLE workspaces", "ALTER TABLE scans")):
355
+ if statement.startswith(("ALTER TABLE security_targets", "ALTER TABLE scans")):
199
356
  add_migration_column(connection, statement)
200
357
  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)
358
+ for prefix in ("CREATE UNIQUE INDEX ", "CREATE INDEX ", "CREATE TRIGGER "):
359
+ if statement.startswith(prefix):
360
+ statement = statement.replace(prefix, f"{prefix}IF NOT EXISTS ", 1)
361
+ break
203
362
  connection.execute(statement)
204
- connection.execute(
205
- """
206
- UPDATE scans
207
- SET target_id = NULL
208
- WHERE target_id IS NOT NULL
209
- AND NOT EXISTS (
210
- SELECT 1 FROM security_targets WHERE security_targets.id = scans.target_id
363
+
364
+ from workbench_scan_history import _scan_completion_order
365
+
366
+ if connection.execute(
367
+ "SELECT 1 FROM scans WHERE status = 'complete' AND completion_sequence IS NULL LIMIT 1"
368
+ ).fetchone():
369
+ # SQL preserves the recorded sequence. Both projections omit it so the merge
370
+ # compares each pending row with the timestamp of the next recorded completion.
371
+ recorded = connection.execute(
372
+ "SELECT id, started_at, completed_at FROM scans "
373
+ "WHERE status = 'complete' AND completion_sequence IS NOT NULL "
374
+ "ORDER BY completion_sequence"
375
+ ).fetchall()
376
+ unsequenced = connection.execute(
377
+ "SELECT id, started_at, completed_at FROM scans "
378
+ "WHERE status = 'complete' AND completion_sequence IS NULL"
379
+ ).fetchall()
380
+ pending = iter(sorted(unsequenced, key=_scan_completion_order))
381
+ candidate = next(pending, None)
382
+ completed = []
383
+ for scan in recorded:
384
+ while candidate is not None and _scan_completion_order(
385
+ candidate
386
+ ) <= _scan_completion_order(scan):
387
+ completed.append(candidate)
388
+ candidate = next(pending, None)
389
+ completed.append(scan)
390
+ if candidate is not None:
391
+ completed.append(candidate)
392
+ completed.extend(pending)
393
+ connection.execute("UPDATE scans SET completion_sequence = NULL WHERE status = 'complete'")
394
+ sequence = connection.execute(
395
+ "SELECT COALESCE(MAX(completion_sequence), 0) FROM scans"
396
+ ).fetchone()[0]
397
+ for scan in completed:
398
+ sequence += 1
399
+ connection.execute(
400
+ "UPDATE scans SET completion_sequence = ? WHERE id = ?",
401
+ (sequence, scan["id"]),
211
402
  )
212
- """
213
- )
214
- return True
403
+ return identity_changed
404
+
405
+
406
+ def repair_schema(connection: sqlite3.Connection, version: int) -> None:
407
+ for statement in _STATEMENTS[version]:
408
+ apply_repair_statement(connection, statement)
215
409
 
216
410
 
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):
411
+ def apply_repair_statement(connection: sqlite3.Connection, statement: str) -> None:
412
+ if statement.startswith("ALTER TABLE "):
220
413
  add_migration_column(connection, statement)
414
+ return
415
+ for prefix in ("CREATE UNIQUE INDEX ", "CREATE INDEX ", "CREATE TABLE "):
416
+ if statement.startswith(prefix):
417
+ statement = statement.replace(prefix, f"{prefix}IF NOT EXISTS ", 1)
418
+ break
419
+ connection.execute(statement)
221
420
 
222
421
 
223
- def add_migration_column(connection: sqlite3.Connection, statement: str) -> None:
422
+ def add_migration_column(connection: sqlite3.Connection, statement: str) -> bool:
224
423
  _, _, table, _, _, column, definition = statement.removesuffix(";").split(None, 6)
424
+ columns = {row["name"] for row in connection.execute(f"PRAGMA table_info({table})")}
425
+ if column in columns:
426
+ return False
225
427
  # Preserve the compact declarations used by historical repairs, including CHECK errors.
226
428
  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}")
429
+ connection.execute(f"ALTER TABLE {table} ADD COLUMN {column} {definition}")
430
+ return True
236
431
 
237
432
 
238
433
  def sql_statements(script: str) -> list[str]:
@@ -22,6 +22,7 @@ from workbench_target import (
22
22
 
23
23
 
24
24
  def require_target(value: str) -> Path:
25
+ """Return the resolved local directory or raise SystemExit if the supplied path is relative or missing."""
25
26
  expanded = Path(value).expanduser()
26
27
  if not expanded.is_absolute():
27
28
  raise SystemExit("Scan target must be an absolute local directory path.")
@@ -32,6 +33,7 @@ def require_target(value: str) -> Path:
32
33
 
33
34
 
34
35
  def inspect_target(target: Path) -> dict[str, Any]:
36
+ """Return the target path, display name, and local Git metadata used by setup."""
35
37
  return {
36
38
  "displayName": target.name,
37
39
  "targetMetadata": git_target_metadata(target),
@@ -40,6 +42,7 @@ def inspect_target(target: Path) -> dict[str, Any]:
40
42
 
41
43
 
42
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."""
43
46
  value = optional_text(revision, maximum=512)
44
47
  if not value:
45
48
  raise SystemExit(f"{label} is required.")
@@ -62,13 +65,18 @@ def require_diff_target(
62
65
  head_revision: str | None,
63
66
  content_digest: str | None,
64
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
+ """
65
73
  current_head = require_review_changes_target(target)
66
74
  if kind not in DIFF_TARGET_KINDS:
67
75
  raise SystemExit("Choose which Git changes to review before starting a diff scan.")
68
76
  if kind == "working_tree":
69
77
  base = resolve_git_commit(target, base_revision or "HEAD", "Working-tree base")
70
78
  head = resolve_git_commit(target, head_revision or current_head, "Working-tree HEAD")
71
- current_digest = worktree_content_digest(target)
79
+ current_digest = worktree_content_digest(target, expected_digest=content_digest)
72
80
  if base != current_head or head != current_head:
73
81
  raise SystemExit(
74
82
  "Repository HEAD changed after these working-tree changes were selected. "
@@ -131,6 +139,7 @@ def inspect_setup_values(
131
139
  diff_head_revision: str | None,
132
140
  diff_content_digest: str | None,
133
141
  ) -> dict[str, Any]:
142
+ """Validate the target, scope, and scan mode and return their normalized values and resolved diff target."""
134
143
  target = require_target(target_path)
135
144
  inspected = require_scannable_target(target)
136
145
  normalized_scope = require_scope(scope, mode, target)
@@ -165,6 +174,7 @@ def inspect_setup_values(
165
174
 
166
175
 
167
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."""
168
178
  revision = require_git_worktree_head(target)
169
179
  repository_root = git_output(target, "rev-parse", "--show-toplevel")
170
180
  if repository_root is None or not Path(repository_root).samefile(target):
@@ -175,6 +185,7 @@ def require_review_changes_target(target: Path) -> str:
175
185
 
176
186
 
177
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."""
178
189
  inspected = inspect_target(target)
179
190
  metadata = inspected["targetMetadata"]
180
191
  if metadata["isGit"] and not metadata["isWorktree"]:
@@ -185,6 +196,7 @@ def require_scannable_target(target: Path) -> dict[str, Any]:
185
196
 
186
197
 
187
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."""
188
200
  value = scope if scope.strip() else "."
189
201
  requested_scope = Path(value)
190
202
  if "\\" in value and (os.name != "nt" or not requested_scope.is_absolute()):
@@ -220,7 +232,7 @@ def inspect_selected_setup(args: argparse.Namespace) -> dict[str, Any]:
220
232
  )
221
233
  if args.mode == "deep":
222
234
  inspected["deepScanConfig"] = resolve_deep_scan_setup(
223
- os.cpu_count() or 1, args.deep_scan_project_json
235
+ project_json=args.deep_scan_project_json
224
236
  )
225
237
  elif args.deep_scan_project_json is not None:
226
238
  raise SystemExit("Project Deep Scan settings require Deep Scan mode.")
@@ -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):
@@ -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,6 +78,7 @@ 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:
81
+ """Return raw stdout for a successful offline Git command with replacement objects disabled, otherwise None."""
77
82
  result = git_command(
78
83
  repository,
79
84
  *arguments,
@@ -86,6 +91,7 @@ def offline_git_bytes(repository: Path, *arguments: str) -> bytes | None:
86
91
 
87
92
  @cache
88
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."""
89
95
  content = offline_git_bytes(repository, "ls-tree", "-z", tree)
90
96
  if content is None:
91
97
  return None
@@ -217,6 +223,12 @@ def capture_source_scopes(
217
223
  *,
218
224
  diff_target_kind: str | None = None,
219
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
+ """
220
232
  revision, snapshot = target_identity[:2]
221
233
  result: dict[str, Any] = {"version": 1, "revision": revision, "scopes": []}
222
234
  # HEAD cannot represent the uncommitted bytes reviewed by a working-tree scan.
@@ -267,6 +279,11 @@ def capture_source_scopes(
267
279
  def load_source_scopes(
268
280
  scan: sqlite3.Row, target: Path, requested: list[str]
269
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
+ """
270
287
  kind = scan["diff_target_kind"] if "diff_target_kind" in scan.keys() else None
271
288
  if kind == "working_tree" or (
272
289
  "mode" in scan.keys() and scan["mode"] == "diff" and kind not in ("commit", "range")
@@ -343,6 +360,7 @@ def load_source_scopes(
343
360
  def source_object_for_path(
344
361
  repository: Path, tree: str, target: Path, value: str, scope: dict[str, str]
345
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."""
346
364
  path = relative_path(value)
347
365
  if path is None or safe_source_path(target, value) is None:
348
366
  return None