@openai/codex-security 0.1.31 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/README.md +442 -2434
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +3 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +7 -214
  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/permission-profile-preflight.mjs +563 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +5 -5
  25. package/_bundled_plugin/references/config-preflight.md +1 -5
  26. package/_bundled_plugin/references/core-scan.md +34 -10
  27. package/_bundled_plugin/references/final-report.md +13 -13
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +3 -4
  31. package/_bundled_plugin/references/scan-contract.md +11 -6
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +2 -2
  36. package/_bundled_plugin/schemas/coverage.schema.json +23 -47
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +71 -192
  40. package/_bundled_plugin/schemas/scan-manifest.schema.json +83 -95
  41. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  42. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  43. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  44. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  45. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  46. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +245 -356
  47. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  48. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  49. package/_bundled_plugin/scripts/config_preflight.py +29 -69
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +208 -363
  52. package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +733 -375
  54. package/_bundled_plugin/scripts/finding_preview.py +81 -91
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +48 -102
  56. package/_bundled_plugin/scripts/generate_rank_input.py +117 -888
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -6
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +43 -902
  60. package/_bundled_plugin/scripts/report_projection.py +143 -219
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +161 -0
  63. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  64. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  65. package/_bundled_plugin/scripts/windows_scan_local_files.py +59 -9
  66. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  67. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  68. package/_bundled_plugin/scripts/workbench/storage.py +21 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +99 -190
  70. package/_bundled_plugin/scripts/workbench_constants.py +6 -14
  71. package/_bundled_plugin/scripts/workbench_db.py +524 -672
  72. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  73. package/_bundled_plugin/scripts/workbench_finding_index.py +20 -7
  74. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  75. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  76. package/_bundled_plugin/scripts/workbench_native_indexes.py +28 -18
  77. package/_bundled_plugin/scripts/workbench_progress.py +26 -92
  78. package/_bundled_plugin/scripts/workbench_publication.py +77 -116
  79. package/_bundled_plugin/scripts/workbench_remediation.py +14 -20
  80. package/_bundled_plugin/scripts/workbench_saved_results.py +1402 -263
  81. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  82. package/_bundled_plugin/scripts/workbench_scan_start.py +109 -52
  83. package/_bundled_plugin/scripts/workbench_scan_usage.py +30 -49
  84. package/_bundled_plugin/scripts/workbench_schema.py +71 -1370
  85. package/_bundled_plugin/scripts/workbench_source_excerpt.py +16 -7
  86. package/_bundled_plugin/scripts/workbench_target.py +526 -150
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
  88. package/_bundled_plugin/scripts/workbench_validation.py +19 -44
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  90. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  91. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  92. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  93. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  94. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  95. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +6 -6
  96. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  97. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  98. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  99. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  100. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  104. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  105. package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
  106. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  107. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  108. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  109. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  110. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  111. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  112. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  113. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  114. package/bin/codex-security.mjs +9 -2
  115. package/dist/api.d.ts +63 -15
  116. package/dist/api.d.ts.map +1 -1
  117. package/dist/api.js +970 -553
  118. package/dist/api.js.map +1 -1
  119. package/dist/artifact-export.d.ts +70 -0
  120. package/dist/artifact-export.d.ts.map +1 -0
  121. package/dist/artifact-export.js +292 -0
  122. package/dist/artifact-export.js.map +1 -0
  123. package/dist/auth.d.ts +2 -6
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +27 -12
  126. package/dist/auth.js.map +1 -1
  127. package/dist/bulk-scan-discovery.d.ts +1 -0
  128. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  129. package/dist/bulk-scan-discovery.js +9 -9
  130. package/dist/bulk-scan-discovery.js.map +1 -1
  131. package/dist/classify-scan-severity.d.ts.map +1 -1
  132. package/dist/classify-scan-severity.js +2 -5
  133. package/dist/classify-scan-severity.js.map +1 -1
  134. package/dist/classify-severity.d.ts +28 -17
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +16 -35
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli-help.d.ts +3 -0
  139. package/dist/cli-help.d.ts.map +1 -0
  140. package/dist/cli-help.js +285 -0
  141. package/dist/cli-help.js.map +1 -0
  142. package/dist/cli-signals.d.ts +8 -0
  143. package/dist/cli-signals.d.ts.map +1 -0
  144. package/dist/cli-signals.js +28 -0
  145. package/dist/cli-signals.js.map +1 -0
  146. package/dist/cli.d.ts +22 -24
  147. package/dist/cli.d.ts.map +1 -1
  148. package/dist/cli.js +1660 -1556
  149. package/dist/cli.js.map +1 -1
  150. package/dist/cloud-publish.d.ts.map +1 -1
  151. package/dist/cloud-publish.js +11 -17
  152. package/dist/cloud-publish.js.map +1 -1
  153. package/dist/codeowners.d.ts +19 -0
  154. package/dist/codeowners.d.ts.map +1 -0
  155. package/dist/codeowners.js +138 -0
  156. package/dist/codeowners.js.map +1 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +1 -2
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/codex-sdk-environment.d.ts +3 -0
  161. package/dist/codex-sdk-environment.d.ts.map +1 -0
  162. package/dist/codex-sdk-environment.js +68 -0
  163. package/dist/codex-sdk-environment.js.map +1 -0
  164. package/dist/component-plan.d.ts +2 -5
  165. package/dist/component-plan.d.ts.map +1 -1
  166. package/dist/component-plan.js +38 -34
  167. package/dist/component-plan.js.map +1 -1
  168. package/dist/component-scan.d.ts +7 -5
  169. package/dist/component-scan.d.ts.map +1 -1
  170. package/dist/component-scan.js +54 -44
  171. package/dist/component-scan.js.map +1 -1
  172. package/dist/config.d.ts.map +1 -1
  173. package/dist/config.js +93 -104
  174. package/dist/config.js.map +1 -1
  175. package/dist/contract.d.ts +15 -2
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +124 -348
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost-model.d.ts +13 -6
  180. package/dist/cost-model.d.ts.map +1 -1
  181. package/dist/cost-model.js +75 -34
  182. package/dist/cost-model.js.map +1 -1
  183. package/dist/cost.d.ts +10 -2
  184. package/dist/cost.d.ts.map +1 -1
  185. package/dist/cost.js +116 -134
  186. package/dist/cost.js.map +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +7 -6
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/custom-validation.d.ts +1 -2
  191. package/dist/custom-validation.d.ts.map +1 -1
  192. package/dist/custom-validation.js +23 -16
  193. package/dist/custom-validation.js.map +1 -1
  194. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  195. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  196. package/dist/deduplication/checkpointed-review.js +33 -20
  197. package/dist/deduplication/checkpointed-review.js.map +1 -1
  198. package/dist/deduplication/codex-review.d.ts +9 -1
  199. package/dist/deduplication/codex-review.d.ts.map +1 -1
  200. package/dist/deduplication/codex-review.js +129 -20
  201. package/dist/deduplication/codex-review.js.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  203. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  204. package/dist/deduplication/deduplication-prompts.js +18 -4
  205. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  207. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  208. package/dist/deduplication/deduplication-reviewer.js +59 -47
  209. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  210. package/dist/deduplication/deduplication.d.ts.map +1 -1
  211. package/dist/deduplication/deduplication.js +59 -113
  212. package/dist/deduplication/deduplication.js.map +1 -1
  213. package/dist/deduplication/diagnostics.d.ts +17 -0
  214. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  215. package/dist/deduplication/diagnostics.js +5 -0
  216. package/dist/deduplication/diagnostics.js.map +1 -0
  217. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  218. package/dist/deduplication/finding-schema.js +7 -1
  219. package/dist/deduplication/finding-schema.js.map +1 -1
  220. package/dist/deduplication/local.d.ts +31 -0
  221. package/dist/deduplication/local.d.ts.map +1 -0
  222. package/dist/deduplication/local.js +166 -0
  223. package/dist/deduplication/local.js.map +1 -0
  224. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  225. package/dist/deduplication/records-protocol.js +12 -28
  226. package/dist/deduplication/records-protocol.js.map +1 -1
  227. package/dist/deduplication/records.d.ts +188 -12
  228. package/dist/deduplication/records.d.ts.map +1 -1
  229. package/dist/deduplication/records.js +34 -24
  230. package/dist/deduplication/records.js.map +1 -1
  231. package/dist/deduplication/review.d.ts +7 -0
  232. package/dist/deduplication/review.d.ts.map +1 -1
  233. package/dist/deduplication/review.js.map +1 -1
  234. package/dist/deduplication/scan.d.ts +9 -3
  235. package/dist/deduplication/scan.d.ts.map +1 -1
  236. package/dist/deduplication/scan.js +159 -44
  237. package/dist/deduplication/scan.js.map +1 -1
  238. package/dist/deep-config.d.ts +2 -1
  239. package/dist/deep-config.d.ts.map +1 -1
  240. package/dist/deep-config.js +7 -23
  241. package/dist/deep-config.js.map +1 -1
  242. package/dist/deep-progress.d.ts +2 -1
  243. package/dist/deep-progress.d.ts.map +1 -1
  244. package/dist/deep-progress.js +32 -47
  245. package/dist/deep-progress.js.map +1 -1
  246. package/dist/deep-scan.d.ts +20 -0
  247. package/dist/deep-scan.d.ts.map +1 -0
  248. package/dist/deep-scan.js +113 -0
  249. package/dist/deep-scan.js.map +1 -0
  250. package/dist/errors.d.ts +5 -2
  251. package/dist/errors.d.ts.map +1 -1
  252. package/dist/errors.js +7 -7
  253. package/dist/errors.js.map +1 -1
  254. package/dist/feedback.d.ts.map +1 -1
  255. package/dist/feedback.js +53 -21
  256. package/dist/feedback.js.map +1 -1
  257. package/dist/finding-catalogue.d.ts.map +1 -1
  258. package/dist/finding-catalogue.js +26 -30
  259. package/dist/finding-catalogue.js.map +1 -1
  260. package/dist/finding-normalization.d.ts +5 -0
  261. package/dist/finding-normalization.d.ts.map +1 -0
  262. package/dist/finding-normalization.js +120 -0
  263. package/dist/finding-normalization.js.map +1 -0
  264. package/dist/finding-retrieval.d.ts +9 -0
  265. package/dist/finding-retrieval.d.ts.map +1 -1
  266. package/dist/finding-retrieval.js.map +1 -1
  267. package/dist/finding-workflow.d.ts +13 -8
  268. package/dist/finding-workflow.d.ts.map +1 -1
  269. package/dist/finding-workflow.js +18 -13
  270. package/dist/finding-workflow.js.map +1 -1
  271. package/dist/findings-client.d.ts +2 -1
  272. package/dist/findings-client.d.ts.map +1 -1
  273. package/dist/findings-client.js +36 -9
  274. package/dist/findings-client.js.map +1 -1
  275. package/dist/findings-errors.d.ts +16 -0
  276. package/dist/findings-errors.d.ts.map +1 -0
  277. package/dist/findings-errors.js +24 -0
  278. package/dist/findings-errors.js.map +1 -0
  279. package/dist/findings-import.d.ts +1 -1
  280. package/dist/findings-import.d.ts.map +1 -1
  281. package/dist/findings-import.js +16 -44
  282. package/dist/findings-import.js.map +1 -1
  283. package/dist/github.d.ts.map +1 -1
  284. package/dist/github.js +9 -4
  285. package/dist/github.js.map +1 -1
  286. package/dist/import-scan.d.ts.map +1 -1
  287. package/dist/import-scan.js +49 -39
  288. package/dist/import-scan.js.map +1 -1
  289. package/dist/index.d.ts +11 -5
  290. package/dist/index.d.ts.map +1 -1
  291. package/dist/index.js +2 -1
  292. package/dist/index.js.map +1 -1
  293. package/dist/knowledge-base.d.ts +7 -1
  294. package/dist/knowledge-base.d.ts.map +1 -1
  295. package/dist/knowledge-base.js +115 -47
  296. package/dist/knowledge-base.js.map +1 -1
  297. package/dist/linear.d.ts.map +1 -1
  298. package/dist/linear.js +4 -10
  299. package/dist/linear.js.map +1 -1
  300. package/dist/mock-scan.d.ts.map +1 -1
  301. package/dist/mock-scan.js +0 -1
  302. package/dist/mock-scan.js.map +1 -1
  303. package/dist/models.d.ts +24 -2
  304. package/dist/models.d.ts.map +1 -1
  305. package/dist/models.js.map +1 -1
  306. package/dist/multiscan.d.ts +9 -3
  307. package/dist/multiscan.d.ts.map +1 -1
  308. package/dist/multiscan.js +225 -153
  309. package/dist/multiscan.js.map +1 -1
  310. package/dist/owner-evidence.d.ts +10 -2
  311. package/dist/owner-evidence.d.ts.map +1 -1
  312. package/dist/owner-evidence.js +69 -14
  313. package/dist/owner-evidence.js.map +1 -1
  314. package/dist/patch-tui.d.ts.map +1 -1
  315. package/dist/patch-tui.js +5 -6
  316. package/dist/patch-tui.js.map +1 -1
  317. package/dist/project-config-schema.d.ts +10 -0
  318. package/dist/project-config-schema.d.ts.map +1 -1
  319. package/dist/project-config-schema.js +1 -0
  320. package/dist/project-config-schema.js.map +1 -1
  321. package/dist/project-config.d.ts +1 -0
  322. package/dist/project-config.d.ts.map +1 -1
  323. package/dist/project-config.js +5 -3
  324. package/dist/project-config.js.map +1 -1
  325. package/dist/prompt-files.d.ts +0 -1
  326. package/dist/prompt-files.d.ts.map +1 -1
  327. package/dist/prompt-files.js +2 -4
  328. package/dist/prompt-files.js.map +1 -1
  329. package/dist/provider-profile.d.ts +21 -0
  330. package/dist/provider-profile.d.ts.map +1 -0
  331. package/dist/provider-profile.js +133 -0
  332. package/dist/provider-profile.js.map +1 -0
  333. package/dist/publication-events.d.ts +6 -8
  334. package/dist/publication-events.d.ts.map +1 -1
  335. package/dist/publication-events.js +40 -79
  336. package/dist/publication-events.js.map +1 -1
  337. package/dist/publication-store.d.ts.map +1 -1
  338. package/dist/publication-store.js +48 -76
  339. package/dist/publication-store.js.map +1 -1
  340. package/dist/publication.d.ts +1 -2
  341. package/dist/publication.d.ts.map +1 -1
  342. package/dist/publication.js +7 -16
  343. package/dist/publication.js.map +1 -1
  344. package/dist/publish.d.ts +1 -5
  345. package/dist/publish.d.ts.map +1 -1
  346. package/dist/publish.js +138 -199
  347. package/dist/publish.js.map +1 -1
  348. package/dist/record.d.ts +2 -0
  349. package/dist/record.d.ts.map +1 -0
  350. package/dist/record.js +4 -0
  351. package/dist/record.js.map +1 -0
  352. package/dist/request-metadata.d.ts +9 -0
  353. package/dist/request-metadata.d.ts.map +1 -0
  354. package/dist/request-metadata.js +13 -0
  355. package/dist/request-metadata.js.map +1 -0
  356. package/dist/result.d.ts +4 -1
  357. package/dist/result.d.ts.map +1 -1
  358. package/dist/result.js +7 -0
  359. package/dist/result.js.map +1 -1
  360. package/dist/runtime.d.ts +25 -17
  361. package/dist/runtime.d.ts.map +1 -1
  362. package/dist/runtime.js +619 -255
  363. package/dist/runtime.js.map +1 -1
  364. package/dist/saved-scan-bootstrap.d.ts +14 -0
  365. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  366. package/dist/saved-scan-bootstrap.js +261 -0
  367. package/dist/saved-scan-bootstrap.js.map +1 -0
  368. package/dist/saved-scan.d.ts +1 -1
  369. package/dist/saved-scan.d.ts.map +1 -1
  370. package/dist/saved-scan.js +16 -32
  371. package/dist/saved-scan.js.map +1 -1
  372. package/dist/scan-activity.d.ts.map +1 -1
  373. package/dist/scan-activity.js +19 -30
  374. package/dist/scan-activity.js.map +1 -1
  375. package/dist/scan-comparison.d.ts +31 -18
  376. package/dist/scan-comparison.d.ts.map +1 -1
  377. package/dist/scan-comparison.js +307 -347
  378. package/dist/scan-comparison.js.map +1 -1
  379. package/dist/scan-dashboard.d.ts +3 -1
  380. package/dist/scan-dashboard.d.ts.map +1 -1
  381. package/dist/scan-dashboard.js +351 -92
  382. package/dist/scan-dashboard.js.map +1 -1
  383. package/dist/scan-history-renderer.d.ts.map +1 -1
  384. package/dist/scan-history-renderer.js +55 -15
  385. package/dist/scan-history-renderer.js.map +1 -1
  386. package/dist/scan-inputs.d.ts +6 -0
  387. package/dist/scan-inputs.d.ts.map +1 -0
  388. package/dist/scan-inputs.js +71 -0
  389. package/dist/scan-inputs.js.map +1 -0
  390. package/dist/scan-logs.d.ts +2 -3
  391. package/dist/scan-logs.d.ts.map +1 -1
  392. package/dist/scan-logs.js +14 -12
  393. package/dist/scan-logs.js.map +1 -1
  394. package/dist/scan-sessions.d.ts +4 -0
  395. package/dist/scan-sessions.d.ts.map +1 -1
  396. package/dist/scan-sessions.js +18 -3
  397. package/dist/scan-sessions.js.map +1 -1
  398. package/dist/scan-settings.d.ts +5 -0
  399. package/dist/scan-settings.d.ts.map +1 -1
  400. package/dist/scan-settings.js +4 -0
  401. package/dist/scan-settings.js.map +1 -1
  402. package/dist/scan-skill-paths.d.ts +8 -0
  403. package/dist/scan-skill-paths.d.ts.map +1 -0
  404. package/dist/scan-skill-paths.js +47 -0
  405. package/dist/scan-skill-paths.js.map +1 -0
  406. package/dist/security-policy-cli.d.ts.map +1 -1
  407. package/dist/security-policy-cli.js +15 -33
  408. package/dist/security-policy-cli.js.map +1 -1
  409. package/dist/security-policy.d.ts +17 -9
  410. package/dist/security-policy.d.ts.map +1 -1
  411. package/dist/security-policy.js +131 -98
  412. package/dist/security-policy.js.map +1 -1
  413. package/dist/server/api.d.ts +0 -1
  414. package/dist/server/api.d.ts.map +1 -1
  415. package/dist/server/api.js +0 -1
  416. package/dist/server/api.js.map +1 -1
  417. package/dist/server/embeddings.d.ts +3 -1
  418. package/dist/server/embeddings.d.ts.map +1 -1
  419. package/dist/server/embeddings.js +11 -3
  420. package/dist/server/embeddings.js.map +1 -1
  421. package/dist/server/errors.d.ts +5 -2
  422. package/dist/server/errors.d.ts.map +1 -1
  423. package/dist/server/errors.js +7 -0
  424. package/dist/server/errors.js.map +1 -1
  425. package/dist/server/sqlite-store.d.ts +0 -2
  426. package/dist/server/sqlite-store.d.ts.map +1 -1
  427. package/dist/server/sqlite-store.js +55 -55
  428. package/dist/server/sqlite-store.js.map +1 -1
  429. package/dist/server/storage.d.ts +0 -2
  430. package/dist/server/storage.d.ts.map +1 -1
  431. package/dist/server/storage.js.map +1 -1
  432. package/dist/severity-store.js +20 -32
  433. package/dist/severity-store.js.map +1 -1
  434. package/dist/standalone-validation-prompt.d.ts +2 -0
  435. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  436. package/dist/standalone-validation-prompt.js +10 -0
  437. package/dist/standalone-validation-prompt.js.map +1 -0
  438. package/dist/suggest-owners.d.ts +6 -5
  439. package/dist/suggest-owners.d.ts.map +1 -1
  440. package/dist/suggest-owners.js +15 -10
  441. package/dist/suggest-owners.js.map +1 -1
  442. package/dist/targets.d.ts +12 -0
  443. package/dist/targets.d.ts.map +1 -1
  444. package/dist/targets.js +124 -62
  445. package/dist/targets.js.map +1 -1
  446. package/dist/trusted-executable.d.ts +6 -1
  447. package/dist/trusted-executable.d.ts.map +1 -1
  448. package/dist/trusted-executable.js +28 -9
  449. package/dist/trusted-executable.js.map +1 -1
  450. package/dist/value.d.ts +2 -0
  451. package/dist/value.d.ts.map +1 -0
  452. package/dist/value.js +27 -0
  453. package/dist/value.js.map +1 -0
  454. package/dist/version.d.ts.map +1 -1
  455. package/dist/version.js +3 -6
  456. package/dist/version.js.map +1 -1
  457. package/dist/windows-path.d.ts.map +1 -1
  458. package/dist/windows-path.js +1 -2
  459. package/dist/windows-path.js.map +1 -1
  460. package/dist/workbench-arguments.d.ts +3 -0
  461. package/dist/workbench-arguments.d.ts.map +1 -0
  462. package/dist/workbench-arguments.js +15 -0
  463. package/dist/workbench-arguments.js.map +1 -0
  464. package/dist/worker-progress.d.ts +2 -0
  465. package/dist/worker-progress.d.ts.map +1 -1
  466. package/dist/worker-progress.js +40 -46
  467. package/dist/worker-progress.js.map +1 -1
  468. package/docs/cli.md +1778 -0
  469. package/docs/dedupe-records.md +24 -0
  470. package/docs/findings-service.md +402 -0
  471. package/package.json +23 -23
  472. package/schemas/project-config.schema.json +5 -0
  473. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  474. package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
  475. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  476. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  477. package/_bundled_plugin/scripts/workbench_severity.py +0 -119
  478. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  479. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  480. package/dist/server/dashboard/app.css +0 -2
  481. package/dist/server/dashboard/app.js +0 -66
  482. package/dist/server/dashboard/index.html +0 -18
  483. package/dist/server/dashboard-types.d.ts +0 -48
  484. package/dist/server/dashboard-types.d.ts.map +0 -1
  485. package/dist/server/dashboard-types.js +0 -2
  486. package/dist/server/dashboard-types.js.map +0 -1
  487. package/dist/server/dashboard.d.ts +0 -6
  488. package/dist/server/dashboard.d.ts.map +0 -1
  489. package/dist/server/dashboard.js +0 -59
  490. package/dist/server/dashboard.js.map +0 -1
  491. package/dist/server/findings-service.d.ts +0 -20
  492. package/dist/server/findings-service.d.ts.map +0 -1
  493. package/dist/server/findings-service.js +0 -31
  494. package/dist/server/findings-service.js.map +0 -1
  495. package/dist/server/index.d.ts +0 -2
  496. package/dist/server/index.d.ts.map +0 -1
  497. package/dist/server/index.js +0 -6
  498. package/dist/server/index.js.map +0 -1
  499. package/dist/server/routes.d.ts +0 -6
  500. package/dist/server/routes.d.ts.map +0 -1
  501. package/dist/server/routes.js +0 -86
  502. package/dist/server/routes.js.map +0 -1
  503. package/dist/server/serve.d.ts +0 -2
  504. package/dist/server/serve.d.ts.map +0 -1
  505. package/dist/server/serve.js +0 -28
  506. package/dist/server/serve.js.map +0 -1
  507. package/dist/server/server.d.ts +0 -10
  508. package/dist/server/server.d.ts.map +0 -1
  509. package/dist/server/server.js +0 -17
  510. package/dist/server/server.js.map +0 -1
  511. package/dist/server/validation.d.ts +0 -17
  512. package/dist/server/validation.d.ts.map +0 -1
  513. package/dist/server/validation.js +0 -53
  514. package/dist/server/validation.js.map +0 -1
@@ -1,16 +1,5 @@
1
1
  export function groupFindings(findings, knownFindingGroups = [], occurrenceGroups = []) {
2
- const parents = new Map();
3
- const root = (value) => {
4
- const path = [];
5
- let current = value;
6
- while (parents.has(current)) {
7
- path.push(current);
8
- current = parents.get(current);
9
- }
10
- for (const item of path)
11
- parents.set(item, current);
12
- return current;
13
- };
2
+ const { parents, root } = findingGroupRoots();
14
3
  const link = (first, second) => {
15
4
  const previous = root(first);
16
5
  const current = root(second);
@@ -39,32 +28,21 @@ export function groupFindings(findings, knownFindingGroups = [], occurrenceGroup
39
28
  link(`finding:${findingId}`, `occurrence:${finding.occurrenceId}`);
40
29
  }
41
30
  }
42
- const groups = new Map();
43
- for (const finding of findings) {
44
- const key = root(`occurrence:${finding.occurrenceId}`);
45
- const group = groups.get(key);
46
- if (group === undefined)
47
- groups.set(key, [finding]);
48
- else
49
- group.push(finding);
50
- }
51
- return [...groups.values()];
31
+ return [
32
+ ...Map.groupBy(findings, (finding) => root(`occurrence:${finding.occurrenceId}`)).values(),
33
+ ];
52
34
  }
53
35
  export function findingCatalogue(findings, knownFindingGroups = []) {
54
36
  return new Map(groupFindings(findings, knownFindingGroups).map((occurrences) => {
55
37
  const latest = occurrences.at(-1);
56
38
  const card = compactFinding(latest);
57
39
  if (occurrences.length > 1) {
58
- const description = (finding) => {
59
- const value = { ...compactFinding(finding) };
60
- delete value["occurrenceId"];
61
- delete value["findingId"];
62
- return value;
63
- };
64
- const current = description(latest);
40
+ const current = compactFinding(latest);
65
41
  const seen = new Set();
66
42
  const aliases = occurrences.slice(0, -1).flatMap((finding) => {
67
- const value = Object.fromEntries(Object.entries(description(finding)).filter(([field, value]) => JSON.stringify(value) !== JSON.stringify(current[field])));
43
+ const value = Object.fromEntries(Object.entries(compactFinding(finding)).filter(([field, value]) => field !== "occurrenceId" &&
44
+ field !== "findingId" &&
45
+ JSON.stringify(value) !== JSON.stringify(current[field])));
68
46
  if (Object.keys(value).length === 0)
69
47
  return [];
70
48
  const key = JSON.stringify(value);
@@ -147,4 +125,22 @@ function present(value) {
147
125
  (!Array.isArray(item) || item.length > 0) &&
148
126
  (record(item) === undefined || Object.keys(item).length > 0)));
149
127
  }
128
+ /** @internal */
129
+ export function findingGroupRoots() {
130
+ const parents = new Map();
131
+ const root = (identity) => {
132
+ if (!parents.has(identity))
133
+ parents.set(identity, identity);
134
+ const path = [];
135
+ let current = identity;
136
+ while (parents.get(current) !== current) {
137
+ path.push(current);
138
+ current = parents.get(current);
139
+ }
140
+ for (const item of path)
141
+ parents.set(item, current);
142
+ return current;
143
+ };
144
+ return { parents, root };
145
+ }
150
146
  //# sourceMappingURL=finding-catalogue.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"finding-catalogue.js","sourceRoot":"","sources":["../src/finding-catalogue.ts"],"names":[],"mappings":"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","sourcesContent":["export type ComparisonFinding = { occurrenceId: string } & Record<\n string,\n unknown\n>;\n\nexport interface CatalogueEntry {\n card: ComparisonFinding;\n occurrences: readonly ComparisonFinding[];\n}\n\nexport function groupFindings(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n occurrenceGroups: readonly (readonly string[])[] = [],\n): ComparisonFinding[][] {\n const parents = new Map<string, string>();\n const root = (value: string): string => {\n const path: string[] = [];\n let current = value;\n while (parents.has(current)) {\n path.push(current);\n current = parents.get(current)!;\n }\n for (const item of path) parents.set(item, current);\n return current;\n };\n const link = (first: string, second: string): void => {\n const previous = root(first);\n const current = root(second);\n if (previous !== current) parents.set(current, previous);\n };\n for (const [prefix, groups] of [\n [\"finding\", knownFindingGroups],\n [\"occurrence\", occurrenceGroups],\n ] as const) {\n for (const group of groups) {\n const identities =\n prefix === \"finding\"\n ? group.filter((identity) => identity.trim().length > 0)\n : group;\n const first = identities[0];\n if (first === undefined) continue;\n for (const value of identities.slice(1)) {\n link(`${prefix}:${first}`, `${prefix}:${value}`);\n }\n }\n }\n for (const finding of findings) {\n const findingId = finding[\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n link(`finding:${findingId}`, `occurrence:${finding.occurrenceId}`);\n }\n }\n\n const groups = new Map<string, ComparisonFinding[]>();\n for (const finding of findings) {\n const key = root(`occurrence:${finding.occurrenceId}`);\n const group = groups.get(key);\n if (group === undefined) groups.set(key, [finding]);\n else group.push(finding);\n }\n\n return [...groups.values()];\n}\n\nexport function findingCatalogue(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n): Map<string, CatalogueEntry> {\n return new Map(\n groupFindings(findings, knownFindingGroups).map((occurrences) => {\n const latest = occurrences.at(-1)!;\n const card = compactFinding(latest);\n if (occurrences.length > 1) {\n const description = (finding: ComparisonFinding) => {\n const value: Record<string, unknown> = { ...compactFinding(finding) };\n delete value[\"occurrenceId\"];\n delete value[\"findingId\"];\n return value;\n };\n const current = description(latest);\n const seen = new Set<string>();\n const aliases = occurrences.slice(0, -1).flatMap((finding) => {\n const value = Object.fromEntries(\n Object.entries(description(finding)).filter(\n ([field, value]) =>\n JSON.stringify(value) !== JSON.stringify(current[field]),\n ),\n );\n if (Object.keys(value).length === 0) return [];\n const key = JSON.stringify(value);\n if (seen.has(key)) return [];\n seen.add(key);\n return [value];\n });\n card[\"occurrenceCount\"] = occurrences.length;\n if (aliases.length > 0) card[\"earlierDescriptions\"] = aliases;\n }\n const findingId = occurrences[0]![\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n card[\"issueId\"] = findingId;\n }\n return [latest.occurrenceId, { card, occurrences }];\n }),\n );\n}\n\nexport function compactFinding(finding: ComparisonFinding): ComparisonFinding {\n const rootCause = finding[\"rootCause\"] ?? finding[\"root_cause\"];\n const attackPath = record(finding[\"attackPath\"]);\n const dataFlow =\n attackPath?.[\"dataFlow\"] ??\n attackPath?.[\"data_flow\"] ??\n attackPath?.[\"dataflow\"];\n const locations = Array.isArray(finding[\"locations\"])\n ? finding[\"locations\"].flatMap((value) => {\n const location = record(value);\n return location === undefined ? [] : [location];\n })\n : [];\n let controls = locations.filter(\n (location) => location[\"role\"] === \"root_control\",\n );\n if (controls.length === 0) {\n controls = locations.filter((location) =>\n [\"expected_control\", \"concrete_implementation\"].includes(\n String(location[\"role\"]),\n ),\n );\n }\n if (controls.length === 0) controls = locations.slice(0, 1);\n\n return {\n occurrenceId: finding.occurrenceId,\n ...present({\n findingId: finding[\"findingId\"],\n title: finding[\"title\"],\n identity: pick(finding[\"identity\"], [\"anchor\", \"instance\"]),\n ruleId: finding[\"ruleId\"],\n taxonomy: pick(finding[\"taxonomy\"], [\"category\", \"cwe\"]),\n rootCause:\n (typeof rootCause === \"string\"\n ? rootCause\n : record(rootCause)?.[\"summary\"]) ?? finding[\"summary\"],\n remediation: finding[\"remediation\"],\n locations: controls.map((location) =>\n pick(location, [\"path\", \"startLine\", \"endLine\", \"role\"]),\n ),\n attackPath: present({\n dataFlow: pick(dataFlow, [\"source\", \"sink\"]),\n reachability: pick(attackPath?.[\"reachability\"], [\n \"attacker\",\n \"entrypoint\",\n ]),\n }),\n affectedComponent: finding[\"affectedComponent\"],\n boundaryCrossed: finding[\"boundaryCrossed\"],\n }),\n };\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === \"object\" && !Array.isArray(value)\n ? (value as Record<string, unknown>)\n : undefined;\n}\n\nfunction pick(value: unknown, fields: readonly string[]): unknown {\n if (typeof value === \"string\") return value;\n const object = record(value);\n return object === undefined\n ? undefined\n : present(\n Object.fromEntries(fields.map((field) => [field, object[field]])),\n );\n}\n\nfunction present(value: Record<string, unknown>): Record<string, unknown> {\n return Object.fromEntries(\n Object.entries(value).filter(\n ([, item]) =>\n item !== undefined &&\n item !== null &&\n item !== \"\" &&\n (!Array.isArray(item) || item.length > 0) &&\n (record(item) === undefined || Object.keys(item as object).length > 0),\n ),\n );\n}\n"]}
1
+ {"version":3,"file":"finding-catalogue.js","sourceRoot":"","sources":["../src/finding-catalogue.ts"],"names":[],"mappings":"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","sourcesContent":["export type ComparisonFinding = { occurrenceId: string } & Record<\n string,\n unknown\n>;\n\nexport interface CatalogueEntry {\n card: ComparisonFinding;\n occurrences: readonly ComparisonFinding[];\n}\n\nexport function groupFindings(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n occurrenceGroups: readonly (readonly string[])[] = [],\n): ComparisonFinding[][] {\n const { parents, root } = findingGroupRoots();\n const link = (first: string, second: string): void => {\n const previous = root(first);\n const current = root(second);\n if (previous !== current) parents.set(current, previous);\n };\n for (const [prefix, groups] of [\n [\"finding\", knownFindingGroups],\n [\"occurrence\", occurrenceGroups],\n ] as const) {\n for (const group of groups) {\n const identities =\n prefix === \"finding\"\n ? group.filter((identity) => identity.trim().length > 0)\n : group;\n const first = identities[0];\n if (first === undefined) continue;\n for (const value of identities.slice(1)) {\n link(`${prefix}:${first}`, `${prefix}:${value}`);\n }\n }\n }\n for (const finding of findings) {\n const findingId = finding[\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n link(`finding:${findingId}`, `occurrence:${finding.occurrenceId}`);\n }\n }\n\n return [\n ...Map.groupBy(findings, (finding) =>\n root(`occurrence:${finding.occurrenceId}`),\n ).values(),\n ];\n}\n\nexport function findingCatalogue(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n): Map<string, CatalogueEntry> {\n return new Map(\n groupFindings(findings, knownFindingGroups).map((occurrences) => {\n const latest = occurrences.at(-1)!;\n const card = compactFinding(latest);\n if (occurrences.length > 1) {\n const current = compactFinding(latest);\n const seen = new Set<string>();\n const aliases = occurrences.slice(0, -1).flatMap((finding) => {\n const value = Object.fromEntries(\n Object.entries(compactFinding(finding)).filter(\n ([field, value]) =>\n field !== \"occurrenceId\" &&\n field !== \"findingId\" &&\n JSON.stringify(value) !== JSON.stringify(current[field]),\n ),\n );\n if (Object.keys(value).length === 0) return [];\n const key = JSON.stringify(value);\n if (seen.has(key)) return [];\n seen.add(key);\n return [value];\n });\n card[\"occurrenceCount\"] = occurrences.length;\n if (aliases.length > 0) card[\"earlierDescriptions\"] = aliases;\n }\n const findingId = occurrences[0]![\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n card[\"issueId\"] = findingId;\n }\n return [latest.occurrenceId, { card, occurrences }];\n }),\n );\n}\n\nexport function compactFinding(finding: ComparisonFinding): ComparisonFinding {\n const rootCause = finding[\"rootCause\"] ?? finding[\"root_cause\"];\n const attackPath = record(finding[\"attackPath\"]);\n const dataFlow =\n attackPath?.[\"dataFlow\"] ??\n attackPath?.[\"data_flow\"] ??\n attackPath?.[\"dataflow\"];\n const locations = Array.isArray(finding[\"locations\"])\n ? finding[\"locations\"].flatMap((value) => {\n const location = record(value);\n return location === undefined ? [] : [location];\n })\n : [];\n let controls = locations.filter(\n (location) => location[\"role\"] === \"root_control\",\n );\n if (controls.length === 0) {\n controls = locations.filter((location) =>\n [\"expected_control\", \"concrete_implementation\"].includes(\n String(location[\"role\"]),\n ),\n );\n }\n if (controls.length === 0) controls = locations.slice(0, 1);\n\n return {\n occurrenceId: finding.occurrenceId,\n ...present({\n findingId: finding[\"findingId\"],\n title: finding[\"title\"],\n identity: pick(finding[\"identity\"], [\"anchor\", \"instance\"]),\n ruleId: finding[\"ruleId\"],\n taxonomy: pick(finding[\"taxonomy\"], [\"category\", \"cwe\"]),\n rootCause:\n (typeof rootCause === \"string\"\n ? rootCause\n : record(rootCause)?.[\"summary\"]) ?? finding[\"summary\"],\n remediation: finding[\"remediation\"],\n locations: controls.map((location) =>\n pick(location, [\"path\", \"startLine\", \"endLine\", \"role\"]),\n ),\n attackPath: present({\n dataFlow: pick(dataFlow, [\"source\", \"sink\"]),\n reachability: pick(attackPath?.[\"reachability\"], [\n \"attacker\",\n \"entrypoint\",\n ]),\n }),\n affectedComponent: finding[\"affectedComponent\"],\n boundaryCrossed: finding[\"boundaryCrossed\"],\n }),\n };\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === \"object\" && !Array.isArray(value)\n ? (value as Record<string, unknown>)\n : undefined;\n}\n\nfunction pick(value: unknown, fields: readonly string[]): unknown {\n if (typeof value === \"string\") return value;\n const object = record(value);\n return object === undefined\n ? undefined\n : present(\n Object.fromEntries(fields.map((field) => [field, object[field]])),\n );\n}\n\nfunction present(value: Record<string, unknown>): Record<string, unknown> {\n return Object.fromEntries(\n Object.entries(value).filter(\n ([, item]) =>\n item !== undefined &&\n item !== null &&\n item !== \"\" &&\n (!Array.isArray(item) || item.length > 0) &&\n (record(item) === undefined || Object.keys(item as object).length > 0),\n ),\n );\n}\n\n/** @internal */\nexport function findingGroupRoots() {\n const parents = new Map<string, string>();\n const root = (identity: string): string => {\n if (!parents.has(identity)) parents.set(identity, identity);\n const path: string[] = [];\n let current = identity;\n while (parents.get(current) !== current) {\n path.push(current);\n current = parents.get(current)!;\n }\n for (const item of path) parents.set(item, current);\n return current;\n };\n return { parents, root };\n}\n"]}
@@ -0,0 +1,5 @@
1
+ type JsonObject = Record<string, unknown>;
2
+ /** Compatibility for historical report reads; never use this to admit new writes. */
3
+ export declare function normalizePersistedFindingDetails(finding: JsonObject): void;
4
+ export {};
5
+ //# sourceMappingURL=finding-normalization.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"finding-normalization.d.ts","sourceRoot":"","sources":["../src/finding-normalization.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,qFAAqF;AACrF,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAkI1E"}
@@ -0,0 +1,120 @@
1
+ import { isRecord as isObject } from "./record.js";
2
+ /** Compatibility for historical report reads; never use this to admit new writes. */
3
+ export function normalizePersistedFindingDetails(finding) {
4
+ if (Array.isArray(finding["code_evidence"])) {
5
+ finding["code_evidence"] = finding["code_evidence"].filter((evidence) => isObject(evidence) &&
6
+ isNonEmptyString(evidence["id"]) &&
7
+ isNonEmptyString(evidence["code"]));
8
+ }
9
+ else if (finding["code_evidence"] !== null) {
10
+ delete finding["code_evidence"];
11
+ }
12
+ for (const [sectionName, listFields] of [
13
+ ["rootCause", ["evidenceRefs", "evidence_refs"]],
14
+ ["root_cause", ["evidenceRefs", "evidence_refs"]],
15
+ [
16
+ "validation",
17
+ [
18
+ "assertions",
19
+ "counterEvidence",
20
+ "evidence",
21
+ "evidenceRefs",
22
+ "evidence_refs",
23
+ "limitations",
24
+ ],
25
+ ],
26
+ [
27
+ "attackPath",
28
+ [
29
+ "assumptions",
30
+ "blindspots",
31
+ "controls",
32
+ "evidenceRefs",
33
+ "evidence_refs",
34
+ "limitations",
35
+ "preconditions",
36
+ "steps",
37
+ ],
38
+ ],
39
+ ]) {
40
+ const section = finding[sectionName];
41
+ if (!isObject(section))
42
+ continue;
43
+ normalizePersistedStringLists(section, listFields);
44
+ }
45
+ const legacyRootCause = finding["root_cause"];
46
+ if (isObject(legacyRootCause)) {
47
+ removeUnsupportedPersistedStrings(legacyRootCause, [
48
+ "summary",
49
+ "code",
50
+ "language",
51
+ ]);
52
+ }
53
+ else if (legacyRootCause !== null && typeof legacyRootCause !== "string") {
54
+ delete finding["root_cause"];
55
+ }
56
+ const validation = finding["validation"];
57
+ if (isObject(validation)) {
58
+ removeUnsupportedPersistedStrings(validation, ["method", "status", "summary", "disposition", "result"].filter((field) => !["status", "disposition", "result"].includes(field) ||
59
+ validation[field] !== null));
60
+ }
61
+ const attackPath = finding["attackPath"];
62
+ if (!isObject(attackPath))
63
+ return;
64
+ removeUnsupportedPersistedStrings(attackPath, ["summary"]);
65
+ for (const field of ["dataFlow", "data_flow", "dataflow", "reachability"]) {
66
+ const detail = attackPath[field];
67
+ if (!isObject(detail)) {
68
+ if (!isNonEmptyString(detail))
69
+ delete attackPath[field];
70
+ continue;
71
+ }
72
+ removeUnsupportedPersistedStrings(detail, [
73
+ "summary",
74
+ "source",
75
+ "sink",
76
+ "outcome",
77
+ ...(field === "reachability" ? ["attacker", "entrypoint"] : []),
78
+ ]);
79
+ normalizePersistedStringLists(detail, [
80
+ "evidenceRefs",
81
+ "evidence_refs",
82
+ "transformations",
83
+ ...(field === "reachability" ? ["preconditions"] : []),
84
+ ]);
85
+ }
86
+ for (const field of ["impact", "likelihood"]) {
87
+ const detail = attackPath[field];
88
+ if (isObject(detail)) {
89
+ removeUnsupportedPersistedStrings(detail, ["level", "rationale", "why"]);
90
+ }
91
+ else if (detail !== undefined &&
92
+ detail !== null &&
93
+ !isNonEmptyString(detail)) {
94
+ delete attackPath[field];
95
+ }
96
+ }
97
+ function normalizePersistedStringLists(section, fields) {
98
+ for (const field of fields) {
99
+ const value = section[field];
100
+ if (isNonEmptyString(value)) {
101
+ if (field !== "evidence")
102
+ section[field] = [value];
103
+ }
104
+ else if (Array.isArray(value))
105
+ section[field] = value.filter(isNonEmptyString);
106
+ else
107
+ delete section[field];
108
+ }
109
+ }
110
+ function removeUnsupportedPersistedStrings(section, fields) {
111
+ for (const field of fields) {
112
+ if (!isNonEmptyString(section[field]))
113
+ delete section[field];
114
+ }
115
+ }
116
+ function isNonEmptyString(value) {
117
+ return typeof value === "string" && value.length > 0;
118
+ }
119
+ }
120
+ //# sourceMappingURL=finding-normalization.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"finding-normalization.js","sourceRoot":"","sources":["../src/finding-normalization.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRecord as isObject } from \"./record.js\";\n\ntype JsonObject = Record<string, unknown>;\n\n/** Compatibility for historical report reads; never use this to admit new writes. */\nexport function normalizePersistedFindingDetails(finding: JsonObject): void {\n if (Array.isArray(finding[\"code_evidence\"])) {\n finding[\"code_evidence\"] = finding[\"code_evidence\"].filter(\n (evidence) =>\n isObject(evidence) &&\n isNonEmptyString(evidence[\"id\"]) &&\n isNonEmptyString(evidence[\"code\"]),\n );\n } else if (finding[\"code_evidence\"] !== null) {\n delete finding[\"code_evidence\"];\n }\n\n for (const [sectionName, listFields] of [\n [\"rootCause\", [\"evidenceRefs\", \"evidence_refs\"]],\n [\"root_cause\", [\"evidenceRefs\", \"evidence_refs\"]],\n [\n \"validation\",\n [\n \"assertions\",\n \"counterEvidence\",\n \"evidence\",\n \"evidenceRefs\",\n \"evidence_refs\",\n \"limitations\",\n ],\n ],\n [\n \"attackPath\",\n [\n \"assumptions\",\n \"blindspots\",\n \"controls\",\n \"evidenceRefs\",\n \"evidence_refs\",\n \"limitations\",\n \"preconditions\",\n \"steps\",\n ],\n ],\n ] satisfies Array<[string, string[]]>) {\n const section = finding[sectionName];\n if (!isObject(section)) continue;\n normalizePersistedStringLists(section, listFields);\n }\n\n const legacyRootCause = finding[\"root_cause\"];\n if (isObject(legacyRootCause)) {\n removeUnsupportedPersistedStrings(legacyRootCause, [\n \"summary\",\n \"code\",\n \"language\",\n ]);\n } else if (legacyRootCause !== null && typeof legacyRootCause !== \"string\") {\n delete finding[\"root_cause\"];\n }\n\n const validation = finding[\"validation\"];\n if (isObject(validation)) {\n removeUnsupportedPersistedStrings(\n validation,\n [\"method\", \"status\", \"summary\", \"disposition\", \"result\"].filter(\n (field) =>\n ![\"status\", \"disposition\", \"result\"].includes(field) ||\n validation[field] !== null,\n ),\n );\n }\n\n const attackPath = finding[\"attackPath\"];\n if (!isObject(attackPath)) return;\n removeUnsupportedPersistedStrings(attackPath, [\"summary\"]);\n for (const field of [\"dataFlow\", \"data_flow\", \"dataflow\", \"reachability\"]) {\n const detail = attackPath[field];\n if (!isObject(detail)) {\n if (!isNonEmptyString(detail)) delete attackPath[field];\n continue;\n }\n removeUnsupportedPersistedStrings(detail, [\n \"summary\",\n \"source\",\n \"sink\",\n \"outcome\",\n ...(field === \"reachability\" ? [\"attacker\", \"entrypoint\"] : []),\n ]);\n normalizePersistedStringLists(detail, [\n \"evidenceRefs\",\n \"evidence_refs\",\n \"transformations\",\n ...(field === \"reachability\" ? [\"preconditions\"] : []),\n ]);\n }\n for (const field of [\"impact\", \"likelihood\"]) {\n const detail = attackPath[field];\n if (isObject(detail)) {\n removeUnsupportedPersistedStrings(detail, [\"level\", \"rationale\", \"why\"]);\n } else if (\n detail !== undefined &&\n detail !== null &&\n !isNonEmptyString(detail)\n ) {\n delete attackPath[field];\n }\n }\n\n function normalizePersistedStringLists(\n section: JsonObject,\n fields: string[],\n ): void {\n for (const field of fields) {\n const value = section[field];\n if (isNonEmptyString(value)) {\n if (field !== \"evidence\") section[field] = [value];\n } else if (Array.isArray(value))\n section[field] = value.filter(isNonEmptyString);\n else delete section[field];\n }\n }\n\n function removeUnsupportedPersistedStrings(\n section: JsonObject,\n fields: string[],\n ): void {\n for (const field of fields) {\n if (!isNonEmptyString(section[field])) delete section[field];\n }\n }\n\n function isNonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0;\n }\n}\n"]}
@@ -6,8 +6,17 @@ export type FindingSearchScope = {
6
6
  allRepositories: true;
7
7
  repositoryId?: never;
8
8
  };
9
+ export interface FindingSourceSnapshot {
10
+ repositoryId: string | null;
11
+ revision: string;
12
+ snapshotDigest: string | null;
13
+ }
9
14
  export interface FindingNeighborhood {
10
15
  finding: Finding;
11
16
  potentialDuplicates: Finding[];
17
+ /** Saved storage associations, separate from model-authored finding content. */
18
+ repositoryIds?: Record<string, string[]>;
19
+ /** Present only when the current body matches its persisted scan occurrence. */
20
+ sourceSnapshots?: Record<string, FindingSourceSnapshot>;
12
21
  }
13
22
  //# sourceMappingURL=finding-retrieval.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"finding-retrieval.d.ts","sourceRoot":"","sources":["../src/finding-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAC1B;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,eAAe,EAAE,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,EAAE,CAAC;CAChC"}
1
+ {"version":3,"file":"finding-retrieval.d.ts","sourceRoot":"","sources":["../src/finding-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,kBAAkB,GAC1B;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,KAAK,CAAA;CAAE,GACjD;IAAE,eAAe,EAAE,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,OAAO,EAAE,CAAC;IAC/B,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACzD"}
@@ -1 +1 @@
1
- {"version":3,"file":"finding-retrieval.js","sourceRoot":"","sources":["../src/finding-retrieval.ts"],"names":[],"mappings":"","sourcesContent":["import type { Finding } from \"./models.js\";\n\nexport type FindingSearchScope =\n | { repositoryId: string; allRepositories?: never }\n | { allRepositories: true; repositoryId?: never };\n\nexport interface FindingNeighborhood {\n finding: Finding;\n potentialDuplicates: Finding[];\n}\n"]}
1
+ {"version":3,"file":"finding-retrieval.js","sourceRoot":"","sources":["../src/finding-retrieval.ts"],"names":[],"mappings":"","sourcesContent":["import type { Finding } from \"./models.js\";\n\nexport type FindingSearchScope =\n | { repositoryId: string; allRepositories?: never }\n | { allRepositories: true; repositoryId?: never };\n\nexport interface FindingSourceSnapshot {\n repositoryId: string | null;\n revision: string;\n snapshotDigest: string | null;\n}\n\nexport interface FindingNeighborhood {\n finding: Finding;\n potentialDuplicates: Finding[];\n /** Saved storage associations, separate from model-authored finding content. */\n repositoryIds?: Record<string, string[]>;\n /** Present only when the current body matches its persisted scan occurrence. */\n sourceSnapshots?: Record<string, FindingSourceSnapshot>;\n}\n"]}
@@ -17,11 +17,17 @@ export interface WorkflowState extends WorkflowBinding {
17
17
  status: "pending" | "running" | "failed" | "completed";
18
18
  result?: unknown;
19
19
  error?: string;
20
- pendingWrite?: {
21
- groups: string[][];
22
- };
20
+ pendingWrite?: DedupePendingWrite;
23
21
  }>;
24
22
  }
23
+ export interface DedupePendingWrite {
24
+ groups: string[][];
25
+ local?: {
26
+ inputDigest: string;
27
+ source: JsonObject;
28
+ gitDisabled?: boolean;
29
+ };
30
+ }
25
31
  export declare function workflowDigest(value: unknown): string;
26
32
  export declare function workflowDestination(url: string): string;
27
33
  /** State lives in the workbench database, never in sealed scan artifacts. */
@@ -30,8 +36,9 @@ export declare class FindingWorkflow {
30
36
  private readonly environment;
31
37
  private readonly workbench;
32
38
  private readonly pythonPath?;
39
+ private readonly protectedRoot?;
33
40
  private options?;
34
- constructor(id: string, environment?: NodeJS.ProcessEnv, workbench?: typeof runWorkbench, pythonPath?: string | undefined);
41
+ constructor(id: string, environment?: NodeJS.ProcessEnv, workbench?: typeof runWorkbench, pythonPath?: string | undefined, protectedRoot?: string | undefined);
35
42
  protectArtifacts(scanDir: string): Promise<void>;
36
43
  get(): Promise<WorkflowState | null>;
37
44
  bind(binding: WorkflowBinding): Promise<WorkflowState>;
@@ -40,12 +47,10 @@ export declare class FindingWorkflow {
40
47
  fail(stage: WorkflowStage, error: unknown): Promise<void>;
41
48
  run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T>;
42
49
  registeredScan(scanId: string): Promise<JsonObject>;
43
- sourceSnapshot(repository: string): Promise<JsonObject>;
50
+ sourceSnapshot(repository: string, gitDisabled?: boolean, privateStatePaths?: readonly string[]): Promise<JsonObject>;
44
51
  getReview(key: string): Promise<unknown>;
45
52
  saveReview(key: string, binding: object, result: unknown): Promise<void>;
46
- prepareDedupe(result: unknown, pendingWrite: {
47
- groups: string[][];
48
- }): Promise<void>;
53
+ prepareDedupe(result: unknown, pendingWrite: DedupePendingWrite): Promise<void>;
49
54
  private command;
50
55
  private request;
51
56
  private call;
@@ -1 +1 @@
1
- {"version":3,"file":"finding-workflow.d.ts","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"finding-workflow.d.ts","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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"}
@@ -1,7 +1,8 @@
1
1
  import { createHash } from "node:crypto";
2
2
  import { isAbsolute, relative, sep } from "node:path";
3
- import { CodexSecurityError, safeErrorMessage } from "./errors.js";
4
- import { bundledPluginRoot, canonicalizeModelSafePath, codexSecurityStateDirectory, resolvePluginPython, runWorkbench, } from "./runtime.js";
3
+ import { CodexSecurityError, errorMessage } from "./errors.js";
4
+ import { findingsBaseUrl } from "./findings-client.js";
5
+ import { bundledPluginRoot, canonicalizeModelSafePath, codexSecurityStateDirectory, workbenchEnvironment, resolvePluginPython, runWorkbench, } from "./runtime.js";
5
6
  export function workflowDigest(value) {
6
7
  const json = JSON.stringify(value, (_key, item) => item !== null && typeof item === "object" && !Array.isArray(item)
7
8
  ? Object.fromEntries(Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)))
@@ -9,11 +10,10 @@ export function workflowDigest(value) {
9
10
  return createHash("sha256").update(json).digest("hex");
10
11
  }
11
12
  export function workflowDestination(url) {
12
- const route = "v1/bulk/findings";
13
- const destination = new URL(route, url.endsWith("/") ? url : `${url}/`);
13
+ const destination = findingsBaseUrl(url);
14
14
  destination.username = "";
15
15
  destination.password = "";
16
- return destination.href.slice(0, -route.length);
16
+ return destination.href;
17
17
  }
18
18
  /** State lives in the workbench database, never in sealed scan artifacts. */
19
19
  export class FindingWorkflow {
@@ -21,12 +21,14 @@ export class FindingWorkflow {
21
21
  environment;
22
22
  workbench;
23
23
  pythonPath;
24
+ protectedRoot;
24
25
  options;
25
- constructor(id, environment = process.env, workbench = runWorkbench, pythonPath) {
26
+ constructor(id, environment = process.env, workbench = runWorkbench, pythonPath, protectedRoot) {
26
27
  this.id = id;
27
28
  this.environment = environment;
28
29
  this.workbench = workbench;
29
30
  this.pythonPath = pythonPath;
31
+ this.protectedRoot = protectedRoot;
30
32
  if (!id.trim())
31
33
  throw new CodexSecurityError("workflowId must be a nonempty string.");
32
34
  }
@@ -53,7 +55,7 @@ export class FindingWorkflow {
53
55
  await this.command({
54
56
  action: "fail",
55
57
  stage,
56
- error: safeErrorMessage(error),
58
+ error: errorMessage(error),
57
59
  }).catch(() => undefined);
58
60
  }
59
61
  async run(stage, operation) {
@@ -74,8 +76,13 @@ export class FindingWorkflow {
74
76
  const context = await this.call(["get-scan", "--scan-id", scanId]);
75
77
  return context["scan"];
76
78
  }
77
- async sourceSnapshot(repository) {
78
- return (await this.request({ action: "source", repository }))["source"];
79
+ async sourceSnapshot(repository, gitDisabled = false, privateStatePaths = []) {
80
+ return (await this.request({
81
+ action: "source",
82
+ repository,
83
+ ...(gitDisabled ? { gitDisabled } : {}),
84
+ ...(privateStatePaths.length ? { privateStatePaths } : {}),
85
+ }))["source"];
79
86
  }
80
87
  async getReview(key) {
81
88
  return (await this.request({ action: "get-review", key }))["review"];
@@ -104,11 +111,9 @@ export class FindingWorkflow {
104
111
  python: await resolvePluginPython({
105
112
  environment: this.environment,
106
113
  configuredPath: this.pythonPath,
114
+ protectedRoot: this.protectedRoot,
107
115
  }),
108
- environment: {
109
- ...this.environment,
110
- CODEX_SECURITY_STATE_DIR: codexSecurityStateDirectory(this.environment),
111
- },
116
+ environment: workbenchEnvironment(this.environment),
112
117
  failureMessage: "Could not save or resume the findings workflow",
113
118
  }))();
114
119
  return await this.workbench(await this.options, args, input);
@@ -1 +1 @@
1
- {"version":3,"file":"finding-workflow.js","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnE,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACnB,YAAY,GAEb,MAAM,cAAc,CAAC;AAyBtB,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAa,EAAE,EAAE,CACzD,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAC/D,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACtE;QACH,CAAC,CAAC,IAAI,CACT,CAAC;IACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,KAAK,GAAG,kBAAkB,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IACxE,WAAW,CAAC,QAAQ,GAAG,EAAE,CAAC;IAC1B,WAAW,CAAC,QAAQ,GAAG,EAAE,CAAC;IAC1B,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,6EAA6E;AAC7E,MAAM,OAAO,eAAe;IAIf,EAAE;IACM,WAAW;IACX,SAAS;IACT,UAAU;IANrB,OAAO,CAAoC;IAEnD,YACW,EAAU,EACF,WAAW,GAAsB,OAAO,CAAC,GAAG,EAC5C,SAAS,GAAwB,YAAY,EAC7C,UAAmB;kBAH3B,EAAE;2BACM,WAAW;yBACX,SAAS;0BACT,UAAU;QAE3B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE;YACZ,MAAM,IAAI,kBAAkB,CAAC,uCAAuC,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,MAAM,IAAI,GAAG,QAAQ,CACnB,MAAM,yBAAyB,CAAC,OAAO,CAAC,EACxC,MAAM,yBAAyB,CAC7B,2BAA2B,CAAC,IAAI,CAAC,WAAW,CAAC,CAC9C,CACF,CAAC;QACF,IACE,IAAI,KAAK,EAAE;YACX,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,EACpE,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,2DAA2D,CAC5D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG;QACP,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAyB,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAwB;QACjC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAE,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAoB;QAC9B,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAE,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,KAAoB,EACpB,MAAe;QAEf,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAE,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAoB,EAAE,KAAc;QAC7C,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,MAAM,EAAE,MAAM;YACd,KAAK;YACL,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC;SAC/B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,KAAoB,EAAE,SAA2B;QAC5D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,WAAW;YAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAW,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACnC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QACnE,OAAO,OAAO,CAAC,MAAM,CAAe,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,CAC3D,QAAQ,CACK,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,UAAU,CACd,GAAW,EACX,OAAe,EACf,MAAe;QAEf,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,MAAe,EACf,YAAoC;QAEpC,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,MAAM,EAAE,gBAAgB;YACxB,KAAK,EAAE,QAAQ;YACf,MAAM;YACN,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAAe;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC,UAAU,CAAoC,CAAC;IAC/D,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,OAAe;QACnC,OAAO,MAAM,IAAI,CAAC,IAAI,CACpB,CAAC,kBAAkB,CAAC,EACpB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAC5C,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,IAAuB,EACvB,KAAc;QAEd,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC7B,UAAU,EAAE,MAAM,iBAAiB,EAAE;YACrC,MAAM,EAAE,MAAM,mBAAmB,CAAC;gBAChC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,cAAc,EAAE,IAAI,CAAC,UAAU;aAChC,CAAC;YACF,WAAW,EAAE;gBACX,GAAG,IAAI,CAAC,WAAW;gBACnB,wBAAwB,EAAE,2BAA2B,CAAC,IAAI,CAAC,WAAW,CAAC;aACxE;YACD,cAAc,EAAE,gDAAgD;SACjE,CAAC,CAAC,EAAE,CAAC;QACN,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;CACF","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { isAbsolute, relative, sep } from \"node:path\";\nimport type { JsonObject } from \"./config.js\";\nimport { CodexSecurityError, safeErrorMessage } from \"./errors.js\";\nimport type { FindingSearchScope } from \"./finding-retrieval.js\";\nimport {\n bundledPluginRoot,\n canonicalizeModelSafePath,\n codexSecurityStateDirectory,\n resolvePluginPython,\n runWorkbench,\n type WorkbenchCommandOptions,\n} from \"./runtime.js\";\n\nexport type WorkflowStage = \"scan\" | \"publish\" | \"dedupe\";\nexport interface WorkflowBinding {\n repositoryPath?: string;\n scanRequestDigest?: string;\n scanId?: string;\n scanDir?: string;\n artifactDigest?: string;\n destination?: string;\n scope?: FindingSearchScope;\n}\nexport interface WorkflowState extends WorkflowBinding {\n id: string;\n stages: Record<\n WorkflowStage,\n {\n status: \"pending\" | \"running\" | \"failed\" | \"completed\";\n result?: unknown;\n error?: string;\n pendingWrite?: { groups: string[][] };\n }\n >;\n}\n\nexport function workflowDigest(value: unknown): string {\n const json = JSON.stringify(value, (_key, item: unknown) =>\n item !== null && typeof item === \"object\" && !Array.isArray(item)\n ? Object.fromEntries(\n Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n )\n : item,\n );\n return createHash(\"sha256\").update(json).digest(\"hex\");\n}\n\nexport function workflowDestination(url: string): string {\n const route = \"v1/bulk/findings\";\n const destination = new URL(route, url.endsWith(\"/\") ? url : `${url}/`);\n destination.username = \"\";\n destination.password = \"\";\n return destination.href.slice(0, -route.length);\n}\n\n/** State lives in the workbench database, never in sealed scan artifacts. */\nexport class FindingWorkflow {\n private options?: Promise<WorkbenchCommandOptions>;\n\n constructor(\n readonly id: string,\n private readonly environment: NodeJS.ProcessEnv = process.env,\n private readonly workbench: typeof runWorkbench = runWorkbench,\n private readonly pythonPath?: string,\n ) {\n if (!id.trim())\n throw new CodexSecurityError(\"workflowId must be a nonempty string.\");\n }\n\n async protectArtifacts(scanDir: string): Promise<void> {\n const path = relative(\n await canonicalizeModelSafePath(scanDir),\n await canonicalizeModelSafePath(\n codexSecurityStateDirectory(this.environment),\n ),\n );\n if (\n path === \"\" ||\n (!isAbsolute(path) && path !== \"..\" && !path.startsWith(`..${sep}`))\n ) {\n throw new CodexSecurityError(\n \"Workflow state must be outside the sealed scan artifacts.\",\n );\n }\n }\n\n async get(): Promise<WorkflowState | null> {\n return (await this.command({ action: \"get\" })) as WorkflowState | null;\n }\n\n async bind(binding: WorkflowBinding): Promise<WorkflowState> {\n return (await this.command({ action: \"bind\", binding }))!;\n }\n\n async begin(stage: WorkflowStage): Promise<WorkflowState> {\n return (await this.command({ action: \"begin\", stage }))!;\n }\n\n async complete(\n stage: WorkflowStage,\n result: unknown,\n ): Promise<WorkflowState> {\n return (await this.command({ action: \"complete\", stage, result }))!;\n }\n\n async fail(stage: WorkflowStage, error: unknown): Promise<void> {\n await this.command({\n action: \"fail\",\n stage,\n error: safeErrorMessage(error),\n }).catch(() => undefined);\n }\n\n async run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T> {\n const state = await this.begin(stage);\n if (state.stages[stage].status === \"completed\")\n return state.stages[stage].result as T;\n try {\n const result = await operation();\n await this.complete(stage, result);\n return result;\n } catch (error) {\n await this.fail(stage, error);\n throw error;\n }\n }\n\n async registeredScan(scanId: string): Promise<JsonObject> {\n const context = await this.call([\"get-scan\", \"--scan-id\", scanId]);\n return context[\"scan\"] as JsonObject;\n }\n\n async sourceSnapshot(repository: string): Promise<JsonObject> {\n return (await this.request({ action: \"source\", repository }))[\n \"source\"\n ] as JsonObject;\n }\n\n async getReview(key: string): Promise<unknown> {\n return (await this.request({ action: \"get-review\", key }))[\"review\"];\n }\n\n async saveReview(\n key: string,\n binding: object,\n result: unknown,\n ): Promise<void> {\n await this.request({ action: \"save-review\", key, binding, result });\n }\n\n async prepareDedupe(\n result: unknown,\n pendingWrite: { groups: string[][] },\n ): Promise<void> {\n await this.command({\n action: \"prepare-dedupe\",\n stage: \"dedupe\",\n result,\n pendingWrite,\n });\n }\n\n private async command(payload: object): Promise<WorkflowState | null> {\n const result = await this.request(payload);\n return result[\"workflow\"] as unknown as WorkflowState | null;\n }\n\n private async request(payload: object): Promise<JsonObject> {\n return await this.call(\n [\"finding-workflow\"],\n JSON.stringify({ id: this.id, ...payload }),\n );\n }\n\n private async call(\n args: readonly string[],\n input?: string,\n ): Promise<JsonObject> {\n this.options ??= (async () => ({\n pluginRoot: await bundledPluginRoot(),\n python: await resolvePluginPython({\n environment: this.environment,\n configuredPath: this.pythonPath,\n }),\n environment: {\n ...this.environment,\n CODEX_SECURITY_STATE_DIR: codexSecurityStateDirectory(this.environment),\n },\n failureMessage: \"Could not save or resume the findings workflow\",\n }))();\n return await this.workbench(await this.options, args, input);\n }\n}\n"]}
1
+ {"version":3,"file":"finding-workflow.js","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { isAbsolute, relative, sep } from \"node:path\";\nimport type { JsonObject } from \"./config.js\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { findingsBaseUrl } from \"./findings-client.js\";\nimport type { FindingSearchScope } from \"./finding-retrieval.js\";\nimport {\n bundledPluginRoot,\n canonicalizeModelSafePath,\n codexSecurityStateDirectory,\n workbenchEnvironment,\n resolvePluginPython,\n runWorkbench,\n type WorkbenchCommandOptions,\n} from \"./runtime.js\";\n\nexport type WorkflowStage = \"scan\" | \"publish\" | \"dedupe\";\nexport interface WorkflowBinding {\n repositoryPath?: string;\n scanRequestDigest?: string;\n scanId?: string;\n scanDir?: string;\n artifactDigest?: string;\n destination?: string;\n scope?: FindingSearchScope;\n}\nexport interface WorkflowState extends WorkflowBinding {\n id: string;\n stages: Record<\n WorkflowStage,\n {\n status: \"pending\" | \"running\" | \"failed\" | \"completed\";\n result?: unknown;\n error?: string;\n pendingWrite?: DedupePendingWrite;\n }\n >;\n}\n\nexport interface DedupePendingWrite {\n groups: string[][];\n local?: { inputDigest: string; source: JsonObject; gitDisabled?: boolean };\n}\n\nexport function workflowDigest(value: unknown): string {\n const json = JSON.stringify(value, (_key, item: unknown) =>\n item !== null && typeof item === \"object\" && !Array.isArray(item)\n ? Object.fromEntries(\n Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n )\n : item,\n );\n return createHash(\"sha256\").update(json).digest(\"hex\");\n}\n\nexport function workflowDestination(url: string): string {\n const destination = findingsBaseUrl(url);\n destination.username = \"\";\n destination.password = \"\";\n return destination.href;\n}\n\n/** State lives in the workbench database, never in sealed scan artifacts. */\nexport class FindingWorkflow {\n private options?: Promise<WorkbenchCommandOptions>;\n\n constructor(\n readonly id: string,\n private readonly environment: NodeJS.ProcessEnv = process.env,\n private readonly workbench: typeof runWorkbench = runWorkbench,\n private readonly pythonPath?: string,\n private readonly protectedRoot?: string,\n ) {\n if (!id.trim())\n throw new CodexSecurityError(\"workflowId must be a nonempty string.\");\n }\n\n async protectArtifacts(scanDir: string): Promise<void> {\n const path = relative(\n await canonicalizeModelSafePath(scanDir),\n await canonicalizeModelSafePath(\n codexSecurityStateDirectory(this.environment),\n ),\n );\n if (\n path === \"\" ||\n (!isAbsolute(path) && path !== \"..\" && !path.startsWith(`..${sep}`))\n ) {\n throw new CodexSecurityError(\n \"Workflow state must be outside the sealed scan artifacts.\",\n );\n }\n }\n\n async get(): Promise<WorkflowState | null> {\n return (await this.command({ action: \"get\" })) as WorkflowState | null;\n }\n\n async bind(binding: WorkflowBinding): Promise<WorkflowState> {\n return (await this.command({ action: \"bind\", binding }))!;\n }\n\n async begin(stage: WorkflowStage): Promise<WorkflowState> {\n return (await this.command({ action: \"begin\", stage }))!;\n }\n\n async complete(\n stage: WorkflowStage,\n result: unknown,\n ): Promise<WorkflowState> {\n return (await this.command({ action: \"complete\", stage, result }))!;\n }\n\n async fail(stage: WorkflowStage, error: unknown): Promise<void> {\n await this.command({\n action: \"fail\",\n stage,\n error: errorMessage(error),\n }).catch(() => undefined);\n }\n\n async run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T> {\n const state = await this.begin(stage);\n if (state.stages[stage].status === \"completed\")\n return state.stages[stage].result as T;\n try {\n const result = await operation();\n await this.complete(stage, result);\n return result;\n } catch (error) {\n await this.fail(stage, error);\n throw error;\n }\n }\n\n async registeredScan(scanId: string): Promise<JsonObject> {\n const context = await this.call([\"get-scan\", \"--scan-id\", scanId]);\n return context[\"scan\"] as JsonObject;\n }\n\n async sourceSnapshot(\n repository: string,\n gitDisabled = false,\n privateStatePaths: readonly string[] = [],\n ): Promise<JsonObject> {\n return (\n await this.request({\n action: \"source\",\n repository,\n ...(gitDisabled ? { gitDisabled } : {}),\n ...(privateStatePaths.length ? { privateStatePaths } : {}),\n })\n )[\"source\"] as JsonObject;\n }\n\n async getReview(key: string): Promise<unknown> {\n return (await this.request({ action: \"get-review\", key }))[\"review\"];\n }\n\n async saveReview(\n key: string,\n binding: object,\n result: unknown,\n ): Promise<void> {\n await this.request({ action: \"save-review\", key, binding, result });\n }\n\n async prepareDedupe(\n result: unknown,\n pendingWrite: DedupePendingWrite,\n ): Promise<void> {\n await this.command({\n action: \"prepare-dedupe\",\n stage: \"dedupe\",\n result,\n pendingWrite,\n });\n }\n\n private async command(payload: object): Promise<WorkflowState | null> {\n const result = await this.request(payload);\n return result[\"workflow\"] as unknown as WorkflowState | null;\n }\n\n private async request(payload: object): Promise<JsonObject> {\n return await this.call(\n [\"finding-workflow\"],\n JSON.stringify({ id: this.id, ...payload }),\n );\n }\n\n private async call(\n args: readonly string[],\n input?: string,\n ): Promise<JsonObject> {\n this.options ??= (async () => ({\n pluginRoot: await bundledPluginRoot(),\n python: await resolvePluginPython({\n environment: this.environment,\n configuredPath: this.pythonPath,\n protectedRoot: this.protectedRoot,\n }),\n environment: workbenchEnvironment(this.environment),\n failureMessage: \"Could not save or resume the findings workflow\",\n }))();\n return await this.workbench(await this.options, args, input);\n }\n}\n"]}
@@ -2,11 +2,12 @@ import { waitForRetry } from "./deduplication/retry.js";
2
2
  import type { Finding } from "./models.js";
3
3
  import type { FindingNeighborhood, FindingSearchScope } from "./finding-retrieval.js";
4
4
  export type FindingsRequest = (url: URL, init: RequestInit) => Promise<Response>;
5
+ export declare function findingsBaseUrl(value: string): URL;
5
6
  export declare class FindingsClient {
6
- private readonly url;
7
7
  private readonly signal?;
8
8
  private readonly request;
9
9
  private readonly retries;
10
+ private readonly url;
10
11
  constructor(url: string, signal?: AbortSignal | undefined, request?: FindingsRequest, retries?: {
11
12
  wait?: typeof waitForRetry;
12
13
  random?: () => number;
@@ -1 +1 @@
1
- {"version":3,"file":"findings-client.d.ts","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AAmBvB,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,YACmB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,YAAA,EACpB,OAAO,GAAE,eAAuB,EAChC,OAAO,GAAE;QACxB,IAAI,CAAC,EAAE,OAAO,YAAY,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;KAClB,EACJ;IAEE,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAuB9B;IAEK,OAAO,CACX,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;IAEK,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;YAEa,KAAK;IAsBnB,OAAO,CAAC,QAAQ;YAIF,IAAI;CAiBnB"}
1
+ {"version":3,"file":"findings-client.d.ts","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AA+CvB,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAMlD;AAED,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,YACE,GAAG,EAAE,MAAM,EACM,MAAM,CAAC,EAAE,WAAW,YAAA,EACpB,OAAO,GAAE,eAAuB,EAChC,OAAO,GAAE;QACxB,IAAI,CAAC,EAAE,OAAO,YAAY,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;KAClB,EAGP;IAEK,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAsB9B;IAEK,OAAO,CACX,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;IAEK,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;YAEa,KAAK;IAsBnB,OAAO,CAAC,QAAQ;YAIF,IAAI;CAgBnB"}