@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
package/dist/scanner-import.js
CHANGED
|
@@ -1,9 +1,14 @@
|
|
|
1
1
|
import { hash } from "node:crypto";
|
|
2
2
|
import { readFile } from "node:fs/promises";
|
|
3
|
+
import { posix } from "node:path";
|
|
3
4
|
import { promisify } from "node:util";
|
|
4
5
|
import { gunzip } from "node:zlib";
|
|
6
|
+
import validSemver from "semver/functions/valid.js";
|
|
5
7
|
import { CodexSecurityError, errorMessage } from "./errors.js";
|
|
6
|
-
import {
|
|
8
|
+
import { REPORTABLE_SEVERITIES, SCAN_SEVERITIES } from "./scan-settings.js";
|
|
9
|
+
import { asRecord, isRecord } from "./record.js";
|
|
10
|
+
import { previousAdmission } from "./external-import-contract.js";
|
|
11
|
+
import { rememberPreviousSelection } from "./reader-selection.js";
|
|
7
12
|
export function record(value, label) {
|
|
8
13
|
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
9
14
|
throw new Error(`${label} must be an object.`);
|
|
@@ -14,15 +19,172 @@ export function array(value, label) {
|
|
|
14
19
|
throw new Error(`${label} must be an array.`);
|
|
15
20
|
return value;
|
|
16
21
|
}
|
|
22
|
+
export function optionalArray(value, label) {
|
|
23
|
+
return value === undefined ? [] : array(value, label);
|
|
24
|
+
}
|
|
25
|
+
// SARIF uses the same index/GUID/ID references for components and descriptors.
|
|
26
|
+
function sarifReferences(entries, select, first = 0) {
|
|
27
|
+
const refs = new Map();
|
|
28
|
+
entries.forEach((entry, index) => {
|
|
29
|
+
if (!isRecord(entry))
|
|
30
|
+
return;
|
|
31
|
+
const item = select(entry);
|
|
32
|
+
refs.set(index + first, item);
|
|
33
|
+
if (typeof entry["guid"] === "string")
|
|
34
|
+
refs.set("guid:" + entry["guid"].toLowerCase(), item);
|
|
35
|
+
if (typeof entry["id"] === "string")
|
|
36
|
+
refs.set("id:" + entry["id"], item);
|
|
37
|
+
});
|
|
38
|
+
return (ref) => {
|
|
39
|
+
const { index, guid, id } = asRecord(ref) ?? {};
|
|
40
|
+
if (typeof index === "number" && index >= 0)
|
|
41
|
+
return refs.get(index);
|
|
42
|
+
if (typeof guid === "string")
|
|
43
|
+
return refs.get("guid:" + guid.toLowerCase());
|
|
44
|
+
return typeof id === "string" ? refs.get("id:" + id) : refs.get(-1);
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
function notificationDescriptors(value) {
|
|
48
|
+
const tool = asRecord(value);
|
|
49
|
+
// The driver is the default component (-1); extension indexes start at 0.
|
|
50
|
+
const component = sarifReferences([
|
|
51
|
+
tool?.["driver"],
|
|
52
|
+
...optionalArray(tool?.["extensions"], "SARIF tool extensions"),
|
|
53
|
+
], (owner) => sarifReferences(optionalArray(owner["notifications"], "SARIF notification descriptors"), (entry) => entry), -1);
|
|
54
|
+
return (ref) => component(asRecord(ref)?.["toolComponent"])?.(ref);
|
|
55
|
+
}
|
|
56
|
+
export function validateSarifRun(run, producer) {
|
|
57
|
+
if (hasSarifExternalPropertyReferences(run["externalPropertyFileReferences"]))
|
|
58
|
+
throw new Error(`Use a self-contained ${producer} SARIF report.`);
|
|
59
|
+
function validate(values, tool, strictExecution) {
|
|
60
|
+
let descriptors;
|
|
61
|
+
const resolve = (ref) => isRecord(ref)
|
|
62
|
+
? (descriptors ??= notificationDescriptors(tool))(ref)
|
|
63
|
+
: undefined;
|
|
64
|
+
for (const value of values) {
|
|
65
|
+
const invocation = record(value, `${producer} invocation`);
|
|
66
|
+
const successful = invocation["executionSuccessful"];
|
|
67
|
+
if (typeof successful !== "boolean")
|
|
68
|
+
throw new Error(`${producer} SARIF executionSuccessful must be a boolean.`);
|
|
69
|
+
const list = (key) => optionalArray(invocation[key], `${producer} ${key}`);
|
|
70
|
+
const execution = list("toolExecutionNotifications");
|
|
71
|
+
const notices = execution.concat(list("toolConfigurationNotifications"));
|
|
72
|
+
if (!successful) {
|
|
73
|
+
const details = [
|
|
74
|
+
invocation["processStartFailureMessage"],
|
|
75
|
+
invocation["exitCodeDescription"],
|
|
76
|
+
invocation["exitCode"],
|
|
77
|
+
invocation["exitSignalName"],
|
|
78
|
+
...notices,
|
|
79
|
+
].filter((value) => value !== undefined);
|
|
80
|
+
throw new Error(`${producer} SARIF contains an unsuccessful invocation.${details.length ? " " + JSON.stringify(details) : ""}`);
|
|
81
|
+
}
|
|
82
|
+
if (strictExecution && execution.length)
|
|
83
|
+
throw new Error(`${producer} SARIF contains scan error notifications: ${JSON.stringify(execution)}`);
|
|
84
|
+
const levels = new Map();
|
|
85
|
+
for (const value of list("notificationConfigurationOverrides")) {
|
|
86
|
+
const override = asRecord(value);
|
|
87
|
+
const descriptor = resolve(override?.["descriptor"]);
|
|
88
|
+
const level = asRecord(override?.["configuration"])?.["level"];
|
|
89
|
+
if (descriptor && level !== undefined)
|
|
90
|
+
levels.set(descriptor, level);
|
|
91
|
+
}
|
|
92
|
+
for (const value of notices) {
|
|
93
|
+
const notice = record(value, `${producer} notification`);
|
|
94
|
+
const descriptor = resolve(notice["descriptor"]);
|
|
95
|
+
const level = notice["level"] ??
|
|
96
|
+
(descriptor && levels.get(descriptor)) ??
|
|
97
|
+
asRecord(descriptor?.["defaultConfiguration"])?.["level"];
|
|
98
|
+
if (level === "error")
|
|
99
|
+
throw new Error(`${producer} SARIF contains scan error notifications: ${JSON.stringify(notice)}`);
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
// Semgrep reports scanner errors as execution notices even below error level.
|
|
104
|
+
validate(optionalArray(run["invocations"], `${producer} invocations`), run["tool"], producer === "Semgrep");
|
|
105
|
+
if (run["conversion"] !== undefined) {
|
|
106
|
+
const conversion = record(run["conversion"], `${producer} conversion`);
|
|
107
|
+
if (conversion["invocation"] !== undefined)
|
|
108
|
+
validate([conversion["invocation"]], conversion["tool"], false);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
17
111
|
export function text(value) {
|
|
18
112
|
return typeof value === "string" && value.trim() ? value : null;
|
|
19
113
|
}
|
|
114
|
+
/** AWS APIs use epoch seconds and AWS CLI exports use timezone-qualified ISO dates. */
|
|
115
|
+
export function awsTimestampSeconds(value) {
|
|
116
|
+
if (typeof value === "number")
|
|
117
|
+
return value;
|
|
118
|
+
if (typeof value === "string" &&
|
|
119
|
+
/^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d+)?(?:Z|[+-]\d\d:\d\d)$/u.test(value))
|
|
120
|
+
return Date.parse(value) / 1000;
|
|
121
|
+
return NaN;
|
|
122
|
+
}
|
|
123
|
+
export function concreteVersion(value, ecosystem, osPackage) {
|
|
124
|
+
const version = text(value);
|
|
125
|
+
if (!version)
|
|
126
|
+
return null;
|
|
127
|
+
// Debian versions use internal tildes for prereleases and backports.
|
|
128
|
+
if (osPackage && version.includes("~"))
|
|
129
|
+
return /^(?:\d+:)?\d[a-z\d.+~]*(?:-[a-z\d.+~]+)*$/iu.test(version)
|
|
130
|
+
? version
|
|
131
|
+
: null;
|
|
132
|
+
if (validSemver(version))
|
|
133
|
+
return version;
|
|
134
|
+
if (ecosystem === "npm" || ecosystem === "cargo")
|
|
135
|
+
return null;
|
|
136
|
+
if (ecosystem === "java" || ecosystem === "maven") {
|
|
137
|
+
if (version === "LATEST" ||
|
|
138
|
+
version === "RELEASE" ||
|
|
139
|
+
version.startsWith("latest."))
|
|
140
|
+
return null;
|
|
141
|
+
return /^[a-z\d][\w.+-]*$/iu.test(version) && !version.endsWith("+")
|
|
142
|
+
? version
|
|
143
|
+
: null;
|
|
144
|
+
}
|
|
145
|
+
if (!ecosystem && version.endsWith("+"))
|
|
146
|
+
return null;
|
|
147
|
+
const publicVersion = ecosystem === "pypi" ? version.split("+", 1)[0] : version;
|
|
148
|
+
return /\d/u.test(version) &&
|
|
149
|
+
/^(?:\d+:)?[a-z\d][\w.+!-]*$/iu.test(version) &&
|
|
150
|
+
!/(?:^|\.)x(?:\.|$)/iu.test(publicVersion)
|
|
151
|
+
? version
|
|
152
|
+
: null;
|
|
153
|
+
}
|
|
20
154
|
export function requiredText(value, label) {
|
|
21
155
|
const result = text(value);
|
|
22
156
|
if (!result)
|
|
23
157
|
throw new Error(`${label} must be nonempty text.`);
|
|
24
158
|
return result;
|
|
25
159
|
}
|
|
160
|
+
/** SARIF repository claims must be checked even when a run has no results. */
|
|
161
|
+
export function sarifRunRepositories(run, producer) {
|
|
162
|
+
if (run == null)
|
|
163
|
+
return [];
|
|
164
|
+
return array(record(run, `${producer} run context`)["versionControlProvenance"] ?? [], `${producer} version control provenance`).flatMap((entry) => {
|
|
165
|
+
const ref = record(entry, `${producer} repository provenance`);
|
|
166
|
+
const url = producer === "Semgrep"
|
|
167
|
+
? text(ref["repositoryUri"])
|
|
168
|
+
: requiredText(ref["repositoryUri"], `${producer} repository URI`);
|
|
169
|
+
if (url === null)
|
|
170
|
+
return [];
|
|
171
|
+
const branch = ref["branch"];
|
|
172
|
+
return [
|
|
173
|
+
{
|
|
174
|
+
url,
|
|
175
|
+
...(producer === "Semgrep" && typeof branch === "string" && { branch }),
|
|
176
|
+
},
|
|
177
|
+
];
|
|
178
|
+
});
|
|
179
|
+
}
|
|
180
|
+
/** Normalize scanners whose reported severities range from low to critical. */
|
|
181
|
+
export function reportableScannerSeverity(value) {
|
|
182
|
+
const level = text(value)?.toLowerCase();
|
|
183
|
+
return (REPORTABLE_SEVERITIES.find((severity) => severity === level) ?? "unknown");
|
|
184
|
+
}
|
|
185
|
+
export function scannerSeverity(value) {
|
|
186
|
+
return SCAN_SEVERITIES.find((severity) => severity === value) ?? "unknown";
|
|
187
|
+
}
|
|
26
188
|
export function strings(value) {
|
|
27
189
|
return Array.isArray(value)
|
|
28
190
|
? value.filter((v) => text(v) !== null)
|
|
@@ -39,17 +201,49 @@ export function relativePath(value) {
|
|
|
39
201
|
? path
|
|
40
202
|
: null;
|
|
41
203
|
}
|
|
204
|
+
// Hosted findings do not identify the scanner operating system or its path separator.
|
|
205
|
+
export function hostedRepositoryPath(value) {
|
|
206
|
+
const path = text(value);
|
|
207
|
+
return path && !path.includes("\\") && !path.includes("://")
|
|
208
|
+
? relativePath(path)
|
|
209
|
+
: null;
|
|
210
|
+
}
|
|
211
|
+
export function repositoryFilePath(value) {
|
|
212
|
+
const relative = relativePath(value);
|
|
213
|
+
if (!relative)
|
|
214
|
+
return null;
|
|
215
|
+
const path = posix.normalize(relative);
|
|
216
|
+
// Anchor the SCP branch at the first eligible @ to avoid rescanning long filenames.
|
|
217
|
+
return path === "." ||
|
|
218
|
+
path.endsWith("/") ||
|
|
219
|
+
/^(?:[a-z][a-z\d+.-]*:|~[^/]*(?:\/|$)|[^/][^/@]*@[^/]+:)/iu.test(path)
|
|
220
|
+
? null
|
|
221
|
+
: path;
|
|
222
|
+
}
|
|
42
223
|
export function stableId(prefix, fields) {
|
|
43
224
|
return `${prefix}:${hash("sha256", JSON.stringify(fields))}`;
|
|
44
225
|
}
|
|
45
226
|
const strictUtf8 = new TextDecoder("utf-8", { fatal: true });
|
|
46
227
|
const gunzipAsync = promisify(gunzip);
|
|
47
|
-
async function
|
|
228
|
+
async function readScannerInput(path) {
|
|
48
229
|
const bytes = await readFile(path);
|
|
49
|
-
|
|
230
|
+
const gzip = bytes[0] === 0x1f && bytes[1] === 0x8b;
|
|
231
|
+
return { gzip, bytes: gzip ? await gunzipAsync(bytes) : bytes };
|
|
232
|
+
}
|
|
233
|
+
export async function readScannerBytes(path) {
|
|
234
|
+
return (await readScannerInput(path)).bytes;
|
|
50
235
|
}
|
|
51
236
|
export async function readScannerText(path) {
|
|
52
|
-
|
|
237
|
+
const { bytes, gzip } = await readScannerInput(path);
|
|
238
|
+
const contents = strictUtf8.decode(bytes);
|
|
239
|
+
// Empty JSONL is a valid stream of zero records; a blank JSON or CSV document isn't.
|
|
240
|
+
if (!contents.trim()) {
|
|
241
|
+
if (!gzip && /\.gz$/iu.test(path))
|
|
242
|
+
throw new Error("The report is blank and contains no gzip stream.");
|
|
243
|
+
if (/\.(?:json|csv)(?:\.gz)?$/iu.test(path))
|
|
244
|
+
throw new Error("The report is blank.");
|
|
245
|
+
}
|
|
246
|
+
return contents;
|
|
53
247
|
}
|
|
54
248
|
export function parseJsonOrJsonl(contents) {
|
|
55
249
|
try {
|
|
@@ -62,7 +256,7 @@ export function parseJsonOrJsonl(contents) {
|
|
|
62
256
|
.map((line) => JSON.parse(line));
|
|
63
257
|
}
|
|
64
258
|
}
|
|
65
|
-
export async function readScannerJson(path) {
|
|
259
|
+
export async function readScannerJson(path, parse = JSON.parse) {
|
|
66
260
|
const bytes = await readScannerBytes(path);
|
|
67
261
|
let decoded;
|
|
68
262
|
try {
|
|
@@ -72,7 +266,7 @@ export async function readScannerJson(path) {
|
|
|
72
266
|
throw new CodexSecurityError(`Scanner report is not valid UTF-8. ${errorMessage(error)}`, { cause: error });
|
|
73
267
|
}
|
|
74
268
|
try {
|
|
75
|
-
return
|
|
269
|
+
return parse(decoded.replace(/^\uFEFF/u, ""));
|
|
76
270
|
}
|
|
77
271
|
catch (error) {
|
|
78
272
|
throw new CodexSecurityError(`Scanner JSON could not be parsed. ${errorMessage(error)}`, { cause: error });
|
|
@@ -97,11 +291,7 @@ const sarifArtifactLocationFields = new Set([
|
|
|
97
291
|
"mappedTo",
|
|
98
292
|
"displayBase",
|
|
99
293
|
]);
|
|
100
|
-
|
|
101
|
-
export function sarifRunContextForResult(runContext, ...selectedEvidence) {
|
|
102
|
-
const { artifacts, ...context } = runContext;
|
|
103
|
-
if (!Array.isArray(artifacts) || artifacts.length === 0)
|
|
104
|
-
return runContext;
|
|
294
|
+
function sarifArtifactReferences(evidence) {
|
|
105
295
|
const locations = [];
|
|
106
296
|
let hasArtifactLink = false;
|
|
107
297
|
function visit(value) {
|
|
@@ -126,46 +316,226 @@ export function sarifRunContextForResult(runContext, ...selectedEvidence) {
|
|
|
126
316
|
visit(child);
|
|
127
317
|
}
|
|
128
318
|
}
|
|
129
|
-
visit(
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
319
|
+
visit(evidence);
|
|
320
|
+
return { locations, hasArtifactLink };
|
|
321
|
+
}
|
|
322
|
+
const unresolvedUri = /[%:\\]|(?:^|\/)\.\.?(?:\/|$)/u;
|
|
323
|
+
function artifactUriMatcher(artifacts) {
|
|
324
|
+
const uris = new Set();
|
|
325
|
+
let hasLocation = false;
|
|
326
|
+
let base;
|
|
327
|
+
for (const artifact of artifacts) {
|
|
328
|
+
if (!isRecord(artifact) || !isRecord(artifact["location"]))
|
|
137
329
|
continue;
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
330
|
+
const { uri, uriBaseId } = artifact["location"];
|
|
331
|
+
// Mixed bases or a URI that needs resolution can match any direct reference.
|
|
332
|
+
if ((hasLocation && uriBaseId !== base) ||
|
|
333
|
+
(typeof uri === "string" && unresolvedUri.test(uri)))
|
|
334
|
+
return () => true;
|
|
335
|
+
hasLocation = true;
|
|
336
|
+
base = uriBaseId;
|
|
337
|
+
if (typeof uri === "string")
|
|
338
|
+
uris.add(uri);
|
|
339
|
+
}
|
|
340
|
+
return (uri, uriBaseId) => hasLocation &&
|
|
341
|
+
(uriBaseId !== base || unresolvedUri.test(uri) || uris.has(uri));
|
|
342
|
+
}
|
|
343
|
+
/** Keep original artifact indexes; omit only inventory unrelated to this finding. */
|
|
344
|
+
export function sarifRunContextSelector(runContext) {
|
|
345
|
+
const { artifacts, ...context } = runContext;
|
|
346
|
+
if (!Array.isArray(artifacts) || artifacts.length === 0)
|
|
347
|
+
return () => runContext;
|
|
348
|
+
let matchesUri;
|
|
349
|
+
return (...selectedEvidence) => {
|
|
350
|
+
const { locations, hasArtifactLink } = sarifArtifactReferences([
|
|
351
|
+
context,
|
|
352
|
+
...selectedEvidence,
|
|
353
|
+
]);
|
|
354
|
+
if (hasArtifactLink)
|
|
355
|
+
return runContext;
|
|
356
|
+
for (const location of locations) {
|
|
357
|
+
const { index, uri, uriBaseId } = location;
|
|
358
|
+
if (typeof index === "number" && index >= 0)
|
|
148
359
|
return runContext;
|
|
360
|
+
if (typeof uri === "string") {
|
|
361
|
+
matchesUri ??= artifactUriMatcher(artifacts);
|
|
362
|
+
if (matchesUri(uri, uriBaseId))
|
|
363
|
+
return runContext;
|
|
364
|
+
}
|
|
149
365
|
}
|
|
150
|
-
|
|
151
|
-
|
|
366
|
+
return context;
|
|
367
|
+
};
|
|
152
368
|
}
|
|
153
369
|
/** Duplicate IDs cannot identify a single rule in this run. */
|
|
154
|
-
export function indexSarifRules(
|
|
370
|
+
export function indexSarifRules(entries) {
|
|
155
371
|
const byId = new Map();
|
|
156
|
-
for (const [index, rule] of
|
|
372
|
+
for (const [index, rule] of entries) {
|
|
157
373
|
const id = rule["id"];
|
|
158
374
|
byId.set(id, byId.has(id) ? null : { rule, index });
|
|
159
375
|
}
|
|
160
376
|
return byId;
|
|
161
377
|
}
|
|
378
|
+
/** Unpack the common SARIF envelope; each reader qualifies its own producer. */
|
|
379
|
+
export function readSarifRuns(input, producer, read) {
|
|
380
|
+
const document = record(input, `${producer} SARIF`);
|
|
381
|
+
if (document["version"] !== "2.1.0")
|
|
382
|
+
throw new Error(`Expected ${producer} SARIF 2.1.0.`);
|
|
383
|
+
return array(document["runs"], "SARIF runs").flatMap((value) => {
|
|
384
|
+
const run = record(value, "SARIF run");
|
|
385
|
+
const tool = record(run["tool"], "SARIF tool");
|
|
386
|
+
const driver = record(tool["driver"], "SARIF driver");
|
|
387
|
+
return read({ document, run, tool, driver });
|
|
388
|
+
});
|
|
389
|
+
}
|
|
390
|
+
/** Pair each result with its shared run context and original evidence. */
|
|
391
|
+
export function sarifRunResults({ document, run, tool, driver }, producer) {
|
|
392
|
+
validateSarifRun(run, producer);
|
|
393
|
+
const rules = array(driver["rules"] ?? [], `${producer} rules`).map((rule) => record(rule, `${producer} rule`));
|
|
394
|
+
const rulesById = indexSarifRules(rules.entries());
|
|
395
|
+
const { runs: _runs, ...documentContext } = document;
|
|
396
|
+
const { results: _results, tool: _tool, ...runContext } = run;
|
|
397
|
+
const { rules: _rules, ...driverContext } = driver;
|
|
398
|
+
const { driver: _driver, ...toolContext } = tool;
|
|
399
|
+
const selectRunContext = sarifRunContextSelector(runContext);
|
|
400
|
+
// JS callers may supply lazy metadata. Preserve each adapter's original traversal order.
|
|
401
|
+
const metadataInReadOrder = producer === "Semgrep"
|
|
402
|
+
? [driverContext, toolContext, documentContext]
|
|
403
|
+
: [documentContext, driverContext, toolContext];
|
|
404
|
+
const context = {
|
|
405
|
+
rulesById,
|
|
406
|
+
runContext,
|
|
407
|
+
sourceData(result, rule) {
|
|
408
|
+
return structuredClone({
|
|
409
|
+
documentContext,
|
|
410
|
+
runContext: selectRunContext(result, rule, ...metadataInReadOrder),
|
|
411
|
+
driverContext,
|
|
412
|
+
toolContext,
|
|
413
|
+
...(rule ? { rule } : {}),
|
|
414
|
+
result,
|
|
415
|
+
});
|
|
416
|
+
},
|
|
417
|
+
};
|
|
418
|
+
return optionalArray(run["results"], `${producer} results`).map((result) => ({
|
|
419
|
+
result,
|
|
420
|
+
context,
|
|
421
|
+
}));
|
|
422
|
+
}
|
|
423
|
+
/** The top-level index and nested descriptor must agree with the selected driver rule. */
|
|
424
|
+
export function validateSarifRuleReference(result, ruleId, selected, producer) {
|
|
425
|
+
// Snyk's original diagnostics use unqualified SARIF field names.
|
|
426
|
+
const label = producer === "Snyk" ? "Result" : producer;
|
|
427
|
+
if (result["ruleIndex"] !== undefined &&
|
|
428
|
+
result["ruleIndex"] !== selected?.index)
|
|
429
|
+
throw new Error(`${label} ruleIndex and ruleId disagree.`);
|
|
430
|
+
if (result["rule"] === undefined)
|
|
431
|
+
return;
|
|
432
|
+
const reference = record(result["rule"], producer === "Snyk" ? "Rule reference" : `${producer} rule reference`);
|
|
433
|
+
if (reference["toolComponent"] !== undefined ||
|
|
434
|
+
(reference["id"] !== undefined && reference["id"] !== ruleId) ||
|
|
435
|
+
(reference["index"] !== undefined &&
|
|
436
|
+
reference["index"] !== selected?.index) ||
|
|
437
|
+
(reference["guid"] !== undefined &&
|
|
438
|
+
reference["guid"] !== selected?.rule["guid"]))
|
|
439
|
+
throw new Error(producer === "Snyk"
|
|
440
|
+
? "Result uses an inconsistent or external rule reference."
|
|
441
|
+
: `Inconsistent or external ${producer} rule reference.`);
|
|
442
|
+
}
|
|
443
|
+
/** Track older size decisions while a single reader constructs its result. */
|
|
444
|
+
export function trackReaderSelection(result) {
|
|
445
|
+
const changes = [];
|
|
446
|
+
const uncertainIds = new Set();
|
|
447
|
+
function append(position, id, project) {
|
|
448
|
+
const index = result.findings.length;
|
|
449
|
+
let outcome;
|
|
450
|
+
try {
|
|
451
|
+
const evidence = project();
|
|
452
|
+
outcome = evidence;
|
|
453
|
+
result.findings.push({ source_finding_id: id, evidence });
|
|
454
|
+
}
|
|
455
|
+
catch (error) {
|
|
456
|
+
outcome = error;
|
|
457
|
+
result.excluded.push({
|
|
458
|
+
position,
|
|
459
|
+
source_finding_id: id,
|
|
460
|
+
reason: errorMessage(error),
|
|
461
|
+
});
|
|
462
|
+
}
|
|
463
|
+
const previous = outcome && typeof outcome === "object"
|
|
464
|
+
? previousAdmission(outcome)
|
|
465
|
+
: undefined;
|
|
466
|
+
if (previous === "uncertain")
|
|
467
|
+
uncertainIds.add(id);
|
|
468
|
+
else if (previous !== undefined)
|
|
469
|
+
changes.push({ index, position, id, previous });
|
|
470
|
+
}
|
|
471
|
+
function finish(filter) {
|
|
472
|
+
if (!changes.length && !uncertainIds.size) {
|
|
473
|
+
filter?.(result);
|
|
474
|
+
return result;
|
|
475
|
+
}
|
|
476
|
+
const findings = [];
|
|
477
|
+
const excluded = [];
|
|
478
|
+
const restoredPositions = new Set();
|
|
479
|
+
let cursor = 0;
|
|
480
|
+
for (const { index, position, id, previous } of changes) {
|
|
481
|
+
while (cursor < index)
|
|
482
|
+
findings.push(result.findings[cursor++]);
|
|
483
|
+
if (previous) {
|
|
484
|
+
findings.push({ source_finding_id: id, evidence: previous });
|
|
485
|
+
restoredPositions.add(position);
|
|
486
|
+
}
|
|
487
|
+
else {
|
|
488
|
+
cursor++;
|
|
489
|
+
excluded.push({
|
|
490
|
+
position,
|
|
491
|
+
source_finding_id: id,
|
|
492
|
+
reason: "Evidence exceeds the Cloud limit of 256 KiB.",
|
|
493
|
+
});
|
|
494
|
+
}
|
|
495
|
+
}
|
|
496
|
+
while (cursor < result.findings.length)
|
|
497
|
+
findings.push(result.findings[cursor++]);
|
|
498
|
+
for (const row of result.excluded) {
|
|
499
|
+
if (!restoredPositions.has(row.position))
|
|
500
|
+
excluded.push(row);
|
|
501
|
+
}
|
|
502
|
+
excluded.sort((a, b) => a.position - b.position);
|
|
503
|
+
const previous = { ...result, findings, excluded };
|
|
504
|
+
// A removed sibling could have depended on an unproven row for its scope.
|
|
505
|
+
filter?.(previous, uncertainIds.size ? uncertainIds : undefined);
|
|
506
|
+
filter?.(result);
|
|
507
|
+
const sourceFindingIds = [
|
|
508
|
+
...new Set([
|
|
509
|
+
...previous.findings.map((row) => row.source_finding_id),
|
|
510
|
+
...uncertainIds,
|
|
511
|
+
]),
|
|
512
|
+
];
|
|
513
|
+
if (uncertainIds.size) {
|
|
514
|
+
rememberPreviousSelection(result, {
|
|
515
|
+
sourceFindingIds,
|
|
516
|
+
uncertainFindingIds: [...uncertainIds],
|
|
517
|
+
knownFindings: structuredClone(previous.findings.filter((row) => !uncertainIds.has(row.source_finding_id))),
|
|
518
|
+
});
|
|
519
|
+
}
|
|
520
|
+
else {
|
|
521
|
+
rememberPreviousSelection(result, {
|
|
522
|
+
sourceFindingIds,
|
|
523
|
+
snapshot: structuredClone(previous),
|
|
524
|
+
});
|
|
525
|
+
}
|
|
526
|
+
return result;
|
|
527
|
+
}
|
|
528
|
+
return { append, finish, uncertainIds };
|
|
529
|
+
}
|
|
162
530
|
/** Exclude every colliding record: choosing the first could overwrite another occurrence. */
|
|
163
|
-
export function normalizeRecords(records, projectEvidence, identify, target = "cloud") {
|
|
531
|
+
export function normalizeRecords(records, projectEvidence, identify, target = "cloud", options = {}) {
|
|
164
532
|
const result = {
|
|
165
533
|
read: records.length,
|
|
166
534
|
findings: [],
|
|
167
535
|
excluded: [],
|
|
536
|
+
...(options.report === undefined ? {} : { report: options.report }),
|
|
168
537
|
};
|
|
538
|
+
const selection = trackReaderSelection(result);
|
|
169
539
|
const identified = [];
|
|
170
540
|
const counts = new Map();
|
|
171
541
|
for (const [index, value] of records.entries()) {
|
|
@@ -197,21 +567,9 @@ export function normalizeRecords(records, projectEvidence, identify, target = "c
|
|
|
197
567
|
});
|
|
198
568
|
continue;
|
|
199
569
|
}
|
|
200
|
-
|
|
201
|
-
result.findings.push({
|
|
202
|
-
source_finding_id: id,
|
|
203
|
-
evidence: projectEvidence(value, id),
|
|
204
|
-
});
|
|
205
|
-
}
|
|
206
|
-
catch (error) {
|
|
207
|
-
result.excluded.push({
|
|
208
|
-
position,
|
|
209
|
-
source_finding_id: id,
|
|
210
|
-
reason: errorMessage(error),
|
|
211
|
-
});
|
|
212
|
-
}
|
|
570
|
+
selection.append(position, id, () => projectEvidence(value, id));
|
|
213
571
|
}
|
|
214
572
|
result.excluded.sort((a, b) => a.position - b.position);
|
|
215
|
-
return
|
|
573
|
+
return selection.finish(options.filter);
|
|
216
574
|
}
|
|
217
575
|
//# sourceMappingURL=scanner-import.js.map
|