@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/github-findings.js
CHANGED
|
@@ -1,14 +1,13 @@
|
|
|
1
1
|
import { hash } from "node:crypto";
|
|
2
|
+
import { isDeepStrictEqual } from "node:util";
|
|
3
|
+
import { isBoxedPrimitive, isDate, isProxy } from "node:util/types";
|
|
2
4
|
import { GHSA_ID, githubRepositoryParts } from "./github-identifiers.js";
|
|
3
5
|
import { CodexSecurityError, errorMessage } from "./errors.js";
|
|
4
|
-
import { validateExternalEvidence } from "./external-import-contract.js";
|
|
6
|
+
import { cloudRepositoryUrlKey, CloudEvidenceDepthError, exportedGitHubRecord, previousGitHubExclusion, validateExternalEvidenceFields, validateExternalEvidenceJson, validateExternalEvidence, } from "./external-import-contract.js";
|
|
5
7
|
import { isGitHubDependabotAlert, normalizeGitHubDependabotAlerts, } from "./github-dependabot-findings.js";
|
|
6
|
-
import {
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
? value
|
|
10
|
-
: undefined;
|
|
11
|
-
}
|
|
8
|
+
import { asRecord, canSnapshotWithoutGetters, cloneWithoutGetters, } from "./record.js";
|
|
9
|
+
import { parseJsonOrJsonl, readScannerText, scannerSeverity, text, } from "./scanner-import.js";
|
|
10
|
+
import { rememberPreviousSelection, } from "./reader-selection.js";
|
|
12
11
|
function repositoryName(value) {
|
|
13
12
|
const repository = text(value);
|
|
14
13
|
if (!repository || !githubRepositoryParts(repository))
|
|
@@ -31,16 +30,16 @@ function sourceTimestamp(value) {
|
|
|
31
30
|
throw new Error("GitHub updated_at is not a valid timestamp.");
|
|
32
31
|
return Math.floor(seconds);
|
|
33
32
|
}
|
|
34
|
-
function
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
33
|
+
function codeScanningPrefix({ parsed, host }, repository, number) {
|
|
34
|
+
const name = repository.toLowerCase();
|
|
35
|
+
const path = parsed.pathname.toLowerCase();
|
|
36
|
+
const alert = `code-scanning/${number}`;
|
|
37
|
+
if (path === `/${name}/${alert}` || path === `/${name}/security/${alert}`)
|
|
38
|
+
return `${host}/${name}/${alert}/`;
|
|
40
39
|
}
|
|
41
|
-
function
|
|
42
|
-
const
|
|
43
|
-
const alert =
|
|
40
|
+
function codeScanningSource(record) {
|
|
41
|
+
const name = repositoryName(record["repository"]);
|
|
42
|
+
const alert = asRecord(record["alert"]);
|
|
44
43
|
const number = record["number"];
|
|
45
44
|
if (!alert ||
|
|
46
45
|
typeof number !== "number" ||
|
|
@@ -51,18 +50,23 @@ function codeScanningFinding(record, target = "cloud") {
|
|
|
51
50
|
const url = text(record["url"]);
|
|
52
51
|
if (!url || url !== alert["html_url"])
|
|
53
52
|
throw new Error("GitHub alert URL must match the original alert.");
|
|
54
|
-
const
|
|
55
|
-
|
|
56
|
-
|
|
53
|
+
const link = sourceUrl(url);
|
|
54
|
+
const prefix = codeScanningPrefix(link, name, number);
|
|
55
|
+
if (!prefix)
|
|
57
56
|
throw new Error("GitHub alert URL does not match the selected repository and alert.");
|
|
58
|
-
const
|
|
59
|
-
|
|
57
|
+
const repository = { url: `${link.origin}/${name}`, name };
|
|
58
|
+
return { alert, number, prefix, url, repository };
|
|
59
|
+
}
|
|
60
|
+
function codeScanningFinding(record) {
|
|
61
|
+
const { alert, number, prefix, url, repository } = codeScanningSource(record);
|
|
62
|
+
const rule = asRecord(alert["rule"]);
|
|
63
|
+
const instance = asRecord(alert["most_recent_instance"]);
|
|
60
64
|
const ref = text(instance?.["ref"]);
|
|
61
65
|
if (!ref)
|
|
62
66
|
throw new Error("GitHub code-scanning evidence requires the selected instance ref.");
|
|
63
|
-
const location =
|
|
64
|
-
const tool =
|
|
65
|
-
const message = text(
|
|
67
|
+
const location = asRecord(instance?.["location"]);
|
|
68
|
+
const tool = asRecord(alert["tool"]);
|
|
69
|
+
const message = text(asRecord(instance?.["message"])?.["text"]);
|
|
66
70
|
const description = text(rule?.["full_description"]) ?? text(rule?.["description"]);
|
|
67
71
|
const tags = Array.isArray(rule?.["tags"]) ? rule["tags"] : [];
|
|
68
72
|
const weaknessIds = [
|
|
@@ -74,30 +78,25 @@ function codeScanningFinding(record, target = "cloud") {
|
|
|
74
78
|
})),
|
|
75
79
|
];
|
|
76
80
|
const path = text(location?.["path"]);
|
|
77
|
-
const sourceId = `${host}/${repository.toLowerCase()}/code-scanning/${number}/${hash("sha256", ref)}`;
|
|
78
81
|
return {
|
|
79
|
-
source_finding_id:
|
|
80
|
-
evidence:
|
|
82
|
+
source_finding_id: prefix + hash("sha256", ref),
|
|
83
|
+
evidence: {
|
|
81
84
|
title: text(rule?.["name"]) ??
|
|
82
85
|
text(rule?.["description"]) ??
|
|
83
86
|
`GitHub code-scanning alert #${number}`,
|
|
84
|
-
|
|
87
|
+
// SARIF error, warning and note describe diagnostics. Use the security rating.
|
|
88
|
+
severity: scannerSeverity(text(rule?.["security_severity_level"])),
|
|
85
89
|
description: [...new Set([message, description].filter(Boolean))].join("\n\n") ||
|
|
86
90
|
null,
|
|
87
91
|
url,
|
|
88
|
-
locations: path
|
|
89
|
-
? [{ path, line: location?.["start_line"] ?? null }]
|
|
90
|
-
: [],
|
|
92
|
+
locations: path ? [{ path, line: location?.["start_line"] ?? null }] : [],
|
|
91
93
|
branch: ref,
|
|
92
94
|
code_revision: text(instance?.["commit_sha"]),
|
|
93
95
|
source_updated_at: sourceTimestamp(alert["updated_at"]),
|
|
94
96
|
source_data: record,
|
|
95
97
|
details: {
|
|
96
98
|
kind: "sast",
|
|
97
|
-
repository
|
|
98
|
-
url: `${origin}/${repository}`,
|
|
99
|
-
name: repository,
|
|
100
|
-
},
|
|
99
|
+
repository,
|
|
101
100
|
// Dismissal covers every branch; detection state belongs to the selected ref.
|
|
102
101
|
source_status: alert["state"] === "dismissed"
|
|
103
102
|
? "dismissed"
|
|
@@ -108,12 +107,15 @@ function codeScanningFinding(record, target = "cloud") {
|
|
|
108
107
|
remediation_instructions: text(rule?.["help"]),
|
|
109
108
|
code: path ? { end_line: location?.["end_line"] ?? null } : null,
|
|
110
109
|
},
|
|
111
|
-
},
|
|
110
|
+
},
|
|
112
111
|
};
|
|
113
112
|
}
|
|
114
|
-
function
|
|
115
|
-
|
|
116
|
-
|
|
113
|
+
function advisorySourceId(host, selection, repository, id) {
|
|
114
|
+
return `${host}/${selection === "repository" ? repository.toLowerCase() : "global"}/security-advisory/${id.toUpperCase()}`;
|
|
115
|
+
}
|
|
116
|
+
function advisorySource(record) {
|
|
117
|
+
const name = repositoryName(record["repository"]);
|
|
118
|
+
const advisory = asRecord(record["advisory"]);
|
|
117
119
|
const id = text(record["ghsaId"]);
|
|
118
120
|
const selection = record["selection"];
|
|
119
121
|
if (!advisory ||
|
|
@@ -131,12 +133,17 @@ function advisoryFinding(record, target = "cloud") {
|
|
|
131
133
|
// Enterprise APIs may return the public advisory database's canonical link.
|
|
132
134
|
const canonicalGlobalLink = selection === "global" && parsedUrl.host === "github.com";
|
|
133
135
|
const expectedPath = selection === "repository"
|
|
134
|
-
? `/${
|
|
136
|
+
? `/${name}/security/advisories/${id}`
|
|
135
137
|
: `/advisories/${id}`;
|
|
136
138
|
if (!host ||
|
|
137
139
|
(linkHost !== host && !canonicalGlobalLink) ||
|
|
138
140
|
parsedUrl.pathname.toLowerCase() !== expectedPath.toLowerCase())
|
|
139
141
|
throw new Error("GitHub advisory URL does not match the selected source and GHSA ID.");
|
|
142
|
+
const repository = { url: `${origin}/${name}`, name };
|
|
143
|
+
return { advisory, id, selection, url, host, repository };
|
|
144
|
+
}
|
|
145
|
+
function advisoryFinding(record) {
|
|
146
|
+
const { advisory, id, selection, url, host, repository } = advisorySource(record);
|
|
140
147
|
const vulnerabilities = advisory["vulnerabilities"] === null ? [] : advisory["vulnerabilities"];
|
|
141
148
|
if (!Array.isArray(vulnerabilities))
|
|
142
149
|
throw new Error("GitHub advisory vulnerabilities must be an array.");
|
|
@@ -146,11 +153,11 @@ function advisoryFinding(record, target = "cloud") {
|
|
|
146
153
|
const advisoryIds = [
|
|
147
154
|
id,
|
|
148
155
|
text(advisory["cve_id"]),
|
|
149
|
-
...identifiers.map((identifier) => text(
|
|
156
|
+
...identifiers.map((identifier) => text(asRecord(identifier)?.["value"])),
|
|
150
157
|
].filter((value) => value !== null);
|
|
151
158
|
const packages = vulnerabilities.flatMap((value) => {
|
|
152
|
-
const vulnerability =
|
|
153
|
-
const pkg =
|
|
159
|
+
const vulnerability = asRecord(value);
|
|
160
|
+
const pkg = asRecord(vulnerability?.["package"]);
|
|
154
161
|
const name = text(pkg?.["name"]);
|
|
155
162
|
// GitHub permits incomplete package metadata in advisory disclosures.
|
|
156
163
|
// Preserve it in source_data without inventing a typed package identity.
|
|
@@ -169,10 +176,10 @@ function advisoryFinding(record, target = "cloud") {
|
|
|
169
176
|
});
|
|
170
177
|
const cwes = Array.isArray(advisory["cwes"]) ? advisory["cwes"] : [];
|
|
171
178
|
return {
|
|
172
|
-
source_finding_id:
|
|
173
|
-
evidence:
|
|
179
|
+
source_finding_id: advisorySourceId(host, selection, repository.name, id),
|
|
180
|
+
evidence: {
|
|
174
181
|
title: text(advisory["summary"]) ?? id,
|
|
175
|
-
severity:
|
|
182
|
+
severity: scannerSeverity(text(advisory["severity"])),
|
|
176
183
|
description: text(advisory["description"]),
|
|
177
184
|
url,
|
|
178
185
|
advisory_ids: [...new Set(advisoryIds)],
|
|
@@ -182,69 +189,375 @@ function advisoryFinding(record, target = "cloud") {
|
|
|
182
189
|
details: {
|
|
183
190
|
kind: "advisory",
|
|
184
191
|
advisory: { source: selection },
|
|
185
|
-
...(selection === "repository"
|
|
186
|
-
? {
|
|
187
|
-
repository: {
|
|
188
|
-
url: `${origin}/${repository}`,
|
|
189
|
-
name: repository,
|
|
190
|
-
},
|
|
191
|
-
}
|
|
192
|
-
: {}),
|
|
192
|
+
...(selection === "repository" ? { repository } : {}),
|
|
193
193
|
source_status: text(advisory["withdrawn_at"])
|
|
194
194
|
? "withdrawn"
|
|
195
195
|
: (text(advisory["state"]) ??
|
|
196
196
|
(selection === "global" ? "published" : null)),
|
|
197
197
|
scanner_origin: "GitHub Security Advisories",
|
|
198
198
|
weakness_ids: cwes
|
|
199
|
-
.map((value) => text(
|
|
199
|
+
.map((value) => text(asRecord(value)?.["cwe_id"]))
|
|
200
200
|
.filter((value) => value !== null),
|
|
201
201
|
},
|
|
202
|
-
},
|
|
202
|
+
},
|
|
203
203
|
};
|
|
204
204
|
}
|
|
205
|
-
|
|
205
|
+
/** Keep the repository from a retained collector export when SDK callers supply their own projection. */
|
|
206
|
+
export function retainedGitHubRepository({ evidence }, repositoryKey = cloudRepositoryUrlKey) {
|
|
207
|
+
const data = evidence.source_data;
|
|
208
|
+
if (!data?.["url"] || !data["repository"])
|
|
209
|
+
return;
|
|
210
|
+
let source;
|
|
211
|
+
if (data["source"] === "github-code-scanning" &&
|
|
212
|
+
data["number"] !== undefined &&
|
|
213
|
+
asRecord(data["alert"])?.["html_url"]) {
|
|
214
|
+
source = codeScanningSource(data);
|
|
215
|
+
}
|
|
216
|
+
else if (data["source"] === "github-security-advisory" &&
|
|
217
|
+
data["ghsaId"] &&
|
|
218
|
+
data["githubHost"] &&
|
|
219
|
+
data["selection"] &&
|
|
220
|
+
asRecord(data["advisory"])?.["html_url"]) {
|
|
221
|
+
source = advisorySource(data);
|
|
222
|
+
if (source.selection === "global") {
|
|
223
|
+
if (evidence.details?.repository)
|
|
224
|
+
throw new CodexSecurityError("Global advisory evidence cannot claim a source repository.");
|
|
225
|
+
return;
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
else
|
|
229
|
+
return;
|
|
230
|
+
const native = source.repository.url;
|
|
231
|
+
const projected = evidence.details?.repository?.url;
|
|
232
|
+
if (projected && repositoryKey(projected) !== repositoryKey(native))
|
|
233
|
+
throw new CodexSecurityError("The normalized repository does not match the original GitHub finding.");
|
|
234
|
+
return native;
|
|
235
|
+
}
|
|
236
|
+
function mapRecord(input) {
|
|
237
|
+
const record = asRecord(input);
|
|
238
|
+
if (!record)
|
|
239
|
+
throw new Error("GitHub finding must be an object.");
|
|
240
|
+
if (record["source"] === "github-code-scanning")
|
|
241
|
+
return codeScanningFinding(record);
|
|
242
|
+
if (record["source"] === "github-security-advisory")
|
|
243
|
+
return advisoryFinding(record);
|
|
244
|
+
throw new Error("Expected saved output from import github or import github-advisories; raw or incomplete API responses need an explicit mapping.");
|
|
245
|
+
}
|
|
246
|
+
function ownData(value, key) {
|
|
247
|
+
if (value && typeof value === "object" && !isProxy(value))
|
|
248
|
+
return Object.getOwnPropertyDescriptor(value, key)?.value;
|
|
249
|
+
}
|
|
250
|
+
function priorAdvisoryId(value) {
|
|
251
|
+
if (ownData(value, "source") !== "github-security-advisory")
|
|
252
|
+
return;
|
|
253
|
+
const id = text(ownData(value, "ghsaId"));
|
|
254
|
+
const host = text(ownData(value, "githubHost"))?.toLowerCase();
|
|
255
|
+
const selection = ownData(value, "selection");
|
|
256
|
+
const repository = text(ownData(value, "repository"));
|
|
257
|
+
if (id &&
|
|
258
|
+
GHSA_ID.test(id) &&
|
|
259
|
+
host &&
|
|
260
|
+
repository &&
|
|
261
|
+
githubRepositoryParts(repository) &&
|
|
262
|
+
(selection === "repository" || selection === "global"))
|
|
263
|
+
return advisorySourceId(host, selection, repository, id);
|
|
264
|
+
}
|
|
265
|
+
// Determine whether JSON can call a serializer without evaluating a getter.
|
|
266
|
+
function maySerialize(value) {
|
|
267
|
+
while (value && typeof value === "object") {
|
|
268
|
+
if (isProxy(value))
|
|
269
|
+
return true;
|
|
270
|
+
const field = Object.getOwnPropertyDescriptor(value, "toJSON");
|
|
271
|
+
if (field)
|
|
272
|
+
return (!Object.hasOwn(field, "value") || typeof field.value === "function");
|
|
273
|
+
value = Object.getPrototypeOf(value);
|
|
274
|
+
}
|
|
275
|
+
return false;
|
|
276
|
+
}
|
|
277
|
+
function codeOccurrencePrefix(value) {
|
|
278
|
+
const repository = ownData(value, "repository"), number = ownData(value, "number"), url = ownData(value, "url");
|
|
279
|
+
if (ownData(value, "source") !== "github-code-scanning" ||
|
|
280
|
+
typeof repository !== "string" ||
|
|
281
|
+
!githubRepositoryParts(repository) ||
|
|
282
|
+
typeof number !== "number" ||
|
|
283
|
+
!Number.isSafeInteger(number) ||
|
|
284
|
+
number <= 0 ||
|
|
285
|
+
typeof url !== "string")
|
|
286
|
+
return;
|
|
287
|
+
try {
|
|
288
|
+
return codeScanningPrefix(sourceUrl(url), repository, number);
|
|
289
|
+
}
|
|
290
|
+
catch {
|
|
291
|
+
/* No validated occurrence anchor. */
|
|
292
|
+
}
|
|
293
|
+
}
|
|
294
|
+
// The released reader measured the caller's source_data JSON before native capture.
|
|
295
|
+
function captureGitHubRecord(input, target) {
|
|
296
|
+
// Only plain records, arrays and standard Buffers have a reconstructable wire size.
|
|
297
|
+
let plainBuffers = [];
|
|
298
|
+
let hiddenFields = false;
|
|
299
|
+
let largeLocalRow = false;
|
|
300
|
+
const record = cloneWithoutGetters(input, (value) => {
|
|
301
|
+
const prototype = Object.getPrototypeOf(value);
|
|
302
|
+
if (target === "local" &&
|
|
303
|
+
((Array.isArray(value) && value.length > 256 * 1024) ||
|
|
304
|
+
(prototype === Buffer.prototype &&
|
|
305
|
+
Buffer.isBuffer(value) &&
|
|
306
|
+
!Object.hasOwn(value, "byteLength") &&
|
|
307
|
+
value.byteLength > 256 * 1024))) {
|
|
308
|
+
largeLocalRow = true;
|
|
309
|
+
return false;
|
|
310
|
+
}
|
|
311
|
+
// Native capture drops non-enumerable fields the released vendor mapper could read.
|
|
312
|
+
if (!Array.isArray(value) &&
|
|
313
|
+
!ArrayBuffer.isView(value) &&
|
|
314
|
+
!isBoxedPrimitive(value) &&
|
|
315
|
+
!isDate(value) &&
|
|
316
|
+
Object.getOwnPropertyNames(value).some((key) => key !== "toJSON" &&
|
|
317
|
+
!Object.prototype.propertyIsEnumerable.call(value, key)))
|
|
318
|
+
hiddenFields = true;
|
|
319
|
+
if (!plainBuffers)
|
|
320
|
+
return;
|
|
321
|
+
if (Buffer.isBuffer(value)) {
|
|
322
|
+
if (prototype === Buffer.prototype &&
|
|
323
|
+
!Object.hasOwn(value, "toJSON") &&
|
|
324
|
+
!Object.hasOwn(value, "length") &&
|
|
325
|
+
!("_arr" in value))
|
|
326
|
+
plainBuffers.push(value);
|
|
327
|
+
else
|
|
328
|
+
plainBuffers = undefined;
|
|
329
|
+
}
|
|
330
|
+
else if ((prototype !== Object.prototype &&
|
|
331
|
+
prototype !== null &&
|
|
332
|
+
prototype !== Array.prototype) ||
|
|
333
|
+
maySerialize(value))
|
|
334
|
+
plainBuffers = undefined;
|
|
335
|
+
});
|
|
336
|
+
return {
|
|
337
|
+
record: asRecord(record),
|
|
338
|
+
hiddenFields,
|
|
339
|
+
plainBuffers,
|
|
340
|
+
largeLocalRow,
|
|
341
|
+
};
|
|
342
|
+
}
|
|
343
|
+
function normalizeRecords(records, target = "cloud", snapshot = false) {
|
|
206
344
|
const result = {
|
|
207
345
|
read: records.length,
|
|
208
346
|
findings: [],
|
|
209
347
|
excluded: [],
|
|
210
348
|
};
|
|
349
|
+
const previous = snapshot
|
|
350
|
+
? { read: records.length, findings: [], excluded: [] }
|
|
351
|
+
: undefined;
|
|
352
|
+
const checks = [];
|
|
353
|
+
const uncertainIds = new Set();
|
|
354
|
+
const unidentifiedRows = new Set();
|
|
355
|
+
let independentlyObserved = Infinity;
|
|
356
|
+
let ranRootSerializer = false;
|
|
357
|
+
let largeLocalSelection = false;
|
|
358
|
+
const potentialIds = [];
|
|
359
|
+
const prefixes = new Set();
|
|
211
360
|
const identities = new Set();
|
|
212
|
-
for (const [index,
|
|
213
|
-
const
|
|
361
|
+
for (const [index, input] of records.entries()) {
|
|
362
|
+
const afterRootSerializer = ranRootSerializer;
|
|
363
|
+
const keySensitive = previous !== undefined && maySerialize(input);
|
|
364
|
+
ranRootSerializer ||= keySensitive;
|
|
365
|
+
let exported = input;
|
|
366
|
+
const capture = previous ? captureGitHubRecord(input, target) : undefined;
|
|
367
|
+
const before = capture?.record;
|
|
368
|
+
const priorPrefix = previous ? codeOccurrencePrefix(input) : undefined;
|
|
369
|
+
let priorId = previous ? priorAdvisoryId(input) : undefined;
|
|
370
|
+
let prefix = priorPrefix;
|
|
371
|
+
const rowIds = new Set();
|
|
372
|
+
let rowUncertain = false;
|
|
373
|
+
const priorRowCount = previous?.findings.length ?? 0;
|
|
374
|
+
function possible() {
|
|
375
|
+
rowUncertain = true;
|
|
376
|
+
// A caller getter can mutate a later row before its native evidence is seen.
|
|
377
|
+
independentlyObserved = Math.min(independentlyObserved, priorRowCount);
|
|
378
|
+
for (const id of rowIds)
|
|
379
|
+
uncertainIds.add(id);
|
|
380
|
+
if (prefix)
|
|
381
|
+
prefixes.add(prefix);
|
|
382
|
+
if (priorId)
|
|
383
|
+
uncertainIds.add(priorId);
|
|
384
|
+
else if (!priorPrefix)
|
|
385
|
+
unidentifiedRows.add(index);
|
|
386
|
+
}
|
|
387
|
+
// The old reader called a root serializer with "source_data" rather than its
|
|
388
|
+
// array index. That code could change a later occurrence before it was read.
|
|
389
|
+
if (afterRootSerializer) {
|
|
390
|
+
possible();
|
|
391
|
+
unidentifiedRows.add(index);
|
|
392
|
+
}
|
|
393
|
+
function retainPrevious(selection, id, evidence) {
|
|
394
|
+
selection.findings.push({ source_finding_id: id, evidence });
|
|
395
|
+
potentialIds.push(id);
|
|
396
|
+
checks.push(() => {
|
|
397
|
+
if (!isDeepStrictEqual(before, asRecord(cloneWithoutGetters(input))))
|
|
398
|
+
possible();
|
|
399
|
+
});
|
|
400
|
+
}
|
|
401
|
+
const exclusion = (record, reason) => ({
|
|
402
|
+
position: index + 1,
|
|
403
|
+
source_finding_id: text(asRecord(record)?.["url"]),
|
|
404
|
+
reason,
|
|
405
|
+
});
|
|
406
|
+
let possibleFreshId = false;
|
|
214
407
|
try {
|
|
215
|
-
if (
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
408
|
+
if (previous && capture) {
|
|
409
|
+
const source = exportedGitHubRecord(input, index, target, target === "local" && !capture.largeLocalRow);
|
|
410
|
+
exported = source.record;
|
|
411
|
+
prefix ??= codeOccurrencePrefix(exported);
|
|
412
|
+
// A serializer or Buffer can expand a native record that fit the approved request.
|
|
413
|
+
const oversizedLocalRow = target === "local" &&
|
|
414
|
+
(capture.largeLocalRow ||
|
|
415
|
+
(source.bytes > 256 * 1024 &&
|
|
416
|
+
(!before || capture.plainBuffers?.length === 0)));
|
|
417
|
+
if (oversizedLocalRow || !before) {
|
|
418
|
+
if (!oversizedLocalRow &&
|
|
419
|
+
source.previousInvalid &&
|
|
420
|
+
!source.skippedRawValue &&
|
|
421
|
+
canSnapshotWithoutGetters(input)) {
|
|
422
|
+
previous.excluded.push(exclusion(exported, errorMessage(source.previousInvalid)));
|
|
423
|
+
}
|
|
424
|
+
else if (target !== "local" &&
|
|
425
|
+
source.bytes + source.adjustment > 256 * 1024 &&
|
|
426
|
+
canSnapshotWithoutGetters(input) &&
|
|
427
|
+
!keySensitive) {
|
|
428
|
+
previous.excluded.push(exclusion(exported, "Evidence exceeds the Cloud limit of 256 KiB."));
|
|
429
|
+
}
|
|
430
|
+
else {
|
|
431
|
+
largeLocalSelection ||= oversizedLocalRow;
|
|
432
|
+
// An occurrence without independent native evidence can only stop a retry.
|
|
433
|
+
possible();
|
|
434
|
+
possibleFreshId = true;
|
|
435
|
+
}
|
|
436
|
+
}
|
|
437
|
+
else {
|
|
438
|
+
if (capture.hiddenFields || source.skippedRawValue)
|
|
439
|
+
possible();
|
|
440
|
+
try {
|
|
441
|
+
const row = mapRecord(before);
|
|
442
|
+
const knownOldId = row.source_finding_id;
|
|
443
|
+
priorId = knownOldId;
|
|
444
|
+
if (!afterRootSerializer)
|
|
445
|
+
unidentifiedRows.delete(index);
|
|
446
|
+
rowIds.add(knownOldId);
|
|
447
|
+
if (rowUncertain)
|
|
448
|
+
uncertainIds.add(knownOldId);
|
|
449
|
+
const evidence = validateExternalEvidenceFields(row.evidence, target);
|
|
450
|
+
if (source.previousInvalid)
|
|
451
|
+
throw source.previousInvalid;
|
|
452
|
+
if (keySensitive)
|
|
453
|
+
possible();
|
|
454
|
+
const reason = keySensitive || target === "local"
|
|
455
|
+
? undefined
|
|
456
|
+
: previousGitHubExclusion(evidence, source.bytes, source.adjustment);
|
|
457
|
+
if (reason)
|
|
458
|
+
previous.excluded.push(exclusion(before, reason));
|
|
459
|
+
else
|
|
460
|
+
retainPrevious(previous, knownOldId, evidence);
|
|
461
|
+
}
|
|
462
|
+
catch (error) {
|
|
463
|
+
previous.excluded.push(exclusion(before, errorMessage(error)));
|
|
464
|
+
}
|
|
465
|
+
}
|
|
466
|
+
if (source.invalid)
|
|
467
|
+
throw source.invalid;
|
|
468
|
+
}
|
|
469
|
+
const mapped = mapRecord(exported), id = mapped.source_finding_id;
|
|
470
|
+
rowIds.add(id);
|
|
471
|
+
if (rowUncertain)
|
|
472
|
+
uncertainIds.add(id);
|
|
473
|
+
if (possibleFreshId)
|
|
474
|
+
potentialIds.push(id);
|
|
475
|
+
const evidence = validateExternalEvidence(mapped.evidence, target);
|
|
476
|
+
if (identities.has(id))
|
|
477
|
+
throw new CodexSecurityError(`Duplicate source finding id ${JSON.stringify(id)}. Select each GitHub occurrence once.`);
|
|
478
|
+
identities.add(id);
|
|
479
|
+
result.findings.push({ source_finding_id: id, evidence });
|
|
228
480
|
}
|
|
229
481
|
catch (error) {
|
|
230
482
|
if (error instanceof CodexSecurityError)
|
|
231
483
|
throw error;
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
484
|
+
const reason = errorMessage(error);
|
|
485
|
+
result.excluded.push(exclusion(snapshot && exported === input
|
|
486
|
+
? { url: ownData(input, "url") }
|
|
487
|
+
: exported, reason));
|
|
488
|
+
if (previous && exported === input) {
|
|
489
|
+
if (error instanceof CloudEvidenceDepthError &&
|
|
490
|
+
before &&
|
|
491
|
+
// Extra Buffer fields were inspected by the old row validator, but
|
|
492
|
+
// structuredClone does not retain them as part of the typed array.
|
|
493
|
+
capture?.plainBuffers?.every((buffer) => Object.keys(buffer).length === buffer.length)) {
|
|
494
|
+
// Exported JSON can be deeper than an approved native snapshot.
|
|
495
|
+
// Retain only the independently observed, valid prior selection.
|
|
496
|
+
try {
|
|
497
|
+
const row = mapRecord(before);
|
|
498
|
+
const evidence = validateExternalEvidence(row.evidence, target);
|
|
499
|
+
const savedSource = JSON.stringify(evidence.source_data);
|
|
500
|
+
// structuredClone turns each Buffer into a Uint8Array. Reconstruct its
|
|
501
|
+
// original serialized size on detached data without running caller hooks.
|
|
502
|
+
const oldSource = JSON.stringify(evidence.source_data, (_key, value) => value instanceof Uint8Array
|
|
503
|
+
? { type: "Buffer", data: [...value] }
|
|
504
|
+
: value);
|
|
505
|
+
validateExternalEvidenceJson(evidence, target, Buffer.byteLength(oldSource) - Buffer.byteLength(savedSource));
|
|
506
|
+
retainPrevious(previous, row.source_finding_id, evidence);
|
|
507
|
+
}
|
|
508
|
+
catch (priorError) {
|
|
509
|
+
previous.excluded.push(exclusion(before, errorMessage(priorError)));
|
|
510
|
+
}
|
|
511
|
+
continue;
|
|
512
|
+
}
|
|
513
|
+
// A serializer may throw at its array key while the old source_data
|
|
514
|
+
// key produced a valid record. Keep only evidence for refusing a match.
|
|
515
|
+
possible();
|
|
516
|
+
if (before)
|
|
517
|
+
try {
|
|
518
|
+
const id = mapRecord(before).source_finding_id;
|
|
519
|
+
priorId = id;
|
|
520
|
+
if (!afterRootSerializer)
|
|
521
|
+
unidentifiedRows.delete(index);
|
|
522
|
+
potentialIds.push(id);
|
|
523
|
+
uncertainIds.add(id);
|
|
524
|
+
}
|
|
525
|
+
catch {
|
|
526
|
+
/* No old identity. */
|
|
527
|
+
}
|
|
528
|
+
}
|
|
529
|
+
}
|
|
530
|
+
}
|
|
531
|
+
if (previous) {
|
|
532
|
+
for (const check of checks)
|
|
533
|
+
check();
|
|
534
|
+
const uncertain = independentlyObserved !== Infinity;
|
|
535
|
+
if (uncertain || !isDeepStrictEqual(previous.findings, result.findings)) {
|
|
536
|
+
const prior = { sourceFindingIds: potentialIds };
|
|
537
|
+
if (uncertain) {
|
|
538
|
+
prior.unprovenIdPrefixes = [...prefixes];
|
|
539
|
+
prior.uncertainFindingIds = [...uncertainIds];
|
|
540
|
+
if (unidentifiedRows.size)
|
|
541
|
+
prior.unprovenOccurrenceCount = unidentifiedRows.size;
|
|
542
|
+
if (!largeLocalSelection)
|
|
543
|
+
prior.knownFindings = previous.findings
|
|
544
|
+
.slice(0, independentlyObserved)
|
|
545
|
+
.filter((finding) => !uncertainIds.has(finding.source_finding_id));
|
|
546
|
+
}
|
|
547
|
+
else
|
|
548
|
+
prior.snapshot = previous;
|
|
549
|
+
rememberPreviousSelection(result, prior);
|
|
237
550
|
}
|
|
238
551
|
}
|
|
239
552
|
return result;
|
|
240
553
|
}
|
|
241
554
|
/** Map selected code-scanning instances while retaining complete upstream evidence. */
|
|
242
555
|
export function normalizeGitHubCodeScanningAlerts(alerts, target = "cloud") {
|
|
243
|
-
return normalizeRecords(alerts, target);
|
|
556
|
+
return normalizeRecords(alerts, target, true);
|
|
244
557
|
}
|
|
245
558
|
/** Map advisory disclosures without asserting an installed vulnerable dependency. */
|
|
246
559
|
export function normalizeGitHubAdvisories(advisories, target = "cloud") {
|
|
247
|
-
return normalizeRecords(advisories, target);
|
|
560
|
+
return normalizeRecords(advisories, target, true);
|
|
248
561
|
}
|
|
249
562
|
/** Read unfiltered JSON/JSONL output saved by the read-only GitHub import commands. */
|
|
250
563
|
export async function readGitHubFindings(path, target = "cloud") {
|