@openai/codex-security 0.8.3 → 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 (534) hide show
  1. package/README.md +192 -151
  2. package/_bundled_plugin/.mcp.json +5 -1
  3. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  4. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  5. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  6. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  7. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  8. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  9. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  10. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/package.json +1 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  20. package/_bundled_plugin/mcp/server.mjs +2 -11
  21. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  22. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  23. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  24. package/_bundled_plugin/references/final-report.md +5 -3
  25. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  26. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  27. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  28. package/_bundled_plugin/references/scan-contract.md +27 -33
  29. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  30. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  31. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  32. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  33. package/_bundled_plugin/scripts/deep_scan_workbench.py +165 -342
  34. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  35. package/_bundled_plugin/scripts/finalize_scan_contract.py +153 -227
  36. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  37. package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
  38. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  39. package/_bundled_plugin/scripts/posix_scan_local_files.py +11 -0
  40. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  41. package/_bundled_plugin/scripts/report_projection.py +81 -43
  42. package/_bundled_plugin/scripts/review_state.py +8 -2
  43. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  44. package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
  45. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  46. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  47. package/_bundled_plugin/scripts/windows_scan_local_files.py +388 -17
  48. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  49. package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
  50. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  51. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  52. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  53. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  54. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  55. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  56. package/_bundled_plugin/scripts/workbench/storage.py +71 -7
  57. package/_bundled_plugin/scripts/workbench_cli.py +30 -12
  58. package/_bundled_plugin/scripts/workbench_constants.py +10 -0
  59. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  60. package/_bundled_plugin/scripts/workbench_db.py +369 -137
  61. package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
  62. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  63. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  64. package/_bundled_plugin/scripts/workbench_native_indexes.py +12 -12
  65. package/_bundled_plugin/scripts/workbench_progress.py +10 -1
  66. package/_bundled_plugin/scripts/workbench_publication.py +14 -10
  67. package/_bundled_plugin/scripts/workbench_remediation.py +13 -0
  68. package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
  69. package/_bundled_plugin/scripts/workbench_scan_history.py +117 -55
  70. package/_bundled_plugin/scripts/workbench_scan_start.py +83 -24
  71. package/_bundled_plugin/scripts/workbench_scan_usage.py +644 -68
  72. package/_bundled_plugin/scripts/workbench_schema.py +44 -55
  73. package/_bundled_plugin/scripts/workbench_setup.py +13 -1
  74. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  75. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  76. package/_bundled_plugin/scripts/workbench_target.py +127 -56
  77. package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
  78. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  79. package/_bundled_plugin/shared/workbench-history-repairs.json +19 -23
  80. package/_bundled_plugin/shared/workbench-migrations.json +34 -0
  81. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  82. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  83. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -1
  84. package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -25
  85. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  86. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  87. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
  88. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  89. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  90. package/dist/api.d.ts +39 -4
  91. package/dist/api.d.ts.map +1 -1
  92. package/dist/api.js +774 -292
  93. package/dist/api.js.map +1 -1
  94. package/dist/auth.d.ts.map +1 -1
  95. package/dist/auth.js +4 -6
  96. package/dist/auth.js.map +1 -1
  97. package/dist/bedrock-oss-pricing.d.ts +6 -0
  98. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  99. package/dist/bedrock-oss-pricing.js +58 -0
  100. package/dist/bedrock-oss-pricing.js.map +1 -0
  101. package/dist/bedrock-pricing.d.ts +15 -0
  102. package/dist/bedrock-pricing.d.ts.map +1 -0
  103. package/dist/bedrock-pricing.js +117 -0
  104. package/dist/bedrock-pricing.js.map +1 -0
  105. package/dist/blackduck-findings.d.ts.map +1 -1
  106. package/dist/blackduck-findings.js +35 -20
  107. package/dist/blackduck-findings.js.map +1 -1
  108. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  109. package/dist/bulk-scan-discovery.js +4 -4
  110. package/dist/bulk-scan-discovery.js.map +1 -1
  111. package/dist/checkmarx-evidence.d.ts +19 -0
  112. package/dist/checkmarx-evidence.d.ts.map +1 -0
  113. package/dist/checkmarx-evidence.js +36 -0
  114. package/dist/checkmarx-evidence.js.map +1 -0
  115. package/dist/checkmarx-findings.d.ts +4 -0
  116. package/dist/checkmarx-findings.d.ts.map +1 -0
  117. package/dist/checkmarx-findings.js +27 -0
  118. package/dist/checkmarx-findings.js.map +1 -0
  119. package/dist/checkmarx-one.d.ts +4 -0
  120. package/dist/checkmarx-one.d.ts.map +1 -0
  121. package/dist/checkmarx-one.js +53 -0
  122. package/dist/checkmarx-one.js.map +1 -0
  123. package/dist/checkmarx-repository.d.ts +12 -0
  124. package/dist/checkmarx-repository.d.ts.map +1 -0
  125. package/dist/checkmarx-repository.js +181 -0
  126. package/dist/checkmarx-repository.js.map +1 -0
  127. package/dist/checkmarx-xml.d.ts +12 -0
  128. package/dist/checkmarx-xml.d.ts.map +1 -0
  129. package/dist/checkmarx-xml.js +196 -0
  130. package/dist/checkmarx-xml.js.map +1 -0
  131. package/dist/classify-severity-records.d.ts +1 -9
  132. package/dist/classify-severity-records.d.ts.map +1 -1
  133. package/dist/classify-severity-records.js +3 -13
  134. package/dist/classify-severity-records.js.map +1 -1
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +2 -4
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli.d.ts +11 -5
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1734 -1238
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.js +2 -2
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/component-scan.d.ts +16 -3
  145. package/dist/component-scan.d.ts.map +1 -1
  146. package/dist/component-scan.js +27 -2
  147. package/dist/component-scan.js.map +1 -1
  148. package/dist/config.d.ts.map +1 -1
  149. package/dist/config.js +100 -66
  150. package/dist/config.js.map +1 -1
  151. package/dist/continuum-findings.d.ts.map +1 -1
  152. package/dist/continuum-findings.js +80 -12
  153. package/dist/continuum-findings.js.map +1 -1
  154. package/dist/contract-values.d.ts +2 -0
  155. package/dist/contract-values.d.ts.map +1 -1
  156. package/dist/contract-values.js +12 -9
  157. package/dist/contract-values.js.map +1 -1
  158. package/dist/cost-model.d.ts +13 -1
  159. package/dist/cost-model.d.ts.map +1 -1
  160. package/dist/cost-model.js +66 -112
  161. package/dist/cost-model.js.map +1 -1
  162. package/dist/cost.d.ts +42 -3
  163. package/dist/cost.d.ts.map +1 -1
  164. package/dist/cost.js +483 -104
  165. package/dist/cost.js.map +1 -1
  166. package/dist/custom-publish.d.ts +4 -0
  167. package/dist/custom-publish.d.ts.map +1 -1
  168. package/dist/custom-publish.js +40 -3
  169. package/dist/custom-publish.js.map +1 -1
  170. package/dist/deduplication/local.d.ts +2 -2
  171. package/dist/deduplication/local.d.ts.map +1 -1
  172. package/dist/deduplication/local.js +2 -2
  173. package/dist/deduplication/local.js.map +1 -1
  174. package/dist/deduplication/refusal.d.ts.map +1 -1
  175. package/dist/deduplication/refusal.js +25 -5
  176. package/dist/deduplication/refusal.js.map +1 -1
  177. package/dist/deduplication/scan.d.ts +3 -0
  178. package/dist/deduplication/scan.d.ts.map +1 -1
  179. package/dist/deduplication/scan.js +1 -1
  180. package/dist/deduplication/scan.js.map +1 -1
  181. package/dist/deep-config.d.ts +0 -1
  182. package/dist/deep-config.d.ts.map +1 -1
  183. package/dist/deep-config.js +22 -33
  184. package/dist/deep-config.js.map +1 -1
  185. package/dist/deep-scan-defaults.d.ts +2 -0
  186. package/dist/deep-scan-defaults.d.ts.map +1 -1
  187. package/dist/deep-scan-defaults.js +28 -1
  188. package/dist/deep-scan-defaults.js.map +1 -1
  189. package/dist/deep-scan.d.ts +2 -0
  190. package/dist/deep-scan.d.ts.map +1 -1
  191. package/dist/deep-scan.js +28 -4
  192. package/dist/deep-scan.js.map +1 -1
  193. package/dist/default-severity-rubric.d.ts +1 -1
  194. package/dist/default-severity-rubric.d.ts.map +1 -1
  195. package/dist/default-severity-rubric.js +1 -1
  196. package/dist/default-severity-rubric.js.map +1 -1
  197. package/dist/endor-findings.d.ts +3 -1
  198. package/dist/endor-findings.d.ts.map +1 -1
  199. package/dist/endor-findings.js +103 -45
  200. package/dist/endor-findings.js.map +1 -1
  201. package/dist/errors.d.ts +1 -1
  202. package/dist/errors.d.ts.map +1 -1
  203. package/dist/errors.js +8 -1
  204. package/dist/errors.js.map +1 -1
  205. package/dist/external-findings-import.d.ts +5 -3
  206. package/dist/external-findings-import.d.ts.map +1 -1
  207. package/dist/external-findings-import.js +7 -6
  208. package/dist/external-findings-import.js.map +1 -1
  209. package/dist/external-findings-local.d.ts +7 -5
  210. package/dist/external-findings-local.d.ts.map +1 -1
  211. package/dist/external-findings-local.js +337 -89
  212. package/dist/external-findings-local.js.map +1 -1
  213. package/dist/external-findings-publish.d.ts +8 -6
  214. package/dist/external-findings-publish.d.ts.map +1 -1
  215. package/dist/external-findings-publish.js +1318 -258
  216. package/dist/external-findings-publish.js.map +1 -1
  217. package/dist/external-findings-read.d.ts +20 -2
  218. package/dist/external-findings-read.d.ts.map +1 -1
  219. package/dist/external-findings-read.js +148 -66
  220. package/dist/external-findings-read.js.map +1 -1
  221. package/dist/external-findings.d.ts +15 -3
  222. package/dist/external-findings.d.ts.map +1 -1
  223. package/dist/external-findings.js +42 -1
  224. package/dist/external-findings.js.map +1 -1
  225. package/dist/external-import-contract.d.ts +5 -1
  226. package/dist/external-import-contract.d.ts.map +1 -1
  227. package/dist/external-import-contract.js +23 -9
  228. package/dist/external-import-contract.js.map +1 -1
  229. package/dist/external-import-models.d.ts +1 -1
  230. package/dist/external-import-models.d.ts.map +1 -1
  231. package/dist/external-import-models.js.map +1 -1
  232. package/dist/feedback.d.ts.map +1 -1
  233. package/dist/feedback.js +5 -4
  234. package/dist/feedback.js.map +1 -1
  235. package/dist/finding-prompt.d.ts +5 -0
  236. package/dist/finding-prompt.d.ts.map +1 -0
  237. package/dist/finding-prompt.js +32 -0
  238. package/dist/finding-prompt.js.map +1 -0
  239. package/dist/findings-client.d.ts +1 -0
  240. package/dist/findings-client.d.ts.map +1 -1
  241. package/dist/findings-client.js +27 -3
  242. package/dist/findings-client.js.map +1 -1
  243. package/dist/github-advisories.d.ts.map +1 -1
  244. package/dist/github-advisories.js +0 -2
  245. package/dist/github-advisories.js.map +1 -1
  246. package/dist/github-dependabot-findings.d.ts.map +1 -1
  247. package/dist/github-dependabot-findings.js +15 -4
  248. package/dist/github-dependabot-findings.js.map +1 -1
  249. package/dist/github-findings.d.ts +4 -1
  250. package/dist/github-findings.d.ts.map +1 -1
  251. package/dist/github-findings.js +55 -30
  252. package/dist/github-findings.js.map +1 -1
  253. package/dist/hosted-git-remotes.d.ts +5 -0
  254. package/dist/hosted-git-remotes.d.ts.map +1 -0
  255. package/dist/hosted-git-remotes.js +285 -0
  256. package/dist/hosted-git-remotes.js.map +1 -0
  257. package/dist/hosted-git-repository.d.ts +28 -0
  258. package/dist/hosted-git-repository.d.ts.map +1 -0
  259. package/dist/hosted-git-repository.js +222 -0
  260. package/dist/hosted-git-repository.js.map +1 -0
  261. package/dist/hosted-scan-protocol.js +2 -2
  262. package/dist/hosted-scan-protocol.js.map +1 -1
  263. package/dist/hosted-scan.d.ts.map +1 -1
  264. package/dist/hosted-scan.js +16 -11
  265. package/dist/hosted-scan.js.map +1 -1
  266. package/dist/hosted-scanner-http.d.ts +21 -0
  267. package/dist/hosted-scanner-http.d.ts.map +1 -0
  268. package/dist/hosted-scanner-http.js +204 -0
  269. package/dist/hosted-scanner-http.js.map +1 -0
  270. package/dist/hosted-scanner-v1.d.ts +6 -0
  271. package/dist/hosted-scanner-v1.d.ts.map +1 -0
  272. package/dist/hosted-scanner-v1.js +60 -0
  273. package/dist/hosted-scanner-v1.js.map +1 -0
  274. package/dist/import-scan.d.ts.map +1 -1
  275. package/dist/import-scan.js +3 -0
  276. package/dist/import-scan.js.map +1 -1
  277. package/dist/index.d.ts +18 -7
  278. package/dist/index.d.ts.map +1 -1
  279. package/dist/index.js +10 -2
  280. package/dist/index.js.map +1 -1
  281. package/dist/inspector-findings.d.ts.map +1 -1
  282. package/dist/inspector-findings.js +47 -65
  283. package/dist/inspector-findings.js.map +1 -1
  284. package/dist/knowledge-base.d.ts.map +1 -1
  285. package/dist/knowledge-base.js +68 -5
  286. package/dist/knowledge-base.js.map +1 -1
  287. package/dist/local-git-metadata.d.ts +1 -1
  288. package/dist/local-git-metadata.d.ts.map +1 -1
  289. package/dist/local-git-metadata.js +1 -2
  290. package/dist/local-git-metadata.js.map +1 -1
  291. package/dist/multiscan.d.ts +6 -4
  292. package/dist/multiscan.d.ts.map +1 -1
  293. package/dist/multiscan.js +138 -65
  294. package/dist/multiscan.js.map +1 -1
  295. package/dist/native-json-findings.d.ts +2 -1
  296. package/dist/native-json-findings.d.ts.map +1 -1
  297. package/dist/native-json-findings.js +12 -2
  298. package/dist/native-json-findings.js.map +1 -1
  299. package/dist/opengrep-findings.d.ts +1 -0
  300. package/dist/opengrep-findings.d.ts.map +1 -1
  301. package/dist/opengrep-findings.js +17 -13
  302. package/dist/opengrep-findings.js.map +1 -1
  303. package/dist/operation-telemetry.d.ts +104 -0
  304. package/dist/operation-telemetry.d.ts.map +1 -0
  305. package/dist/operation-telemetry.js +293 -0
  306. package/dist/operation-telemetry.js.map +1 -0
  307. package/dist/plugin-python-probe.d.ts +4 -0
  308. package/dist/plugin-python-probe.d.ts.map +1 -0
  309. package/dist/plugin-python-probe.js +10 -0
  310. package/dist/plugin-python-probe.js.map +1 -0
  311. package/dist/private-finding-import.d.ts +97 -2
  312. package/dist/private-finding-import.d.ts.map +1 -1
  313. package/dist/private-finding-import.js +58 -34
  314. package/dist/private-finding-import.js.map +1 -1
  315. package/dist/provider-profile.d.ts +1 -1
  316. package/dist/provider-profile.d.ts.map +1 -1
  317. package/dist/provider-profile.js +8 -1
  318. package/dist/provider-profile.js.map +1 -1
  319. package/dist/publication-telemetry.d.ts +45 -0
  320. package/dist/publication-telemetry.d.ts.map +1 -0
  321. package/dist/publication-telemetry.js +50 -0
  322. package/dist/publication-telemetry.js.map +1 -0
  323. package/dist/publish.d.ts +4 -0
  324. package/dist/publish.d.ts.map +1 -1
  325. package/dist/publish.js +42 -2
  326. package/dist/publish.js.map +1 -1
  327. package/dist/reader-selection.d.ts +2 -0
  328. package/dist/reader-selection.d.ts.map +1 -1
  329. package/dist/reader-selection.js +8 -0
  330. package/dist/reader-selection.js.map +1 -1
  331. package/dist/remediation.d.ts +1 -4
  332. package/dist/remediation.d.ts.map +1 -1
  333. package/dist/remediation.js +3 -7
  334. package/dist/remediation.js.map +1 -1
  335. package/dist/request-metadata.d.ts +3 -0
  336. package/dist/request-metadata.d.ts.map +1 -1
  337. package/dist/request-metadata.js +9 -0
  338. package/dist/request-metadata.js.map +1 -1
  339. package/dist/result.d.ts +4 -0
  340. package/dist/result.d.ts.map +1 -1
  341. package/dist/result.js +1 -1
  342. package/dist/result.js.map +1 -1
  343. package/dist/retry-windows-rename.d.ts +8 -0
  344. package/dist/retry-windows-rename.d.ts.map +1 -0
  345. package/dist/retry-windows-rename.js +24 -0
  346. package/dist/retry-windows-rename.js.map +1 -0
  347. package/dist/runtime.d.ts +20 -0
  348. package/dist/runtime.d.ts.map +1 -1
  349. package/dist/runtime.js +313 -110
  350. package/dist/runtime.js.map +1 -1
  351. package/dist/saved-scan-bootstrap.d.ts +1 -0
  352. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  353. package/dist/saved-scan-bootstrap.js +18 -15
  354. package/dist/saved-scan-bootstrap.js.map +1 -1
  355. package/dist/scan-activity.d.ts.map +1 -1
  356. package/dist/scan-activity.js +141 -56
  357. package/dist/scan-activity.js.map +1 -1
  358. package/dist/scan-comparison.d.ts +10 -5
  359. package/dist/scan-comparison.d.ts.map +1 -1
  360. package/dist/scan-comparison.js +60 -15
  361. package/dist/scan-comparison.js.map +1 -1
  362. package/dist/scan-dashboard.d.ts +6 -6
  363. package/dist/scan-dashboard.d.ts.map +1 -1
  364. package/dist/scan-dashboard.js +75 -42
  365. package/dist/scan-dashboard.js.map +1 -1
  366. package/dist/scan-executor.d.ts +10 -1
  367. package/dist/scan-executor.d.ts.map +1 -1
  368. package/dist/scan-executor.js +22 -2
  369. package/dist/scan-executor.js.map +1 -1
  370. package/dist/scan-history-renderer.d.ts.map +1 -1
  371. package/dist/scan-history-renderer.js +9 -19
  372. package/dist/scan-history-renderer.js.map +1 -1
  373. package/dist/scan-logs.d.ts +12 -0
  374. package/dist/scan-logs.d.ts.map +1 -1
  375. package/dist/scan-logs.js +106 -77
  376. package/dist/scan-logs.js.map +1 -1
  377. package/dist/scan-measurement.d.ts +26 -0
  378. package/dist/scan-measurement.d.ts.map +1 -0
  379. package/dist/scan-measurement.js +77 -0
  380. package/dist/scan-measurement.js.map +1 -0
  381. package/dist/scan-progress.d.ts +1 -0
  382. package/dist/scan-progress.d.ts.map +1 -1
  383. package/dist/scan-progress.js +3 -0
  384. package/dist/scan-progress.js.map +1 -1
  385. package/dist/scan-sessions.d.ts.map +1 -1
  386. package/dist/scan-sessions.js +4 -1
  387. package/dist/scan-sessions.js.map +1 -1
  388. package/dist/scan-settings.d.ts +1 -1
  389. package/dist/scan-settings.d.ts.map +1 -1
  390. package/dist/scan-settings.js +1 -24
  391. package/dist/scan-settings.js.map +1 -1
  392. package/dist/scanner-import.d.ts +20 -2
  393. package/dist/scanner-import.d.ts.map +1 -1
  394. package/dist/scanner-import.js +200 -8
  395. package/dist/scanner-import.js.map +1 -1
  396. package/dist/scanner-repository-url.d.ts +4 -1
  397. package/dist/scanner-repository-url.d.ts.map +1 -1
  398. package/dist/scanner-repository-url.js +10 -6
  399. package/dist/scanner-repository-url.js.map +1 -1
  400. package/dist/security-policy.d.ts +1 -1
  401. package/dist/security-policy.d.ts.map +1 -1
  402. package/dist/security-policy.js.map +1 -1
  403. package/dist/semgrep-findings.d.ts +6 -3
  404. package/dist/semgrep-findings.d.ts.map +1 -1
  405. package/dist/semgrep-findings.js +107 -43
  406. package/dist/semgrep-findings.js.map +1 -1
  407. package/dist/semgrep-guardian-findings.d.ts +38 -0
  408. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  409. package/dist/semgrep-guardian-findings.js +165 -0
  410. package/dist/semgrep-guardian-findings.js.map +1 -0
  411. package/dist/semgrep-platform-collector.d.ts +26 -0
  412. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  413. package/dist/semgrep-platform-collector.js +108 -0
  414. package/dist/semgrep-platform-collector.js.map +1 -0
  415. package/dist/semgrep-platform-findings.d.ts +207 -6
  416. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  417. package/dist/semgrep-platform-findings.js +983 -103
  418. package/dist/semgrep-platform-findings.js.map +1 -1
  419. package/dist/semgrep-platform-v1.d.ts +6 -0
  420. package/dist/semgrep-platform-v1.d.ts.map +1 -0
  421. package/dist/semgrep-platform-v1.js +83 -0
  422. package/dist/semgrep-platform-v1.js.map +1 -0
  423. package/dist/server/api.d.ts +1 -1
  424. package/dist/server/api.d.ts.map +1 -1
  425. package/dist/server/api.js.map +1 -1
  426. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  427. package/dist/server/embedding-tokenizer.d.ts +2 -0
  428. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  429. package/dist/server/embedding-tokenizer.js +322 -0
  430. package/dist/server/embedding-tokenizer.js.map +6 -0
  431. package/dist/server/embeddings.d.ts +16 -2
  432. package/dist/server/embeddings.d.ts.map +1 -1
  433. package/dist/server/embeddings.js +35 -5
  434. package/dist/server/embeddings.js.map +1 -1
  435. package/dist/session-lines.d.ts +5 -0
  436. package/dist/session-lines.d.ts.map +1 -0
  437. package/dist/session-lines.js +60 -0
  438. package/dist/session-lines.js.map +1 -0
  439. package/dist/severity-review.d.ts +3 -1
  440. package/dist/severity-review.d.ts.map +1 -1
  441. package/dist/severity-review.js +3 -2
  442. package/dist/severity-review.js.map +1 -1
  443. package/dist/skill-authentication.d.ts +1 -0
  444. package/dist/skill-authentication.d.ts.map +1 -1
  445. package/dist/skill-authentication.js +1 -0
  446. package/dist/skill-authentication.js.map +1 -1
  447. package/dist/snyk-findings.d.ts +7 -2
  448. package/dist/snyk-findings.d.ts.map +1 -1
  449. package/dist/snyk-findings.js +93 -70
  450. package/dist/snyk-findings.js.map +1 -1
  451. package/dist/snyk-rest-findings.d.ts +76 -0
  452. package/dist/snyk-rest-findings.d.ts.map +1 -0
  453. package/dist/snyk-rest-findings.js +1051 -0
  454. package/dist/snyk-rest-findings.js.map +1 -0
  455. package/dist/snyk-rest-v1.d.ts +28 -0
  456. package/dist/snyk-rest-v1.d.ts.map +1 -0
  457. package/dist/snyk-rest-v1.js +132 -0
  458. package/dist/snyk-rest-v1.js.map +1 -0
  459. package/dist/snyk-token-origin.d.ts +4 -0
  460. package/dist/snyk-token-origin.d.ts.map +1 -0
  461. package/dist/snyk-token-origin.js +82 -0
  462. package/dist/snyk-token-origin.js.map +1 -0
  463. package/dist/sonar-collector.d.ts.map +1 -1
  464. package/dist/sonar-collector.js +0 -3
  465. package/dist/sonar-collector.js.map +1 -1
  466. package/dist/sonar-import.d.ts.map +1 -1
  467. package/dist/sonar-import.js +2 -4
  468. package/dist/sonar-import.js.map +1 -1
  469. package/dist/target-drift.d.ts +9 -0
  470. package/dist/target-drift.d.ts.map +1 -0
  471. package/dist/target-drift.js +27 -0
  472. package/dist/target-drift.js.map +1 -0
  473. package/dist/targets.d.ts +2 -0
  474. package/dist/targets.d.ts.map +1 -1
  475. package/dist/targets.js +56 -20
  476. package/dist/targets.js.map +1 -1
  477. package/dist/tenable-findings.d.ts +9 -0
  478. package/dist/tenable-findings.d.ts.map +1 -0
  479. package/dist/tenable-findings.js +122 -0
  480. package/dist/tenable-findings.js.map +1 -0
  481. package/dist/terminal-stream.d.ts +13 -0
  482. package/dist/terminal-stream.d.ts.map +1 -0
  483. package/dist/terminal-stream.js +35 -0
  484. package/dist/terminal-stream.js.map +1 -0
  485. package/dist/trivy-findings.d.ts +19 -0
  486. package/dist/trivy-findings.d.ts.map +1 -0
  487. package/dist/trivy-findings.js +435 -0
  488. package/dist/trivy-findings.js.map +1 -0
  489. package/dist/trivy-import.d.ts +19 -0
  490. package/dist/trivy-import.d.ts.map +1 -0
  491. package/dist/trivy-import.js +151 -0
  492. package/dist/trivy-import.js.map +1 -0
  493. package/dist/validation-records.js +1 -1
  494. package/dist/validation-records.js.map +1 -1
  495. package/dist/veracode-findings.d.ts +2 -0
  496. package/dist/veracode-findings.d.ts.map +1 -1
  497. package/dist/veracode-findings.js +49 -11
  498. package/dist/veracode-findings.js.map +1 -1
  499. package/dist/vertex-pricing.d.ts +8 -0
  500. package/dist/vertex-pricing.d.ts.map +1 -0
  501. package/dist/vertex-pricing.js +20 -0
  502. package/dist/vertex-pricing.js.map +1 -0
  503. package/dist/windows-path.d.ts +1 -0
  504. package/dist/windows-path.d.ts.map +1 -1
  505. package/dist/windows-path.js +26 -1
  506. package/dist/windows-path.js.map +1 -1
  507. package/dist/wiz-findings.d.ts +4 -0
  508. package/dist/wiz-findings.d.ts.map +1 -1
  509. package/dist/wiz-findings.js +57 -3
  510. package/dist/wiz-findings.js.map +1 -1
  511. package/docs/classify-severity-records.md +27 -12
  512. package/docs/cli.md +497 -550
  513. package/docs/dedupe-records.md +44 -24
  514. package/docs/findings-service.md +66 -39
  515. package/docs/hosted-remediation.md +14 -7
  516. package/docs/hosted-scans.md +50 -42
  517. package/docs/telemetry.md +236 -0
  518. package/docs/validate-records.md +78 -44
  519. package/package.json +18 -15
  520. package/schemas/external-findings.schema.json +3 -1
  521. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  522. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  523. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  524. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  525. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  526. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  527. package/dist/external-imports-feature.d.ts +0 -6
  528. package/dist/external-imports-feature.d.ts.map +0 -1
  529. package/dist/external-imports-feature.js +0 -51
  530. package/dist/external-imports-feature.js.map +0 -1
  531. package/dist/finding-normalization.d.ts +0 -5
  532. package/dist/finding-normalization.d.ts.map +0 -1
  533. package/dist/finding-normalization.js +0 -155
  534. package/dist/finding-normalization.js.map +0 -1
@@ -1,9 +1,13 @@
1
- import { posix } from "node:path";
2
1
  import { previousAdmission, validateExternalEvidenceJson, validateExternalReport, } from "./external-import-contract.js";
3
2
  import { canonicalJson } from "./record.js";
4
3
  import { errorMessage } from "./errors.js";
5
- import { messageText, parseNativeJsonResult, projectNativeJsonResult, sourceRepositoryUrl, } from "./native-json-findings.js";
6
- import { trackReaderSelection, array, readScannerJson, record, relativePath, requiredText, stableId, } from "./scanner-import.js";
4
+ import { messageText, nativeResultPath, parseNativeJsonResult, projectNativeJsonResult, sourceRepositoryUrl, } from "./native-json-findings.js";
5
+ import { trackReaderSelection, array, readScannerJson, record, requiredText, stableId, } from "./scanner-import.js";
6
+ // Occurrences are sorted by ID and can retain traces from nonadjacent input rows.
7
+ const sourcePositions = new WeakMap();
8
+ export function getOpenGrepSourcePositions(findings) {
9
+ return Array.isArray(findings) ? sourcePositions.get(findings) : undefined;
10
+ }
7
11
  /** Import native scanner evidence without assigning a Codex assessment. */
8
12
  export function normalizeOpenGrepFindings(input, options, target = "cloud") {
9
13
  const document = record(input, "OpenGrep report");
@@ -123,15 +127,7 @@ export function normalizeOpenGrepFindings(input, options, target = "cloud") {
123
127
  for (const [index, value] of values.entries()) {
124
128
  let id = null;
125
129
  try {
126
- const parsed = parseNativeJsonResult(value, "OpenGrep");
127
- if (parsed.path !== null) {
128
- // Validate the emitted spelling across platforms, keeping literal POSIX backslashes.
129
- const path = posix.normalize(parsed.rawPath);
130
- parsed.path =
131
- relativePath(posix.normalize(path.replaceAll("\\", "/"))) === null
132
- ? null
133
- : path;
134
- }
130
+ const parsed = parseNativeJsonResult(value, "OpenGrep", nativeResultPath);
135
131
  // Native fingerprint counters change when another analysis pass adds matches.
136
132
  // A source move creates a new occurrence; this is not cross-revision matching.
137
133
  id = stableId("opengrep-location", [
@@ -151,9 +147,15 @@ export function normalizeOpenGrepFindings(input, options, target = "cloud") {
151
147
  exclude(index + 1, id, error);
152
148
  }
153
149
  }
150
+ const positions = new Map();
154
151
  for (const [id, observations] of [...groups].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)) {
155
152
  if (observations.length === 1) {
156
- selection.append(observations[0].position, id, () => projectGroup(observations));
153
+ const { position } = observations[0];
154
+ selection.append(position, id, () => {
155
+ const evidence = projectGroup(observations);
156
+ positions.set(id, [position]);
157
+ return evidence;
158
+ });
157
159
  continue;
158
160
  }
159
161
  const ordered = observations
@@ -197,6 +199,7 @@ export function normalizeOpenGrepFindings(input, options, target = "cloud") {
197
199
  if (previousAdmission(evidence) === null)
198
200
  selection.uncertainIds.add(id);
199
201
  output.findings.push({ source_finding_id: id, evidence });
202
+ positions.set(id, retained.map(({ position }) => position));
200
203
  }
201
204
  catch (error) {
202
205
  for (const observation of retained)
@@ -204,6 +207,7 @@ export function normalizeOpenGrepFindings(input, options, target = "cloud") {
204
207
  }
205
208
  }
206
209
  output.excluded.sort((left, right) => left.position - right.position);
210
+ sourcePositions.set(output.findings, positions);
207
211
  return selection.finish();
208
212
  }
209
213
  export async function readOpenGrepFindings(path, options, target = "cloud") {
@@ -1 +1 @@
1
- {"version":3,"file":"opengrep-findings.js","sourceRoot":"","sources":["../src/opengrep-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { posix } from \"node:path\";\nimport {\n previousAdmission,\n validateExternalEvidenceJson,\n validateExternalReport,\n type ExternalImportTarget,\n} from \"./external-import-contract.js\";\nimport { canonicalJson } from \"./record.js\";\nimport { errorMessage } from \"./errors.js\";\nimport type { ExternalFindings } from \"./external-findings.js\";\nimport {\n messageText,\n parseNativeJsonResult,\n projectNativeJsonResult,\n sourceRepositoryUrl,\n} from \"./native-json-findings.js\";\nimport {\n trackReaderSelection,\n array,\n readScannerJson,\n record,\n relativePath,\n requiredText,\n stableId,\n} from \"./scanner-import.js\";\n\nexport interface OpenGrepImportOptions {\n /** Source repository declared by the caller, independent of the destination. */\n sourceRepositoryUrl: string;\n}\n\n/** Import native scanner evidence without assigning a Codex assessment. */\nexport function normalizeOpenGrepFindings(\n input: unknown,\n options: OpenGrepImportOptions,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n const document = record(input, \"OpenGrep report\");\n const repositoryUrl = sourceRepositoryUrl(\n options?.sourceRepositoryUrl,\n \"OpenGrep\",\n );\n const version = requiredText(document[\"version\"], \"OpenGrep version\");\n const { results, ...report } = document;\n const values = array(results, \"OpenGrep results\");\n const errors = array(report[\"errors\"], \"OpenGrep errors\");\n validateExternalReport(report);\n const projection = {\n origin: \"OpenGrep\",\n repositoryUrl,\n severity: () => \"unknown\",\n reportContext: { version },\n target,\n scanErrorCount: errors.length,\n };\n const output: ExternalFindings = {\n read: values.length,\n findings: [],\n excluded: [],\n report: structuredClone(report),\n };\n const selection = trackReaderSelection(output);\n type Observation = {\n position: number;\n parsed: ReturnType<typeof parseNativeJsonResult>;\n };\n function exclude(position: number, id: string | null, error: unknown) {\n if (id && error instanceof Error && previousAdmission(error) !== undefined)\n selection.uncertainIds.add(id);\n output.excluded.push({\n position,\n source_finding_id: id,\n reason: errorMessage(error),\n });\n }\n function projectGroup(observations: Observation[]) {\n const results = observations.map(({ parsed }) => parsed.result);\n if (results.length === 1)\n return projectNativeJsonResult(observations[0]!.parsed, {\n ...projection,\n observations: results,\n });\n const sourceData = {\n report: { version },\n scan_error_count: errors.length,\n results,\n };\n // Replacing [] with the same raw results adds the same wire bytes to every candidate.\n const rawBytes =\n validateExternalEvidenceJson({ source_data: sourceData }, target) -\n validateExternalEvidenceJson(\n { source_data: { ...sourceData, results: [] } },\n target,\n );\n let projectionError: unknown;\n for (const { parsed } of observations) {\n try {\n const evidence = projectNativeJsonResult(parsed, {\n ...projection,\n observations: [],\n });\n validateExternalEvidenceJson(evidence, target, rawBytes);\n evidence.source_data![\"results\"] = results;\n return evidence;\n } catch (error) {\n projectionError ??= error;\n }\n }\n throw projectionError;\n }\n function retainPublishableTraces(observations: Observation[], id: string) {\n const emptyWrapperBytes = validateExternalEvidenceJson(\n { source_data: { results: [] } },\n target,\n );\n function sizeWithTrace(observation: Observation, evidenceBytes: number) {\n return validateExternalEvidenceJson(\n { source_data: { results: [observation.parsed.result] } },\n target,\n evidenceBytes - emptyWrapperBytes,\n );\n }\n const singletonErrors = new Map<Observation, string>();\n let smallestProjectionBytes = Infinity;\n let coreRawBytes = 0;\n for (const observation of observations) {\n try {\n const evidence = projectNativeJsonResult(observation.parsed, {\n ...projection,\n observations: [],\n });\n const projectedBytes = validateExternalEvidenceJson(evidence, target);\n const singletonBytes = sizeWithTrace(observation, projectedBytes);\n coreRawBytes += singletonBytes - projectedBytes;\n smallestProjectionBytes = Math.min(\n smallestProjectionBytes,\n projectedBytes,\n );\n } catch (error) {\n if (error instanceof Error && previousAdmission(error) !== undefined)\n selection.uncertainIds.add(id);\n singletonErrors.set(observation, errorMessage(error));\n }\n }\n if (!singletonErrors.size) return observations;\n // Reserve every independently publishable trace, including the commas in\n // their results array, before trying raw-only traces in canonical order.\n const coreCount = observations.length - singletonErrors.size;\n let groupBytes = smallestProjectionBytes + coreRawBytes + coreCount - 1;\n return observations.filter((observation) => {\n let reason = singletonErrors.get(observation);\n if (reason === undefined) return true;\n if (coreCount) {\n try {\n groupBytes = sizeWithTrace(observation, groupBytes + 1);\n return true;\n } catch (error) {\n const groupReason = errorMessage(error);\n if (groupReason !== reason)\n reason = `${groupReason} This trace also fails standalone validation. ${reason}`;\n }\n }\n exclude(observation.position, id, reason);\n return false;\n });\n }\n const groups = new Map<string, Observation[]>();\n for (const [index, value] of values.entries()) {\n let id: string | null = null;\n try {\n const parsed = parseNativeJsonResult(value, \"OpenGrep\");\n if (parsed.path !== null) {\n // Validate the emitted spelling across platforms, keeping literal POSIX backslashes.\n const path = posix.normalize(parsed.rawPath);\n parsed.path =\n relativePath(posix.normalize(path.replaceAll(\"\\\\\", \"/\"))) === null\n ? null\n : path;\n }\n // Native fingerprint counters change when another analysis pass adds matches.\n // A source move creates a new occurrence; this is not cross-revision matching.\n id = stableId(\"opengrep-location\", [\n parsed.rule,\n parsed.path ?? parsed.rawPath,\n parsed.line,\n parsed.column,\n parsed.endLine,\n parsed.endColumn,\n ]);\n messageText(parsed.extra[\"message\"], \"OpenGrep\");\n const group = groups.get(id) ?? [];\n group.push({ position: index + 1, parsed });\n groups.set(id, group);\n } catch (error) {\n exclude(index + 1, id, error);\n }\n }\n for (const [id, observations] of [...groups].sort(([left], [right]) =>\n left < right ? -1 : left > right ? 1 : 0,\n )) {\n if (observations.length === 1) {\n selection.append(observations[0]!.position, id, () =>\n projectGroup(observations),\n );\n continue;\n }\n const ordered = observations\n .flatMap((observation) => {\n try {\n const result = structuredClone(observation.parsed.result);\n // The group adds these same raw bytes when choosing a representative\n // and deciding which traces fit alongside it.\n validateExternalEvidenceJson(\n { source_data: { results: [result] } },\n target,\n 0,\n (previousBytes, currentBytes) => {\n if (previousBytes !== currentBytes)\n selection.uncertainIds.add(id);\n },\n );\n observation.parsed.result = result;\n return [{ observation, key: canonicalJson(result) }];\n } catch (error) {\n exclude(observation.position, id, error);\n return [];\n }\n })\n .sort((left, right) =>\n left.key < right.key ? -1 : left.key > right.key ? 1 : 0,\n )\n .map(({ observation }) => observation);\n if (!ordered.length) continue;\n let retained = ordered;\n try {\n let evidence;\n try {\n evidence = projectGroup(retained);\n } catch (error) {\n if (retained.length === 1) throw error;\n retained = retainPublishableTraces(retained, id);\n if (!retained.length) continue;\n if (retained.length === ordered.length) throw error;\n evidence = projectGroup(retained);\n }\n if (previousAdmission(evidence) === null) selection.uncertainIds.add(id);\n output.findings.push({ source_finding_id: id, evidence });\n } catch (error) {\n for (const observation of retained)\n exclude(observation.position, id, error);\n }\n }\n output.excluded.sort((left, right) => left.position - right.position);\n return selection.finish();\n}\n\nexport async function readOpenGrepFindings(\n path: string,\n options: OpenGrepImportOptions,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeOpenGrepFindings(\n await readScannerJson(path),\n options,\n target,\n );\n}\n"]}
1
+ {"version":3,"file":"opengrep-findings.js","sourceRoot":"","sources":["../src/opengrep-findings.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,sBAAsB,GAEvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,KAAK,EACL,eAAe,EACf,MAAM,EACN,YAAY,EACZ,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAO7B,kFAAkF;AAClF,MAAM,eAAe,GAAG,IAAI,OAAO,EAGhC,CAAC;AAEJ,MAAM,UAAU,0BAA0B,CAAC,QAAiB;IAC1D,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,OAA8B,EAC9B,MAAM,GAAyB,OAAO;IAEtC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,mBAAmB,CACvC,OAAO,EAAE,mBAAmB,EAC5B,UAAU,CACX,CAAC;IACF,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACtE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC1D,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG;QACjB,MAAM,EAAE,UAAU;QAClB,aAAa;QACb,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS;QACzB,aAAa,EAAE,EAAE,OAAO,EAAE;QAC1B,MAAM;QACN,cAAc,EAAE,MAAM,CAAC,MAAM;KAC9B,CAAC;IACF,MAAM,MAAM,GAAqB;QAC/B,IAAI,EAAE,MAAM,CAAC,MAAM;QACnB,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;KAChC,CAAC;IACF,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAK/C,SAAS,OAAO,CAAC,QAAgB,EAAE,EAAiB,EAAE,KAAc;QAClE,IAAI,EAAE,IAAI,KAAK,YAAY,KAAK,IAAI,iBAAiB,CAAC,KAAK,CAAC,KAAK,SAAS;YACxE,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACnB,QAAQ;YACR,iBAAiB,EAAE,EAAE;YACrB,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IACD,SAAS,YAAY,CAAC,YAA2B;QAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YACtB,OAAO,uBAAuB,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC,MAAM,EAAE;gBACtD,GAAG,UAAU;gBACb,YAAY,EAAE,OAAO;aACtB,CAAC,CAAC;QACL,MAAM,UAAU,GAAG;YACjB,MAAM,EAAE,EAAE,OAAO,EAAE;YACnB,gBAAgB,EAAE,MAAM,CAAC,MAAM;YAC/B,OAAO;SACR,CAAC;QACF,sFAAsF;QACtF,MAAM,QAAQ,GACZ,4BAA4B,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,MAAM,CAAC;YACjE,4BAA4B,CAC1B,EAAE,WAAW,EAAE,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAC/C,MAAM,CACP,CAAC;QACJ,IAAI,eAAwB,CAAC;QAC7B,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE;oBAC/C,GAAG,UAAU;oBACb,YAAY,EAAE,EAAE;iBACjB,CAAC,CAAC;gBACH,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACzD,QAAQ,CAAC,WAAY,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;gBAC3C,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,eAAe,KAAK,KAAK,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,MAAM,eAAe,CAAC;IACxB,CAAC;IACD,SAAS,uBAAuB,CAAC,YAA2B,EAAE,EAAU;QACtE,MAAM,iBAAiB,GAAG,4BAA4B,CACpD,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAChC,MAAM,CACP,CAAC;QACF,SAAS,aAAa,CAAC,WAAwB,EAAE,aAAqB;YACpE,OAAO,4BAA4B,CACjC,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EACzD,MAAM,EACN,aAAa,GAAG,iBAAiB,CAClC,CAAC;QACJ,CAAC;QACD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAuB,CAAC;QACvD,IAAI,uBAAuB,GAAG,QAAQ,CAAC;QACvC,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,CAAC,MAAM,EAAE;oBAC3D,GAAG,UAAU;oBACb,YAAY,EAAE,EAAE;iBACjB,CAAC,CAAC;gBACH,MAAM,cAAc,GAAG,4BAA4B,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACtE,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;gBAClE,YAAY,IAAI,cAAc,GAAG,cAAc,CAAC;gBAChD,uBAAuB,GAAG,IAAI,CAAC,GAAG,CAChC,uBAAuB,EACvB,cAAc,CACf,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,KAAK,IAAI,iBAAiB,CAAC,KAAK,CAAC,KAAK,SAAS;oBAClE,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACjC,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,IAAI;YAAE,OAAO,YAAY,CAAC;QAC/C,yEAAyE;QACzE,yEAAyE;QACzE,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC;QAC7D,IAAI,UAAU,GAAG,uBAAuB,GAAG,YAAY,GAAG,SAAS,GAAG,CAAC,CAAC;QACxE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE;YACzC,IAAI,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACtC,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC;oBACH,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;oBACxD,OAAO,IAAI,CAAC;gBACd,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;oBACxC,IAAI,WAAW,KAAK,MAAM;wBACxB,MAAM,GAAG,GAAG,WAAW,iDAAiD,MAAM,EAAE,CAAC;gBACrF,CAAC;YACH,CAAC;YACD,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,IAAI,EAAE,GAAkB,IAAI,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;YAC1E,8EAA8E;YAC9E,+EAA+E;YAC/E,EAAE,GAAG,QAAQ,CAAC,mBAAmB,EAAE;gBACjC,MAAM,CAAC,IAAI;gBACX,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO;gBAC7B,MAAM,CAAC,IAAI;gBACX,MAAM,CAAC,MAAM;gBACb,MAAM,CAAC,OAAO;gBACd,MAAM,CAAC,SAAS;aACjB,CAAC,CAAC;YACH,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC9C,KAAK,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CACpE,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACzC,EAAE,CAAC;QACF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;YACtC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,EAAE;gBAClC,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;gBAC5C,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC9B,OAAO,QAAQ,CAAC;YAClB,CAAC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,YAAY;aACzB,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YACvB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1D,qEAAqE;gBACrE,8CAA8C;gBAC9C,4BAA4B,CAC1B,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,EACtC,MAAM,EACN,CAAC,EACD,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE;oBAC9B,IAAI,aAAa,KAAK,YAAY;wBAChC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnC,CAAC,CACF,CAAC;gBACF,WAAW,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;gBACnC,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;gBACzC,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACpB,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACzD;aACA,GAAG,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,SAAS;QAC9B,IAAI,QAAQ,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC;YACb,IAAI,CAAC;gBACH,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAC;gBACvC,QAAQ,GAAG,uBAAuB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACjD,IAAI,CAAC,QAAQ,CAAC,MAAM;oBAAE,SAAS;gBAC/B,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;oBAAE,MAAM,KAAK,CAAC;gBACpD,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;YACD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,KAAK,IAAI;gBAAE,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1D,SAAS,CAAC,GAAG,CACX,EAAE,EACF,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CACzC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,MAAM,WAAW,IAAI,QAAQ;gBAChC,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtE,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChD,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,OAA8B,EAC9B,MAAM,GAAyB,OAAO;IAEtC,OAAO,yBAAyB,CAC9B,MAAM,eAAe,CAAC,IAAI,CAAC,EAC3B,OAAO,EACP,MAAM,CACP,CAAC;AACJ,CAAC","sourcesContent":["import {\n previousAdmission,\n validateExternalEvidenceJson,\n validateExternalReport,\n type ExternalImportTarget,\n} from \"./external-import-contract.js\";\nimport { canonicalJson } from \"./record.js\";\nimport { errorMessage } from \"./errors.js\";\nimport type { ExternalFindings } from \"./external-findings.js\";\nimport {\n messageText,\n nativeResultPath,\n parseNativeJsonResult,\n projectNativeJsonResult,\n sourceRepositoryUrl,\n} from \"./native-json-findings.js\";\nimport {\n trackReaderSelection,\n array,\n readScannerJson,\n record,\n requiredText,\n stableId,\n} from \"./scanner-import.js\";\n\nexport interface OpenGrepImportOptions {\n /** Source repository declared by the caller, independent of the destination. */\n sourceRepositoryUrl: string;\n}\n\n// Occurrences are sorted by ID and can retain traces from nonadjacent input rows.\nconst sourcePositions = new WeakMap<\n ExternalFindings[\"findings\"],\n ReadonlyMap<string, readonly number[]>\n>();\n\nexport function getOpenGrepSourcePositions(findings: unknown) {\n return Array.isArray(findings) ? sourcePositions.get(findings) : undefined;\n}\n\n/** Import native scanner evidence without assigning a Codex assessment. */\nexport function normalizeOpenGrepFindings(\n input: unknown,\n options: OpenGrepImportOptions,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n const document = record(input, \"OpenGrep report\");\n const repositoryUrl = sourceRepositoryUrl(\n options?.sourceRepositoryUrl,\n \"OpenGrep\",\n );\n const version = requiredText(document[\"version\"], \"OpenGrep version\");\n const { results, ...report } = document;\n const values = array(results, \"OpenGrep results\");\n const errors = array(report[\"errors\"], \"OpenGrep errors\");\n validateExternalReport(report);\n const projection = {\n origin: \"OpenGrep\",\n repositoryUrl,\n severity: () => \"unknown\",\n reportContext: { version },\n target,\n scanErrorCount: errors.length,\n };\n const output: ExternalFindings = {\n read: values.length,\n findings: [],\n excluded: [],\n report: structuredClone(report),\n };\n const selection = trackReaderSelection(output);\n type Observation = {\n position: number;\n parsed: ReturnType<typeof parseNativeJsonResult>;\n };\n function exclude(position: number, id: string | null, error: unknown) {\n if (id && error instanceof Error && previousAdmission(error) !== undefined)\n selection.uncertainIds.add(id);\n output.excluded.push({\n position,\n source_finding_id: id,\n reason: errorMessage(error),\n });\n }\n function projectGroup(observations: Observation[]) {\n const results = observations.map(({ parsed }) => parsed.result);\n if (results.length === 1)\n return projectNativeJsonResult(observations[0]!.parsed, {\n ...projection,\n observations: results,\n });\n const sourceData = {\n report: { version },\n scan_error_count: errors.length,\n results,\n };\n // Replacing [] with the same raw results adds the same wire bytes to every candidate.\n const rawBytes =\n validateExternalEvidenceJson({ source_data: sourceData }, target) -\n validateExternalEvidenceJson(\n { source_data: { ...sourceData, results: [] } },\n target,\n );\n let projectionError: unknown;\n for (const { parsed } of observations) {\n try {\n const evidence = projectNativeJsonResult(parsed, {\n ...projection,\n observations: [],\n });\n validateExternalEvidenceJson(evidence, target, rawBytes);\n evidence.source_data![\"results\"] = results;\n return evidence;\n } catch (error) {\n projectionError ??= error;\n }\n }\n throw projectionError;\n }\n function retainPublishableTraces(observations: Observation[], id: string) {\n const emptyWrapperBytes = validateExternalEvidenceJson(\n { source_data: { results: [] } },\n target,\n );\n function sizeWithTrace(observation: Observation, evidenceBytes: number) {\n return validateExternalEvidenceJson(\n { source_data: { results: [observation.parsed.result] } },\n target,\n evidenceBytes - emptyWrapperBytes,\n );\n }\n const singletonErrors = new Map<Observation, string>();\n let smallestProjectionBytes = Infinity;\n let coreRawBytes = 0;\n for (const observation of observations) {\n try {\n const evidence = projectNativeJsonResult(observation.parsed, {\n ...projection,\n observations: [],\n });\n const projectedBytes = validateExternalEvidenceJson(evidence, target);\n const singletonBytes = sizeWithTrace(observation, projectedBytes);\n coreRawBytes += singletonBytes - projectedBytes;\n smallestProjectionBytes = Math.min(\n smallestProjectionBytes,\n projectedBytes,\n );\n } catch (error) {\n if (error instanceof Error && previousAdmission(error) !== undefined)\n selection.uncertainIds.add(id);\n singletonErrors.set(observation, errorMessage(error));\n }\n }\n if (!singletonErrors.size) return observations;\n // Reserve every independently publishable trace, including the commas in\n // their results array, before trying raw-only traces in canonical order.\n const coreCount = observations.length - singletonErrors.size;\n let groupBytes = smallestProjectionBytes + coreRawBytes + coreCount - 1;\n return observations.filter((observation) => {\n let reason = singletonErrors.get(observation);\n if (reason === undefined) return true;\n if (coreCount) {\n try {\n groupBytes = sizeWithTrace(observation, groupBytes + 1);\n return true;\n } catch (error) {\n const groupReason = errorMessage(error);\n if (groupReason !== reason)\n reason = `${groupReason} This trace also fails standalone validation. ${reason}`;\n }\n }\n exclude(observation.position, id, reason);\n return false;\n });\n }\n const groups = new Map<string, Observation[]>();\n for (const [index, value] of values.entries()) {\n let id: string | null = null;\n try {\n const parsed = parseNativeJsonResult(value, \"OpenGrep\", nativeResultPath);\n // Native fingerprint counters change when another analysis pass adds matches.\n // A source move creates a new occurrence; this is not cross-revision matching.\n id = stableId(\"opengrep-location\", [\n parsed.rule,\n parsed.path ?? parsed.rawPath,\n parsed.line,\n parsed.column,\n parsed.endLine,\n parsed.endColumn,\n ]);\n messageText(parsed.extra[\"message\"], \"OpenGrep\");\n const group = groups.get(id) ?? [];\n group.push({ position: index + 1, parsed });\n groups.set(id, group);\n } catch (error) {\n exclude(index + 1, id, error);\n }\n }\n const positions = new Map<string, number[]>();\n for (const [id, observations] of [...groups].sort(([left], [right]) =>\n left < right ? -1 : left > right ? 1 : 0,\n )) {\n if (observations.length === 1) {\n const { position } = observations[0]!;\n selection.append(position, id, () => {\n const evidence = projectGroup(observations);\n positions.set(id, [position]);\n return evidence;\n });\n continue;\n }\n const ordered = observations\n .flatMap((observation) => {\n try {\n const result = structuredClone(observation.parsed.result);\n // The group adds these same raw bytes when choosing a representative\n // and deciding which traces fit alongside it.\n validateExternalEvidenceJson(\n { source_data: { results: [result] } },\n target,\n 0,\n (previousBytes, currentBytes) => {\n if (previousBytes !== currentBytes)\n selection.uncertainIds.add(id);\n },\n );\n observation.parsed.result = result;\n return [{ observation, key: canonicalJson(result) }];\n } catch (error) {\n exclude(observation.position, id, error);\n return [];\n }\n })\n .sort((left, right) =>\n left.key < right.key ? -1 : left.key > right.key ? 1 : 0,\n )\n .map(({ observation }) => observation);\n if (!ordered.length) continue;\n let retained = ordered;\n try {\n let evidence;\n try {\n evidence = projectGroup(retained);\n } catch (error) {\n if (retained.length === 1) throw error;\n retained = retainPublishableTraces(retained, id);\n if (!retained.length) continue;\n if (retained.length === ordered.length) throw error;\n evidence = projectGroup(retained);\n }\n if (previousAdmission(evidence) === null) selection.uncertainIds.add(id);\n output.findings.push({ source_finding_id: id, evidence });\n positions.set(\n id,\n retained.map(({ position }) => position),\n );\n } catch (error) {\n for (const observation of retained)\n exclude(observation.position, id, error);\n }\n }\n output.excluded.sort((left, right) => left.position - right.position);\n sourcePositions.set(output.findings, positions);\n return selection.finish();\n}\n\nexport async function readOpenGrepFindings(\n path: string,\n options: OpenGrepImportOptions,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeOpenGrepFindings(\n await readScannerJson(path),\n options,\n target,\n );\n}\n"]}
@@ -0,0 +1,104 @@
1
+ import type { ScanUsageMeasurement } from "./cost.js";
2
+ export type OperationOutcome = "completed" | "failed" | "canceled" | "unresolved";
3
+ export type OperationFailureCategory = "configuration" | "authentication" | "input" | "budget" | "execution" | "canceled";
4
+ /** Content-free operational receipts. IDs are for joins, never metric labels. */
5
+ export interface OperationTelemetryEvent {
6
+ schemaVersion: 1;
7
+ eventId: string;
8
+ operationId: string;
9
+ attemptId: string;
10
+ parentAttemptId?: string;
11
+ /** Resumed scans share a cumulative measurement scope; never sum those receipts. */
12
+ usageScopeId: string;
13
+ occurredAt: string;
14
+ observedAt: string;
15
+ type: "attempt_started" | "attempt_finished";
16
+ command: "scan" | "patch" | "validate" | "policy" | "verify-fix" | "assess-patch-risk";
17
+ surface: "cli" | "sdk";
18
+ packageVersion: string;
19
+ mode?: "standard" | "deep";
20
+ resumed: boolean;
21
+ /** True when this call returned a saved result without starting new work. */
22
+ reusedResult?: boolean;
23
+ outcome?: OperationOutcome;
24
+ failureCategory?: OperationFailureCategory;
25
+ durationMs?: number;
26
+ measurement?: Readonly<ScanUsageMeasurement>;
27
+ findingCount?: number;
28
+ reviewedSurfaceCount?: number;
29
+ deferredCount?: number;
30
+ pluginVersion?: string;
31
+ providerFamily?: string;
32
+ validationDisposition?: "reportable" | "suppressed" | "not_applicable" | "deferred";
33
+ artifactComplete?: boolean;
34
+ collection: {
35
+ persisted: number;
36
+ writeFailures: number;
37
+ };
38
+ }
39
+ interface OperationTelemetryOptions {
40
+ directory: string;
41
+ protectedRepository?: string;
42
+ protectedOutput?: string;
43
+ command: OperationTelemetryEvent["command"];
44
+ surface: OperationTelemetryEvent["surface"];
45
+ mode?: OperationTelemetryEvent["mode"];
46
+ resumeScanId?: string;
47
+ deferPersistence?: boolean;
48
+ context?: {
49
+ operationId: string;
50
+ parentAttemptId?: string;
51
+ };
52
+ onEvent?: (event: Readonly<OperationTelemetryEvent>) => void;
53
+ onError?: (error: unknown) => void;
54
+ }
55
+ /** Local journal only. Export, acknowledgement and retention belong to the host. */
56
+ export declare class OperationTelemetry {
57
+ #private;
58
+ readonly attemptId: `${string}-${string}-${string}-${string}-${string}`;
59
+ operationId: string;
60
+ measurement: Readonly<ScanUsageMeasurement> | undefined;
61
+ reusedResult: boolean;
62
+ nativeTurnFailed: boolean;
63
+ constructor(options: OperationTelemetryOptions);
64
+ get context(): {
65
+ operationId: string;
66
+ attemptId: `${string}-${string}-${string}-${string}-${string}`;
67
+ parentAttemptId?: string | undefined;
68
+ };
69
+ start(): Promise<void>;
70
+ /** Callers establish repository and artifact protection before any writes. */
71
+ activatePersistence(protectedRoots: readonly string[], savedOutput?: string): Promise<void>;
72
+ bindScan(scanId: string): Promise<void>;
73
+ describe(runtime: Pick<OperationTelemetryEvent, "pluginVersion" | "providerFamily">): void;
74
+ finish(outcome: OperationOutcome, details?: Pick<OperationTelemetryEvent, "failureCategory" | "findingCount" | "artifactComplete" | "reviewedSurfaceCount" | "deferredCount" | "validationDisposition">): Promise<void>;
75
+ }
76
+ /** Read durable receipts, retaining explicit evidence of truncated/corrupt records. */
77
+ export declare function readOperationTelemetry(stateDirectory: string): Promise<{
78
+ events: OperationTelemetryEvent[];
79
+ parseFailures: number;
80
+ }>;
81
+ /** Attempts without a terminal receipt remain unresolved, including process loss. */
82
+ export declare function summarizeOperationTelemetry(events: readonly OperationTelemetryEvent[]): {
83
+ operations: number;
84
+ successfulOperations: number;
85
+ attempts: number;
86
+ outcomes: {
87
+ completed: number;
88
+ failed: number;
89
+ canceled: number;
90
+ unresolved: number;
91
+ };
92
+ usageCoverage: {
93
+ complete: number;
94
+ partial: number;
95
+ unavailable: number;
96
+ };
97
+ durationMs: number[];
98
+ observedCostUsd: number;
99
+ pricedAttempts: number;
100
+ reusedAttempts: number;
101
+ duplicates: number;
102
+ };
103
+ export {};
104
+ //# sourceMappingURL=operation-telemetry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-telemetry.d.ts","sourceRoot":"","sources":["../src/operation-telemetry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,293 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { appendFile, mkdir, readFile, readdir, writeFile, } from "node:fs/promises";
3
+ import { join } from "node:path";
4
+ import { canonicalConfigPath, requireOutputOutsideRepositories, requireSecureOutputAncestry, } from "./runtime.js";
5
+ import { gitProtectionRoots } from "./targets.js";
6
+ import { VERSION } from "./version.js";
7
+ /** Local journal only. Export, acknowledgement and retention belong to the host. */
8
+ export class OperationTelemetry {
9
+ attemptId = randomUUID();
10
+ operationId;
11
+ measurement;
12
+ reusedResult = false;
13
+ nativeTurnFailed = false;
14
+ #started = performance.now();
15
+ #startedAt = new Date().toISOString();
16
+ #options;
17
+ #directory;
18
+ #persisted = 0;
19
+ #writeFailures = 0;
20
+ #ready = false;
21
+ #runtime = {};
22
+ #finished = false;
23
+ #usageScopeId = this.attemptId;
24
+ #deferred;
25
+ #startedEvent;
26
+ constructor(options) {
27
+ this.#options = options;
28
+ this.operationId = options.context?.operationId ?? randomUUID();
29
+ this.#directory = join(options.directory, "telemetry");
30
+ this.#deferred = options.deferPersistence === true;
31
+ }
32
+ get context() {
33
+ return {
34
+ operationId: this.operationId,
35
+ attemptId: this.attemptId,
36
+ ...(this.#options.context?.parentAttemptId === undefined
37
+ ? {}
38
+ : { parentAttemptId: this.#options.context.parentAttemptId }),
39
+ };
40
+ }
41
+ async start() {
42
+ if (!this.#deferred)
43
+ await this.#preparePersistence();
44
+ await this.#emit("attempt_started");
45
+ }
46
+ /** Callers establish repository and artifact protection before any writes. */
47
+ async activatePersistence(protectedRoots, savedOutput) {
48
+ if (!this.#deferred || this.#finished)
49
+ return;
50
+ this.#deferred = false;
51
+ await this.#preparePersistence(protectedRoots, savedOutput);
52
+ if (this.#startedEvent !== undefined) {
53
+ const event = {
54
+ ...this.#startedEvent,
55
+ ...this.context,
56
+ usageScopeId: this.#usageScopeId,
57
+ collection: {
58
+ persisted: this.#persisted + (this.#ready ? 1 : 0),
59
+ writeFailures: this.#writeFailures,
60
+ },
61
+ };
62
+ if (this.#ready)
63
+ await this.#persist(event);
64
+ if (this.#options.resumeScanId !== undefined)
65
+ this.#notify(event);
66
+ }
67
+ this.#startedEvent = undefined;
68
+ }
69
+ async #preparePersistence(additionalRoots = [], savedOutput) {
70
+ try {
71
+ const protectedRoots = [...additionalRoots];
72
+ for (const output of [this.#options.protectedOutput, savedOutput]) {
73
+ if (output !== undefined)
74
+ protectedRoots.push(await canonicalConfigPath(output));
75
+ }
76
+ if (this.#options.protectedRepository !== undefined) {
77
+ const repository = await canonicalConfigPath(this.#options.protectedRepository);
78
+ protectedRoots.push(repository, ...(await gitProtectionRoots(this.#options.protectedRepository)));
79
+ }
80
+ if (protectedRoots.length > 0) {
81
+ requireOutputOutsideRepositories(protectedRoots, await canonicalConfigPath(this.#directory), "runtime");
82
+ }
83
+ await requireSecureOutputAncestry(this.#directory);
84
+ await mkdir(this.#directory, { recursive: true, mode: 0o700 });
85
+ this.#ready = true;
86
+ if (this.#options.resumeScanId !== undefined) {
87
+ try {
88
+ const saved = JSON.parse(await readFile(this.#bindingPath(this.#options.resumeScanId), "utf8"));
89
+ this.operationId = saved.operationId;
90
+ this.#usageScopeId = saved.usageScopeId;
91
+ }
92
+ catch (error) {
93
+ if (error.code !== "ENOENT")
94
+ this.#error(error);
95
+ }
96
+ }
97
+ }
98
+ catch (error) {
99
+ this.#error(error);
100
+ }
101
+ }
102
+ async bindScan(scanId) {
103
+ if (!this.#ready)
104
+ return;
105
+ try {
106
+ await writeFile(this.#bindingPath(scanId), JSON.stringify({
107
+ ...this.context,
108
+ usageScopeId: this.#usageScopeId,
109
+ }), {
110
+ mode: 0o600,
111
+ });
112
+ }
113
+ catch (error) {
114
+ this.#error(error);
115
+ }
116
+ }
117
+ describe(runtime) {
118
+ this.#runtime = runtime;
119
+ }
120
+ async finish(outcome, details = {}) {
121
+ if (this.#finished)
122
+ return;
123
+ this.#finished = true;
124
+ if (this.#startedEvent !== undefined &&
125
+ this.#options.resumeScanId !== undefined) {
126
+ this.#notify(this.#startedEvent);
127
+ this.#startedEvent = undefined;
128
+ }
129
+ await this.#emit("attempt_finished", {
130
+ outcome,
131
+ reusedResult: this.reusedResult,
132
+ durationMs: Math.max(0, performance.now() - this.#started),
133
+ ...(this.measurement === undefined
134
+ ? {}
135
+ : { measurement: this.measurement }),
136
+ ...this.#runtime,
137
+ ...details,
138
+ });
139
+ }
140
+ #bindingPath(scanId) {
141
+ return join(this.#directory, `${createHash("sha256").update(scanId).digest("hex")}.binding.json`);
142
+ }
143
+ #error(error) {
144
+ this.#writeFailures++;
145
+ try {
146
+ this.#options.onError?.(error);
147
+ }
148
+ catch { }
149
+ }
150
+ async #persist(event) {
151
+ try {
152
+ await appendFile(join(this.#directory, `${this.attemptId}.jsonl`), `${JSON.stringify(event)}\n`, { mode: 0o600 });
153
+ this.#persisted++;
154
+ }
155
+ catch (error) {
156
+ this.#error(error);
157
+ event.collection = {
158
+ persisted: this.#persisted,
159
+ writeFailures: this.#writeFailures,
160
+ };
161
+ }
162
+ }
163
+ async #emit(type, details = {}) {
164
+ const time = new Date().toISOString();
165
+ const event = {
166
+ schemaVersion: 1,
167
+ eventId: `${this.attemptId}:${type}`,
168
+ ...this.context,
169
+ usageScopeId: this.#usageScopeId,
170
+ occurredAt: type === "attempt_started" ? this.#startedAt : time,
171
+ observedAt: time,
172
+ type,
173
+ command: this.#options.command,
174
+ surface: this.#options.surface,
175
+ packageVersion: VERSION,
176
+ ...(this.#options.mode === undefined ? {} : { mode: this.#options.mode }),
177
+ resumed: this.#options.resumeScanId !== undefined,
178
+ ...details,
179
+ collection: {
180
+ persisted: this.#persisted + (this.#ready ? 1 : 0),
181
+ writeFailures: this.#writeFailures,
182
+ },
183
+ };
184
+ if (this.#ready)
185
+ await this.#persist(event);
186
+ else if (this.#deferred && type === "attempt_started") {
187
+ this.#startedEvent = event;
188
+ // Resume identity is restored only after the caller protects output paths.
189
+ if (this.#options.resumeScanId !== undefined)
190
+ return;
191
+ }
192
+ this.#notify(event);
193
+ }
194
+ #notify(event) {
195
+ // Observers cannot delay or fail the operation. Replay uses the same event ID.
196
+ void Promise.resolve()
197
+ .then(() => this.#options.onEvent?.(event))
198
+ .catch(() => { });
199
+ }
200
+ }
201
+ /** Read durable receipts, retaining explicit evidence of truncated/corrupt records. */
202
+ export async function readOperationTelemetry(stateDirectory) {
203
+ const directory = join(stateDirectory, "telemetry");
204
+ const events = [];
205
+ let parseFailures = 0;
206
+ const names = await readdir(directory).catch((error) => {
207
+ if (error.code === "ENOENT")
208
+ return [];
209
+ throw error;
210
+ });
211
+ for (const name of names.filter((name) => name.endsWith(".jsonl")).sort()) {
212
+ for (const line of (await readFile(join(directory, name), "utf8")).split("\n")) {
213
+ if (!line)
214
+ continue;
215
+ try {
216
+ const event = JSON.parse(line);
217
+ if (event.schemaVersion !== 1 ||
218
+ typeof event.eventId !== "string" ||
219
+ typeof event.attemptId !== "string" ||
220
+ typeof event.operationId !== "string" ||
221
+ typeof event.usageScopeId !== "string" ||
222
+ !["attempt_started", "attempt_finished"].includes(event.type) ||
223
+ ((event.type === "attempt_finished" || event.outcome !== undefined) &&
224
+ !["completed", "failed", "canceled", "unresolved"].includes(event.outcome ?? "")) ||
225
+ (event.measurement !== undefined &&
226
+ !["complete", "partial", "unavailable"].includes(event.measurement?.coverage))) {
227
+ parseFailures++;
228
+ }
229
+ else
230
+ events.push(event);
231
+ }
232
+ catch {
233
+ parseFailures++;
234
+ }
235
+ }
236
+ }
237
+ return { events, parseFailures };
238
+ }
239
+ /** Attempts without a terminal receipt remain unresolved, including process loss. */
240
+ export function summarizeOperationTelemetry(events) {
241
+ const seen = new Set();
242
+ const attempts = new Map();
243
+ let duplicates = 0;
244
+ for (const event of events) {
245
+ if (seen.has(event.eventId)) {
246
+ duplicates++;
247
+ continue;
248
+ }
249
+ seen.add(event.eventId);
250
+ const previous = attempts.get(event.attemptId);
251
+ if (previous?.type !== "attempt_finished" ||
252
+ event.type === "attempt_finished")
253
+ attempts.set(event.attemptId, event);
254
+ }
255
+ const operations = new Map();
256
+ const outcomes = { completed: 0, failed: 0, canceled: 0, unresolved: 0 };
257
+ const usageCoverage = { complete: 0, partial: 0, unavailable: 0 };
258
+ const durationMs = [];
259
+ let observedCostUsd = 0;
260
+ let pricedAttempts = 0;
261
+ let reusedAttempts = 0;
262
+ const costsByScope = new Map();
263
+ for (const event of attempts.values()) {
264
+ operations.set(event.operationId, operations.get(event.operationId) === true ||
265
+ event.outcome === "completed");
266
+ outcomes[event.outcome ?? "unresolved"]++;
267
+ if (event.reusedResult === true)
268
+ reusedAttempts++;
269
+ else
270
+ usageCoverage[event.measurement?.coverage ?? "unavailable"]++;
271
+ if (event.durationMs !== undefined)
272
+ durationMs.push(event.durationMs);
273
+ if (event.measurement?.cost != null) {
274
+ costsByScope.set(event.usageScopeId, Math.max(costsByScope.get(event.usageScopeId) ?? 0, event.measurement.cost.estimatedUsd));
275
+ pricedAttempts++;
276
+ }
277
+ }
278
+ for (const cost of costsByScope.values())
279
+ observedCostUsd += cost;
280
+ return {
281
+ operations: operations.size,
282
+ successfulOperations: [...operations.values()].filter(Boolean).length,
283
+ attempts: attempts.size,
284
+ outcomes,
285
+ usageCoverage,
286
+ durationMs,
287
+ observedCostUsd,
288
+ pricedAttempts,
289
+ reusedAttempts,
290
+ duplicates,
291
+ };
292
+ }
293
+ //# sourceMappingURL=operation-telemetry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"operation-telemetry.js","sourceRoot":"","sources":["../src/operation-telemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport {\n appendFile,\n mkdir,\n readFile,\n readdir,\n writeFile,\n} from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { ScanUsageMeasurement } from \"./cost.js\";\nimport {\n canonicalConfigPath,\n requireOutputOutsideRepositories,\n requireSecureOutputAncestry,\n} from \"./runtime.js\";\nimport { gitProtectionRoots } from \"./targets.js\";\nimport { VERSION } from \"./version.js\";\n\nexport type OperationOutcome =\n \"completed\" | \"failed\" | \"canceled\" | \"unresolved\";\nexport type OperationFailureCategory =\n | \"configuration\"\n | \"authentication\"\n | \"input\"\n | \"budget\"\n | \"execution\"\n | \"canceled\";\n\n/** Content-free operational receipts. IDs are for joins, never metric labels. */\nexport interface OperationTelemetryEvent {\n schemaVersion: 1;\n eventId: string;\n operationId: string;\n attemptId: string;\n parentAttemptId?: string;\n /** Resumed scans share a cumulative measurement scope; never sum those receipts. */\n usageScopeId: string;\n occurredAt: string;\n observedAt: string;\n type: \"attempt_started\" | \"attempt_finished\";\n command:\n | \"scan\"\n | \"patch\"\n | \"validate\"\n | \"policy\"\n | \"verify-fix\"\n | \"assess-patch-risk\";\n surface: \"cli\" | \"sdk\";\n packageVersion: string;\n mode?: \"standard\" | \"deep\";\n resumed: boolean;\n /** True when this call returned a saved result without starting new work. */\n reusedResult?: boolean;\n outcome?: OperationOutcome;\n failureCategory?: OperationFailureCategory;\n durationMs?: number;\n measurement?: Readonly<ScanUsageMeasurement>;\n findingCount?: number;\n reviewedSurfaceCount?: number;\n deferredCount?: number;\n pluginVersion?: string;\n providerFamily?: string;\n validationDisposition?:\n \"reportable\" | \"suppressed\" | \"not_applicable\" | \"deferred\";\n artifactComplete?: boolean;\n collection: { persisted: number; writeFailures: number };\n}\n\ninterface OperationTelemetryOptions {\n directory: string;\n protectedRepository?: string;\n protectedOutput?: string;\n command: OperationTelemetryEvent[\"command\"];\n surface: OperationTelemetryEvent[\"surface\"];\n mode?: OperationTelemetryEvent[\"mode\"];\n resumeScanId?: string;\n deferPersistence?: boolean;\n context?: { operationId: string; parentAttemptId?: string };\n onEvent?: (event: Readonly<OperationTelemetryEvent>) => void;\n onError?: (error: unknown) => void;\n}\n\n/** Local journal only. Export, acknowledgement and retention belong to the host. */\nexport class OperationTelemetry {\n readonly attemptId = randomUUID();\n operationId: string;\n measurement: Readonly<ScanUsageMeasurement> | undefined;\n reusedResult = false;\n nativeTurnFailed = false;\n readonly #started = performance.now();\n readonly #startedAt = new Date().toISOString();\n readonly #options: OperationTelemetryOptions;\n readonly #directory: string;\n #persisted = 0;\n #writeFailures = 0;\n #ready = false;\n #runtime: Pick<OperationTelemetryEvent, \"pluginVersion\" | \"providerFamily\"> =\n {};\n #finished = false;\n #usageScopeId: string = this.attemptId;\n #deferred: boolean;\n #startedEvent: OperationTelemetryEvent | undefined;\n\n constructor(options: OperationTelemetryOptions) {\n this.#options = options;\n this.operationId = options.context?.operationId ?? randomUUID();\n this.#directory = join(options.directory, \"telemetry\");\n this.#deferred = options.deferPersistence === true;\n }\n\n get context() {\n return {\n operationId: this.operationId,\n attemptId: this.attemptId,\n ...(this.#options.context?.parentAttemptId === undefined\n ? {}\n : { parentAttemptId: this.#options.context.parentAttemptId }),\n };\n }\n\n async start(): Promise<void> {\n if (!this.#deferred) await this.#preparePersistence();\n await this.#emit(\"attempt_started\");\n }\n\n /** Callers establish repository and artifact protection before any writes. */\n async activatePersistence(\n protectedRoots: readonly string[],\n savedOutput?: string,\n ): Promise<void> {\n if (!this.#deferred || this.#finished) return;\n this.#deferred = false;\n await this.#preparePersistence(protectedRoots, savedOutput);\n if (this.#startedEvent !== undefined) {\n const event = {\n ...this.#startedEvent,\n ...this.context,\n usageScopeId: this.#usageScopeId,\n collection: {\n persisted: this.#persisted + (this.#ready ? 1 : 0),\n writeFailures: this.#writeFailures,\n },\n };\n if (this.#ready) await this.#persist(event);\n if (this.#options.resumeScanId !== undefined) this.#notify(event);\n }\n this.#startedEvent = undefined;\n }\n\n async #preparePersistence(\n additionalRoots: readonly string[] = [],\n savedOutput?: string,\n ): Promise<void> {\n try {\n const protectedRoots = [...additionalRoots];\n for (const output of [this.#options.protectedOutput, savedOutput]) {\n if (output !== undefined)\n protectedRoots.push(await canonicalConfigPath(output));\n }\n if (this.#options.protectedRepository !== undefined) {\n const repository = await canonicalConfigPath(\n this.#options.protectedRepository,\n );\n protectedRoots.push(\n repository,\n ...(await gitProtectionRoots(this.#options.protectedRepository)),\n );\n }\n if (protectedRoots.length > 0) {\n requireOutputOutsideRepositories(\n protectedRoots,\n await canonicalConfigPath(this.#directory),\n \"runtime\",\n );\n }\n await requireSecureOutputAncestry(this.#directory);\n await mkdir(this.#directory, { recursive: true, mode: 0o700 });\n this.#ready = true;\n if (this.#options.resumeScanId !== undefined) {\n try {\n const saved = JSON.parse(\n await readFile(\n this.#bindingPath(this.#options.resumeScanId),\n \"utf8\",\n ),\n ) as { operationId: string; usageScopeId: string };\n this.operationId = saved.operationId;\n this.#usageScopeId = saved.usageScopeId;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\")\n this.#error(error);\n }\n }\n } catch (error) {\n this.#error(error);\n }\n }\n\n async bindScan(scanId: string): Promise<void> {\n if (!this.#ready) return;\n try {\n await writeFile(\n this.#bindingPath(scanId),\n JSON.stringify({\n ...this.context,\n usageScopeId: this.#usageScopeId,\n }),\n {\n mode: 0o600,\n },\n );\n } catch (error) {\n this.#error(error);\n }\n }\n\n describe(\n runtime: Pick<OperationTelemetryEvent, \"pluginVersion\" | \"providerFamily\">,\n ): void {\n this.#runtime = runtime;\n }\n\n async finish(\n outcome: OperationOutcome,\n details: Pick<\n OperationTelemetryEvent,\n | \"failureCategory\"\n | \"findingCount\"\n | \"artifactComplete\"\n | \"reviewedSurfaceCount\"\n | \"deferredCount\"\n | \"validationDisposition\"\n > = {},\n ): Promise<void> {\n if (this.#finished) return;\n this.#finished = true;\n if (\n this.#startedEvent !== undefined &&\n this.#options.resumeScanId !== undefined\n ) {\n this.#notify(this.#startedEvent);\n this.#startedEvent = undefined;\n }\n await this.#emit(\"attempt_finished\", {\n outcome,\n reusedResult: this.reusedResult,\n durationMs: Math.max(0, performance.now() - this.#started),\n ...(this.measurement === undefined\n ? {}\n : { measurement: this.measurement }),\n ...this.#runtime,\n ...details,\n });\n }\n\n #bindingPath(scanId: string): string {\n return join(\n this.#directory,\n `${createHash(\"sha256\").update(scanId).digest(\"hex\")}.binding.json`,\n );\n }\n\n #error(error: unknown): void {\n this.#writeFailures++;\n try {\n this.#options.onError?.(error);\n } catch {}\n }\n\n async #persist(event: OperationTelemetryEvent): Promise<void> {\n try {\n await appendFile(\n join(this.#directory, `${this.attemptId}.jsonl`),\n `${JSON.stringify(event)}\\n`,\n { mode: 0o600 },\n );\n this.#persisted++;\n } catch (error) {\n this.#error(error);\n event.collection = {\n persisted: this.#persisted,\n writeFailures: this.#writeFailures,\n };\n }\n }\n\n async #emit(\n type: OperationTelemetryEvent[\"type\"],\n details: Partial<OperationTelemetryEvent> = {},\n ): Promise<void> {\n const time = new Date().toISOString();\n const event: OperationTelemetryEvent = {\n schemaVersion: 1,\n eventId: `${this.attemptId}:${type}`,\n ...this.context,\n usageScopeId: this.#usageScopeId,\n occurredAt: type === \"attempt_started\" ? this.#startedAt : time,\n observedAt: time,\n type,\n command: this.#options.command,\n surface: this.#options.surface,\n packageVersion: VERSION,\n ...(this.#options.mode === undefined ? {} : { mode: this.#options.mode }),\n resumed: this.#options.resumeScanId !== undefined,\n ...details,\n collection: {\n persisted: this.#persisted + (this.#ready ? 1 : 0),\n writeFailures: this.#writeFailures,\n },\n };\n if (this.#ready) await this.#persist(event);\n else if (this.#deferred && type === \"attempt_started\") {\n this.#startedEvent = event;\n // Resume identity is restored only after the caller protects output paths.\n if (this.#options.resumeScanId !== undefined) return;\n }\n this.#notify(event);\n }\n\n #notify(event: OperationTelemetryEvent): void {\n // Observers cannot delay or fail the operation. Replay uses the same event ID.\n void Promise.resolve()\n .then(() => this.#options.onEvent?.(event))\n .catch(() => {});\n }\n}\n\n/** Read durable receipts, retaining explicit evidence of truncated/corrupt records. */\nexport async function readOperationTelemetry(stateDirectory: string): Promise<{\n events: OperationTelemetryEvent[];\n parseFailures: number;\n}> {\n const directory = join(stateDirectory, \"telemetry\");\n const events: OperationTelemetryEvent[] = [];\n let parseFailures = 0;\n const names = await readdir(directory).catch(\n (error: NodeJS.ErrnoException) => {\n if (error.code === \"ENOENT\") return [];\n throw error;\n },\n );\n for (const name of names.filter((name) => name.endsWith(\".jsonl\")).sort()) {\n for (const line of (await readFile(join(directory, name), \"utf8\")).split(\n \"\\n\",\n )) {\n if (!line) continue;\n try {\n const event = JSON.parse(line) as OperationTelemetryEvent;\n if (\n event.schemaVersion !== 1 ||\n typeof event.eventId !== \"string\" ||\n typeof event.attemptId !== \"string\" ||\n typeof event.operationId !== \"string\" ||\n typeof event.usageScopeId !== \"string\" ||\n ![\"attempt_started\", \"attempt_finished\"].includes(event.type) ||\n ((event.type === \"attempt_finished\" || event.outcome !== undefined) &&\n ![\"completed\", \"failed\", \"canceled\", \"unresolved\"].includes(\n event.outcome ?? \"\",\n )) ||\n (event.measurement !== undefined &&\n ![\"complete\", \"partial\", \"unavailable\"].includes(\n event.measurement?.coverage,\n ))\n ) {\n parseFailures++;\n } else events.push(event);\n } catch {\n parseFailures++;\n }\n }\n }\n return { events, parseFailures };\n}\n\n/** Attempts without a terminal receipt remain unresolved, including process loss. */\nexport function summarizeOperationTelemetry(\n events: readonly OperationTelemetryEvent[],\n) {\n const seen = new Set<string>();\n const attempts = new Map<string, OperationTelemetryEvent>();\n let duplicates = 0;\n for (const event of events) {\n if (seen.has(event.eventId)) {\n duplicates++;\n continue;\n }\n seen.add(event.eventId);\n const previous = attempts.get(event.attemptId);\n if (\n previous?.type !== \"attempt_finished\" ||\n event.type === \"attempt_finished\"\n )\n attempts.set(event.attemptId, event);\n }\n const operations = new Map<string, boolean>();\n const outcomes = { completed: 0, failed: 0, canceled: 0, unresolved: 0 };\n const usageCoverage = { complete: 0, partial: 0, unavailable: 0 };\n const durationMs: number[] = [];\n let observedCostUsd = 0;\n let pricedAttempts = 0;\n let reusedAttempts = 0;\n const costsByScope = new Map<string, number>();\n for (const event of attempts.values()) {\n operations.set(\n event.operationId,\n operations.get(event.operationId) === true ||\n event.outcome === \"completed\",\n );\n outcomes[event.outcome ?? \"unresolved\"]++;\n if (event.reusedResult === true) reusedAttempts++;\n else usageCoverage[event.measurement?.coverage ?? \"unavailable\"]++;\n if (event.durationMs !== undefined) durationMs.push(event.durationMs);\n if (event.measurement?.cost != null) {\n costsByScope.set(\n event.usageScopeId,\n Math.max(\n costsByScope.get(event.usageScopeId) ?? 0,\n event.measurement.cost.estimatedUsd,\n ),\n );\n pricedAttempts++;\n }\n }\n for (const cost of costsByScope.values()) observedCostUsd += cost;\n return {\n operations: operations.size,\n successfulOperations: [...operations.values()].filter(Boolean).length,\n attempts: attempts.size,\n outcomes,\n usageCoverage,\n durationMs,\n observedCostUsd,\n pricedAttempts,\n reusedAttempts,\n duplicates,\n };\n}\n"]}
@@ -0,0 +1,4 @@
1
+ export declare const PLUGIN_PYTHON_READY = "codex-security-python-ok";
2
+ export declare const PLUGIN_PYTHON_PROBE_TIMEOUT_MS = 30000;
3
+ export declare const PLUGIN_PYTHON_PROBE: string;
4
+ //# sourceMappingURL=plugin-python-probe.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-python-probe.d.ts","sourceRoot":"","sources":["../src/plugin-python-probe.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,eAAO,MAAM,mBAAmB,QAKpB,CAAC"}
@@ -0,0 +1,10 @@
1
+ export const PLUGIN_PYTHON_READY = "codex-security-python-ok";
2
+ // Cold Python startup can exceed five seconds on busy Windows hosts.
3
+ export const PLUGIN_PYTHON_PROBE_TIMEOUT_MS = 30_000;
4
+ export const PLUGIN_PYTHON_PROBE = [
5
+ "import importlib.util,sys",
6
+ "if sys.version_info < (3, 10): raise SystemExit(1)",
7
+ "if sys.version_info < (3, 11) and importlib.util.find_spec('tomli') is None: raise SystemExit(1)",
8
+ `print('${PLUGIN_PYTHON_READY}')`,
9
+ ].join("\n");
10
+ //# sourceMappingURL=plugin-python-probe.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-python-probe.js","sourceRoot":"","sources":["../src/plugin-python-probe.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAC9D,qEAAqE;AACrE,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAErD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,2BAA2B;IAC3B,oDAAoD;IACpD,kGAAkG;IAClG,UAAU,mBAAmB,IAAI;CAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC","sourcesContent":["export const PLUGIN_PYTHON_READY = \"codex-security-python-ok\";\n// Cold Python startup can exceed five seconds on busy Windows hosts.\nexport const PLUGIN_PYTHON_PROBE_TIMEOUT_MS = 30_000;\n\nexport const PLUGIN_PYTHON_PROBE = [\n \"import importlib.util,sys\",\n \"if sys.version_info < (3, 10): raise SystemExit(1)\",\n \"if sys.version_info < (3, 11) and importlib.util.find_spec('tomli') is None: raise SystemExit(1)\",\n `print('${PLUGIN_PYTHON_READY}')`,\n].join(\"\\n\");\n"]}