@openai/codex-security 0.8.2 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +201 -178
- package/_bundled_plugin/.app.json +4 -0
- package/_bundled_plugin/.mcp.json +6 -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 +51 -14
- 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/artifact-storage.md +1 -1
- package/_bundled_plugin/references/core-scan.md +14 -5
- package/_bundled_plugin/references/default-severity-rubric.md +33 -0
- package/_bundled_plugin/references/final-report.md +5 -3
- package/_bundled_plugin/references/finding-detail-fields.md +19 -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/references/threat-model.md +1 -0
- 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 +188 -454
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
- package/_bundled_plugin/scripts/finding_preview.py +25 -29
- 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 +198 -0
- package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
- package/_bundled_plugin/scripts/report_projection.py +167 -178
- 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 +9 -7
- package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
- 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 +38 -75
- 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 +152 -248
- 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 +121 -14
- package/_bundled_plugin/scripts/workbench_constants.py +19 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
- package/_bundled_plugin/scripts/workbench_db.py +550 -492
- 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 +90 -4
- package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
- 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 +508 -11
- package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
- package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
- package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
- package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
- package/_bundled_plugin/scripts/workbench_schema.py +44 -55
- package/_bundled_plugin/scripts/workbench_setup.py +251 -0
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
- package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
- package/_bundled_plugin/scripts/workbench_target.py +330 -66
- package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
- package/_bundled_plugin/scripts/workbench_validation.py +44 -12
- package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
- package/_bundled_plugin/shared/workbench-migrations.json +53 -0
- package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
- package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
- package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
- package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
- package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
- package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
- package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
- package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
- package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
- package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
- package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
- package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
- package/dist/api.d.ts +45 -5
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +1144 -411
- package/dist/api.js.map +1 -1
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +10 -7
- 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 +8 -0
- package/dist/blackduck-findings.d.ts.map +1 -0
- package/dist/blackduck-findings.js +320 -0
- package/dist/blackduck-findings.js.map +1 -0
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +51 -36
- 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 +6 -9
- package/dist/classify-severity-records.d.ts.map +1 -1
- package/dist/classify-severity-records.js +9 -21
- package/dist/classify-severity-records.js.map +1 -1
- package/dist/classify-severity.d.ts +4 -1
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +30 -13
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli.d.ts +14 -5
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +2112 -1266
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.js +2 -2
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codex-prompt.d.ts +2 -0
- package/dist/codex-prompt.d.ts.map +1 -1
- package/dist/codex-prompt.js +6 -0
- package/dist/codex-prompt.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 +32 -6
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts +2 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +221 -65
- package/dist/config.js.map +1 -1
- package/dist/continuum-findings.d.ts +7 -0
- package/dist/continuum-findings.d.ts.map +1 -0
- package/dist/continuum-findings.js +225 -0
- package/dist/continuum-findings.js.map +1 -0
- package/dist/contract-values.d.ts +30 -0
- package/dist/contract-values.d.ts.map +1 -0
- package/dist/contract-values.js +78 -0
- package/dist/contract-values.js.map +1 -0
- package/dist/contract.d.ts +2 -20
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +58 -669
- package/dist/contract.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 -115
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +61 -4
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +2560 -100
- 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/custom-validation-prompt.d.ts +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +5 -0
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/custom-validation.d.ts +2 -0
- package/dist/custom-validation.d.ts.map +1 -1
- package/dist/custom-validation.js +4 -0
- package/dist/custom-validation.js.map +1 -1
- package/dist/deduplication/deduplication-prompts.d.ts +4 -4
- package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
- package/dist/deduplication/deduplication-prompts.js +2 -2
- package/dist/deduplication/deduplication-prompts.js.map +1 -1
- package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
- package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
- package/dist/deduplication/deduplication-reviewer.js +11 -4
- package/dist/deduplication/deduplication-reviewer.js.map +1 -1
- package/dist/deduplication/deduplication.js.map +1 -1
- package/dist/deduplication/finding-schema.d.ts +19 -1
- package/dist/deduplication/finding-schema.d.ts.map +1 -1
- package/dist/deduplication/finding-schema.js +25 -0
- package/dist/deduplication/finding-schema.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 +5 -10
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/records.d.ts +8 -2
- package/dist/deduplication/records.d.ts.map +1 -1
- package/dist/deduplication/records.js +36 -8
- package/dist/deduplication/records.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 +13 -0
- package/dist/deep-scan.d.ts.map +1 -1
- package/dist/deep-scan.js +262 -7
- package/dist/deep-scan.js.map +1 -1
- package/dist/default-severity-rubric.d.ts +1 -2
- package/dist/default-severity-rubric.d.ts.map +1 -1
- package/dist/default-severity-rubric.js +2 -66
- 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 +108 -80
- 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 +9 -2
- 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 +11 -16
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +15 -4
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +619 -225
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +20 -6
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +2356 -308
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +28 -2
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +174 -81
- package/dist/external-findings-read.js.map +1 -1
- package/dist/external-findings.d.ts +17 -3
- package/dist/external-findings.d.ts.map +1 -1
- package/dist/external-findings.js +153 -1
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +33 -1
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +335 -51
- 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/finding-retrieval.d.ts +3 -3
- package/dist/finding-retrieval.d.ts.map +1 -1
- package/dist/finding-retrieval.js.map +1 -1
- package/dist/finding-workflow.d.ts +6 -1
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +2 -2
- package/dist/finding-workflow.js.map +1 -1
- 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/git-remote.d.ts +4 -0
- package/dist/git-remote.d.ts.map +1 -1
- package/dist/git-remote.js +20 -0
- package/dist/git-remote.js.map +1 -1
- package/dist/github-advisories.d.ts +3 -12
- package/dist/github-advisories.d.ts.map +1 -1
- package/dist/github-advisories.js +9 -31
- package/dist/github-advisories.js.map +1 -1
- package/dist/github-dependabot-findings.d.ts.map +1 -1
- package/dist/github-dependabot-findings.js +22 -20
- 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 +392 -79
- package/dist/github-findings.js.map +1 -1
- package/dist/github.d.ts +17 -7
- package/dist/github.d.ts.map +1 -1
- package/dist/github.js +43 -30
- package/dist/github.js.map +1 -1
- package/dist/host-protocol.d.ts +2 -2
- package/dist/host-protocol.d.ts.map +1 -1
- package/dist/host-protocol.js.map +1 -1
- package/dist/host-records-protocol.d.ts +10 -11
- package/dist/host-records-protocol.d.ts.map +1 -1
- package/dist/host-records-protocol.js +69 -9
- package/dist/host-records-protocol.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 +15 -0
- package/dist/hosted-scan.d.ts.map +1 -1
- package/dist/hosted-scan.js +71 -44
- 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 +24 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +15 -1
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +58 -81
- package/dist/inspector-findings.js.map +1 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +86 -10
- package/dist/knowledge-base.js.map +1 -1
- package/dist/local-git-metadata.d.ts +5 -0
- package/dist/local-git-metadata.d.ts.map +1 -0
- package/dist/local-git-metadata.js +130 -0
- package/dist/local-git-metadata.js.map +1 -0
- package/dist/multiscan.d.ts +6 -4
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +160 -77
- 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 +49 -31
- 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/patch-tui.d.ts.map +1 -1
- package/dist/patch-tui.js +90 -35
- package/dist/patch-tui.js.map +1 -1
- 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 +341 -0
- package/dist/private-finding-import.d.ts.map +1 -0
- package/dist/private-finding-import.js +411 -0
- package/dist/private-finding-import.js.map +1 -0
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +2 -2
- package/dist/project-config.js.map +1 -1
- package/dist/provider-profile.d.ts +11 -3
- package/dist/provider-profile.d.ts.map +1 -1
- package/dist/provider-profile.js +80 -11
- 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/publication.js +7 -1
- package/dist/publication.js.map +1 -1
- 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 +15 -0
- package/dist/reader-selection.d.ts.map +1 -0
- package/dist/reader-selection.js +89 -0
- package/dist/reader-selection.js.map +1 -0
- package/dist/record.d.ts +6 -1
- package/dist/record.d.ts.map +1 -1
- package/dist/record.js +53 -2
- package/dist/record.js.map +1 -1
- package/dist/remediation.d.ts +3 -1
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +28 -2
- 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 +6 -0
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +3 -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 +22 -1
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +408 -162
- 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 +172 -64
- 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 +68 -25
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +7 -6
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +91 -79
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts +12 -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 +31 -28
- 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 +64 -6
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +406 -48
- package/dist/scanner-import.js.map +1 -1
- package/dist/scanner-repository-url.d.ts +17 -0
- package/dist/scanner-repository-url.d.ts.map +1 -0
- package/dist/scanner-repository-url.js +71 -0
- package/dist/scanner-repository-url.js.map +1 -0
- 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 +124 -88
- 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 +213 -0
- package/dist/semgrep-platform-findings.d.ts.map +1 -0
- package/dist/semgrep-platform-findings.js +1078 -0
- package/dist/semgrep-platform-findings.js.map +1 -0
- 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/severity-rubric.d.ts +20 -0
- package/dist/severity-rubric.d.ts.map +1 -0
- package/dist/severity-rubric.js +73 -0
- package/dist/severity-rubric.js.map +1 -0
- package/dist/severity-store.js +15 -5
- package/dist/severity-store.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 +108 -84
- 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 +16 -0
- package/dist/sonar-collector.d.ts.map +1 -0
- package/dist/sonar-collector.js +380 -0
- package/dist/sonar-collector.js.map +1 -0
- package/dist/sonar-findings.d.ts +49 -0
- package/dist/sonar-findings.d.ts.map +1 -0
- package/dist/sonar-findings.js +288 -0
- package/dist/sonar-findings.js.map +1 -0
- package/dist/sonar-import.d.ts +111 -0
- package/dist/sonar-import.d.ts.map +1 -0
- package/dist/sonar-import.js +277 -0
- package/dist/sonar-import.js.map +1 -0
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +2 -1
- package/dist/suggest-owners.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 +5 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +73 -31
- 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-columns.d.ts +4 -0
- package/dist/terminal-columns.d.ts.map +1 -0
- package/dist/terminal-columns.js +19 -0
- package/dist/terminal-columns.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.d.ts +0 -3
- package/dist/validation-records.d.ts.map +1 -1
- package/dist/validation-records.js +1 -17
- package/dist/validation-records.js.map +1 -1
- package/dist/veracode-findings.d.ts +9 -0
- package/dist/veracode-findings.d.ts.map +1 -0
- package/dist/veracode-findings.js +409 -0
- package/dist/veracode-findings.js.map +1 -0
- 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 +27 -1
- package/dist/windows-path.js.map +1 -1
- package/dist/wiz-csv.d.ts +2 -2
- package/dist/wiz-csv.d.ts.map +1 -1
- package/dist/wiz-csv.js +1 -3
- package/dist/wiz-csv.js.map +1 -1
- package/dist/wiz-findings.d.ts +14 -2
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +143 -50
- package/dist/wiz-findings.js.map +1 -1
- package/docs/classify-severity-records.md +28 -13
- package/docs/cli.md +623 -843
- package/docs/dedupe-records.md +54 -24
- package/docs/findings-service.md +87 -47
- package/docs/hosted-remediation.md +14 -7
- package/docs/hosted-scans.md +64 -41
- package/docs/telemetry.md +236 -0
- package/docs/validate-records.md +78 -44
- package/package.json +19 -17
- package/schemas/external-findings.schema.json +14 -1
- package/schemas/hosted-scan-v2.fixture.json +16 -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/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
- package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
- package/dist/deduplication/records-protocol.d.ts +0 -4
- package/dist/deduplication/records-protocol.d.ts.map +0 -1
- package/dist/deduplication/records-protocol.js +0 -49
- package/dist/deduplication/records-protocol.js.map +0 -1
- 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 -120
- package/dist/finding-normalization.js.map +0 -1
|
@@ -0,0 +1,320 @@
|
|
|
1
|
+
import { CodexSecurityError } from "./errors.js";
|
|
2
|
+
import { validateEnrichedExternalEvidence, } from "./external-import-contract.js";
|
|
3
|
+
import { canonicalJson, isRecord } from "./record.js";
|
|
4
|
+
import { array, normalizeRecords, readScannerJson, record, reportableScannerSeverity, requiredText, stableId, text, } from "./scanner-import.js";
|
|
5
|
+
import { declaredScannerRepositoryUrl, repositoryScopeValidator, } from "./scanner-repository-url.js";
|
|
6
|
+
const format = "blackduck-bom-6";
|
|
7
|
+
const componentVersionPath = /^components\/[^/]+\/versions\/[^/]+$/u;
|
|
8
|
+
const nativeId = /^blackduck-bom:[a-f0-9]{64}$/u;
|
|
9
|
+
export function projectedBlackDuckRepositoryUrl(finding, target) {
|
|
10
|
+
if (!nativeId.test(finding.source_finding_id))
|
|
11
|
+
return;
|
|
12
|
+
const url = finding.evidence.source_data?.["sourceRepositoryUrl"];
|
|
13
|
+
if (typeof url === "string")
|
|
14
|
+
return declaredScannerRepositoryUrl(url, "Black Duck", target);
|
|
15
|
+
return finding.evidence.details?.repository?.url ?? undefined;
|
|
16
|
+
}
|
|
17
|
+
function hasBlackDuckEvidence(data) {
|
|
18
|
+
if (!isRecord(data))
|
|
19
|
+
return false;
|
|
20
|
+
return (data["format"] === format ||
|
|
21
|
+
[data, data["row"]].some((row) => {
|
|
22
|
+
if (!isRecord(row) || !isRecord(row["vulnerabilityWithRemediation"]))
|
|
23
|
+
return false;
|
|
24
|
+
const resource = parseApiResource(text(row["componentVersion"]));
|
|
25
|
+
return resource !== undefined && componentVersionPath.test(resource.path);
|
|
26
|
+
}));
|
|
27
|
+
}
|
|
28
|
+
function retainedRepository(provider, finding, target) {
|
|
29
|
+
const { source_finding_id: id, evidence: { source_data: data }, } = finding;
|
|
30
|
+
const nativeEvidence = hasBlackDuckEvidence(data);
|
|
31
|
+
if (provider !== "blackduck") {
|
|
32
|
+
if (nativeEvidence)
|
|
33
|
+
throw new CodexSecurityError("Retained Black Duck evidence requires the blackduck provider.");
|
|
34
|
+
const url = projectedBlackDuckRepositoryUrl(finding, target);
|
|
35
|
+
return url ? { url } : undefined;
|
|
36
|
+
}
|
|
37
|
+
const native = nativeEvidence || nativeId.test(id);
|
|
38
|
+
if (native && (!isRecord(data) || !isRecord(data["row"])))
|
|
39
|
+
throw new Error("Expected retained Black Duck BOM occurrence evidence.");
|
|
40
|
+
if (!isRecord(data) || (!native && !("sourceRepositoryUrl" in data)))
|
|
41
|
+
return;
|
|
42
|
+
const url = declaredScannerRepositoryUrl(data["sourceRepositoryUrl"], "Black Duck", target);
|
|
43
|
+
if (!native)
|
|
44
|
+
return { url };
|
|
45
|
+
const resource = apiResource(data["projectVersionUrl"], "retained project-version URL");
|
|
46
|
+
if (!/^projects\/[^/]+\/versions\/[^/]+$/u.test(resource.path) ||
|
|
47
|
+
resource.query.size)
|
|
48
|
+
throw new Error("Invalid retained Black Duck project-version URL.");
|
|
49
|
+
const projectVersion = `${resource.base}/${resource.path}`;
|
|
50
|
+
const actual = occurrenceId(scopedRow(data["row"], projectVersion, false), projectVersion);
|
|
51
|
+
if (id !== actual)
|
|
52
|
+
throw new Error("Black Duck source finding ID contradicts the retained native occurrence.");
|
|
53
|
+
return { url, scope: projectVersion };
|
|
54
|
+
}
|
|
55
|
+
export const blackDuckReportRepositories = repositoryScopeValidator({ provider: "blackduck", label: "Black Duck", scope: "project version" }, retainedRepository);
|
|
56
|
+
function parseApiResource(href) {
|
|
57
|
+
const url = href && URL.parse(href);
|
|
58
|
+
const parts = url && /^(.*\/api)\/(.+?)\/?$/u.exec(url.pathname);
|
|
59
|
+
if (!url ||
|
|
60
|
+
!parts ||
|
|
61
|
+
!["http:", "https:"].includes(url.protocol) ||
|
|
62
|
+
url.username ||
|
|
63
|
+
url.password ||
|
|
64
|
+
url.hash)
|
|
65
|
+
return;
|
|
66
|
+
return {
|
|
67
|
+
base: url.origin + parts[1],
|
|
68
|
+
path: parts[2],
|
|
69
|
+
query: url.searchParams,
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
function apiResource(href, label) {
|
|
73
|
+
const resource = parseApiResource(requiredText(href, label));
|
|
74
|
+
if (!resource)
|
|
75
|
+
throw new Error(`Expected a credential-free Black Duck API URL for ${label}.`);
|
|
76
|
+
return resource;
|
|
77
|
+
}
|
|
78
|
+
function links(meta) {
|
|
79
|
+
if (meta === undefined)
|
|
80
|
+
return [];
|
|
81
|
+
const value = record(meta, "Black Duck _meta")["links"];
|
|
82
|
+
return value === undefined
|
|
83
|
+
? []
|
|
84
|
+
: array(value, "Black Duck _meta.links").map((entry) => record(entry, "Black Duck link"));
|
|
85
|
+
}
|
|
86
|
+
function collectionScope(collection) {
|
|
87
|
+
const meta = record(collection["_meta"], "Black Duck collection _meta");
|
|
88
|
+
const resource = apiResource(meta["href"], "collection href");
|
|
89
|
+
const project = /^projects?\/([^/]+)\/versions\/([^/]+)\/vulnerable-bom-components$/u.exec(resource.path);
|
|
90
|
+
if (!project)
|
|
91
|
+
throw new Error("Expected a Black Duck project-version vulnerable-bom-components collection.");
|
|
92
|
+
if (resource.query.getAll("offset").some((offset) => !/^0+$/u.test(offset)) ||
|
|
93
|
+
links(meta).some((link) => ["next", "prev", "previous"].includes(String(link["rel"]))))
|
|
94
|
+
throw new Error("Incomplete Black Duck collection page. Supply a complete export or explicitly selected rows.");
|
|
95
|
+
return `${resource.base}/projects/${project[1]}/versions/${project[2]}`;
|
|
96
|
+
}
|
|
97
|
+
function projectReference(href, relation) {
|
|
98
|
+
const label = relation === "remediation" ? "remediation URL" : "matched-files link";
|
|
99
|
+
const resource = apiResource(href, label);
|
|
100
|
+
const match = /^(projects\/[^/]+\/versions\/[^/]+)\/(components\/[^/]+\/versions\/[^/]+)(?:\/origins\/([^/]+))?\/(matched-files|vulnerabilities\/[^/]+\/remediation)$/u.exec(resource.path);
|
|
101
|
+
if (!match || !match[4].endsWith(relation))
|
|
102
|
+
throw new Error(`Invalid Black Duck project-version ${label}.`);
|
|
103
|
+
return {
|
|
104
|
+
scope: `${resource.base}/${match[1]}`,
|
|
105
|
+
component: `${resource.base}/${match[2]}`,
|
|
106
|
+
origin: match[3],
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
function scopedRow(value, scope, selected) {
|
|
110
|
+
const row = isRecord(value) ? value : {};
|
|
111
|
+
const meta = row["_meta"];
|
|
112
|
+
const declared = isRecord(meta) ? meta["links"] : undefined;
|
|
113
|
+
const matched = (Array.isArray(declared) ? declared : [])
|
|
114
|
+
.filter((link) => isRecord(link) && link["rel"] === "matched-files")
|
|
115
|
+
.map((link) => projectReference(link["href"], "matched-files"));
|
|
116
|
+
if (isRecord(meta) && meta["href"] !== undefined)
|
|
117
|
+
matched.push(projectReference(meta["href"], "remediation"));
|
|
118
|
+
if (selected && !matched.length)
|
|
119
|
+
throw new Error("Each selected Black Duck row must identify its project version with a remediation or matched-files link.");
|
|
120
|
+
for (const reference of matched) {
|
|
121
|
+
if (scope !== undefined && scope !== reference.scope)
|
|
122
|
+
throw new Error("Black Duck rows must belong to the same project version and server as the collection or selection.");
|
|
123
|
+
scope = reference.scope;
|
|
124
|
+
}
|
|
125
|
+
const vulnerability = row["vulnerabilityWithRemediation"];
|
|
126
|
+
return {
|
|
127
|
+
row,
|
|
128
|
+
matched,
|
|
129
|
+
scope,
|
|
130
|
+
// Shape errors are row exclusions; project-scope errors abort the report.
|
|
131
|
+
get vulnerability() {
|
|
132
|
+
record(value, "Black Duck BOM component");
|
|
133
|
+
return record(vulnerability, "Black Duck vulnerabilityWithRemediation");
|
|
134
|
+
},
|
|
135
|
+
};
|
|
136
|
+
}
|
|
137
|
+
function occurrenceId({ row, vulnerability, matched }, projectVersion) {
|
|
138
|
+
const resource = apiResource(row["componentVersion"], "componentVersion");
|
|
139
|
+
const component = `${resource.base}/${resource.path}`;
|
|
140
|
+
if (!componentVersionPath.test(resource.path) ||
|
|
141
|
+
resource.base !==
|
|
142
|
+
projectVersion.slice(0, projectVersion.lastIndexOf("/projects/")))
|
|
143
|
+
throw new Error("Black Duck componentVersion must identify a component version on the same server.");
|
|
144
|
+
const origins = new Set();
|
|
145
|
+
for (const reference of matched) {
|
|
146
|
+
if (reference.component !== component)
|
|
147
|
+
throw new Error("Black Duck project-version link contradicts componentVersion.");
|
|
148
|
+
if (reference.origin)
|
|
149
|
+
origins.add(reference.origin);
|
|
150
|
+
}
|
|
151
|
+
for (const link of links(row["_meta"]).filter((entry) => entry["rel"] === "vulnerabilities")) {
|
|
152
|
+
const reference = apiResource(link["href"], "vulnerabilities link");
|
|
153
|
+
const match = /^(components\/[^/]+\/versions\/[^/]+)(?:\/origin\/([^/]+))?\/vulnerabilities$/u.exec(reference.path);
|
|
154
|
+
if (!match)
|
|
155
|
+
continue;
|
|
156
|
+
if (`${reference.base}/${match[1]}` !== component)
|
|
157
|
+
throw new Error("Black Duck vulnerabilities link contradicts componentVersion.");
|
|
158
|
+
if (match[2])
|
|
159
|
+
origins.add(match[2]);
|
|
160
|
+
}
|
|
161
|
+
const [origin] = origins;
|
|
162
|
+
if (!origin || origins.size !== 1)
|
|
163
|
+
throw new Error("Black Duck row must identify one unambiguous component-version origin.");
|
|
164
|
+
const source = requiredText(vulnerability["source"], "Black Duck advisory source");
|
|
165
|
+
if (source !== "BDSA" && source !== "NVD")
|
|
166
|
+
throw new Error(`Unsupported Black Duck advisory source: ${source}.`);
|
|
167
|
+
return stableId("blackduck-bom", [
|
|
168
|
+
projectVersion,
|
|
169
|
+
component,
|
|
170
|
+
origin,
|
|
171
|
+
source,
|
|
172
|
+
requiredText(vulnerability["vulnerabilityName"], "Black Duck vulnerability name"),
|
|
173
|
+
]);
|
|
174
|
+
}
|
|
175
|
+
const nameVersionForges = new Map([
|
|
176
|
+
["npmjs", "npm"],
|
|
177
|
+
["pypi", "pypi"],
|
|
178
|
+
["nuget", "nuget"],
|
|
179
|
+
["rubygems", "gem"],
|
|
180
|
+
["crates", "cargo"],
|
|
181
|
+
]);
|
|
182
|
+
function packageUrlName(ecosystem, parts) {
|
|
183
|
+
if (parts.some((part) => !part || part.includes("/")))
|
|
184
|
+
return;
|
|
185
|
+
if (ecosystem === "github" && parts.length === 2)
|
|
186
|
+
return parts.join("/").toLowerCase();
|
|
187
|
+
if (ecosystem === "maven" || ecosystem === "composer")
|
|
188
|
+
return parts.length === 2
|
|
189
|
+
? parts.join(ecosystem === "maven" ? ":" : "/")
|
|
190
|
+
: undefined;
|
|
191
|
+
if (parts.length === 1 ||
|
|
192
|
+
ecosystem === "golang" ||
|
|
193
|
+
ecosystem === "generic" ||
|
|
194
|
+
(parts.length === 2 && ecosystem === "npm" && parts[0].startsWith("@")))
|
|
195
|
+
return parts.join("/");
|
|
196
|
+
}
|
|
197
|
+
function originPackage(row) {
|
|
198
|
+
const origin = text(row["componentVersionOriginName"])?.toLowerCase();
|
|
199
|
+
const id = text(row["componentVersionOriginId"]) ?? "";
|
|
200
|
+
if (origin === "maven") {
|
|
201
|
+
const coordinate = /^([^:\s/]+:[^:\s/]+):([^:\s/]+)$/u.exec(id);
|
|
202
|
+
if (coordinate)
|
|
203
|
+
return {
|
|
204
|
+
name: coordinate[1],
|
|
205
|
+
ecosystem: origin,
|
|
206
|
+
installed_version: coordinate[2],
|
|
207
|
+
};
|
|
208
|
+
}
|
|
209
|
+
const ecosystem = nameVersionForges.get(origin ?? "");
|
|
210
|
+
if (ecosystem) {
|
|
211
|
+
const coordinate = /^(?:(@[^/\s]+)\/)?([^/\s]+)\/([^/\s]+)$/u.exec(id);
|
|
212
|
+
if (coordinate && (!coordinate[1] || ecosystem === "npm"))
|
|
213
|
+
return {
|
|
214
|
+
name: id.slice(0, id.lastIndexOf("/")),
|
|
215
|
+
ecosystem,
|
|
216
|
+
installed_version: coordinate[3],
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
function blackDuckPackages(row) {
|
|
221
|
+
const origin = originPackage(row);
|
|
222
|
+
const fallback = origin ? [origin] : [];
|
|
223
|
+
const purl = /^pkg:([a-z][a-z0-9.+-]*)\/((?:@[^/@?#]+\/)?[^@?#]+)(?:@([^@?#]+))?(?:[?#].*)?$/iu.exec(text(row["packageUrl"]) ?? "");
|
|
224
|
+
if (purl) {
|
|
225
|
+
try {
|
|
226
|
+
const ecosystem = purl[1].toLowerCase();
|
|
227
|
+
const name = packageUrlName(ecosystem, purl[2].split("/").map(decodeURIComponent));
|
|
228
|
+
if (name) {
|
|
229
|
+
if (!purl[3] && origin?.ecosystem === ecosystem && origin.name === name)
|
|
230
|
+
return { packages: fallback };
|
|
231
|
+
const pkg = {
|
|
232
|
+
name,
|
|
233
|
+
ecosystem,
|
|
234
|
+
installed_version: purl[3]
|
|
235
|
+
? decodeURIComponent(purl[3])
|
|
236
|
+
: text(row["componentVersionName"]),
|
|
237
|
+
};
|
|
238
|
+
// Earlier versions used the origin fallback for owner/repository PURLs.
|
|
239
|
+
return ecosystem === "github" && name.includes("/")
|
|
240
|
+
? { packages: fallback, enrichment: { packages: [pkg] } }
|
|
241
|
+
: { packages: [pkg] };
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
catch {
|
|
245
|
+
// A malformed escape does not invalidate the native origin coordinate.
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
return { packages: fallback };
|
|
249
|
+
}
|
|
250
|
+
function normalizeReport(input, sourceRepositoryUrl, target, previous) {
|
|
251
|
+
const repository = declaredScannerRepositoryUrl(sourceRepositoryUrl, "Black Duck", target);
|
|
252
|
+
const selected = Array.isArray(input);
|
|
253
|
+
let scope;
|
|
254
|
+
let items;
|
|
255
|
+
if (selected) {
|
|
256
|
+
items = input;
|
|
257
|
+
}
|
|
258
|
+
else {
|
|
259
|
+
const collection = record(input, "Black Duck collection");
|
|
260
|
+
items = array(collection["items"], "Black Duck items");
|
|
261
|
+
scope = collectionScope(collection);
|
|
262
|
+
if (collection["totalCount"] !== items.length)
|
|
263
|
+
throw new Error("Incomplete Black Duck collection: totalCount must equal the number of items. Supply a complete export or explicitly selected rows.");
|
|
264
|
+
}
|
|
265
|
+
const rows = items.map((value) => {
|
|
266
|
+
const entry = scopedRow(value, scope, selected);
|
|
267
|
+
scope = entry.scope;
|
|
268
|
+
return entry;
|
|
269
|
+
});
|
|
270
|
+
if (!scope)
|
|
271
|
+
throw new Error("An empty Black Duck selection cannot identify a project version. Supply its complete collection envelope.");
|
|
272
|
+
const projectVersion = scope;
|
|
273
|
+
const result = normalizeRecords(rows, ({ row, vulnerability }) => {
|
|
274
|
+
const advisory = requiredText(vulnerability["vulnerabilityName"], "Black Duck vulnerability name");
|
|
275
|
+
const name = requiredText(row["componentName"], "Black Duck component name");
|
|
276
|
+
const related = text(vulnerability["relatedVulnerability"]);
|
|
277
|
+
const { packages, enrichment } = blackDuckPackages(row);
|
|
278
|
+
return validateEnrichedExternalEvidence({
|
|
279
|
+
title: `${advisory} in ${name}`,
|
|
280
|
+
description: text(vulnerability["description"]),
|
|
281
|
+
severity: reportableScannerSeverity(vulnerability["severity"]),
|
|
282
|
+
advisory_ids: related && related !== advisory ? [advisory, related] : [advisory],
|
|
283
|
+
packages,
|
|
284
|
+
source_data: {
|
|
285
|
+
format,
|
|
286
|
+
sourceRepositoryUrl: repository,
|
|
287
|
+
projectVersionUrl: projectVersion,
|
|
288
|
+
row: structuredClone(row),
|
|
289
|
+
},
|
|
290
|
+
}, target, previous ? undefined : enrichment);
|
|
291
|
+
}, (entry) => occurrenceId(entry, projectVersion), target);
|
|
292
|
+
if (!selected) {
|
|
293
|
+
// normalizeRecords excludes every collision. An unidentified row can also
|
|
294
|
+
// repeat across pages, so compare its original JSON when it has no ID.
|
|
295
|
+
const seen = new Set();
|
|
296
|
+
for (const excluded of result.excluded) {
|
|
297
|
+
const key = excluded.source_finding_id ??
|
|
298
|
+
canonicalJson(items[excluded.position - 1]);
|
|
299
|
+
if (seen.has(key))
|
|
300
|
+
throw new CodexSecurityError("Duplicate row in a collection with a declared total; pages may overlap. Retrieve the complete export again.");
|
|
301
|
+
seen.add(key);
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
return result;
|
|
305
|
+
}
|
|
306
|
+
export function normalizeBlackDuckFindings(input, sourceRepositoryUrl, target = "cloud") {
|
|
307
|
+
return normalizeReport(input, sourceRepositoryUrl, target, false);
|
|
308
|
+
}
|
|
309
|
+
/** @internal Earlier readers used the native origin fallback for GitHub package URLs. */
|
|
310
|
+
export function needsPreviousBlackDuckProjection({ findings, }) {
|
|
311
|
+
return findings.some(({ evidence }) => evidence.packages?.some((pkg) => pkg.ecosystem === "github" && pkg.name.includes("/")));
|
|
312
|
+
}
|
|
313
|
+
/** @internal Reconstruct the original evidence for an interrupted Cloud request. */
|
|
314
|
+
export function normalizePreviousBlackDuckFindings(input, sourceRepositoryUrl, target = "cloud") {
|
|
315
|
+
return normalizeReport(input, sourceRepositoryUrl, target, true);
|
|
316
|
+
}
|
|
317
|
+
export async function readBlackDuckFindings(path, sourceRepositoryUrl, target = "cloud") {
|
|
318
|
+
return normalizeBlackDuckFindings(await readScannerJson(path), sourceRepositoryUrl, target);
|
|
319
|
+
}
|
|
320
|
+
//# sourceMappingURL=blackduck-findings.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"blackduck-findings.js","sourceRoot":"","sources":["../src/blackduck-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport type { Provider } from \"./external-import-models.js\";\nimport {\n type ExternalImportTarget,\n validateEnrichedExternalEvidence,\n} from \"./external-import-contract.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport { canonicalJson, isRecord } from \"./record.js\";\nimport {\n array,\n normalizeRecords,\n readScannerJson,\n record,\n reportableScannerSeverity,\n requiredText,\n stableId,\n text,\n} from \"./scanner-import.js\";\nimport {\n declaredScannerRepositoryUrl,\n repositoryScopeValidator,\n} from \"./scanner-repository-url.js\";\n\nconst format = \"blackduck-bom-6\";\nconst componentVersionPath = /^components\\/[^/]+\\/versions\\/[^/]+$/u;\nconst nativeId = /^blackduck-bom:[a-f0-9]{64}$/u;\n\nexport function projectedBlackDuckRepositoryUrl(\n finding: ExternalFinding,\n target: ExternalImportTarget,\n): string | undefined {\n if (!nativeId.test(finding.source_finding_id)) return;\n const url = finding.evidence.source_data?.[\"sourceRepositoryUrl\"];\n if (typeof url === \"string\")\n return declaredScannerRepositoryUrl(url, \"Black Duck\", target);\n return finding.evidence.details?.repository?.url ?? undefined;\n}\n\nfunction hasBlackDuckEvidence(data: unknown): boolean {\n if (!isRecord(data)) return false;\n return (\n data[\"format\"] === format ||\n [data, data[\"row\"]].some((row) => {\n if (!isRecord(row) || !isRecord(row[\"vulnerabilityWithRemediation\"]))\n return false;\n const resource = parseApiResource(text(row[\"componentVersion\"]));\n return resource !== undefined && componentVersionPath.test(resource.path);\n })\n );\n}\n\nfunction retainedRepository(\n provider: Provider,\n finding: ExternalFinding,\n target: ExternalImportTarget,\n): { url: string; scope?: string } | undefined {\n const {\n source_finding_id: id,\n evidence: { source_data: data },\n } = finding;\n const nativeEvidence = hasBlackDuckEvidence(data);\n if (provider !== \"blackduck\") {\n if (nativeEvidence)\n throw new CodexSecurityError(\n \"Retained Black Duck evidence requires the blackduck provider.\",\n );\n const url = projectedBlackDuckRepositoryUrl(finding, target);\n return url ? { url } : undefined;\n }\n const native = nativeEvidence || nativeId.test(id);\n if (native && (!isRecord(data) || !isRecord(data[\"row\"])))\n throw new Error(\"Expected retained Black Duck BOM occurrence evidence.\");\n if (!isRecord(data) || (!native && !(\"sourceRepositoryUrl\" in data))) return;\n const url = declaredScannerRepositoryUrl(\n data[\"sourceRepositoryUrl\"],\n \"Black Duck\",\n target,\n );\n if (!native) return { url };\n const resource = apiResource(\n data[\"projectVersionUrl\"],\n \"retained project-version URL\",\n );\n if (\n !/^projects\\/[^/]+\\/versions\\/[^/]+$/u.test(resource.path) ||\n resource.query.size\n )\n throw new Error(\"Invalid retained Black Duck project-version URL.\");\n const projectVersion = `${resource.base}/${resource.path}`;\n const actual = occurrenceId(\n scopedRow(data[\"row\"], projectVersion, false),\n projectVersion,\n );\n if (id !== actual)\n throw new Error(\n \"Black Duck source finding ID contradicts the retained native occurrence.\",\n );\n return { url, scope: projectVersion };\n}\n\nexport const blackDuckReportRepositories = repositoryScopeValidator(\n { provider: \"blackduck\", label: \"Black Duck\", scope: \"project version\" },\n retainedRepository,\n);\n\nfunction parseApiResource(href: string | null) {\n const url = href && URL.parse(href);\n const parts = url && /^(.*\\/api)\\/(.+?)\\/?$/u.exec(url.pathname);\n if (\n !url ||\n !parts ||\n ![\"http:\", \"https:\"].includes(url.protocol) ||\n url.username ||\n url.password ||\n url.hash\n )\n return;\n return {\n base: url.origin + parts[1],\n path: parts[2]!,\n query: url.searchParams,\n };\n}\n\nfunction apiResource(href: unknown, label: string) {\n const resource = parseApiResource(requiredText(href, label));\n if (!resource)\n throw new Error(\n `Expected a credential-free Black Duck API URL for ${label}.`,\n );\n return resource;\n}\n\nfunction links(meta: unknown): Record<string, unknown>[] {\n if (meta === undefined) return [];\n const value = record(meta, \"Black Duck _meta\")[\"links\"];\n return value === undefined\n ? []\n : array(value, \"Black Duck _meta.links\").map((entry) =>\n record(entry, \"Black Duck link\"),\n );\n}\n\nfunction collectionScope(collection: Record<string, unknown>) {\n const meta = record(collection[\"_meta\"], \"Black Duck collection _meta\");\n const resource = apiResource(meta[\"href\"], \"collection href\");\n const project =\n /^projects?\\/([^/]+)\\/versions\\/([^/]+)\\/vulnerable-bom-components$/u.exec(\n resource.path,\n );\n if (!project)\n throw new Error(\n \"Expected a Black Duck project-version vulnerable-bom-components collection.\",\n );\n if (\n resource.query.getAll(\"offset\").some((offset) => !/^0+$/u.test(offset)) ||\n links(meta).some((link) =>\n [\"next\", \"prev\", \"previous\"].includes(String(link[\"rel\"])),\n )\n )\n throw new Error(\n \"Incomplete Black Duck collection page. Supply a complete export or explicitly selected rows.\",\n );\n return `${resource.base}/projects/${project[1]}/versions/${project[2]}`;\n}\n\nfunction projectReference(\n href: unknown,\n relation: \"remediation\" | \"matched-files\",\n) {\n const label =\n relation === \"remediation\" ? \"remediation URL\" : \"matched-files link\";\n const resource = apiResource(href, label);\n const match =\n /^(projects\\/[^/]+\\/versions\\/[^/]+)\\/(components\\/[^/]+\\/versions\\/[^/]+)(?:\\/origins\\/([^/]+))?\\/(matched-files|vulnerabilities\\/[^/]+\\/remediation)$/u.exec(\n resource.path,\n );\n if (!match || !match[4]!.endsWith(relation))\n throw new Error(`Invalid Black Duck project-version ${label}.`);\n return {\n scope: `${resource.base}/${match[1]}`,\n component: `${resource.base}/${match[2]}`,\n origin: match[3],\n };\n}\n\nfunction scopedRow(\n value: unknown,\n scope: string | undefined,\n selected: boolean,\n) {\n const row = isRecord(value) ? value : {};\n const meta = row[\"_meta\"];\n const declared = isRecord(meta) ? meta[\"links\"] : undefined;\n const matched = (Array.isArray(declared) ? declared : [])\n .filter(\n (link): link is Record<string, unknown> =>\n isRecord(link) && link[\"rel\"] === \"matched-files\",\n )\n .map((link) => projectReference(link[\"href\"], \"matched-files\"));\n if (isRecord(meta) && meta[\"href\"] !== undefined)\n matched.push(projectReference(meta[\"href\"], \"remediation\"));\n if (selected && !matched.length)\n throw new Error(\n \"Each selected Black Duck row must identify its project version with a remediation or matched-files link.\",\n );\n for (const reference of matched) {\n if (scope !== undefined && scope !== reference.scope)\n throw new Error(\n \"Black Duck rows must belong to the same project version and server as the collection or selection.\",\n );\n scope = reference.scope;\n }\n const vulnerability = row[\"vulnerabilityWithRemediation\"];\n return {\n row,\n matched,\n scope,\n // Shape errors are row exclusions; project-scope errors abort the report.\n get vulnerability() {\n record(value, \"Black Duck BOM component\");\n return record(vulnerability, \"Black Duck vulnerabilityWithRemediation\");\n },\n };\n}\n\nfunction occurrenceId(\n { row, vulnerability, matched }: ReturnType<typeof scopedRow>,\n projectVersion: string,\n) {\n const resource = apiResource(row[\"componentVersion\"], \"componentVersion\");\n const component = `${resource.base}/${resource.path}`;\n if (\n !componentVersionPath.test(resource.path) ||\n resource.base !==\n projectVersion.slice(0, projectVersion.lastIndexOf(\"/projects/\"))\n )\n throw new Error(\n \"Black Duck componentVersion must identify a component version on the same server.\",\n );\n const origins = new Set<string>();\n for (const reference of matched) {\n if (reference.component !== component)\n throw new Error(\n \"Black Duck project-version link contradicts componentVersion.\",\n );\n if (reference.origin) origins.add(reference.origin);\n }\n for (const link of links(row[\"_meta\"]).filter(\n (entry) => entry[\"rel\"] === \"vulnerabilities\",\n )) {\n const reference = apiResource(link[\"href\"], \"vulnerabilities link\");\n const match =\n /^(components\\/[^/]+\\/versions\\/[^/]+)(?:\\/origin\\/([^/]+))?\\/vulnerabilities$/u.exec(\n reference.path,\n );\n if (!match) continue;\n if (`${reference.base}/${match[1]}` !== component)\n throw new Error(\n \"Black Duck vulnerabilities link contradicts componentVersion.\",\n );\n if (match[2]) origins.add(match[2]);\n }\n const [origin] = origins;\n if (!origin || origins.size !== 1)\n throw new Error(\n \"Black Duck row must identify one unambiguous component-version origin.\",\n );\n const source = requiredText(\n vulnerability[\"source\"],\n \"Black Duck advisory source\",\n );\n if (source !== \"BDSA\" && source !== \"NVD\")\n throw new Error(`Unsupported Black Duck advisory source: ${source}.`);\n return stableId(\"blackduck-bom\", [\n projectVersion,\n component,\n origin,\n source,\n requiredText(\n vulnerability[\"vulnerabilityName\"],\n \"Black Duck vulnerability name\",\n ),\n ]);\n}\n\nconst nameVersionForges = new Map([\n [\"npmjs\", \"npm\"],\n [\"pypi\", \"pypi\"],\n [\"nuget\", \"nuget\"],\n [\"rubygems\", \"gem\"],\n [\"crates\", \"cargo\"],\n]);\n\nfunction packageUrlName(ecosystem: string, parts: string[]) {\n if (parts.some((part) => !part || part.includes(\"/\"))) return;\n if (ecosystem === \"github\" && parts.length === 2)\n return parts.join(\"/\").toLowerCase();\n if (ecosystem === \"maven\" || ecosystem === \"composer\")\n return parts.length === 2\n ? parts.join(ecosystem === \"maven\" ? \":\" : \"/\")\n : undefined;\n if (\n parts.length === 1 ||\n ecosystem === \"golang\" ||\n ecosystem === \"generic\" ||\n (parts.length === 2 && ecosystem === \"npm\" && parts[0]!.startsWith(\"@\"))\n )\n return parts.join(\"/\");\n}\n\nfunction originPackage(row: Record<string, unknown>) {\n const origin = text(row[\"componentVersionOriginName\"])?.toLowerCase();\n const id = text(row[\"componentVersionOriginId\"]) ?? \"\";\n if (origin === \"maven\") {\n const coordinate = /^([^:\\s/]+:[^:\\s/]+):([^:\\s/]+)$/u.exec(id);\n if (coordinate)\n return {\n name: coordinate[1]!,\n ecosystem: origin,\n installed_version: coordinate[2]!,\n };\n }\n const ecosystem = nameVersionForges.get(origin ?? \"\");\n if (ecosystem) {\n const coordinate = /^(?:(@[^/\\s]+)\\/)?([^/\\s]+)\\/([^/\\s]+)$/u.exec(id);\n if (coordinate && (!coordinate[1] || ecosystem === \"npm\"))\n return {\n name: id.slice(0, id.lastIndexOf(\"/\")),\n ecosystem,\n installed_version: coordinate[3]!,\n };\n }\n}\n\nfunction blackDuckPackages(row: Record<string, unknown>) {\n const origin = originPackage(row);\n const fallback = origin ? [origin] : [];\n const purl =\n /^pkg:([a-z][a-z0-9.+-]*)\\/((?:@[^/@?#]+\\/)?[^@?#]+)(?:@([^@?#]+))?(?:[?#].*)?$/iu.exec(\n text(row[\"packageUrl\"]) ?? \"\",\n );\n if (purl) {\n try {\n const ecosystem = purl[1]!.toLowerCase();\n const name = packageUrlName(\n ecosystem,\n purl[2]!.split(\"/\").map(decodeURIComponent),\n );\n if (name) {\n if (!purl[3] && origin?.ecosystem === ecosystem && origin.name === name)\n return { packages: fallback };\n const pkg = {\n name,\n ecosystem,\n installed_version: purl[3]\n ? decodeURIComponent(purl[3])\n : text(row[\"componentVersionName\"]),\n };\n // Earlier versions used the origin fallback for owner/repository PURLs.\n return ecosystem === \"github\" && name.includes(\"/\")\n ? { packages: fallback, enrichment: { packages: [pkg] } }\n : { packages: [pkg] };\n }\n } catch {\n // A malformed escape does not invalidate the native origin coordinate.\n }\n }\n\n return { packages: fallback };\n}\n\nfunction normalizeReport(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget,\n previous: boolean,\n): ExternalFindings {\n const repository = declaredScannerRepositoryUrl(\n sourceRepositoryUrl,\n \"Black Duck\",\n target,\n );\n const selected = Array.isArray(input);\n let scope: string | undefined;\n let items: unknown[];\n if (selected) {\n items = input;\n } else {\n const collection = record(input, \"Black Duck collection\");\n items = array(collection[\"items\"], \"Black Duck items\");\n scope = collectionScope(collection);\n if (collection[\"totalCount\"] !== items.length)\n throw new Error(\n \"Incomplete Black Duck collection: totalCount must equal the number of items. Supply a complete export or explicitly selected rows.\",\n );\n }\n\n const rows = items.map((value) => {\n const entry = scopedRow(value, scope, selected);\n scope = entry.scope;\n return entry;\n });\n if (!scope)\n throw new Error(\n \"An empty Black Duck selection cannot identify a project version. Supply its complete collection envelope.\",\n );\n const projectVersion = scope;\n const result = normalizeRecords(\n rows,\n ({ row, vulnerability }) => {\n const advisory = requiredText(\n vulnerability[\"vulnerabilityName\"],\n \"Black Duck vulnerability name\",\n );\n const name = requiredText(\n row[\"componentName\"],\n \"Black Duck component name\",\n );\n const related = text(vulnerability[\"relatedVulnerability\"]);\n const { packages, enrichment } = blackDuckPackages(row);\n return validateEnrichedExternalEvidence(\n {\n title: `${advisory} in ${name}`,\n description: text(vulnerability[\"description\"]),\n severity: reportableScannerSeverity(vulnerability[\"severity\"]),\n advisory_ids:\n related && related !== advisory ? [advisory, related] : [advisory],\n packages,\n source_data: {\n format,\n sourceRepositoryUrl: repository,\n projectVersionUrl: projectVersion,\n row: structuredClone(row),\n },\n },\n target,\n previous ? undefined : enrichment,\n );\n },\n (entry) => occurrenceId(entry, projectVersion),\n target,\n );\n if (!selected) {\n // normalizeRecords excludes every collision. An unidentified row can also\n // repeat across pages, so compare its original JSON when it has no ID.\n const seen = new Set<string>();\n for (const excluded of result.excluded) {\n const key =\n excluded.source_finding_id ??\n canonicalJson(items[excluded.position - 1]);\n if (seen.has(key))\n throw new CodexSecurityError(\n \"Duplicate row in a collection with a declared total; pages may overlap. Retrieve the complete export again.\",\n );\n seen.add(key);\n }\n }\n return result;\n}\n\nexport function normalizeBlackDuckFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n return normalizeReport(input, sourceRepositoryUrl, target, false);\n}\n\n/** @internal Earlier readers used the native origin fallback for GitHub package URLs. */\nexport function needsPreviousBlackDuckProjection({\n findings,\n}: ExternalFindings) {\n return findings.some(({ evidence }) =>\n evidence.packages?.some(\n (pkg) => pkg.ecosystem === \"github\" && pkg.name.includes(\"/\"),\n ),\n );\n}\n\n/** @internal Reconstruct the original evidence for an interrupted Cloud request. */\nexport function normalizePreviousBlackDuckFindings(\n input: unknown,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n return normalizeReport(input, sourceRepositoryUrl, target, true);\n}\n\nexport async function readBlackDuckFindings(\n path: string,\n sourceRepositoryUrl: string,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeBlackDuckFindings(\n await readScannerJson(path),\n sourceRepositoryUrl,\n target,\n );\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bulk-scan-discovery.d.ts","sourceRoot":"","sources":["../src/bulk-scan-discovery.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"bulk-scan-discovery.d.ts","sourceRoot":"","sources":["../src/bulk-scan-discovery.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AA8CxC,MAAM,WAAW,cAAc;IAC7B,aAAa,IAAI,OAAO,CAAC;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,OAAO,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CACH,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,CAAC,KAAK,SAAS,MAAM,EACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EACnE,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAClC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,CAAC,CAAC;IAClB,QAAQ,CAAC,KAAK,SAAS,MAAM,EAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EACnE,YAAY,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,EACtD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CACrB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,IAAI,MAAM,CAAC;IACd,gBAAgB,IAAI,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE;IAC3D,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,IAAI,MAAM,CAAC;IACd,gBAAgB,IAAI,MAAM,CAAC;CAC5B,GAAG,6BAA6B,CAehC;AAED,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,6BAA6B,EAC3C,MAAM,CAAC,EAAE,WAAW,EACpB,gBAAgB,SAAqB,GACpC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAmEtC;AA+ID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CA+EzE"}
|
|
@@ -3,7 +3,6 @@ import { lstat, mkdir, writeFile } from "node:fs/promises";
|
|
|
3
3
|
import { join, resolve } from "node:path";
|
|
4
4
|
import { stdin } from "node:process";
|
|
5
5
|
import { Writable } from "node:stream";
|
|
6
|
-
import { checkbox, confirm, input, search, Separator } from "@inquirer/prompts";
|
|
7
6
|
import Papa from "papaparse";
|
|
8
7
|
import { createAuthenticatedGitHub } from "./github.js";
|
|
9
8
|
import { expandHome } from "./runtime.js";
|
|
@@ -58,12 +57,12 @@ export async function runBulkScanWizard(dependencies, signal, defaultOutputDir =
|
|
|
58
57
|
prompt.write("\nNo repositories matched your selection.\n");
|
|
59
58
|
return null;
|
|
60
59
|
}
|
|
61
|
-
prompt.write(`\nFound ${discovered.length}
|
|
60
|
+
prompt.write(`\nFound ${formatRepositoryCount(discovered.length)}.\n`);
|
|
62
61
|
const repositories = await selectGitHubRepositories(discovered, prompt, signal);
|
|
63
62
|
const outputDir = resolve(dependencies.currentDirectory(), expandHome(await prompt.input("Where should scan results be saved?", defaultOutputDir, signal)));
|
|
64
63
|
const inputPath = join(outputDir, "repositories.csv");
|
|
65
64
|
await validateWizardOutput(outputDir);
|
|
66
|
-
prompt.write(`\nReady to scan ${repositories.length}
|
|
65
|
+
prompt.write(`\nReady to scan ${formatRepositoryCount(repositories.length)}?\n` +
|
|
67
66
|
`Results: ${outputDir}\nRepository list: ${inputPath}\n`);
|
|
68
67
|
if (!(await prompt.confirm("Start scanning?", false, signal))) {
|
|
69
68
|
prompt.write("\nScan canceled.\n");
|
|
@@ -103,14 +102,18 @@ async function selectGitHubOwner(github, prompt, signal) {
|
|
|
103
102
|
prompt.write(`\nFinding repositories in ${personal}.\n`);
|
|
104
103
|
return personal;
|
|
105
104
|
}
|
|
105
|
+
function formatRepositoryCount(count) {
|
|
106
|
+
return count === 1 ? "1 repository" : `${count} repositories`;
|
|
107
|
+
}
|
|
106
108
|
async function selectGitHubRepositories(repositories, prompt, signal) {
|
|
109
|
+
const allLabel = repositories.length === 1
|
|
110
|
+
? "All repositories"
|
|
111
|
+
: `All ${formatRepositoryCount(repositories.length)}`;
|
|
107
112
|
const selected = new Set();
|
|
108
113
|
while (selected.size < repositories.length) {
|
|
109
114
|
const choice = await prompt.select("Select repositories to scan (type to filter)", [
|
|
110
115
|
{
|
|
111
|
-
label: selected.size
|
|
112
|
-
? `Done (${selected.size} selected)`
|
|
113
|
-
: `All ${repositories.length} repositories`,
|
|
116
|
+
label: selected.size ? `Done (${selected.size} selected)` : allLabel,
|
|
114
117
|
value: "",
|
|
115
118
|
},
|
|
116
119
|
...repositories
|
|
@@ -202,41 +205,53 @@ export function createTerminalPrompt(output) {
|
|
|
202
205
|
write: (value) => {
|
|
203
206
|
output.write(value);
|
|
204
207
|
},
|
|
205
|
-
confirm
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
208
|
+
async confirm(message, defaultValue = false, signal) {
|
|
209
|
+
const { default: confirm } = await import("@inquirer/confirm");
|
|
210
|
+
return confirm({ message, default: defaultValue }, context(signal));
|
|
211
|
+
},
|
|
212
|
+
async input(message, defaultValue, signal) {
|
|
213
|
+
const { default: input } = await import("@inquirer/input");
|
|
214
|
+
return input({ message, default: defaultValue }, context(signal));
|
|
215
|
+
},
|
|
216
|
+
async checkbox(message, options, presentation, signal) {
|
|
217
|
+
const { default: checkbox, Separator } = await import("@inquirer/checkbox");
|
|
218
|
+
return checkbox({
|
|
219
|
+
message,
|
|
220
|
+
choices: [
|
|
221
|
+
...(presentation?.header === undefined
|
|
222
|
+
? []
|
|
223
|
+
: [new Separator(presentation.header)]),
|
|
224
|
+
...options.map(({ label, value, short }) => ({
|
|
225
|
+
name: label,
|
|
226
|
+
value,
|
|
227
|
+
...(short === undefined ? {} : { short }),
|
|
228
|
+
})),
|
|
229
|
+
],
|
|
230
|
+
required: presentation?.required,
|
|
231
|
+
}, context(signal));
|
|
232
|
+
},
|
|
233
|
+
async select(message, options, presentation, signal) {
|
|
234
|
+
const { default: search } = await import("@inquirer/search");
|
|
235
|
+
return search({
|
|
236
|
+
message,
|
|
210
237
|
...(presentation?.header === undefined
|
|
211
|
-
?
|
|
212
|
-
:
|
|
213
|
-
|
|
238
|
+
? {}
|
|
239
|
+
: {
|
|
240
|
+
theme: {
|
|
241
|
+
style: {
|
|
242
|
+
searchTerm: (term) => `${term}\n ${presentation.header}`,
|
|
243
|
+
},
|
|
244
|
+
},
|
|
245
|
+
}),
|
|
246
|
+
source: (term) => options
|
|
247
|
+
.filter(({ label }) => label.toLowerCase().includes(term?.toLowerCase() ?? ""))
|
|
248
|
+
.map(({ label, value, short }) => ({
|
|
214
249
|
name: label,
|
|
215
250
|
value,
|
|
216
251
|
...(short === undefined ? {} : { short }),
|
|
217
252
|
})),
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
}, context(signal)),
|
|
221
|
-
select: (message, options, presentation, signal) => search({
|
|
222
|
-
message,
|
|
223
|
-
...(presentation?.header === undefined
|
|
224
|
-
? {}
|
|
225
|
-
: {
|
|
226
|
-
theme: {
|
|
227
|
-
style: {
|
|
228
|
-
searchTerm: (term) => `${term}\n ${presentation.header}`,
|
|
229
|
-
},
|
|
230
|
-
},
|
|
231
|
-
}),
|
|
232
|
-
source: (term) => options
|
|
233
|
-
.filter(({ label }) => label.toLowerCase().includes(term?.toLowerCase() ?? ""))
|
|
234
|
-
.map(({ label, value, short }) => ({
|
|
235
|
-
name: label,
|
|
236
|
-
value,
|
|
237
|
-
...(short === undefined ? {} : { short }),
|
|
238
|
-
})),
|
|
239
|
-
}, context(signal)),
|
|
253
|
+
}, context(signal));
|
|
254
|
+
},
|
|
240
255
|
};
|
|
241
256
|
}
|
|
242
257
|
//# sourceMappingURL=bulk-scan-discovery.js.map
|