@openai/codex-security 0.8.3 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +192 -151
- package/_bundled_plugin/.mcp.json +5 -1
- package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
- package/_bundled_plugin/examples/completed-scan/report.md +11 -8
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
- package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
- package/_bundled_plugin/mcp/helpers.mjs +2 -11
- package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
- package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
- package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
- package/_bundled_plugin/mcp/package.json +1 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
- package/_bundled_plugin/mcp/server.mjs +2 -11
- package/_bundled_plugin/mcp/server.mjs.br +0 -0
- package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
- package/_bundled_plugin/references/default-severity-rubric.md +9 -4
- package/_bundled_plugin/references/final-report.md +5 -3
- package/_bundled_plugin/references/finding-detail-fields.md +18 -18
- package/_bundled_plugin/references/sarif-adapter.md +8 -2
- package/_bundled_plugin/references/scan-artifacts.md +21 -12
- package/_bundled_plugin/references/scan-contract.md +27 -33
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
- package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
- package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
- package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
- package/_bundled_plugin/scripts/deep_scan_workbench.py +165 -342
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +153 -227
- package/_bundled_plugin/scripts/finding_preview.py +20 -0
- package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
- package/_bundled_plugin/scripts/legacy_findings.py +148 -0
- package/_bundled_plugin/scripts/posix_scan_local_files.py +11 -0
- package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
- package/_bundled_plugin/scripts/report_projection.py +81 -43
- package/_bundled_plugin/scripts/review_state.py +8 -2
- package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
- package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
- package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
- package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
- package/_bundled_plugin/scripts/windows_scan_local_files.py +388 -17
- package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
- package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
- package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
- package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
- package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
- package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
- package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
- package/_bundled_plugin/scripts/workbench/storage.py +71 -7
- package/_bundled_plugin/scripts/workbench_cli.py +30 -12
- package/_bundled_plugin/scripts/workbench_constants.py +10 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
- package/_bundled_plugin/scripts/workbench_db.py +369 -137
- package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
- package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
- package/_bundled_plugin/scripts/workbench_native_indexes.py +12 -12
- package/_bundled_plugin/scripts/workbench_progress.py +10 -1
- package/_bundled_plugin/scripts/workbench_publication.py +14 -10
- package/_bundled_plugin/scripts/workbench_remediation.py +13 -0
- package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
- package/_bundled_plugin/scripts/workbench_scan_history.py +117 -55
- package/_bundled_plugin/scripts/workbench_scan_start.py +83 -24
- package/_bundled_plugin/scripts/workbench_scan_usage.py +644 -68
- package/_bundled_plugin/scripts/workbench_schema.py +44 -55
- package/_bundled_plugin/scripts/workbench_setup.py +13 -1
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
- package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
- package/_bundled_plugin/scripts/workbench_target.py +127 -56
- package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
- package/_bundled_plugin/scripts/workbench_validation.py +43 -3
- package/_bundled_plugin/shared/workbench-history-repairs.json +19 -23
- package/_bundled_plugin/shared/workbench-migrations.json +34 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
- package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -1
- package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -25
- package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
- package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
- package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
- package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
- package/dist/api.d.ts +39 -4
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +774 -292
- package/dist/api.js.map +1 -1
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +4 -6
- package/dist/auth.js.map +1 -1
- package/dist/bedrock-oss-pricing.d.ts +6 -0
- package/dist/bedrock-oss-pricing.d.ts.map +1 -0
- package/dist/bedrock-oss-pricing.js +58 -0
- package/dist/bedrock-oss-pricing.js.map +1 -0
- package/dist/bedrock-pricing.d.ts +15 -0
- package/dist/bedrock-pricing.d.ts.map +1 -0
- package/dist/bedrock-pricing.js +117 -0
- package/dist/bedrock-pricing.js.map +1 -0
- package/dist/blackduck-findings.d.ts.map +1 -1
- package/dist/blackduck-findings.js +35 -20
- package/dist/blackduck-findings.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +4 -4
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/checkmarx-evidence.d.ts +19 -0
- package/dist/checkmarx-evidence.d.ts.map +1 -0
- package/dist/checkmarx-evidence.js +36 -0
- package/dist/checkmarx-evidence.js.map +1 -0
- package/dist/checkmarx-findings.d.ts +4 -0
- package/dist/checkmarx-findings.d.ts.map +1 -0
- package/dist/checkmarx-findings.js +27 -0
- package/dist/checkmarx-findings.js.map +1 -0
- package/dist/checkmarx-one.d.ts +4 -0
- package/dist/checkmarx-one.d.ts.map +1 -0
- package/dist/checkmarx-one.js +53 -0
- package/dist/checkmarx-one.js.map +1 -0
- package/dist/checkmarx-repository.d.ts +12 -0
- package/dist/checkmarx-repository.d.ts.map +1 -0
- package/dist/checkmarx-repository.js +181 -0
- package/dist/checkmarx-repository.js.map +1 -0
- package/dist/checkmarx-xml.d.ts +12 -0
- package/dist/checkmarx-xml.d.ts.map +1 -0
- package/dist/checkmarx-xml.js +196 -0
- package/dist/checkmarx-xml.js.map +1 -0
- package/dist/classify-severity-records.d.ts +1 -9
- package/dist/classify-severity-records.d.ts.map +1 -1
- package/dist/classify-severity-records.js +3 -13
- package/dist/classify-severity-records.js.map +1 -1
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +2 -4
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli.d.ts +11 -5
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1734 -1238
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.js +2 -2
- package/dist/cloud-publish.js.map +1 -1
- package/dist/component-scan.d.ts +16 -3
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +27 -2
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +100 -66
- package/dist/config.js.map +1 -1
- package/dist/continuum-findings.d.ts.map +1 -1
- package/dist/continuum-findings.js +80 -12
- package/dist/continuum-findings.js.map +1 -1
- package/dist/contract-values.d.ts +2 -0
- package/dist/contract-values.d.ts.map +1 -1
- package/dist/contract-values.js +12 -9
- package/dist/contract-values.js.map +1 -1
- package/dist/cost-model.d.ts +13 -1
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +66 -112
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +42 -3
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +483 -104
- package/dist/cost.js.map +1 -1
- package/dist/custom-publish.d.ts +4 -0
- package/dist/custom-publish.d.ts.map +1 -1
- package/dist/custom-publish.js +40 -3
- package/dist/custom-publish.js.map +1 -1
- package/dist/deduplication/local.d.ts +2 -2
- package/dist/deduplication/local.d.ts.map +1 -1
- package/dist/deduplication/local.js +2 -2
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/refusal.d.ts.map +1 -1
- package/dist/deduplication/refusal.js +25 -5
- package/dist/deduplication/refusal.js.map +1 -1
- package/dist/deduplication/scan.d.ts +3 -0
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +1 -1
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +0 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +22 -33
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-scan-defaults.d.ts +2 -0
- package/dist/deep-scan-defaults.d.ts.map +1 -1
- package/dist/deep-scan-defaults.js +28 -1
- package/dist/deep-scan-defaults.js.map +1 -1
- package/dist/deep-scan.d.ts +2 -0
- package/dist/deep-scan.d.ts.map +1 -1
- package/dist/deep-scan.js +28 -4
- package/dist/deep-scan.js.map +1 -1
- package/dist/default-severity-rubric.d.ts +1 -1
- package/dist/default-severity-rubric.d.ts.map +1 -1
- package/dist/default-severity-rubric.js +1 -1
- package/dist/default-severity-rubric.js.map +1 -1
- package/dist/endor-findings.d.ts +3 -1
- package/dist/endor-findings.d.ts.map +1 -1
- package/dist/endor-findings.js +103 -45
- package/dist/endor-findings.js.map +1 -1
- package/dist/errors.d.ts +1 -1
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +8 -1
- package/dist/errors.js.map +1 -1
- package/dist/external-findings-import.d.ts +5 -3
- package/dist/external-findings-import.d.ts.map +1 -1
- package/dist/external-findings-import.js +7 -6
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +7 -5
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +337 -89
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +8 -6
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +1318 -258
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +20 -2
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +148 -66
- package/dist/external-findings-read.js.map +1 -1
- package/dist/external-findings.d.ts +15 -3
- package/dist/external-findings.d.ts.map +1 -1
- package/dist/external-findings.js +42 -1
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +5 -1
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +23 -9
- package/dist/external-import-contract.js.map +1 -1
- package/dist/external-import-models.d.ts +1 -1
- package/dist/external-import-models.d.ts.map +1 -1
- package/dist/external-import-models.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +5 -4
- package/dist/feedback.js.map +1 -1
- package/dist/finding-prompt.d.ts +5 -0
- package/dist/finding-prompt.d.ts.map +1 -0
- package/dist/finding-prompt.js +32 -0
- package/dist/finding-prompt.js.map +1 -0
- package/dist/findings-client.d.ts +1 -0
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +27 -3
- package/dist/findings-client.js.map +1 -1
- package/dist/github-advisories.d.ts.map +1 -1
- package/dist/github-advisories.js +0 -2
- package/dist/github-advisories.js.map +1 -1
- package/dist/github-dependabot-findings.d.ts.map +1 -1
- package/dist/github-dependabot-findings.js +15 -4
- package/dist/github-dependabot-findings.js.map +1 -1
- package/dist/github-findings.d.ts +4 -1
- package/dist/github-findings.d.ts.map +1 -1
- package/dist/github-findings.js +55 -30
- package/dist/github-findings.js.map +1 -1
- package/dist/hosted-git-remotes.d.ts +5 -0
- package/dist/hosted-git-remotes.d.ts.map +1 -0
- package/dist/hosted-git-remotes.js +285 -0
- package/dist/hosted-git-remotes.js.map +1 -0
- package/dist/hosted-git-repository.d.ts +28 -0
- package/dist/hosted-git-repository.d.ts.map +1 -0
- package/dist/hosted-git-repository.js +222 -0
- package/dist/hosted-git-repository.js.map +1 -0
- package/dist/hosted-scan-protocol.js +2 -2
- package/dist/hosted-scan-protocol.js.map +1 -1
- package/dist/hosted-scan.d.ts.map +1 -1
- package/dist/hosted-scan.js +16 -11
- package/dist/hosted-scan.js.map +1 -1
- package/dist/hosted-scanner-http.d.ts +21 -0
- package/dist/hosted-scanner-http.d.ts.map +1 -0
- package/dist/hosted-scanner-http.js +204 -0
- package/dist/hosted-scanner-http.js.map +1 -0
- package/dist/hosted-scanner-v1.d.ts +6 -0
- package/dist/hosted-scanner-v1.d.ts.map +1 -0
- package/dist/hosted-scanner-v1.js +60 -0
- package/dist/hosted-scanner-v1.js.map +1 -0
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +3 -0
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +18 -7
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -2
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +47 -65
- package/dist/inspector-findings.js.map +1 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +68 -5
- package/dist/knowledge-base.js.map +1 -1
- package/dist/local-git-metadata.d.ts +1 -1
- package/dist/local-git-metadata.d.ts.map +1 -1
- package/dist/local-git-metadata.js +1 -2
- package/dist/local-git-metadata.js.map +1 -1
- package/dist/multiscan.d.ts +6 -4
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +138 -65
- package/dist/multiscan.js.map +1 -1
- package/dist/native-json-findings.d.ts +2 -1
- package/dist/native-json-findings.d.ts.map +1 -1
- package/dist/native-json-findings.js +12 -2
- package/dist/native-json-findings.js.map +1 -1
- package/dist/opengrep-findings.d.ts +1 -0
- package/dist/opengrep-findings.d.ts.map +1 -1
- package/dist/opengrep-findings.js +17 -13
- package/dist/opengrep-findings.js.map +1 -1
- package/dist/operation-telemetry.d.ts +104 -0
- package/dist/operation-telemetry.d.ts.map +1 -0
- package/dist/operation-telemetry.js +293 -0
- package/dist/operation-telemetry.js.map +1 -0
- package/dist/plugin-python-probe.d.ts +4 -0
- package/dist/plugin-python-probe.d.ts.map +1 -0
- package/dist/plugin-python-probe.js +10 -0
- package/dist/plugin-python-probe.js.map +1 -0
- package/dist/private-finding-import.d.ts +97 -2
- package/dist/private-finding-import.d.ts.map +1 -1
- package/dist/private-finding-import.js +58 -34
- package/dist/private-finding-import.js.map +1 -1
- package/dist/provider-profile.d.ts +1 -1
- package/dist/provider-profile.d.ts.map +1 -1
- package/dist/provider-profile.js +8 -1
- package/dist/provider-profile.js.map +1 -1
- package/dist/publication-telemetry.d.ts +45 -0
- package/dist/publication-telemetry.d.ts.map +1 -0
- package/dist/publication-telemetry.js +50 -0
- package/dist/publication-telemetry.js.map +1 -0
- package/dist/publish.d.ts +4 -0
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +42 -2
- package/dist/publish.js.map +1 -1
- package/dist/reader-selection.d.ts +2 -0
- package/dist/reader-selection.d.ts.map +1 -1
- package/dist/reader-selection.js +8 -0
- package/dist/reader-selection.js.map +1 -1
- package/dist/remediation.d.ts +1 -4
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +3 -7
- package/dist/remediation.js.map +1 -1
- package/dist/request-metadata.d.ts +3 -0
- package/dist/request-metadata.d.ts.map +1 -1
- package/dist/request-metadata.js +9 -0
- package/dist/request-metadata.js.map +1 -1
- package/dist/result.d.ts +4 -0
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +1 -1
- package/dist/result.js.map +1 -1
- package/dist/retry-windows-rename.d.ts +8 -0
- package/dist/retry-windows-rename.d.ts.map +1 -0
- package/dist/retry-windows-rename.js +24 -0
- package/dist/retry-windows-rename.js.map +1 -0
- package/dist/runtime.d.ts +20 -0
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +313 -110
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +1 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -1
- package/dist/saved-scan-bootstrap.js +18 -15
- package/dist/saved-scan-bootstrap.js.map +1 -1
- package/dist/scan-activity.d.ts.map +1 -1
- package/dist/scan-activity.js +141 -56
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +10 -5
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +60 -15
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +6 -6
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +75 -42
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts +10 -1
- package/dist/scan-executor.d.ts.map +1 -1
- package/dist/scan-executor.js +22 -2
- package/dist/scan-executor.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +9 -19
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-logs.d.ts +12 -0
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +106 -77
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-measurement.d.ts +26 -0
- package/dist/scan-measurement.d.ts.map +1 -0
- package/dist/scan-measurement.js +77 -0
- package/dist/scan-measurement.js.map +1 -0
- package/dist/scan-progress.d.ts +1 -0
- package/dist/scan-progress.d.ts.map +1 -1
- package/dist/scan-progress.js +3 -0
- package/dist/scan-progress.js.map +1 -1
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +4 -1
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-settings.d.ts +1 -1
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +1 -24
- package/dist/scan-settings.js.map +1 -1
- package/dist/scanner-import.d.ts +20 -2
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +200 -8
- package/dist/scanner-import.js.map +1 -1
- package/dist/scanner-repository-url.d.ts +4 -1
- package/dist/scanner-repository-url.d.ts.map +1 -1
- package/dist/scanner-repository-url.js +10 -6
- package/dist/scanner-repository-url.js.map +1 -1
- package/dist/security-policy.d.ts +1 -1
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js.map +1 -1
- package/dist/semgrep-findings.d.ts +6 -3
- package/dist/semgrep-findings.d.ts.map +1 -1
- package/dist/semgrep-findings.js +107 -43
- package/dist/semgrep-findings.js.map +1 -1
- package/dist/semgrep-guardian-findings.d.ts +38 -0
- package/dist/semgrep-guardian-findings.d.ts.map +1 -0
- package/dist/semgrep-guardian-findings.js +165 -0
- package/dist/semgrep-guardian-findings.js.map +1 -0
- package/dist/semgrep-platform-collector.d.ts +26 -0
- package/dist/semgrep-platform-collector.d.ts.map +1 -0
- package/dist/semgrep-platform-collector.js +108 -0
- package/dist/semgrep-platform-collector.js.map +1 -0
- package/dist/semgrep-platform-findings.d.ts +207 -6
- package/dist/semgrep-platform-findings.d.ts.map +1 -1
- package/dist/semgrep-platform-findings.js +983 -103
- package/dist/semgrep-platform-findings.js.map +1 -1
- package/dist/semgrep-platform-v1.d.ts +6 -0
- package/dist/semgrep-platform-v1.d.ts.map +1 -0
- package/dist/semgrep-platform-v1.js +83 -0
- package/dist/semgrep-platform-v1.js.map +1 -0
- package/dist/server/api.d.ts +1 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embedding-tokenizer.cdx.json +33 -0
- package/dist/server/embedding-tokenizer.d.ts +2 -0
- package/dist/server/embedding-tokenizer.d.ts.map +1 -0
- package/dist/server/embedding-tokenizer.js +322 -0
- package/dist/server/embedding-tokenizer.js.map +6 -0
- package/dist/server/embeddings.d.ts +16 -2
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +35 -5
- package/dist/server/embeddings.js.map +1 -1
- package/dist/session-lines.d.ts +5 -0
- package/dist/session-lines.d.ts.map +1 -0
- package/dist/session-lines.js +60 -0
- package/dist/session-lines.js.map +1 -0
- package/dist/severity-review.d.ts +3 -1
- package/dist/severity-review.d.ts.map +1 -1
- package/dist/severity-review.js +3 -2
- package/dist/severity-review.js.map +1 -1
- package/dist/skill-authentication.d.ts +1 -0
- package/dist/skill-authentication.d.ts.map +1 -1
- package/dist/skill-authentication.js +1 -0
- package/dist/skill-authentication.js.map +1 -1
- package/dist/snyk-findings.d.ts +7 -2
- package/dist/snyk-findings.d.ts.map +1 -1
- package/dist/snyk-findings.js +93 -70
- package/dist/snyk-findings.js.map +1 -1
- package/dist/snyk-rest-findings.d.ts +76 -0
- package/dist/snyk-rest-findings.d.ts.map +1 -0
- package/dist/snyk-rest-findings.js +1051 -0
- package/dist/snyk-rest-findings.js.map +1 -0
- package/dist/snyk-rest-v1.d.ts +28 -0
- package/dist/snyk-rest-v1.d.ts.map +1 -0
- package/dist/snyk-rest-v1.js +132 -0
- package/dist/snyk-rest-v1.js.map +1 -0
- package/dist/snyk-token-origin.d.ts +4 -0
- package/dist/snyk-token-origin.d.ts.map +1 -0
- package/dist/snyk-token-origin.js +82 -0
- package/dist/snyk-token-origin.js.map +1 -0
- package/dist/sonar-collector.d.ts.map +1 -1
- package/dist/sonar-collector.js +0 -3
- package/dist/sonar-collector.js.map +1 -1
- package/dist/sonar-import.d.ts.map +1 -1
- package/dist/sonar-import.js +2 -4
- package/dist/sonar-import.js.map +1 -1
- package/dist/target-drift.d.ts +9 -0
- package/dist/target-drift.d.ts.map +1 -0
- package/dist/target-drift.js +27 -0
- package/dist/target-drift.js.map +1 -0
- package/dist/targets.d.ts +2 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +56 -20
- package/dist/targets.js.map +1 -1
- package/dist/tenable-findings.d.ts +9 -0
- package/dist/tenable-findings.d.ts.map +1 -0
- package/dist/tenable-findings.js +122 -0
- package/dist/tenable-findings.js.map +1 -0
- package/dist/terminal-stream.d.ts +13 -0
- package/dist/terminal-stream.d.ts.map +1 -0
- package/dist/terminal-stream.js +35 -0
- package/dist/terminal-stream.js.map +1 -0
- package/dist/trivy-findings.d.ts +19 -0
- package/dist/trivy-findings.d.ts.map +1 -0
- package/dist/trivy-findings.js +435 -0
- package/dist/trivy-findings.js.map +1 -0
- package/dist/trivy-import.d.ts +19 -0
- package/dist/trivy-import.d.ts.map +1 -0
- package/dist/trivy-import.js +151 -0
- package/dist/trivy-import.js.map +1 -0
- package/dist/validation-records.js +1 -1
- package/dist/validation-records.js.map +1 -1
- package/dist/veracode-findings.d.ts +2 -0
- package/dist/veracode-findings.d.ts.map +1 -1
- package/dist/veracode-findings.js +49 -11
- package/dist/veracode-findings.js.map +1 -1
- package/dist/vertex-pricing.d.ts +8 -0
- package/dist/vertex-pricing.d.ts.map +1 -0
- package/dist/vertex-pricing.js +20 -0
- package/dist/vertex-pricing.js.map +1 -0
- package/dist/windows-path.d.ts +1 -0
- package/dist/windows-path.d.ts.map +1 -1
- package/dist/windows-path.js +26 -1
- package/dist/windows-path.js.map +1 -1
- package/dist/wiz-findings.d.ts +4 -0
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +57 -3
- package/dist/wiz-findings.js.map +1 -1
- package/docs/classify-severity-records.md +27 -12
- package/docs/cli.md +497 -550
- package/docs/dedupe-records.md +44 -24
- package/docs/findings-service.md +66 -39
- package/docs/hosted-remediation.md +14 -7
- package/docs/hosted-scans.md +50 -42
- package/docs/telemetry.md +236 -0
- package/docs/validate-records.md +78 -44
- package/package.json +18 -15
- package/schemas/external-findings.schema.json +3 -1
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
- package/dist/external-imports-feature.d.ts +0 -6
- package/dist/external-imports-feature.d.ts.map +0 -1
- package/dist/external-imports-feature.js +0 -51
- package/dist/external-imports-feature.js.map +0 -1
- package/dist/finding-normalization.d.ts +0 -5
- package/dist/finding-normalization.d.ts.map +0 -1
- package/dist/finding-normalization.js +0 -155
- package/dist/finding-normalization.js.map +0 -1
|
@@ -8,6 +8,7 @@ from pathlib import Path
|
|
|
8
8
|
|
|
9
9
|
_SHARED = Path(__file__).resolve().parents[1] / "shared"
|
|
10
10
|
_HISTORY = json.loads((_SHARED / "workbench-migrations.json").read_text(encoding="utf-8"))
|
|
11
|
+
_STATEMENTS = {migration["version"]: migration["statements"] for migration in _HISTORY}
|
|
11
12
|
_REPAIR_HISTORY = json.dumps(_HISTORY)
|
|
12
13
|
_REPAIR_PLAN = json.loads((_SHARED / "workbench-history-repairs.json").read_text(encoding="utf-8"))
|
|
13
14
|
MIGRATIONS = tuple(
|
|
@@ -52,6 +53,12 @@ def apply_migrations(
|
|
|
52
53
|
*,
|
|
53
54
|
immediate: bool = False,
|
|
54
55
|
) -> None:
|
|
56
|
+
"""Apply missing schema versions and repair supported historical migrations.
|
|
57
|
+
|
|
58
|
+
Commit pending work on the connection before starting the migration transaction.
|
|
59
|
+
Set immediate to acquire the SQLite write lock up front. The backfill callback
|
|
60
|
+
links older scans and workspaces to stable targets when required.
|
|
61
|
+
"""
|
|
55
62
|
connection.commit()
|
|
56
63
|
connection.execute("BEGIN IMMEDIATE" if immediate else "BEGIN")
|
|
57
64
|
with connection:
|
|
@@ -71,12 +78,14 @@ def apply_migrations(
|
|
|
71
78
|
should_backfill_targets = False
|
|
72
79
|
for version, name, sql in migrations:
|
|
73
80
|
if version == 6:
|
|
74
|
-
|
|
81
|
+
# Preserve the original one-line index declaration in sqlite_schema.
|
|
82
|
+
for statement in _STATEMENTS[6]:
|
|
83
|
+
apply_repair_statement(connection, statement.replace("\n", " "))
|
|
75
84
|
elif version == 16:
|
|
76
85
|
should_backfill_targets = repair_stable_targets_migration(connection)
|
|
77
86
|
elif version in applied:
|
|
78
|
-
if version in (2, 12, 13, 26, 28, 31, 32, 42, 47, 50, 54, 55, 58, 59, 60):
|
|
79
|
-
|
|
87
|
+
if version in (2, 12, 13, 26, 28, 31, 32, 42, 47, 50, 54, 55, 58, 59, 60, 61):
|
|
88
|
+
repair_schema(connection, version)
|
|
80
89
|
elif version == 11:
|
|
81
90
|
repair_deep_scan_migration(connection)
|
|
82
91
|
else:
|
|
@@ -106,7 +115,7 @@ def normalize_pre_release_migrations(connection: sqlite3.Connection, timestamp:
|
|
|
106
115
|
if operation == "error":
|
|
107
116
|
raise SystemExit(value)
|
|
108
117
|
if operation == "additive":
|
|
109
|
-
|
|
118
|
+
repair_schema(connection, value)
|
|
110
119
|
elif operation == "column":
|
|
111
120
|
add_migration_column(connection, value)
|
|
112
121
|
else:
|
|
@@ -134,19 +143,10 @@ def repair_deep_scan_migration(connection: sqlite3.Connection) -> None:
|
|
|
134
143
|
if not owner_column_missing and expected_objects <= existing_objects:
|
|
135
144
|
return
|
|
136
145
|
|
|
137
|
-
|
|
138
|
-
add_column_if_missing(connection, "scans", "deep_scan_owner_thread_id", "TEXT")
|
|
139
|
-
migration_sql = next(sql for version, _, sql in MIGRATIONS if version == 11)
|
|
140
|
-
for statement in sql_statements(migration_sql):
|
|
141
|
-
if statement.startswith("ALTER TABLE scans"):
|
|
142
|
-
continue
|
|
146
|
+
for statement in _STATEMENTS[11]:
|
|
143
147
|
if statement.startswith("UPDATE scans") and not owner_column_missing:
|
|
144
148
|
continue
|
|
145
|
-
|
|
146
|
-
if statement.startswith(prefix):
|
|
147
|
-
statement = statement.replace(prefix, f"{prefix}IF NOT EXISTS ", 1)
|
|
148
|
-
break
|
|
149
|
-
connection.execute(statement)
|
|
149
|
+
apply_repair_statement(connection, statement)
|
|
150
150
|
if statement.startswith("UPDATE scans") and "continuation_thread_id" in scan_columns:
|
|
151
151
|
connection.execute(
|
|
152
152
|
"UPDATE scans SET deep_scan_owner_thread_id = continuation_thread_id "
|
|
@@ -156,28 +156,18 @@ def repair_deep_scan_migration(connection: sqlite3.Connection) -> None:
|
|
|
156
156
|
|
|
157
157
|
|
|
158
158
|
def repair_deep_scan_failure_counter_migration(connection: sqlite3.Connection) -> None:
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
threshold_missing = "stop_after_consecutive_errors" not in columns
|
|
164
|
-
add_migration_column(connection, threshold_column)
|
|
165
|
-
if threshold_missing:
|
|
166
|
-
connection.execute(
|
|
167
|
-
"UPDATE deep_scan_runs SET stop_after_consecutive_errors = stop_after_no_new"
|
|
168
|
-
)
|
|
169
|
-
add_migration_column(connection, count_column)
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
def repair_thread_scoped_workspaces_migration(connection: sqlite3.Connection) -> None:
|
|
173
|
-
add_column_if_missing(connection, "workspaces", "thread_id", "TEXT")
|
|
174
|
-
connection.execute(
|
|
175
|
-
"CREATE INDEX IF NOT EXISTS workspaces_by_thread_and_updated_at "
|
|
176
|
-
"ON workspaces(thread_id, updated_at DESC)"
|
|
177
|
-
)
|
|
159
|
+
threshold, count, backfill = _STATEMENTS[27]
|
|
160
|
+
if add_migration_column(connection, threshold):
|
|
161
|
+
connection.execute(backfill)
|
|
162
|
+
add_migration_column(connection, count)
|
|
178
163
|
|
|
179
164
|
|
|
180
165
|
def repair_stable_targets_migration(connection: sqlite3.Connection) -> bool:
|
|
166
|
+
"""Repair a partial target-ID migration and return whether the schema required repair.
|
|
167
|
+
|
|
168
|
+
Create missing target tables, columns, and indexes. Clear scan references
|
|
169
|
+
to missing target records so they can be backfilled.
|
|
170
|
+
"""
|
|
181
171
|
workspace_columns = {row["name"] for row in connection.execute("PRAGMA table_info(workspaces)")}
|
|
182
172
|
scan_columns = {row["name"] for row in connection.execute("PRAGMA table_info(scans)")}
|
|
183
173
|
existing_objects = {
|
|
@@ -193,14 +183,7 @@ def repair_stable_targets_migration(connection: sqlite3.Connection) -> bool:
|
|
|
193
183
|
):
|
|
194
184
|
return False
|
|
195
185
|
|
|
196
|
-
|
|
197
|
-
for statement in sql_statements(migration_sql):
|
|
198
|
-
if statement.startswith(("ALTER TABLE workspaces", "ALTER TABLE scans")):
|
|
199
|
-
add_migration_column(connection, statement)
|
|
200
|
-
continue
|
|
201
|
-
statement = statement.replace("CREATE TABLE ", "CREATE TABLE IF NOT EXISTS ", 1)
|
|
202
|
-
statement = statement.replace("CREATE INDEX ", "CREATE INDEX IF NOT EXISTS ", 1)
|
|
203
|
-
connection.execute(statement)
|
|
186
|
+
repair_schema(connection, 16)
|
|
204
187
|
connection.execute(
|
|
205
188
|
"""
|
|
206
189
|
UPDATE scans
|
|
@@ -214,25 +197,31 @@ def repair_stable_targets_migration(connection: sqlite3.Connection) -> bool:
|
|
|
214
197
|
return True
|
|
215
198
|
|
|
216
199
|
|
|
217
|
-
def
|
|
218
|
-
|
|
219
|
-
|
|
200
|
+
def repair_schema(connection: sqlite3.Connection, version: int) -> None:
|
|
201
|
+
for statement in _STATEMENTS[version]:
|
|
202
|
+
apply_repair_statement(connection, statement)
|
|
203
|
+
|
|
204
|
+
|
|
205
|
+
def apply_repair_statement(connection: sqlite3.Connection, statement: str) -> None:
|
|
206
|
+
if statement.startswith("ALTER TABLE "):
|
|
220
207
|
add_migration_column(connection, statement)
|
|
208
|
+
return
|
|
209
|
+
for prefix in ("CREATE UNIQUE INDEX ", "CREATE INDEX ", "CREATE TABLE "):
|
|
210
|
+
if statement.startswith(prefix):
|
|
211
|
+
statement = statement.replace(prefix, f"{prefix}IF NOT EXISTS ", 1)
|
|
212
|
+
break
|
|
213
|
+
connection.execute(statement)
|
|
221
214
|
|
|
222
215
|
|
|
223
|
-
def add_migration_column(connection: sqlite3.Connection, statement: str) ->
|
|
216
|
+
def add_migration_column(connection: sqlite3.Connection, statement: str) -> bool:
|
|
224
217
|
_, _, table, _, _, column, definition = statement.removesuffix(";").split(None, 6)
|
|
218
|
+
columns = {row["name"] for row in connection.execute(f"PRAGMA table_info({table})")}
|
|
219
|
+
if column in columns:
|
|
220
|
+
return False
|
|
225
221
|
# Preserve the compact declarations used by historical repairs, including CHECK errors.
|
|
226
222
|
definition = " ".join(definition.split()).replace("( ", "(").replace(" )", ")")
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
def add_column_if_missing(
|
|
231
|
-
connection: sqlite3.Connection, table: str, column: str, definition: str
|
|
232
|
-
) -> None:
|
|
233
|
-
columns = {row["name"] for row in connection.execute(f"PRAGMA table_info({table})")}
|
|
234
|
-
if column not in columns:
|
|
235
|
-
connection.execute(f"ALTER TABLE {table} ADD COLUMN {column} {definition}")
|
|
223
|
+
connection.execute(f"ALTER TABLE {table} ADD COLUMN {column} {definition}")
|
|
224
|
+
return True
|
|
236
225
|
|
|
237
226
|
|
|
238
227
|
def sql_statements(script: str) -> list[str]:
|
|
@@ -22,6 +22,7 @@ from workbench_target import (
|
|
|
22
22
|
|
|
23
23
|
|
|
24
24
|
def require_target(value: str) -> Path:
|
|
25
|
+
"""Return the resolved local directory or raise SystemExit if the supplied path is relative or missing."""
|
|
25
26
|
expanded = Path(value).expanduser()
|
|
26
27
|
if not expanded.is_absolute():
|
|
27
28
|
raise SystemExit("Scan target must be an absolute local directory path.")
|
|
@@ -32,6 +33,7 @@ def require_target(value: str) -> Path:
|
|
|
32
33
|
|
|
33
34
|
|
|
34
35
|
def inspect_target(target: Path) -> dict[str, Any]:
|
|
36
|
+
"""Return the target path, display name, and local Git metadata used by setup."""
|
|
35
37
|
return {
|
|
36
38
|
"displayName": target.name,
|
|
37
39
|
"targetMetadata": git_target_metadata(target),
|
|
@@ -40,6 +42,7 @@ def inspect_target(target: Path) -> dict[str, Any]:
|
|
|
40
42
|
|
|
41
43
|
|
|
42
44
|
def resolve_git_commit(target: Path, revision: str, label: str) -> str:
|
|
45
|
+
"""Resolve a revision to a local commit ID or raise SystemExit with the caller’s label."""
|
|
43
46
|
value = optional_text(revision, maximum=512)
|
|
44
47
|
if not value:
|
|
45
48
|
raise SystemExit(f"{label} is required.")
|
|
@@ -62,6 +65,11 @@ def require_diff_target(
|
|
|
62
65
|
head_revision: str | None,
|
|
63
66
|
content_digest: str | None,
|
|
64
67
|
) -> dict[str, str]:
|
|
68
|
+
"""Resolve the selected Git change to its base and head commits.
|
|
69
|
+
|
|
70
|
+
For a working-tree selection, also return the current content digest and reject
|
|
71
|
+
changes since selection. Invalid or stale selections raise SystemExit.
|
|
72
|
+
"""
|
|
65
73
|
current_head = require_review_changes_target(target)
|
|
66
74
|
if kind not in DIFF_TARGET_KINDS:
|
|
67
75
|
raise SystemExit("Choose which Git changes to review before starting a diff scan.")
|
|
@@ -131,6 +139,7 @@ def inspect_setup_values(
|
|
|
131
139
|
diff_head_revision: str | None,
|
|
132
140
|
diff_content_digest: str | None,
|
|
133
141
|
) -> dict[str, Any]:
|
|
142
|
+
"""Validate the target, scope, and scan mode and return their normalized values and resolved diff target."""
|
|
134
143
|
target = require_target(target_path)
|
|
135
144
|
inspected = require_scannable_target(target)
|
|
136
145
|
normalized_scope = require_scope(scope, mode, target)
|
|
@@ -165,6 +174,7 @@ def inspect_setup_values(
|
|
|
165
174
|
|
|
166
175
|
|
|
167
176
|
def require_review_changes_target(target: Path) -> str:
|
|
177
|
+
"""Return the checked-out revision or raise SystemExit if target is not the worktree root."""
|
|
168
178
|
revision = require_git_worktree_head(target)
|
|
169
179
|
repository_root = git_output(target, "rev-parse", "--show-toplevel")
|
|
170
180
|
if repository_root is None or not Path(repository_root).samefile(target):
|
|
@@ -175,6 +185,7 @@ def require_review_changes_target(target: Path) -> str:
|
|
|
175
185
|
|
|
176
186
|
|
|
177
187
|
def require_scannable_target(target: Path) -> dict[str, Any]:
|
|
188
|
+
"""Return the inspected target metadata, rejecting a Git repository that has no checked-out worktree."""
|
|
178
189
|
inspected = inspect_target(target)
|
|
179
190
|
metadata = inspected["targetMetadata"]
|
|
180
191
|
if metadata["isGit"] and not metadata["isWorktree"]:
|
|
@@ -185,6 +196,7 @@ def require_scannable_target(target: Path) -> dict[str, Any]:
|
|
|
185
196
|
|
|
186
197
|
|
|
187
198
|
def require_scope(scope: str, mode: str, target: Path) -> str:
|
|
199
|
+
"""Return the existing scan directory relative to the target, requiring the whole repository for deep mode."""
|
|
188
200
|
value = scope if scope.strip() else "."
|
|
189
201
|
requested_scope = Path(value)
|
|
190
202
|
if "\\" in value and (os.name != "nt" or not requested_scope.is_absolute()):
|
|
@@ -220,7 +232,7 @@ def inspect_selected_setup(args: argparse.Namespace) -> dict[str, Any]:
|
|
|
220
232
|
)
|
|
221
233
|
if args.mode == "deep":
|
|
222
234
|
inspected["deepScanConfig"] = resolve_deep_scan_setup(
|
|
223
|
-
|
|
235
|
+
project_json=args.deep_scan_project_json
|
|
224
236
|
)
|
|
225
237
|
elif args.deep_scan_project_json is not None:
|
|
226
238
|
raise SystemExit("Project Deep Scan settings require Deep Scan mode.")
|
|
@@ -30,6 +30,18 @@ def finding_source_excerpt(
|
|
|
30
30
|
locations: list[dict[str, Any]],
|
|
31
31
|
scopes: list[str],
|
|
32
32
|
) -> str | None:
|
|
33
|
+
"""Return numbered context from a finding location at the scanned Git revision.
|
|
34
|
+
|
|
35
|
+
Args:
|
|
36
|
+
scan: Saved scan row with its revision, snapshot digest, and scope metadata.
|
|
37
|
+
target: Local target directory in which to resolve the recorded Git objects.
|
|
38
|
+
locations: Displayed finding locations, using one-based line numbers.
|
|
39
|
+
scopes: Selected paths used to interpret saved source scopes.
|
|
40
|
+
|
|
41
|
+
Returns:
|
|
42
|
+
A bounded excerpt, or None when a location, scope, or local blob cannot
|
|
43
|
+
supply it. Root-control locations have priority.
|
|
44
|
+
"""
|
|
33
45
|
if target is None or not locations or scan["target_revision"] == "unversioned":
|
|
34
46
|
return None
|
|
35
47
|
snapshot = scan["target_snapshot_digest"]
|
|
@@ -116,6 +128,7 @@ def finding_source_excerpt(
|
|
|
116
128
|
|
|
117
129
|
|
|
118
130
|
def scanned_source_text(repository: Path, object_id: str) -> str | None:
|
|
131
|
+
"""Decode the locally available Git blob as UTF-8 with replacement, or return None on lookup failure."""
|
|
119
132
|
try:
|
|
120
133
|
content = offline_git_bytes(repository, "cat-file", "blob", object_id)
|
|
121
134
|
except (OSError, RuntimeError, SystemExit):
|
|
@@ -26,6 +26,7 @@ OBJECT_ID = re.compile(r"(?:[0-9a-f]{40}|[0-9a-f]{64})\Z")
|
|
|
26
26
|
|
|
27
27
|
|
|
28
28
|
def expected_target_kinds(scan: sqlite3.Row) -> list[str]:
|
|
29
|
+
"""Return the manifest target kinds compatible with the stored scan mode, revision, and snapshot digest."""
|
|
29
30
|
if scan["mode"] == "diff":
|
|
30
31
|
return ["git_diff"]
|
|
31
32
|
if scan["target_revision"] == "unversioned":
|
|
@@ -38,6 +39,7 @@ def expected_target_kinds(scan: sqlite3.Row) -> list[str]:
|
|
|
38
39
|
|
|
39
40
|
|
|
40
41
|
def requested_scan_paths(scan: sqlite3.Row) -> list[str]:
|
|
42
|
+
"""Return the explicit paths in the saved launch recipe, falling back to the scan’s original scope."""
|
|
41
43
|
if "recipe_json" in scan.keys() and scan["recipe_json"] is not None:
|
|
42
44
|
recipe = json.loads(scan["recipe_json"], parse_constant=reject_non_finite_json)
|
|
43
45
|
target = recipe["target"]
|
|
@@ -47,6 +49,7 @@ def requested_scan_paths(scan: sqlite3.Row) -> list[str]:
|
|
|
47
49
|
|
|
48
50
|
|
|
49
51
|
def public_scan_recipe(scan: sqlite3.Row) -> dict[str, Any]:
|
|
52
|
+
"""Return the decoded launch recipe with the internal file-scope metadata removed."""
|
|
50
53
|
recipe = json.loads(scan["recipe_json"], parse_constant=reject_non_finite_json)
|
|
51
54
|
recipe.pop("_codexSecurityFileScopes", None)
|
|
52
55
|
return recipe
|
|
@@ -62,6 +65,7 @@ def relative_path(value: str) -> PurePosixPath | None:
|
|
|
62
65
|
|
|
63
66
|
|
|
64
67
|
def safe_source_path(target: Path, value: str) -> Path | None:
|
|
68
|
+
"""Resolve a repository-relative POSIX path and return None if it is invalid or resolves outside the target."""
|
|
65
69
|
parsed = relative_path(value)
|
|
66
70
|
if parsed is None:
|
|
67
71
|
return None
|
|
@@ -74,6 +78,7 @@ def safe_source_path(target: Path, value: str) -> Path | None:
|
|
|
74
78
|
|
|
75
79
|
|
|
76
80
|
def offline_git_bytes(repository: Path, *arguments: str) -> bytes | None:
|
|
81
|
+
"""Return raw stdout for a successful offline Git command with replacement objects disabled, otherwise None."""
|
|
77
82
|
result = git_command(
|
|
78
83
|
repository,
|
|
79
84
|
*arguments,
|
|
@@ -86,6 +91,7 @@ def offline_git_bytes(repository: Path, *arguments: str) -> bytes | None:
|
|
|
86
91
|
|
|
87
92
|
@cache
|
|
88
93
|
def tree_entries(repository: Path, tree: str) -> dict[str, tuple[tuple[str, str, str], ...]] | None:
|
|
94
|
+
"""Index a Git tree by normalized name, retaining every original name, entry kind, and object ID in each group."""
|
|
89
95
|
content = offline_git_bytes(repository, "ls-tree", "-z", tree)
|
|
90
96
|
if content is None:
|
|
91
97
|
return None
|
|
@@ -217,6 +223,12 @@ def capture_source_scopes(
|
|
|
217
223
|
*,
|
|
218
224
|
diff_target_kind: str | None = None,
|
|
219
225
|
) -> dict[str, Any]:
|
|
226
|
+
"""Bind requested paths to the local Git objects that may supply excerpts later.
|
|
227
|
+
|
|
228
|
+
Return the revision and the file or tree IDs that can be verified locally.
|
|
229
|
+
A working-tree diff, dirty snapshot, or replacement ref leaves the scope list
|
|
230
|
+
empty. A path that cannot be bound adds no authority to read other paths.
|
|
231
|
+
"""
|
|
220
232
|
revision, snapshot = target_identity[:2]
|
|
221
233
|
result: dict[str, Any] = {"version": 1, "revision": revision, "scopes": []}
|
|
222
234
|
# HEAD cannot represent the uncommitted bytes reviewed by a working-tree scan.
|
|
@@ -267,6 +279,11 @@ def capture_source_scopes(
|
|
|
267
279
|
def load_source_scopes(
|
|
268
280
|
scan: sqlite3.Row, target: Path, requested: list[str]
|
|
269
281
|
) -> tuple[Path, str, list[dict[str, str]]] | None:
|
|
282
|
+
"""Return the repository, tree ID, and valid source scopes, or None when none can be established.
|
|
283
|
+
|
|
284
|
+
Use saved object IDs for current records. For a legacy scan, reconstruct only
|
|
285
|
+
unambiguous entries from its original revision and respect any recorded file kinds.
|
|
286
|
+
"""
|
|
270
287
|
kind = scan["diff_target_kind"] if "diff_target_kind" in scan.keys() else None
|
|
271
288
|
if kind == "working_tree" or (
|
|
272
289
|
"mode" in scan.keys() and scan["mode"] == "diff" and kind not in ("commit", "range")
|
|
@@ -343,6 +360,7 @@ def load_source_scopes(
|
|
|
343
360
|
def source_object_for_path(
|
|
344
361
|
repository: Path, tree: str, target: Path, value: str, scope: dict[str, str]
|
|
345
362
|
) -> str | None:
|
|
363
|
+
"""Return the Git blob ID for a file covered by the recorded scope, or None if the path cannot be verified."""
|
|
346
364
|
path = relative_path(value)
|
|
347
365
|
if path is None or safe_source_path(target, value) is None:
|
|
348
366
|
return None
|