@openai/codex-security 0.8.3 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (658) hide show
  1. package/README.md +36 -746
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +7 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/baseline-auditor.md +18 -0
  26. package/_bundled_plugin/references/core-scan.md +5 -42
  27. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  28. package/_bundled_plugin/references/final-report.md +5 -3
  29. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  30. package/_bundled_plugin/references/focused-investigator.md +13 -0
  31. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  32. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  33. package/_bundled_plugin/references/scan-contract.md +27 -33
  34. package/_bundled_plugin/references/scan-prologue.md +2 -2
  35. package/_bundled_plugin/references/scan-runtime.md +4 -2
  36. package/_bundled_plugin/references/security-guidance.md +14 -1
  37. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  38. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  39. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  40. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  41. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  42. package/_bundled_plugin/scripts/deep_scan_workbench.py +192 -352
  43. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  44. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  45. package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
  46. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  47. package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
  48. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  49. package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
  50. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  51. package/_bundled_plugin/scripts/report_projection.py +81 -43
  52. package/_bundled_plugin/scripts/review_state.py +8 -2
  53. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  54. package/_bundled_plugin/scripts/snapshot_sqlite.py +9 -2
  55. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  56. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  57. package/_bundled_plugin/scripts/windows_scan_local_files.py +582 -20
  58. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  59. package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
  60. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  61. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  62. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  63. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  64. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  65. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  66. package/_bundled_plugin/scripts/workbench/storage.py +91 -7
  67. package/_bundled_plugin/scripts/workbench_cli.py +54 -14
  68. package/_bundled_plugin/scripts/workbench_constants.py +12 -0
  69. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  70. package/_bundled_plugin/scripts/workbench_db.py +562 -303
  71. package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +238 -41
  75. package/_bundled_plugin/scripts/workbench_progress.py +169 -4
  76. package/_bundled_plugin/scripts/workbench_publication.py +16 -13
  77. package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
  82. package/_bundled_plugin/scripts/workbench_schema.py +258 -63
  83. package/_bundled_plugin/scripts/workbench_setup.py +14 -2
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  85. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  86. package/_bundled_plugin/scripts/workbench_target.py +594 -136
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
  88. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
  90. package/_bundled_plugin/shared/workbench-migrations.json +100 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  93. package/_bundled_plugin/skills/fix-finding/SKILL.md +2 -1
  94. package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
  95. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  96. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  97. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  98. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +409 -0
  99. package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
  100. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  104. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  105. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  106. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  107. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  108. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  110. package/bin/codex-security.mjs +2 -2
  111. package/dist/api.d.ts +45 -5
  112. package/dist/api.d.ts.map +1 -1
  113. package/dist/api.js +1192 -427
  114. package/dist/api.js.map +1 -1
  115. package/dist/armorcode-findings.d.ts +9 -0
  116. package/dist/armorcode-findings.d.ts.map +1 -0
  117. package/dist/armorcode-findings.js +145 -0
  118. package/dist/armorcode-findings.js.map +1 -0
  119. package/dist/artifact-export.d.ts +2 -0
  120. package/dist/artifact-export.d.ts.map +1 -1
  121. package/dist/artifact-export.js +29 -13
  122. package/dist/artifact-export.js.map +1 -1
  123. package/dist/auth.d.ts +6 -2
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +37 -18
  126. package/dist/auth.js.map +1 -1
  127. package/dist/batch-cost.d.ts +18 -0
  128. package/dist/batch-cost.d.ts.map +1 -0
  129. package/dist/batch-cost.js +41 -0
  130. package/dist/batch-cost.js.map +1 -0
  131. package/dist/bedrock-oss-pricing.d.ts +6 -0
  132. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  133. package/dist/bedrock-oss-pricing.js +58 -0
  134. package/dist/bedrock-oss-pricing.js.map +1 -0
  135. package/dist/bedrock-pricing.d.ts +15 -0
  136. package/dist/bedrock-pricing.d.ts.map +1 -0
  137. package/dist/bedrock-pricing.js +117 -0
  138. package/dist/bedrock-pricing.js.map +1 -0
  139. package/dist/blackduck-findings.d.ts +1 -1
  140. package/dist/blackduck-findings.d.ts.map +1 -1
  141. package/dist/blackduck-findings.js +24 -22
  142. package/dist/blackduck-findings.js.map +1 -1
  143. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  144. package/dist/bulk-scan-discovery.js +4 -4
  145. package/dist/bulk-scan-discovery.js.map +1 -1
  146. package/dist/bundled-plugin.d.ts +4 -0
  147. package/dist/bundled-plugin.d.ts.map +1 -0
  148. package/dist/bundled-plugin.js +23 -0
  149. package/dist/bundled-plugin.js.map +1 -0
  150. package/dist/checkmarx-evidence.d.ts +19 -0
  151. package/dist/checkmarx-evidence.d.ts.map +1 -0
  152. package/dist/checkmarx-evidence.js +36 -0
  153. package/dist/checkmarx-evidence.js.map +1 -0
  154. package/dist/checkmarx-findings.d.ts +4 -0
  155. package/dist/checkmarx-findings.d.ts.map +1 -0
  156. package/dist/checkmarx-findings.js +27 -0
  157. package/dist/checkmarx-findings.js.map +1 -0
  158. package/dist/checkmarx-one.d.ts +4 -0
  159. package/dist/checkmarx-one.d.ts.map +1 -0
  160. package/dist/checkmarx-one.js +53 -0
  161. package/dist/checkmarx-one.js.map +1 -0
  162. package/dist/checkmarx-repository.d.ts +12 -0
  163. package/dist/checkmarx-repository.d.ts.map +1 -0
  164. package/dist/checkmarx-repository.js +181 -0
  165. package/dist/checkmarx-repository.js.map +1 -0
  166. package/dist/checkmarx-xml.d.ts +12 -0
  167. package/dist/checkmarx-xml.d.ts.map +1 -0
  168. package/dist/checkmarx-xml.js +196 -0
  169. package/dist/checkmarx-xml.js.map +1 -0
  170. package/dist/classify-scan-severity.d.ts +1 -1
  171. package/dist/classify-scan-severity.d.ts.map +1 -1
  172. package/dist/classify-scan-severity.js +11 -3
  173. package/dist/classify-scan-severity.js.map +1 -1
  174. package/dist/classify-severity-records.d.ts +1 -9
  175. package/dist/classify-severity-records.d.ts.map +1 -1
  176. package/dist/classify-severity-records.js +3 -13
  177. package/dist/classify-severity-records.js.map +1 -1
  178. package/dist/classify-severity.d.ts.map +1 -1
  179. package/dist/classify-severity.js +11 -10
  180. package/dist/classify-severity.js.map +1 -1
  181. package/dist/cli-argument.d.ts +4 -0
  182. package/dist/cli-argument.d.ts.map +1 -0
  183. package/dist/cli-argument.js +17 -0
  184. package/dist/cli-argument.js.map +1 -0
  185. package/dist/cli-help.d.ts +1 -1
  186. package/dist/cli-help.d.ts.map +1 -1
  187. package/dist/cli-help.js +71 -29
  188. package/dist/cli-help.js.map +1 -1
  189. package/dist/cli-hook.d.ts +3 -0
  190. package/dist/cli-hook.d.ts.map +1 -0
  191. package/dist/cli-hook.js +87 -0
  192. package/dist/cli-hook.js.map +1 -0
  193. package/dist/cli-integrations.d.ts +13 -0
  194. package/dist/cli-integrations.d.ts.map +1 -0
  195. package/dist/cli-integrations.js +333 -0
  196. package/dist/cli-integrations.js.map +1 -0
  197. package/dist/cli-mcp.d.ts +15 -0
  198. package/dist/cli-mcp.d.ts.map +1 -0
  199. package/dist/cli-mcp.js +178 -0
  200. package/dist/cli-mcp.js.map +1 -0
  201. package/dist/cli-token-view.d.ts +10 -0
  202. package/dist/cli-token-view.d.ts.map +1 -0
  203. package/dist/cli-token-view.js +41 -0
  204. package/dist/cli-token-view.js.map +1 -0
  205. package/dist/cli.d.ts +16 -8
  206. package/dist/cli.d.ts.map +1 -1
  207. package/dist/cli.js +3382 -2017
  208. package/dist/cli.js.map +1 -1
  209. package/dist/cloud-publish.d.ts.map +1 -1
  210. package/dist/cloud-publish.js +35 -33
  211. package/dist/cloud-publish.js.map +1 -1
  212. package/dist/codex-sdk-environment.d.ts +6 -0
  213. package/dist/codex-sdk-environment.d.ts.map +1 -1
  214. package/dist/codex-sdk-environment.js +19 -0
  215. package/dist/codex-sdk-environment.js.map +1 -1
  216. package/dist/command-words.d.ts +3 -0
  217. package/dist/command-words.d.ts.map +1 -0
  218. package/dist/command-words.js +46 -0
  219. package/dist/command-words.js.map +1 -0
  220. package/dist/component-scan.d.ts +19 -4
  221. package/dist/component-scan.d.ts.map +1 -1
  222. package/dist/component-scan.js +67 -9
  223. package/dist/component-scan.js.map +1 -1
  224. package/dist/config.d.ts +1 -1
  225. package/dist/config.d.ts.map +1 -1
  226. package/dist/config.js +130 -67
  227. package/dist/config.js.map +1 -1
  228. package/dist/continuum-findings.d.ts +1 -1
  229. package/dist/continuum-findings.d.ts.map +1 -1
  230. package/dist/continuum-findings.js +149 -19
  231. package/dist/continuum-findings.js.map +1 -1
  232. package/dist/contract-values.d.ts +2 -0
  233. package/dist/contract-values.d.ts.map +1 -1
  234. package/dist/contract-values.js +12 -9
  235. package/dist/contract-values.js.map +1 -1
  236. package/dist/cost-model.d.ts +13 -1
  237. package/dist/cost-model.d.ts.map +1 -1
  238. package/dist/cost-model.js +66 -112
  239. package/dist/cost-model.js.map +1 -1
  240. package/dist/cost.d.ts +42 -3
  241. package/dist/cost.d.ts.map +1 -1
  242. package/dist/cost.js +484 -149
  243. package/dist/cost.js.map +1 -1
  244. package/dist/custom-publish.d.ts +4 -0
  245. package/dist/custom-publish.d.ts.map +1 -1
  246. package/dist/custom-publish.js +40 -3
  247. package/dist/custom-publish.js.map +1 -1
  248. package/dist/custom-validation-prompt.d.ts +1 -1
  249. package/dist/custom-validation-prompt.d.ts.map +1 -1
  250. package/dist/custom-validation-prompt.js +29 -19
  251. package/dist/custom-validation-prompt.js.map +1 -1
  252. package/dist/deduplication/local.d.ts +4 -2
  253. package/dist/deduplication/local.d.ts.map +1 -1
  254. package/dist/deduplication/local.js +9 -2
  255. package/dist/deduplication/local.js.map +1 -1
  256. package/dist/deduplication/refusal.d.ts.map +1 -1
  257. package/dist/deduplication/refusal.js +26 -5
  258. package/dist/deduplication/refusal.js.map +1 -1
  259. package/dist/deduplication/scan.d.ts +5 -0
  260. package/dist/deduplication/scan.d.ts.map +1 -1
  261. package/dist/deduplication/scan.js +24 -7
  262. package/dist/deduplication/scan.js.map +1 -1
  263. package/dist/deep-config.d.ts +0 -1
  264. package/dist/deep-config.d.ts.map +1 -1
  265. package/dist/deep-config.js +22 -33
  266. package/dist/deep-config.js.map +1 -1
  267. package/dist/deep-scan-defaults.d.ts +2 -0
  268. package/dist/deep-scan-defaults.d.ts.map +1 -1
  269. package/dist/deep-scan-defaults.js +28 -1
  270. package/dist/deep-scan-defaults.js.map +1 -1
  271. package/dist/deep-scan.d.ts +2 -0
  272. package/dist/deep-scan.d.ts.map +1 -1
  273. package/dist/deep-scan.js +44 -19
  274. package/dist/deep-scan.js.map +1 -1
  275. package/dist/default-severity-rubric.d.ts +1 -1
  276. package/dist/default-severity-rubric.d.ts.map +1 -1
  277. package/dist/default-severity-rubric.js +1 -1
  278. package/dist/default-severity-rubric.js.map +1 -1
  279. package/dist/endor-findings.d.ts +3 -1
  280. package/dist/endor-findings.d.ts.map +1 -1
  281. package/dist/endor-findings.js +86 -45
  282. package/dist/endor-findings.js.map +1 -1
  283. package/dist/errors.d.ts +4 -2
  284. package/dist/errors.d.ts.map +1 -1
  285. package/dist/errors.js +15 -4
  286. package/dist/errors.js.map +1 -1
  287. package/dist/executable-path.d.ts +3 -0
  288. package/dist/executable-path.d.ts.map +1 -1
  289. package/dist/executable-path.js +26 -0
  290. package/dist/executable-path.js.map +1 -1
  291. package/dist/external-findings-import.d.ts +5 -3
  292. package/dist/external-findings-import.d.ts.map +1 -1
  293. package/dist/external-findings-import.js +19 -7
  294. package/dist/external-findings-import.js.map +1 -1
  295. package/dist/external-findings-local.d.ts +69 -5
  296. package/dist/external-findings-local.d.ts.map +1 -1
  297. package/dist/external-findings-local.js +537 -108
  298. package/dist/external-findings-local.js.map +1 -1
  299. package/dist/external-findings-publish.d.ts +13 -6
  300. package/dist/external-findings-publish.d.ts.map +1 -1
  301. package/dist/external-findings-publish.js +895 -1142
  302. package/dist/external-findings-publish.js.map +1 -1
  303. package/dist/external-findings-read.d.ts +21 -2
  304. package/dist/external-findings-read.d.ts.map +1 -1
  305. package/dist/external-findings-read.js +130 -68
  306. package/dist/external-findings-read.js.map +1 -1
  307. package/dist/external-findings.d.ts +15 -3
  308. package/dist/external-findings.d.ts.map +1 -1
  309. package/dist/external-findings.js +54 -2
  310. package/dist/external-findings.js.map +1 -1
  311. package/dist/external-import-contract.d.ts +8 -12
  312. package/dist/external-import-contract.d.ts.map +1 -1
  313. package/dist/external-import-contract.js +51 -184
  314. package/dist/external-import-contract.js.map +1 -1
  315. package/dist/external-import-models.d.ts +1 -1
  316. package/dist/external-import-models.d.ts.map +1 -1
  317. package/dist/external-import-models.js.map +1 -1
  318. package/dist/feedback.d.ts.map +1 -1
  319. package/dist/feedback.js +5 -4
  320. package/dist/feedback.js.map +1 -1
  321. package/dist/finding-prompt.d.ts +5 -0
  322. package/dist/finding-prompt.d.ts.map +1 -0
  323. package/dist/finding-prompt.js +32 -0
  324. package/dist/finding-prompt.js.map +1 -0
  325. package/dist/findings-client.d.ts +1 -0
  326. package/dist/findings-client.d.ts.map +1 -1
  327. package/dist/findings-client.js +27 -3
  328. package/dist/findings-client.js.map +1 -1
  329. package/dist/github-advisories.d.ts.map +1 -1
  330. package/dist/github-advisories.js +0 -2
  331. package/dist/github-advisories.js.map +1 -1
  332. package/dist/github-dependabot-findings.d.ts.map +1 -1
  333. package/dist/github-dependabot-findings.js +18 -8
  334. package/dist/github-dependabot-findings.js.map +1 -1
  335. package/dist/github-findings.d.ts +4 -1
  336. package/dist/github-findings.d.ts.map +1 -1
  337. package/dist/github-findings.js +73 -316
  338. package/dist/github-findings.js.map +1 -1
  339. package/dist/hosted-git-remotes.d.ts +5 -0
  340. package/dist/hosted-git-remotes.d.ts.map +1 -0
  341. package/dist/hosted-git-remotes.js +285 -0
  342. package/dist/hosted-git-remotes.js.map +1 -0
  343. package/dist/hosted-git-repository.d.ts +28 -0
  344. package/dist/hosted-git-repository.d.ts.map +1 -0
  345. package/dist/hosted-git-repository.js +222 -0
  346. package/dist/hosted-git-repository.js.map +1 -0
  347. package/dist/hosted-remediation.d.ts +1 -0
  348. package/dist/hosted-remediation.d.ts.map +1 -1
  349. package/dist/hosted-remediation.js +23 -3
  350. package/dist/hosted-remediation.js.map +1 -1
  351. package/dist/hosted-scan-protocol.js +2 -2
  352. package/dist/hosted-scan-protocol.js.map +1 -1
  353. package/dist/hosted-scan.d.ts.map +1 -1
  354. package/dist/hosted-scan.js +16 -11
  355. package/dist/hosted-scan.js.map +1 -1
  356. package/dist/hosted-scanner-http.d.ts +21 -0
  357. package/dist/hosted-scanner-http.d.ts.map +1 -0
  358. package/dist/hosted-scanner-http.js +204 -0
  359. package/dist/hosted-scanner-http.js.map +1 -0
  360. package/dist/import-scan.d.ts.map +1 -1
  361. package/dist/import-scan.js +3 -0
  362. package/dist/import-scan.js.map +1 -1
  363. package/dist/index.d.ts +21 -9
  364. package/dist/index.d.ts.map +1 -1
  365. package/dist/index.js +12 -3
  366. package/dist/index.js.map +1 -1
  367. package/dist/inspector-findings.d.ts.map +1 -1
  368. package/dist/inspector-findings.js +52 -86
  369. package/dist/inspector-findings.js.map +1 -1
  370. package/dist/knowledge-base.d.ts +1 -1
  371. package/dist/knowledge-base.d.ts.map +1 -1
  372. package/dist/knowledge-base.js +102 -32
  373. package/dist/knowledge-base.js.map +1 -1
  374. package/dist/linear.d.ts +11 -0
  375. package/dist/linear.d.ts.map +1 -1
  376. package/dist/linear.js.map +1 -1
  377. package/dist/local-git-metadata.d.ts +5 -2
  378. package/dist/local-git-metadata.d.ts.map +1 -1
  379. package/dist/local-git-metadata.js +8 -5
  380. package/dist/local-git-metadata.js.map +1 -1
  381. package/dist/multiscan.d.ts +10 -4
  382. package/dist/multiscan.d.ts.map +1 -1
  383. package/dist/multiscan.js +217 -102
  384. package/dist/multiscan.js.map +1 -1
  385. package/dist/native-json-findings.d.ts +2 -1
  386. package/dist/native-json-findings.d.ts.map +1 -1
  387. package/dist/native-json-findings.js +12 -2
  388. package/dist/native-json-findings.js.map +1 -1
  389. package/dist/opengrep-findings.d.ts +5 -2
  390. package/dist/opengrep-findings.d.ts.map +1 -1
  391. package/dist/opengrep-findings.js +54 -33
  392. package/dist/opengrep-findings.js.map +1 -1
  393. package/dist/operation-telemetry.d.ts +104 -0
  394. package/dist/operation-telemetry.d.ts.map +1 -0
  395. package/dist/operation-telemetry.js +293 -0
  396. package/dist/operation-telemetry.js.map +1 -0
  397. package/dist/plugin-python-probe.d.ts +4 -0
  398. package/dist/plugin-python-probe.d.ts.map +1 -0
  399. package/dist/plugin-python-probe.js +10 -0
  400. package/dist/plugin-python-probe.js.map +1 -0
  401. package/dist/private-finding-import.d.ts +99 -9
  402. package/dist/private-finding-import.d.ts.map +1 -1
  403. package/dist/private-finding-import.js +116 -152
  404. package/dist/private-finding-import.js.map +1 -1
  405. package/dist/project-config.d.ts.map +1 -1
  406. package/dist/project-config.js +53 -13
  407. package/dist/project-config.js.map +1 -1
  408. package/dist/prompt-files.d.ts +7 -2
  409. package/dist/prompt-files.d.ts.map +1 -1
  410. package/dist/prompt-files.js +42 -20
  411. package/dist/prompt-files.js.map +1 -1
  412. package/dist/provider-profile.d.ts +1 -1
  413. package/dist/provider-profile.d.ts.map +1 -1
  414. package/dist/provider-profile.js +12 -10
  415. package/dist/provider-profile.js.map +1 -1
  416. package/dist/publication-telemetry.d.ts +45 -0
  417. package/dist/publication-telemetry.d.ts.map +1 -0
  418. package/dist/publication-telemetry.js +50 -0
  419. package/dist/publication-telemetry.js.map +1 -0
  420. package/dist/publication.d.ts +1 -1
  421. package/dist/publication.d.ts.map +1 -1
  422. package/dist/publication.js.map +1 -1
  423. package/dist/publish.d.ts +4 -0
  424. package/dist/publish.d.ts.map +1 -1
  425. package/dist/publish.js +42 -2
  426. package/dist/publish.js.map +1 -1
  427. package/dist/record.d.ts +1 -5
  428. package/dist/record.d.ts.map +1 -1
  429. package/dist/record.js +3 -51
  430. package/dist/record.js.map +1 -1
  431. package/dist/remediation.d.ts +1 -4
  432. package/dist/remediation.d.ts.map +1 -1
  433. package/dist/remediation.js +6 -8
  434. package/dist/remediation.js.map +1 -1
  435. package/dist/request-metadata.d.ts +3 -0
  436. package/dist/request-metadata.d.ts.map +1 -1
  437. package/dist/request-metadata.js +9 -0
  438. package/dist/request-metadata.js.map +1 -1
  439. package/dist/result.d.ts +4 -0
  440. package/dist/result.d.ts.map +1 -1
  441. package/dist/result.js +1 -1
  442. package/dist/result.js.map +1 -1
  443. package/dist/retry-windows-rename.d.ts +8 -0
  444. package/dist/retry-windows-rename.d.ts.map +1 -0
  445. package/dist/retry-windows-rename.js +24 -0
  446. package/dist/retry-windows-rename.js.map +1 -0
  447. package/dist/runtime.d.ts +54 -6
  448. package/dist/runtime.d.ts.map +1 -1
  449. package/dist/runtime.js +1084 -256
  450. package/dist/runtime.js.map +1 -1
  451. package/dist/saved-scan-bootstrap.d.ts +7 -1
  452. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  453. package/dist/saved-scan-bootstrap.js +269 -114
  454. package/dist/saved-scan-bootstrap.js.map +1 -1
  455. package/dist/scan-activity.d.ts.map +1 -1
  456. package/dist/scan-activity.js +141 -56
  457. package/dist/scan-activity.js.map +1 -1
  458. package/dist/scan-archive-path.d.ts +2 -0
  459. package/dist/scan-archive-path.d.ts.map +1 -0
  460. package/dist/scan-archive-path.js +5 -0
  461. package/dist/scan-archive-path.js.map +1 -0
  462. package/dist/scan-comparison.d.ts +10 -5
  463. package/dist/scan-comparison.d.ts.map +1 -1
  464. package/dist/scan-comparison.js +66 -17
  465. package/dist/scan-comparison.js.map +1 -1
  466. package/dist/scan-dashboard.d.ts +7 -6
  467. package/dist/scan-dashboard.d.ts.map +1 -1
  468. package/dist/scan-dashboard.js +92 -43
  469. package/dist/scan-dashboard.js.map +1 -1
  470. package/dist/scan-executor.d.ts +10 -1
  471. package/dist/scan-executor.d.ts.map +1 -1
  472. package/dist/scan-executor.js +24 -2
  473. package/dist/scan-executor.js.map +1 -1
  474. package/dist/scan-history-renderer.d.ts +1 -0
  475. package/dist/scan-history-renderer.d.ts.map +1 -1
  476. package/dist/scan-history-renderer.js +34 -28
  477. package/dist/scan-history-renderer.js.map +1 -1
  478. package/dist/scan-logs.d.ts +12 -0
  479. package/dist/scan-logs.d.ts.map +1 -1
  480. package/dist/scan-logs.js +131 -78
  481. package/dist/scan-logs.js.map +1 -1
  482. package/dist/scan-measurement.d.ts +26 -0
  483. package/dist/scan-measurement.d.ts.map +1 -0
  484. package/dist/scan-measurement.js +77 -0
  485. package/dist/scan-measurement.js.map +1 -0
  486. package/dist/scan-progress.d.ts +1 -0
  487. package/dist/scan-progress.d.ts.map +1 -1
  488. package/dist/scan-progress.js +3 -0
  489. package/dist/scan-progress.js.map +1 -1
  490. package/dist/scan-sessions.d.ts.map +1 -1
  491. package/dist/scan-sessions.js +4 -1
  492. package/dist/scan-sessions.js.map +1 -1
  493. package/dist/scan-settings.d.ts +1 -1
  494. package/dist/scan-settings.d.ts.map +1 -1
  495. package/dist/scan-settings.js +1 -24
  496. package/dist/scan-settings.js.map +1 -1
  497. package/dist/scanner-import.d.ts +25 -13
  498. package/dist/scanner-import.d.ts.map +1 -1
  499. package/dist/scanner-import.js +216 -97
  500. package/dist/scanner-import.js.map +1 -1
  501. package/dist/scanner-repository-url.d.ts +4 -1
  502. package/dist/scanner-repository-url.d.ts.map +1 -1
  503. package/dist/scanner-repository-url.js +10 -6
  504. package/dist/scanner-repository-url.js.map +1 -1
  505. package/dist/security-policy.d.ts +1 -1
  506. package/dist/security-policy.d.ts.map +1 -1
  507. package/dist/security-policy.js +26 -6
  508. package/dist/security-policy.js.map +1 -1
  509. package/dist/semgrep-findings.d.ts +6 -3
  510. package/dist/semgrep-findings.d.ts.map +1 -1
  511. package/dist/semgrep-findings.js +72 -42
  512. package/dist/semgrep-findings.js.map +1 -1
  513. package/dist/semgrep-guardian-findings.d.ts +38 -0
  514. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  515. package/dist/semgrep-guardian-findings.js +165 -0
  516. package/dist/semgrep-guardian-findings.js.map +1 -0
  517. package/dist/semgrep-platform-collector.d.ts +26 -0
  518. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  519. package/dist/semgrep-platform-collector.js +108 -0
  520. package/dist/semgrep-platform-collector.js.map +1 -0
  521. package/dist/semgrep-platform-findings.d.ts +157 -6
  522. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  523. package/dist/semgrep-platform-findings.js +766 -103
  524. package/dist/semgrep-platform-findings.js.map +1 -1
  525. package/dist/server/api.d.ts +1 -1
  526. package/dist/server/api.d.ts.map +1 -1
  527. package/dist/server/api.js.map +1 -1
  528. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  529. package/dist/server/embedding-tokenizer.d.ts +2 -0
  530. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  531. package/dist/server/embedding-tokenizer.js +322 -0
  532. package/dist/server/embedding-tokenizer.js.map +6 -0
  533. package/dist/server/embeddings.d.ts +16 -2
  534. package/dist/server/embeddings.d.ts.map +1 -1
  535. package/dist/server/embeddings.js +35 -5
  536. package/dist/server/embeddings.js.map +1 -1
  537. package/dist/session-lines.d.ts +5 -0
  538. package/dist/session-lines.d.ts.map +1 -0
  539. package/dist/session-lines.js +60 -0
  540. package/dist/session-lines.js.map +1 -0
  541. package/dist/severity-review.d.ts +3 -1
  542. package/dist/severity-review.d.ts.map +1 -1
  543. package/dist/severity-review.js +3 -2
  544. package/dist/severity-review.js.map +1 -1
  545. package/dist/skill-authentication.d.ts +1 -0
  546. package/dist/skill-authentication.d.ts.map +1 -1
  547. package/dist/skill-authentication.js +1 -0
  548. package/dist/skill-authentication.js.map +1 -1
  549. package/dist/snyk-findings.d.ts +9 -2
  550. package/dist/snyk-findings.d.ts.map +1 -1
  551. package/dist/snyk-findings.js +90 -70
  552. package/dist/snyk-findings.js.map +1 -1
  553. package/dist/snyk-rest-findings.d.ts +59 -0
  554. package/dist/snyk-rest-findings.d.ts.map +1 -0
  555. package/dist/snyk-rest-findings.js +879 -0
  556. package/dist/snyk-rest-findings.js.map +1 -0
  557. package/dist/snyk-token-origin.d.ts +4 -0
  558. package/dist/snyk-token-origin.d.ts.map +1 -0
  559. package/dist/snyk-token-origin.js +82 -0
  560. package/dist/snyk-token-origin.js.map +1 -0
  561. package/dist/sonar-collector.d.ts.map +1 -1
  562. package/dist/sonar-collector.js +0 -3
  563. package/dist/sonar-collector.js.map +1 -1
  564. package/dist/sonar-findings.d.ts +1 -1
  565. package/dist/sonar-findings.d.ts.map +1 -1
  566. package/dist/sonar-findings.js +2 -4
  567. package/dist/sonar-findings.js.map +1 -1
  568. package/dist/sonar-import.d.ts +3 -0
  569. package/dist/sonar-import.d.ts.map +1 -1
  570. package/dist/sonar-import.js +30 -34
  571. package/dist/sonar-import.js.map +1 -1
  572. package/dist/stored-finding-projection.d.ts +6 -0
  573. package/dist/stored-finding-projection.d.ts.map +1 -0
  574. package/dist/stored-finding-projection.js +104 -0
  575. package/dist/stored-finding-projection.js.map +1 -0
  576. package/dist/stored-findings-publication.d.ts +23 -0
  577. package/dist/stored-findings-publication.d.ts.map +1 -0
  578. package/dist/stored-findings-publication.js +169 -0
  579. package/dist/stored-findings-publication.js.map +1 -0
  580. package/dist/target-drift.d.ts +9 -0
  581. package/dist/target-drift.d.ts.map +1 -0
  582. package/dist/target-drift.js +27 -0
  583. package/dist/target-drift.js.map +1 -0
  584. package/dist/targets.d.ts +8 -1
  585. package/dist/targets.d.ts.map +1 -1
  586. package/dist/targets.js +131 -42
  587. package/dist/targets.js.map +1 -1
  588. package/dist/tenable-findings.d.ts +6 -0
  589. package/dist/tenable-findings.d.ts.map +1 -0
  590. package/dist/tenable-findings.js +122 -0
  591. package/dist/tenable-findings.js.map +1 -0
  592. package/dist/terminal-stream.d.ts +13 -0
  593. package/dist/terminal-stream.d.ts.map +1 -0
  594. package/dist/terminal-stream.js +35 -0
  595. package/dist/terminal-stream.js.map +1 -0
  596. package/dist/trivy-findings.d.ts +19 -0
  597. package/dist/trivy-findings.d.ts.map +1 -0
  598. package/dist/trivy-findings.js +424 -0
  599. package/dist/trivy-findings.js.map +1 -0
  600. package/dist/trivy-import.d.ts +19 -0
  601. package/dist/trivy-import.d.ts.map +1 -0
  602. package/dist/trivy-import.js +151 -0
  603. package/dist/trivy-import.js.map +1 -0
  604. package/dist/trusted-executable.d.ts +6 -0
  605. package/dist/trusted-executable.d.ts.map +1 -1
  606. package/dist/trusted-executable.js +140 -37
  607. package/dist/trusted-executable.js.map +1 -1
  608. package/dist/validation-records.js +1 -1
  609. package/dist/validation-records.js.map +1 -1
  610. package/dist/veracode-findings.d.ts +1 -1
  611. package/dist/veracode-findings.d.ts.map +1 -1
  612. package/dist/veracode-findings.js +19 -6
  613. package/dist/veracode-findings.js.map +1 -1
  614. package/dist/version.d.ts +3 -1
  615. package/dist/version.d.ts.map +1 -1
  616. package/dist/version.js +184 -32
  617. package/dist/version.js.map +1 -1
  618. package/dist/vertex-pricing.d.ts +8 -0
  619. package/dist/vertex-pricing.d.ts.map +1 -0
  620. package/dist/vertex-pricing.js +20 -0
  621. package/dist/vertex-pricing.js.map +1 -0
  622. package/dist/windows-path.d.ts +1 -0
  623. package/dist/windows-path.d.ts.map +1 -1
  624. package/dist/windows-path.js +26 -1
  625. package/dist/windows-path.js.map +1 -1
  626. package/dist/wiz-findings.d.ts +6 -2
  627. package/dist/wiz-findings.d.ts.map +1 -1
  628. package/dist/wiz-findings.js +65 -89
  629. package/dist/wiz-findings.js.map +1 -1
  630. package/docs/classify-severity-records.md +27 -12
  631. package/docs/cli.md +853 -639
  632. package/docs/dedupe-records.md +44 -24
  633. package/docs/findings-service.md +84 -44
  634. package/docs/hosted-remediation.md +27 -11
  635. package/docs/hosted-scans.md +50 -42
  636. package/docs/sdk.md +903 -0
  637. package/docs/telemetry.md +236 -0
  638. package/docs/validate-records.md +78 -44
  639. package/package.json +23 -16
  640. package/schemas/external-findings.schema.json +4 -1
  641. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  642. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  643. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  644. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  645. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  646. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  647. package/dist/external-imports-feature.d.ts +0 -6
  648. package/dist/external-imports-feature.d.ts.map +0 -1
  649. package/dist/external-imports-feature.js +0 -51
  650. package/dist/external-imports-feature.js.map +0 -1
  651. package/dist/finding-normalization.d.ts +0 -5
  652. package/dist/finding-normalization.d.ts.map +0 -1
  653. package/dist/finding-normalization.js +0 -155
  654. package/dist/finding-normalization.js.map +0 -1
  655. package/dist/reader-selection.d.ts +0 -13
  656. package/dist/reader-selection.d.ts.map +0 -1
  657. package/dist/reader-selection.js +0 -81
  658. package/dist/reader-selection.js.map +0 -1
@@ -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] = {}
@@ -251,6 +256,7 @@ def bounded_finding_section(
251
256
  priority_keys: tuple[str, ...],
252
257
  reserved_fields: tuple[tuple[tuple[str, ...], int], ...],
253
258
  ) -> Any:
259
+ """Apply each field group’s size cap before selecting fields in priority order under the section cap."""
254
260
  if not isinstance(value, dict):
255
261
  return bounded_json_value(value, [maximum_bytes])
256
262
  ordered: dict[str, Any] = {}
@@ -270,6 +276,12 @@ def bounded_finding_section(
270
276
 
271
277
 
272
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
+ """
273
285
  evidence_keys = [key for key in ("codeEvidence", "code_evidence") if key in value]
274
286
  if not evidence_keys:
275
287
  return None, None
@@ -315,6 +327,7 @@ def merged_bounded_code_evidence(value: dict[str, Any]) -> tuple[str | None, Any
315
327
 
316
328
 
317
329
  def json_size(value: Any) -> int:
330
+ """Return the byte count of the compact, ASCII-escaped JSON representation."""
318
331
  # ASCII output gives byte length; strings can use the cached default encoder.
319
332
  return len(json.dumps(value, separators=None if isinstance(value, str) else (",", ":")))
320
333
 
@@ -326,6 +339,7 @@ def bounded_json_value(
326
339
  depth: int = 0,
327
340
  max_depth: int = 4,
328
341
  ) -> Any:
342
+ """Build a depth-limited preview while charging its JSON representation to the shared byte budget."""
329
343
  if budget[0] <= 0:
330
344
  return None
331
345
  if depth >= max_depth:
@@ -415,6 +429,7 @@ def bounded_json_value(
415
429
 
416
430
 
417
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."""
418
433
  if budget[0] < size:
419
434
  budget[0] = 0
420
435
  return False
@@ -423,6 +438,11 @@ def consume_json_budget(budget: list[int], size: int) -> bool:
423
438
 
424
439
 
425
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
+ """
426
446
  length = bisect_right(
427
447
  range(min(len(value), maximum_bytes) + 1), maximum_bytes, key=lambda n: json_size(value[:n])
428
448
  )
@@ -1,10 +1,14 @@
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
- PATH="${PATH:-/usr/bin:/bin}:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
5
- export PATH
5
+ # The SDK may have removed directories containing repository-owned executables.
6
+ if [ -z "${_CODEX_SECURITY_SDK_NODE_SEARCH_PATH+x}" ]; then
7
+ PATH="${PATH:-/usr/bin:/bin}:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
8
+ export PATH
9
+ fi
6
10
 
7
- launcher_dir=$(CDPATH= cd "$(dirname "$0")" && pwd)
11
+ launcher_dir=$(CDPATH= cd "$(command -p dirname "$0")" && pwd)
8
12
  server_path=$launcher_dir/../mcp/server.mjs
9
13
  if [ "${1:-}" = "--helper" ]; then
10
14
  server_path=$launcher_dir/../mcp/helpers.mjs
@@ -15,10 +19,10 @@ launch_node() {
15
19
  if [ "${1:-}" = "--helper" ]; then
16
20
  shift
17
21
  # Preserve POSIX argv and HOME bytes without temporary files or consuming stdin.
18
- helper_stdin=-
22
+ helper_stdin_open=false
19
23
  if (exec 4<&0) 2>&-; then
20
24
  exec 4<&0
21
- helper_stdin=4
25
+ helper_stdin_open=true
22
26
  fi
23
27
  wait_helper() {
24
28
  if wait "$!" 2>&-; then exit 0; else exit $?; fi
@@ -33,8 +37,15 @@ launch_node() {
33
37
  trap 'forward_signal HUP 129' HUP
34
38
  trap 'forward_signal INT 130' INT
35
39
  trap 'forward_signal TERM 143' TERM
36
- printf '%s\000' "${HOME+x}" "${HOME-}" "$@" | od -An -v -tx1 | tr -d ' \n' |
37
- "$node_command" "$server_path" --helper 3<&0 0<&"$helper_stdin" 4<&- &
40
+ printf '%s\000' "${HOME+x}" "${HOME-}" "$@" | command -p od -An -v -tx1 | command -p tr -d ' \n' | {
41
+ # BusyBox ash requires a literal close redirection for a closed stdin.
42
+ if [ "$helper_stdin_open" = true ]; then
43
+ exec 0<&4
44
+ else
45
+ exec 0<&-
46
+ fi
47
+ exec "$node_command" "$server_path" --helper 4<&-
48
+ } 3<&0 &
38
49
  exec 4<&-
39
50
  wait_helper
40
51
  fi
@@ -54,19 +65,43 @@ fi
54
65
 
55
66
  first_node=
56
67
  can_load_native() {
68
+ selected_node=$1
57
69
  if [ -z "$first_node" ]; then
58
70
  first_node=$1
59
71
  fi
60
- # Some managed macOS runtimes enforce library validation and cannot load the
61
- # plugin's addon. Check before starting a server or helper with side effects.
72
+ # Database helpers need SQLite. On macOS, library validation can also
73
+ # prevent a managed runtime from loading the plugin's addon.
62
74
  # Capture output without opening a writable file for read-only callers.
63
- _native_probe_output=$("$1" -e '
64
- if (process.platform === "darwin") {
75
+ if _native_probe_output=$("$1" -e '
76
+ if (process.platform === "linux") {
77
+ try { require("node:sqlite"); } catch { process.exitCode = 78; }
78
+ } else if (process.platform === "darwin") {
65
79
  require("node:sqlite");
66
80
  require(require("node:path").join(process.argv[1], "native",
67
81
  `${process.platform}-${process.arch}`, "unix.node"));
68
82
  }
69
- ' "$launcher_dir/../mcp" </dev/null 2>&1)
83
+ ' "$launcher_dir/../mcp" </dev/null 2>&1); then
84
+ return 0
85
+ elif [ "$?" -ne 78 ]; then
86
+ return 1
87
+ fi
88
+
89
+ # This Linux runtime can still run helpers without SQLite. Prefer a system
90
+ # installation if available, without expanding discovery into the caller's PATH.
91
+ for system_candidate in /usr/local/bin/node /usr/bin/node /bin/node; do
92
+ if [ -n "${_CODEX_SECURITY_SDK_NODE_SEARCH_PATH+x}" ]; then
93
+ case ":$_CODEX_SECURITY_SDK_NODE_SEARCH_PATH:" in
94
+ *":${system_candidate%/*}:"*) ;;
95
+ *) continue ;;
96
+ esac
97
+ fi
98
+ if [ -x "$system_candidate" ] &&
99
+ _native_probe_output=$("$system_candidate" -e 'require("node:sqlite")' </dev/null 2>&1); then
100
+ selected_node=$system_candidate
101
+ break
102
+ fi
103
+ done
104
+ return 0
70
105
  }
71
106
 
72
107
  for candidate in \
@@ -76,16 +111,20 @@ for candidate in \
76
111
  "$cache_root/codex-runtimes/codex-primary-runtime/dependencies/node/bin/node"
77
112
  do
78
113
  if [ -n "$candidate" ] && [ -x "$candidate" ] && can_load_native "$candidate"; then
79
- launch_node "$candidate" "$@"
114
+ launch_node "$selected_node" "$@"
80
115
  fi
81
116
  done
82
117
 
83
- remaining_path=$PATH
84
- while :; do
118
+ remaining_path=${PATH-}
119
+ if [ -n "${CODEX_SECURITY_PLUGIN_ROOT:-}" ] && [ -n "${_CODEX_SECURITY_SDK_NODE_SEARCH_PATH:-}" ]; then
120
+ # Only Node lookup uses the SDK-inspected fallback directories.
121
+ remaining_path=${remaining_path:+$remaining_path:}$_CODEX_SECURITY_SDK_NODE_SEARCH_PATH
122
+ fi
123
+ while [ -n "$remaining_path" ]; do
85
124
  path_entry=${remaining_path%%:*}
86
125
  node_path=${path_entry:-.}/node
87
126
  if [ -x "$node_path" ] && can_load_native "$node_path"; then
88
- launch_node "$node_path" "$@"
127
+ launch_node "$selected_node" "$@"
89
128
  fi
90
129
  case "$remaining_path" in
91
130
  *:*) remaining_path=${remaining_path#*:} ;;
@@ -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
@@ -14,6 +14,7 @@ from pathlib import Path, PurePosixPath
14
14
 
15
15
 
16
16
  def descriptor_relative_writes_available() -> bool:
17
+ """Return whether the platform supports the descriptor-relative operations used for writes."""
17
18
  # os.replace accepts src_dir_fd/dst_dir_fd wherever descriptor-relative
18
19
  # os.rename is supported, but Python lists only os.rename in supports_dir_fd.
19
20
  required_operations = (os.mkdir, os.open, os.rename, os.stat, os.unlink)
@@ -24,6 +25,7 @@ def descriptor_relative_writes_available() -> bool:
24
25
 
25
26
  @contextmanager
26
27
  def managed_fd(descriptor: int) -> Iterator[int]:
28
+ """Yield the descriptor and close it when the context exits, including on error."""
27
29
  try:
28
30
  yield descriptor
29
31
  finally:
@@ -34,6 +36,7 @@ def managed_fd(descriptor: int) -> Iterator[int]:
34
36
  def stage_file(
35
37
  parent_fd: int, filename: str, payload: bytes, owner_read_write: bool
36
38
  ) -> Iterator[int]:
39
+ """Yield a synced file descriptor for a new staging entry, removing the entry on exit if it still matches."""
37
40
  descriptor = os.open(filename, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600, dir_fd=parent_fd)
38
41
  try:
39
42
  with os.fdopen(descriptor, "wb", closefd=False) as handle:
@@ -56,6 +59,7 @@ def stage_file(
56
59
 
57
60
 
58
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."""
59
63
  import ctypes
60
64
 
61
65
  libc = ctypes.CDLL(None, use_errno=True)
@@ -80,6 +84,28 @@ def _rename_exclusive(parent_fd: int, source: str, destination: str) -> None:
80
84
  if rename(parent_fd, os.fsencode(source), parent_fd, os.fsencode(destination), flag) == 0:
81
85
  return
82
86
  code = ctypes.get_errno()
87
+ elif sys.platform == "linux":
88
+ import sysconfig
89
+
90
+ # musl omits the renameat2 wrapper. Select the syscall for the Python
91
+ # process's ABI, which can differ from the host kernel's architecture.
92
+ arch = (sysconfig.get_config_var("MULTIARCH") or "").partition("-")[0]
93
+ number = {"x86_64": 316, "aarch64": 276}.get(arch)
94
+ syscall = getattr(libc, "syscall", None)
95
+ if number is not None and ctypes.sizeof(ctypes.c_void_p) == 8 and syscall is not None:
96
+ syscall.argtypes = [ctypes.c_long]
97
+ syscall.restype = ctypes.c_long
98
+ result = syscall(
99
+ number,
100
+ ctypes.c_long(parent_fd),
101
+ ctypes.c_char_p(os.fsencode(source)),
102
+ ctypes.c_long(parent_fd),
103
+ ctypes.c_char_p(os.fsencode(destination)),
104
+ ctypes.c_long(flag),
105
+ )
106
+ if result == 0:
107
+ return
108
+ code = ctypes.get_errno()
83
109
  detail = os.strerror(code)
84
110
  if code in {errno.ENOSYS, errno.ENOTSUP, errno.EOPNOTSUPP, errno.EINVAL}:
85
111
  detail = f"cannot publish a new file atomically without hard links or exclusive rename ({detail})"
@@ -87,6 +113,7 @@ def _rename_exclusive(parent_fd: int, source: str, destination: str) -> None:
87
113
 
88
114
 
89
115
  def publish_new_file(parent_fd: int, source: str, destination: str) -> None:
116
+ """Publish the staged name without overwriting the destination, using an exclusive rename if linking is unavailable."""
90
117
  try:
91
118
  os.link(
92
119
  source, destination, src_dir_fd=parent_fd, dst_dir_fd=parent_fd, follow_symlinks=False
@@ -118,6 +145,12 @@ def stage_write(
118
145
  check_parent: Callable[[Path], None],
119
146
  contract_error: type[ValueError],
120
147
  ) -> Iterator[Callable[..., tuple[os.stat_result, int]]]:
148
+ """Stage payload under the open parent directory and yield a callable that publishes it.
149
+
150
+ Call the publisher inside the context. It returns file metadata and the
151
+ change time in nanoseconds. With compare_existing, matching bytes can
152
+ reuse an existing file when replacements are allowed.
153
+ """
121
154
  name = PurePosixPath(relative_path).name
122
155
  # Stage through the held parent so a replacement path cannot redirect the write.
123
156
  try:
@@ -157,7 +190,10 @@ def stage_write(
157
190
  if matches:
158
191
  yield lambda _directory=None: (opened, opened.st_ctime_ns)
159
192
  return
160
- candidate = f".{name}.{secrets.token_hex(8)}.tmp"
193
+ # A valid destination may already occupy the filesystem's entire name limit.
194
+ candidate = f".{secrets.token_hex(8)}.tmp"
195
+ if name.casefold() == candidate:
196
+ candidate = "." + candidate
161
197
 
162
198
  with stage_file(parent_fd, candidate, payload, owner_read_write) as staged_fd:
163
199
  staged = os.fstat(staged_fd)
@@ -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
+ }