@openai/codex-security 0.8.3 → 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 (534) hide show
  1. package/README.md +192 -151
  2. package/_bundled_plugin/.mcp.json +5 -1
  3. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  4. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  5. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  6. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  7. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  8. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  9. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  10. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/package.json +1 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  20. package/_bundled_plugin/mcp/server.mjs +2 -11
  21. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  22. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  23. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  24. package/_bundled_plugin/references/final-report.md +5 -3
  25. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  26. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  27. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  28. package/_bundled_plugin/references/scan-contract.md +27 -33
  29. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  30. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  31. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  32. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  33. package/_bundled_plugin/scripts/deep_scan_workbench.py +165 -342
  34. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  35. package/_bundled_plugin/scripts/finalize_scan_contract.py +153 -227
  36. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  37. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  38. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  39. package/_bundled_plugin/scripts/posix_scan_local_files.py +11 -0
  40. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  41. package/_bundled_plugin/scripts/report_projection.py +81 -43
  42. package/_bundled_plugin/scripts/review_state.py +8 -2
  43. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  44. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  45. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  46. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  47. package/_bundled_plugin/scripts/windows_scan_local_files.py +388 -17
  48. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  49. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  50. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  51. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  52. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  53. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  54. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  55. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  56. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  57. package/_bundled_plugin/scripts/workbench_cli.py +30 -12
  58. package/_bundled_plugin/scripts/workbench_constants.py +10 -0
  59. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  60. package/_bundled_plugin/scripts/workbench_db.py +369 -137
  61. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  62. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  63. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  64. package/_bundled_plugin/scripts/workbench_native_indexes.py +12 -12
  65. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  66. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  67. package/_bundled_plugin/scripts/workbench_remediation.py +13 -0
  68. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  69. package/_bundled_plugin/scripts/workbench_scan_history.py +117 -55
  70. package/_bundled_plugin/scripts/workbench_scan_start.py +83 -24
  71. package/_bundled_plugin/scripts/workbench_scan_usage.py +644 -68
  72. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  73. package/_bundled_plugin/scripts/workbench_setup.py +13 -1
  74. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  75. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  76. package/_bundled_plugin/scripts/workbench_target.py +127 -56
  77. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  78. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  79. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -23
  80. package/_bundled_plugin/shared/workbench-migrations.json +34 -0
  81. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  82. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  83. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -1
  84. package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -25
  85. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  86. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  87. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  88. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  89. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  90. package/dist/api.d.ts +39 -4
  91. package/dist/api.d.ts.map +1 -1
  92. package/dist/api.js +774 -292
  93. package/dist/api.js.map +1 -1
  94. package/dist/auth.d.ts.map +1 -1
  95. package/dist/auth.js +4 -6
  96. package/dist/auth.js.map +1 -1
  97. package/dist/bedrock-oss-pricing.d.ts +6 -0
  98. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  99. package/dist/bedrock-oss-pricing.js +58 -0
  100. package/dist/bedrock-oss-pricing.js.map +1 -0
  101. package/dist/bedrock-pricing.d.ts +15 -0
  102. package/dist/bedrock-pricing.d.ts.map +1 -0
  103. package/dist/bedrock-pricing.js +117 -0
  104. package/dist/bedrock-pricing.js.map +1 -0
  105. package/dist/blackduck-findings.d.ts.map +1 -1
  106. package/dist/blackduck-findings.js +35 -20
  107. package/dist/blackduck-findings.js.map +1 -1
  108. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  109. package/dist/bulk-scan-discovery.js +4 -4
  110. package/dist/bulk-scan-discovery.js.map +1 -1
  111. package/dist/checkmarx-evidence.d.ts +19 -0
  112. package/dist/checkmarx-evidence.d.ts.map +1 -0
  113. package/dist/checkmarx-evidence.js +36 -0
  114. package/dist/checkmarx-evidence.js.map +1 -0
  115. package/dist/checkmarx-findings.d.ts +4 -0
  116. package/dist/checkmarx-findings.d.ts.map +1 -0
  117. package/dist/checkmarx-findings.js +27 -0
  118. package/dist/checkmarx-findings.js.map +1 -0
  119. package/dist/checkmarx-one.d.ts +4 -0
  120. package/dist/checkmarx-one.d.ts.map +1 -0
  121. package/dist/checkmarx-one.js +53 -0
  122. package/dist/checkmarx-one.js.map +1 -0
  123. package/dist/checkmarx-repository.d.ts +12 -0
  124. package/dist/checkmarx-repository.d.ts.map +1 -0
  125. package/dist/checkmarx-repository.js +181 -0
  126. package/dist/checkmarx-repository.js.map +1 -0
  127. package/dist/checkmarx-xml.d.ts +12 -0
  128. package/dist/checkmarx-xml.d.ts.map +1 -0
  129. package/dist/checkmarx-xml.js +196 -0
  130. package/dist/checkmarx-xml.js.map +1 -0
  131. package/dist/classify-severity-records.d.ts +1 -9
  132. package/dist/classify-severity-records.d.ts.map +1 -1
  133. package/dist/classify-severity-records.js +3 -13
  134. package/dist/classify-severity-records.js.map +1 -1
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +2 -4
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli.d.ts +11 -5
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1734 -1238
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.js +2 -2
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/component-scan.d.ts +16 -3
  145. package/dist/component-scan.d.ts.map +1 -1
  146. package/dist/component-scan.js +27 -2
  147. package/dist/component-scan.js.map +1 -1
  148. package/dist/config.d.ts.map +1 -1
  149. package/dist/config.js +100 -66
  150. package/dist/config.js.map +1 -1
  151. package/dist/continuum-findings.d.ts.map +1 -1
  152. package/dist/continuum-findings.js +80 -12
  153. package/dist/continuum-findings.js.map +1 -1
  154. package/dist/contract-values.d.ts +2 -0
  155. package/dist/contract-values.d.ts.map +1 -1
  156. package/dist/contract-values.js +12 -9
  157. package/dist/contract-values.js.map +1 -1
  158. package/dist/cost-model.d.ts +13 -1
  159. package/dist/cost-model.d.ts.map +1 -1
  160. package/dist/cost-model.js +66 -112
  161. package/dist/cost-model.js.map +1 -1
  162. package/dist/cost.d.ts +42 -3
  163. package/dist/cost.d.ts.map +1 -1
  164. package/dist/cost.js +483 -104
  165. package/dist/cost.js.map +1 -1
  166. package/dist/custom-publish.d.ts +4 -0
  167. package/dist/custom-publish.d.ts.map +1 -1
  168. package/dist/custom-publish.js +40 -3
  169. package/dist/custom-publish.js.map +1 -1
  170. package/dist/deduplication/local.d.ts +2 -2
  171. package/dist/deduplication/local.d.ts.map +1 -1
  172. package/dist/deduplication/local.js +2 -2
  173. package/dist/deduplication/local.js.map +1 -1
  174. package/dist/deduplication/refusal.d.ts.map +1 -1
  175. package/dist/deduplication/refusal.js +25 -5
  176. package/dist/deduplication/refusal.js.map +1 -1
  177. package/dist/deduplication/scan.d.ts +3 -0
  178. package/dist/deduplication/scan.d.ts.map +1 -1
  179. package/dist/deduplication/scan.js +1 -1
  180. package/dist/deduplication/scan.js.map +1 -1
  181. package/dist/deep-config.d.ts +0 -1
  182. package/dist/deep-config.d.ts.map +1 -1
  183. package/dist/deep-config.js +22 -33
  184. package/dist/deep-config.js.map +1 -1
  185. package/dist/deep-scan-defaults.d.ts +2 -0
  186. package/dist/deep-scan-defaults.d.ts.map +1 -1
  187. package/dist/deep-scan-defaults.js +28 -1
  188. package/dist/deep-scan-defaults.js.map +1 -1
  189. package/dist/deep-scan.d.ts +2 -0
  190. package/dist/deep-scan.d.ts.map +1 -1
  191. package/dist/deep-scan.js +28 -4
  192. package/dist/deep-scan.js.map +1 -1
  193. package/dist/default-severity-rubric.d.ts +1 -1
  194. package/dist/default-severity-rubric.d.ts.map +1 -1
  195. package/dist/default-severity-rubric.js +1 -1
  196. package/dist/default-severity-rubric.js.map +1 -1
  197. package/dist/endor-findings.d.ts +3 -1
  198. package/dist/endor-findings.d.ts.map +1 -1
  199. package/dist/endor-findings.js +103 -45
  200. package/dist/endor-findings.js.map +1 -1
  201. package/dist/errors.d.ts +1 -1
  202. package/dist/errors.d.ts.map +1 -1
  203. package/dist/errors.js +8 -1
  204. package/dist/errors.js.map +1 -1
  205. package/dist/external-findings-import.d.ts +5 -3
  206. package/dist/external-findings-import.d.ts.map +1 -1
  207. package/dist/external-findings-import.js +7 -6
  208. package/dist/external-findings-import.js.map +1 -1
  209. package/dist/external-findings-local.d.ts +7 -5
  210. package/dist/external-findings-local.d.ts.map +1 -1
  211. package/dist/external-findings-local.js +337 -89
  212. package/dist/external-findings-local.js.map +1 -1
  213. package/dist/external-findings-publish.d.ts +8 -6
  214. package/dist/external-findings-publish.d.ts.map +1 -1
  215. package/dist/external-findings-publish.js +1318 -258
  216. package/dist/external-findings-publish.js.map +1 -1
  217. package/dist/external-findings-read.d.ts +20 -2
  218. package/dist/external-findings-read.d.ts.map +1 -1
  219. package/dist/external-findings-read.js +148 -66
  220. package/dist/external-findings-read.js.map +1 -1
  221. package/dist/external-findings.d.ts +15 -3
  222. package/dist/external-findings.d.ts.map +1 -1
  223. package/dist/external-findings.js +42 -1
  224. package/dist/external-findings.js.map +1 -1
  225. package/dist/external-import-contract.d.ts +5 -1
  226. package/dist/external-import-contract.d.ts.map +1 -1
  227. package/dist/external-import-contract.js +23 -9
  228. package/dist/external-import-contract.js.map +1 -1
  229. package/dist/external-import-models.d.ts +1 -1
  230. package/dist/external-import-models.d.ts.map +1 -1
  231. package/dist/external-import-models.js.map +1 -1
  232. package/dist/feedback.d.ts.map +1 -1
  233. package/dist/feedback.js +5 -4
  234. package/dist/feedback.js.map +1 -1
  235. package/dist/finding-prompt.d.ts +5 -0
  236. package/dist/finding-prompt.d.ts.map +1 -0
  237. package/dist/finding-prompt.js +32 -0
  238. package/dist/finding-prompt.js.map +1 -0
  239. package/dist/findings-client.d.ts +1 -0
  240. package/dist/findings-client.d.ts.map +1 -1
  241. package/dist/findings-client.js +27 -3
  242. package/dist/findings-client.js.map +1 -1
  243. package/dist/github-advisories.d.ts.map +1 -1
  244. package/dist/github-advisories.js +0 -2
  245. package/dist/github-advisories.js.map +1 -1
  246. package/dist/github-dependabot-findings.d.ts.map +1 -1
  247. package/dist/github-dependabot-findings.js +15 -4
  248. package/dist/github-dependabot-findings.js.map +1 -1
  249. package/dist/github-findings.d.ts +4 -1
  250. package/dist/github-findings.d.ts.map +1 -1
  251. package/dist/github-findings.js +55 -30
  252. package/dist/github-findings.js.map +1 -1
  253. package/dist/hosted-git-remotes.d.ts +5 -0
  254. package/dist/hosted-git-remotes.d.ts.map +1 -0
  255. package/dist/hosted-git-remotes.js +285 -0
  256. package/dist/hosted-git-remotes.js.map +1 -0
  257. package/dist/hosted-git-repository.d.ts +28 -0
  258. package/dist/hosted-git-repository.d.ts.map +1 -0
  259. package/dist/hosted-git-repository.js +222 -0
  260. package/dist/hosted-git-repository.js.map +1 -0
  261. package/dist/hosted-scan-protocol.js +2 -2
  262. package/dist/hosted-scan-protocol.js.map +1 -1
  263. package/dist/hosted-scan.d.ts.map +1 -1
  264. package/dist/hosted-scan.js +16 -11
  265. package/dist/hosted-scan.js.map +1 -1
  266. package/dist/hosted-scanner-http.d.ts +21 -0
  267. package/dist/hosted-scanner-http.d.ts.map +1 -0
  268. package/dist/hosted-scanner-http.js +204 -0
  269. package/dist/hosted-scanner-http.js.map +1 -0
  270. package/dist/hosted-scanner-v1.d.ts +6 -0
  271. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  272. package/dist/hosted-scanner-v1.js +60 -0
  273. package/dist/hosted-scanner-v1.js.map +1 -0
  274. package/dist/import-scan.d.ts.map +1 -1
  275. package/dist/import-scan.js +3 -0
  276. package/dist/import-scan.js.map +1 -1
  277. package/dist/index.d.ts +18 -7
  278. package/dist/index.d.ts.map +1 -1
  279. package/dist/index.js +10 -2
  280. package/dist/index.js.map +1 -1
  281. package/dist/inspector-findings.d.ts.map +1 -1
  282. package/dist/inspector-findings.js +47 -65
  283. package/dist/inspector-findings.js.map +1 -1
  284. package/dist/knowledge-base.d.ts.map +1 -1
  285. package/dist/knowledge-base.js +68 -5
  286. package/dist/knowledge-base.js.map +1 -1
  287. package/dist/local-git-metadata.d.ts +1 -1
  288. package/dist/local-git-metadata.d.ts.map +1 -1
  289. package/dist/local-git-metadata.js +1 -2
  290. package/dist/local-git-metadata.js.map +1 -1
  291. package/dist/multiscan.d.ts +6 -4
  292. package/dist/multiscan.d.ts.map +1 -1
  293. package/dist/multiscan.js +138 -65
  294. package/dist/multiscan.js.map +1 -1
  295. package/dist/native-json-findings.d.ts +2 -1
  296. package/dist/native-json-findings.d.ts.map +1 -1
  297. package/dist/native-json-findings.js +12 -2
  298. package/dist/native-json-findings.js.map +1 -1
  299. package/dist/opengrep-findings.d.ts +1 -0
  300. package/dist/opengrep-findings.d.ts.map +1 -1
  301. package/dist/opengrep-findings.js +17 -13
  302. package/dist/opengrep-findings.js.map +1 -1
  303. package/dist/operation-telemetry.d.ts +104 -0
  304. package/dist/operation-telemetry.d.ts.map +1 -0
  305. package/dist/operation-telemetry.js +293 -0
  306. package/dist/operation-telemetry.js.map +1 -0
  307. package/dist/plugin-python-probe.d.ts +4 -0
  308. package/dist/plugin-python-probe.d.ts.map +1 -0
  309. package/dist/plugin-python-probe.js +10 -0
  310. package/dist/plugin-python-probe.js.map +1 -0
  311. package/dist/private-finding-import.d.ts +97 -2
  312. package/dist/private-finding-import.d.ts.map +1 -1
  313. package/dist/private-finding-import.js +58 -34
  314. package/dist/private-finding-import.js.map +1 -1
  315. package/dist/provider-profile.d.ts +1 -1
  316. package/dist/provider-profile.d.ts.map +1 -1
  317. package/dist/provider-profile.js +8 -1
  318. package/dist/provider-profile.js.map +1 -1
  319. package/dist/publication-telemetry.d.ts +45 -0
  320. package/dist/publication-telemetry.d.ts.map +1 -0
  321. package/dist/publication-telemetry.js +50 -0
  322. package/dist/publication-telemetry.js.map +1 -0
  323. package/dist/publish.d.ts +4 -0
  324. package/dist/publish.d.ts.map +1 -1
  325. package/dist/publish.js +42 -2
  326. package/dist/publish.js.map +1 -1
  327. package/dist/reader-selection.d.ts +2 -0
  328. package/dist/reader-selection.d.ts.map +1 -1
  329. package/dist/reader-selection.js +8 -0
  330. package/dist/reader-selection.js.map +1 -1
  331. package/dist/remediation.d.ts +1 -4
  332. package/dist/remediation.d.ts.map +1 -1
  333. package/dist/remediation.js +3 -7
  334. package/dist/remediation.js.map +1 -1
  335. package/dist/request-metadata.d.ts +3 -0
  336. package/dist/request-metadata.d.ts.map +1 -1
  337. package/dist/request-metadata.js +9 -0
  338. package/dist/request-metadata.js.map +1 -1
  339. package/dist/result.d.ts +4 -0
  340. package/dist/result.d.ts.map +1 -1
  341. package/dist/result.js +1 -1
  342. package/dist/result.js.map +1 -1
  343. package/dist/retry-windows-rename.d.ts +8 -0
  344. package/dist/retry-windows-rename.d.ts.map +1 -0
  345. package/dist/retry-windows-rename.js +24 -0
  346. package/dist/retry-windows-rename.js.map +1 -0
  347. package/dist/runtime.d.ts +20 -0
  348. package/dist/runtime.d.ts.map +1 -1
  349. package/dist/runtime.js +313 -110
  350. package/dist/runtime.js.map +1 -1
  351. package/dist/saved-scan-bootstrap.d.ts +1 -0
  352. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  353. package/dist/saved-scan-bootstrap.js +18 -15
  354. package/dist/saved-scan-bootstrap.js.map +1 -1
  355. package/dist/scan-activity.d.ts.map +1 -1
  356. package/dist/scan-activity.js +141 -56
  357. package/dist/scan-activity.js.map +1 -1
  358. package/dist/scan-comparison.d.ts +10 -5
  359. package/dist/scan-comparison.d.ts.map +1 -1
  360. package/dist/scan-comparison.js +60 -15
  361. package/dist/scan-comparison.js.map +1 -1
  362. package/dist/scan-dashboard.d.ts +6 -6
  363. package/dist/scan-dashboard.d.ts.map +1 -1
  364. package/dist/scan-dashboard.js +75 -42
  365. package/dist/scan-dashboard.js.map +1 -1
  366. package/dist/scan-executor.d.ts +10 -1
  367. package/dist/scan-executor.d.ts.map +1 -1
  368. package/dist/scan-executor.js +22 -2
  369. package/dist/scan-executor.js.map +1 -1
  370. package/dist/scan-history-renderer.d.ts.map +1 -1
  371. package/dist/scan-history-renderer.js +9 -19
  372. package/dist/scan-history-renderer.js.map +1 -1
  373. package/dist/scan-logs.d.ts +12 -0
  374. package/dist/scan-logs.d.ts.map +1 -1
  375. package/dist/scan-logs.js +106 -77
  376. package/dist/scan-logs.js.map +1 -1
  377. package/dist/scan-measurement.d.ts +26 -0
  378. package/dist/scan-measurement.d.ts.map +1 -0
  379. package/dist/scan-measurement.js +77 -0
  380. package/dist/scan-measurement.js.map +1 -0
  381. package/dist/scan-progress.d.ts +1 -0
  382. package/dist/scan-progress.d.ts.map +1 -1
  383. package/dist/scan-progress.js +3 -0
  384. package/dist/scan-progress.js.map +1 -1
  385. package/dist/scan-sessions.d.ts.map +1 -1
  386. package/dist/scan-sessions.js +4 -1
  387. package/dist/scan-sessions.js.map +1 -1
  388. package/dist/scan-settings.d.ts +1 -1
  389. package/dist/scan-settings.d.ts.map +1 -1
  390. package/dist/scan-settings.js +1 -24
  391. package/dist/scan-settings.js.map +1 -1
  392. package/dist/scanner-import.d.ts +20 -2
  393. package/dist/scanner-import.d.ts.map +1 -1
  394. package/dist/scanner-import.js +200 -8
  395. package/dist/scanner-import.js.map +1 -1
  396. package/dist/scanner-repository-url.d.ts +4 -1
  397. package/dist/scanner-repository-url.d.ts.map +1 -1
  398. package/dist/scanner-repository-url.js +10 -6
  399. package/dist/scanner-repository-url.js.map +1 -1
  400. package/dist/security-policy.d.ts +1 -1
  401. package/dist/security-policy.d.ts.map +1 -1
  402. package/dist/security-policy.js.map +1 -1
  403. package/dist/semgrep-findings.d.ts +6 -3
  404. package/dist/semgrep-findings.d.ts.map +1 -1
  405. package/dist/semgrep-findings.js +107 -43
  406. package/dist/semgrep-findings.js.map +1 -1
  407. package/dist/semgrep-guardian-findings.d.ts +38 -0
  408. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  409. package/dist/semgrep-guardian-findings.js +165 -0
  410. package/dist/semgrep-guardian-findings.js.map +1 -0
  411. package/dist/semgrep-platform-collector.d.ts +26 -0
  412. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  413. package/dist/semgrep-platform-collector.js +108 -0
  414. package/dist/semgrep-platform-collector.js.map +1 -0
  415. package/dist/semgrep-platform-findings.d.ts +207 -6
  416. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  417. package/dist/semgrep-platform-findings.js +983 -103
  418. package/dist/semgrep-platform-findings.js.map +1 -1
  419. package/dist/semgrep-platform-v1.d.ts +6 -0
  420. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  421. package/dist/semgrep-platform-v1.js +83 -0
  422. package/dist/semgrep-platform-v1.js.map +1 -0
  423. package/dist/server/api.d.ts +1 -1
  424. package/dist/server/api.d.ts.map +1 -1
  425. package/dist/server/api.js.map +1 -1
  426. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  427. package/dist/server/embedding-tokenizer.d.ts +2 -0
  428. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  429. package/dist/server/embedding-tokenizer.js +322 -0
  430. package/dist/server/embedding-tokenizer.js.map +6 -0
  431. package/dist/server/embeddings.d.ts +16 -2
  432. package/dist/server/embeddings.d.ts.map +1 -1
  433. package/dist/server/embeddings.js +35 -5
  434. package/dist/server/embeddings.js.map +1 -1
  435. package/dist/session-lines.d.ts +5 -0
  436. package/dist/session-lines.d.ts.map +1 -0
  437. package/dist/session-lines.js +60 -0
  438. package/dist/session-lines.js.map +1 -0
  439. package/dist/severity-review.d.ts +3 -1
  440. package/dist/severity-review.d.ts.map +1 -1
  441. package/dist/severity-review.js +3 -2
  442. package/dist/severity-review.js.map +1 -1
  443. package/dist/skill-authentication.d.ts +1 -0
  444. package/dist/skill-authentication.d.ts.map +1 -1
  445. package/dist/skill-authentication.js +1 -0
  446. package/dist/skill-authentication.js.map +1 -1
  447. package/dist/snyk-findings.d.ts +7 -2
  448. package/dist/snyk-findings.d.ts.map +1 -1
  449. package/dist/snyk-findings.js +93 -70
  450. package/dist/snyk-findings.js.map +1 -1
  451. package/dist/snyk-rest-findings.d.ts +76 -0
  452. package/dist/snyk-rest-findings.d.ts.map +1 -0
  453. package/dist/snyk-rest-findings.js +1051 -0
  454. package/dist/snyk-rest-findings.js.map +1 -0
  455. package/dist/snyk-rest-v1.d.ts +28 -0
  456. package/dist/snyk-rest-v1.d.ts.map +1 -0
  457. package/dist/snyk-rest-v1.js +132 -0
  458. package/dist/snyk-rest-v1.js.map +1 -0
  459. package/dist/snyk-token-origin.d.ts +4 -0
  460. package/dist/snyk-token-origin.d.ts.map +1 -0
  461. package/dist/snyk-token-origin.js +82 -0
  462. package/dist/snyk-token-origin.js.map +1 -0
  463. package/dist/sonar-collector.d.ts.map +1 -1
  464. package/dist/sonar-collector.js +0 -3
  465. package/dist/sonar-collector.js.map +1 -1
  466. package/dist/sonar-import.d.ts.map +1 -1
  467. package/dist/sonar-import.js +2 -4
  468. package/dist/sonar-import.js.map +1 -1
  469. package/dist/target-drift.d.ts +9 -0
  470. package/dist/target-drift.d.ts.map +1 -0
  471. package/dist/target-drift.js +27 -0
  472. package/dist/target-drift.js.map +1 -0
  473. package/dist/targets.d.ts +2 -0
  474. package/dist/targets.d.ts.map +1 -1
  475. package/dist/targets.js +56 -20
  476. package/dist/targets.js.map +1 -1
  477. package/dist/tenable-findings.d.ts +9 -0
  478. package/dist/tenable-findings.d.ts.map +1 -0
  479. package/dist/tenable-findings.js +122 -0
  480. package/dist/tenable-findings.js.map +1 -0
  481. package/dist/terminal-stream.d.ts +13 -0
  482. package/dist/terminal-stream.d.ts.map +1 -0
  483. package/dist/terminal-stream.js +35 -0
  484. package/dist/terminal-stream.js.map +1 -0
  485. package/dist/trivy-findings.d.ts +19 -0
  486. package/dist/trivy-findings.d.ts.map +1 -0
  487. package/dist/trivy-findings.js +435 -0
  488. package/dist/trivy-findings.js.map +1 -0
  489. package/dist/trivy-import.d.ts +19 -0
  490. package/dist/trivy-import.d.ts.map +1 -0
  491. package/dist/trivy-import.js +151 -0
  492. package/dist/trivy-import.js.map +1 -0
  493. package/dist/validation-records.js +1 -1
  494. package/dist/validation-records.js.map +1 -1
  495. package/dist/veracode-findings.d.ts +2 -0
  496. package/dist/veracode-findings.d.ts.map +1 -1
  497. package/dist/veracode-findings.js +49 -11
  498. package/dist/veracode-findings.js.map +1 -1
  499. package/dist/vertex-pricing.d.ts +8 -0
  500. package/dist/vertex-pricing.d.ts.map +1 -0
  501. package/dist/vertex-pricing.js +20 -0
  502. package/dist/vertex-pricing.js.map +1 -0
  503. package/dist/windows-path.d.ts +1 -0
  504. package/dist/windows-path.d.ts.map +1 -1
  505. package/dist/windows-path.js +26 -1
  506. package/dist/windows-path.js.map +1 -1
  507. package/dist/wiz-findings.d.ts +4 -0
  508. package/dist/wiz-findings.d.ts.map +1 -1
  509. package/dist/wiz-findings.js +57 -3
  510. package/dist/wiz-findings.js.map +1 -1
  511. package/docs/classify-severity-records.md +27 -12
  512. package/docs/cli.md +497 -550
  513. package/docs/dedupe-records.md +44 -24
  514. package/docs/findings-service.md +66 -39
  515. package/docs/hosted-remediation.md +14 -7
  516. package/docs/hosted-scans.md +50 -42
  517. package/docs/telemetry.md +236 -0
  518. package/docs/validate-records.md +78 -44
  519. package/package.json +18 -15
  520. package/schemas/external-findings.schema.json +3 -1
  521. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  522. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  523. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  524. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  525. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  526. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  527. package/dist/external-imports-feature.d.ts +0 -6
  528. package/dist/external-imports-feature.d.ts.map +0 -1
  529. package/dist/external-imports-feature.js +0 -51
  530. package/dist/external-imports-feature.js.map +0 -1
  531. package/dist/finding-normalization.d.ts +0 -5
  532. package/dist/finding-normalization.d.ts.map +0 -1
  533. package/dist/finding-normalization.js +0 -155
  534. package/dist/finding-normalization.js.map +0 -1
@@ -16,12 +16,12 @@ import tempfile
16
16
  import unicodedata
17
17
  from concurrent.futures import ThreadPoolExecutor
18
18
  from pathlib import Path, PurePosixPath
19
- from typing import Any, BinaryIO, Callable
19
+ from typing import Any, BinaryIO, Callable, cast
20
20
 
21
21
  # Some plugin hosts launch Python with safe-path isolation enabled.
22
22
  sys.path.insert(0, str(Path(__file__).resolve().parent))
23
23
  from filesystem_identity import stored_filesystem_identity_matches
24
- from windows_scan_local_files import copy_directory_junction
24
+ from windows_scan_local_files import copy_directory_junction, pinned_root_git_marker
25
25
  from workbench_constants import GIT_REPOSITORY_ENVIRONMENT
26
26
 
27
27
  SOURCE_METADATA_DIRECTORIES = {".git", ".svn"}
@@ -44,6 +44,11 @@ def committed_diff_snapshot_digest(kind: str, base_revision: str, head_revision:
44
44
 
45
45
 
46
46
  def diff_snapshot_digest(scan: sqlite3.Row, manifest: dict[str, Any] | None) -> str | None:
47
+ """Return the content identity used for a stored diff, or None when unavailable.
48
+
49
+ Working-tree scans use their recorded content digest. Commit and range scans
50
+ reuse the sealed manifest value during recovery or derive a digest from both revisions.
51
+ """
47
52
  if scan["diff_target_kind"] == "working_tree":
48
53
  return scan["diff_content_digest"]
49
54
  if scan["diff_target_kind"] in {"commit", "range"}:
@@ -67,6 +72,7 @@ def git_output(
67
72
  work_tree: Path | None = None,
68
73
  offline: bool = False,
69
74
  ) -> str | None:
75
+ """Return decoded Git stdout with one trailing newline removed, or None on failure or empty output."""
70
76
  completed = git_command(
71
77
  target, *args, text=False, git_dir=git_dir, work_tree=work_tree, offline=offline
72
78
  )
@@ -275,6 +281,12 @@ def git_command(
275
281
  environment_overrides: dict[str, str] | None = None,
276
282
  offline: bool = False,
277
283
  ) -> subprocess.CompletedProcess[str] | subprocess.CompletedProcess[bytes]:
284
+ """Run Git against target and return the completed process with its exit status.
285
+
286
+ Pass git_dir and work_tree together to select an explicit checkout. Set
287
+ offline to disable transports and lazy fetches. The text flag selects
288
+ decoded or binary output, and stdout_file can redirect it to a file.
289
+ """
278
290
  if (git_dir is None) != (work_tree is None):
279
291
  raise ValueError("git_dir and work_tree must be provided together")
280
292
  environment = os.environ.copy()
@@ -326,7 +338,7 @@ def git_command(
326
338
  return subprocess.CompletedProcess(full_command, 127, empty_output, empty_output)
327
339
 
328
340
 
329
- def run_git_changed_paths(repo: Path, diff_args: list[str]) -> list[tuple[Path, str]]:
341
+ def run_git_changed_paths(repo: Path, diff_args: list[str]) -> list[tuple[str, str, str | None]]:
330
342
  """Return changed regular files from the selected side of each change."""
331
343
  result = git_command(
332
344
  repo,
@@ -345,25 +357,29 @@ def run_git_changed_paths(repo: Path, diff_args: list[str]) -> list[tuple[Path,
345
357
  if fields and not fields[-1]:
346
358
  fields.pop()
347
359
 
348
- changed: list[tuple[Path, str]] = []
360
+ changed: list[tuple[str, str, str | None]] = []
349
361
  index = 0
350
362
  while index < len(fields):
351
363
  metadata = fields[index].split()
352
364
  status = chr(metadata[-1][0])
353
365
  index += 1
366
+ rename_source = os.fsdecode(fields[index]) if status == "R" else None
354
367
  if status in {"C", "R"}:
355
368
  index += 1
356
- path = repo / os.fsdecode(fields[index])
369
+ path = os.fsdecode(fields[index])
357
370
  index += 1
358
371
  selected_mode = metadata[0].removeprefix(b":") if status == "D" else metadata[1]
359
372
  if selected_mode.startswith(b"100"):
360
- changed.append((path, status))
373
+ changed.append((path, status, rename_source))
361
374
  return changed
362
375
 
363
376
 
364
377
  def git_changed_paths(repo: Path, base: str, head: str, mode: str) -> list[tuple[Path, str]]:
365
378
  if mode == "revisions":
366
- return run_git_changed_paths(repo, [f"{base}..{head}"])
379
+ return [
380
+ (repo / name, status)
381
+ for name, status, _ in run_git_changed_paths(repo, [f"{base}..{head}"])
382
+ ]
367
383
  if mode == "local-patch":
368
384
  unstaged = run_git_changed_paths(repo, [base])
369
385
  staged = run_git_changed_paths(repo, ["--cached", base])
@@ -377,26 +393,37 @@ def git_changed_paths(repo: Path, base: str, head: str, mode: str) -> list[tuple
377
393
  offline=True,
378
394
  )
379
395
  untracked.check_returncode()
380
- combined = dict(staged)
381
- combined.update(unstaged)
382
- combined.update(
383
- (repo / os.fsdecode(relative), "A")
384
- for relative in untracked.stdout.split(b"\0")
385
- if relative and not relative.endswith(b"/")
386
- )
387
- selected = []
396
+ combined = {name: (status, source) for name, status, source in [*staged, *unstaged]}
397
+ selected: dict[str, str] = {}
388
398
  linked_prefixes: dict[str, bool] = {}
389
- for path, status in combined.items():
390
- if not SOURCE_METADATA_DIRECTORIES.isdisjoint(path.relative_to(repo).parts):
391
- continue
399
+
400
+ def local_status(name: str, status: str) -> str | None:
401
+ if not SOURCE_METADATA_DIRECTORIES.isdisjoint(PurePosixPath(name).parts):
402
+ return None
403
+ if status == "D":
404
+ return status
405
+ path = repo / name
392
406
  try:
393
- if status == "M" and _directory_link_boundary(repo, path, linked_prefixes) != path:
394
- selected.append((path, "D"))
395
- elif status == "D" or (not path.is_symlink() and path.is_file()):
396
- selected.append((path, status))
407
+ if (
408
+ status in {"M", "R"}
409
+ and _directory_link_boundary(repo, path, linked_prefixes) != path
410
+ ):
411
+ return "D" if status == "M" else None
412
+ return status if stat.S_ISREG(path.lstat().st_mode) else None
397
413
  except (FileNotFoundError, NotADirectoryError):
398
- continue
399
- return sorted(selected)
414
+ return None
415
+
416
+ for name, (status, source) in combined.items():
417
+ if chosen := local_status(name, status):
418
+ selected[name] = chosen
419
+ elif source is not None and local_status(source, "D"):
420
+ selected.setdefault(source, "D")
421
+ for relative in untracked.stdout.split(b"\0"):
422
+ if relative and not relative.endswith(b"/"):
423
+ name = os.fsdecode(relative)
424
+ if local_status(name, "A"):
425
+ selected[name] = "A"
426
+ return sorted((repo / name, status) for name, status in selected.items())
400
427
  raise SystemExit(f"Unknown diff mode: {mode}")
401
428
 
402
429
 
@@ -527,6 +554,19 @@ def update_digest_field(digest: Any, label: bytes, value: bytes) -> None:
527
554
  digest.update(value)
528
555
 
529
556
 
557
+ def _update_regular_file_digest(digest: Any, path: Path, prefix: bytes = b"") -> None:
558
+ """Record the file kind, byte count, and SHA-256 in the snapshot digest."""
559
+ content = hashlib.sha256()
560
+ size = 0
561
+ with path.open("rb") as handle:
562
+ for chunk in iter(lambda: handle.read(1024 * 1024), b""):
563
+ content.update(chunk)
564
+ size += len(chunk)
565
+ update_digest_field(digest, prefix + b"kind", b"file")
566
+ update_digest_field(digest, prefix + b"size", str(size).encode())
567
+ update_digest_field(digest, prefix + b"content-sha256", content.digest())
568
+
569
+
530
570
  def _visible_git_character(char: str) -> str:
531
571
  if char in "\n\t" or unicodedata.category(char) not in {"Cc", "Cf"}:
532
572
  return char
@@ -569,6 +609,7 @@ def _update_digest_field_from_git(
569
609
 
570
610
 
571
611
  def worktree_content_digest(target: Path) -> str:
612
+ """Return the worktree digest for the selected path after checking the state of its submodules."""
572
613
  require_clean_submodule_worktrees(target)
573
614
  repository, pathspec = git_worktree_context(target)
574
615
  return worktree_content_digest_for_context(repository, pathspec)
@@ -582,6 +623,7 @@ def remediation_checkout_snapshot(
582
623
  "Repository HEAD changed. Regenerate the remediation patch against the current checkout."
583
624
  ),
584
625
  ) -> tuple[str, str | None]:
626
+ """Return the current revision and content digest after verifying the recorded checkout identity and required revision."""
585
627
  target = require_scan_target_identity(scan)
586
628
  revision = git_revision(target)
587
629
  required_revision = expected_revision or scan["target_revision"]
@@ -706,26 +748,10 @@ def worktree_content_digest_for_context(
706
748
  directory_content_digest(path.resolve()).encode(),
707
749
  )
708
750
  elif stat.S_ISREG(metadata.st_mode):
709
- content_digest = hashlib.sha256()
710
- content_size = 0
711
751
  try:
712
- with path.open("rb") as handle:
713
- for chunk in iter(lambda: handle.read(1024 * 1024), b""):
714
- content_digest.update(chunk)
715
- content_size += len(chunk)
752
+ _update_regular_file_digest(digest, path, prefix=b"untracked-")
716
753
  except OSError as exc:
717
754
  raise SystemExit(f"Could not read untracked file: {relative_path}") from exc
718
- update_digest_field(digest, b"untracked-kind", b"file")
719
- update_digest_field(
720
- digest,
721
- b"untracked-size",
722
- str(content_size).encode(),
723
- )
724
- update_digest_field(
725
- digest,
726
- b"untracked-content-sha256",
727
- content_digest.digest(),
728
- )
729
755
  else:
730
756
  raise SystemExit(f"Unsupported untracked file type: {relative_path}")
731
757
  return f"codex-security-snapshot/v1:sha256:{digest.hexdigest()}"
@@ -835,6 +861,54 @@ def _directory_link_boundary(target: Path, path: Path, linked_prefixes: dict[str
835
861
  return path
836
862
 
837
863
 
864
+ def _windows_inventory_query(
865
+ target: Path,
866
+ *args: str,
867
+ git_dir: Path,
868
+ work_tree: Path,
869
+ input_data: bytes | None = None,
870
+ environment_overrides: dict[str, str] | None = None,
871
+ ) -> subprocess.CompletedProcess[bytes]:
872
+ """Retry a root inventory's metadata length error with its verified literal marker."""
873
+
874
+ def query(
875
+ directory: Path, environment: dict[str, str] | None
876
+ ) -> subprocess.CompletedProcess[bytes]:
877
+ return cast(
878
+ subprocess.CompletedProcess[bytes],
879
+ git_command(
880
+ target,
881
+ *args,
882
+ text=False,
883
+ git_dir=directory,
884
+ work_tree=work_tree,
885
+ input_data=input_data,
886
+ environment_overrides=environment,
887
+ ),
888
+ )
889
+
890
+ result = query(git_dir, environment_overrides)
891
+ if (
892
+ result.returncode != 128
893
+ or result.stdout
894
+ or str(target) != str(work_tree)
895
+ or b"GIT_DIR" not in result.stderr
896
+ ):
897
+ return result
898
+ diagnostic = b"fatal: '$GIT_DIR' too big"
899
+ if diagnostic not in result.stderr.splitlines():
900
+ # Confirm translated diagnostics without changing the actual inventory's environment.
901
+ probe = query(git_dir, {**(environment_overrides or {}), "LC_ALL": "C", "LANGUAGE": "C"})
902
+ if probe.returncode != 128 or probe.stdout or diagnostic not in probe.stderr.splitlines():
903
+ return result
904
+ with pinned_root_git_marker(target, git_dir) as marker:
905
+ if marker is not None:
906
+ retry = query(marker, environment_overrides)
907
+ if retry.returncode == 0 or (retry.returncode == 1 and "check-ignore" in args):
908
+ return retry
909
+ return result
910
+
911
+
838
912
  def git_directory_snapshot_paths(target: Path) -> list[Path] | None:
839
913
  repository_root = git_output(target, "rev-parse", "--show-toplevel")
840
914
  if repository_root is None:
@@ -928,7 +1002,7 @@ def git_directory_snapshot_paths(target: Path) -> list[Path] | None:
928
1002
  git_directory = git_output(target, "rev-parse", "--absolute-git-dir")
929
1003
  if git_directory is None:
930
1004
  raise SystemExit("Could not inspect the selected Git working tree.")
931
- directories = git_bytes(
1005
+ directories = _windows_inventory_query(
932
1006
  target,
933
1007
  "--no-literal-pathspecs",
934
1008
  "ls-files",
@@ -942,9 +1016,9 @@ def git_directory_snapshot_paths(target: Path) -> list[Path] | None:
942
1016
  git_dir=Path(git_directory),
943
1017
  work_tree=repository,
944
1018
  )
945
- if directories is None:
1019
+ if directories.returncode != 0:
946
1020
  raise SystemExit("Could not inspect directories in the selected Git working tree.")
947
- pending = [target / os.fsdecode(path) for path in directories.split(b"\0") if path]
1021
+ pending = [target / os.fsdecode(path) for path in directories.stdout.split(b"\0") if path]
948
1022
  while pending:
949
1023
  children: list[Path] = []
950
1024
  for path in pending:
@@ -983,13 +1057,12 @@ def git_directory_snapshot_paths(target: Path) -> list[Path] | None:
983
1057
  if not candidates:
984
1058
  break
985
1059
  # Filter a directory level at once, retaining the outer repository context.
986
- ignored = git_command(
1060
+ ignored = _windows_inventory_query(
987
1061
  repository,
988
1062
  "--no-literal-pathspecs",
989
1063
  "check-ignore",
990
1064
  "-z",
991
1065
  "--stdin",
992
- text=False,
993
1066
  input_data=b"\0".join(candidates) + b"\0",
994
1067
  git_dir=Path(git_directory),
995
1068
  work_tree=repository,
@@ -1084,18 +1157,10 @@ def directory_content_digest(
1084
1157
  elif stat.S_ISDIR(mode):
1085
1158
  update_digest_field(digest, b"kind", b"directory")
1086
1159
  elif stat.S_ISREG(mode):
1087
- content_digest = hashlib.sha256()
1088
- content_size = 0
1089
1160
  try:
1090
- with path.open("rb") as handle:
1091
- for chunk in iter(lambda: handle.read(1024 * 1024), b""):
1092
- content_digest.update(chunk)
1093
- content_size += len(chunk)
1161
+ _update_regular_file_digest(digest, path)
1094
1162
  except OSError as exc:
1095
1163
  raise UnreadableLocalFile(f"Could not read local file: {relative_path}") from exc
1096
- update_digest_field(digest, b"kind", b"file")
1097
- update_digest_field(digest, b"size", str(content_size).encode())
1098
- update_digest_field(digest, b"content-sha256", content_digest.digest())
1099
1164
  else:
1100
1165
  raise UnsupportedLocalFileType(f"Unsupported local file type: {relative_path}")
1101
1166
  return f"codex-security-snapshot/v1:sha256:{digest.hexdigest()}"
@@ -1213,7 +1278,12 @@ def copy_git_worktree_files(
1213
1278
  destination_path = destination / relative
1214
1279
  destination_path.parent.mkdir(parents=True, exist_ok=True)
1215
1280
  if stat.S_ISLNK(metadata.st_mode):
1216
- destination_path.symlink_to(os.readlink(source_path))
1281
+ directory_link = bool(
1282
+ getattr(metadata, "st_file_attributes", 0) & stat.FILE_ATTRIBUTE_DIRECTORY
1283
+ )
1284
+ destination_path.symlink_to(
1285
+ os.readlink(source_path), target_is_directory=directory_link
1286
+ )
1217
1287
  elif stat.S_ISREG(metadata.st_mode):
1218
1288
  shutil.copy2(source_path, destination_path, follow_symlinks=False)
1219
1289
  elif stat.S_ISDIR(metadata.st_mode):
@@ -1311,6 +1381,7 @@ def require_remediation_target(value: str) -> Path:
1311
1381
 
1312
1382
 
1313
1383
  def require_scan_target_identity(scan: sqlite3.Row) -> Path:
1384
+ """Return the recorded checkout path or raise SystemExit if it no longer identifies the original directory."""
1314
1385
  target = require_remediation_target(scan["target_path"])
1315
1386
  expected_inode = scan["target_inode"]
1316
1387
  if expected_inode is None:
@@ -10,11 +10,13 @@ from pathlib import Path
10
10
 
11
11
 
12
12
  def stable_target_id(target: Path) -> str:
13
+ """Hash the supplied path spelling into the workbench ID for a local workspace."""
13
14
  digest = hashlib.sha256(f"local-workspace\0{target}".encode()).hexdigest()
14
15
  return f"target_sha256_{digest}"
15
16
 
16
17
 
17
18
  def backfill_security_targets(connection: sqlite3.Connection) -> None:
19
+ """Fill missing target IDs on scans and workspaces in the caller’s transaction."""
18
20
  rows = connection.execute(
19
21
  """
20
22
  SELECT target_path FROM workspaces WHERE target_path IS NOT NULL
@@ -36,6 +38,7 @@ def backfill_security_targets(connection: sqlite3.Connection) -> None:
36
38
 
37
39
 
38
40
  def ensure_security_target(connection: sqlite3.Connection, target_path: str) -> str:
41
+ """Return the ID already associated with the path or insert a deterministic ID for it."""
39
42
  existing = connection.execute(
40
43
  "SELECT id FROM security_targets WHERE current_path = ?",
41
44
  (target_path,),
@@ -26,6 +26,20 @@ from workbench_scan_usage import _timestamp as usage_timestamp
26
26
  reject_non_finite_json = finalizer._reject_non_finite_json
27
27
 
28
28
 
29
+ def read_json_object(path: Path) -> dict[str, Any]:
30
+ """Read a UTF-8 JSON object from path, raising SystemExit on read errors, malformed JSON, or another top-level type."""
31
+ try:
32
+ payload = json.loads(
33
+ path.read_text(encoding="utf-8"),
34
+ parse_constant=reject_non_finite_json,
35
+ )
36
+ except (OSError, ValueError) as exc:
37
+ raise SystemExit(f"{path.name}: invalid JSON: {exc}") from exc
38
+ if not isinstance(payload, dict):
39
+ raise SystemExit(f"{path.name}: expected a JSON object.")
40
+ return payload
41
+
42
+
29
43
  def javascript_utf8(value: str) -> bytes:
30
44
  """Match Node's UTF-8 encoding of UTF-16 strings without changing stored text."""
31
45
  return (
@@ -40,6 +54,7 @@ def timestamp_key(value: str) -> datetime:
40
54
 
41
55
 
42
56
  def require_uuid(value: str, label: str) -> str:
57
+ """Return the standard hyphenated UUID text or raise SystemExit using label to identify the invalid argument."""
43
58
  try:
44
59
  return str(uuid.UUID(value))
45
60
  except ValueError as exc:
@@ -54,6 +69,7 @@ path_within_scope = finalizer.path_within_scope
54
69
 
55
70
 
56
71
  def require_close_note(close_reason: str | None, note: str | None) -> None:
72
+ """Require a note when closing a finding as a false positive or when declining a fix."""
57
73
  if note is None and close_reason == "false_positive":
58
74
  raise SystemExit("Explain why this finding is a false positive.")
59
75
  if note is None and close_reason == "wont_fix":
@@ -92,7 +108,7 @@ def _valid_measured_scan_usage(usage: object) -> bool:
92
108
  thread_count = usage.get("threadCount")
93
109
  if (
94
110
  coverage not in ("complete", "partial", "unavailable")
95
- or usage.get("source") != "codex_rollout"
111
+ or usage.get("source") not in ("codex_rollout", "codex_runtime")
96
112
  or type(thread_count) is not int
97
113
  or thread_count < 0
98
114
  ):
@@ -134,6 +150,7 @@ def _valid_measured_scan_usage(usage: object) -> bool:
134
150
 
135
151
  allowed_keys = {
136
152
  "coverage",
153
+ "coverageScope",
137
154
  "source",
138
155
  "threadCount",
139
156
  "missingThreadCount",
@@ -144,19 +161,32 @@ def _valid_measured_scan_usage(usage: object) -> bool:
144
161
  "observedAt",
145
162
  "tokensUpdatedAt",
146
163
  "accountRateLimits",
164
+ "cacheWriteInputTokensReported",
147
165
  *SCAN_USAGE_TOKEN_KEYS,
148
166
  }
149
167
  if thread_count == 0 or not set(usage).issubset(allowed_keys):
150
168
  return False
169
+ if "coverageScope" in usage:
170
+ scope = usage["coverageScope"]
171
+ if (
172
+ not isinstance(scope, list)
173
+ or any(not isinstance(identity, str) or not identity for identity in scope)
174
+ or len(set(scope)) != len(scope)
175
+ ):
176
+ return False
151
177
  if (
152
178
  not all(type(usage.get(key)) is int and usage[key] >= 0 for key in SCAN_USAGE_TOKEN_KEYS)
153
179
  or usage["cachedInputTokens"] + usage["cacheWriteInputTokens"] > usage["inputTokens"]
180
+ or "cacheWriteInputTokensReported" in usage
181
+ and type(usage["cacheWriteInputTokensReported"]) is not bool
154
182
  ):
155
183
  return False
156
184
  missing = usage.get("missingThreadCount", 0)
157
185
  if type(missing) is not int or missing < 0:
158
186
  return False
159
- if coverage == "complete" and (warnings or missing):
187
+ if coverage == "complete" and (
188
+ any(warning != "cost_estimate_covers_earlier_usage" for warning in warnings) or missing
189
+ ):
160
190
  return False
161
191
  if coverage == "partial" and not (warnings or missing):
162
192
  return False
@@ -177,8 +207,11 @@ def _valid_measured_scan_usage(usage: object) -> bool:
177
207
  return False
178
208
  if any(
179
209
  not isinstance(role, dict)
180
- or set(role) != keys
210
+ or not keys.issubset(role)
211
+ or not set(role).issubset({*keys, "cacheWriteInputTokensReported"})
181
212
  or any(type(role[key]) is not int or role[key] < 0 for key in keys)
213
+ or "cacheWriteInputTokensReported" in role
214
+ and type(role["cacheWriteInputTokensReported"]) is not bool
182
215
  for role in roles.values()
183
216
  ):
184
217
  return False
@@ -188,6 +221,11 @@ def _valid_measured_scan_usage(usage: object) -> bool:
188
221
 
189
222
 
190
223
  def parse_scan_cost(value: str | None) -> str | None:
224
+ """Return compact JSON for valid measured usage or a legacy cost estimate.
225
+
226
+ None means cost data was omitted. Invalid JSON, nonfinite numbers, or an
227
+ unsupported cost record raise SystemExit.
228
+ """
191
229
  if value is None:
192
230
  return None
193
231
  try:
@@ -210,11 +248,13 @@ def parse_scan_cost(value: str | None) -> str | None:
210
248
 
211
249
 
212
250
  def bounded_output_text(value: Any, maximum_bytes: int) -> str:
251
+ """Return the prefix of the stringified value that fits in maximum_bytes of UTF-8 without splitting a character."""
213
252
  encoded = str(value).encode("utf-8")[:maximum_bytes]
214
253
  return encoded.decode("utf-8", errors="ignore")
215
254
 
216
255
 
217
256
  def require_occurrence(connection: sqlite3.Connection, occurrence_id: str) -> sqlite3.Row:
257
+ """Return the finding occurrence row or raise SystemExit if its ID is missing or unknown."""
218
258
  occurrence_id = optional_text(occurrence_id, maximum=256)
219
259
  if occurrence_id is None:
220
260
  raise SystemExit("occurrence-id is required.")
@@ -1,28 +1,24 @@
1
1
  [
2
2
  [
3
- "WITH input AS (SELECT :history AS history)",
4
- "SELECT 'sql' AS operation,",
5
- " 'UPDATE schema_migrations SET version = 60 WHERE version = ' || version AS value",
6
- "FROM schema_migrations",
7
- "WHERE version IN (58, 59) AND name = 'record classification rubric provenance';"
8
- ],
9
- [
10
- "-- Move checkpoint previews before source-scope history checks.",
11
- "WITH input AS (SELECT :history AS history)",
12
- "SELECT 'sql' AS operation,",
13
- " 'UPDATE schema_migrations SET version = 57 WHERE version = ' || version AS value",
14
- "FROM schema_migrations",
15
- "WHERE version IN (47, 48, 50, 52, 53, 54)",
16
- " AND name = 'freeze stopped scan checkpoint selections';"
17
- ],
18
- [
19
- "-- Move source-scope previews before the shared history repairs.",
20
- "WITH input AS (SELECT :history AS history)",
21
- "SELECT 'sql' AS operation,",
22
- " 'UPDATE schema_migrations SET version = 50 WHERE version = ' || version AS value",
23
- "FROM schema_migrations",
24
- "WHERE version IN (34, 40, 41, 42, 43, 44, 48)",
25
- " AND name = 'persist authorized source excerpt scopes';"
3
+ "WITH input AS (SELECT :history AS history),",
4
+ "previews AS (",
5
+ " SELECT version, CASE",
6
+ " WHEN version IN (48, 50, 63) AND name = 'persist scan log completion boundaries'",
7
+ " THEN 'UPDATE schema_migrations SET version = 64'",
8
+ " WHEN version IN (58, 59) AND name = 'record classification rubric provenance'",
9
+ " THEN 'UPDATE schema_migrations SET version = 60'",
10
+ " WHEN version IN (47, 48, 50, 52, 53, 54) AND name = 'freeze stopped scan checkpoint selections'",
11
+ " THEN 'UPDATE schema_migrations SET version = 57'",
12
+ " WHEN version IN (34, 40, 41, 42, 43, 44, 48) AND name = 'persist authorized source excerpt scopes'",
13
+ " THEN 'UPDATE schema_migrations SET version = 50'",
14
+ " WHEN version = 63 AND name = 'retain native investigation time allowances'",
15
+ " THEN 'DELETE FROM schema_migrations'",
16
+ " END AS repair FROM schema_migrations",
17
+ ")",
18
+ "SELECT 'sql' AS operation, repair || ' WHERE version = ' || version AS value",
19
+ "FROM previews WHERE repair IS NOT NULL",
20
+ "-- Vacate checkpoint preview 50 before moving a lower source-scope receipt into it.",
21
+ "ORDER BY version DESC;"
26
22
  ],
27
23
  [
28
24
  "WITH history AS (",
@@ -488,5 +488,39 @@
488
488
  "statements": [
489
489
  "ALTER TABLE scan_severity_classifications ADD COLUMN rubric_binding_json TEXT;"
490
490
  ]
491
+ },
492
+ {
493
+ "version": 61,
494
+ "name": "record scan launch attribution",
495
+ "statements": [
496
+ "ALTER TABLE scans ADD COLUMN launch_surface TEXT;",
497
+ "ALTER TABLE scans ADD COLUMN launch_package_version TEXT;",
498
+ "ALTER TABLE scans ADD COLUMN launch_plugin_version TEXT;",
499
+ "ALTER TABLE scans ADD COLUMN launch_kind TEXT CHECK (launch_kind IN ('scan', 'mock', 'import'));"
500
+ ]
501
+ },
502
+ {
503
+ "version": 62,
504
+ "name": "project scan lifecycle snapshots",
505
+ "statements": [
506
+ "CREATE TRIGGER classify_legacy_scan_recipe\nAFTER UPDATE OF recipe_json ON scans\nWHEN OLD.recipe_json IS NULL AND (NEW.launch_kind IS NULL OR NEW.launch_plugin_version IS NULL)\n AND json_valid(NEW.recipe_json)\nBEGIN\n UPDATE scans SET\n launch_kind = COALESCE(launch_kind, CASE\n WHEN json_type(recipe_json, '$.import') = 'object' THEN 'import'\n WHEN json_type(recipe_json, '$.mock') = 'true' THEN 'mock' END),\n launch_plugin_version = COALESCE(launch_plugin_version, CASE\n WHEN json_type(recipe_json, '$.pluginVersion') = 'text'\n AND trim(json_extract(recipe_json, '$.pluginVersion'), char(9, 10, 11, 12, 13, 32)) <> ''\n THEN json_extract(recipe_json, '$.pluginVersion') END)\n WHERE id = NEW.id;\nEND;",
507
+ "UPDATE scans\nSET launch_kind = CASE WHEN json_type(recipe_json, '$.import') = 'object' THEN 'import' ELSE 'mock' END\nWHERE launch_kind IS NULL AND CASE WHEN json_valid(recipe_json) THEN\n json_type(recipe_json, '$.import') = 'object' OR json_type(recipe_json, '$.mock') = 'true'\nEND;",
508
+ "UPDATE scans SET launch_plugin_version = json_extract(recipe_json, '$.pluginVersion')\nWHERE launch_plugin_version IS NULL AND CASE WHEN json_valid(recipe_json) THEN\n json_type(recipe_json, '$.pluginVersion') = 'text'\n AND trim(json_extract(recipe_json, '$.pluginVersion'), char(9, 10, 11, 12, 13, 32)) <> ''\nEND;",
509
+ "CREATE VIEW scan_lifecycles AS\nSELECT scans.id AS scan_id, json_object(\n 'scanId', scans.id,\n 'mode', CASE WHEN launch_kind = 'import' THEN 'import' ELSE scans.mode END,\n 'startedAt', scans.started_at,\n 'status', CASE WHEN canceled_at IS NOT NULL THEN 'canceled'\n WHEN scans.status = 'complete' THEN 'completed' ELSE scans.status END,\n 'finishedAt', COALESCE(canceled_at, completed_at),\n 'hasReportableFindings', json(CASE\n WHEN scans.status = 'complete' AND canceled_at IS NULL\n THEN (SELECT CASE WHEN reportable_findings_count > 0 THEN 'true' ELSE 'false' END\n FROM scan_progress WHERE scan_id = scans.id) END),\n 'surface', launch_surface,\n 'packageVersion', launch_package_version,\n 'pluginVersion', launch_plugin_version,\n 'mock', json(CASE WHEN launch_kind = 'mock' THEN 'true'\n WHEN launch_kind IS NOT NULL THEN 'false' END)\n) AS snapshot\nFROM scans;"
510
+ ]
511
+ },
512
+ {
513
+ "version": 63,
514
+ "name": "retain unverified Deep Scan worker attempts",
515
+ "statements": [
516
+ "ALTER TABLE deep_scan_runs ADD COLUMN worker_usage_gap INTEGER NOT NULL DEFAULT 0 CHECK (worker_usage_gap IN (0, 1));",
517
+ "UPDATE deep_scan_runs SET worker_usage_gap = 1\nWHERE scan_id IN (\n SELECT w.scan_id FROM deep_scan_workers AS w\n WHERE w.kind IN ('discovery', 'dedup') AND w.attempt > 1\n AND w.started_at IS NOT NULL AND w.sdk_thread_id IS NULL\n AND NOT EXISTS (SELECT 1 FROM deep_scan_worker_threads AS t\n WHERE t.scan_id = w.scan_id AND t.worker_id = w.id)\n);",
518
+ "CREATE TRIGGER retain_unverified_deep_scan_worker_attempt\nAFTER UPDATE OF attempt ON deep_scan_workers\nWHEN NEW.attempt > OLD.attempt AND OLD.started_at IS NOT NULL\n AND OLD.sdk_thread_id IS NULL AND OLD.kind IN ('discovery', 'dedup')\nBEGIN\n UPDATE deep_scan_runs SET worker_usage_gap = 1 WHERE scan_id = OLD.scan_id;\nEND;"
519
+ ]
520
+ },
521
+ {
522
+ "version": 64,
523
+ "name": "persist scan log completion boundaries",
524
+ "statements": ["ALTER TABLE scans ADD COLUMN log_completed_at TEXT;"]
491
525
  }
492
526
  ]
@@ -20,11 +20,11 @@ Call `defense_factory_bootstrap` before data reads. Reuse its result within the
20
20
 
21
21
  Use `defense_factory_github_search`, `defense_factory_github_repositories`, or `defense_factory_github_get` to resolve repositories on the connectors returned by bootstrap. Preserve returned repository and connector IDs, including GitHub Enterprise identities. `defense_factory_workflow_repositories` can locate repositories with recorded runs. A local checkout name alone does not identify a Cloud repository. Ask the user to choose when account or repository context is ambiguous; in noninteractive use, stop with the ambiguity and required selection. An explicit request for all accessible repositories may use that broader scope.
22
22
 
23
- For a finding link, accept the selected Cloud `webOrigin` with the path `/codex/cloud/security/findings/<finding-id>` or the legacy `/codex/security/findings/<finding-id>`. Decode the final path segment once and resolve it through `defense_factory_findings_get`. Preserve combined finding IDs (`commit:…`, `rf_…`, or `pro_…`) returned by Cloud. A commit-finding link under either accepted path may use a bare finding ID; pass that as `commit:<finding-id>`. Do not substitute a grouped issue, scan, or PR ID. For an unsupported origin or path, explain which finding link or ID is needed instead of guessing another record. Use returned Cloud links when available. Every direct detail or evidence read must go through its tool, even for an ID that was previously listed.
23
+ For a finding link, accept the selected Cloud `webOrigin` with the path `/codex/cloud/security/findings/<finding-id>` or the legacy `/codex/security/findings/<finding-id>`. Decode the final path segment once and resolve it through `defense_factory_findings_get`. Pass complete finding IDs returned by Cloud unchanged, including any source prefix. A commit-finding link under either accepted path may use a bare finding ID; pass that as `commit:<finding-id>`. Do not substitute a grouped issue, scan, or PR ID. For an unsupported origin or path, explain which finding link or ID is needed instead of guessing another record. Use returned Cloud links when available. Every direct detail or evidence read must go through its tool, even for an ID that was previously listed.
24
24
 
25
25
  ## List and inspect findings
26
26
 
27
- When the findings list or detail tool offers `api_version`, select `v2` for requests that include imported scanner findings. The default `v1` view covers native findings. For an imported-only list, also set `source` to `imported` if exposed. Use only provider values advertised by the selected tool. If you filter returned evidence locally, follow every page in the requested scope and say how you filtered it.
27
+ When the findings list or detail tool offers `api_version`, select `v2` for requests that include imported scanner findings. The default `v1` view covers native findings. For an imported-only list, also set `source` to `imported` if exposed. Use `provider` to filter scanner occurrences. To list grouped issues with published evidence from a scanner, use `defense_factory_canonical_findings_list` with `published_evidence_provider`. Scope grouped issues to a repository with its stable ID in `repo_id`. Use the provider values advertised by each tool. If the scanner has no filter value, list imported findings within the requested repository and inspect the returned provider and scanner origin where available. For example, OpenGrep uses the Semgrep provider and identifies itself in `details.scanner_origin`. Follow every page for a complete answer. If the evidence available to the caller cannot identify the scanner, report that limit.
28
28
 
29
29
  Use `defense_factory_findings_list` with the discovered repository URL in `repo` and the user's filters; `repo` accepts comma-separated URLs, not repository IDs. Workflow tools use the returned repository ID in `repo_id`. Filters may include severity (`criticality`), lifecycle `status`, `source`, `q`, `path_prefix`, `start_at`, `end_at`, `scan_id`, `review_run_id`, `validated`, `has_patch`, `author`, and `assignee`; use the tool's current schema for available filters and their accepted values. `assignee` accepts comma-separated recorded user emails and is separate from commit authorship. Do not invent an assigned-team filter.
30
30
 
@@ -39,7 +39,7 @@ Keep these records separate in the answer:
39
39
  - **Periodic fix check:** its recorded time, commit, result, and report.
40
40
  - **Lifecycle status:** the finding's recorded state; it does not prove that a patch was checked or that a periodic fix check passed.
41
41
 
42
- Repository-scan and PR-review findings may not supply the same fields as commit findings. Preserve their source evidence and report absent or unknown values as unavailable or unknown, rather than success, failure, or unassigned.
42
+ The fields available for repository-scan, PR-review, and imported findings can differ from those for commit findings. Preserve their source evidence and report absent or unknown values as unavailable or unknown, rather than success, failure, or unassigned.
43
43
 
44
44
  ## Read evidence
45
45
 
@@ -51,6 +51,6 @@ An artifact reference or download link alone is not report content. Unsupported
51
51
 
52
52
  ## Read scan status
53
53
 
54
- Use `defense_factory_scan_history` for combined commit and repository scan history. It accepts only `limit` (1–100), `cursor`, and `scan_type` (`commit_scan` or `repository_scan`). Follow its pages to locate commit scans; do not claim it has repository, status, or date filters. For repository runs, use `defense_factory_workflow_list` with its `repo_id` and `status` filters, then `defense_factory_workflow_get` for progress and failure details. When history provides a monitoring configuration ID and scan ID, use `defense_factory_monitoring_scan_get` with that configuration as `parameters.path.id` and the scan as `parameters.path.scan_id`.
54
+ Use `defense_factory_scan_history` for combined commit and repository scan history. Use `repo_ids` for repository-scoped history. To include the caller’s private imports in combined history, set `include_private_imports: true` and omit `repo_ids` and `scan_type`. For private imports alone, set `scan_type: private_import` and omit `repo_ids`. Follow the returned cursor for more history. For repository runs, use `defense_factory_workflow_list` with its `repo_id` and `status` filters, then `defense_factory_workflow_get` for progress and failure details. When history provides a monitoring configuration ID and scan ID, use `defense_factory_monitoring_scan_get` with that configuration as `parameters.path.id` and the scan as `parameters.path.scan_id`.
55
55
 
56
- Commit scans record status, timestamps, and success but may have no detailed failure message or progress stage. Say when those details are unavailable. A failed, canceled, or unfinished scan with zero findings is not a clean scan. Include the source, relevant IDs, scope read, and recorded status in the answer.
56
+ For the current processing phase, request `view: progress` on the workflow or monitoring scan detail tool. Commit scans record status, timestamps, and success. Report when detailed failure information is unavailable. A failed, canceled, or unfinished scan with zero findings is not a clean scan. Include the source, relevant IDs, scope read, and recorded status in the answer.