@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 @@
|
|
|
1
|
+
{"version":3,"file":"semgrep-guardian-findings.js","sourceRoot":"","sources":["../src/semgrep-guardian-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n type ExternalImportTarget,\n validateExternalEvidence,\n} from \"./external-import-contract.js\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport type {\n ExternalFinding,\n ExternalSourceRepository,\n} from \"./external-findings.js\";\nimport { isRecord } from \"./record.js\";\nimport {\n array,\n normalizeRecords,\n record,\n requiredText,\n scannerSeverity,\n stableId,\n text,\n} from \"./scanner-import.js\";\nimport { declaredScannerRepositoryUrl } from \"./scanner-repository-url.js\";\nimport {\n platformLocationPath,\n requireSemgrepFullRef,\n selectionRepository,\n} from \"./semgrep-platform-findings.js\";\n\nexport const guardianSelectionFormat = \"semgrep-guardian-selection/v1\";\n\nexport const guardianFindingId = /^semgrep-guardian:[0-9a-f]{64}$/u;\n\nfunction guardianScope(data: Record<string, unknown>) {\n const tool = data[\"tool\"];\n if (\n tool !== \"get_semgrep_sast_findings\" &&\n tool !== \"get_semgrep_supply_chain_findings\"\n )\n throw new Error(\"Select a Guardian SAST or Supply Chain findings tool.\");\n const deployment = requiredText(data[\"deployment\"], \"Guardian deployment\");\n const repository = requiredText(data[\"repository\"], \"Guardian repository\");\n const ref = requiredText(data[\"ref\"], \"Guardian Git ref\");\n requireSemgrepFullRef(ref);\n return { tool, deployment, repository, ref };\n}\n\nfunction guardianId(scope: ReturnType<typeof guardianScope>, id: unknown) {\n return stableId(\"semgrep-guardian\", [\n scope.deployment,\n scope.repository,\n scope.tool,\n scope.ref,\n requiredText(id, \"Guardian finding ID\"),\n ]);\n}\n\nexport function guardianFindingRepository(\n { source_finding_id, evidence }: ExternalFinding,\n target: ExternalImportTarget,\n) {\n const data = evidence.source_data ?? {};\n const generated = guardianFindingId.test(source_finding_id);\n if (data[\"format\"] !== guardianSelectionFormat && !generated) return;\n const row = record(data[\"finding\"], \"Original Guardian finding\");\n const scope = guardianScope(data);\n requireGuardianRowScope(scope, row);\n if (evidence.branch != null && evidence.branch !== scope.ref)\n throw new CodexSecurityError(\n \"The Guardian finding branch does not match the selected ref.\",\n );\n if (source_finding_id !== guardianId(scope, row[\"id\"]))\n throw new CodexSecurityError(\n \"The normalized finding ID does not match the original Guardian finding.\",\n );\n return declaredScannerRepositoryUrl(\n data[\"sourceRepositoryUrl\"],\n \"Guardian\",\n target,\n );\n}\n\ntype GuardianTool =\n \"get_semgrep_sast_findings\" | \"get_semgrep_supply_chain_findings\";\n\n/** The request passed to the signed-in Guardian MCP client. */\ninterface GuardianRequest {\n name: GuardianTool;\n arguments: {\n deployment_name: string;\n repository_name: string;\n ref: string;\n states?: string[] | null;\n severities?: string[] | null;\n max_num_findings?: number;\n };\n}\n\nfunction selectionScope(request: unknown, findingIds: unknown) {\n const tool = record(request, \"Guardian tool request\");\n const args = record(tool[\"arguments\"], \"Guardian tool arguments\");\n const scope = guardianScope({\n tool: tool[\"name\"],\n deployment: args[\"deployment_name\"],\n repository: args[\"repository_name\"],\n ref: args[\"ref\"],\n });\n const ids = new Set(\n array(findingIds, \"Guardian finding IDs\").map((id) =>\n requiredText(id, \"Guardian finding ID\"),\n ),\n );\n if (!ids.size) throw new Error(\"Select at least one Guardian finding ID.\");\n return { ...scope, ids };\n}\n\nfunction requireGuardianRowScope(\n scope: ReturnType<typeof guardianScope>,\n row: Record<string, unknown>,\n): void {\n const id = row[\"id\"];\n const repository = record(row[\"repository\"], \"Guardian finding repository\");\n if (\n repository[\"name\"] !== scope.repository ||\n (row[\"ref\"] != null && row[\"ref\"] !== scope.ref)\n )\n throw new Error(\n `Guardian finding ${id} does not match the selected repository and ref.`,\n );\n const expected = scope.tool === \"get_semgrep_sast_findings\" ? \"sast\" : \"sca\";\n if (\n row[\"issueType\"] != null &&\n text(row[\"issueType\"])\n ?.toLowerCase()\n .replace(/^issue_type_/u, \"\") !== expected\n )\n throw new Error(\n `Guardian finding ${id} does not match the selected product.`,\n );\n}\n\nfunction selectedRows(\n scope: ReturnType<typeof selectionScope>,\n structuredContent: unknown,\n) {\n const { findings } = record(structuredContent, \"Guardian structuredContent\");\n const rows = new Map<string, Record<string, unknown>>();\n for (const row of array(findings ?? [], \"Guardian findings\")) {\n if (\n !isRecord(row) ||\n typeof row[\"id\"] !== \"string\" ||\n !scope.ids.has(row[\"id\"])\n )\n continue;\n const id = row[\"id\"];\n if (rows.has(id))\n throw new Error(`Guardian returned duplicate finding ID ${id}.`);\n requireGuardianRowScope(scope, row);\n rows.set(id, row);\n }\n return Array.from(scope.ids, (id) => {\n const row = rows.get(id);\n if (!row)\n throw new Error(`Guardian did not return selected finding ${id}.`);\n return row;\n });\n}\n\n/** Use the caller's connected Guardian MCP client. Only selected rows enter the saved capture. */\nexport async function collectSelectedSemgrepGuardianFindings(\n selection: {\n request: GuardianRequest;\n findingIds: readonly string[];\n sourceRepositoryUrl: string;\n },\n dependencies: {\n callTool: (request: GuardianRequest) => Promise<unknown>;\n environment?: NodeJS.ProcessEnv;\n },\n) {\n const query = structuredClone(selection.request);\n const scope = selectionScope(query, selection.findingIds);\n const sourceRepositoryUrl = declaredScannerRepositoryUrl(\n selection.sourceRepositoryUrl,\n \"Guardian\",\n \"local\",\n );\n const result = record(\n await dependencies.callTool(query),\n \"Guardian MCP result\",\n );\n if (result[\"isError\"]) {\n const content = result[\"content\"];\n const messages = Array.isArray(content)\n ? content\n .map((part: unknown) =>\n isRecord(part) && part[\"type\"] === \"text\"\n ? text(part[\"text\"])\n : null,\n )\n .filter(Boolean)\n : [];\n throw new Error(messages.join(\"\\n\") || \"Guardian MCP request failed.\");\n }\n return {\n format: guardianSelectionFormat,\n sourceRepositoryUrl,\n request: query,\n findingIds: [...scope.ids],\n structuredContent: {\n findings: selectedRows(scope, result[\"structuredContent\"]),\n },\n };\n}\n\nexport function normalizeGuardianSelection(\n document: Record<string, unknown>,\n target: ExternalImportTarget,\n declaredUrl?: string,\n references: readonly ExternalSourceRepository[] = [],\n) {\n // Guardian returns a repository name. The caller supplies its verified SCM mapping.\n const url = declaredScannerRepositoryUrl(\n document[\"sourceRepositoryUrl\"],\n \"Guardian\",\n target,\n );\n const repositoryBinding = selectionRepository(url, references, target);\n if (\n declaredUrl !== undefined &&\n repositoryBinding.key(\n declaredScannerRepositoryUrl(declaredUrl, \"Guardian\", target),\n ) !== repositoryBinding.key(url)\n )\n throw new Error(\n \"Guardian selection does not match the declared source repository URL.\",\n );\n const scope = selectionScope(document[\"request\"], document[\"findingIds\"]);\n const { tool, deployment, repository, ref } = scope;\n return normalizeRecords(\n selectedRows(scope, document[\"structuredContent\"]),\n (finding) => {\n const rule = text(finding[\"rulePath\"]);\n const message = text(finding[\"message\"]);\n const path = platformLocationPath(finding[\"filePath\"]);\n const line = finding[\"line\"];\n return validateExternalEvidence(\n {\n title: rule ?? message ?? `Semgrep finding ${finding[\"id\"]}`,\n description: message,\n severity: scannerSeverity(\n text(finding[\"severity\"])\n ?.toLowerCase()\n .replace(/^severity_/u, \"\"),\n ),\n branch: ref,\n locations: path\n ? [{ path, line: line === 0 ? null : (line ?? null) }]\n : [],\n ...(tool === \"get_semgrep_sast_findings\" && {\n details: {\n kind: \"sast\",\n scanner_origin: \"Semgrep\",\n repository: { name: repository, url },\n rule: rule ? { id: rule } : null,\n source_status: text(finding[\"status\"]),\n },\n }),\n source_data: {\n format: guardianSelectionFormat,\n tool,\n deployment,\n repository,\n ref,\n sourceRepositoryUrl: url,\n finding,\n },\n },\n target,\n );\n },\n // Guardian's string ID has not been verified against Web API occurrence IDs.\n (finding) => guardianId(scope, finding[\"id\"]),\n target,\n { report: { format: guardianSelectionFormat, repositoryUrl: url } },\n );\n}\n"]}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { type ExternalSourceRepository } from "./external-findings.js";
|
|
2
|
+
import { type HostedScannerHttpOptions } from "./hosted-scanner-http.js";
|
|
3
|
+
import { semgrepPlatformFormat, SEMGREP_PLATFORM_PRODUCTS, type SemgrepPlatformProduct, type SemgrepPlatformScope } from "./semgrep-platform-findings.js";
|
|
4
|
+
export { SEMGREP_PLATFORM_PRODUCTS };
|
|
5
|
+
export interface SemgrepPlatformOptions {
|
|
6
|
+
deployment: string;
|
|
7
|
+
project: string;
|
|
8
|
+
ref: string;
|
|
9
|
+
product?: SemgrepPlatformProduct;
|
|
10
|
+
sourceRepositoryUrl?: string;
|
|
11
|
+
sourceRepositories?: readonly ExternalSourceRepository[];
|
|
12
|
+
token?: string;
|
|
13
|
+
signal?: AbortSignal;
|
|
14
|
+
}
|
|
15
|
+
export interface SemgrepPlatformReport extends SemgrepPlatformScope {
|
|
16
|
+
/** The original transport address when the provider supplied an SSH repository. */
|
|
17
|
+
nativeProjectUrl?: string;
|
|
18
|
+
/** The operator's binding when the native URL is missing or uses SSH. */
|
|
19
|
+
sourceRepositoryUrl?: string;
|
|
20
|
+
format: typeof semgrepPlatformFormat;
|
|
21
|
+
findingCount: number;
|
|
22
|
+
findings: string[];
|
|
23
|
+
repositoryAliases: string[];
|
|
24
|
+
}
|
|
25
|
+
export declare function collectSemgrepPlatformFindings(options: SemgrepPlatformOptions, dependencies?: HostedScannerHttpOptions): Promise<SemgrepPlatformReport>;
|
|
26
|
+
//# sourceMappingURL=semgrep-platform-collector.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"semgrep-platform-collector.d.ts","sourceRoot":"","sources":["../src/semgrep-platform-collector.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAIL,qBAAqB,EAOrB,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAErC,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,OAAO,qBAAqB,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,sBAAsB,EAC/B,YAAY,GAAE,wBAA6B,GAC1C,OAAO,CAAC,qBAAqB,CAAC,CA6IhC"}
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { snapshotSourceRepositories, } from "./external-findings.js";
|
|
2
|
+
import { hostedScannerToken, hostedRepositoryUrl, hostedScannerHttp, } from "./hosted-scanner-http.js";
|
|
3
|
+
import { checkSemgrepPlatformRow, projectAliases, responseRecord, semgrepPlatformFormat, selectionRepository, semgrepNativeProjectUrl, semgrepProjectUrlEvidence, semgrepPlatformId, semgrepPlatformIdOrUndefined, stringifySemgrepFinding, SEMGREP_PLATFORM_PRODUCTS, } from "./semgrep-platform-findings.js";
|
|
4
|
+
import { array, requiredText, stableId, text } from "./scanner-import.js";
|
|
5
|
+
export { SEMGREP_PLATFORM_PRODUCTS };
|
|
6
|
+
export async function collectSemgrepPlatformFindings(options, dependencies = {}) {
|
|
7
|
+
const environment = dependencies.environment ?? process.env;
|
|
8
|
+
const token = requiredText(hostedScannerToken(environment, "SEMGREP_APP_TOKEN", options.token, "https://semgrep.dev", "SEMGREP_URL", "SEMGREP_APP_URL"), "Semgrep Web API token (SEMGREP_APP_TOKEN)");
|
|
9
|
+
const { getJson, signal } = hostedScannerHttp(dependencies, options.signal);
|
|
10
|
+
const deployment = requiredText(options.deployment, "Semgrep deployment");
|
|
11
|
+
const name = requiredText(options.project, "Semgrep project name");
|
|
12
|
+
if (deployment.includes("/") ||
|
|
13
|
+
[deployment, name].some((part) => part === "." || part === ".."))
|
|
14
|
+
throw new Error("Invalid Semgrep deployment slug or project name.");
|
|
15
|
+
const ref = requiredText(options.ref, "Semgrep ref");
|
|
16
|
+
const { sourceRepositoryUrl } = options;
|
|
17
|
+
const sourceRepositories = snapshotSourceRepositories(options.sourceRepositories);
|
|
18
|
+
const product = options.product ?? "sast";
|
|
19
|
+
if (!SEMGREP_PLATFORM_PRODUCTS.includes(product))
|
|
20
|
+
throw new Error("Select a Semgrep Platform product: sast, sca or ai_sast.");
|
|
21
|
+
const base = `https://semgrep.dev/api/v1/deployments/${encodeURIComponent(deployment)}`;
|
|
22
|
+
const get = async (url) => responseRecord(await getJson(url, `Bearer ${token}`), "Semgrep API response");
|
|
23
|
+
const lookup = await get(new URL(`${base}/projects/${encodeURIComponent(name)}`));
|
|
24
|
+
const native = responseRecord(lookup["project"], "Semgrep project");
|
|
25
|
+
if (native["name"] !== name)
|
|
26
|
+
throw new Error("Semgrep returned a different project than requested.");
|
|
27
|
+
const nativeUrl = semgrepNativeProjectUrl(native["url"], sourceRepositories);
|
|
28
|
+
const mappedUrl = hostedRepositoryUrl(sourceRepositoryUrl ?? nativeUrl, "Semgrep project repository");
|
|
29
|
+
const url = nativeUrl ?? mappedUrl;
|
|
30
|
+
const source = selectionRepository(url, sourceRepositories);
|
|
31
|
+
if (source.key(mappedUrl) !== source.key(url))
|
|
32
|
+
throw new Error("Semgrep project does not match the selected source repository URL.");
|
|
33
|
+
const project = { id: semgrepPlatformId(native["id"]), name, url };
|
|
34
|
+
const scope = { deployment, project, ref, product };
|
|
35
|
+
const endpoint = new URL(`${base}/findings`);
|
|
36
|
+
const pageSize = 3000;
|
|
37
|
+
endpoint.search = new URLSearchParams({
|
|
38
|
+
repository_ids: project.id,
|
|
39
|
+
issue_type: product,
|
|
40
|
+
ref,
|
|
41
|
+
dedup: "false",
|
|
42
|
+
page_size: String(pageSize),
|
|
43
|
+
}).toString();
|
|
44
|
+
const names = projectAliases(name, url, sourceRepositories);
|
|
45
|
+
const witnessed = new Set();
|
|
46
|
+
const verified = {
|
|
47
|
+
has: (label) => names.has(label) || witnessed.has(label),
|
|
48
|
+
};
|
|
49
|
+
const observed = new Set();
|
|
50
|
+
async function readPage(page, collecting = true) {
|
|
51
|
+
endpoint.searchParams.set("page", String(page));
|
|
52
|
+
const document = await get(new URL(endpoint));
|
|
53
|
+
return array(document["findings"], "Semgrep findings").map((entry) => {
|
|
54
|
+
const finding = responseRecord(entry, "Semgrep finding");
|
|
55
|
+
const repository = responseRecord(finding["repository"] ?? {}, "Semgrep finding repository");
|
|
56
|
+
const label = text(repository["name"]);
|
|
57
|
+
if (collecting && label)
|
|
58
|
+
observed.add(label);
|
|
59
|
+
checkSemgrepPlatformRow(finding, scope, collecting ? observed : verified, source);
|
|
60
|
+
if (collecting &&
|
|
61
|
+
label &&
|
|
62
|
+
(repository["id"] != null || text(repository["url"])))
|
|
63
|
+
witnessed.add(label);
|
|
64
|
+
const raw = JSON.stringify(finding);
|
|
65
|
+
return {
|
|
66
|
+
key: semgrepPlatformIdOrUndefined(finding["id"]) ??
|
|
67
|
+
stringifySemgrepFinding(finding),
|
|
68
|
+
raw,
|
|
69
|
+
};
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
const pageId = (batch) => stableId("page", batch.map((row) => row.key).sort());
|
|
73
|
+
const findings = [];
|
|
74
|
+
const previousKeys = new Set();
|
|
75
|
+
let firstPage;
|
|
76
|
+
for (let page = 0;; page++) {
|
|
77
|
+
const batch = await readPage(page);
|
|
78
|
+
// Compare only with prior pages; same-page ambiguities are reported per finding on import.
|
|
79
|
+
if (batch.some((row) => previousKeys.has(row.key)))
|
|
80
|
+
throw new Error("Semgrep Platform repeated findings across pages; retry the collection.");
|
|
81
|
+
for (const row of batch)
|
|
82
|
+
findings.push(row.raw);
|
|
83
|
+
if (batch.length < pageSize)
|
|
84
|
+
break;
|
|
85
|
+
for (const row of batch)
|
|
86
|
+
previousKeys.add(row.key);
|
|
87
|
+
if (page === 0)
|
|
88
|
+
firstPage = pageId(batch);
|
|
89
|
+
}
|
|
90
|
+
// A name-only finding can precede the row that binds this label to the project.
|
|
91
|
+
for (const label of observed) {
|
|
92
|
+
if (!verified.has(label))
|
|
93
|
+
throw new Error(`Semgrep finding repository name "${label}" has no matching project name, repository ID or URL.`);
|
|
94
|
+
}
|
|
95
|
+
// Offset pagination can skip a row if the first page changes between reads.
|
|
96
|
+
if (firstPage && firstPage !== pageId(await readPage(0, false)))
|
|
97
|
+
throw new Error("Semgrep Platform findings changed across pages; retry the collection.");
|
|
98
|
+
signal?.throwIfAborted();
|
|
99
|
+
return {
|
|
100
|
+
format: semgrepPlatformFormat,
|
|
101
|
+
...scope,
|
|
102
|
+
...semgrepProjectUrlEvidence(native["url"], nativeUrl, sourceRepositoryUrl),
|
|
103
|
+
repositoryAliases: [...observed].sort(),
|
|
104
|
+
findingCount: findings.length,
|
|
105
|
+
findings,
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
//# sourceMappingURL=semgrep-platform-collector.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"semgrep-platform-collector.js","sourceRoot":"","sources":["../src/semgrep-platform-collector.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n snapshotSourceRepositories,\n type ExternalSourceRepository,\n} from \"./external-findings.js\";\nimport {\n hostedScannerToken,\n hostedRepositoryUrl,\n hostedScannerHttp,\n type HostedScannerHttpOptions,\n} from \"./hosted-scanner-http.js\";\nimport {\n checkSemgrepPlatformRow,\n projectAliases,\n responseRecord,\n semgrepPlatformFormat,\n selectionRepository,\n semgrepNativeProjectUrl,\n semgrepProjectUrlEvidence,\n semgrepPlatformId,\n semgrepPlatformIdOrUndefined,\n stringifySemgrepFinding,\n SEMGREP_PLATFORM_PRODUCTS,\n type SemgrepPlatformProduct,\n type SemgrepPlatformScope,\n} from \"./semgrep-platform-findings.js\";\nimport { array, requiredText, stableId, text } from \"./scanner-import.js\";\n\nexport { SEMGREP_PLATFORM_PRODUCTS };\n\nexport interface SemgrepPlatformOptions {\n deployment: string;\n project: string;\n ref: string;\n product?: SemgrepPlatformProduct;\n sourceRepositoryUrl?: string;\n sourceRepositories?: readonly ExternalSourceRepository[];\n token?: string;\n signal?: AbortSignal;\n}\n\nexport interface SemgrepPlatformReport extends SemgrepPlatformScope {\n /** The original transport address when the provider supplied an SSH repository. */\n nativeProjectUrl?: string;\n /** The operator's binding when the native URL is missing or uses SSH. */\n sourceRepositoryUrl?: string;\n format: typeof semgrepPlatformFormat;\n findingCount: number;\n findings: string[];\n repositoryAliases: string[];\n}\n\nexport async function collectSemgrepPlatformFindings(\n options: SemgrepPlatformOptions,\n dependencies: HostedScannerHttpOptions = {},\n): Promise<SemgrepPlatformReport> {\n const environment = dependencies.environment ?? process.env;\n const token = requiredText(\n hostedScannerToken(\n environment,\n \"SEMGREP_APP_TOKEN\",\n options.token,\n \"https://semgrep.dev\",\n \"SEMGREP_URL\",\n \"SEMGREP_APP_URL\",\n ),\n \"Semgrep Web API token (SEMGREP_APP_TOKEN)\",\n );\n const { getJson, signal } = hostedScannerHttp(dependencies, options.signal);\n const deployment = requiredText(options.deployment, \"Semgrep deployment\");\n const name = requiredText(options.project, \"Semgrep project name\");\n if (\n deployment.includes(\"/\") ||\n [deployment, name].some((part) => part === \".\" || part === \"..\")\n )\n throw new Error(\"Invalid Semgrep deployment slug or project name.\");\n const ref = requiredText(options.ref, \"Semgrep ref\");\n const { sourceRepositoryUrl } = options;\n const sourceRepositories = snapshotSourceRepositories(\n options.sourceRepositories,\n );\n const product = options.product ?? \"sast\";\n if (!SEMGREP_PLATFORM_PRODUCTS.includes(product))\n throw new Error(\"Select a Semgrep Platform product: sast, sca or ai_sast.\");\n\n const base = `https://semgrep.dev/api/v1/deployments/${encodeURIComponent(deployment)}`;\n const get = async (url: URL) =>\n responseRecord(\n await getJson(url, `Bearer ${token}`),\n \"Semgrep API response\",\n );\n const lookup = await get(\n new URL(`${base}/projects/${encodeURIComponent(name)}`),\n );\n const native = responseRecord(lookup[\"project\"], \"Semgrep project\");\n if (native[\"name\"] !== name)\n throw new Error(\"Semgrep returned a different project than requested.\");\n const nativeUrl = semgrepNativeProjectUrl(native[\"url\"], sourceRepositories);\n const mappedUrl = hostedRepositoryUrl(\n sourceRepositoryUrl ?? nativeUrl,\n \"Semgrep project repository\",\n );\n const url = nativeUrl ?? mappedUrl;\n const source = selectionRepository(url, sourceRepositories);\n if (source.key(mappedUrl) !== source.key(url))\n throw new Error(\n \"Semgrep project does not match the selected source repository URL.\",\n );\n const project = { id: semgrepPlatformId(native[\"id\"]), name, url };\n const scope = { deployment, project, ref, product };\n const endpoint = new URL(`${base}/findings`);\n const pageSize = 3000;\n endpoint.search = new URLSearchParams({\n repository_ids: project.id,\n issue_type: product,\n ref,\n dedup: \"false\",\n page_size: String(pageSize),\n }).toString();\n const names = projectAliases(name, url, sourceRepositories);\n const witnessed = new Set<string>();\n const verified = {\n has: (label: string) => names.has(label) || witnessed.has(label),\n };\n const observed = new Set<string>();\n async function readPage(page: number, collecting = true) {\n endpoint.searchParams.set(\"page\", String(page));\n const document = await get(new URL(endpoint));\n return array(document[\"findings\"], \"Semgrep findings\").map((entry) => {\n const finding = responseRecord(entry, \"Semgrep finding\");\n const repository = responseRecord(\n finding[\"repository\"] ?? {},\n \"Semgrep finding repository\",\n );\n const label = text(repository[\"name\"]);\n if (collecting && label) observed.add(label);\n checkSemgrepPlatformRow(\n finding,\n scope,\n collecting ? observed : verified,\n source,\n );\n if (\n collecting &&\n label &&\n (repository[\"id\"] != null || text(repository[\"url\"]))\n )\n witnessed.add(label);\n const raw = JSON.stringify(finding);\n return {\n key:\n semgrepPlatformIdOrUndefined(finding[\"id\"]) ??\n stringifySemgrepFinding(finding),\n raw,\n };\n });\n }\n\n const pageId = (batch: Awaited<ReturnType<typeof readPage>>) =>\n stableId(\"page\", batch.map((row) => row.key).sort());\n const findings: string[] = [];\n const previousKeys = new Set<string>();\n let firstPage: string | undefined;\n for (let page = 0; ; page++) {\n const batch = await readPage(page);\n // Compare only with prior pages; same-page ambiguities are reported per finding on import.\n if (batch.some((row) => previousKeys.has(row.key)))\n throw new Error(\n \"Semgrep Platform repeated findings across pages; retry the collection.\",\n );\n for (const row of batch) findings.push(row.raw);\n if (batch.length < pageSize) break;\n for (const row of batch) previousKeys.add(row.key);\n if (page === 0) firstPage = pageId(batch);\n }\n // A name-only finding can precede the row that binds this label to the project.\n for (const label of observed) {\n if (!verified.has(label))\n throw new Error(\n `Semgrep finding repository name \"${label}\" has no matching project name, repository ID or URL.`,\n );\n }\n // Offset pagination can skip a row if the first page changes between reads.\n if (firstPage && firstPage !== pageId(await readPage(0, false)))\n throw new Error(\n \"Semgrep Platform findings changed across pages; retry the collection.\",\n );\n signal?.throwIfAborted();\n return {\n format: semgrepPlatformFormat,\n ...scope,\n ...semgrepProjectUrlEvidence(native[\"url\"], nativeUrl, sourceRepositoryUrl),\n repositoryAliases: [...observed].sort(),\n findingCount: findings.length,\n findings,\n };\n}\n"]}
|
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
import { type ExternalImportTarget } from "./external-import-contract.js";
|
|
2
|
+
import type { ExternalFinding, ExternalFindings, ExternalSourceRepository } from "./external-findings.js";
|
|
3
|
+
import { hostedNativeRepositoryUrl } from "./hosted-scanner-http.js";
|
|
4
|
+
import type { SemgrepImportOptions } from "./semgrep-findings.js";
|
|
5
|
+
export declare const semgrepPlatformFormat = "semgrep-platform-findings/v2";
|
|
6
|
+
export declare const semgrepPlatformLegacyFormat = "semgrep-platform-findings/v1";
|
|
7
|
+
export declare const SEMGREP_PLATFORM_PRODUCTS: readonly ["sast", "sca", "ai_sast"];
|
|
8
|
+
export type SemgrepPlatformProduct = (typeof SEMGREP_PLATFORM_PRODUCTS)[number];
|
|
9
|
+
export declare const semgrepSelectionFormat = "semgrep-platform-selection/v1";
|
|
10
|
+
export declare function isSemgrepPlatformFormat(format: unknown): format is typeof semgrepSelectionFormat | typeof semgrepPlatformFormat | typeof semgrepPlatformLegacyFormat;
|
|
11
|
+
/** Recover the native collection scope, including when every row was excluded. */
|
|
12
|
+
export declare function semgrepPlatformReportScope(input: ExternalFindings, provider?: string, references?: readonly ExternalSourceRepository[]): {
|
|
13
|
+
deployment?: undefined;
|
|
14
|
+
projectId?: undefined;
|
|
15
|
+
product?: undefined;
|
|
16
|
+
url: string;
|
|
17
|
+
format?: undefined;
|
|
18
|
+
ref?: undefined;
|
|
19
|
+
} | {
|
|
20
|
+
format: "semgrep-platform-findings/v1" | "semgrep-platform-findings/v2" | "semgrep-platform-selection/v1";
|
|
21
|
+
deployment: string;
|
|
22
|
+
projectId: string;
|
|
23
|
+
ref: string;
|
|
24
|
+
product: "ai_sast" | "sast" | "sca";
|
|
25
|
+
url: string;
|
|
26
|
+
} | undefined;
|
|
27
|
+
export declare function semgrepPlatformReportRepository(input: ExternalFindings, provider?: string): string | undefined;
|
|
28
|
+
export interface SemgrepPlatformScope {
|
|
29
|
+
deployment: string;
|
|
30
|
+
project: {
|
|
31
|
+
id: string;
|
|
32
|
+
name: string;
|
|
33
|
+
url: string;
|
|
34
|
+
};
|
|
35
|
+
ref: string;
|
|
36
|
+
product: SemgrepPlatformProduct;
|
|
37
|
+
}
|
|
38
|
+
type ResolvedScope = SemgrepPlatformScope & {
|
|
39
|
+
sourceRepositoryUrl?: string;
|
|
40
|
+
nativeProjectUrl?: string;
|
|
41
|
+
};
|
|
42
|
+
export interface SemgrepPlatformSelection extends SemgrepPlatformScope {
|
|
43
|
+
product: "sast";
|
|
44
|
+
format: typeof semgrepSelectionFormat;
|
|
45
|
+
/** Each native finding is JSON text so numbers retain their exact wire values through replay. */
|
|
46
|
+
findings: string[];
|
|
47
|
+
}
|
|
48
|
+
export declare function responseRecord(value: unknown, label: string): Record<string, unknown>;
|
|
49
|
+
export declare function parseSemgrepResponse(json: string): Record<string, unknown>;
|
|
50
|
+
export declare function semgrepPlatformIdOrUndefined(value: unknown): string | undefined;
|
|
51
|
+
export declare function semgrepPlatformId(value: unknown): string;
|
|
52
|
+
export declare function projectAliases(name: string, url: string, references?: SemgrepRepositoryReference, earlyV1?: boolean): {
|
|
53
|
+
hasHistoricalPath: (label: string) => boolean;
|
|
54
|
+
has: (label: string) => boolean;
|
|
55
|
+
};
|
|
56
|
+
/** Older captures could derive a row label from their verified HTTP mapping for an SSH project. */
|
|
57
|
+
export declare function legacyProjectAliases(name: string, url: string, references: SemgrepRepositoryReference, mapping: string | undefined): {
|
|
58
|
+
has: (label: string) => boolean;
|
|
59
|
+
};
|
|
60
|
+
/** Compare HTTP origins canonically without folding paths on independent custom Git hosts. */
|
|
61
|
+
export declare function semgrepRepositoryUrlKey(value: string): string;
|
|
62
|
+
export type SemgrepRepositoryReference = readonly ExternalSourceRepository[] | ((url: string) => string);
|
|
63
|
+
/** Readers may pass the SCM web link from the project response or its equivalent Git transport. */
|
|
64
|
+
export declare function semgrepReferenceMatches(source: ExternalSourceRepository, url: string): boolean;
|
|
65
|
+
export declare function semgrepPlatformRepositoryReference(url: string, references: readonly ExternalSourceRepository[]): ExternalSourceRepository;
|
|
66
|
+
/** Keep provider transport spelling independently of its resolved HTTP repository. */
|
|
67
|
+
export declare function semgrepProjectUrlEvidence(raw: unknown, resolved: string | undefined, mapping: string | undefined): {
|
|
68
|
+
sourceRepositoryUrl: string | undefined;
|
|
69
|
+
} | {
|
|
70
|
+
nativeProjectUrl: string;
|
|
71
|
+
sourceRepositoryUrl?: string | undefined;
|
|
72
|
+
} | {
|
|
73
|
+
sourceRepositoryUrl?: undefined;
|
|
74
|
+
};
|
|
75
|
+
/** Interpret a project's native SSH spelling only when its Git host is known. */
|
|
76
|
+
export declare function semgrepNativeProjectUrl(value: unknown, references: SemgrepRepositoryReference): string | undefined;
|
|
77
|
+
export declare function selectionRepository(projectUrl: string, references?: readonly ExternalSourceRepository[], target?: ExternalImportTarget): {
|
|
78
|
+
source: ExternalSourceRepository;
|
|
79
|
+
selectableProject: boolean;
|
|
80
|
+
key: (url: string) => string;
|
|
81
|
+
name: (name: string) => string;
|
|
82
|
+
};
|
|
83
|
+
/** Complete reports record the repository labels returned by the project-ID-scoped request. */
|
|
84
|
+
export declare function checkSemgrepPlatformRow(finding: Record<string, unknown>, scope: ResolvedScope, aliases?: Pick<ReadonlySet<string>, "has">, repository?: {
|
|
85
|
+
source: ExternalSourceRepository;
|
|
86
|
+
selectableProject: boolean;
|
|
87
|
+
key: (url: string) => string;
|
|
88
|
+
name: (name: string) => string;
|
|
89
|
+
}, readId?: typeof semgrepPlatformId, repositoryUrl?: typeof hostedNativeRepositoryUrl, capture?: boolean): boolean;
|
|
90
|
+
interface SemgrepSelectionInput {
|
|
91
|
+
deployment: string;
|
|
92
|
+
ref: string;
|
|
93
|
+
projectResponse: string;
|
|
94
|
+
findingsResponses: Iterable<string>;
|
|
95
|
+
findingIds: readonly string[];
|
|
96
|
+
}
|
|
97
|
+
export declare function requireSemgrepFullRef(ref: string): void;
|
|
98
|
+
/** Select existing SAST findings from native Web API responses for one project and ref. */
|
|
99
|
+
export declare function selectSemgrepPlatformFindings(options: SemgrepSelectionInput & {
|
|
100
|
+
sourceRepositories?: readonly ExternalSourceRepository[];
|
|
101
|
+
}): SemgrepPlatformSelection;
|
|
102
|
+
/** Select SAST findings using the operator's exact, independently supplied HTTP(S) spelling. */
|
|
103
|
+
export declare function normalizeSelectedSemgrepPlatformFindings(options: SemgrepSelectionInput & {
|
|
104
|
+
sourceRepositoryUrl: string;
|
|
105
|
+
}): {
|
|
106
|
+
sourceRepositoryUrl: string;
|
|
107
|
+
read: number;
|
|
108
|
+
report?: Record<string, unknown>;
|
|
109
|
+
findings: ExternalFinding[];
|
|
110
|
+
excluded: {
|
|
111
|
+
position: number;
|
|
112
|
+
source_finding_id: string | null;
|
|
113
|
+
reason: string;
|
|
114
|
+
}[];
|
|
115
|
+
};
|
|
116
|
+
/** Current occurrences carry a provider-specific key; older v1 rows retain their native scope and finding. */
|
|
117
|
+
export declare function isSemgrepPlatformEvidence(finding: ExternalFinding, provider?: string): boolean;
|
|
118
|
+
/** Original v1 occurrences could keep only the observed repository label on a row. */
|
|
119
|
+
export declare function semgrepLegacyRepositoryWitnesses(findings: readonly ExternalFinding[], provider: string, references?: SemgrepRepositoryReference, target?: ExternalImportTarget): ReadonlyMap<string, string>;
|
|
120
|
+
/** Recheck the source repository when an SDK caller supplies normalized evidence directly. */
|
|
121
|
+
export declare function semgrepPlatformFindingRepository(finding: ExternalFinding, provider: string, references?: SemgrepRepositoryReference, legacyWitnesses?: ReadonlyMap<string, string>): string | undefined;
|
|
122
|
+
export declare function platformLocationPath(value: unknown): string | null;
|
|
123
|
+
/** A marked report reserves the v1 finding's repository, ref and product for Semgrep scope. */
|
|
124
|
+
export declare function hasRetainedSemgrepScope(finding: unknown): boolean;
|
|
125
|
+
export declare function semgrepPlatformFindingBinding(finding: ExternalFinding, provider: string, references?: SemgrepRepositoryReference, legacyWitnesses?: ReadonlyMap<string, string>, reportScope?: ReturnType<typeof semgrepPlatformReportScope>, projectedSources?: readonly ({
|
|
126
|
+
url?: string;
|
|
127
|
+
branch?: string;
|
|
128
|
+
} | undefined)[], target?: ExternalImportTarget, replayApprovedRequest?: boolean): {
|
|
129
|
+
url: string;
|
|
130
|
+
nativeId: string;
|
|
131
|
+
migration: {
|
|
132
|
+
severity?: import("./external-import-models.js").Severity | undefined;
|
|
133
|
+
locations?: import("./external-import-models.js").Locations | undefined;
|
|
134
|
+
details?: {
|
|
135
|
+
kind: import("./external-import-models.js").Kind;
|
|
136
|
+
repository?: import("./external-import-models.js").ImportedRepositoryReference | null;
|
|
137
|
+
advisory?: import("./external-import-models.js").ImportedAdvisoryContext | null;
|
|
138
|
+
source_status?: import("./external-import-models.js").SourceStatus;
|
|
139
|
+
scanner_origin?: import("./external-import-models.js").ScannerOrigin;
|
|
140
|
+
scanner_verdict?: import("./external-import-models.js").ScannerVerdict;
|
|
141
|
+
rule?: import("./external-import-models.js").ImportedFindingRule | null;
|
|
142
|
+
weakness_ids?: import("./external-import-models.js").WeaknessIds;
|
|
143
|
+
remediation_instructions?: import("./external-import-models.js").RemediationInstructions;
|
|
144
|
+
secret?: import("./external-import-models.js").ImportedSecretDetails | null;
|
|
145
|
+
configuration?: import("./external-import-models.js").ImportedConfigurationDetails | null;
|
|
146
|
+
file_url?: import("./external-import-models.js").FileUrl;
|
|
147
|
+
code: {
|
|
148
|
+
snippet?: import("./external-import-models.js").Snippet;
|
|
149
|
+
end_line: import("./external-import-models.js").EndLine | undefined;
|
|
150
|
+
};
|
|
151
|
+
} | undefined;
|
|
152
|
+
} | {
|
|
153
|
+
severity?: import("./external-import-models.js").Severity | undefined;
|
|
154
|
+
locations?: import("./external-import-models.js").Locations | undefined;
|
|
155
|
+
details: {
|
|
156
|
+
kind: import("./external-import-models.js").Kind;
|
|
157
|
+
advisory?: import("./external-import-models.js").ImportedAdvisoryContext | null;
|
|
158
|
+
source_status?: import("./external-import-models.js").SourceStatus;
|
|
159
|
+
scanner_origin?: import("./external-import-models.js").ScannerOrigin;
|
|
160
|
+
scanner_verdict?: import("./external-import-models.js").ScannerVerdict;
|
|
161
|
+
rule?: import("./external-import-models.js").ImportedFindingRule | null;
|
|
162
|
+
weakness_ids?: import("./external-import-models.js").WeaknessIds;
|
|
163
|
+
remediation_instructions?: import("./external-import-models.js").RemediationInstructions;
|
|
164
|
+
code?: import("./external-import-models.js").ImportedCodeContext | null;
|
|
165
|
+
secret?: import("./external-import-models.js").ImportedSecretDetails | null;
|
|
166
|
+
configuration?: import("./external-import-models.js").ImportedConfigurationDetails | null;
|
|
167
|
+
file_url?: import("./external-import-models.js").FileUrl;
|
|
168
|
+
repository: {
|
|
169
|
+
id?: import("./external-import-models.js").Id1;
|
|
170
|
+
name?: import("./external-import-models.js").Name1;
|
|
171
|
+
url: string;
|
|
172
|
+
};
|
|
173
|
+
};
|
|
174
|
+
} | undefined;
|
|
175
|
+
sourceData: {
|
|
176
|
+
deployment: string;
|
|
177
|
+
ref: string;
|
|
178
|
+
product: SemgrepPlatformProduct;
|
|
179
|
+
sourceRepositoryUrl?: string;
|
|
180
|
+
project: {
|
|
181
|
+
id: string;
|
|
182
|
+
name: string;
|
|
183
|
+
url: string | null;
|
|
184
|
+
};
|
|
185
|
+
format: string;
|
|
186
|
+
idEncoding?: string | undefined;
|
|
187
|
+
repositoryAliases?: string[] | undefined;
|
|
188
|
+
repositoryWitnessJson?: string | undefined;
|
|
189
|
+
semgrepPlatformFindingJson: string;
|
|
190
|
+
};
|
|
191
|
+
} | undefined;
|
|
192
|
+
/** Normalize a saved selection or Platform project export. The default target is local. */
|
|
193
|
+
export declare function normalizeSemgrepPlatformFindings(report: unknown, options?: string | Partial<SemgrepImportOptions>, target?: ExternalImportTarget, references?: readonly ExternalSourceRepository[]): {
|
|
194
|
+
sourceFormat: "semgrep-platform-findings/v1" | "semgrep-platform-findings/v2" | "semgrep-platform-selection/v1";
|
|
195
|
+
sourceRepositoryUrl: string;
|
|
196
|
+
semgrepPlatformScope: {
|
|
197
|
+
deployment: string;
|
|
198
|
+
projectId: string;
|
|
199
|
+
ref: string;
|
|
200
|
+
product: "ai_sast" | "sast" | "sca";
|
|
201
|
+
};
|
|
202
|
+
read: number;
|
|
203
|
+
report?: Record<string, unknown>;
|
|
204
|
+
findings: ExternalFinding[];
|
|
205
|
+
excluded: {
|
|
206
|
+
position: number;
|
|
207
|
+
source_finding_id: string | null;
|
|
208
|
+
reason: string;
|
|
209
|
+
}[];
|
|
210
|
+
};
|
|
211
|
+
export declare function stringifySemgrepFinding(finding: Record<string, unknown>, idOf?: (id: unknown) => string | undefined): string;
|
|
212
|
+
export {};
|
|
213
|
+
//# sourceMappingURL=semgrep-platform-findings.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"semgrep-platform-findings.d.ts","sourceRoot":"","sources":["../src/semgrep-platform-findings.ts"],"names":[],"mappings":"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"}
|