@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
@@ -1,51 +0,0 @@
1
- import { CodexSecurityError } from "./errors.js";
2
- const flag = "CODEX_SECURITY_ENABLE_EXTERNAL_IMPORTS";
3
- export const externalImportsDisabledMessage = `External findings imports are disabled. Set ${flag}=1 to enable them.`;
4
- function externalImportSetting(environment) {
5
- const exact = environment[flag];
6
- if (process.platform !== "win32")
7
- return { key: flag, value: exact };
8
- // A scan can override a case-insensitive process.env with its own spelling.
9
- function callerDeclares(key) {
10
- for (let owner = environment; owner && owner !== process.env; owner = Object.getPrototypeOf(owner)) {
11
- if (Object.hasOwn(owner, key))
12
- return true;
13
- }
14
- return false;
15
- }
16
- if (exact !== undefined && callerDeclares(flag))
17
- return { key: flag, value: exact };
18
- // Node includes enumerable prototype keys and sorts competing spellings.
19
- const keys = [];
20
- for (const name in environment) {
21
- if (name.toUpperCase() === flag)
22
- keys.push(name);
23
- }
24
- keys.sort();
25
- const key = keys.find(callerDeclares) ?? keys[0];
26
- if (key !== undefined)
27
- return { key, value: key === flag ? exact : environment[key] };
28
- }
29
- export function externalImportsEnabled(environment = process.env) {
30
- return externalImportSetting(environment)?.value === "1";
31
- }
32
- /** Preserve the selected flag while copying a caller's environment for a child. */
33
- export function forwardExternalImportSetting(source, child) {
34
- const selected = externalImportSetting(source);
35
- if (selected === undefined)
36
- return;
37
- if (process.platform === "win32") {
38
- for (const name of Object.keys(child)) {
39
- if (name !== selected.key && name.toUpperCase() === flag)
40
- delete child[name];
41
- }
42
- }
43
- if (selected.value !== undefined)
44
- child[selected.key] = selected.value;
45
- }
46
- export function requireExternalImports(environment) {
47
- if (!externalImportsEnabled(environment)) {
48
- throw new CodexSecurityError(externalImportsDisabledMessage);
49
- }
50
- }
51
- //# sourceMappingURL=external-imports-feature.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"external-imports-feature.js","sourceRoot":"","sources":["../src/external-imports-feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,IAAI,GAAG,wCAAwC,CAAC;AACtD,MAAM,CAAC,MAAM,8BAA8B,GAAG,+CAA+C,IAAI,oBAAoB,CAAC;AAEtH,SAAS,qBAAqB,CAAQ,WAAkC;IACtE,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACrE,4EAA4E;IAC5E,SAAS,cAAc,CAAC,GAAW;QACjC,KACE,IAAI,KAAK,GAAkB,WAAW,EACtC,KAAK,IAAI,KAAK,KAAK,OAAO,CAAC,GAAG,EAC9B,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EACpC,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC7C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,IAAI,cAAc,CAAC,IAAI,CAAC;QAC7C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACrC,yEAAyE;IACzE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;IACZ,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,GAAG,KAAK,SAAS;QACnB,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,WAAW,GAAsB,OAAO,CAAC,GAAG;IAE5C,OAAO,qBAAqB,CAAC,WAAW,CAAC,EAAE,KAAK,KAAK,GAAG,CAAC;AAC3D,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,4BAA4B,CAC1C,MAAyC,EACzC,KAA4B;IAE5B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,IAAI,IAAI,KAAK,QAAQ,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI;gBACtD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAA+B;IACpE,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,kBAAkB,CAAC,8BAA8B,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\n\nconst flag = \"CODEX_SECURITY_ENABLE_EXTERNAL_IMPORTS\";\nexport const externalImportsDisabledMessage = `External findings imports are disabled. Set ${flag}=1 to enable them.`;\n\nfunction externalImportSetting<Value>(environment: Record<string, Value>) {\n const exact = environment[flag];\n if (process.platform !== \"win32\") return { key: flag, value: exact };\n // A scan can override a case-insensitive process.env with its own spelling.\n function callerDeclares(key: string): boolean {\n for (\n let owner: object | null = environment;\n owner && owner !== process.env;\n owner = Object.getPrototypeOf(owner)\n ) {\n if (Object.hasOwn(owner, key)) return true;\n }\n return false;\n }\n if (exact !== undefined && callerDeclares(flag))\n return { key: flag, value: exact };\n // Node includes enumerable prototype keys and sorts competing spellings.\n const keys: string[] = [];\n for (const name in environment) {\n if (name.toUpperCase() === flag) keys.push(name);\n }\n keys.sort();\n const key = keys.find(callerDeclares) ?? keys[0];\n if (key !== undefined)\n return { key, value: key === flag ? exact : environment[key] };\n}\n\nexport function externalImportsEnabled(\n environment: NodeJS.ProcessEnv = process.env,\n): boolean {\n return externalImportSetting(environment)?.value === \"1\";\n}\n\n/** Preserve the selected flag while copying a caller's environment for a child. */\nexport function forwardExternalImportSetting<Value>(\n source: Record<string, Value | undefined>,\n child: Record<string, Value>,\n): void {\n const selected = externalImportSetting(source);\n if (selected === undefined) return;\n if (process.platform === \"win32\") {\n for (const name of Object.keys(child)) {\n if (name !== selected.key && name.toUpperCase() === flag)\n delete child[name];\n }\n }\n if (selected.value !== undefined) child[selected.key] = selected.value;\n}\n\nexport function requireExternalImports(environment?: NodeJS.ProcessEnv): void {\n if (!externalImportsEnabled(environment)) {\n throw new CodexSecurityError(externalImportsDisabledMessage);\n }\n}\n"]}
@@ -1,5 +0,0 @@
1
- type JsonObject = Record<string, unknown>;
2
- /** Compatibility for historical report reads; never use this to admit new writes. */
3
- export declare function normalizePersistedFindingDetails(finding: JsonObject, profile?: "sdk" | "tracking"): void;
4
- export {};
5
- //# sourceMappingURL=finding-normalization.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"finding-normalization.d.ts","sourceRoot":"","sources":["../src/finding-normalization.ts"],"names":[],"mappings":"AAIA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,qFAAqF;AACrF,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,KAAK,GAAG,UAAkB,GAClC,IAAI,CAwKN"}
@@ -1,155 +0,0 @@
1
- /* Generated from plugin finding-normalization.ts. Run `pnpm generate:models`. */
2
- import { isRecord as isObject } from "./record.js";
3
- import { hasRequiredFindingText } from "./contract-values.js";
4
- /** Compatibility for historical report reads; never use this to admit new writes. */
5
- export function normalizePersistedFindingDetails(finding, profile = "sdk") {
6
- const evidenceIds = new Set();
7
- if (profile === "tracking" && Array.isArray(finding["codeEvidence"])) {
8
- for (const evidence of finding["codeEvidence"]) {
9
- if (isObject(evidence) && isNonEmptyString(evidence["id"]))
10
- evidenceIds.add(evidence["id"]);
11
- }
12
- }
13
- if (Array.isArray(finding["code_evidence"])) {
14
- finding["code_evidence"] = finding["code_evidence"].filter((evidence) => {
15
- if (!isObject(evidence) ||
16
- !isNonEmptyString(evidence["id"]) ||
17
- !isNonEmptyString(evidence["code"]))
18
- return false;
19
- if (profile === "sdk")
20
- return true;
21
- if (!hasRequiredFindingText(evidence["id"]) ||
22
- !hasRequiredFindingText(evidence["code"]) ||
23
- evidenceIds.has(evidence["id"]))
24
- return false;
25
- evidenceIds.add(evidence["id"]);
26
- return true;
27
- });
28
- }
29
- else if (profile === "tracking" || finding["code_evidence"] !== null) {
30
- delete finding["code_evidence"];
31
- }
32
- for (const [sectionName, listFields] of [
33
- ["rootCause", ["evidenceRefs", "evidence_refs"]],
34
- ["root_cause", ["evidenceRefs", "evidence_refs"]],
35
- [
36
- "validation",
37
- [
38
- "assertions",
39
- "counterEvidence",
40
- "evidence",
41
- "evidenceRefs",
42
- "evidence_refs",
43
- "limitations",
44
- ],
45
- ],
46
- [
47
- "attackPath",
48
- [
49
- "assumptions",
50
- "blindspots",
51
- "controls",
52
- "evidenceRefs",
53
- "evidence_refs",
54
- "limitations",
55
- "preconditions",
56
- "steps",
57
- ],
58
- ],
59
- ]) {
60
- const section = finding[sectionName];
61
- if (!isObject(section))
62
- continue;
63
- normalizePersistedStringLists(section, listFields);
64
- }
65
- const legacyRootCause = finding["root_cause"];
66
- if (isObject(legacyRootCause)) {
67
- removeUnsupportedPersistedStrings(legacyRootCause, [
68
- "summary",
69
- "code",
70
- "language",
71
- ]);
72
- }
73
- else if (legacyRootCause !== null &&
74
- (typeof legacyRootCause !== "string" ||
75
- (profile === "tracking" && legacyRootCause === ""))) {
76
- delete finding["root_cause"];
77
- }
78
- const validation = finding["validation"];
79
- if (isObject(validation)) {
80
- removeUnsupportedPersistedStrings(validation, ["method", "status", "summary", "disposition", "result"].filter((field) => profile === "tracking" ||
81
- !["status", "disposition", "result"].includes(field) ||
82
- validation[field] !== null));
83
- }
84
- const attackPath = finding["attackPath"];
85
- if (!isObject(attackPath))
86
- return;
87
- removeUnsupportedPersistedStrings(attackPath, ["summary"]);
88
- for (const field of ["dataFlow", "data_flow", "dataflow", "reachability"]) {
89
- const detail = attackPath[field];
90
- if (!isObject(detail)) {
91
- if (!isNonEmptyString(detail))
92
- delete attackPath[field];
93
- continue;
94
- }
95
- removeUnsupportedPersistedStrings(detail, [
96
- "summary",
97
- "source",
98
- "sink",
99
- "outcome",
100
- ...(field === "reachability" ? ["attacker", "entrypoint"] : []),
101
- ]);
102
- normalizePersistedStringLists(detail, [
103
- "evidenceRefs",
104
- "evidence_refs",
105
- "transformations",
106
- ...(field === "reachability" ? ["preconditions"] : []),
107
- ]);
108
- }
109
- for (const field of ["impact", "likelihood"]) {
110
- const detail = attackPath[field];
111
- if (isObject(detail)) {
112
- removeUnsupportedPersistedStrings(detail, ["level", "rationale", "why"]);
113
- }
114
- else if (detail !== undefined &&
115
- detail !== null &&
116
- !isNonEmptyString(detail)) {
117
- delete attackPath[field];
118
- }
119
- }
120
- function normalizePersistedStringLists(section, fields) {
121
- for (const field of fields) {
122
- const value = section[field];
123
- const accepted = (value) => isNonEmptyString(value) &&
124
- (profile === "sdk" || hasRequiredFindingText(value));
125
- if (accepted(value)) {
126
- if (profile === "tracking" || field !== "evidence")
127
- section[field] = [value];
128
- }
129
- else if (Array.isArray(value)) {
130
- const items = value.filter(accepted);
131
- if (profile === "tracking" && items.length === 0)
132
- delete section[field];
133
- else
134
- section[field] = items;
135
- }
136
- else
137
- delete section[field];
138
- if (profile === "tracking" &&
139
- (field === "evidenceRefs" || field === "evidence_refs") &&
140
- Array.isArray(section[field])) {
141
- section[field] = section[field].filter((ref) => typeof ref === "string" && evidenceIds.has(ref));
142
- }
143
- }
144
- }
145
- function removeUnsupportedPersistedStrings(section, fields) {
146
- for (const field of fields) {
147
- if (!isNonEmptyString(section[field]))
148
- delete section[field];
149
- }
150
- }
151
- function isNonEmptyString(value) {
152
- return typeof value === "string" && value.length > 0;
153
- }
154
- }
155
- //# sourceMappingURL=finding-normalization.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"finding-normalization.js","sourceRoot":"","sources":["../src/finding-normalization.ts"],"names":[],"mappings":"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","sourcesContent":["/* Generated from plugin finding-normalization.ts. Run `pnpm generate:models`. */\nimport { isRecord as isObject } from \"./record.js\";\nimport { hasRequiredFindingText } from \"./contract-values.js\";\n\ntype JsonObject = Record<string, unknown>;\n\n/** Compatibility for historical report reads; never use this to admit new writes. */\nexport function normalizePersistedFindingDetails(\n finding: JsonObject,\n profile: \"sdk\" | \"tracking\" = \"sdk\",\n): void {\n const evidenceIds = new Set<string>();\n if (profile === \"tracking\" && Array.isArray(finding[\"codeEvidence\"])) {\n for (const evidence of finding[\"codeEvidence\"]) {\n if (isObject(evidence) && isNonEmptyString(evidence[\"id\"]))\n evidenceIds.add(evidence[\"id\"]);\n }\n }\n if (Array.isArray(finding[\"code_evidence\"])) {\n finding[\"code_evidence\"] = finding[\"code_evidence\"].filter((evidence) => {\n if (\n !isObject(evidence) ||\n !isNonEmptyString(evidence[\"id\"]) ||\n !isNonEmptyString(evidence[\"code\"])\n )\n return false;\n if (profile === \"sdk\") return true;\n if (\n !hasRequiredFindingText(evidence[\"id\"]) ||\n !hasRequiredFindingText(evidence[\"code\"]) ||\n evidenceIds.has(evidence[\"id\"])\n )\n return false;\n evidenceIds.add(evidence[\"id\"]);\n return true;\n });\n } else if (profile === \"tracking\" || finding[\"code_evidence\"] !== null) {\n delete finding[\"code_evidence\"];\n }\n\n for (const [sectionName, listFields] of [\n [\"rootCause\", [\"evidenceRefs\", \"evidence_refs\"]],\n [\"root_cause\", [\"evidenceRefs\", \"evidence_refs\"]],\n [\n \"validation\",\n [\n \"assertions\",\n \"counterEvidence\",\n \"evidence\",\n \"evidenceRefs\",\n \"evidence_refs\",\n \"limitations\",\n ],\n ],\n [\n \"attackPath\",\n [\n \"assumptions\",\n \"blindspots\",\n \"controls\",\n \"evidenceRefs\",\n \"evidence_refs\",\n \"limitations\",\n \"preconditions\",\n \"steps\",\n ],\n ],\n ] satisfies Array<[string, string[]]>) {\n const section = finding[sectionName];\n if (!isObject(section)) continue;\n normalizePersistedStringLists(section, listFields);\n }\n\n const legacyRootCause = finding[\"root_cause\"];\n if (isObject(legacyRootCause)) {\n removeUnsupportedPersistedStrings(legacyRootCause, [\n \"summary\",\n \"code\",\n \"language\",\n ]);\n } else if (\n legacyRootCause !== null &&\n (typeof legacyRootCause !== \"string\" ||\n (profile === \"tracking\" && legacyRootCause === \"\"))\n ) {\n delete finding[\"root_cause\"];\n }\n\n const validation = finding[\"validation\"];\n if (isObject(validation)) {\n removeUnsupportedPersistedStrings(\n validation,\n [\"method\", \"status\", \"summary\", \"disposition\", \"result\"].filter(\n (field) =>\n profile === \"tracking\" ||\n ![\"status\", \"disposition\", \"result\"].includes(field) ||\n validation[field] !== null,\n ),\n );\n }\n\n const attackPath = finding[\"attackPath\"];\n if (!isObject(attackPath)) return;\n removeUnsupportedPersistedStrings(attackPath, [\"summary\"]);\n for (const field of [\"dataFlow\", \"data_flow\", \"dataflow\", \"reachability\"]) {\n const detail = attackPath[field];\n if (!isObject(detail)) {\n if (!isNonEmptyString(detail)) delete attackPath[field];\n continue;\n }\n removeUnsupportedPersistedStrings(detail, [\n \"summary\",\n \"source\",\n \"sink\",\n \"outcome\",\n ...(field === \"reachability\" ? [\"attacker\", \"entrypoint\"] : []),\n ]);\n normalizePersistedStringLists(detail, [\n \"evidenceRefs\",\n \"evidence_refs\",\n \"transformations\",\n ...(field === \"reachability\" ? [\"preconditions\"] : []),\n ]);\n }\n for (const field of [\"impact\", \"likelihood\"]) {\n const detail = attackPath[field];\n if (isObject(detail)) {\n removeUnsupportedPersistedStrings(detail, [\"level\", \"rationale\", \"why\"]);\n } else if (\n detail !== undefined &&\n detail !== null &&\n !isNonEmptyString(detail)\n ) {\n delete attackPath[field];\n }\n }\n\n function normalizePersistedStringLists(\n section: JsonObject,\n fields: string[],\n ): void {\n for (const field of fields) {\n const value = section[field];\n const accepted = (value: unknown): value is string =>\n isNonEmptyString(value) &&\n (profile === \"sdk\" || hasRequiredFindingText(value));\n if (accepted(value)) {\n if (profile === \"tracking\" || field !== \"evidence\")\n section[field] = [value];\n } else if (Array.isArray(value)) {\n const items = value.filter(accepted);\n if (profile === \"tracking\" && items.length === 0) delete section[field];\n else section[field] = items;\n } else delete section[field];\n if (\n profile === \"tracking\" &&\n (field === \"evidenceRefs\" || field === \"evidence_refs\") &&\n Array.isArray(section[field])\n ) {\n section[field] = section[field].filter(\n (ref) => typeof ref === \"string\" && evidenceIds.has(ref),\n );\n }\n }\n }\n\n function removeUnsupportedPersistedStrings(\n section: JsonObject,\n fields: string[],\n ): void {\n for (const field of fields) {\n if (!isNonEmptyString(section[field])) delete section[field];\n }\n }\n\n function isNonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0;\n }\n}\n"]}
@@ -1,13 +0,0 @@
1
- import type { ExternalFindings } from "./external-findings.js";
2
- export interface LegacyReaderSelection {
3
- sourceFindingIds: string[];
4
- snapshot?: ExternalFindings;
5
- unprovenIdPrefixes?: string[];
6
- uncertainFindingIds?: string[];
7
- unprovenOccurrenceCount?: number;
8
- knownFindings?: ExternalFindings["findings"];
9
- }
10
- export declare function rememberPreviousSelection(result: ExternalFindings, prior: LegacyReaderSelection): void;
11
- /** Only unchanged SDK output can identify an older, differently serialized selection. */
12
- export declare function previousReaderSelection(input: ExternalFindings, current: ExternalFindings, native?: ExternalFindings | null): LegacyReaderSelection | undefined;
13
- //# sourceMappingURL=reader-selection.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"reader-selection.d.ts","sourceRoot":"","sources":["../src/reader-selection.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CAC9C;AAoCD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,qBAAqB,GAC3B,IAAI,CAaN;AAED,yFAAyF;AACzF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAC/B,qBAAqB,GAAG,SAAS,CA6CnC"}
@@ -1,81 +0,0 @@
1
- import { createHash } from "node:crypto";
2
- import { isDeepStrictEqual } from "node:util";
3
- import { isBoxedPrimitive, isProxy } from "node:util/types";
4
- import { canonicalJson, cloneWithoutGetters } from "./record.js";
5
- const previousSelections = new WeakMap();
6
- // The registry digest is process-local. Frame both ordered lists separately so a
7
- // local import never needs one JSON string containing all its findings.
8
- function exportedSelectionDigest(result, preserveScalar) {
9
- const { findings, excluded, ...metadata } = result;
10
- const digest = createHash("sha256");
11
- digest.update(canonicalJson(metadata, undefined, preserveScalar));
12
- for (const rows of [excluded, findings]) {
13
- digest.update("[");
14
- for (let index = 0; index < rows.length; index++) {
15
- // Keep the array index supplied to toJSON. An omitted entry in an array
16
- // is JSON null, just like an explicit null or a hole.
17
- const entry = canonicalJson({ [index]: rows[index] }, undefined, preserveScalar);
18
- digest.update(entry === "{}" ? `{"${index}":null}` : entry);
19
- }
20
- digest.update("]");
21
- }
22
- return digest.digest("hex");
23
- }
24
- export function rememberPreviousSelection(result, prior) {
25
- // Stop-only hints do not require hashing unbounded local evidence.
26
- const exported = prior.snapshot || prior.knownFindings
27
- ? exportedSelectionDigest(result, isBoxedPrimitive)
28
- : undefined;
29
- const selection = {
30
- exported,
31
- native: exported ? cloneWithoutGetters(result) : undefined,
32
- previous: prior,
33
- };
34
- previousSelections.set(result, selection);
35
- previousSelections.set(result.findings, selection);
36
- }
37
- /** Only unchanged SDK output can identify an older, differently serialized selection. */
38
- export function previousReaderSelection(input, current, native) {
39
- const selection = previousSelections.get(input) ??
40
- (!isProxy(input) &&
41
- previousSelections.get(Object.getOwnPropertyDescriptor(input, "findings")?.value));
42
- if (!selection)
43
- return undefined;
44
- const observed = native === undefined ? cloneWithoutGetters(input) : native;
45
- if (selection.native && observed && selection.exported) {
46
- // Callers can attach a report after normalizing rows. Historical validation
47
- // and the saved approval still bind the independently captured report.
48
- const attachedReport = !Object.hasOwn(selection.native, "report") &&
49
- !Object.hasOwn(selection.previous.snapshot ?? {}, "report") &&
50
- observed.report !== undefined;
51
- const rows = (value) => {
52
- if (!attachedReport)
53
- return value;
54
- const { report: _report, ...readerOutput } = value;
55
- return readerOutput;
56
- };
57
- if (isDeepStrictEqual(selection.native, rows(observed)) &&
58
- exportedSelectionDigest(rows(current)) === selection.exported) {
59
- const prior = selection.previous;
60
- return attachedReport && prior.snapshot
61
- ? { ...prior, snapshot: { ...prior.snapshot, report: observed.report } }
62
- : prior;
63
- }
64
- }
65
- // Without a verified snapshot these IDs can only stop a retry. Preserve
66
- // the caller's order when they rearranged the same known occurrences.
67
- let sourceFindingIds = selection.previous.sourceFindingIds;
68
- if (current.findings.length === sourceFindingIds.length) {
69
- const members = new Set(sourceFindingIds);
70
- const ordered = current.findings.map((row) => row.source_finding_id);
71
- if (ordered.every((id) => members.has(id)))
72
- sourceFindingIds = ordered;
73
- }
74
- return {
75
- sourceFindingIds,
76
- unprovenIdPrefixes: selection.previous.unprovenIdPrefixes,
77
- uncertainFindingIds: selection.previous.uncertainFindingIds,
78
- unprovenOccurrenceCount: selection.previous.unprovenOccurrenceCount,
79
- };
80
- }
81
- //# sourceMappingURL=reader-selection.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"reader-selection.js","sourceRoot":"","sources":["../src/reader-selection.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { isDeepStrictEqual } from \"node:util\";\nimport { isBoxedPrimitive, isProxy } from \"node:util/types\";\nimport type { ExternalFindings } from \"./external-findings.js\";\nimport { canonicalJson, cloneWithoutGetters } from \"./record.js\";\n\nexport interface LegacyReaderSelection {\n sourceFindingIds: string[];\n snapshot?: ExternalFindings;\n unprovenIdPrefixes?: string[];\n uncertainFindingIds?: string[];\n unprovenOccurrenceCount?: number;\n knownFindings?: ExternalFindings[\"findings\"];\n}\nconst previousSelections = new WeakMap<\n object,\n {\n exported?: string;\n native?: ExternalFindings;\n previous: LegacyReaderSelection;\n }\n>();\n\n// The registry digest is process-local. Frame both ordered lists separately so a\n// local import never needs one JSON string containing all its findings.\nfunction exportedSelectionDigest(\n result: ExternalFindings,\n preserveScalar?: (value: object) => boolean,\n): string {\n const { findings, excluded, ...metadata } = result;\n const digest = createHash(\"sha256\");\n digest.update(canonicalJson(metadata, undefined, preserveScalar));\n for (const rows of [excluded, findings]) {\n digest.update(\"[\");\n for (let index = 0; index < rows.length; index++) {\n // Keep the array index supplied to toJSON. An omitted entry in an array\n // is JSON null, just like an explicit null or a hole.\n const entry = canonicalJson(\n { [index]: rows[index] },\n undefined,\n preserveScalar,\n );\n digest.update(entry === \"{}\" ? `{\"${index}\":null}` : entry);\n }\n digest.update(\"]\");\n }\n return digest.digest(\"hex\");\n}\n\nexport function rememberPreviousSelection(\n result: ExternalFindings,\n prior: LegacyReaderSelection,\n): void {\n // Stop-only hints do not require hashing unbounded local evidence.\n const exported =\n prior.snapshot || prior.knownFindings\n ? exportedSelectionDigest(result, isBoxedPrimitive)\n : undefined;\n const selection = {\n exported,\n native: exported ? cloneWithoutGetters(result) : undefined,\n previous: prior,\n };\n previousSelections.set(result, selection);\n previousSelections.set(result.findings, selection);\n}\n\n/** Only unchanged SDK output can identify an older, differently serialized selection. */\nexport function previousReaderSelection(\n input: ExternalFindings,\n current: ExternalFindings,\n native?: ExternalFindings | null,\n): LegacyReaderSelection | undefined {\n const selection =\n previousSelections.get(input) ??\n (!isProxy(input) &&\n previousSelections.get(\n Object.getOwnPropertyDescriptor(input, \"findings\")?.value,\n ));\n if (!selection) return undefined;\n const observed = native === undefined ? cloneWithoutGetters(input) : native;\n if (selection.native && observed && selection.exported) {\n // Callers can attach a report after normalizing rows. Historical validation\n // and the saved approval still bind the independently captured report.\n const attachedReport =\n !Object.hasOwn(selection.native, \"report\") &&\n !Object.hasOwn(selection.previous.snapshot ?? {}, \"report\") &&\n observed.report !== undefined;\n const rows = (value: ExternalFindings) => {\n if (!attachedReport) return value;\n const { report: _report, ...readerOutput } = value;\n return readerOutput;\n };\n if (\n isDeepStrictEqual(selection.native, rows(observed)) &&\n exportedSelectionDigest(rows(current)) === selection.exported\n ) {\n const prior = selection.previous;\n return attachedReport && prior.snapshot\n ? { ...prior, snapshot: { ...prior.snapshot, report: observed.report } }\n : prior;\n }\n }\n // Without a verified snapshot these IDs can only stop a retry. Preserve\n // the caller's order when they rearranged the same known occurrences.\n let sourceFindingIds = selection.previous.sourceFindingIds;\n if (current.findings.length === sourceFindingIds.length) {\n const members = new Set(sourceFindingIds);\n const ordered = current.findings.map((row) => row.source_finding_id);\n if (ordered.every((id) => members.has(id))) sourceFindingIds = ordered;\n }\n return {\n sourceFindingIds,\n unprovenIdPrefixes: selection.previous.unprovenIdPrefixes,\n uncertainFindingIds: selection.previous.uncertainFindingIds,\n unprovenOccurrenceCount: selection.previous.unprovenOccurrenceCount,\n };\n}\n"]}