@openai/codex-security 0.9.1 → 0.10.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 (444) hide show
  1. package/README.md +37 -788
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +3 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  5. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  6. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  7. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  12. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  13. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  14. package/_bundled_plugin/references/access-advisory.md +1 -1
  15. package/_bundled_plugin/references/artifact-storage.md +1 -1
  16. package/_bundled_plugin/references/baseline-auditor.md +18 -0
  17. package/_bundled_plugin/references/core-scan.md +5 -42
  18. package/_bundled_plugin/references/final-report.md +1 -1
  19. package/_bundled_plugin/references/focused-investigator.md +13 -0
  20. package/_bundled_plugin/references/scan-prologue.md +2 -2
  21. package/_bundled_plugin/references/scan-runtime.md +4 -2
  22. package/_bundled_plugin/references/security-guidance.md +14 -1
  23. package/_bundled_plugin/references/threat-model.md +1 -0
  24. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  25. package/_bundled_plugin/scripts/deep_scan_workbench.py +30 -12
  26. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  27. package/_bundled_plugin/scripts/finalize_scan_contract.py +47 -9
  28. package/_bundled_plugin/scripts/launch_codex_security_mcp +54 -16
  29. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +2 -0
  30. package/_bundled_plugin/scripts/posix_scan_local_files.py +26 -1
  31. package/_bundled_plugin/scripts/snapshot_sqlite.py +8 -2
  32. package/_bundled_plugin/scripts/windows_scan_local_files.py +216 -25
  33. package/_bundled_plugin/scripts/workbench/handoff.py +55 -25
  34. package/_bundled_plugin/scripts/workbench/storage.py +25 -5
  35. package/_bundled_plugin/scripts/workbench_cli.py +24 -2
  36. package/_bundled_plugin/scripts/workbench_constants.py +2 -0
  37. package/_bundled_plugin/scripts/workbench_db.py +257 -268
  38. package/_bundled_plugin/scripts/workbench_feedback.py +49 -4
  39. package/_bundled_plugin/scripts/workbench_native_indexes.py +226 -29
  40. package/_bundled_plugin/scripts/workbench_progress.py +159 -3
  41. package/_bundled_plugin/scripts/workbench_publication.py +2 -3
  42. package/_bundled_plugin/scripts/workbench_remediation.py +142 -2
  43. package/_bundled_plugin/scripts/workbench_saved_results.py +48 -8
  44. package/_bundled_plugin/scripts/workbench_scan_history.py +291 -134
  45. package/_bundled_plugin/scripts/workbench_scan_start.py +208 -11
  46. package/_bundled_plugin/scripts/workbench_scan_usage.py +36 -10
  47. package/_bundled_plugin/scripts/workbench_schema.py +220 -14
  48. package/_bundled_plugin/scripts/workbench_setup.py +1 -1
  49. package/_bundled_plugin/scripts/workbench_source_scopes.py +8 -0
  50. package/_bundled_plugin/scripts/workbench_target.py +486 -85
  51. package/_bundled_plugin/scripts/workbench_target_state.py +1108 -22
  52. package/_bundled_plugin/shared/workbench-history-repairs.json +64 -14
  53. package/_bundled_plugin/shared/workbench-migrations.json +66 -0
  54. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +4 -2
  55. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +2 -2
  56. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -0
  57. package/_bundled_plugin/skills/publish-findings/SKILL.md +26 -160
  58. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  59. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +2 -2
  60. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +3 -58
  61. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  62. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  63. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  64. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  65. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  66. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  67. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  68. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  69. package/bin/codex-security.mjs +2 -2
  70. package/dist/api.d.ts +7 -1
  71. package/dist/api.d.ts.map +1 -1
  72. package/dist/api.js +459 -157
  73. package/dist/api.js.map +1 -1
  74. package/dist/armorcode-findings.d.ts +9 -0
  75. package/dist/armorcode-findings.d.ts.map +1 -0
  76. package/dist/armorcode-findings.js +145 -0
  77. package/dist/armorcode-findings.js.map +1 -0
  78. package/dist/artifact-export.d.ts +2 -0
  79. package/dist/artifact-export.d.ts.map +1 -1
  80. package/dist/artifact-export.js +29 -13
  81. package/dist/artifact-export.js.map +1 -1
  82. package/dist/auth.d.ts +6 -2
  83. package/dist/auth.d.ts.map +1 -1
  84. package/dist/auth.js +33 -12
  85. package/dist/auth.js.map +1 -1
  86. package/dist/batch-cost.d.ts +18 -0
  87. package/dist/batch-cost.d.ts.map +1 -0
  88. package/dist/batch-cost.js +41 -0
  89. package/dist/batch-cost.js.map +1 -0
  90. package/dist/blackduck-findings.d.ts +1 -1
  91. package/dist/blackduck-findings.d.ts.map +1 -1
  92. package/dist/blackduck-findings.js +5 -18
  93. package/dist/blackduck-findings.js.map +1 -1
  94. package/dist/bundled-plugin.d.ts +4 -0
  95. package/dist/bundled-plugin.d.ts.map +1 -0
  96. package/dist/bundled-plugin.js +23 -0
  97. package/dist/bundled-plugin.js.map +1 -0
  98. package/dist/classify-scan-severity.d.ts +1 -1
  99. package/dist/classify-scan-severity.d.ts.map +1 -1
  100. package/dist/classify-scan-severity.js +11 -3
  101. package/dist/classify-scan-severity.js.map +1 -1
  102. package/dist/classify-severity-diagnostics.d.ts +10 -0
  103. package/dist/classify-severity-diagnostics.d.ts.map +1 -0
  104. package/dist/classify-severity-diagnostics.js +57 -0
  105. package/dist/classify-severity-diagnostics.js.map +1 -0
  106. package/dist/classify-severity-records.d.ts +4 -0
  107. package/dist/classify-severity-records.d.ts.map +1 -1
  108. package/dist/classify-severity-records.js +35 -8
  109. package/dist/classify-severity-records.js.map +1 -1
  110. package/dist/classify-severity.d.ts.map +1 -1
  111. package/dist/classify-severity.js +9 -6
  112. package/dist/classify-severity.js.map +1 -1
  113. package/dist/cli-argument.d.ts +4 -0
  114. package/dist/cli-argument.d.ts.map +1 -0
  115. package/dist/cli-argument.js +17 -0
  116. package/dist/cli-argument.js.map +1 -0
  117. package/dist/cli-help.d.ts +1 -1
  118. package/dist/cli-help.d.ts.map +1 -1
  119. package/dist/cli-help.js +71 -29
  120. package/dist/cli-help.js.map +1 -1
  121. package/dist/cli-hook.d.ts +3 -0
  122. package/dist/cli-hook.d.ts.map +1 -0
  123. package/dist/cli-hook.js +87 -0
  124. package/dist/cli-hook.js.map +1 -0
  125. package/dist/cli-integrations.d.ts +13 -0
  126. package/dist/cli-integrations.d.ts.map +1 -0
  127. package/dist/cli-integrations.js +333 -0
  128. package/dist/cli-integrations.js.map +1 -0
  129. package/dist/cli-mcp.d.ts +15 -0
  130. package/dist/cli-mcp.d.ts.map +1 -0
  131. package/dist/cli-mcp.js +178 -0
  132. package/dist/cli-mcp.js.map +1 -0
  133. package/dist/cli-token-view.d.ts +10 -0
  134. package/dist/cli-token-view.d.ts.map +1 -0
  135. package/dist/cli-token-view.js +41 -0
  136. package/dist/cli-token-view.js.map +1 -0
  137. package/dist/cli.d.ts +8 -3
  138. package/dist/cli.d.ts.map +1 -1
  139. package/dist/cli.js +1860 -903
  140. package/dist/cli.js.map +1 -1
  141. package/dist/cloud-publish.d.ts.map +1 -1
  142. package/dist/cloud-publish.js +33 -31
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/codex-sdk-environment.d.ts +6 -0
  145. package/dist/codex-sdk-environment.d.ts.map +1 -1
  146. package/dist/codex-sdk-environment.js +19 -0
  147. package/dist/codex-sdk-environment.js.map +1 -1
  148. package/dist/command-words.d.ts +3 -0
  149. package/dist/command-words.d.ts.map +1 -0
  150. package/dist/command-words.js +46 -0
  151. package/dist/command-words.js.map +1 -0
  152. package/dist/component-plan.d.ts.map +1 -1
  153. package/dist/component-plan.js +3 -3
  154. package/dist/component-plan.js.map +1 -1
  155. package/dist/component-scan.d.ts +3 -1
  156. package/dist/component-scan.d.ts.map +1 -1
  157. package/dist/component-scan.js +40 -7
  158. package/dist/component-scan.js.map +1 -1
  159. package/dist/config.d.ts +1 -1
  160. package/dist/config.d.ts.map +1 -1
  161. package/dist/config.js +30 -1
  162. package/dist/config.js.map +1 -1
  163. package/dist/continuum-aws.d.ts +6 -0
  164. package/dist/continuum-aws.d.ts.map +1 -0
  165. package/dist/continuum-aws.js +202 -0
  166. package/dist/continuum-aws.js.map +1 -0
  167. package/dist/continuum-collector.d.ts +44 -0
  168. package/dist/continuum-collector.d.ts.map +1 -0
  169. package/dist/continuum-collector.js +266 -0
  170. package/dist/continuum-collector.js.map +1 -0
  171. package/dist/continuum-findings.d.ts +31 -2
  172. package/dist/continuum-findings.d.ts.map +1 -1
  173. package/dist/continuum-findings.js +497 -59
  174. package/dist/continuum-findings.js.map +1 -1
  175. package/dist/contract.d.ts +1 -0
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +3 -0
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost.d.ts.map +1 -1
  180. package/dist/cost.js +1 -45
  181. package/dist/cost.js.map +1 -1
  182. package/dist/crowdstrike-findings.d.ts +7 -0
  183. package/dist/crowdstrike-findings.d.ts.map +1 -0
  184. package/dist/crowdstrike-findings.js +210 -0
  185. package/dist/crowdstrike-findings.js.map +1 -0
  186. package/dist/custom-validation-prompt.d.ts +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +29 -19
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/deduplication/local.d.ts +3 -1
  191. package/dist/deduplication/local.d.ts.map +1 -1
  192. package/dist/deduplication/local.js +8 -1
  193. package/dist/deduplication/local.js.map +1 -1
  194. package/dist/deduplication/refusal.d.ts.map +1 -1
  195. package/dist/deduplication/refusal.js +2 -1
  196. package/dist/deduplication/refusal.js.map +1 -1
  197. package/dist/deduplication/scan.d.ts +2 -0
  198. package/dist/deduplication/scan.d.ts.map +1 -1
  199. package/dist/deduplication/scan.js +24 -7
  200. package/dist/deduplication/scan.js.map +1 -1
  201. package/dist/deep-scan.d.ts.map +1 -1
  202. package/dist/deep-scan.js +16 -15
  203. package/dist/deep-scan.js.map +1 -1
  204. package/dist/endor-findings.d.ts +2 -2
  205. package/dist/endor-findings.d.ts.map +1 -1
  206. package/dist/endor-findings.js +6 -23
  207. package/dist/endor-findings.js.map +1 -1
  208. package/dist/errors.d.ts +3 -1
  209. package/dist/errors.d.ts.map +1 -1
  210. package/dist/errors.js +7 -3
  211. package/dist/errors.js.map +1 -1
  212. package/dist/executable-path.d.ts +3 -0
  213. package/dist/executable-path.d.ts.map +1 -1
  214. package/dist/executable-path.js +26 -0
  215. package/dist/executable-path.js.map +1 -1
  216. package/dist/external-findings-import.d.ts.map +1 -1
  217. package/dist/external-findings-import.js +12 -1
  218. package/dist/external-findings-import.js.map +1 -1
  219. package/dist/external-findings-local.d.ts +66 -4
  220. package/dist/external-findings-local.d.ts.map +1 -1
  221. package/dist/external-findings-local.js +258 -59
  222. package/dist/external-findings-local.js.map +1 -1
  223. package/dist/external-findings-publish.d.ts +6 -1
  224. package/dist/external-findings-publish.d.ts.map +1 -1
  225. package/dist/external-findings-publish.js +330 -1633
  226. package/dist/external-findings-publish.js.map +1 -1
  227. package/dist/external-findings-read.d.ts +11 -2
  228. package/dist/external-findings-read.d.ts.map +1 -1
  229. package/dist/external-findings-read.js +56 -53
  230. package/dist/external-findings-read.js.map +1 -1
  231. package/dist/external-findings.d.ts +1 -1
  232. package/dist/external-findings.d.ts.map +1 -1
  233. package/dist/external-findings.js +12 -1
  234. package/dist/external-findings.js.map +1 -1
  235. package/dist/external-import-contract.d.ts +6 -11
  236. package/dist/external-import-contract.d.ts.map +1 -1
  237. package/dist/external-import-contract.js +35 -177
  238. package/dist/external-import-contract.js.map +1 -1
  239. package/dist/external-import-models.d.ts +1 -1
  240. package/dist/external-import-models.d.ts.map +1 -1
  241. package/dist/external-import-models.js.map +1 -1
  242. package/dist/finding-prompt.d.ts.map +1 -1
  243. package/dist/finding-prompt.js +2 -2
  244. package/dist/finding-prompt.js.map +1 -1
  245. package/dist/github-dependabot-findings.d.ts.map +1 -1
  246. package/dist/github-dependabot-findings.js +3 -4
  247. package/dist/github-dependabot-findings.js.map +1 -1
  248. package/dist/github-findings.d.ts.map +1 -1
  249. package/dist/github-findings.js +19 -287
  250. package/dist/github-findings.js.map +1 -1
  251. package/dist/host-protocol.d.ts +6 -0
  252. package/dist/host-protocol.d.ts.map +1 -1
  253. package/dist/host-protocol.js +11 -1
  254. package/dist/host-protocol.js.map +1 -1
  255. package/dist/host-records-protocol.d.ts +2 -0
  256. package/dist/host-records-protocol.d.ts.map +1 -1
  257. package/dist/host-records-protocol.js +4 -0
  258. package/dist/host-records-protocol.js.map +1 -1
  259. package/dist/hosted-remediation.d.ts +1 -0
  260. package/dist/hosted-remediation.d.ts.map +1 -1
  261. package/dist/hosted-remediation.js +23 -3
  262. package/dist/hosted-remediation.js.map +1 -1
  263. package/dist/index.d.ts +5 -3
  264. package/dist/index.d.ts.map +1 -1
  265. package/dist/index.js +3 -1
  266. package/dist/index.js.map +1 -1
  267. package/dist/inspector-findings.d.ts.map +1 -1
  268. package/dist/inspector-findings.js +19 -35
  269. package/dist/inspector-findings.js.map +1 -1
  270. package/dist/knowledge-base.d.ts +1 -1
  271. package/dist/knowledge-base.d.ts.map +1 -1
  272. package/dist/knowledge-base.js +34 -27
  273. package/dist/knowledge-base.js.map +1 -1
  274. package/dist/linear.d.ts +11 -0
  275. package/dist/linear.d.ts.map +1 -1
  276. package/dist/linear.js.map +1 -1
  277. package/dist/local-git-metadata.d.ts +5 -2
  278. package/dist/local-git-metadata.d.ts.map +1 -1
  279. package/dist/local-git-metadata.js +8 -4
  280. package/dist/local-git-metadata.js.map +1 -1
  281. package/dist/multiscan.d.ts +4 -0
  282. package/dist/multiscan.d.ts.map +1 -1
  283. package/dist/multiscan.js +83 -39
  284. package/dist/multiscan.js.map +1 -1
  285. package/dist/opengrep-findings.d.ts +4 -2
  286. package/dist/opengrep-findings.d.ts.map +1 -1
  287. package/dist/opengrep-findings.js +39 -22
  288. package/dist/opengrep-findings.js.map +1 -1
  289. package/dist/private-finding-import.d.ts +8 -13
  290. package/dist/private-finding-import.d.ts.map +1 -1
  291. package/dist/private-finding-import.js +69 -129
  292. package/dist/private-finding-import.js.map +1 -1
  293. package/dist/project-config-schema.d.ts +2 -0
  294. package/dist/project-config-schema.d.ts.map +1 -1
  295. package/dist/project-config-schema.js +1 -0
  296. package/dist/project-config-schema.js.map +1 -1
  297. package/dist/project-config.d.ts +1 -0
  298. package/dist/project-config.d.ts.map +1 -1
  299. package/dist/project-config.js +56 -13
  300. package/dist/project-config.js.map +1 -1
  301. package/dist/prompt-files.d.ts +7 -2
  302. package/dist/prompt-files.d.ts.map +1 -1
  303. package/dist/prompt-files.js +42 -20
  304. package/dist/prompt-files.js.map +1 -1
  305. package/dist/provider-profile.d.ts.map +1 -1
  306. package/dist/provider-profile.js +4 -9
  307. package/dist/provider-profile.js.map +1 -1
  308. package/dist/publication.d.ts +1 -1
  309. package/dist/publication.d.ts.map +1 -1
  310. package/dist/publication.js.map +1 -1
  311. package/dist/record.d.ts +1 -5
  312. package/dist/record.d.ts.map +1 -1
  313. package/dist/record.js +3 -51
  314. package/dist/record.js.map +1 -1
  315. package/dist/remediation.d.ts.map +1 -1
  316. package/dist/remediation.js +3 -1
  317. package/dist/remediation.js.map +1 -1
  318. package/dist/runtime.d.ts +35 -7
  319. package/dist/runtime.d.ts.map +1 -1
  320. package/dist/runtime.js +782 -153
  321. package/dist/runtime.js.map +1 -1
  322. package/dist/saved-scan-bootstrap.d.ts +6 -1
  323. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  324. package/dist/saved-scan-bootstrap.js +267 -115
  325. package/dist/saved-scan-bootstrap.js.map +1 -1
  326. package/dist/scan-archive-path.d.ts +2 -0
  327. package/dist/scan-archive-path.d.ts.map +1 -0
  328. package/dist/scan-archive-path.js +5 -0
  329. package/dist/scan-archive-path.js.map +1 -0
  330. package/dist/scan-comparison.d.ts +20 -2
  331. package/dist/scan-comparison.d.ts.map +1 -1
  332. package/dist/scan-comparison.js +26 -5
  333. package/dist/scan-comparison.js.map +1 -1
  334. package/dist/scan-dashboard.d.ts +1 -0
  335. package/dist/scan-dashboard.d.ts.map +1 -1
  336. package/dist/scan-dashboard.js +18 -2
  337. package/dist/scan-dashboard.js.map +1 -1
  338. package/dist/scan-executor.d.ts.map +1 -1
  339. package/dist/scan-executor.js +4 -2
  340. package/dist/scan-executor.js.map +1 -1
  341. package/dist/scan-history-renderer.d.ts +1 -0
  342. package/dist/scan-history-renderer.d.ts.map +1 -1
  343. package/dist/scan-history-renderer.js +25 -9
  344. package/dist/scan-history-renderer.js.map +1 -1
  345. package/dist/scan-logs.d.ts.map +1 -1
  346. package/dist/scan-logs.js +28 -4
  347. package/dist/scan-logs.js.map +1 -1
  348. package/dist/scan-settings.d.ts +1 -0
  349. package/dist/scan-settings.d.ts.map +1 -1
  350. package/dist/scan-settings.js +1 -0
  351. package/dist/scan-settings.js.map +1 -1
  352. package/dist/scanner-import.d.ts +5 -11
  353. package/dist/scanner-import.d.ts.map +1 -1
  354. package/dist/scanner-import.js +16 -89
  355. package/dist/scanner-import.js.map +1 -1
  356. package/dist/security-policy.d.ts.map +1 -1
  357. package/dist/security-policy.js +26 -6
  358. package/dist/security-policy.js.map +1 -1
  359. package/dist/semgrep-findings.d.ts.map +1 -1
  360. package/dist/semgrep-findings.js +14 -48
  361. package/dist/semgrep-findings.js.map +1 -1
  362. package/dist/semgrep-platform-findings.d.ts +20 -70
  363. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  364. package/dist/semgrep-platform-findings.js +116 -333
  365. package/dist/semgrep-platform-findings.js.map +1 -1
  366. package/dist/severity-review.d.ts.map +1 -1
  367. package/dist/severity-review.js +1 -0
  368. package/dist/severity-review.js.map +1 -1
  369. package/dist/snyk-findings.d.ts +2 -0
  370. package/dist/snyk-findings.d.ts.map +1 -1
  371. package/dist/snyk-findings.js +5 -8
  372. package/dist/snyk-findings.js.map +1 -1
  373. package/dist/snyk-rest-findings.d.ts +3 -20
  374. package/dist/snyk-rest-findings.d.ts.map +1 -1
  375. package/dist/snyk-rest-findings.js +45 -217
  376. package/dist/snyk-rest-findings.js.map +1 -1
  377. package/dist/sonar-findings.d.ts +1 -1
  378. package/dist/sonar-findings.d.ts.map +1 -1
  379. package/dist/sonar-findings.js +2 -4
  380. package/dist/sonar-findings.js.map +1 -1
  381. package/dist/sonar-import.d.ts +3 -0
  382. package/dist/sonar-import.d.ts.map +1 -1
  383. package/dist/sonar-import.js +28 -30
  384. package/dist/sonar-import.js.map +1 -1
  385. package/dist/stored-finding-projection.d.ts +6 -0
  386. package/dist/stored-finding-projection.d.ts.map +1 -0
  387. package/dist/stored-finding-projection.js +129 -0
  388. package/dist/stored-finding-projection.js.map +1 -0
  389. package/dist/stored-findings-publication.d.ts +23 -0
  390. package/dist/stored-findings-publication.d.ts.map +1 -0
  391. package/dist/stored-findings-publication.js +169 -0
  392. package/dist/stored-findings-publication.js.map +1 -0
  393. package/dist/targets.d.ts +8 -1
  394. package/dist/targets.d.ts.map +1 -1
  395. package/dist/targets.js +103 -23
  396. package/dist/targets.js.map +1 -1
  397. package/dist/tenable-findings.d.ts +1 -4
  398. package/dist/tenable-findings.d.ts.map +1 -1
  399. package/dist/tenable-findings.js.map +1 -1
  400. package/dist/trivy-findings.d.ts.map +1 -1
  401. package/dist/trivy-findings.js +0 -11
  402. package/dist/trivy-findings.js.map +1 -1
  403. package/dist/trusted-executable.d.ts +7 -0
  404. package/dist/trusted-executable.d.ts.map +1 -1
  405. package/dist/trusted-executable.js +148 -37
  406. package/dist/trusted-executable.js.map +1 -1
  407. package/dist/value.js +3 -1
  408. package/dist/value.js.map +1 -1
  409. package/dist/veracode-findings.d.ts +1 -3
  410. package/dist/veracode-findings.d.ts.map +1 -1
  411. package/dist/veracode-findings.js +13 -38
  412. package/dist/veracode-findings.js.map +1 -1
  413. package/dist/version.d.ts +3 -1
  414. package/dist/version.d.ts.map +1 -1
  415. package/dist/version.js +184 -32
  416. package/dist/version.js.map +1 -1
  417. package/dist/wiz-findings.d.ts +2 -2
  418. package/dist/wiz-findings.d.ts.map +1 -1
  419. package/dist/wiz-findings.js +14 -92
  420. package/dist/wiz-findings.js.map +1 -1
  421. package/docs/classify-severity-records.md +30 -0
  422. package/docs/cli.md +537 -124
  423. package/docs/findings-service.md +22 -9
  424. package/docs/hosted-remediation.md +13 -4
  425. package/docs/sdk.md +918 -0
  426. package/package.json +15 -6
  427. package/schemas/external-findings.schema.json +2 -1
  428. package/schemas/project-config.schema.json +5 -0
  429. package/dist/hosted-scanner-v1.d.ts +0 -6
  430. package/dist/hosted-scanner-v1.d.ts.map +0 -1
  431. package/dist/hosted-scanner-v1.js +0 -60
  432. package/dist/hosted-scanner-v1.js.map +0 -1
  433. package/dist/reader-selection.d.ts +0 -15
  434. package/dist/reader-selection.d.ts.map +0 -1
  435. package/dist/reader-selection.js +0 -89
  436. package/dist/reader-selection.js.map +0 -1
  437. package/dist/semgrep-platform-v1.d.ts +0 -6
  438. package/dist/semgrep-platform-v1.d.ts.map +0 -1
  439. package/dist/semgrep-platform-v1.js +0 -83
  440. package/dist/semgrep-platform-v1.js.map +0 -1
  441. package/dist/snyk-rest-v1.d.ts +0 -28
  442. package/dist/snyk-rest-v1.d.ts.map +0 -1
  443. package/dist/snyk-rest-v1.js +0 -132
  444. package/dist/snyk-rest-v1.js.map +0 -1
package/dist/multiscan.js CHANGED
@@ -8,16 +8,17 @@ import { basename, dirname, isAbsolute, join, relative, resolve, sep, } from "no
8
8
  import { promisify } from "node:util";
9
9
  import Papa from "papaparse";
10
10
  import { ContractSchemaError, loadContract, readScanFile } from "./contract.js";
11
+ import { BatchCostPool, batchScanBudget } from "./batch-cost.js";
11
12
  import { deepScanOptions } from "./deep-config.js";
12
13
  import { readThreatModelPath } from "./artifact-export.js";
13
14
  import { OutputDirectoryNotEmptyError, errorMessage, ScanCostLimitExceededError, } from "./errors.js";
14
15
  import { readKnowledgeBaseSnapshot, } from "./knowledge-base.js";
15
16
  import { resolveScanPrompts } from "./prompt-files.js";
16
17
  import { canonicalConfigPath, createWindowsOutputDirectory, requireSecureOutputAncestry, requireWindowsOutputPath, resolvePluginPath, validateOutputDir, } from "./runtime.js";
17
- import { DiffTarget, UNSUPPORTED_GIT_ENVIRONMENT, } from "./targets.js";
18
+ import { DiffTarget, gitOutput, gitProtectionRoots, nullIfMissingPath, UNSUPPORTED_GIT_ENVIRONMENT, resolveTargetPath, } from "./targets.js";
18
19
  import { meetsSeverity, } from "./scan-settings.js";
19
20
  import { workflowDigest } from "./finding-workflow.js";
20
- import { resolveTrustedExecutable } from "./trusted-executable.js";
21
+ import { resolveTrustedExecutable, withProtectedExecutableRoots, } from "./trusted-executable.js";
21
22
  const execFile = promisify(execFileCallback);
22
23
  const CHECKOUT_MARKER = ".git/codex-security-campaign-attempt";
23
24
  const REQUIRED_ARTIFACTS = ["scan-manifest.json", "findings.json", "report.md"];
@@ -34,7 +35,7 @@ export async function runMultiscan(options) {
34
35
  if (!Number.isSafeInteger(options.maxAttempts) || options.maxAttempts < 1) {
35
36
  throw new Error("Multiscan max attempts must be a positive integer.");
36
37
  }
37
- const tasks = parseInventory(await readFile(options.inputPath, "utf8"), dirname(resolve(options.inputPath)), options.mode);
38
+ const tasks = parseInventory(await readFile(options.inputPath, "utf8"), dirname(resolveTargetPath(options.inputPath)), options.mode);
38
39
  for (const mode of new Set(tasks.map((task) => task.mode))) {
39
40
  deepScanOptions({ ...options.scanOptionsByMode?.[mode], mode });
40
41
  }
@@ -42,29 +43,21 @@ export async function runMultiscan(options) {
42
43
  options.scanOptionsByMode?.[task.mode]?.target instanceof DiffTarget)) {
43
44
  throw new Error("Bulk scans do not support diff or working-tree scopes because their checkouts are clean, shallow snapshots. Use repository or path scopes instead.");
44
45
  }
45
- const repositories = [];
46
- if ([
47
- [options.scanPrompt, options.scanPromptFile],
48
- [options.validationPrompt, options.validationPromptFile],
49
- [options.postScanPrompt, options.postScanPromptFile],
50
- ].some(([inline, file]) => inline === undefined && file !== undefined)) {
51
- for (const repository of new Set(tasks.map((task) => task.repository))) {
52
- if (!isAbsolute(repository))
53
- continue;
54
- try {
55
- repositories.push(await realpath(repository));
56
- }
57
- catch (error) {
58
- // Missing sources retain the campaign's per-repository failure behavior.
59
- const code = error.code;
60
- if (code !== "ENOENT" && code !== "ENOTDIR")
61
- throw error;
62
- }
63
- }
64
- }
65
- // Shared inputs use actual local CSV sources as directory-link boundaries,
66
- // not the invocation directory, and are read once before any scan starts.
67
- const prompts = await resolveScanPrompts(options, repositories);
46
+ // Direct input paths need no source discovery. Prompts and knowledge share the result.
47
+ let pendingRoots;
48
+ const documentRoots = () => (pendingRoots ??= bulkDocumentRoots(tasks, options.signal));
49
+ const requestedOutput = resolve(options.outputDir);
50
+ const localSources = [
51
+ ...new Set(tasks.map((task) => task.repository).filter(isAbsolute)),
52
+ ];
53
+ const worktrees = await Promise.all(localSources.map((source) => gitProtectionRoots(source, options.signal)));
54
+ const executableRoots = (output) => [
55
+ ...localSources,
56
+ ...worktrees.flat(),
57
+ join(output, "checkouts"),
58
+ join(output, "recovery-checkouts"),
59
+ ];
60
+ const prompts = await resolveScanPrompts(options, () => withProtectedExecutableRoots(executableRoots(requestedOutput), documentRoots));
68
61
  const resolvedOptions = {
69
62
  ...options,
70
63
  ...prompts,
@@ -78,7 +71,6 @@ export async function runMultiscan(options) {
78
71
  tasks.some((task) => task.mode === "deep")) {
79
72
  throw new Error("Custom validation is not supported for Deep scans.");
80
73
  }
81
- const requestedOutput = resolve(options.outputDir);
82
74
  if (options.recoverScan !== undefined) {
83
75
  const manifest = await lstat(join(requestedOutput, "manifest.json")).catch(undefinedIfMissingFile);
84
76
  if (!manifest?.isFile())
@@ -97,7 +89,7 @@ export async function runMultiscan(options) {
97
89
  return await resolvePluginPath(options.config.pluginPath, pluginWorkspace ?? output, options.signal);
98
90
  })());
99
91
  try {
100
- const result = await runCampaign(resolvedOptions, tasks, output, resumePluginRoot);
92
+ const result = await withProtectedExecutableRoots(executableRoots(output), () => runCampaign(resolvedOptions, tasks, output, resumePluginRoot, documentRoots));
101
93
  return (await realpath(requestedOutput).catch(() => undefined)) === output
102
94
  ? { ...result, resultsPath: join(requestedOutput, "results.jsonl") }
103
95
  : result;
@@ -111,20 +103,49 @@ export async function runMultiscan(options) {
111
103
  ]);
112
104
  }
113
105
  }
114
- async function runCampaign(options, tasks, output, resumePluginRoot) {
106
+ async function bulkDocumentRoots(tasks, signal) {
107
+ const roots = [];
108
+ for (const repository of new Set(tasks.map((task) => task.repository))) {
109
+ if (!isAbsolute(repository))
110
+ continue;
111
+ const source = await realpath(repository).catch(nullIfMissingPath);
112
+ if (source === null) {
113
+ // Git also accepts an omitted .git suffix; wholly missing rows fail at checkout.
114
+ if (await lstat(repository + ".git").catch(nullIfMissingPath))
115
+ return null;
116
+ continue;
117
+ }
118
+ // Only an ordinary worktree and its own .git directory share one boundary.
119
+ const marker = await lstat(join(source, ".git")).catch(nullIfMissingPath);
120
+ if (!marker?.isDirectory())
121
+ return null;
122
+ const layout = await gitOutput(source, [
123
+ "rev-parse",
124
+ "--path-format=relative",
125
+ "--show-toplevel",
126
+ "--git-common-dir",
127
+ ], signal, undefined, source, "utf8", process.cwd()).catch(() => null);
128
+ signal?.throwIfAborted();
129
+ if (layout !== "./\n.git" && layout !== "./\r\n.git")
130
+ return null;
131
+ roots.push(source);
132
+ }
133
+ return roots;
134
+ }
135
+ async function runCampaign(options, tasks, output, resumePluginRoot, documentRoots) {
115
136
  const ledger = join(output, "results.jsonl");
116
137
  await ensureOutputDirectory(join(output, "checkouts"));
117
138
  await ensureOutputDirectory(join(output, "artifacts"));
118
139
  const knowledgeByMode = {};
119
140
  const sharedKnowledge = options.knowledgeBasePaths?.length
120
- ? readKnowledgeBaseSnapshot(options.knowledgeBasePaths, options.signal)
141
+ ? readKnowledgeBaseSnapshot(options.knowledgeBasePaths, options.signal, documentRoots)
121
142
  : undefined;
122
143
  for (const mode of new Set(tasks.map((task) => task.mode))) {
123
144
  try {
124
145
  const paths = options.scanOptionsByMode?.[mode]?.knowledgeBasePaths;
125
146
  const snapshot = await (sharedKnowledge ??
126
147
  (paths?.length
127
- ? readKnowledgeBaseSnapshot(paths, options.signal)
148
+ ? readKnowledgeBaseSnapshot(paths, options.signal, documentRoots)
128
149
  : undefined));
129
150
  if (snapshot !== undefined)
130
151
  knowledgeByMode[mode] = { snapshot };
@@ -135,7 +156,7 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
135
156
  }
136
157
  }
137
158
  await ensureManifest(join(output, "manifest.json"), tasks, options, knowledgeByMode);
138
- const receipts = await readReceipts(ledger, options.recoverScan !== undefined);
159
+ const receipts = await readReceipts(ledger, new Set(tasks.map((task) => task.id.toLowerCase())), options.recoverScan !== undefined);
139
160
  const pending = [];
140
161
  const rejectedCompleted = new Set();
141
162
  let completed = 0;
@@ -229,6 +250,9 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
229
250
  });
230
251
  if (pending.length === 0)
231
252
  return summarize();
253
+ const pool = options.maxTotalCostUsd === undefined
254
+ ? undefined
255
+ : new BatchCostPool(options.maxTotalCostUsd, pending.length * options.maxAttempts);
232
256
  let next = 0;
233
257
  let receiptTail = Promise.resolve();
234
258
  const worker = async (security) => {
@@ -238,6 +262,11 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
238
262
  if (task === undefined)
239
263
  return;
240
264
  const knowledge = knowledgeByMode[task.mode];
265
+ const scanSettings = options.scanOptionsByMode?.[task.mode];
266
+ const budget = batchScanBudget(pool?.share, {
267
+ ...options,
268
+ maxCostUsd: options.maxCostUsd ?? scanSettings?.maxCostUsd,
269
+ });
241
270
  const history = receipts.get(task.id.toLowerCase());
242
271
  let operationId = history?.scan?.operationId;
243
272
  let maxAttempt = history?.maxAttempt ?? 0;
@@ -275,9 +304,11 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
275
304
  let attemptPolicyFailed;
276
305
  let cost = null;
277
306
  let measurement = null;
307
+ let reservation;
278
308
  let savedUsage;
279
309
  const observers = {
280
310
  onMeasurement: (value) => {
311
+ reservation?.record(value.cost);
281
312
  measurement = value;
282
313
  cost = value.cost;
283
314
  },
@@ -291,6 +322,8 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
291
322
  let knowledgeBaseFailure = false;
292
323
  let checkoutOccupied = false;
293
324
  try {
325
+ reservation = pool?.reserve(budget.maxCostUsd);
326
+ const maxCostUsd = reservation?.maxCostUsd ?? budget.maxCostUsd;
294
327
  await ensureOutputDirectory(artifactRoot);
295
328
  let result;
296
329
  if (options.recoverScan !== undefined &&
@@ -313,6 +346,7 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
313
346
  repository: task.id,
314
347
  attempt,
315
348
  status: "started",
349
+ maxCostUsd,
316
350
  });
317
351
  if (knowledge?.failure !== undefined) {
318
352
  knowledgeBaseFailure = true;
@@ -320,6 +354,9 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
320
354
  }
321
355
  result = await options.recoverScan(scanDir, {
322
356
  ...options,
357
+ ...(options.maxTotalCostUsd === undefined
358
+ ? {}
359
+ : { maxTotalCostShareUsd: maxCostUsd }),
323
360
  knowledgeBaseSnapshot: knowledge?.snapshot,
324
361
  ...observers,
325
362
  ...(operationId === undefined
@@ -329,7 +366,6 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
329
366
  attemptedResume = result !== undefined;
330
367
  }
331
368
  }
332
- const scanSettings = options.scanOptionsByMode?.[task.mode];
333
369
  if (result === undefined) {
334
370
  if (options.recoverScan !== undefined)
335
371
  attempt = nextAttempt();
@@ -338,6 +374,7 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
338
374
  repository: task.id,
339
375
  attempt,
340
376
  status: "started",
377
+ maxCostUsd,
341
378
  });
342
379
  if (options.recoverScan === undefined)
343
380
  await validateOutputDir(scanDir);
@@ -407,9 +444,8 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
407
444
  ...(options.postScanPrompt === undefined
408
445
  ? {}
409
446
  : { postScanPrompt: options.postScanPrompt }),
410
- ...(options.maxCostUsd === undefined
411
- ? {}
412
- : { maxCostUsd: options.maxCostUsd }),
447
+ ...budget,
448
+ maxCostUsd,
413
449
  ...observers,
414
450
  onWarning: (warning) => {
415
451
  runWarnings.push(warning);
@@ -427,6 +463,8 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
427
463
  }
428
464
  threatModelPath = result.threatModelPath;
429
465
  cost = result.cost;
466
+ if (!result.alreadyCompleted)
467
+ reservation?.record(cost);
430
468
  savedUsage = result.usage;
431
469
  const failureSeverity = scanSettings?.failureSeverity;
432
470
  if (failureSeverity !== undefined) {
@@ -441,8 +479,11 @@ async function runCampaign(options, tasks, output, resumePluginRoot) {
441
479
  // Recovery retains its resumable attempt and checkout; SDK telemetry records cancellation.
442
480
  if (options.signal?.aborted && options.recoverScan !== undefined)
443
481
  options.signal.throwIfAborted();
482
+ if (pool && !reservation)
483
+ exhaustedBudget = true;
444
484
  if (error instanceof ScanCostLimitExceededError) {
445
485
  cost = error.cost;
486
+ reservation?.record(cost);
446
487
  exhaustedBudget = true;
447
488
  }
448
489
  requiresRecovery = error instanceof OutputDirectoryNotEmptyError;
@@ -857,7 +898,7 @@ async function ensureManifest(path, tasks, options, knowledgeByMode) {
857
898
  }
858
899
  }
859
900
  }
860
- async function readReceipts(path, preserveInterrupted = false) {
901
+ async function readReceipts(path, campaignIds, preserveInterrupted = false) {
861
902
  let contents;
862
903
  try {
863
904
  contents = await readFile(path);
@@ -878,6 +919,8 @@ async function readReceipts(path, preserveInterrupted = false) {
878
919
  saved = JSON.parse(line);
879
920
  if (typeof saved?.id !== "string")
880
921
  throw new Error("Expected a receipt with a string id");
922
+ if (!campaignIds.has(saved.id.toLowerCase()))
923
+ throw new Error("Receipt task id is absent from the campaign manifest");
881
924
  if (!Number.isSafeInteger(saved.attempt) || saved.attempt < 1)
882
925
  throw new Error("Expected a positive integer receipt attempt");
883
926
  }
@@ -985,9 +1028,10 @@ function parseInventory(source, directory, defaultMode) {
985
1028
  scope.includes("\0"))) {
986
1029
  throw new Error("Multiscan scope must stay inside its repository.");
987
1030
  }
1031
+ const repository = normalizeRepository(get("repository"), directory);
988
1032
  return {
989
1033
  id,
990
- repository: normalizeRepository(get("repository"), directory),
1034
+ repository,
991
1035
  revision,
992
1036
  mode: mode,
993
1037
  ...(scope ? { scope } : {}),
@@ -1002,7 +1046,7 @@ function normalizeRepository(repository, directory) {
1002
1046
  if (/^[^@\s/:]+@[^:\s/]+:.+$/u.test(repository))
1003
1047
  return repository;
1004
1048
  if (!repository.includes("://")) {
1005
- const path = resolve(directory, repository);
1049
+ const path = resolveTargetPath(repository, directory);
1006
1050
  if (process.platform !== "win32")
1007
1051
  return path;
1008
1052
  try {