@openai/codex-security 0.8.2 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -7,12 +7,12 @@ import json
7
7
  import re
8
8
  import sys
9
9
  from bisect import bisect_right
10
- from itertools import chain, islice
10
+ from itertools import islice
11
11
  from pathlib import Path
12
12
  from typing import Any
13
13
 
14
14
  sys.path.insert(0, str(Path(__file__).resolve().parent))
15
- from report_projection import merged_root_cause
15
+ from report_projection import code_evidence_rows, merged_root_cause
16
16
  from workbench_constants import (
17
17
  FINDING_ATTACK_PATH_PREVIEW_BYTES,
18
18
  FINDING_CODE_EVIDENCE_LIMIT,
@@ -27,6 +27,11 @@ from workbench_constants import (
27
27
 
28
28
 
29
29
  def bounded_finding_details(value: Any) -> dict[str, Any]:
30
+ """Build the workbench preview of a stored finding, returning an empty dict for non-object input.
31
+
32
+ Budget for writeup text, diagnostics, and guidance alongside code evidence so a
33
+ large snippet cannot consume the whole preview.
34
+ """
30
35
  if not isinstance(value, dict):
31
36
  return {}
32
37
  prepared: dict[str, Any] = {}
@@ -35,14 +40,12 @@ def bounded_finding_details(value: Any) -> dict[str, Any]:
35
40
  ("rootCause", "root_cause"),
36
41
  FINDING_ROOT_CAUSE_PREVIEW_BYTES,
37
42
  (
38
- "summary",
39
43
  "description",
40
44
  "detail",
41
45
  "cause",
42
46
  "rationale",
43
47
  "why",
44
48
  "explanation",
45
- "evidenceRefs",
46
49
  "evidence_refs",
47
50
  ),
48
51
  (
@@ -54,21 +57,13 @@ def bounded_finding_details(value: Any) -> dict[str, Any]:
54
57
  ("validation",),
55
58
  FINDING_VALIDATION_PREVIEW_BYTES,
56
59
  (
57
- "summary",
58
60
  "conclusion",
59
- "method",
60
- "status",
61
61
  "disposition",
62
62
  "result",
63
63
  "rationale",
64
64
  "evidenceRef",
65
65
  "evidence_ref",
66
- "evidenceRefs",
67
66
  "evidence_refs",
68
- "assertions",
69
- "evidence",
70
- "counterEvidence",
71
- "limitations",
72
67
  ),
73
68
  (
74
69
  (("summary", "conclusion", "rationale", "detail", "disposition"), 800),
@@ -85,23 +80,14 @@ def bounded_finding_details(value: Any) -> dict[str, Any]:
85
80
  ("attackPath",),
86
81
  FINDING_ATTACK_PATH_PREVIEW_BYTES,
87
82
  (
88
- "narrative",
89
83
  "summary",
90
84
  "description",
91
- "dataFlow",
92
85
  "data_flow",
93
86
  "dataflow",
94
87
  "path",
95
- "reachability",
96
- "steps",
97
- "authScope",
98
88
  "auth_scope",
99
- "vector",
100
- "preconditions",
101
- "assumptions",
102
89
  "impact",
103
90
  "likelihood",
104
- "evidenceRefs",
105
91
  "evidence_refs",
106
92
  ),
107
93
  (
@@ -270,6 +256,7 @@ def bounded_finding_section(
270
256
  priority_keys: tuple[str, ...],
271
257
  reserved_fields: tuple[tuple[tuple[str, ...], int], ...],
272
258
  ) -> Any:
259
+ """Apply each field group’s size cap before selecting fields in priority order under the section cap."""
273
260
  if not isinstance(value, dict):
274
261
  return bounded_json_value(value, [maximum_bytes])
275
262
  ordered: dict[str, Any] = {}
@@ -277,6 +264,7 @@ def bounded_finding_section(
277
264
  key = next((alias for alias in aliases if alias in value), None)
278
265
  if key is not None:
279
266
  ordered[key] = bounded_json_value(value[key], [field_bytes])
267
+ # Reserved fields already come first. Order the remaining aliases and fields next.
280
268
  for key in (*priority_keys, *value):
281
269
  if key in value and key not in ordered:
282
270
  ordered[key] = value[key]
@@ -288,6 +276,12 @@ def bounded_finding_section(
288
276
 
289
277
 
290
278
  def merged_bounded_code_evidence(value: dict[str, Any]) -> tuple[str | None, Any]:
279
+ """Return the preferred evidence key and the preview data to store under it.
280
+
281
+ Merge camelCase and snake_case catalogs by evidence ID, keeping the first
282
+ eligible snippet per ID. Return (None, None) if both keys are absent.
283
+ If neither value is a list, preserve the first supplied value.
284
+ """
291
285
  evidence_keys = [key for key in ("codeEvidence", "code_evidence") if key in value]
292
286
  if not evidence_keys:
293
287
  return None, None
@@ -295,14 +289,8 @@ def merged_bounded_code_evidence(value: dict[str, Any]) -> tuple[str | None, Any
295
289
  if not catalogs:
296
290
  return evidence_keys[0], value[evidence_keys[0]]
297
291
  bounded = {}
298
- for item in chain.from_iterable(catalogs):
299
- if not (
300
- isinstance(item, dict)
301
- and isinstance(item.get("id"), str)
302
- and bool(item["id"].strip())
303
- and isinstance(item.get("code"), str)
304
- and bool(item["code"].strip())
305
- ):
292
+ for item in code_evidence_rows(*catalogs):
293
+ if not isinstance(item.get("id"), str) or not item["id"].strip():
306
294
  continue
307
295
  if item["id"] in bounded:
308
296
  continue
@@ -339,6 +327,7 @@ def merged_bounded_code_evidence(value: dict[str, Any]) -> tuple[str | None, Any
339
327
 
340
328
 
341
329
  def json_size(value: Any) -> int:
330
+ """Return the byte count of the compact, ASCII-escaped JSON representation."""
342
331
  # ASCII output gives byte length; strings can use the cached default encoder.
343
332
  return len(json.dumps(value, separators=None if isinstance(value, str) else (",", ":")))
344
333
 
@@ -350,6 +339,7 @@ def bounded_json_value(
350
339
  depth: int = 0,
351
340
  max_depth: int = 4,
352
341
  ) -> Any:
342
+ """Build a depth-limited preview while charging its JSON representation to the shared byte budget."""
353
343
  if budget[0] <= 0:
354
344
  return None
355
345
  if depth >= max_depth:
@@ -439,6 +429,7 @@ def bounded_json_value(
439
429
 
440
430
 
441
431
  def consume_json_budget(budget: list[int], size: int) -> bool:
432
+ """Deduct the requested size and return whether it fit, exhausting the budget on failure."""
442
433
  if budget[0] < size:
443
434
  budget[0] = 0
444
435
  return False
@@ -447,6 +438,11 @@ def consume_json_budget(budget: list[int], size: int) -> bool:
447
438
 
448
439
 
449
440
  def bounded_json_text(value: str, maximum_bytes: int) -> tuple[str, int]:
441
+ """Return a string prefix and its ASCII-escaped JSON size in bytes.
442
+
443
+ Count the surrounding quotes and escape sequences toward maximum_bytes.
444
+ If even the empty string exceeds the budget, return the empty string and 2.
445
+ """
450
446
  length = bisect_right(
451
447
  range(min(len(value), maximum_bytes) + 1), maximum_bytes, key=lambda n: json_size(value[:n])
452
448
  )
@@ -1,4 +1,5 @@
1
1
  #!/bin/sh
2
+ # Use LF line endings so POSIX can execute this script directly from Windows-built packages.
2
3
  set -eu
3
4
 
4
5
  PATH="${PATH:-/usr/bin:/bin}:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
@@ -0,0 +1,148 @@
1
+ """Normalize legacy finding details for scan contract validation."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import copy
6
+ from typing import Any
7
+
8
+ import report_projection
9
+
10
+
11
+ def _filter_unknown_legacy_evidence_refs(section: dict[str, Any], evidence_ids: set[str]) -> None:
12
+ for refs_field in ("evidenceRefs", "evidence_refs"):
13
+ refs = section.get(refs_field)
14
+ if isinstance(refs, list):
15
+ section[refs_field] = [
16
+ ref for ref in refs if isinstance(ref, str) and ref.strip() and ref in evidence_ids
17
+ ]
18
+
19
+
20
+ def _normalize_legacy_string_list_fields(section: dict[str, Any], fields: tuple[str, ...]) -> None:
21
+ for field in fields:
22
+ if field not in section:
23
+ continue
24
+ value = section[field]
25
+ if isinstance(value, str):
26
+ normalized = [value] if value.strip() else []
27
+ elif isinstance(value, list):
28
+ normalized = [item for item in value if isinstance(item, str) and item.strip()]
29
+ else:
30
+ normalized = []
31
+ if normalized:
32
+ section[field] = normalized
33
+ else:
34
+ section.pop(field)
35
+
36
+
37
+ def _remove_unsupported_legacy_scalar_fields(
38
+ section: dict[str, Any], fields: tuple[str, ...]
39
+ ) -> None:
40
+ for field in fields:
41
+ if field in section and (not isinstance(section[field], str) or section[field] == ""):
42
+ section.pop(field)
43
+
44
+
45
+ def _legacy_sealed_findings_for_validation(findings: dict[str, Any]) -> dict[str, Any]:
46
+ compatible = copy.deepcopy(findings)
47
+ finding_items = compatible.get("findings")
48
+ if not isinstance(finding_items, list):
49
+ return compatible
50
+ for finding in finding_items:
51
+ if not isinstance(finding, dict):
52
+ continue
53
+ canonical_evidence = finding.get("codeEvidence")
54
+ canonical_evidence = canonical_evidence if isinstance(canonical_evidence, list) else []
55
+ evidence_ids = {
56
+ evidence["id"]
57
+ for evidence in canonical_evidence
58
+ if isinstance(evidence, dict) and isinstance(evidence.get("id"), str) and evidence["id"]
59
+ }
60
+ legacy_evidence = finding.get("code_evidence")
61
+ if isinstance(legacy_evidence, list):
62
+ compatible_legacy_evidence = []
63
+ for evidence in report_projection.code_evidence_rows(legacy_evidence):
64
+ evidence_id = evidence.get("id")
65
+ if not isinstance(evidence_id, str) or not evidence_id.strip():
66
+ continue
67
+ if evidence_id in evidence_ids:
68
+ continue
69
+ evidence_ids.add(evidence_id)
70
+ compatible_legacy_evidence.append(evidence)
71
+ finding["code_evidence"] = compatible_legacy_evidence
72
+ elif "code_evidence" in finding:
73
+ finding.pop("code_evidence")
74
+ for section_name, list_fields in (
75
+ ("rootCause", ("evidenceRefs", "evidence_refs")),
76
+ ("root_cause", ("evidenceRefs", "evidence_refs")),
77
+ (
78
+ "validation",
79
+ (
80
+ "assertions",
81
+ "counterEvidence",
82
+ "evidence",
83
+ "evidenceRefs",
84
+ "evidence_refs",
85
+ "limitations",
86
+ ),
87
+ ),
88
+ (
89
+ "attackPath",
90
+ (
91
+ "assumptions",
92
+ "blindspots",
93
+ "controls",
94
+ "evidenceRefs",
95
+ "evidence_refs",
96
+ "limitations",
97
+ "preconditions",
98
+ "steps",
99
+ ),
100
+ ),
101
+ ):
102
+ section = finding.get(section_name)
103
+ if not isinstance(section, dict):
104
+ continue
105
+ _normalize_legacy_string_list_fields(section, list_fields)
106
+ _filter_unknown_legacy_evidence_refs(section, evidence_ids)
107
+ legacy_root_cause = finding.get("root_cause")
108
+ if isinstance(legacy_root_cause, dict):
109
+ _remove_unsupported_legacy_scalar_fields(
110
+ legacy_root_cause, ("summary", "code", "language")
111
+ )
112
+ elif (
113
+ "root_cause" in finding
114
+ and legacy_root_cause is not None
115
+ and (not isinstance(legacy_root_cause, str) or legacy_root_cause == "")
116
+ ):
117
+ finding.pop("root_cause")
118
+ validation = finding.get("validation")
119
+ if isinstance(validation, dict):
120
+ _remove_unsupported_legacy_scalar_fields(
121
+ validation, ("method", "status", "summary", "disposition", "result")
122
+ )
123
+ attack_path = finding.get("attackPath")
124
+ if not isinstance(attack_path, dict):
125
+ continue
126
+ _remove_unsupported_legacy_scalar_fields(attack_path, ("summary",))
127
+ for field in ("dataFlow", "data_flow", "dataflow", "reachability"):
128
+ detail = attack_path.get(field)
129
+ if isinstance(detail, dict):
130
+ detail_scalar_fields = ("summary", "source", "sink", "outcome")
131
+ if field == "reachability":
132
+ detail_scalar_fields += ("attacker", "entrypoint")
133
+ _remove_unsupported_legacy_scalar_fields(detail, detail_scalar_fields)
134
+ _normalize_legacy_string_list_fields(
135
+ detail, ("evidenceRefs", "evidence_refs", "transformations")
136
+ )
137
+ _filter_unknown_legacy_evidence_refs(detail, evidence_ids)
138
+ if field == "reachability":
139
+ _normalize_legacy_string_list_fields(detail, ("preconditions",))
140
+ elif not isinstance(detail, str) or detail == "":
141
+ attack_path.pop(field, None)
142
+ for field in ("impact", "likelihood"):
143
+ detail = attack_path.get(field)
144
+ if isinstance(detail, dict):
145
+ _remove_unsupported_legacy_scalar_fields(detail, ("level", "rationale", "why"))
146
+ elif detail is not None and (not isinstance(detail, str) or detail == ""):
147
+ attack_path.pop(field)
148
+ return compatible
@@ -0,0 +1,198 @@
1
+ """Stage and publish POSIX scan-local files through verified directory descriptors."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import errno
7
+ import os
8
+ import secrets
9
+ import stat
10
+ import sys
11
+ from collections.abc import Callable, Iterator
12
+ from contextlib import contextmanager
13
+ from pathlib import Path, PurePosixPath
14
+
15
+
16
+ def descriptor_relative_writes_available() -> bool:
17
+ """Return whether the platform supports the descriptor-relative operations used for writes."""
18
+ # os.replace accepts src_dir_fd/dst_dir_fd wherever descriptor-relative
19
+ # os.rename is supported, but Python lists only os.rename in supports_dir_fd.
20
+ required_operations = (os.mkdir, os.open, os.rename, os.stat, os.unlink)
21
+ return hasattr(os, "O_NOFOLLOW") and all(
22
+ operation in os.supports_dir_fd for operation in required_operations
23
+ )
24
+
25
+
26
+ @contextmanager
27
+ def managed_fd(descriptor: int) -> Iterator[int]:
28
+ """Yield the descriptor and close it when the context exits, including on error."""
29
+ try:
30
+ yield descriptor
31
+ finally:
32
+ os.close(descriptor)
33
+
34
+
35
+ @contextmanager
36
+ def stage_file(
37
+ parent_fd: int, filename: str, payload: bytes, owner_read_write: bool
38
+ ) -> Iterator[int]:
39
+ """Yield a synced file descriptor for a new staging entry, removing the entry on exit if it still matches."""
40
+ descriptor = os.open(filename, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600, dir_fd=parent_fd)
41
+ try:
42
+ with os.fdopen(descriptor, "wb", closefd=False) as handle:
43
+ if owner_read_write:
44
+ os.fchmod(descriptor, 0o600)
45
+ handle.write(payload)
46
+ handle.flush()
47
+ os.fsync(descriptor)
48
+ yield descriptor
49
+ finally:
50
+ try:
51
+ entry = os.stat(filename, dir_fd=parent_fd, follow_symlinks=False)
52
+ if os.path.samestat(os.fstat(descriptor), entry):
53
+ os.unlink(filename, dir_fd=parent_fd)
54
+ except FileNotFoundError:
55
+ # Successful publication has already removed the temporary name.
56
+ pass
57
+ finally:
58
+ os.close(descriptor)
59
+
60
+
61
+ def _rename_exclusive(parent_fd: int, source: str, destination: str) -> None:
62
+ """Rename a directory entry atomically while requiring the destination to be absent."""
63
+ import ctypes
64
+
65
+ libc = ctypes.CDLL(None, use_errno=True)
66
+ if sys.platform == "linux":
67
+ rename = getattr(libc, "renameat2", None)
68
+ flag = 1 # RENAME_NOREPLACE
69
+ elif sys.platform == "darwin":
70
+ rename = getattr(libc, "renameatx_np", None)
71
+ flag = 4 # RENAME_EXCL
72
+ else:
73
+ rename = None
74
+ code = errno.ENOSYS
75
+ if rename is not None:
76
+ rename.argtypes = [
77
+ ctypes.c_int,
78
+ ctypes.c_char_p,
79
+ ctypes.c_int,
80
+ ctypes.c_char_p,
81
+ ctypes.c_uint,
82
+ ]
83
+ rename.restype = ctypes.c_int
84
+ if rename(parent_fd, os.fsencode(source), parent_fd, os.fsencode(destination), flag) == 0:
85
+ return
86
+ code = ctypes.get_errno()
87
+ detail = os.strerror(code)
88
+ if code in {errno.ENOSYS, errno.ENOTSUP, errno.EOPNOTSUPP, errno.EINVAL}:
89
+ detail = f"cannot publish a new file atomically without hard links or exclusive rename ({detail})"
90
+ raise OSError(code, detail, destination)
91
+
92
+
93
+ def publish_new_file(parent_fd: int, source: str, destination: str) -> None:
94
+ """Publish the staged name without overwriting the destination, using an exclusive rename if linking is unavailable."""
95
+ try:
96
+ os.link(
97
+ source, destination, src_dir_fd=parent_fd, dst_dir_fd=parent_fd, follow_symlinks=False
98
+ )
99
+ except OSError as exc:
100
+ if exc.errno not in {
101
+ errno.EPERM,
102
+ errno.ENOTSUP,
103
+ errno.EOPNOTSUPP,
104
+ errno.ENOSYS,
105
+ errno.EXDEV,
106
+ errno.EMLINK,
107
+ }:
108
+ raise
109
+ _rename_exclusive(parent_fd, source, destination)
110
+ else:
111
+ os.unlink(source, dir_fd=parent_fd)
112
+
113
+
114
+ @contextmanager
115
+ def stage_write(
116
+ parent_fd: int,
117
+ relative_path: str,
118
+ payload: bytes,
119
+ *,
120
+ owner_read_write: bool,
121
+ replace_existing: bool,
122
+ compare_existing: bool,
123
+ check_parent: Callable[[Path], None],
124
+ contract_error: type[ValueError],
125
+ ) -> Iterator[Callable[..., tuple[os.stat_result, int]]]:
126
+ """Stage payload under the open parent directory and yield a callable that publishes it.
127
+
128
+ Call the publisher inside the context. It returns file metadata and the
129
+ change time in nanoseconds. With compare_existing, matching bytes can
130
+ reuse an existing file when replacements are allowed.
131
+ """
132
+ name = PurePosixPath(relative_path).name
133
+ # Stage through the held parent so a replacement path cannot redirect the write.
134
+ try:
135
+ metadata = os.stat(name, dir_fd=parent_fd, follow_symlinks=False)
136
+ except FileNotFoundError:
137
+ pass
138
+ else:
139
+ if not replace_existing:
140
+ raise FileExistsError(errno.EEXIST, os.strerror(errno.EEXIST), relative_path)
141
+ if not stat.S_ISREG(metadata.st_mode):
142
+ raise contract_error(f"{relative_path}: expected a regular non-symlink file")
143
+ try:
144
+ existing_fd = os.open(
145
+ name,
146
+ os.O_RDONLY | getattr(os, "O_NOFOLLOW", 0) | getattr(os, "O_NONBLOCK", 0),
147
+ dir_fd=parent_fd,
148
+ )
149
+ except OSError as exc:
150
+ if exc.errno not in {errno.ENOENT, errno.EACCES, errno.EPERM}:
151
+ raise
152
+ else:
153
+ with managed_fd(existing_fd):
154
+ opened = os.fstat(existing_fd)
155
+ if not stat.S_ISREG(opened.st_mode):
156
+ raise contract_error(f"{relative_path}: expected a regular non-symlink file")
157
+ if not os.path.samestat(opened, metadata):
158
+ raise contract_error(f"{relative_path}: changed while it was being opened")
159
+ if compare_existing and opened.st_size == len(payload):
160
+ from windows_scan_local_files import stream_matches_payload
161
+
162
+ try:
163
+ with os.fdopen(existing_fd, "rb", closefd=False) as handle:
164
+ matches = stream_matches_payload(handle, payload)
165
+ except OSError:
166
+ # A failed content comparison still allows an atomic replacement.
167
+ matches = False
168
+ if matches:
169
+ yield lambda _directory=None: (opened, opened.st_ctime_ns)
170
+ return
171
+ candidate = f".{name}.{secrets.token_hex(8)}.tmp"
172
+
173
+ with stage_file(parent_fd, candidate, payload, owner_read_write) as staged_fd:
174
+ staged = os.fstat(staged_fd)
175
+
176
+ def publish(directory: Path | None = None) -> tuple[os.stat_result, int]:
177
+ if directory is not None:
178
+ check_parent(directory)
179
+ if replace_existing:
180
+ os.replace(candidate, name, src_dir_fd=parent_fd, dst_dir_fd=parent_fd)
181
+ return staged, staged.st_ctime_ns
182
+ named = os.stat(candidate, dir_fd=parent_fd, follow_symlinks=False)
183
+ if not os.path.samestat(staged, named) or staged.st_ctime_ns != named.st_ctime_ns:
184
+ raise contract_error(f"{relative_path}: staged file changed before publication")
185
+ publish_new_file(parent_fd, candidate, name)
186
+ published = os.fstat(staged_fd)
187
+ if (staged.st_size, staged.st_mtime_ns) != (
188
+ published.st_size,
189
+ published.st_mtime_ns,
190
+ ):
191
+ raise contract_error(f"{relative_path}: staged contents changed during publication")
192
+ return published, published.st_ctime_ns
193
+
194
+ yield publish
195
+
196
+
197
+ if __name__ == "__main__":
198
+ argparse.ArgumentParser(description=__doc__).parse_args()
@@ -0,0 +1,21 @@
1
+ import { createReadStream } from "node:fs";
2
+ import { pipeline } from "node:stream/promises";
3
+
4
+ // The Python usage collector uses the plugin's required Node runtime to read
5
+ // cold rollouts without requiring a separate Python compression dependency.
6
+ try {
7
+ const path = process.argv[2];
8
+ if (!path) throw new Error("A Codex rollout path is required.");
9
+ // Native Node decoding can stop after the first frame. Rollouts may contain
10
+ // concatenated frames, and an incomplete later frame must remain an error.
11
+ const { createZstdDecompress } =
12
+ await import("../mcp/session-decompression.mjs");
13
+ await pipeline(
14
+ createReadStream(path),
15
+ createZstdDecompress(),
16
+ process.stdout,
17
+ );
18
+ } catch (error) {
19
+ console.error(error instanceof Error ? error.message : String(error));
20
+ process.exitCode = 1;
21
+ }