@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.
- package/README.md +192 -151
- package/_bundled_plugin/.mcp.json +5 -1
- package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
- package/_bundled_plugin/examples/completed-scan/report.md +11 -8
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
- package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
- package/_bundled_plugin/mcp/helpers.mjs +2 -11
- package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
- package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
- package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
- package/_bundled_plugin/mcp/package.json +1 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
- package/_bundled_plugin/mcp/server.mjs +2 -11
- package/_bundled_plugin/mcp/server.mjs.br +0 -0
- package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
- package/_bundled_plugin/references/default-severity-rubric.md +9 -4
- package/_bundled_plugin/references/final-report.md +5 -3
- package/_bundled_plugin/references/finding-detail-fields.md +18 -18
- package/_bundled_plugin/references/sarif-adapter.md +8 -2
- package/_bundled_plugin/references/scan-artifacts.md +21 -12
- package/_bundled_plugin/references/scan-contract.md +27 -33
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
- package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
- package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
- package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
- package/_bundled_plugin/scripts/deep_scan_workbench.py +165 -342
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +153 -227
- package/_bundled_plugin/scripts/finding_preview.py +20 -0
- package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
- package/_bundled_plugin/scripts/legacy_findings.py +148 -0
- package/_bundled_plugin/scripts/posix_scan_local_files.py +11 -0
- package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
- package/_bundled_plugin/scripts/report_projection.py +81 -43
- package/_bundled_plugin/scripts/review_state.py +8 -2
- package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
- package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
- package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
- package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
- package/_bundled_plugin/scripts/windows_scan_local_files.py +388 -17
- package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
- package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
- package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
- package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
- package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
- package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
- package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
- package/_bundled_plugin/scripts/workbench/storage.py +71 -7
- package/_bundled_plugin/scripts/workbench_cli.py +30 -12
- package/_bundled_plugin/scripts/workbench_constants.py +10 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
- package/_bundled_plugin/scripts/workbench_db.py +369 -137
- package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
- package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
- package/_bundled_plugin/scripts/workbench_native_indexes.py +12 -12
- package/_bundled_plugin/scripts/workbench_progress.py +10 -1
- package/_bundled_plugin/scripts/workbench_publication.py +14 -10
- package/_bundled_plugin/scripts/workbench_remediation.py +13 -0
- package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
- package/_bundled_plugin/scripts/workbench_scan_history.py +117 -55
- package/_bundled_plugin/scripts/workbench_scan_start.py +83 -24
- package/_bundled_plugin/scripts/workbench_scan_usage.py +644 -68
- package/_bundled_plugin/scripts/workbench_schema.py +44 -55
- package/_bundled_plugin/scripts/workbench_setup.py +13 -1
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
- package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
- package/_bundled_plugin/scripts/workbench_target.py +127 -56
- package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
- package/_bundled_plugin/scripts/workbench_validation.py +43 -3
- package/_bundled_plugin/shared/workbench-history-repairs.json +19 -23
- package/_bundled_plugin/shared/workbench-migrations.json +34 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
- package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -1
- package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -25
- package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
- package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
- package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
- package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
- package/dist/api.d.ts +39 -4
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +774 -292
- package/dist/api.js.map +1 -1
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +4 -6
- package/dist/auth.js.map +1 -1
- package/dist/bedrock-oss-pricing.d.ts +6 -0
- package/dist/bedrock-oss-pricing.d.ts.map +1 -0
- package/dist/bedrock-oss-pricing.js +58 -0
- package/dist/bedrock-oss-pricing.js.map +1 -0
- package/dist/bedrock-pricing.d.ts +15 -0
- package/dist/bedrock-pricing.d.ts.map +1 -0
- package/dist/bedrock-pricing.js +117 -0
- package/dist/bedrock-pricing.js.map +1 -0
- package/dist/blackduck-findings.d.ts.map +1 -1
- package/dist/blackduck-findings.js +35 -20
- package/dist/blackduck-findings.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +4 -4
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/checkmarx-evidence.d.ts +19 -0
- package/dist/checkmarx-evidence.d.ts.map +1 -0
- package/dist/checkmarx-evidence.js +36 -0
- package/dist/checkmarx-evidence.js.map +1 -0
- package/dist/checkmarx-findings.d.ts +4 -0
- package/dist/checkmarx-findings.d.ts.map +1 -0
- package/dist/checkmarx-findings.js +27 -0
- package/dist/checkmarx-findings.js.map +1 -0
- package/dist/checkmarx-one.d.ts +4 -0
- package/dist/checkmarx-one.d.ts.map +1 -0
- package/dist/checkmarx-one.js +53 -0
- package/dist/checkmarx-one.js.map +1 -0
- package/dist/checkmarx-repository.d.ts +12 -0
- package/dist/checkmarx-repository.d.ts.map +1 -0
- package/dist/checkmarx-repository.js +181 -0
- package/dist/checkmarx-repository.js.map +1 -0
- package/dist/checkmarx-xml.d.ts +12 -0
- package/dist/checkmarx-xml.d.ts.map +1 -0
- package/dist/checkmarx-xml.js +196 -0
- package/dist/checkmarx-xml.js.map +1 -0
- package/dist/classify-severity-records.d.ts +1 -9
- package/dist/classify-severity-records.d.ts.map +1 -1
- package/dist/classify-severity-records.js +3 -13
- package/dist/classify-severity-records.js.map +1 -1
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +2 -4
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli.d.ts +11 -5
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1734 -1238
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.js +2 -2
- package/dist/cloud-publish.js.map +1 -1
- package/dist/component-scan.d.ts +16 -3
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +27 -2
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +100 -66
- package/dist/config.js.map +1 -1
- package/dist/continuum-findings.d.ts.map +1 -1
- package/dist/continuum-findings.js +80 -12
- package/dist/continuum-findings.js.map +1 -1
- package/dist/contract-values.d.ts +2 -0
- package/dist/contract-values.d.ts.map +1 -1
- package/dist/contract-values.js +12 -9
- package/dist/contract-values.js.map +1 -1
- package/dist/cost-model.d.ts +13 -1
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +66 -112
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +42 -3
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +483 -104
- package/dist/cost.js.map +1 -1
- package/dist/custom-publish.d.ts +4 -0
- package/dist/custom-publish.d.ts.map +1 -1
- package/dist/custom-publish.js +40 -3
- package/dist/custom-publish.js.map +1 -1
- package/dist/deduplication/local.d.ts +2 -2
- package/dist/deduplication/local.d.ts.map +1 -1
- package/dist/deduplication/local.js +2 -2
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/refusal.d.ts.map +1 -1
- package/dist/deduplication/refusal.js +25 -5
- package/dist/deduplication/refusal.js.map +1 -1
- package/dist/deduplication/scan.d.ts +3 -0
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +1 -1
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +0 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +22 -33
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-scan-defaults.d.ts +2 -0
- package/dist/deep-scan-defaults.d.ts.map +1 -1
- package/dist/deep-scan-defaults.js +28 -1
- package/dist/deep-scan-defaults.js.map +1 -1
- package/dist/deep-scan.d.ts +2 -0
- package/dist/deep-scan.d.ts.map +1 -1
- package/dist/deep-scan.js +28 -4
- package/dist/deep-scan.js.map +1 -1
- package/dist/default-severity-rubric.d.ts +1 -1
- package/dist/default-severity-rubric.d.ts.map +1 -1
- package/dist/default-severity-rubric.js +1 -1
- package/dist/default-severity-rubric.js.map +1 -1
- package/dist/endor-findings.d.ts +3 -1
- package/dist/endor-findings.d.ts.map +1 -1
- package/dist/endor-findings.js +103 -45
- package/dist/endor-findings.js.map +1 -1
- package/dist/errors.d.ts +1 -1
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +8 -1
- package/dist/errors.js.map +1 -1
- package/dist/external-findings-import.d.ts +5 -3
- package/dist/external-findings-import.d.ts.map +1 -1
- package/dist/external-findings-import.js +7 -6
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +7 -5
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +337 -89
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +8 -6
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +1318 -258
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +20 -2
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +148 -66
- package/dist/external-findings-read.js.map +1 -1
- package/dist/external-findings.d.ts +15 -3
- package/dist/external-findings.d.ts.map +1 -1
- package/dist/external-findings.js +42 -1
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +5 -1
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +23 -9
- package/dist/external-import-contract.js.map +1 -1
- package/dist/external-import-models.d.ts +1 -1
- package/dist/external-import-models.d.ts.map +1 -1
- package/dist/external-import-models.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +5 -4
- package/dist/feedback.js.map +1 -1
- package/dist/finding-prompt.d.ts +5 -0
- package/dist/finding-prompt.d.ts.map +1 -0
- package/dist/finding-prompt.js +32 -0
- package/dist/finding-prompt.js.map +1 -0
- package/dist/findings-client.d.ts +1 -0
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +27 -3
- package/dist/findings-client.js.map +1 -1
- package/dist/github-advisories.d.ts.map +1 -1
- package/dist/github-advisories.js +0 -2
- package/dist/github-advisories.js.map +1 -1
- package/dist/github-dependabot-findings.d.ts.map +1 -1
- package/dist/github-dependabot-findings.js +15 -4
- package/dist/github-dependabot-findings.js.map +1 -1
- package/dist/github-findings.d.ts +4 -1
- package/dist/github-findings.d.ts.map +1 -1
- package/dist/github-findings.js +55 -30
- package/dist/github-findings.js.map +1 -1
- package/dist/hosted-git-remotes.d.ts +5 -0
- package/dist/hosted-git-remotes.d.ts.map +1 -0
- package/dist/hosted-git-remotes.js +285 -0
- package/dist/hosted-git-remotes.js.map +1 -0
- package/dist/hosted-git-repository.d.ts +28 -0
- package/dist/hosted-git-repository.d.ts.map +1 -0
- package/dist/hosted-git-repository.js +222 -0
- package/dist/hosted-git-repository.js.map +1 -0
- package/dist/hosted-scan-protocol.js +2 -2
- package/dist/hosted-scan-protocol.js.map +1 -1
- package/dist/hosted-scan.d.ts.map +1 -1
- package/dist/hosted-scan.js +16 -11
- package/dist/hosted-scan.js.map +1 -1
- package/dist/hosted-scanner-http.d.ts +21 -0
- package/dist/hosted-scanner-http.d.ts.map +1 -0
- package/dist/hosted-scanner-http.js +204 -0
- package/dist/hosted-scanner-http.js.map +1 -0
- package/dist/hosted-scanner-v1.d.ts +6 -0
- package/dist/hosted-scanner-v1.d.ts.map +1 -0
- package/dist/hosted-scanner-v1.js +60 -0
- package/dist/hosted-scanner-v1.js.map +1 -0
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +3 -0
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +18 -7
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -2
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +47 -65
- package/dist/inspector-findings.js.map +1 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +68 -5
- package/dist/knowledge-base.js.map +1 -1
- package/dist/local-git-metadata.d.ts +1 -1
- package/dist/local-git-metadata.d.ts.map +1 -1
- package/dist/local-git-metadata.js +1 -2
- package/dist/local-git-metadata.js.map +1 -1
- package/dist/multiscan.d.ts +6 -4
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +138 -65
- package/dist/multiscan.js.map +1 -1
- package/dist/native-json-findings.d.ts +2 -1
- package/dist/native-json-findings.d.ts.map +1 -1
- package/dist/native-json-findings.js +12 -2
- package/dist/native-json-findings.js.map +1 -1
- package/dist/opengrep-findings.d.ts +1 -0
- package/dist/opengrep-findings.d.ts.map +1 -1
- package/dist/opengrep-findings.js +17 -13
- package/dist/opengrep-findings.js.map +1 -1
- package/dist/operation-telemetry.d.ts +104 -0
- package/dist/operation-telemetry.d.ts.map +1 -0
- package/dist/operation-telemetry.js +293 -0
- package/dist/operation-telemetry.js.map +1 -0
- package/dist/plugin-python-probe.d.ts +4 -0
- package/dist/plugin-python-probe.d.ts.map +1 -0
- package/dist/plugin-python-probe.js +10 -0
- package/dist/plugin-python-probe.js.map +1 -0
- package/dist/private-finding-import.d.ts +97 -2
- package/dist/private-finding-import.d.ts.map +1 -1
- package/dist/private-finding-import.js +58 -34
- package/dist/private-finding-import.js.map +1 -1
- package/dist/provider-profile.d.ts +1 -1
- package/dist/provider-profile.d.ts.map +1 -1
- package/dist/provider-profile.js +8 -1
- package/dist/provider-profile.js.map +1 -1
- package/dist/publication-telemetry.d.ts +45 -0
- package/dist/publication-telemetry.d.ts.map +1 -0
- package/dist/publication-telemetry.js +50 -0
- package/dist/publication-telemetry.js.map +1 -0
- package/dist/publish.d.ts +4 -0
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +42 -2
- package/dist/publish.js.map +1 -1
- package/dist/reader-selection.d.ts +2 -0
- package/dist/reader-selection.d.ts.map +1 -1
- package/dist/reader-selection.js +8 -0
- package/dist/reader-selection.js.map +1 -1
- package/dist/remediation.d.ts +1 -4
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +3 -7
- package/dist/remediation.js.map +1 -1
- package/dist/request-metadata.d.ts +3 -0
- package/dist/request-metadata.d.ts.map +1 -1
- package/dist/request-metadata.js +9 -0
- package/dist/request-metadata.js.map +1 -1
- package/dist/result.d.ts +4 -0
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +1 -1
- package/dist/result.js.map +1 -1
- package/dist/retry-windows-rename.d.ts +8 -0
- package/dist/retry-windows-rename.d.ts.map +1 -0
- package/dist/retry-windows-rename.js +24 -0
- package/dist/retry-windows-rename.js.map +1 -0
- package/dist/runtime.d.ts +20 -0
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +313 -110
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +1 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -1
- package/dist/saved-scan-bootstrap.js +18 -15
- package/dist/saved-scan-bootstrap.js.map +1 -1
- package/dist/scan-activity.d.ts.map +1 -1
- package/dist/scan-activity.js +141 -56
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +10 -5
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +60 -15
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +6 -6
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +75 -42
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts +10 -1
- package/dist/scan-executor.d.ts.map +1 -1
- package/dist/scan-executor.js +22 -2
- package/dist/scan-executor.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +9 -19
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-logs.d.ts +12 -0
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +106 -77
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-measurement.d.ts +26 -0
- package/dist/scan-measurement.d.ts.map +1 -0
- package/dist/scan-measurement.js +77 -0
- package/dist/scan-measurement.js.map +1 -0
- package/dist/scan-progress.d.ts +1 -0
- package/dist/scan-progress.d.ts.map +1 -1
- package/dist/scan-progress.js +3 -0
- package/dist/scan-progress.js.map +1 -1
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +4 -1
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-settings.d.ts +1 -1
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +1 -24
- package/dist/scan-settings.js.map +1 -1
- package/dist/scanner-import.d.ts +20 -2
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +200 -8
- package/dist/scanner-import.js.map +1 -1
- package/dist/scanner-repository-url.d.ts +4 -1
- package/dist/scanner-repository-url.d.ts.map +1 -1
- package/dist/scanner-repository-url.js +10 -6
- package/dist/scanner-repository-url.js.map +1 -1
- package/dist/security-policy.d.ts +1 -1
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js.map +1 -1
- package/dist/semgrep-findings.d.ts +6 -3
- package/dist/semgrep-findings.d.ts.map +1 -1
- package/dist/semgrep-findings.js +107 -43
- package/dist/semgrep-findings.js.map +1 -1
- package/dist/semgrep-guardian-findings.d.ts +38 -0
- package/dist/semgrep-guardian-findings.d.ts.map +1 -0
- package/dist/semgrep-guardian-findings.js +165 -0
- package/dist/semgrep-guardian-findings.js.map +1 -0
- package/dist/semgrep-platform-collector.d.ts +26 -0
- package/dist/semgrep-platform-collector.d.ts.map +1 -0
- package/dist/semgrep-platform-collector.js +108 -0
- package/dist/semgrep-platform-collector.js.map +1 -0
- package/dist/semgrep-platform-findings.d.ts +207 -6
- package/dist/semgrep-platform-findings.d.ts.map +1 -1
- package/dist/semgrep-platform-findings.js +983 -103
- package/dist/semgrep-platform-findings.js.map +1 -1
- package/dist/semgrep-platform-v1.d.ts +6 -0
- package/dist/semgrep-platform-v1.d.ts.map +1 -0
- package/dist/semgrep-platform-v1.js +83 -0
- package/dist/semgrep-platform-v1.js.map +1 -0
- package/dist/server/api.d.ts +1 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embedding-tokenizer.cdx.json +33 -0
- package/dist/server/embedding-tokenizer.d.ts +2 -0
- package/dist/server/embedding-tokenizer.d.ts.map +1 -0
- package/dist/server/embedding-tokenizer.js +322 -0
- package/dist/server/embedding-tokenizer.js.map +6 -0
- package/dist/server/embeddings.d.ts +16 -2
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +35 -5
- package/dist/server/embeddings.js.map +1 -1
- package/dist/session-lines.d.ts +5 -0
- package/dist/session-lines.d.ts.map +1 -0
- package/dist/session-lines.js +60 -0
- package/dist/session-lines.js.map +1 -0
- package/dist/severity-review.d.ts +3 -1
- package/dist/severity-review.d.ts.map +1 -1
- package/dist/severity-review.js +3 -2
- package/dist/severity-review.js.map +1 -1
- package/dist/skill-authentication.d.ts +1 -0
- package/dist/skill-authentication.d.ts.map +1 -1
- package/dist/skill-authentication.js +1 -0
- package/dist/skill-authentication.js.map +1 -1
- package/dist/snyk-findings.d.ts +7 -2
- package/dist/snyk-findings.d.ts.map +1 -1
- package/dist/snyk-findings.js +93 -70
- package/dist/snyk-findings.js.map +1 -1
- package/dist/snyk-rest-findings.d.ts +76 -0
- package/dist/snyk-rest-findings.d.ts.map +1 -0
- package/dist/snyk-rest-findings.js +1051 -0
- package/dist/snyk-rest-findings.js.map +1 -0
- package/dist/snyk-rest-v1.d.ts +28 -0
- package/dist/snyk-rest-v1.d.ts.map +1 -0
- package/dist/snyk-rest-v1.js +132 -0
- package/dist/snyk-rest-v1.js.map +1 -0
- package/dist/snyk-token-origin.d.ts +4 -0
- package/dist/snyk-token-origin.d.ts.map +1 -0
- package/dist/snyk-token-origin.js +82 -0
- package/dist/snyk-token-origin.js.map +1 -0
- package/dist/sonar-collector.d.ts.map +1 -1
- package/dist/sonar-collector.js +0 -3
- package/dist/sonar-collector.js.map +1 -1
- package/dist/sonar-import.d.ts.map +1 -1
- package/dist/sonar-import.js +2 -4
- package/dist/sonar-import.js.map +1 -1
- package/dist/target-drift.d.ts +9 -0
- package/dist/target-drift.d.ts.map +1 -0
- package/dist/target-drift.js +27 -0
- package/dist/target-drift.js.map +1 -0
- package/dist/targets.d.ts +2 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +56 -20
- package/dist/targets.js.map +1 -1
- package/dist/tenable-findings.d.ts +9 -0
- package/dist/tenable-findings.d.ts.map +1 -0
- package/dist/tenable-findings.js +122 -0
- package/dist/tenable-findings.js.map +1 -0
- package/dist/terminal-stream.d.ts +13 -0
- package/dist/terminal-stream.d.ts.map +1 -0
- package/dist/terminal-stream.js +35 -0
- package/dist/terminal-stream.js.map +1 -0
- package/dist/trivy-findings.d.ts +19 -0
- package/dist/trivy-findings.d.ts.map +1 -0
- package/dist/trivy-findings.js +435 -0
- package/dist/trivy-findings.js.map +1 -0
- package/dist/trivy-import.d.ts +19 -0
- package/dist/trivy-import.d.ts.map +1 -0
- package/dist/trivy-import.js +151 -0
- package/dist/trivy-import.js.map +1 -0
- package/dist/validation-records.js +1 -1
- package/dist/validation-records.js.map +1 -1
- package/dist/veracode-findings.d.ts +2 -0
- package/dist/veracode-findings.d.ts.map +1 -1
- package/dist/veracode-findings.js +49 -11
- package/dist/veracode-findings.js.map +1 -1
- package/dist/vertex-pricing.d.ts +8 -0
- package/dist/vertex-pricing.d.ts.map +1 -0
- package/dist/vertex-pricing.js +20 -0
- package/dist/vertex-pricing.js.map +1 -0
- package/dist/windows-path.d.ts +1 -0
- package/dist/windows-path.d.ts.map +1 -1
- package/dist/windows-path.js +26 -1
- package/dist/windows-path.js.map +1 -1
- package/dist/wiz-findings.d.ts +4 -0
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +57 -3
- package/dist/wiz-findings.js.map +1 -1
- package/docs/classify-severity-records.md +27 -12
- package/docs/cli.md +497 -550
- package/docs/dedupe-records.md +44 -24
- package/docs/findings-service.md +66 -39
- package/docs/hosted-remediation.md +14 -7
- package/docs/hosted-scans.md +50 -42
- package/docs/telemetry.md +236 -0
- package/docs/validate-records.md +78 -44
- package/package.json +18 -15
- package/schemas/external-findings.schema.json +3 -1
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
- package/dist/external-imports-feature.d.ts +0 -6
- package/dist/external-imports-feature.d.ts.map +0 -1
- package/dist/external-imports-feature.js +0 -51
- package/dist/external-imports-feature.js.map +0 -1
- package/dist/finding-normalization.d.ts +0 -5
- package/dist/finding-normalization.d.ts.map +0 -1
- package/dist/finding-normalization.js +0 -155
- package/dist/finding-normalization.js.map +0 -1
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
import { isRecord } from "./record.js";
|
|
2
|
+
import { requiredText, text } from "./scanner-import.js";
|
|
3
|
+
import { checkmarxOneId } from "./checkmarx-one.js";
|
|
4
|
+
import { checkmarxResultViewer, checkmarxXmlId, checkmarxXmlInstance, checkmarxXmlScope, } from "./checkmarx-xml.js";
|
|
5
|
+
import { declaredScannerRepositoryUrl, repositoryScopeValidator, } from "./scanner-repository-url.js";
|
|
6
|
+
const nativeId = /^checkmarx-(?:one|cxsast):[a-f0-9]{64}$/u;
|
|
7
|
+
function checkmarxFormat(value) {
|
|
8
|
+
return value === "cxsast-xml" || value === "checkmarx-one-json";
|
|
9
|
+
}
|
|
10
|
+
function scanKey(value, xml) {
|
|
11
|
+
const uuid = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/iu;
|
|
12
|
+
return !xml && typeof value === "string" && uuid.test(value)
|
|
13
|
+
? value.toLowerCase()
|
|
14
|
+
: value;
|
|
15
|
+
}
|
|
16
|
+
/** A native payload can verify its occurrence ID. A projection can still identify its source. */
|
|
17
|
+
function checkmarxSource({ source_finding_id: id, evidence }, provider) {
|
|
18
|
+
const data = evidence.source_data;
|
|
19
|
+
const format = data?.["format"];
|
|
20
|
+
if (checkmarxFormat(format))
|
|
21
|
+
return format;
|
|
22
|
+
const scanner = evidence.details?.scanner_origin;
|
|
23
|
+
const projected = nativeId.test(id) ||
|
|
24
|
+
scanner === "CxSAST" ||
|
|
25
|
+
scanner === "Checkmarx One SAST" ||
|
|
26
|
+
Boolean(checkmarxResultViewer(data));
|
|
27
|
+
if (data &&
|
|
28
|
+
(provider === "checkmarx" || projected || "sourceRepositoryUrl" in data)) {
|
|
29
|
+
const row = data["row"];
|
|
30
|
+
if (isRecord(row) && row["type"] === "sast" && "similarityId" in row)
|
|
31
|
+
return "checkmarx-one-json";
|
|
32
|
+
const path = data["path"];
|
|
33
|
+
if ("projectId" in data && isRecord(path) && "SimilarityId" in path)
|
|
34
|
+
return "cxsast-xml";
|
|
35
|
+
}
|
|
36
|
+
if (projected)
|
|
37
|
+
return "projection";
|
|
38
|
+
}
|
|
39
|
+
const mismatch = "Checkmarx finding does not match the retained report format, scan or project.";
|
|
40
|
+
/** Compare the claims present across the whole batch, including projected SDK rows. */
|
|
41
|
+
function checkBatchScope(findings, formats, report) {
|
|
42
|
+
const claims = new Map();
|
|
43
|
+
function claim(key, value) {
|
|
44
|
+
if (value == null)
|
|
45
|
+
return;
|
|
46
|
+
if (claims.has(key) && claims.get(key) !== value)
|
|
47
|
+
throw new Error(report
|
|
48
|
+
? mismatch
|
|
49
|
+
: "Checkmarx occurrences must belong to the same product, project and scan.");
|
|
50
|
+
claims.set(key, value);
|
|
51
|
+
}
|
|
52
|
+
for (const format of [report?.["format"], ...formats])
|
|
53
|
+
if (checkmarxFormat(format))
|
|
54
|
+
claim("scanner", format === "cxsast-xml" ? "CxSAST" : "Checkmarx One SAST");
|
|
55
|
+
const sources = [report];
|
|
56
|
+
for (const { evidence } of findings) {
|
|
57
|
+
claim("scanner", evidence.details?.scanner_origin);
|
|
58
|
+
if (evidence.source_data)
|
|
59
|
+
sources.push(evidence.source_data);
|
|
60
|
+
}
|
|
61
|
+
if (sources.some(checkmarxResultViewer))
|
|
62
|
+
claim("scanner", "CxSAST");
|
|
63
|
+
const xml = claims.get("scanner") === "CxSAST";
|
|
64
|
+
const named = xml || sources.some((data) => text(data?.["teamFullPathOnReportDate"]));
|
|
65
|
+
claim("scan", scanKey(report?.["scanId"], xml));
|
|
66
|
+
for (const { evidence } of findings)
|
|
67
|
+
claim("scan", scanKey(evidence.source_scan_id, xml));
|
|
68
|
+
let instance;
|
|
69
|
+
for (const data of sources) {
|
|
70
|
+
if (!data)
|
|
71
|
+
continue;
|
|
72
|
+
claim("project", data["projectId"]);
|
|
73
|
+
if (named) {
|
|
74
|
+
claim("project name", text(data["projectName"]));
|
|
75
|
+
claim("team", text(data["teamFullPathOnReportDate"])
|
|
76
|
+
?.replaceAll("\\", "/")
|
|
77
|
+
.replace(/^\/+|\/+$/gu, "")
|
|
78
|
+
.replace(/[A-Z]/gu, (c) => c.toLowerCase()));
|
|
79
|
+
}
|
|
80
|
+
// A URL identifies a deployment; other instance metadata in SDK rows is opaque.
|
|
81
|
+
const url = data["instance"];
|
|
82
|
+
if (xml ||
|
|
83
|
+
(typeof url === "string" &&
|
|
84
|
+
/^https?:$/u.test(URL.parse(url)?.protocol ?? ""))) {
|
|
85
|
+
const scope = checkmarxXmlScope(data);
|
|
86
|
+
instance = checkmarxXmlInstance(instance, scope.instance);
|
|
87
|
+
claim("project", scope.projectId);
|
|
88
|
+
claim("scan", scope.scanId);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
/** Identify report and row provenance once for both import destinations. */
|
|
93
|
+
export function checkmarxSelection(provider, findings, report, target, historical = false) {
|
|
94
|
+
const selected = provider === "checkmarx";
|
|
95
|
+
const replay = historical && !selected;
|
|
96
|
+
const format = report?.["format"];
|
|
97
|
+
const nativeReport = checkmarxFormat(format);
|
|
98
|
+
const formats = new Map();
|
|
99
|
+
for (const finding of findings) {
|
|
100
|
+
const kind = checkmarxSource(finding, provider);
|
|
101
|
+
if (kind)
|
|
102
|
+
formats.set(finding, kind);
|
|
103
|
+
}
|
|
104
|
+
const validateUrl = (value) => declaredScannerRepositoryUrl(value, "Checkmarx", target);
|
|
105
|
+
function requireProvider() {
|
|
106
|
+
if (!selected)
|
|
107
|
+
throw new Error("Retained Checkmarx evidence requires the checkmarx provider.");
|
|
108
|
+
}
|
|
109
|
+
if (selected)
|
|
110
|
+
checkBatchScope(findings, formats.values(), report);
|
|
111
|
+
let reportUrl;
|
|
112
|
+
if (report && nativeReport && !replay) {
|
|
113
|
+
requireProvider();
|
|
114
|
+
const xml = format === "cxsast-xml";
|
|
115
|
+
const scan = scanKey(requiredText(report["scanId"], "Checkmarx report scan ID"), xml);
|
|
116
|
+
const project = xml
|
|
117
|
+
? requiredText(report["projectId"], "CxSAST report project ID")
|
|
118
|
+
: undefined;
|
|
119
|
+
for (const finding of findings) {
|
|
120
|
+
const { evidence } = finding;
|
|
121
|
+
const data = evidence.source_data;
|
|
122
|
+
if ((data && "format" in data ? data["format"] : formats.get(finding)) !==
|
|
123
|
+
format ||
|
|
124
|
+
scanKey(evidence.source_scan_id, xml) !== scan ||
|
|
125
|
+
(xml && data?.["projectId"] !== project))
|
|
126
|
+
throw new Error(mismatch);
|
|
127
|
+
}
|
|
128
|
+
reportUrl = validateUrl(report["sourceRepositoryUrl"]);
|
|
129
|
+
}
|
|
130
|
+
else if (report) {
|
|
131
|
+
if (selected && "sourceRepositoryUrl" in report && "scanId" in report)
|
|
132
|
+
throw new Error("Expected the original Checkmarx report format.");
|
|
133
|
+
if (typeof report["sourceRepositoryUrl"] === "string" &&
|
|
134
|
+
(selected || nativeReport || formats.size))
|
|
135
|
+
reportUrl = validateUrl(report["sourceRepositoryUrl"]);
|
|
136
|
+
}
|
|
137
|
+
const marked = new Set(nativeReport || reportUrl ? findings : formats.keys());
|
|
138
|
+
function projectedRepository({ evidence }) {
|
|
139
|
+
const source = evidence.source_data?.["sourceRepositoryUrl"];
|
|
140
|
+
const url = typeof source === "string"
|
|
141
|
+
? validateUrl(source)
|
|
142
|
+
: evidence.details?.repository?.url;
|
|
143
|
+
return url ? { url } : undefined;
|
|
144
|
+
}
|
|
145
|
+
const validateRows = repositoryScopeValidator({
|
|
146
|
+
provider: "checkmarx",
|
|
147
|
+
label: "Checkmarx",
|
|
148
|
+
scope: "product, project and scan",
|
|
149
|
+
}, (_, finding) => {
|
|
150
|
+
const { source_finding_id: id, evidence } = finding;
|
|
151
|
+
const data = evidence.source_data;
|
|
152
|
+
const kind = formats.get(finding);
|
|
153
|
+
if (checkmarxFormat(kind) && data) {
|
|
154
|
+
requireProvider();
|
|
155
|
+
requiredText(evidence.source_scan_id, "Checkmarx source scan ID");
|
|
156
|
+
const expected = kind === "cxsast-xml"
|
|
157
|
+
? checkmarxXmlId(data)
|
|
158
|
+
: checkmarxOneId(data["row"]);
|
|
159
|
+
if (id !== expected)
|
|
160
|
+
throw new Error("Checkmarx source finding ID does not match the retained occurrence.");
|
|
161
|
+
return { url: validateUrl(data["sourceRepositoryUrl"]), scope: kind };
|
|
162
|
+
}
|
|
163
|
+
if (selected && nativeId.test(id))
|
|
164
|
+
throw new Error("Checkmarx source finding ID requires its original evidence.");
|
|
165
|
+
if (selected && data && "sourceRepositoryUrl" in data)
|
|
166
|
+
return { url: validateUrl(data["sourceRepositoryUrl"]) };
|
|
167
|
+
return kind ? projectedRepository(finding) : undefined;
|
|
168
|
+
});
|
|
169
|
+
return {
|
|
170
|
+
reportUrl,
|
|
171
|
+
projections: selected ? new Set() : marked,
|
|
172
|
+
repositories(sameRepositories) {
|
|
173
|
+
const rows = replay || (!selected && !formats.size)
|
|
174
|
+
? undefined
|
|
175
|
+
: validateRows(provider, findings, target, sameRepositories);
|
|
176
|
+
return (finding) => rows?.get(finding.source_finding_id) ??
|
|
177
|
+
(marked.has(finding) ? projectedRepository(finding) : undefined);
|
|
178
|
+
},
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
//# sourceMappingURL=checkmarx-repository.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"checkmarx-repository.js","sourceRoot":"","sources":["../src/checkmarx-repository.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport type { ExternalImportTarget } from \"./external-import-contract.js\";\nimport type { Provider } from \"./external-import-models.js\";\nimport { isRecord } from \"./record.js\";\nimport { requiredText, text } from \"./scanner-import.js\";\nimport { checkmarxOneId } from \"./checkmarx-one.js\";\nimport {\n checkmarxResultViewer,\n checkmarxXmlId,\n checkmarxXmlInstance,\n checkmarxXmlScope,\n} from \"./checkmarx-xml.js\";\nimport {\n declaredScannerRepositoryUrl,\n repositoryScopeValidator,\n} from \"./scanner-repository-url.js\";\n\nconst nativeId = /^checkmarx-(?:one|cxsast):[a-f0-9]{64}$/u;\n\nfunction checkmarxFormat(value: unknown) {\n return value === \"cxsast-xml\" || value === \"checkmarx-one-json\";\n}\n\nfunction scanKey(value: unknown, xml: boolean) {\n const uuid = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/iu;\n return !xml && typeof value === \"string\" && uuid.test(value)\n ? value.toLowerCase()\n : value;\n}\n\n/** A native payload can verify its occurrence ID. A projection can still identify its source. */\nfunction checkmarxSource(\n { source_finding_id: id, evidence }: ExternalFinding,\n provider?: Provider,\n) {\n const data = evidence.source_data;\n const format = data?.[\"format\"];\n if (checkmarxFormat(format)) return format;\n const scanner = evidence.details?.scanner_origin;\n const projected =\n nativeId.test(id) ||\n scanner === \"CxSAST\" ||\n scanner === \"Checkmarx One SAST\" ||\n Boolean(checkmarxResultViewer(data));\n if (\n data &&\n (provider === \"checkmarx\" || projected || \"sourceRepositoryUrl\" in data)\n ) {\n const row = data[\"row\"];\n if (isRecord(row) && row[\"type\"] === \"sast\" && \"similarityId\" in row)\n return \"checkmarx-one-json\";\n const path = data[\"path\"];\n if (\"projectId\" in data && isRecord(path) && \"SimilarityId\" in path)\n return \"cxsast-xml\";\n }\n if (projected) return \"projection\";\n}\n\nconst mismatch =\n \"Checkmarx finding does not match the retained report format, scan or project.\";\n\n/** Compare the claims present across the whole batch, including projected SDK rows. */\nfunction checkBatchScope(\n findings: readonly ExternalFinding[],\n formats: Iterable<string>,\n report: ExternalFindings[\"report\"],\n) {\n const claims = new Map<string, unknown>();\n function claim(key: string, value: unknown) {\n if (value == null) return;\n if (claims.has(key) && claims.get(key) !== value)\n throw new Error(\n report\n ? mismatch\n : \"Checkmarx occurrences must belong to the same product, project and scan.\",\n );\n claims.set(key, value);\n }\n\n for (const format of [report?.[\"format\"], ...formats])\n if (checkmarxFormat(format))\n claim(\n \"scanner\",\n format === \"cxsast-xml\" ? \"CxSAST\" : \"Checkmarx One SAST\",\n );\n const sources = [report];\n for (const { evidence } of findings) {\n claim(\"scanner\", evidence.details?.scanner_origin);\n if (evidence.source_data) sources.push(evidence.source_data);\n }\n if (sources.some(checkmarxResultViewer)) claim(\"scanner\", \"CxSAST\");\n const xml = claims.get(\"scanner\") === \"CxSAST\";\n const named =\n xml || sources.some((data) => text(data?.[\"teamFullPathOnReportDate\"]));\n claim(\"scan\", scanKey(report?.[\"scanId\"], xml));\n for (const { evidence } of findings)\n claim(\"scan\", scanKey(evidence.source_scan_id, xml));\n\n let instance: string | undefined;\n for (const data of sources) {\n if (!data) continue;\n claim(\"project\", data[\"projectId\"]);\n if (named) {\n claim(\"project name\", text(data[\"projectName\"]));\n claim(\n \"team\",\n text(data[\"teamFullPathOnReportDate\"])\n ?.replaceAll(\"\\\\\", \"/\")\n .replace(/^\\/+|\\/+$/gu, \"\")\n .replace(/[A-Z]/gu, (c) => c.toLowerCase()),\n );\n }\n // A URL identifies a deployment; other instance metadata in SDK rows is opaque.\n const url = data[\"instance\"];\n if (\n xml ||\n (typeof url === \"string\" &&\n /^https?:$/u.test(URL.parse(url)?.protocol ?? \"\"))\n ) {\n const scope = checkmarxXmlScope(data);\n instance = checkmarxXmlInstance(instance, scope.instance);\n claim(\"project\", scope.projectId);\n claim(\"scan\", scope.scanId);\n }\n }\n}\n\n/** Identify report and row provenance once for both import destinations. */\nexport function checkmarxSelection(\n provider: Provider,\n findings: ExternalFindings[\"findings\"],\n report: ExternalFindings[\"report\"],\n target: ExternalImportTarget,\n historical = false,\n) {\n const selected = provider === \"checkmarx\";\n const replay = historical && !selected;\n const format = report?.[\"format\"];\n const nativeReport = checkmarxFormat(format);\n const formats = new Map<ExternalFinding, string>();\n for (const finding of findings) {\n const kind = checkmarxSource(finding, provider);\n if (kind) formats.set(finding, kind);\n }\n const validateUrl = (value: unknown) =>\n declaredScannerRepositoryUrl(value, \"Checkmarx\", target);\n function requireProvider() {\n if (!selected)\n throw new Error(\n \"Retained Checkmarx evidence requires the checkmarx provider.\",\n );\n }\n if (selected) checkBatchScope(findings, formats.values(), report);\n let reportUrl: string | undefined;\n if (report && nativeReport && !replay) {\n requireProvider();\n const xml = format === \"cxsast-xml\";\n const scan = scanKey(\n requiredText(report[\"scanId\"], \"Checkmarx report scan ID\"),\n xml,\n );\n const project = xml\n ? requiredText(report[\"projectId\"], \"CxSAST report project ID\")\n : undefined;\n for (const finding of findings) {\n const { evidence } = finding;\n const data = evidence.source_data;\n if (\n (data && \"format\" in data ? data[\"format\"] : formats.get(finding)) !==\n format ||\n scanKey(evidence.source_scan_id, xml) !== scan ||\n (xml && data?.[\"projectId\"] !== project)\n )\n throw new Error(mismatch);\n }\n reportUrl = validateUrl(report[\"sourceRepositoryUrl\"]);\n } else if (report) {\n if (selected && \"sourceRepositoryUrl\" in report && \"scanId\" in report)\n throw new Error(\"Expected the original Checkmarx report format.\");\n if (\n typeof report[\"sourceRepositoryUrl\"] === \"string\" &&\n (selected || nativeReport || formats.size)\n )\n reportUrl = validateUrl(report[\"sourceRepositoryUrl\"]);\n }\n const marked = new Set(nativeReport || reportUrl ? findings : formats.keys());\n function projectedRepository({ evidence }: ExternalFinding) {\n const source = evidence.source_data?.[\"sourceRepositoryUrl\"];\n const url =\n typeof source === \"string\"\n ? validateUrl(source)\n : evidence.details?.repository?.url;\n return url ? { url } : undefined;\n }\n const validateRows = repositoryScopeValidator(\n {\n provider: \"checkmarx\",\n label: \"Checkmarx\",\n scope: \"product, project and scan\",\n },\n (_, finding) => {\n const { source_finding_id: id, evidence } = finding;\n const data = evidence.source_data;\n const kind = formats.get(finding);\n if (checkmarxFormat(kind) && data) {\n requireProvider();\n requiredText(evidence.source_scan_id, \"Checkmarx source scan ID\");\n const expected =\n kind === \"cxsast-xml\"\n ? checkmarxXmlId(data)\n : checkmarxOneId(data[\"row\"]);\n if (id !== expected)\n throw new Error(\n \"Checkmarx source finding ID does not match the retained occurrence.\",\n );\n return { url: validateUrl(data[\"sourceRepositoryUrl\"]), scope: kind };\n }\n if (selected && nativeId.test(id))\n throw new Error(\n \"Checkmarx source finding ID requires its original evidence.\",\n );\n if (selected && data && \"sourceRepositoryUrl\" in data)\n return { url: validateUrl(data[\"sourceRepositoryUrl\"]) };\n return kind ? projectedRepository(finding) : undefined;\n },\n );\n return {\n reportUrl,\n projections: selected ? new Set<ExternalFinding>() : marked,\n repositories(sameRepositories?: (urls: Iterable<string>) => boolean) {\n const rows =\n replay || (!selected && !formats.size)\n ? undefined\n : validateRows(provider, findings, target, sameRepositories);\n return (finding: ExternalFinding) =>\n rows?.get(finding.source_finding_id) ??\n (marked.has(finding) ? projectedRepository(finding) : undefined);\n },\n };\n}\n"]}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { ExternalImportTarget } from "./external-import-contract.js";
|
|
2
|
+
export declare function checkmarxXmlInstance(current: string | undefined, next: string | undefined): string | undefined;
|
|
3
|
+
export declare function checkmarxResultViewer(source: Record<string, unknown> | null | undefined): URL | undefined;
|
|
4
|
+
export declare function checkmarxXmlScope(source: Record<string, unknown>, scanId?: string, projectId?: string): {
|
|
5
|
+
instance: string | undefined;
|
|
6
|
+
scanId: string | undefined;
|
|
7
|
+
projectId: string | undefined;
|
|
8
|
+
};
|
|
9
|
+
/** SimilarityId groups paths, including paths with different intermediate nodes. */
|
|
10
|
+
export declare function checkmarxXmlId(source: Record<string, unknown>): string;
|
|
11
|
+
export declare function normalizeCheckmarxXml(contents: string, repository: string, target: ExternalImportTarget): import("./external-findings.js").ExternalFindings;
|
|
12
|
+
//# sourceMappingURL=checkmarx-xml.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"checkmarx-xml.d.ts","sourceRoot":"","sources":["../src/checkmarx-xml.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAiE1E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,sBAUzB;AAaD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,mBAGnD;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM;IAUhB,QAAQ;IAMR,MAAM;IACN,SAAS;EAEZ;AAgED,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAkBtE;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oBAAoB,qDA0D7B"}
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
import { SaxesParser } from "saxes";
|
|
2
|
+
import { asRecord } from "./record.js";
|
|
3
|
+
import { checkmarxEvidence } from "./checkmarx-evidence.js";
|
|
4
|
+
import { array, normalizeRecords, record, requiredText, stableId, text, } from "./scanner-import.js";
|
|
5
|
+
function fields(element) {
|
|
6
|
+
return Object.fromEntries(element.children
|
|
7
|
+
.filter((child) => !child.children.length)
|
|
8
|
+
.map((child) => [child.name, child.text]));
|
|
9
|
+
}
|
|
10
|
+
function pathNode(element) {
|
|
11
|
+
const node = fields(element);
|
|
12
|
+
const snippet = element.children.find((child) => child.name === "Snippet");
|
|
13
|
+
if (snippet)
|
|
14
|
+
node["Snippet"] = snippet.children
|
|
15
|
+
.filter((child) => child.name === "Line")
|
|
16
|
+
.map(fields);
|
|
17
|
+
return node;
|
|
18
|
+
}
|
|
19
|
+
const viewerPath = "/cxwebclient/viewermain.aspx";
|
|
20
|
+
function viewerLink(value) {
|
|
21
|
+
const url = typeof value === "string" ? URL.parse(value) : null;
|
|
22
|
+
if (url &&
|
|
23
|
+
/^https?:$/u.test(url.protocol) &&
|
|
24
|
+
url.pathname.toLowerCase().endsWith(viewerPath))
|
|
25
|
+
return url;
|
|
26
|
+
}
|
|
27
|
+
function viewerInstance(link) {
|
|
28
|
+
return link && link.origin + link.pathname.slice(0, -viewerPath.length);
|
|
29
|
+
}
|
|
30
|
+
function instanceKey(value) {
|
|
31
|
+
const url = URL.parse(value);
|
|
32
|
+
return url && /^https?:$/u.test(url.protocol) ? url.href : value;
|
|
33
|
+
}
|
|
34
|
+
export function checkmarxXmlInstance(current, next) {
|
|
35
|
+
if (current !== undefined &&
|
|
36
|
+
next !== undefined &&
|
|
37
|
+
current !== next &&
|
|
38
|
+
instanceKey(current) !== instanceKey(next))
|
|
39
|
+
throw new Error("CxSAST viewer links must identify the same instance.");
|
|
40
|
+
return current ?? next;
|
|
41
|
+
}
|
|
42
|
+
function viewerId(link, field, expected) {
|
|
43
|
+
let selected = expected;
|
|
44
|
+
for (const [key, id] of link?.searchParams ?? []) {
|
|
45
|
+
if (!id || key.toLowerCase() !== field)
|
|
46
|
+
continue;
|
|
47
|
+
if (selected !== undefined && selected !== id)
|
|
48
|
+
throw new Error(`CxSAST DeepLink ${field} does not match the report.`);
|
|
49
|
+
selected = id;
|
|
50
|
+
}
|
|
51
|
+
return selected;
|
|
52
|
+
}
|
|
53
|
+
export function checkmarxResultViewer(source) {
|
|
54
|
+
return viewerLink(asRecord(source?.["result"])?.["DeepLink"]);
|
|
55
|
+
}
|
|
56
|
+
export function checkmarxXmlScope(source, scanId, projectId) {
|
|
57
|
+
const link = checkmarxResultViewer(source);
|
|
58
|
+
viewerId(link, "pathid", text(asRecord(source["path"])?.["PathId"]) ?? undefined);
|
|
59
|
+
const instance = source["instance"];
|
|
60
|
+
return {
|
|
61
|
+
instance: checkmarxXmlInstance(instance === undefined
|
|
62
|
+
? undefined
|
|
63
|
+
: requiredText(instance, "CxSAST instance"), viewerInstance(link)),
|
|
64
|
+
scanId: viewerId(link, "scanid", scanId),
|
|
65
|
+
projectId: viewerId(link, "projectid", projectId),
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
function readReport(contents) {
|
|
69
|
+
const rows = [];
|
|
70
|
+
const stack = [];
|
|
71
|
+
const parser = new SaxesParser({ xmlns: false });
|
|
72
|
+
let scanId = "";
|
|
73
|
+
let rootInstance;
|
|
74
|
+
const project = { projectId: "" };
|
|
75
|
+
parser.on("opentag", ({ name, attributes }) => {
|
|
76
|
+
const element = { name, attributes, children: [], text: "" };
|
|
77
|
+
if (!stack.length) {
|
|
78
|
+
if (name !== "CxXMLResults")
|
|
79
|
+
throw new Error("Expected a Checkmarx CxSAST CxXMLResults report.");
|
|
80
|
+
project.projectId = requiredText(attributes["ProjectId"], "CxSAST ProjectId");
|
|
81
|
+
scanId = requiredText(attributes["ScanId"], "CxSAST ScanId");
|
|
82
|
+
const projectName = text(attributes["ProjectName"]);
|
|
83
|
+
const team = text(attributes["TeamFullPathOnReportDate"]);
|
|
84
|
+
if (projectName)
|
|
85
|
+
project["projectName"] = projectName;
|
|
86
|
+
if (team)
|
|
87
|
+
project["teamFullPathOnReportDate"] = team;
|
|
88
|
+
const link = viewerLink(attributes["DeepLink"]);
|
|
89
|
+
viewerId(link, "scanid", scanId);
|
|
90
|
+
viewerId(link, "projectid", project.projectId);
|
|
91
|
+
rootInstance = viewerInstance(link);
|
|
92
|
+
}
|
|
93
|
+
else if ((stack.length === 1 && name !== "Query") ||
|
|
94
|
+
(stack.length === 2 && name !== "Result")) {
|
|
95
|
+
throw new Error("Expected CxSAST results directly under their Query.");
|
|
96
|
+
}
|
|
97
|
+
// Only build subtrees within the current result, then release them.
|
|
98
|
+
if (stack.length >= 3)
|
|
99
|
+
stack.at(-1).children.push(element);
|
|
100
|
+
stack.push(element);
|
|
101
|
+
});
|
|
102
|
+
function appendText(value) {
|
|
103
|
+
const element = stack.at(-1);
|
|
104
|
+
if (element)
|
|
105
|
+
element.text += value;
|
|
106
|
+
}
|
|
107
|
+
parser.on("text", appendText);
|
|
108
|
+
parser.on("cdata", appendText);
|
|
109
|
+
parser.on("closetag", () => {
|
|
110
|
+
const element = stack.pop();
|
|
111
|
+
const parent = stack.at(-1);
|
|
112
|
+
if (parent?.name !== "Query" || stack.length !== 2)
|
|
113
|
+
return;
|
|
114
|
+
const paths = element.children.filter((child) => child.name === "Path");
|
|
115
|
+
const path = paths.length === 1 ? paths[0] : undefined;
|
|
116
|
+
rows.push({
|
|
117
|
+
...project,
|
|
118
|
+
query: parent.attributes,
|
|
119
|
+
result: element.attributes,
|
|
120
|
+
path: path?.attributes ?? null,
|
|
121
|
+
nodes: path?.children
|
|
122
|
+
.filter((child) => child.name === "PathNode")
|
|
123
|
+
.map(pathNode) ?? [],
|
|
124
|
+
});
|
|
125
|
+
});
|
|
126
|
+
parser.write(contents).close();
|
|
127
|
+
return { rows, project, scanId, rootInstance };
|
|
128
|
+
}
|
|
129
|
+
/** SimilarityId groups paths, including paths with different intermediate nodes. */
|
|
130
|
+
export function checkmarxXmlId(source) {
|
|
131
|
+
const projectId = requiredText(source["projectId"], "CxSAST ProjectId");
|
|
132
|
+
const query = record(source["query"], "CxSAST Query");
|
|
133
|
+
const result = record(source["result"], "CxSAST Result");
|
|
134
|
+
const path = record(source["path"], "CxSAST Path");
|
|
135
|
+
const nodes = array(source["nodes"], "CxSAST Path nodes");
|
|
136
|
+
const route = (nodes.length ? nodes : [result]).map((value) => {
|
|
137
|
+
const node = record(value, "CxSAST path node");
|
|
138
|
+
return ["FileName", "Line", "Column", "Name", "Type"].map((field) => text(node[field]));
|
|
139
|
+
});
|
|
140
|
+
return stableId("checkmarx-cxsast", [
|
|
141
|
+
projectId,
|
|
142
|
+
requiredText(query["id"], "CxSAST Query id"),
|
|
143
|
+
requiredText(path["SimilarityId"], "CxSAST SimilarityId"),
|
|
144
|
+
route,
|
|
145
|
+
]);
|
|
146
|
+
}
|
|
147
|
+
export function normalizeCheckmarxXml(contents, repository, target) {
|
|
148
|
+
const { rows, project, scanId, rootInstance } = readReport(contents);
|
|
149
|
+
function normalize(instance) {
|
|
150
|
+
const report = {
|
|
151
|
+
format: "cxsast-xml",
|
|
152
|
+
scanId,
|
|
153
|
+
...project,
|
|
154
|
+
...(instance && { instance }),
|
|
155
|
+
sourceRepositoryUrl: repository,
|
|
156
|
+
};
|
|
157
|
+
return normalizeRecords(rows, (row) => {
|
|
158
|
+
const { query, result } = row;
|
|
159
|
+
return checkmarxEvidence(report, {
|
|
160
|
+
title: requiredText(query["name"], "CxSAST Query name"),
|
|
161
|
+
ruleId: query["id"],
|
|
162
|
+
severity: text(result["Severity"]) ?? query["Severity"],
|
|
163
|
+
description: result["Remark"],
|
|
164
|
+
status: result["Status"],
|
|
165
|
+
verdict: result["FalsePositive"]?.toLowerCase() === "true"
|
|
166
|
+
? "False positive"
|
|
167
|
+
: result["state"],
|
|
168
|
+
cwe: query["cweId"],
|
|
169
|
+
sourceData: !row["instance"] && instance ? { ...row, instance } : row,
|
|
170
|
+
}, target);
|
|
171
|
+
}, (row) => {
|
|
172
|
+
const scope = checkmarxXmlScope(row, scanId, project.projectId);
|
|
173
|
+
if (scope.instance)
|
|
174
|
+
row["instance"] = scope.instance;
|
|
175
|
+
return checkmarxXmlId(row);
|
|
176
|
+
}, target, { report });
|
|
177
|
+
}
|
|
178
|
+
const result = normalize(rootInstance);
|
|
179
|
+
let instance = rootInstance;
|
|
180
|
+
let hasUnboundRows = false;
|
|
181
|
+
for (const { evidence } of result.findings) {
|
|
182
|
+
const rowInstance = text(evidence.source_data?.["instance"]);
|
|
183
|
+
if (rowInstance)
|
|
184
|
+
instance = checkmarxXmlInstance(instance, rowInstance);
|
|
185
|
+
else
|
|
186
|
+
hasUnboundRows = true;
|
|
187
|
+
}
|
|
188
|
+
if (instance && !rootInstance) {
|
|
189
|
+
// Count inherited instance bytes before accepting linkless findings for Cloud.
|
|
190
|
+
if (hasUnboundRows)
|
|
191
|
+
return normalize(instance);
|
|
192
|
+
result.report["instance"] = instance;
|
|
193
|
+
}
|
|
194
|
+
return result;
|
|
195
|
+
}
|
|
196
|
+
//# sourceMappingURL=checkmarx-xml.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"checkmarx-xml.js","sourceRoot":"","sources":["../src/checkmarx-xml.ts"],"names":[],"mappings":"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","sourcesContent":["import { SaxesParser } from \"saxes\";\nimport { asRecord } from \"./record.js\";\nimport { checkmarxEvidence } from \"./checkmarx-evidence.js\";\nimport type { ExternalImportTarget } from \"./external-import-contract.js\";\nimport {\n array,\n normalizeRecords,\n record,\n requiredText,\n stableId,\n text,\n} from \"./scanner-import.js\";\n\ntype Attributes = Record<string, string>;\ninterface Element {\n name: string;\n attributes: Attributes;\n children: Element[];\n text: string;\n}\n\nfunction fields(element: Element): Attributes {\n return Object.fromEntries(\n element.children\n .filter((child) => !child.children.length)\n .map((child) => [child.name, child.text]),\n );\n}\n\nfunction pathNode(element: Element): Record<string, unknown> {\n const node: Record<string, unknown> = fields(element);\n const snippet = element.children.find((child) => child.name === \"Snippet\");\n if (snippet)\n node[\"Snippet\"] = snippet.children\n .filter((child) => child.name === \"Line\")\n .map(fields);\n return node;\n}\n\ninterface Row extends Record<string, unknown> {\n projectId: string;\n query: Attributes;\n result: Attributes;\n path: Attributes | null;\n nodes: Record<string, unknown>[];\n}\n\nconst viewerPath = \"/cxwebclient/viewermain.aspx\";\n\nfunction viewerLink(value: unknown) {\n const url = typeof value === \"string\" ? URL.parse(value) : null;\n if (\n url &&\n /^https?:$/u.test(url.protocol) &&\n url.pathname.toLowerCase().endsWith(viewerPath)\n )\n return url;\n}\n\nfunction viewerInstance(link: URL | undefined) {\n return link && link.origin + link.pathname.slice(0, -viewerPath.length);\n}\n\nfunction instanceKey(value: string) {\n const url = URL.parse(value);\n return url && /^https?:$/u.test(url.protocol) ? url.href : value;\n}\n\nexport function checkmarxXmlInstance(\n current: string | undefined,\n next: string | undefined,\n) {\n if (\n current !== undefined &&\n next !== undefined &&\n current !== next &&\n instanceKey(current) !== instanceKey(next)\n )\n throw new Error(\"CxSAST viewer links must identify the same instance.\");\n return current ?? next;\n}\n\nfunction viewerId(link: URL | undefined, field: string, expected?: string) {\n let selected = expected;\n for (const [key, id] of link?.searchParams ?? []) {\n if (!id || key.toLowerCase() !== field) continue;\n if (selected !== undefined && selected !== id)\n throw new Error(`CxSAST DeepLink ${field} does not match the report.`);\n selected = id;\n }\n return selected;\n}\n\nexport function checkmarxResultViewer(\n source: Record<string, unknown> | null | undefined,\n) {\n return viewerLink(asRecord(source?.[\"result\"])?.[\"DeepLink\"]);\n}\n\nexport function checkmarxXmlScope(\n source: Record<string, unknown>,\n scanId?: string,\n projectId?: string,\n) {\n const link = checkmarxResultViewer(source);\n viewerId(\n link,\n \"pathid\",\n text(asRecord(source[\"path\"])?.[\"PathId\"]) ?? undefined,\n );\n const instance = source[\"instance\"];\n return {\n instance: checkmarxXmlInstance(\n instance === undefined\n ? undefined\n : requiredText(instance, \"CxSAST instance\"),\n viewerInstance(link),\n ),\n scanId: viewerId(link, \"scanid\", scanId),\n projectId: viewerId(link, \"projectid\", projectId),\n };\n}\n\nfunction readReport(contents: string) {\n const rows: Row[] = [];\n const stack: Element[] = [];\n const parser = new SaxesParser({ xmlns: false });\n let scanId = \"\";\n let rootInstance: string | undefined;\n const project: Attributes & { projectId: string } = { projectId: \"\" };\n parser.on(\"opentag\", ({ name, attributes }) => {\n const element: Element = { name, attributes, children: [], text: \"\" };\n if (!stack.length) {\n if (name !== \"CxXMLResults\")\n throw new Error(\"Expected a Checkmarx CxSAST CxXMLResults report.\");\n project.projectId = requiredText(\n attributes[\"ProjectId\"],\n \"CxSAST ProjectId\",\n );\n scanId = requiredText(attributes[\"ScanId\"], \"CxSAST ScanId\");\n const projectName = text(attributes[\"ProjectName\"]);\n const team = text(attributes[\"TeamFullPathOnReportDate\"]);\n if (projectName) project[\"projectName\"] = projectName;\n if (team) project[\"teamFullPathOnReportDate\"] = team;\n const link = viewerLink(attributes[\"DeepLink\"]);\n viewerId(link, \"scanid\", scanId);\n viewerId(link, \"projectid\", project.projectId);\n rootInstance = viewerInstance(link);\n } else if (\n (stack.length === 1 && name !== \"Query\") ||\n (stack.length === 2 && name !== \"Result\")\n ) {\n throw new Error(\"Expected CxSAST results directly under their Query.\");\n }\n // Only build subtrees within the current result, then release them.\n if (stack.length >= 3) stack.at(-1)!.children.push(element);\n stack.push(element);\n });\n function appendText(value: string) {\n const element = stack.at(-1);\n if (element) element.text += value;\n }\n parser.on(\"text\", appendText);\n parser.on(\"cdata\", appendText);\n parser.on(\"closetag\", () => {\n const element = stack.pop()!;\n const parent = stack.at(-1);\n if (parent?.name !== \"Query\" || stack.length !== 2) return;\n const paths = element.children.filter((child) => child.name === \"Path\");\n const path = paths.length === 1 ? paths[0] : undefined;\n rows.push({\n ...project,\n query: parent.attributes,\n result: element.attributes,\n path: path?.attributes ?? null,\n nodes:\n path?.children\n .filter((child) => child.name === \"PathNode\")\n .map(pathNode) ?? [],\n });\n });\n parser.write(contents).close();\n return { rows, project, scanId, rootInstance };\n}\n\n/** SimilarityId groups paths, including paths with different intermediate nodes. */\nexport function checkmarxXmlId(source: Record<string, unknown>): string {\n const projectId = requiredText(source[\"projectId\"], \"CxSAST ProjectId\");\n const query = record(source[\"query\"], \"CxSAST Query\");\n const result = record(source[\"result\"], \"CxSAST Result\");\n const path = record(source[\"path\"], \"CxSAST Path\");\n const nodes = array(source[\"nodes\"], \"CxSAST Path nodes\");\n const route = (nodes.length ? nodes : [result]).map((value) => {\n const node = record(value, \"CxSAST path node\");\n return [\"FileName\", \"Line\", \"Column\", \"Name\", \"Type\"].map((field) =>\n text(node[field]),\n );\n });\n return stableId(\"checkmarx-cxsast\", [\n projectId,\n requiredText(query[\"id\"], \"CxSAST Query id\"),\n requiredText(path[\"SimilarityId\"], \"CxSAST SimilarityId\"),\n route,\n ]);\n}\n\nexport function normalizeCheckmarxXml(\n contents: string,\n repository: string,\n target: ExternalImportTarget,\n) {\n const { rows, project, scanId, rootInstance } = readReport(contents);\n function normalize(instance: string | undefined) {\n const report = {\n format: \"cxsast-xml\",\n scanId,\n ...project,\n ...(instance && { instance }),\n sourceRepositoryUrl: repository,\n } as const;\n return normalizeRecords(\n rows,\n (row) => {\n const { query, result } = row;\n return checkmarxEvidence(\n report,\n {\n title: requiredText(query[\"name\"], \"CxSAST Query name\"),\n ruleId: query[\"id\"],\n severity: text(result[\"Severity\"]) ?? query[\"Severity\"],\n description: result[\"Remark\"],\n status: result[\"Status\"],\n verdict:\n result[\"FalsePositive\"]?.toLowerCase() === \"true\"\n ? \"False positive\"\n : result[\"state\"],\n cwe: query[\"cweId\"],\n sourceData:\n !row[\"instance\"] && instance ? { ...row, instance } : row,\n },\n target,\n );\n },\n (row) => {\n const scope = checkmarxXmlScope(row, scanId, project.projectId);\n if (scope.instance) row[\"instance\"] = scope.instance;\n return checkmarxXmlId(row);\n },\n target,\n { report },\n );\n }\n\n const result = normalize(rootInstance);\n let instance = rootInstance;\n let hasUnboundRows = false;\n for (const { evidence } of result.findings) {\n const rowInstance = text(evidence.source_data?.[\"instance\"]);\n if (rowInstance) instance = checkmarxXmlInstance(instance, rowInstance);\n else hasUnboundRows = true;\n }\n if (instance && !rootInstance) {\n // Count inherited instance bytes before accepting linkless findings for Cloud.\n if (hasUnboundRows) return normalize(instance);\n result.report![\"instance\"] = instance;\n }\n return result;\n}\n"]}
|
|
@@ -14,15 +14,7 @@ export declare const classifySeverityRecordsInputSchema: z.ZodObject<{
|
|
|
14
14
|
sha256: z.ZodString;
|
|
15
15
|
}, z.core.$strict>>;
|
|
16
16
|
model: z.ZodString;
|
|
17
|
-
effort: z.
|
|
18
|
-
high: "high";
|
|
19
|
-
low: "low";
|
|
20
|
-
max: "max";
|
|
21
|
-
medium: "medium";
|
|
22
|
-
minimal: "minimal";
|
|
23
|
-
ultra: "ultra";
|
|
24
|
-
xhigh: "xhigh";
|
|
25
|
-
}>;
|
|
17
|
+
effort: z.ZodString;
|
|
26
18
|
records: z.ZodArray<z.ZodObject<{
|
|
27
19
|
id: z.ZodString;
|
|
28
20
|
revision: z.ZodNumber;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAO9B,eAAO,MAAM,4BAA4B;;;;kBAIvC,CAAC;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC
|
|
1
|
+
{"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAO9B,eAAO,MAAM,4BAA4B;;;;kBAIvC,CAAC;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;kBAiBpC,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,yBAAyB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QACZ,GAAG,CACD,OAAO,EAAE,mCAAmC,EAC5C,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,gBAAgB,EAChB,WAAW,CACZ,GAAG;IACF,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,GAC9D,CACI;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,2BAA2B,EAAE,CAAA;CAAE,GACnE;IACE,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CACJ,CAAC;AAMJ;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAqFxC"}
|
|
@@ -3,7 +3,7 @@ import { defaultSeverityRubric } from "./default-severity-rubric.js";
|
|
|
3
3
|
import { createHash, randomUUID } from "node:crypto";
|
|
4
4
|
import { z } from "zod";
|
|
5
5
|
import { abortable } from "./targets.js";
|
|
6
|
-
import { parseSeverityDecision, reviewSeverity,
|
|
6
|
+
import { parseSeverityDecision, reviewSeverity, reviewRunsOption, severityDecisionSchema, severityReviewInstructions, } from "./severity-review.js";
|
|
7
7
|
const text = z
|
|
8
8
|
.string()
|
|
9
9
|
.refine((value) => value.trim().length > 0, "Must not be blank.");
|
|
@@ -36,15 +36,7 @@ export const classifySeverityRecordsInputSchema = z
|
|
|
36
36
|
version: z.literal(1),
|
|
37
37
|
rubric: severityRubricSnapshotSchema.optional(),
|
|
38
38
|
model: text,
|
|
39
|
-
effort: z.
|
|
40
|
-
"minimal",
|
|
41
|
-
"low",
|
|
42
|
-
"medium",
|
|
43
|
-
"high",
|
|
44
|
-
"xhigh",
|
|
45
|
-
"max",
|
|
46
|
-
"ultra",
|
|
47
|
-
]),
|
|
39
|
+
effort: z.string(),
|
|
48
40
|
records: z.array(z
|
|
49
41
|
.object({
|
|
50
42
|
id: text,
|
|
@@ -64,9 +56,7 @@ function sha256(value) {
|
|
|
64
56
|
*/
|
|
65
57
|
export async function classifySeverityRecords(input, options) {
|
|
66
58
|
options.signal?.throwIfAborted();
|
|
67
|
-
const classificationRuns =
|
|
68
|
-
.default(3)
|
|
69
|
-
.parse(options.classificationRuns);
|
|
59
|
+
const classificationRuns = reviewRunsOption.parse(options.classificationRuns);
|
|
70
60
|
const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));
|
|
71
61
|
const rubric = data.rubric ?? {
|
|
72
62
|
revision: 1,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity-records.js","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"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","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.js\";\nimport { defaultSeverityRubric } from \"./default-severity-rubric.js\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { abortable } from \"./targets.js\";\nimport {\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n severityDecisionSchema,\n severityReviewInstructions,\n type SeverityDecision,\n} from \"./severity-review.js\";\n\nconst text = z\n .string()\n .refine((value) => value.trim().length > 0, \"Must not be blank.\");\nconst digest = z.string().regex(/^[a-f0-9]{64}$/u);\nconst revision = z.number().int().nonnegative();\nexport const severityRubricSnapshotSchema = z.strictObject({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n});\n\nconst reportSchema = z\n .object({\n findingId: text,\n title: text,\n summary: text,\n occurrenceId: text.optional(),\n severity: z\n .object({\n level: z.enum(SCAN_SEVERITIES),\n rationale: z.string().optional(),\n changeConditions: z.string().optional(),\n })\n .passthrough()\n .optional(),\n })\n .passthrough();\n\n/** Versioned input for repository-free classification of canonical records. */\nexport const classifySeverityRecordsInputSchema = z\n .object({\n version: z.literal(1),\n rubric: severityRubricSnapshotSchema.optional(),\n model: text,\n effort: z.enum([\n \"minimal\",\n \"low\",\n \"medium\",\n \"high\",\n \"xhigh\",\n \"max\",\n \"ultra\",\n ]),\n records: z.array(\n z\n .object({\n id: text,\n revision,\n findingJson: text,\n inputSha256: digest,\n })\n .strict(),\n ),\n })\n .strict();\n\nexport type ClassifySeverityRecordsInput = z.infer<\n typeof classifySeverityRecordsInputSchema\n>;\n\nexport interface SeverityClassificationReviewRequest {\n requestId: string;\n stage: \"severity-classification\";\n model: string;\n effort: ClassifySeverityRecordsInput[\"effort\"];\n trustedInstructions: string;\n prompt: string;\n schema: unknown;\n}\n\nexport interface ClassifySeverityRecordsOptions {\n /** Independent reviews per record: integer 1–10, default 3. */\n classificationRuns?: number;\n reviewRunner: {\n run(\n request: SeverityClassificationReviewRequest,\n options?: { signal?: AbortSignal },\n ): Promise<unknown>;\n };\n signal?: AbortSignal;\n}\n\nexport type CanonicalSeverityAssessment = Omit<\n SeverityDecision,\n \"findingId\"\n> & {\n id: string;\n revision: number;\n inputSha256: string;\n};\n\ninterface RecordsResultBinding {\n classificationRuns: number;\n version: 1;\n rubric: { revision: number; sha256: string };\n}\n\nexport type ClassifySeverityRecordsResult = RecordsResultBinding &\n (\n | { status: \"completed\"; assessments: CanonicalSeverityAssessment[] }\n | {\n status: \"unresolved\";\n assessments: [];\n error: {\n recordId: string;\n code: \"review_failed\" | \"invalid_assessment\";\n message: string;\n };\n }\n );\n\nfunction sha256(value: string): string {\n return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n/**\n * Classify immutable host-provided reports. No filesystem, auth, local model,\n * repository access, retries, or persistence. The host owns those lifecycles.\n */\nexport async function classifySeverityRecords(\n input: ClassifySeverityRecordsInput,\n options: ClassifySeverityRecordsOptions,\n): Promise<ClassifySeverityRecordsResult> {\n options.signal?.throwIfAborted();\n const classificationRuns = classificationRunsSchema\n .default(3)\n .parse(options.classificationRuns);\n const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));\n const rubric = data.rubric ?? {\n revision: 1,\n markdown: defaultSeverityRubric,\n sha256: sha256(defaultSeverityRubric),\n };\n if (sha256(rubric.markdown) !== rubric.sha256)\n throw new Error(\"Rubric SHA-256 does not match its exact UTF-8 Markdown.\");\n const ids = new Set<string>();\n for (const record of data.records) {\n if (ids.has(record.id))\n throw new Error(\"Canonical record IDs must be unique.\");\n ids.add(record.id);\n if (sha256(record.findingJson) !== record.inputSha256)\n throw new Error(\"Finding SHA-256 does not match its exact UTF-8 JSON.\");\n const report = reportSchema.parse(JSON.parse(record.findingJson));\n if (report.findingId !== record.id)\n throw new Error(\n \"The report findingId must equal its canonical record ID.\",\n );\n }\n const binding: RecordsResultBinding = {\n classificationRuns,\n version: 1,\n rubric: { revision: rubric.revision, sha256: rubric.sha256 },\n };\n const assessments: CanonicalSeverityAssessment[] = [];\n for (const record of data.records) {\n options.signal?.throwIfAborted();\n let code: \"review_failed\" | \"invalid_assessment\" = \"review_failed\";\n try {\n const { findingId: _findingId, ...decision } = await reviewSeverity(\n async () => {\n code = \"review_failed\";\n const response = await abortable(() => {\n options.signal?.throwIfAborted();\n return options.reviewRunner.run(\n {\n requestId: randomUUID(),\n stage: \"severity-classification\",\n model: data.model,\n effort: data.effort,\n trustedInstructions: severityReviewInstructions,\n prompt: `{\"rubric\":${JSON.stringify([rubric.markdown])},\"knowledgeBase\":null,\"finding\":${record.findingJson}}`,\n schema: z.toJSONSchema(severityDecisionSchema),\n },\n { signal: options.signal },\n );\n }, options.signal);\n options.signal?.throwIfAborted();\n code = \"invalid_assessment\";\n return parseSeverityDecision(response, record.id);\n },\n classificationRuns,\n );\n options.signal?.throwIfAborted();\n assessments.push({\n ...decision,\n id: record.id,\n revision: record.revision,\n inputSha256: record.inputSha256,\n });\n } catch (error) {\n options.signal?.throwIfAborted();\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code,\n message:\n error instanceof Error\n ? error.message\n : code === \"review_failed\"\n ? \"Host review failed.\"\n : \"Invalid assessment.\",\n },\n };\n }\n }\n return { ...binding, status: \"completed\", assessments };\n}\n"]}
|
|
1
|
+
{"version":3,"file":"classify-severity-records.js","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"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","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.js\";\nimport { defaultSeverityRubric } from \"./default-severity-rubric.js\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { abortable } from \"./targets.js\";\nimport {\n parseSeverityDecision,\n reviewSeverity,\n reviewRunsOption,\n severityDecisionSchema,\n severityReviewInstructions,\n type SeverityDecision,\n} from \"./severity-review.js\";\n\nconst text = z\n .string()\n .refine((value) => value.trim().length > 0, \"Must not be blank.\");\nconst digest = z.string().regex(/^[a-f0-9]{64}$/u);\nconst revision = z.number().int().nonnegative();\nexport const severityRubricSnapshotSchema = z.strictObject({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n});\n\nconst reportSchema = z\n .object({\n findingId: text,\n title: text,\n summary: text,\n occurrenceId: text.optional(),\n severity: z\n .object({\n level: z.enum(SCAN_SEVERITIES),\n rationale: z.string().optional(),\n changeConditions: z.string().optional(),\n })\n .passthrough()\n .optional(),\n })\n .passthrough();\n\n/** Versioned input for repository-free classification of canonical records. */\nexport const classifySeverityRecordsInputSchema = z\n .object({\n version: z.literal(1),\n rubric: severityRubricSnapshotSchema.optional(),\n model: text,\n effort: z.string(),\n records: z.array(\n z\n .object({\n id: text,\n revision,\n findingJson: text,\n inputSha256: digest,\n })\n .strict(),\n ),\n })\n .strict();\n\nexport type ClassifySeverityRecordsInput = z.infer<\n typeof classifySeverityRecordsInputSchema\n>;\n\nexport interface SeverityClassificationReviewRequest {\n requestId: string;\n stage: \"severity-classification\";\n model: string;\n effort: ClassifySeverityRecordsInput[\"effort\"];\n trustedInstructions: string;\n prompt: string;\n schema: unknown;\n}\n\nexport interface ClassifySeverityRecordsOptions {\n /** Independent reviews per record: integer 1–10, default 3. */\n classificationRuns?: number;\n reviewRunner: {\n run(\n request: SeverityClassificationReviewRequest,\n options?: { signal?: AbortSignal },\n ): Promise<unknown>;\n };\n signal?: AbortSignal;\n}\n\nexport type CanonicalSeverityAssessment = Omit<\n SeverityDecision,\n \"findingId\"\n> & {\n id: string;\n revision: number;\n inputSha256: string;\n};\n\ninterface RecordsResultBinding {\n classificationRuns: number;\n version: 1;\n rubric: { revision: number; sha256: string };\n}\n\nexport type ClassifySeverityRecordsResult = RecordsResultBinding &\n (\n | { status: \"completed\"; assessments: CanonicalSeverityAssessment[] }\n | {\n status: \"unresolved\";\n assessments: [];\n error: {\n recordId: string;\n code: \"review_failed\" | \"invalid_assessment\";\n message: string;\n };\n }\n );\n\nfunction sha256(value: string): string {\n return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n/**\n * Classify immutable host-provided reports. No filesystem, auth, local model,\n * repository access, retries, or persistence. The host owns those lifecycles.\n */\nexport async function classifySeverityRecords(\n input: ClassifySeverityRecordsInput,\n options: ClassifySeverityRecordsOptions,\n): Promise<ClassifySeverityRecordsResult> {\n options.signal?.throwIfAborted();\n const classificationRuns = reviewRunsOption.parse(options.classificationRuns);\n const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));\n const rubric = data.rubric ?? {\n revision: 1,\n markdown: defaultSeverityRubric,\n sha256: sha256(defaultSeverityRubric),\n };\n if (sha256(rubric.markdown) !== rubric.sha256)\n throw new Error(\"Rubric SHA-256 does not match its exact UTF-8 Markdown.\");\n const ids = new Set<string>();\n for (const record of data.records) {\n if (ids.has(record.id))\n throw new Error(\"Canonical record IDs must be unique.\");\n ids.add(record.id);\n if (sha256(record.findingJson) !== record.inputSha256)\n throw new Error(\"Finding SHA-256 does not match its exact UTF-8 JSON.\");\n const report = reportSchema.parse(JSON.parse(record.findingJson));\n if (report.findingId !== record.id)\n throw new Error(\n \"The report findingId must equal its canonical record ID.\",\n );\n }\n const binding: RecordsResultBinding = {\n classificationRuns,\n version: 1,\n rubric: { revision: rubric.revision, sha256: rubric.sha256 },\n };\n const assessments: CanonicalSeverityAssessment[] = [];\n for (const record of data.records) {\n options.signal?.throwIfAborted();\n let code: \"review_failed\" | \"invalid_assessment\" = \"review_failed\";\n try {\n const { findingId: _findingId, ...decision } = await reviewSeverity(\n async () => {\n code = \"review_failed\";\n const response = await abortable(() => {\n options.signal?.throwIfAborted();\n return options.reviewRunner.run(\n {\n requestId: randomUUID(),\n stage: \"severity-classification\",\n model: data.model,\n effort: data.effort,\n trustedInstructions: severityReviewInstructions,\n prompt: `{\"rubric\":${JSON.stringify([rubric.markdown])},\"knowledgeBase\":null,\"finding\":${record.findingJson}}`,\n schema: z.toJSONSchema(severityDecisionSchema),\n },\n { signal: options.signal },\n );\n }, options.signal);\n options.signal?.throwIfAborted();\n code = \"invalid_assessment\";\n return parseSeverityDecision(response, record.id);\n },\n classificationRuns,\n );\n options.signal?.throwIfAborted();\n assessments.push({\n ...decision,\n id: record.id,\n revision: record.revision,\n inputSha256: record.inputSha256,\n });\n } catch (error) {\n options.signal?.throwIfAborted();\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code,\n message:\n error instanceof Error\n ? error.message\n : code === \"review_failed\"\n ? \"Host review failed.\"\n : \"Invalid assessment.\",\n },\n };\n }\n }\n return { ...binding, status: \"completed\", assessments };\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity.d.ts","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,IAAI,cAAc,
|
|
1
|
+
{"version":3,"file":"classify-severity.d.ts","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,IAAI,cAAc,EAMzC,MAAM,sBAAsB,CAAC;AAG9B,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,OAAO,EACP,WAAW,GAAG,OAAO,GAAG,SAAS,CAClC,GACC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAAC,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1B,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,oBAAoB,EAClB,QAAQ,GACR,aAAa,GACb,OAAO,GACP,iBAAiB,GACjB,QAAQ,GACR,kBAAkB,CACrB;IACC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAGxC;AAED,MAAM,WAAW,kBAAmB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;IACxE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB,GAAG,QAAQ,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2GAA2G;IAC3G,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AA0CD,yFAAyF;AACzF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,EAClD,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAEjC"}
|
|
@@ -6,7 +6,7 @@ import { CodexSecurityError } from "./errors.js";
|
|
|
6
6
|
import { workflowDigest } from "./finding-workflow.js";
|
|
7
7
|
import { readKnowledgeBaseDocuments } from "./knowledge-base.js";
|
|
8
8
|
import { runReadOnlyCodex, } from "./scan-comparison.js";
|
|
9
|
-
import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, reviewSeverity, classificationRunsSchema, } from "./severity-review.js";
|
|
9
|
+
import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, reviewSeverity, classificationRunsSchema, reviewRunsOption, } from "./severity-review.js";
|
|
10
10
|
import { CODEX_SECURITY_THREAD_SOURCES } from "./thread-source.js";
|
|
11
11
|
const textSchema = z
|
|
12
12
|
.string()
|
|
@@ -34,9 +34,7 @@ export async function classifySeverity(findings, options = {}) {
|
|
|
34
34
|
/** @internal */
|
|
35
35
|
export async function classifySeverityInternal(findings, options = {}, surface = "sdk", checkpoint) {
|
|
36
36
|
options.signal?.throwIfAborted();
|
|
37
|
-
const classificationRuns =
|
|
38
|
-
.default(3)
|
|
39
|
-
.parse(options.classificationRuns);
|
|
37
|
+
const classificationRuns = reviewRunsOption.parse(options.classificationRuns);
|
|
40
38
|
const ids = new Set();
|
|
41
39
|
for (const finding of findings) {
|
|
42
40
|
if (!finding.findingId?.trim() || ids.has(finding.findingId)) {
|