@openai/codex-security 0.8.2 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (649) hide show
  1. package/README.md +201 -178
  2. package/_bundled_plugin/.app.json +4 -0
  3. package/_bundled_plugin/.mcp.json +6 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/core-scan.md +14 -5
  26. package/_bundled_plugin/references/default-severity-rubric.md +33 -0
  27. package/_bundled_plugin/references/final-report.md +5 -3
  28. package/_bundled_plugin/references/finding-detail-fields.md +19 -18
  29. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  30. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  31. package/_bundled_plugin/references/scan-contract.md +27 -33
  32. package/_bundled_plugin/references/threat-model.md +1 -0
  33. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  34. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  35. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  36. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  37. package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
  38. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  39. package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
  40. package/_bundled_plugin/scripts/finding_preview.py +25 -29
  41. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  42. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  43. package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
  44. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  45. package/_bundled_plugin/scripts/report_projection.py +167 -178
  46. package/_bundled_plugin/scripts/review_state.py +8 -2
  47. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  48. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  49. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  50. package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
  51. package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
  52. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  53. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  54. package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
  55. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  56. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  57. package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
  58. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  59. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  60. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  61. package/_bundled_plugin/scripts/workbench_cli.py +121 -14
  62. package/_bundled_plugin/scripts/workbench_constants.py +19 -0
  63. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  64. package/_bundled_plugin/scripts/workbench_db.py +550 -492
  65. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  66. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  67. package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
  68. package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
  69. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  70. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  71. package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
  72. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  73. package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
  74. package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
  75. package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
  76. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  77. package/_bundled_plugin/scripts/workbench_setup.py +251 -0
  78. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  79. package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
  80. package/_bundled_plugin/scripts/workbench_target.py +330 -66
  81. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  82. package/_bundled_plugin/scripts/workbench_validation.py +44 -12
  83. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
  84. package/_bundled_plugin/shared/workbench-migrations.json +53 -0
  85. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
  86. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
  87. package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
  88. package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
  89. package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
  90. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  91. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
  92. package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
  93. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  94. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
  95. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  96. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
  97. package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
  98. package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
  99. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
  100. package/dist/api.d.ts +45 -5
  101. package/dist/api.d.ts.map +1 -1
  102. package/dist/api.js +1144 -411
  103. package/dist/api.js.map +1 -1
  104. package/dist/auth.d.ts.map +1 -1
  105. package/dist/auth.js +10 -7
  106. package/dist/auth.js.map +1 -1
  107. package/dist/bedrock-oss-pricing.d.ts +6 -0
  108. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  109. package/dist/bedrock-oss-pricing.js +58 -0
  110. package/dist/bedrock-oss-pricing.js.map +1 -0
  111. package/dist/bedrock-pricing.d.ts +15 -0
  112. package/dist/bedrock-pricing.d.ts.map +1 -0
  113. package/dist/bedrock-pricing.js +117 -0
  114. package/dist/bedrock-pricing.js.map +1 -0
  115. package/dist/blackduck-findings.d.ts +8 -0
  116. package/dist/blackduck-findings.d.ts.map +1 -0
  117. package/dist/blackduck-findings.js +320 -0
  118. package/dist/blackduck-findings.js.map +1 -0
  119. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  120. package/dist/bulk-scan-discovery.js +51 -36
  121. package/dist/bulk-scan-discovery.js.map +1 -1
  122. package/dist/checkmarx-evidence.d.ts +19 -0
  123. package/dist/checkmarx-evidence.d.ts.map +1 -0
  124. package/dist/checkmarx-evidence.js +36 -0
  125. package/dist/checkmarx-evidence.js.map +1 -0
  126. package/dist/checkmarx-findings.d.ts +4 -0
  127. package/dist/checkmarx-findings.d.ts.map +1 -0
  128. package/dist/checkmarx-findings.js +27 -0
  129. package/dist/checkmarx-findings.js.map +1 -0
  130. package/dist/checkmarx-one.d.ts +4 -0
  131. package/dist/checkmarx-one.d.ts.map +1 -0
  132. package/dist/checkmarx-one.js +53 -0
  133. package/dist/checkmarx-one.js.map +1 -0
  134. package/dist/checkmarx-repository.d.ts +12 -0
  135. package/dist/checkmarx-repository.d.ts.map +1 -0
  136. package/dist/checkmarx-repository.js +181 -0
  137. package/dist/checkmarx-repository.js.map +1 -0
  138. package/dist/checkmarx-xml.d.ts +12 -0
  139. package/dist/checkmarx-xml.d.ts.map +1 -0
  140. package/dist/checkmarx-xml.js +196 -0
  141. package/dist/checkmarx-xml.js.map +1 -0
  142. package/dist/classify-severity-records.d.ts +6 -9
  143. package/dist/classify-severity-records.d.ts.map +1 -1
  144. package/dist/classify-severity-records.js +9 -21
  145. package/dist/classify-severity-records.js.map +1 -1
  146. package/dist/classify-severity.d.ts +4 -1
  147. package/dist/classify-severity.d.ts.map +1 -1
  148. package/dist/classify-severity.js +30 -13
  149. package/dist/classify-severity.js.map +1 -1
  150. package/dist/cli.d.ts +14 -5
  151. package/dist/cli.d.ts.map +1 -1
  152. package/dist/cli.js +2112 -1266
  153. package/dist/cli.js.map +1 -1
  154. package/dist/cloud-publish.js +2 -2
  155. package/dist/cloud-publish.js.map +1 -1
  156. package/dist/codex-prompt.d.ts +2 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +6 -0
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/component-scan.d.ts +16 -3
  161. package/dist/component-scan.d.ts.map +1 -1
  162. package/dist/component-scan.js +32 -6
  163. package/dist/component-scan.js.map +1 -1
  164. package/dist/config.d.ts +2 -1
  165. package/dist/config.d.ts.map +1 -1
  166. package/dist/config.js +221 -65
  167. package/dist/config.js.map +1 -1
  168. package/dist/continuum-findings.d.ts +7 -0
  169. package/dist/continuum-findings.d.ts.map +1 -0
  170. package/dist/continuum-findings.js +225 -0
  171. package/dist/continuum-findings.js.map +1 -0
  172. package/dist/contract-values.d.ts +30 -0
  173. package/dist/contract-values.d.ts.map +1 -0
  174. package/dist/contract-values.js +78 -0
  175. package/dist/contract-values.js.map +1 -0
  176. package/dist/contract.d.ts +2 -20
  177. package/dist/contract.d.ts.map +1 -1
  178. package/dist/contract.js +58 -669
  179. package/dist/contract.js.map +1 -1
  180. package/dist/cost-model.d.ts +13 -1
  181. package/dist/cost-model.d.ts.map +1 -1
  182. package/dist/cost-model.js +66 -115
  183. package/dist/cost-model.js.map +1 -1
  184. package/dist/cost.d.ts +61 -4
  185. package/dist/cost.d.ts.map +1 -1
  186. package/dist/cost.js +2560 -100
  187. package/dist/cost.js.map +1 -1
  188. package/dist/custom-publish.d.ts +4 -0
  189. package/dist/custom-publish.d.ts.map +1 -1
  190. package/dist/custom-publish.js +40 -3
  191. package/dist/custom-publish.js.map +1 -1
  192. package/dist/custom-validation-prompt.d.ts +1 -1
  193. package/dist/custom-validation-prompt.d.ts.map +1 -1
  194. package/dist/custom-validation-prompt.js +5 -0
  195. package/dist/custom-validation-prompt.js.map +1 -1
  196. package/dist/custom-validation.d.ts +2 -0
  197. package/dist/custom-validation.d.ts.map +1 -1
  198. package/dist/custom-validation.js +4 -0
  199. package/dist/custom-validation.js.map +1 -1
  200. package/dist/deduplication/deduplication-prompts.d.ts +4 -4
  201. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.js +2 -2
  203. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  204. package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
  205. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.js +11 -4
  207. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  208. package/dist/deduplication/deduplication.js.map +1 -1
  209. package/dist/deduplication/finding-schema.d.ts +19 -1
  210. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  211. package/dist/deduplication/finding-schema.js +25 -0
  212. package/dist/deduplication/finding-schema.js.map +1 -1
  213. package/dist/deduplication/local.d.ts +2 -2
  214. package/dist/deduplication/local.d.ts.map +1 -1
  215. package/dist/deduplication/local.js +5 -10
  216. package/dist/deduplication/local.js.map +1 -1
  217. package/dist/deduplication/records.d.ts +8 -2
  218. package/dist/deduplication/records.d.ts.map +1 -1
  219. package/dist/deduplication/records.js +36 -8
  220. package/dist/deduplication/records.js.map +1 -1
  221. package/dist/deduplication/refusal.d.ts.map +1 -1
  222. package/dist/deduplication/refusal.js +25 -5
  223. package/dist/deduplication/refusal.js.map +1 -1
  224. package/dist/deduplication/scan.d.ts +3 -0
  225. package/dist/deduplication/scan.d.ts.map +1 -1
  226. package/dist/deduplication/scan.js +1 -1
  227. package/dist/deduplication/scan.js.map +1 -1
  228. package/dist/deep-config.d.ts +0 -1
  229. package/dist/deep-config.d.ts.map +1 -1
  230. package/dist/deep-config.js +22 -33
  231. package/dist/deep-config.js.map +1 -1
  232. package/dist/deep-scan-defaults.d.ts +2 -0
  233. package/dist/deep-scan-defaults.d.ts.map +1 -1
  234. package/dist/deep-scan-defaults.js +28 -1
  235. package/dist/deep-scan-defaults.js.map +1 -1
  236. package/dist/deep-scan.d.ts +13 -0
  237. package/dist/deep-scan.d.ts.map +1 -1
  238. package/dist/deep-scan.js +262 -7
  239. package/dist/deep-scan.js.map +1 -1
  240. package/dist/default-severity-rubric.d.ts +1 -2
  241. package/dist/default-severity-rubric.d.ts.map +1 -1
  242. package/dist/default-severity-rubric.js +2 -66
  243. package/dist/default-severity-rubric.js.map +1 -1
  244. package/dist/endor-findings.d.ts +3 -1
  245. package/dist/endor-findings.d.ts.map +1 -1
  246. package/dist/endor-findings.js +108 -80
  247. package/dist/endor-findings.js.map +1 -1
  248. package/dist/errors.d.ts +1 -1
  249. package/dist/errors.d.ts.map +1 -1
  250. package/dist/errors.js +9 -2
  251. package/dist/errors.js.map +1 -1
  252. package/dist/external-findings-import.d.ts +5 -3
  253. package/dist/external-findings-import.d.ts.map +1 -1
  254. package/dist/external-findings-import.js +11 -16
  255. package/dist/external-findings-import.js.map +1 -1
  256. package/dist/external-findings-local.d.ts +15 -4
  257. package/dist/external-findings-local.d.ts.map +1 -1
  258. package/dist/external-findings-local.js +619 -225
  259. package/dist/external-findings-local.js.map +1 -1
  260. package/dist/external-findings-publish.d.ts +20 -6
  261. package/dist/external-findings-publish.d.ts.map +1 -1
  262. package/dist/external-findings-publish.js +2356 -308
  263. package/dist/external-findings-publish.js.map +1 -1
  264. package/dist/external-findings-read.d.ts +28 -2
  265. package/dist/external-findings-read.d.ts.map +1 -1
  266. package/dist/external-findings-read.js +174 -81
  267. package/dist/external-findings-read.js.map +1 -1
  268. package/dist/external-findings.d.ts +17 -3
  269. package/dist/external-findings.d.ts.map +1 -1
  270. package/dist/external-findings.js +153 -1
  271. package/dist/external-findings.js.map +1 -1
  272. package/dist/external-import-contract.d.ts +33 -1
  273. package/dist/external-import-contract.d.ts.map +1 -1
  274. package/dist/external-import-contract.js +335 -51
  275. package/dist/external-import-contract.js.map +1 -1
  276. package/dist/external-import-models.d.ts +1 -1
  277. package/dist/external-import-models.d.ts.map +1 -1
  278. package/dist/external-import-models.js.map +1 -1
  279. package/dist/feedback.d.ts.map +1 -1
  280. package/dist/feedback.js +5 -4
  281. package/dist/feedback.js.map +1 -1
  282. package/dist/finding-prompt.d.ts +5 -0
  283. package/dist/finding-prompt.d.ts.map +1 -0
  284. package/dist/finding-prompt.js +32 -0
  285. package/dist/finding-prompt.js.map +1 -0
  286. package/dist/finding-retrieval.d.ts +3 -3
  287. package/dist/finding-retrieval.d.ts.map +1 -1
  288. package/dist/finding-retrieval.js.map +1 -1
  289. package/dist/finding-workflow.d.ts +6 -1
  290. package/dist/finding-workflow.d.ts.map +1 -1
  291. package/dist/finding-workflow.js +2 -2
  292. package/dist/finding-workflow.js.map +1 -1
  293. package/dist/findings-client.d.ts +1 -0
  294. package/dist/findings-client.d.ts.map +1 -1
  295. package/dist/findings-client.js +27 -3
  296. package/dist/findings-client.js.map +1 -1
  297. package/dist/git-remote.d.ts +4 -0
  298. package/dist/git-remote.d.ts.map +1 -1
  299. package/dist/git-remote.js +20 -0
  300. package/dist/git-remote.js.map +1 -1
  301. package/dist/github-advisories.d.ts +3 -12
  302. package/dist/github-advisories.d.ts.map +1 -1
  303. package/dist/github-advisories.js +9 -31
  304. package/dist/github-advisories.js.map +1 -1
  305. package/dist/github-dependabot-findings.d.ts.map +1 -1
  306. package/dist/github-dependabot-findings.js +22 -20
  307. package/dist/github-dependabot-findings.js.map +1 -1
  308. package/dist/github-findings.d.ts +4 -1
  309. package/dist/github-findings.d.ts.map +1 -1
  310. package/dist/github-findings.js +392 -79
  311. package/dist/github-findings.js.map +1 -1
  312. package/dist/github.d.ts +17 -7
  313. package/dist/github.d.ts.map +1 -1
  314. package/dist/github.js +43 -30
  315. package/dist/github.js.map +1 -1
  316. package/dist/host-protocol.d.ts +2 -2
  317. package/dist/host-protocol.d.ts.map +1 -1
  318. package/dist/host-protocol.js.map +1 -1
  319. package/dist/host-records-protocol.d.ts +10 -11
  320. package/dist/host-records-protocol.d.ts.map +1 -1
  321. package/dist/host-records-protocol.js +69 -9
  322. package/dist/host-records-protocol.js.map +1 -1
  323. package/dist/hosted-git-remotes.d.ts +5 -0
  324. package/dist/hosted-git-remotes.d.ts.map +1 -0
  325. package/dist/hosted-git-remotes.js +285 -0
  326. package/dist/hosted-git-remotes.js.map +1 -0
  327. package/dist/hosted-git-repository.d.ts +28 -0
  328. package/dist/hosted-git-repository.d.ts.map +1 -0
  329. package/dist/hosted-git-repository.js +222 -0
  330. package/dist/hosted-git-repository.js.map +1 -0
  331. package/dist/hosted-scan-protocol.js +2 -2
  332. package/dist/hosted-scan-protocol.js.map +1 -1
  333. package/dist/hosted-scan.d.ts +15 -0
  334. package/dist/hosted-scan.d.ts.map +1 -1
  335. package/dist/hosted-scan.js +71 -44
  336. package/dist/hosted-scan.js.map +1 -1
  337. package/dist/hosted-scanner-http.d.ts +21 -0
  338. package/dist/hosted-scanner-http.d.ts.map +1 -0
  339. package/dist/hosted-scanner-http.js +204 -0
  340. package/dist/hosted-scanner-http.js.map +1 -0
  341. package/dist/hosted-scanner-v1.d.ts +6 -0
  342. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  343. package/dist/hosted-scanner-v1.js +60 -0
  344. package/dist/hosted-scanner-v1.js.map +1 -0
  345. package/dist/import-scan.d.ts.map +1 -1
  346. package/dist/import-scan.js +3 -0
  347. package/dist/import-scan.js.map +1 -1
  348. package/dist/index.d.ts +24 -6
  349. package/dist/index.d.ts.map +1 -1
  350. package/dist/index.js +15 -1
  351. package/dist/index.js.map +1 -1
  352. package/dist/inspector-findings.d.ts.map +1 -1
  353. package/dist/inspector-findings.js +58 -81
  354. package/dist/inspector-findings.js.map +1 -1
  355. package/dist/knowledge-base.d.ts.map +1 -1
  356. package/dist/knowledge-base.js +86 -10
  357. package/dist/knowledge-base.js.map +1 -1
  358. package/dist/local-git-metadata.d.ts +5 -0
  359. package/dist/local-git-metadata.d.ts.map +1 -0
  360. package/dist/local-git-metadata.js +130 -0
  361. package/dist/local-git-metadata.js.map +1 -0
  362. package/dist/multiscan.d.ts +6 -4
  363. package/dist/multiscan.d.ts.map +1 -1
  364. package/dist/multiscan.js +160 -77
  365. package/dist/multiscan.js.map +1 -1
  366. package/dist/native-json-findings.d.ts +2 -1
  367. package/dist/native-json-findings.d.ts.map +1 -1
  368. package/dist/native-json-findings.js +12 -2
  369. package/dist/native-json-findings.js.map +1 -1
  370. package/dist/opengrep-findings.d.ts +1 -0
  371. package/dist/opengrep-findings.d.ts.map +1 -1
  372. package/dist/opengrep-findings.js +49 -31
  373. package/dist/opengrep-findings.js.map +1 -1
  374. package/dist/operation-telemetry.d.ts +104 -0
  375. package/dist/operation-telemetry.d.ts.map +1 -0
  376. package/dist/operation-telemetry.js +293 -0
  377. package/dist/operation-telemetry.js.map +1 -0
  378. package/dist/patch-tui.d.ts.map +1 -1
  379. package/dist/patch-tui.js +90 -35
  380. package/dist/patch-tui.js.map +1 -1
  381. package/dist/plugin-python-probe.d.ts +4 -0
  382. package/dist/plugin-python-probe.d.ts.map +1 -0
  383. package/dist/plugin-python-probe.js +10 -0
  384. package/dist/plugin-python-probe.js.map +1 -0
  385. package/dist/private-finding-import.d.ts +341 -0
  386. package/dist/private-finding-import.d.ts.map +1 -0
  387. package/dist/private-finding-import.js +411 -0
  388. package/dist/private-finding-import.js.map +1 -0
  389. package/dist/project-config.d.ts.map +1 -1
  390. package/dist/project-config.js +2 -2
  391. package/dist/project-config.js.map +1 -1
  392. package/dist/provider-profile.d.ts +11 -3
  393. package/dist/provider-profile.d.ts.map +1 -1
  394. package/dist/provider-profile.js +80 -11
  395. package/dist/provider-profile.js.map +1 -1
  396. package/dist/publication-telemetry.d.ts +45 -0
  397. package/dist/publication-telemetry.d.ts.map +1 -0
  398. package/dist/publication-telemetry.js +50 -0
  399. package/dist/publication-telemetry.js.map +1 -0
  400. package/dist/publication.js +7 -1
  401. package/dist/publication.js.map +1 -1
  402. package/dist/publish.d.ts +4 -0
  403. package/dist/publish.d.ts.map +1 -1
  404. package/dist/publish.js +42 -2
  405. package/dist/publish.js.map +1 -1
  406. package/dist/reader-selection.d.ts +15 -0
  407. package/dist/reader-selection.d.ts.map +1 -0
  408. package/dist/reader-selection.js +89 -0
  409. package/dist/reader-selection.js.map +1 -0
  410. package/dist/record.d.ts +6 -1
  411. package/dist/record.d.ts.map +1 -1
  412. package/dist/record.js +53 -2
  413. package/dist/record.js.map +1 -1
  414. package/dist/remediation.d.ts +3 -1
  415. package/dist/remediation.d.ts.map +1 -1
  416. package/dist/remediation.js +28 -2
  417. package/dist/remediation.js.map +1 -1
  418. package/dist/request-metadata.d.ts +3 -0
  419. package/dist/request-metadata.d.ts.map +1 -1
  420. package/dist/request-metadata.js +9 -0
  421. package/dist/request-metadata.js.map +1 -1
  422. package/dist/result.d.ts +6 -0
  423. package/dist/result.d.ts.map +1 -1
  424. package/dist/result.js +3 -1
  425. package/dist/result.js.map +1 -1
  426. package/dist/retry-windows-rename.d.ts +8 -0
  427. package/dist/retry-windows-rename.d.ts.map +1 -0
  428. package/dist/retry-windows-rename.js +24 -0
  429. package/dist/retry-windows-rename.js.map +1 -0
  430. package/dist/runtime.d.ts +22 -1
  431. package/dist/runtime.d.ts.map +1 -1
  432. package/dist/runtime.js +408 -162
  433. package/dist/runtime.js.map +1 -1
  434. package/dist/saved-scan-bootstrap.d.ts +1 -0
  435. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  436. package/dist/saved-scan-bootstrap.js +18 -15
  437. package/dist/saved-scan-bootstrap.js.map +1 -1
  438. package/dist/scan-activity.d.ts.map +1 -1
  439. package/dist/scan-activity.js +172 -64
  440. package/dist/scan-activity.js.map +1 -1
  441. package/dist/scan-comparison.d.ts +10 -5
  442. package/dist/scan-comparison.d.ts.map +1 -1
  443. package/dist/scan-comparison.js +68 -25
  444. package/dist/scan-comparison.js.map +1 -1
  445. package/dist/scan-dashboard.d.ts +7 -6
  446. package/dist/scan-dashboard.d.ts.map +1 -1
  447. package/dist/scan-dashboard.js +91 -79
  448. package/dist/scan-dashboard.js.map +1 -1
  449. package/dist/scan-executor.d.ts +12 -1
  450. package/dist/scan-executor.d.ts.map +1 -1
  451. package/dist/scan-executor.js +22 -2
  452. package/dist/scan-executor.js.map +1 -1
  453. package/dist/scan-history-renderer.d.ts.map +1 -1
  454. package/dist/scan-history-renderer.js +31 -28
  455. package/dist/scan-history-renderer.js.map +1 -1
  456. package/dist/scan-logs.d.ts +12 -0
  457. package/dist/scan-logs.d.ts.map +1 -1
  458. package/dist/scan-logs.js +106 -77
  459. package/dist/scan-logs.js.map +1 -1
  460. package/dist/scan-measurement.d.ts +26 -0
  461. package/dist/scan-measurement.d.ts.map +1 -0
  462. package/dist/scan-measurement.js +77 -0
  463. package/dist/scan-measurement.js.map +1 -0
  464. package/dist/scan-progress.d.ts +1 -0
  465. package/dist/scan-progress.d.ts.map +1 -1
  466. package/dist/scan-progress.js +3 -0
  467. package/dist/scan-progress.js.map +1 -1
  468. package/dist/scan-sessions.d.ts.map +1 -1
  469. package/dist/scan-sessions.js +4 -1
  470. package/dist/scan-sessions.js.map +1 -1
  471. package/dist/scan-settings.d.ts +1 -1
  472. package/dist/scan-settings.d.ts.map +1 -1
  473. package/dist/scan-settings.js +1 -24
  474. package/dist/scan-settings.js.map +1 -1
  475. package/dist/scanner-import.d.ts +64 -6
  476. package/dist/scanner-import.d.ts.map +1 -1
  477. package/dist/scanner-import.js +406 -48
  478. package/dist/scanner-import.js.map +1 -1
  479. package/dist/scanner-repository-url.d.ts +17 -0
  480. package/dist/scanner-repository-url.d.ts.map +1 -0
  481. package/dist/scanner-repository-url.js +71 -0
  482. package/dist/scanner-repository-url.js.map +1 -0
  483. package/dist/security-policy.d.ts +1 -1
  484. package/dist/security-policy.d.ts.map +1 -1
  485. package/dist/security-policy.js.map +1 -1
  486. package/dist/semgrep-findings.d.ts +6 -3
  487. package/dist/semgrep-findings.d.ts.map +1 -1
  488. package/dist/semgrep-findings.js +124 -88
  489. package/dist/semgrep-findings.js.map +1 -1
  490. package/dist/semgrep-guardian-findings.d.ts +38 -0
  491. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  492. package/dist/semgrep-guardian-findings.js +165 -0
  493. package/dist/semgrep-guardian-findings.js.map +1 -0
  494. package/dist/semgrep-platform-collector.d.ts +26 -0
  495. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  496. package/dist/semgrep-platform-collector.js +108 -0
  497. package/dist/semgrep-platform-collector.js.map +1 -0
  498. package/dist/semgrep-platform-findings.d.ts +213 -0
  499. package/dist/semgrep-platform-findings.d.ts.map +1 -0
  500. package/dist/semgrep-platform-findings.js +1078 -0
  501. package/dist/semgrep-platform-findings.js.map +1 -0
  502. package/dist/semgrep-platform-v1.d.ts +6 -0
  503. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  504. package/dist/semgrep-platform-v1.js +83 -0
  505. package/dist/semgrep-platform-v1.js.map +1 -0
  506. package/dist/server/api.d.ts +1 -1
  507. package/dist/server/api.d.ts.map +1 -1
  508. package/dist/server/api.js.map +1 -1
  509. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  510. package/dist/server/embedding-tokenizer.d.ts +2 -0
  511. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  512. package/dist/server/embedding-tokenizer.js +322 -0
  513. package/dist/server/embedding-tokenizer.js.map +6 -0
  514. package/dist/server/embeddings.d.ts +16 -2
  515. package/dist/server/embeddings.d.ts.map +1 -1
  516. package/dist/server/embeddings.js +35 -5
  517. package/dist/server/embeddings.js.map +1 -1
  518. package/dist/session-lines.d.ts +5 -0
  519. package/dist/session-lines.d.ts.map +1 -0
  520. package/dist/session-lines.js +60 -0
  521. package/dist/session-lines.js.map +1 -0
  522. package/dist/severity-review.d.ts +3 -1
  523. package/dist/severity-review.d.ts.map +1 -1
  524. package/dist/severity-review.js +3 -2
  525. package/dist/severity-review.js.map +1 -1
  526. package/dist/severity-rubric.d.ts +20 -0
  527. package/dist/severity-rubric.d.ts.map +1 -0
  528. package/dist/severity-rubric.js +73 -0
  529. package/dist/severity-rubric.js.map +1 -0
  530. package/dist/severity-store.js +15 -5
  531. package/dist/severity-store.js.map +1 -1
  532. package/dist/skill-authentication.d.ts +1 -0
  533. package/dist/skill-authentication.d.ts.map +1 -1
  534. package/dist/skill-authentication.js +1 -0
  535. package/dist/skill-authentication.js.map +1 -1
  536. package/dist/snyk-findings.d.ts +7 -2
  537. package/dist/snyk-findings.d.ts.map +1 -1
  538. package/dist/snyk-findings.js +108 -84
  539. package/dist/snyk-findings.js.map +1 -1
  540. package/dist/snyk-rest-findings.d.ts +76 -0
  541. package/dist/snyk-rest-findings.d.ts.map +1 -0
  542. package/dist/snyk-rest-findings.js +1051 -0
  543. package/dist/snyk-rest-findings.js.map +1 -0
  544. package/dist/snyk-rest-v1.d.ts +28 -0
  545. package/dist/snyk-rest-v1.d.ts.map +1 -0
  546. package/dist/snyk-rest-v1.js +132 -0
  547. package/dist/snyk-rest-v1.js.map +1 -0
  548. package/dist/snyk-token-origin.d.ts +4 -0
  549. package/dist/snyk-token-origin.d.ts.map +1 -0
  550. package/dist/snyk-token-origin.js +82 -0
  551. package/dist/snyk-token-origin.js.map +1 -0
  552. package/dist/sonar-collector.d.ts +16 -0
  553. package/dist/sonar-collector.d.ts.map +1 -0
  554. package/dist/sonar-collector.js +380 -0
  555. package/dist/sonar-collector.js.map +1 -0
  556. package/dist/sonar-findings.d.ts +49 -0
  557. package/dist/sonar-findings.d.ts.map +1 -0
  558. package/dist/sonar-findings.js +288 -0
  559. package/dist/sonar-findings.js.map +1 -0
  560. package/dist/sonar-import.d.ts +111 -0
  561. package/dist/sonar-import.d.ts.map +1 -0
  562. package/dist/sonar-import.js +277 -0
  563. package/dist/sonar-import.js.map +1 -0
  564. package/dist/suggest-owners.d.ts.map +1 -1
  565. package/dist/suggest-owners.js +2 -1
  566. package/dist/suggest-owners.js.map +1 -1
  567. package/dist/target-drift.d.ts +9 -0
  568. package/dist/target-drift.d.ts.map +1 -0
  569. package/dist/target-drift.js +27 -0
  570. package/dist/target-drift.js.map +1 -0
  571. package/dist/targets.d.ts +5 -0
  572. package/dist/targets.d.ts.map +1 -1
  573. package/dist/targets.js +73 -31
  574. package/dist/targets.js.map +1 -1
  575. package/dist/tenable-findings.d.ts +9 -0
  576. package/dist/tenable-findings.d.ts.map +1 -0
  577. package/dist/tenable-findings.js +122 -0
  578. package/dist/tenable-findings.js.map +1 -0
  579. package/dist/terminal-columns.d.ts +4 -0
  580. package/dist/terminal-columns.d.ts.map +1 -0
  581. package/dist/terminal-columns.js +19 -0
  582. package/dist/terminal-columns.js.map +1 -0
  583. package/dist/terminal-stream.d.ts +13 -0
  584. package/dist/terminal-stream.d.ts.map +1 -0
  585. package/dist/terminal-stream.js +35 -0
  586. package/dist/terminal-stream.js.map +1 -0
  587. package/dist/trivy-findings.d.ts +19 -0
  588. package/dist/trivy-findings.d.ts.map +1 -0
  589. package/dist/trivy-findings.js +435 -0
  590. package/dist/trivy-findings.js.map +1 -0
  591. package/dist/trivy-import.d.ts +19 -0
  592. package/dist/trivy-import.d.ts.map +1 -0
  593. package/dist/trivy-import.js +151 -0
  594. package/dist/trivy-import.js.map +1 -0
  595. package/dist/validation-records.d.ts +0 -3
  596. package/dist/validation-records.d.ts.map +1 -1
  597. package/dist/validation-records.js +1 -17
  598. package/dist/validation-records.js.map +1 -1
  599. package/dist/veracode-findings.d.ts +9 -0
  600. package/dist/veracode-findings.d.ts.map +1 -0
  601. package/dist/veracode-findings.js +409 -0
  602. package/dist/veracode-findings.js.map +1 -0
  603. package/dist/vertex-pricing.d.ts +8 -0
  604. package/dist/vertex-pricing.d.ts.map +1 -0
  605. package/dist/vertex-pricing.js +20 -0
  606. package/dist/vertex-pricing.js.map +1 -0
  607. package/dist/windows-path.d.ts +1 -0
  608. package/dist/windows-path.d.ts.map +1 -1
  609. package/dist/windows-path.js +27 -1
  610. package/dist/windows-path.js.map +1 -1
  611. package/dist/wiz-csv.d.ts +2 -2
  612. package/dist/wiz-csv.d.ts.map +1 -1
  613. package/dist/wiz-csv.js +1 -3
  614. package/dist/wiz-csv.js.map +1 -1
  615. package/dist/wiz-findings.d.ts +14 -2
  616. package/dist/wiz-findings.d.ts.map +1 -1
  617. package/dist/wiz-findings.js +143 -50
  618. package/dist/wiz-findings.js.map +1 -1
  619. package/docs/classify-severity-records.md +28 -13
  620. package/docs/cli.md +623 -843
  621. package/docs/dedupe-records.md +54 -24
  622. package/docs/findings-service.md +87 -47
  623. package/docs/hosted-remediation.md +14 -7
  624. package/docs/hosted-scans.md +64 -41
  625. package/docs/telemetry.md +236 -0
  626. package/docs/validate-records.md +78 -44
  627. package/package.json +19 -17
  628. package/schemas/external-findings.schema.json +14 -1
  629. package/schemas/hosted-scan-v2.fixture.json +16 -1
  630. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  631. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  632. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  633. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  634. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  635. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  636. package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
  637. package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
  638. package/dist/deduplication/records-protocol.d.ts +0 -4
  639. package/dist/deduplication/records-protocol.d.ts.map +0 -1
  640. package/dist/deduplication/records-protocol.js +0 -49
  641. package/dist/deduplication/records-protocol.js.map +0 -1
  642. package/dist/external-imports-feature.d.ts +0 -6
  643. package/dist/external-imports-feature.d.ts.map +0 -1
  644. package/dist/external-imports-feature.js +0 -51
  645. package/dist/external-imports-feature.js.map +0 -1
  646. package/dist/finding-normalization.d.ts +0 -5
  647. package/dist/finding-normalization.d.ts.map +0 -1
  648. package/dist/finding-normalization.js +0 -120
  649. package/dist/finding-normalization.js.map +0 -1
@@ -0,0 +1,225 @@
1
+ import { CodexSecurityError } from "./errors.js";
2
+ import { DEFAULT_CLOUD_STRING_BYTES, validateEnrichedExternalEvidence, } from "./external-import-contract.js";
3
+ import { isRecord } from "./record.js";
4
+ import { array, awsTimestampSeconds, concreteVersion, normalizeRecords, readScannerJson, record, repositoryFilePath, requiredText, strings, text, } from "./scanner-import.js";
5
+ import { declaredScannerRepositoryUrl, repositoryScopeValidator, } from "./scanner-repository-url.js";
6
+ const format = "aws-continuum-code-findings/v1";
7
+ const findingArn = /^(arn:[a-z0-9-]+:continuum:[a-z0-9-]+:\d{12}:environments\/([a-z0-9]+))\/code-findings\/([a-z0-9]+)$/u;
8
+ function identity(value) {
9
+ const row = record(value, "Continuum finding");
10
+ const arn = requiredText(row["findingArn"], "Continuum finding ARN");
11
+ const match = findingArn.exec(arn);
12
+ if (!match ||
13
+ row["environmentId"] !== match[2] ||
14
+ row["findingId"] !== match[3])
15
+ throw new Error("Expected a Continuum finding ARN matching its environmentId and findingId.");
16
+ return { arn, scope: match[1] };
17
+ }
18
+ function retainedRepository(provider, finding, target) {
19
+ const { source_finding_id: id, evidence: { source_data: data }, } = finding;
20
+ const native = data?.["finding"];
21
+ const marked = data?.["format"] === format;
22
+ const nativeArn = isRecord(native) && findingArn.test(text(native["findingArn"]) ?? "");
23
+ if (provider !== "continuum") {
24
+ if (marked ||
25
+ (data?.["sourceRepositoryUrl"] &&
26
+ nativeArn &&
27
+ native["findingArn"] === id))
28
+ throw new CodexSecurityError("Retained AWS Continuum evidence requires the continuum provider.");
29
+ return;
30
+ }
31
+ if (!marked && !nativeArn && !findingArn.test(id))
32
+ return;
33
+ const { arn, scope } = identity(native);
34
+ if (arn !== id)
35
+ throw new Error("Continuum source finding ID does not match the retained finding ARN.");
36
+ return {
37
+ url: declaredScannerRepositoryUrl(data?.["sourceRepositoryUrl"], "Continuum", target),
38
+ scope,
39
+ };
40
+ }
41
+ export const continuumReportRepositories = repositoryScopeValidator({ provider: "continuum", label: "AWS Continuum", scope: "environment" }, retainedRepository);
42
+ function codeLocations(row, vulnerabilities) {
43
+ const locations = [];
44
+ const seen = new Set();
45
+ let endLine = null;
46
+ let snippet = null;
47
+ function add(value, start, end, fragment) {
48
+ const path = repositoryFilePath(value);
49
+ if (!path)
50
+ return;
51
+ const line = typeof start === "number" && Number.isSafeInteger(start) && start > 0
52
+ ? start
53
+ : null;
54
+ const key = JSON.stringify([path, line]);
55
+ if (!seen.has(key)) {
56
+ seen.add(key);
57
+ locations.push({ path, line });
58
+ }
59
+ // The flat location and first nested location can describe the same range.
60
+ if (locations[0].path === path && locations[0].line === line) {
61
+ if (line !== null &&
62
+ typeof end === "number" &&
63
+ Number.isSafeInteger(end) &&
64
+ end >= line)
65
+ endLine ??= end;
66
+ snippet ??= text(fragment);
67
+ }
68
+ }
69
+ add(row["filePath"], row["lineNumber"], row["endLine"], row["vulnerableCode"]);
70
+ for (const vulnerability of vulnerabilities) {
71
+ for (const value of array(vulnerability["locations"] ?? [], "Continuum vulnerability locations")) {
72
+ const location = record(value, "Continuum vulnerability location");
73
+ add(location["filePath"], location["startLine"], location["endLine"], vulnerability["code"]);
74
+ }
75
+ }
76
+ return { locations, code: { end_line: endLine, snippet } };
77
+ }
78
+ function reportRows(input, previous) {
79
+ if (Array.isArray(input) && !previous)
80
+ return { rows: input, summary: false };
81
+ const document = record(input, "Continuum report");
82
+ if (Object.hasOwn(document, "nextToken") ||
83
+ Object.hasOwn(document, "NextToken"))
84
+ throw new Error("Continuum export has a continuation token; supply the complete paginated CLI output.");
85
+ if (!("items" in document || "findingArn" in document))
86
+ throw new Error("Expected a Continuum ListCodeFindings or GetCodeFinding response.");
87
+ const summary = "items" in document;
88
+ return {
89
+ rows: summary ? array(document["items"], "Continuum items") : [document],
90
+ summary,
91
+ };
92
+ }
93
+ function statusUpdatedAt(value) {
94
+ const seconds = Math.floor(awsTimestampSeconds(value));
95
+ return Number.isSafeInteger(seconds) && seconds >= 0 ? seconds : null;
96
+ }
97
+ const versionEcosystems = new Map([
98
+ ["gradle", "maven"],
99
+ ["pnpm", "npm"],
100
+ ["yarn", "npm"],
101
+ ]);
102
+ function affectedPackages(items, target) {
103
+ const unique = new Map();
104
+ const field = (value) => {
105
+ const result = text(value);
106
+ return result &&
107
+ !result.includes("\0") &&
108
+ (target === "local" ||
109
+ Buffer.byteLength(result) <= DEFAULT_CLOUD_STRING_BYTES)
110
+ ? result
111
+ : null;
112
+ };
113
+ for (const item of items) {
114
+ if (!isRecord(item))
115
+ continue;
116
+ const name = field(item["name"]);
117
+ if (!name)
118
+ continue;
119
+ const ecosystem = field(item["packageManager"]);
120
+ const manager = ecosystem?.toLowerCase();
121
+ const syntax = manager ? (versionEcosystems.get(manager) ?? manager) : null;
122
+ const version = (value) => concreteVersion(field(value), syntax, false);
123
+ const fixed = version(item["fixedInVersion"]);
124
+ const pkg = {
125
+ name,
126
+ ecosystem,
127
+ installed_version: version(item["version"]),
128
+ fixed_versions: fixed ? [fixed] : [],
129
+ };
130
+ unique.set(JSON.stringify(pkg), pkg);
131
+ // The Cloud contract accepts 100 structured packages. The native row keeps them all.
132
+ if (target === "cloud" && unique.size === 100)
133
+ break;
134
+ }
135
+ return [...unique.values()];
136
+ }
137
+ function normalize(input, sourceRepositoryUrl, target, previous) {
138
+ const repository = declaredScannerRepositoryUrl(sourceRepositoryUrl, "Continuum", target);
139
+ const { rows, summary } = reportRows(input, previous);
140
+ const scopes = new Set();
141
+ const output = normalizeRecords(rows, (value) => {
142
+ const row = record(value, "Continuum finding");
143
+ if (row["type"] !== "CONTINUUM_CODE_VULN" &&
144
+ row["type"] !== "CUSTOMER_CODE_VULN")
145
+ throw new Error("Expected a Continuum code vulnerability finding type.");
146
+ const severity = requiredText(row["severity"], "Continuum severity").toLowerCase();
147
+ const vulnerabilities = array(row["vulnerabilities"] ?? [], "Continuum vulnerabilities").map((item) => record(item, "Continuum vulnerability"));
148
+ const { locations, code } = codeLocations(row, vulnerabilities);
149
+ const source = requiredText(row["source"], "Continuum source");
150
+ const status = requiredText(row["status"], "Continuum status");
151
+ const validation = record(row["validation"] ?? {}, "Continuum validation");
152
+ const all = [row, ...vulnerabilities];
153
+ const advisoryIds = [
154
+ ...new Set(strings(all.map((item) => item["cveId"]))),
155
+ ];
156
+ const packages = all.flatMap((item) => Array.isArray(item["affectedPackages"]) ? item["affectedPackages"] : []);
157
+ const packageFinding = advisoryIds.length > 0 || packages.length > 0;
158
+ const posture = row["ocsfClass"] === "APPLICATION_SECURITY_POSTURE_FINDING" ||
159
+ row["posture"] != null;
160
+ const codeFinding = !summary &&
161
+ !posture &&
162
+ !packageFinding &&
163
+ (code.snippet !== null ||
164
+ locations.some((location) => location.line !== null));
165
+ const evidence = {
166
+ title: requiredText(row["title"], "Continuum title"),
167
+ severity: severity === "fatal"
168
+ ? "critical"
169
+ : severity === "other"
170
+ ? "unknown"
171
+ : severity,
172
+ description: text(row["detailedDescription"]) ?? text(row["summary"]),
173
+ locations,
174
+ advisory_ids: advisoryIds,
175
+ source_scan_id: text(row["scanRunId"]),
176
+ ...(codeFinding && {
177
+ details: {
178
+ kind: "sast",
179
+ repository: { url: repository },
180
+ scanner_origin: source,
181
+ scanner_verdict: text(validation["verdict"]),
182
+ source_status: status,
183
+ weakness_ids: strings(row["cweIds"]),
184
+ remediation_instructions: text(row["mitigation"]),
185
+ code,
186
+ },
187
+ }),
188
+ source_data: {
189
+ format,
190
+ sourceRepositoryUrl: repository,
191
+ finding: structuredClone(row),
192
+ },
193
+ };
194
+ const updatedAt = previous
195
+ ? null
196
+ : statusUpdatedAt(row["statusUpdatedAt"]);
197
+ // Keep the status timestamp when structured packages exceed the Cloud budget.
198
+ return validateEnrichedExternalEvidence(evidence, target, previous
199
+ ? undefined
200
+ : {
201
+ packages: affectedPackages(packages, target),
202
+ source_updated_at: updatedAt,
203
+ }, packages.length && updatedAt !== null
204
+ ? { source_updated_at: updatedAt }
205
+ : undefined);
206
+ }, (value) => {
207
+ const { arn, scope } = identity(value);
208
+ scopes.add(scope);
209
+ return arn;
210
+ }, target);
211
+ if (scopes.size > 1)
212
+ throw new Error("Continuum findings must belong to the same environment.");
213
+ return output;
214
+ }
215
+ export function normalizeContinuumFindings(input, sourceRepositoryUrl, target = "cloud") {
216
+ return normalize(input, sourceRepositoryUrl, target, false);
217
+ }
218
+ /** @internal Reconstruct the original evidence for an interrupted Cloud request. */
219
+ export function normalizePreviousContinuumFindings(input, sourceRepositoryUrl, target = "cloud") {
220
+ return normalize(input, sourceRepositoryUrl, target, true);
221
+ }
222
+ export async function readContinuumFindings(path, sourceRepositoryUrl, target = "cloud") {
223
+ return normalizeContinuumFindings(await readScannerJson(path), sourceRepositoryUrl, target);
224
+ }
225
+ //# sourceMappingURL=continuum-findings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"continuum-findings.js","sourceRoot":"","sources":["../src/continuum-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport {\n DEFAULT_CLOUD_STRING_BYTES,\n type ExternalImportTarget,\n validateEnrichedExternalEvidence,\n} from \"./external-import-contract.js\";\nimport type { ImportedPackage, Provider } from \"./external-import-models.js\";\nimport { isRecord } from \"./record.js\";\nimport {\n array,\n awsTimestampSeconds,\n concreteVersion,\n normalizeRecords,\n readScannerJson,\n record,\n repositoryFilePath,\n requiredText,\n strings,\n text,\n} from \"./scanner-import.js\";\nimport {\n declaredScannerRepositoryUrl,\n repositoryScopeValidator,\n} from \"./scanner-repository-url.js\";\n\nconst format = \"aws-continuum-code-findings/v1\";\nconst findingArn =\n /^(arn:[a-z0-9-]+:continuum:[a-z0-9-]+:\\d{12}:environments\\/([a-z0-9]+))\\/code-findings\\/([a-z0-9]+)$/u;\n\nfunction identity(value: unknown) {\n const row = record(value, \"Continuum finding\");\n const arn = requiredText(row[\"findingArn\"], \"Continuum finding ARN\");\n const match = findingArn.exec(arn);\n if (\n !match ||\n row[\"environmentId\"] !== match[2] ||\n row[\"findingId\"] !== match[3]\n )\n throw new Error(\n \"Expected a Continuum finding ARN matching its environmentId and findingId.\",\n );\n return { arn, scope: match[1]! };\n}\n\nfunction retainedRepository(\n provider: Provider,\n finding: ExternalFinding,\n target: ExternalImportTarget,\n) {\n const {\n source_finding_id: id,\n evidence: { source_data: data },\n } = finding;\n const native = data?.[\"finding\"];\n const marked = data?.[\"format\"] === format;\n const nativeArn =\n isRecord(native) && findingArn.test(text(native[\"findingArn\"]) ?? \"\");\n if (provider !== \"continuum\") {\n if (\n marked ||\n (data?.[\"sourceRepositoryUrl\"] &&\n nativeArn &&\n native[\"findingArn\"] === id)\n )\n throw new CodexSecurityError(\n \"Retained AWS Continuum evidence requires the continuum provider.\",\n );\n return;\n }\n if (!marked && !nativeArn && !findingArn.test(id)) return;\n const { arn, scope } = identity(native);\n if (arn !== id)\n throw new Error(\n \"Continuum source finding ID does not match the retained finding ARN.\",\n );\n return {\n url: declaredScannerRepositoryUrl(\n data?.[\"sourceRepositoryUrl\"],\n \"Continuum\",\n target,\n ),\n scope,\n };\n}\n\nexport const continuumReportRepositories = repositoryScopeValidator(\n { provider: \"continuum\", label: \"AWS Continuum\", scope: \"environment\" },\n retainedRepository,\n);\n\nfunction codeLocations(\n row: Record<string, unknown>,\n vulnerabilities: Record<string, unknown>[],\n) {\n const locations: { path: string; line: number | null }[] = [];\n const seen = new Set<string>();\n let endLine: number | null = null;\n let snippet: string | null = null;\n function add(\n value: unknown,\n start: unknown,\n end: unknown,\n fragment: unknown,\n ) {\n const path = repositoryFilePath(value);\n if (!path) return;\n const line =\n typeof start === \"number\" && Number.isSafeInteger(start) && start > 0\n ? start\n : null;\n const key = JSON.stringify([path, line]);\n if (!seen.has(key)) {\n seen.add(key);\n locations.push({ path, line });\n }\n // The flat location and first nested location can describe the same range.\n if (locations[0]!.path === path && locations[0]!.line === line) {\n if (\n line !== null &&\n typeof end === \"number\" &&\n Number.isSafeInteger(end) &&\n end >= line\n )\n endLine ??= end;\n snippet ??= text(fragment);\n }\n }\n add(\n row[\"filePath\"],\n row[\"lineNumber\"],\n row[\"endLine\"],\n row[\"vulnerableCode\"],\n );\n for (const vulnerability of vulnerabilities) {\n for (const value of array(\n vulnerability[\"locations\"] ?? [],\n \"Continuum vulnerability locations\",\n )) {\n const location = record(value, \"Continuum vulnerability location\");\n add(\n location[\"filePath\"],\n location[\"startLine\"],\n location[\"endLine\"],\n vulnerability[\"code\"],\n );\n }\n }\n return { locations, code: { end_line: endLine, snippet } };\n}\n\nfunction reportRows(input: unknown, previous: boolean) {\n if (Array.isArray(input) && !previous) return { rows: input, summary: false };\n const document = record(input, \"Continuum report\");\n if (\n Object.hasOwn(document, \"nextToken\") ||\n Object.hasOwn(document, \"NextToken\")\n )\n throw new Error(\n \"Continuum export has a continuation token; supply the complete paginated CLI output.\",\n );\n if (!(\"items\" in document || \"findingArn\" in document))\n throw new Error(\n \"Expected a Continuum ListCodeFindings or GetCodeFinding response.\",\n );\n const summary = \"items\" in document;\n return {\n rows: summary ? array(document[\"items\"], \"Continuum items\") : [document],\n summary,\n };\n}\n\nfunction statusUpdatedAt(value: unknown) {\n const seconds = Math.floor(awsTimestampSeconds(value));\n return Number.isSafeInteger(seconds) && seconds >= 0 ? seconds : null;\n}\n\nconst versionEcosystems = new Map([\n [\"gradle\", \"maven\"],\n [\"pnpm\", \"npm\"],\n [\"yarn\", \"npm\"],\n]);\n\nfunction affectedPackages(\n items: unknown[],\n target: ExternalImportTarget,\n): ImportedPackage[] {\n const unique = new Map<string, ImportedPackage>();\n const field = (value: unknown) => {\n const result = text(value);\n return result &&\n !result.includes(\"\\0\") &&\n (target === \"local\" ||\n Buffer.byteLength(result) <= DEFAULT_CLOUD_STRING_BYTES)\n ? result\n : null;\n };\n for (const item of items) {\n if (!isRecord(item)) continue;\n const name = field(item[\"name\"]);\n if (!name) continue;\n const ecosystem = field(item[\"packageManager\"]);\n const manager = ecosystem?.toLowerCase();\n const syntax = manager ? (versionEcosystems.get(manager) ?? manager) : null;\n const version = (value: unknown) =>\n concreteVersion(field(value), syntax, false);\n const fixed = version(item[\"fixedInVersion\"]);\n const pkg = {\n name,\n ecosystem,\n installed_version: version(item[\"version\"]),\n fixed_versions: fixed ? [fixed] : [],\n };\n unique.set(JSON.stringify(pkg), pkg);\n // The Cloud contract accepts 100 structured packages. The native row keeps them all.\n if (target === \"cloud\" && unique.size === 100) break;\n }\n return [...unique.values()];\n}\n\nfunction normalize(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget,\n previous: boolean,\n): ExternalFindings {\n const repository = declaredScannerRepositoryUrl(\n sourceRepositoryUrl,\n \"Continuum\",\n target,\n );\n const { rows, summary } = reportRows(input, previous);\n const scopes = new Set<string>();\n const output = normalizeRecords(\n rows,\n (value) => {\n const row = record(value, \"Continuum finding\");\n if (\n row[\"type\"] !== \"CONTINUUM_CODE_VULN\" &&\n row[\"type\"] !== \"CUSTOMER_CODE_VULN\"\n )\n throw new Error(\n \"Expected a Continuum code vulnerability finding type.\",\n );\n const severity = requiredText(\n row[\"severity\"],\n \"Continuum severity\",\n ).toLowerCase();\n const vulnerabilities = array(\n row[\"vulnerabilities\"] ?? [],\n \"Continuum vulnerabilities\",\n ).map((item) => record(item, \"Continuum vulnerability\"));\n const { locations, code } = codeLocations(row, vulnerabilities);\n const source = requiredText(row[\"source\"], \"Continuum source\");\n const status = requiredText(row[\"status\"], \"Continuum status\");\n const validation = record(\n row[\"validation\"] ?? {},\n \"Continuum validation\",\n );\n const all = [row, ...vulnerabilities];\n const advisoryIds = [\n ...new Set(strings(all.map((item) => item[\"cveId\"]))),\n ];\n const packages = all.flatMap((item) =>\n Array.isArray(item[\"affectedPackages\"]) ? item[\"affectedPackages\"] : [],\n );\n const packageFinding = advisoryIds.length > 0 || packages.length > 0;\n const posture =\n row[\"ocsfClass\"] === \"APPLICATION_SECURITY_POSTURE_FINDING\" ||\n row[\"posture\"] != null;\n const codeFinding =\n !summary &&\n !posture &&\n !packageFinding &&\n (code.snippet !== null ||\n locations.some((location) => location.line !== null));\n const evidence = {\n title: requiredText(row[\"title\"], \"Continuum title\"),\n severity:\n severity === \"fatal\"\n ? \"critical\"\n : severity === \"other\"\n ? \"unknown\"\n : severity,\n description: text(row[\"detailedDescription\"]) ?? text(row[\"summary\"]),\n locations,\n advisory_ids: advisoryIds,\n source_scan_id: text(row[\"scanRunId\"]),\n ...(codeFinding && {\n details: {\n kind: \"sast\",\n repository: { url: repository },\n scanner_origin: source,\n scanner_verdict: text(validation[\"verdict\"]),\n source_status: status,\n weakness_ids: strings(row[\"cweIds\"]),\n remediation_instructions: text(row[\"mitigation\"]),\n code,\n },\n }),\n source_data: {\n format,\n sourceRepositoryUrl: repository,\n finding: structuredClone(row),\n },\n };\n const updatedAt = previous\n ? null\n : statusUpdatedAt(row[\"statusUpdatedAt\"]);\n // Keep the status timestamp when structured packages exceed the Cloud budget.\n return validateEnrichedExternalEvidence(\n evidence,\n target,\n previous\n ? undefined\n : {\n packages: affectedPackages(packages, target),\n source_updated_at: updatedAt,\n },\n packages.length && updatedAt !== null\n ? { source_updated_at: updatedAt }\n : undefined,\n );\n },\n (value) => {\n const { arn, scope } = identity(value);\n scopes.add(scope);\n return arn;\n },\n target,\n );\n if (scopes.size > 1)\n throw new Error(\"Continuum findings must belong to the same environment.\");\n return output;\n}\n\nexport function normalizeContinuumFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n return normalize(input, sourceRepositoryUrl, target, false);\n}\n\n/** @internal Reconstruct the original evidence for an interrupted Cloud request. */\nexport function normalizePreviousContinuumFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n return normalize(input, sourceRepositoryUrl, target, true);\n}\n\nexport async function readContinuumFindings(\n path: string,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeContinuumFindings(\n await readScannerJson(path),\n sourceRepositoryUrl,\n target,\n );\n}\n"]}
@@ -0,0 +1,30 @@
1
+ import type { Finding } from "./models.js";
2
+ export declare class SealedContractError extends Error {
3
+ constructor(message: string, options?: ErrorOptions);
4
+ }
5
+ export declare class SealedContractSchemaError extends SealedContractError {
6
+ }
7
+ export declare const SEALED_DEFERRED_PATH_RULE = "invalidSealedDeferredPath";
8
+ export declare const DEFERRED_PATH_LOCATION: RegExp;
9
+ /** Match the producer's Python str.strip without changing saved text. */
10
+ export declare function hasRequiredFindingText(value: string): boolean;
11
+ /** Return canonical spelling for a valid scan-relative POSIX path. */
12
+ export declare function normalizedScanRelativePath(value: string, allowDot?: boolean): string | undefined;
13
+ export declare function safeRelativePath(value: string, context: string, allowDot?: boolean): string;
14
+ export declare function portableRelativePath(value: string, context: string): string;
15
+ export declare function safeScopePath(value: string): string;
16
+ export declare function deriveFindingIdentity(scanId: string, targetId: string, ruleId: string, identity: Finding["identity"]): {
17
+ findingId: string;
18
+ occurrenceId: string;
19
+ ruleId: string;
20
+ identity: {
21
+ [k: string]: unknown;
22
+ anchor: string;
23
+ instance?: string;
24
+ };
25
+ fingerprints: {
26
+ algorithm: "codex-security/v1";
27
+ primary: string;
28
+ };
29
+ };
30
+ //# sourceMappingURL=contract-values.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract-values.d.ts","sourceRoot":"","sources":["../src/contract-values.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAGlD;CACF;AAED,qBAAa,yBAA0B,SAAQ,mBAAmB;CAAG;AAErE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,sBAAsB,QAAuC,CAAC;AAE3E,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,sEAAsE;AACtE,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EACb,QAAQ,UAAQ,GACf,MAAM,GAAG,SAAS,CAmBpB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,UAAQ,GACf,MAAM,CAOR;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAW3E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAOD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;QAiBzB,SAAS,EAAE,mBAAmB;QAC9B,OAAO;;EAGZ"}
@@ -0,0 +1,78 @@
1
+ /* Generated from plugin contract-values.ts. Run `pnpm generate:models`. */
2
+ import { hash } from "node:crypto";
3
+ import { isAbsolute, posix } from "node:path";
4
+ import { isWindowsUnsafePathComponent } from "./windows-path.js";
5
+ export class SealedContractError extends Error {
6
+ constructor(message, options) {
7
+ super(message, options);
8
+ this.name = new.target.name;
9
+ }
10
+ }
11
+ export class SealedContractSchemaError extends SealedContractError {
12
+ }
13
+ export const SEALED_DEFERRED_PATH_RULE = "invalidSealedDeferredPath";
14
+ export const DEFERRED_PATH_LOCATION = /^\/deferred\/(\d+)\/paths\/(\d+)$/u;
15
+ /** Match the producer's Python str.strip without changing saved text. */
16
+ export function hasRequiredFindingText(value) {
17
+ return !/^[\p{White_Space}\u001c-\u001f]*$/u.test(value);
18
+ }
19
+ /** Return canonical spelling for a valid scan-relative POSIX path. */
20
+ export function normalizedScanRelativePath(value, allowDot = false) {
21
+ if (value.length === 0 ||
22
+ Buffer.from(value, "utf8").toString("utf8") !== value ||
23
+ value.startsWith("/") ||
24
+ /^[A-Za-z]:/.test(value) ||
25
+ value.split("/").includes("..") ||
26
+ value.includes("\\") ||
27
+ /[\u0000-\u001f]/u.test(value))
28
+ return;
29
+ const normalized = posix.normalize(value).replace(/\/+$/, "");
30
+ if ((!allowDot && normalized === ".") ||
31
+ normalized.startsWith("../") ||
32
+ isAbsolute(normalized))
33
+ return;
34
+ return normalized;
35
+ }
36
+ export function safeRelativePath(value, context, allowDot = false) {
37
+ const normalized = normalizedScanRelativePath(value, allowDot);
38
+ if (normalized === undefined)
39
+ throw new SealedContractError(`${context}: expected a safe scan-relative POSIX path.`);
40
+ return normalized;
41
+ }
42
+ export function portableRelativePath(value, context) {
43
+ const normalized = safeRelativePath(value, context);
44
+ if (value.trim().length === 0 ||
45
+ value.split("/").some(isWindowsUnsafePathComponent)) {
46
+ throw new SealedContractError(`${context}: expected a safe scan-relative POSIX path.`);
47
+ }
48
+ return normalized;
49
+ }
50
+ export function safeScopePath(value) {
51
+ return value === "."
52
+ ? value
53
+ : safeRelativePath(value, "manifest scope include path");
54
+ }
55
+ /** @internal */
56
+ export function sha256Text(value) {
57
+ return hash("sha256", value);
58
+ }
59
+ export function deriveFindingIdentity(scanId, targetId, ruleId, identity) {
60
+ const fingerprint = `codex-security/v1:sha256:${sha256Text([
61
+ "codex-security/v1",
62
+ targetId,
63
+ ruleId,
64
+ identity.anchor,
65
+ identity.instance ?? "",
66
+ ].join("\0"))}`;
67
+ return {
68
+ findingId: `csf_${sha256Text(fingerprint).slice(0, 24)}`,
69
+ occurrenceId: `occ_${sha256Text([scanId, fingerprint].join("\0")).slice(0, 24)}`,
70
+ ruleId,
71
+ identity,
72
+ fingerprints: {
73
+ algorithm: "codex-security/v1",
74
+ primary: fingerprint,
75
+ },
76
+ };
77
+ }
78
+ //# sourceMappingURL=contract-values.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract-values.js","sourceRoot":"","sources":["../src/contract-values.ts"],"names":[],"mappings":"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","sourcesContent":["/* Generated from plugin contract-values.ts. Run `pnpm generate:models`. */\nimport { hash } from \"node:crypto\";\nimport { isAbsolute, posix } from \"node:path\";\nimport type { Finding } from \"./models.js\";\nimport { isWindowsUnsafePathComponent } from \"./windows-path.js\";\n\nexport class SealedContractError extends Error {\n constructor(message: string, options?: ErrorOptions) {\n super(message, options);\n this.name = new.target.name;\n }\n}\n\nexport class SealedContractSchemaError extends SealedContractError {}\n\nexport const SEALED_DEFERRED_PATH_RULE = \"invalidSealedDeferredPath\";\nexport const DEFERRED_PATH_LOCATION = /^\\/deferred\\/(\\d+)\\/paths\\/(\\d+)$/u;\n\n/** Match the producer's Python str.strip without changing saved text. */\nexport function hasRequiredFindingText(value: string): boolean {\n return !/^[\\p{White_Space}\\u001c-\\u001f]*$/u.test(value);\n}\n\n/** Return canonical spelling for a valid scan-relative POSIX path. */\nexport function normalizedScanRelativePath(\n value: string,\n allowDot = false,\n): string | undefined {\n if (\n value.length === 0 ||\n Buffer.from(value, \"utf8\").toString(\"utf8\") !== value ||\n value.startsWith(\"/\") ||\n /^[A-Za-z]:/.test(value) ||\n value.split(\"/\").includes(\"..\") ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001f]/u.test(value)\n )\n return;\n const normalized = posix.normalize(value).replace(/\\/+$/, \"\");\n if (\n (!allowDot && normalized === \".\") ||\n normalized.startsWith(\"../\") ||\n isAbsolute(normalized)\n )\n return;\n return normalized;\n}\n\nexport function safeRelativePath(\n value: string,\n context: string,\n allowDot = false,\n): string {\n const normalized = normalizedScanRelativePath(value, allowDot);\n if (normalized === undefined)\n throw new SealedContractError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n return normalized;\n}\n\nexport function portableRelativePath(value: string, context: string): string {\n const normalized = safeRelativePath(value, context);\n if (\n value.trim().length === 0 ||\n value.split(\"/\").some(isWindowsUnsafePathComponent)\n ) {\n throw new SealedContractError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n return normalized;\n}\n\nexport function safeScopePath(value: string): string {\n return value === \".\"\n ? value\n : safeRelativePath(value, \"manifest scope include path\");\n}\n\n/** @internal */\nexport function sha256Text(value: string): string {\n return hash(\"sha256\", value);\n}\n\nexport function deriveFindingIdentity(\n scanId: string,\n targetId: string,\n ruleId: string,\n identity: Finding[\"identity\"],\n) {\n const fingerprint = `codex-security/v1:sha256:${sha256Text(\n [\n \"codex-security/v1\",\n targetId,\n ruleId,\n identity.anchor,\n identity.instance ?? \"\",\n ].join(\"\\0\"),\n )}`;\n return {\n findingId: `csf_${sha256Text(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256Text([scanId, fingerprint].join(\"\\0\")).slice(0, 24)}`,\n ruleId,\n identity,\n fingerprints: {\n algorithm: \"codex-security/v1\" as const,\n primary: fingerprint,\n },\n };\n}\n"]}
@@ -1,8 +1,9 @@
1
1
  import { type BigIntStats, type Stats } from "node:fs";
2
2
  import { type FileHandle } from "node:fs/promises";
3
3
  import { ContractValidationError } from "./errors.js";
4
- import type { Finding, FindingsDocument, ScanManifest } from "./models.js";
4
+ import type { FindingsDocument, ScanManifest } from "./models.js";
5
5
  import type { NormalizedTarget, ScanMode } from "./targets.js";
6
+ export { DEFERRED_PATH_LOCATION, SEALED_DEFERRED_PATH_RULE, deriveFindingIdentity, hasRequiredFindingText, } from "./contract-values.js";
6
7
  export interface ScanExpectation {
7
8
  repository: string;
8
9
  repositoryRevision: string | null;
@@ -19,8 +20,6 @@ export interface LoadedContract {
19
20
  export declare const validatedFileDigests: WeakMap<ScanManifest, ReadonlyMap<string, string>>;
20
21
  export declare class ContractSchemaError extends ContractValidationError {
21
22
  }
22
- export declare const SEALED_DEFERRED_PATH_RULE = "invalidSealedDeferredPath";
23
- export declare const DEFERRED_PATH_LOCATION: RegExp;
24
23
  type LoadContractOptions = {
25
24
  pluginRoot: string;
26
25
  expectedScanId?: string;
@@ -33,8 +32,6 @@ export declare function loadContractWithScanDirectory(scanDirectory: string, opt
33
32
  contract: LoadedContract;
34
33
  scanDirectory: string;
35
34
  }>;
36
- /** Match the producer's Python str.strip without changing saved text. */
37
- export declare function hasRequiredFindingText(value: string): boolean;
38
35
  export declare function requireScanFile(scanDirectory: string, relativePath: string, context: string, signal?: AbortSignal): Promise<string>;
39
36
  export declare function readScanFile(scanDirectory: string, relativePath: string, context: string, signal?: AbortSignal): Promise<Buffer>;
40
37
  export declare function safeScopePath(value: string): string;
@@ -42,19 +39,4 @@ export declare function sameCheckedFileDevice(file: FileHandle, checked: {
42
39
  path: string;
43
40
  metadata: Pick<Stats | BigIntStats, "dev" | "ino">;
44
41
  }, opened: Pick<Stats | BigIntStats, "dev" | "ino">, platform?: NodeJS.Platform, openReference?: (path: string, flags: number) => Promise<FileHandle>): Promise<boolean>;
45
- export declare function deriveFindingIdentity(scanId: string, targetId: string, ruleId: string, identity: Finding["identity"]): {
46
- findingId: string;
47
- occurrenceId: string;
48
- ruleId: string;
49
- identity: {
50
- [k: string]: unknown;
51
- anchor: string;
52
- instance?: string;
53
- };
54
- fingerprints: {
55
- algorithm: "codex-security/v1";
56
- primary: string;
57
- };
58
- };
59
- export {};
60
42
  //# sourceMappingURL=contract.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,uBAAuB,EAGxB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAEV,OAAO,EACP,gBAAgB,EAChB,YAAY,EACb,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAqB/D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;CACrD;AAGD,eAAO,MAAM,oBAAoB,oDAG9B,CAAC;AAEJ,qBAAa,mBAAoB,SAAQ,uBAAuB;CAAG;AAEnE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,eAAO,MAAM,sBAAsB,QAAuC,CAAC;AAE3E,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CA+H9D;AAeD,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE7D;AAsLD,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAgXD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AA0PD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,KAAK,GAAG,KAAK,CAAC,CAAA;CAAE,EAC7E,MAAM,EAAE,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,KAAK,GAAG,KAAK,CAAC,EAChD,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,aAAa,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAQ,GACzE,OAAO,CAAC,OAAO,CAAC,CA+BlB;AA2DD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC;;;;;;;;;;QAiBzB,SAAS,EAAE,mBAAmB;QAC9B,OAAO;;EAGZ"}
1
+ {"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGhE,OAAO,EAAE,uBAAuB,EAAe,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAEV,gBAAgB,EAChB,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;CACrD;AAGD,eAAO,MAAM,oBAAoB,oDAG9B,CAAC;AAEJ,qBAAa,mBAAoB,SAAQ,uBAAuB;CAAG;AAEnE,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AA+BF,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB9D;AAED,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASnD;AAuFD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,KAAK,GAAG,KAAK,CAAC,CAAA;CAAE,EAC7E,MAAM,EAAE,IAAI,CAAC,KAAK,GAAG,WAAW,EAAE,KAAK,GAAG,KAAK,CAAC,EAChD,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,aAAa,GAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAQ,GACzE,OAAO,CAAC,OAAO,CAAC,CA+BlB"}