@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
|
@@ -16,12 +16,12 @@ import tempfile
|
|
|
16
16
|
import unicodedata
|
|
17
17
|
from concurrent.futures import ThreadPoolExecutor
|
|
18
18
|
from pathlib import Path, PurePosixPath
|
|
19
|
-
from typing import Any, BinaryIO, Callable
|
|
19
|
+
from typing import Any, BinaryIO, Callable, cast
|
|
20
20
|
|
|
21
21
|
# Some plugin hosts launch Python with safe-path isolation enabled.
|
|
22
22
|
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
|
23
23
|
from filesystem_identity import stored_filesystem_identity_matches
|
|
24
|
-
from windows_scan_local_files import copy_directory_junction
|
|
24
|
+
from windows_scan_local_files import copy_directory_junction, pinned_root_git_marker
|
|
25
25
|
from workbench_constants import GIT_REPOSITORY_ENVIRONMENT
|
|
26
26
|
|
|
27
27
|
SOURCE_METADATA_DIRECTORIES = {".git", ".svn"}
|
|
@@ -44,6 +44,11 @@ def committed_diff_snapshot_digest(kind: str, base_revision: str, head_revision:
|
|
|
44
44
|
|
|
45
45
|
|
|
46
46
|
def diff_snapshot_digest(scan: sqlite3.Row, manifest: dict[str, Any] | None) -> str | None:
|
|
47
|
+
"""Return the content identity used for a stored diff, or None when unavailable.
|
|
48
|
+
|
|
49
|
+
Working-tree scans use their recorded content digest. Commit and range scans
|
|
50
|
+
reuse the sealed manifest value during recovery or derive a digest from both revisions.
|
|
51
|
+
"""
|
|
47
52
|
if scan["diff_target_kind"] == "working_tree":
|
|
48
53
|
return scan["diff_content_digest"]
|
|
49
54
|
if scan["diff_target_kind"] in {"commit", "range"}:
|
|
@@ -67,6 +72,7 @@ def git_output(
|
|
|
67
72
|
work_tree: Path | None = None,
|
|
68
73
|
offline: bool = False,
|
|
69
74
|
) -> str | None:
|
|
75
|
+
"""Return decoded Git stdout with one trailing newline removed, or None on failure or empty output."""
|
|
70
76
|
completed = git_command(
|
|
71
77
|
target, *args, text=False, git_dir=git_dir, work_tree=work_tree, offline=offline
|
|
72
78
|
)
|
|
@@ -275,6 +281,12 @@ def git_command(
|
|
|
275
281
|
environment_overrides: dict[str, str] | None = None,
|
|
276
282
|
offline: bool = False,
|
|
277
283
|
) -> subprocess.CompletedProcess[str] | subprocess.CompletedProcess[bytes]:
|
|
284
|
+
"""Run Git against target and return the completed process with its exit status.
|
|
285
|
+
|
|
286
|
+
Pass git_dir and work_tree together to select an explicit checkout. Set
|
|
287
|
+
offline to disable transports and lazy fetches. The text flag selects
|
|
288
|
+
decoded or binary output, and stdout_file can redirect it to a file.
|
|
289
|
+
"""
|
|
278
290
|
if (git_dir is None) != (work_tree is None):
|
|
279
291
|
raise ValueError("git_dir and work_tree must be provided together")
|
|
280
292
|
environment = os.environ.copy()
|
|
@@ -326,7 +338,7 @@ def git_command(
|
|
|
326
338
|
return subprocess.CompletedProcess(full_command, 127, empty_output, empty_output)
|
|
327
339
|
|
|
328
340
|
|
|
329
|
-
def run_git_changed_paths(repo: Path, diff_args: list[str]) -> list[tuple[
|
|
341
|
+
def run_git_changed_paths(repo: Path, diff_args: list[str]) -> list[tuple[str, str, str | None]]:
|
|
330
342
|
"""Return changed regular files from the selected side of each change."""
|
|
331
343
|
result = git_command(
|
|
332
344
|
repo,
|
|
@@ -345,25 +357,29 @@ def run_git_changed_paths(repo: Path, diff_args: list[str]) -> list[tuple[Path,
|
|
|
345
357
|
if fields and not fields[-1]:
|
|
346
358
|
fields.pop()
|
|
347
359
|
|
|
348
|
-
changed: list[tuple[
|
|
360
|
+
changed: list[tuple[str, str, str | None]] = []
|
|
349
361
|
index = 0
|
|
350
362
|
while index < len(fields):
|
|
351
363
|
metadata = fields[index].split()
|
|
352
364
|
status = chr(metadata[-1][0])
|
|
353
365
|
index += 1
|
|
366
|
+
rename_source = os.fsdecode(fields[index]) if status == "R" else None
|
|
354
367
|
if status in {"C", "R"}:
|
|
355
368
|
index += 1
|
|
356
|
-
path =
|
|
369
|
+
path = os.fsdecode(fields[index])
|
|
357
370
|
index += 1
|
|
358
371
|
selected_mode = metadata[0].removeprefix(b":") if status == "D" else metadata[1]
|
|
359
372
|
if selected_mode.startswith(b"100"):
|
|
360
|
-
changed.append((path, status))
|
|
373
|
+
changed.append((path, status, rename_source))
|
|
361
374
|
return changed
|
|
362
375
|
|
|
363
376
|
|
|
364
377
|
def git_changed_paths(repo: Path, base: str, head: str, mode: str) -> list[tuple[Path, str]]:
|
|
365
378
|
if mode == "revisions":
|
|
366
|
-
return
|
|
379
|
+
return [
|
|
380
|
+
(repo / name, status)
|
|
381
|
+
for name, status, _ in run_git_changed_paths(repo, [f"{base}..{head}"])
|
|
382
|
+
]
|
|
367
383
|
if mode == "local-patch":
|
|
368
384
|
unstaged = run_git_changed_paths(repo, [base])
|
|
369
385
|
staged = run_git_changed_paths(repo, ["--cached", base])
|
|
@@ -377,26 +393,37 @@ def git_changed_paths(repo: Path, base: str, head: str, mode: str) -> list[tuple
|
|
|
377
393
|
offline=True,
|
|
378
394
|
)
|
|
379
395
|
untracked.check_returncode()
|
|
380
|
-
combined =
|
|
381
|
-
|
|
382
|
-
combined.update(
|
|
383
|
-
(repo / os.fsdecode(relative), "A")
|
|
384
|
-
for relative in untracked.stdout.split(b"\0")
|
|
385
|
-
if relative and not relative.endswith(b"/")
|
|
386
|
-
)
|
|
387
|
-
selected = []
|
|
396
|
+
combined = {name: (status, source) for name, status, source in [*staged, *unstaged]}
|
|
397
|
+
selected: dict[str, str] = {}
|
|
388
398
|
linked_prefixes: dict[str, bool] = {}
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
399
|
+
|
|
400
|
+
def local_status(name: str, status: str) -> str | None:
|
|
401
|
+
if not SOURCE_METADATA_DIRECTORIES.isdisjoint(PurePosixPath(name).parts):
|
|
402
|
+
return None
|
|
403
|
+
if status == "D":
|
|
404
|
+
return status
|
|
405
|
+
path = repo / name
|
|
392
406
|
try:
|
|
393
|
-
if
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
407
|
+
if (
|
|
408
|
+
status in {"M", "R"}
|
|
409
|
+
and _directory_link_boundary(repo, path, linked_prefixes) != path
|
|
410
|
+
):
|
|
411
|
+
return "D" if status == "M" else None
|
|
412
|
+
return status if stat.S_ISREG(path.lstat().st_mode) else None
|
|
397
413
|
except (FileNotFoundError, NotADirectoryError):
|
|
398
|
-
|
|
399
|
-
|
|
414
|
+
return None
|
|
415
|
+
|
|
416
|
+
for name, (status, source) in combined.items():
|
|
417
|
+
if chosen := local_status(name, status):
|
|
418
|
+
selected[name] = chosen
|
|
419
|
+
elif source is not None and local_status(source, "D"):
|
|
420
|
+
selected.setdefault(source, "D")
|
|
421
|
+
for relative in untracked.stdout.split(b"\0"):
|
|
422
|
+
if relative and not relative.endswith(b"/"):
|
|
423
|
+
name = os.fsdecode(relative)
|
|
424
|
+
if local_status(name, "A"):
|
|
425
|
+
selected[name] = "A"
|
|
426
|
+
return sorted((repo / name, status) for name, status in selected.items())
|
|
400
427
|
raise SystemExit(f"Unknown diff mode: {mode}")
|
|
401
428
|
|
|
402
429
|
|
|
@@ -527,6 +554,19 @@ def update_digest_field(digest: Any, label: bytes, value: bytes) -> None:
|
|
|
527
554
|
digest.update(value)
|
|
528
555
|
|
|
529
556
|
|
|
557
|
+
def _update_regular_file_digest(digest: Any, path: Path, prefix: bytes = b"") -> None:
|
|
558
|
+
"""Record the file kind, byte count, and SHA-256 in the snapshot digest."""
|
|
559
|
+
content = hashlib.sha256()
|
|
560
|
+
size = 0
|
|
561
|
+
with path.open("rb") as handle:
|
|
562
|
+
for chunk in iter(lambda: handle.read(1024 * 1024), b""):
|
|
563
|
+
content.update(chunk)
|
|
564
|
+
size += len(chunk)
|
|
565
|
+
update_digest_field(digest, prefix + b"kind", b"file")
|
|
566
|
+
update_digest_field(digest, prefix + b"size", str(size).encode())
|
|
567
|
+
update_digest_field(digest, prefix + b"content-sha256", content.digest())
|
|
568
|
+
|
|
569
|
+
|
|
530
570
|
def _visible_git_character(char: str) -> str:
|
|
531
571
|
if char in "\n\t" or unicodedata.category(char) not in {"Cc", "Cf"}:
|
|
532
572
|
return char
|
|
@@ -569,6 +609,7 @@ def _update_digest_field_from_git(
|
|
|
569
609
|
|
|
570
610
|
|
|
571
611
|
def worktree_content_digest(target: Path) -> str:
|
|
612
|
+
"""Return the worktree digest for the selected path after checking the state of its submodules."""
|
|
572
613
|
require_clean_submodule_worktrees(target)
|
|
573
614
|
repository, pathspec = git_worktree_context(target)
|
|
574
615
|
return worktree_content_digest_for_context(repository, pathspec)
|
|
@@ -582,6 +623,7 @@ def remediation_checkout_snapshot(
|
|
|
582
623
|
"Repository HEAD changed. Regenerate the remediation patch against the current checkout."
|
|
583
624
|
),
|
|
584
625
|
) -> tuple[str, str | None]:
|
|
626
|
+
"""Return the current revision and content digest after verifying the recorded checkout identity and required revision."""
|
|
585
627
|
target = require_scan_target_identity(scan)
|
|
586
628
|
revision = git_revision(target)
|
|
587
629
|
required_revision = expected_revision or scan["target_revision"]
|
|
@@ -706,26 +748,10 @@ def worktree_content_digest_for_context(
|
|
|
706
748
|
directory_content_digest(path.resolve()).encode(),
|
|
707
749
|
)
|
|
708
750
|
elif stat.S_ISREG(metadata.st_mode):
|
|
709
|
-
content_digest = hashlib.sha256()
|
|
710
|
-
content_size = 0
|
|
711
751
|
try:
|
|
712
|
-
|
|
713
|
-
for chunk in iter(lambda: handle.read(1024 * 1024), b""):
|
|
714
|
-
content_digest.update(chunk)
|
|
715
|
-
content_size += len(chunk)
|
|
752
|
+
_update_regular_file_digest(digest, path, prefix=b"untracked-")
|
|
716
753
|
except OSError as exc:
|
|
717
754
|
raise SystemExit(f"Could not read untracked file: {relative_path}") from exc
|
|
718
|
-
update_digest_field(digest, b"untracked-kind", b"file")
|
|
719
|
-
update_digest_field(
|
|
720
|
-
digest,
|
|
721
|
-
b"untracked-size",
|
|
722
|
-
str(content_size).encode(),
|
|
723
|
-
)
|
|
724
|
-
update_digest_field(
|
|
725
|
-
digest,
|
|
726
|
-
b"untracked-content-sha256",
|
|
727
|
-
content_digest.digest(),
|
|
728
|
-
)
|
|
729
755
|
else:
|
|
730
756
|
raise SystemExit(f"Unsupported untracked file type: {relative_path}")
|
|
731
757
|
return f"codex-security-snapshot/v1:sha256:{digest.hexdigest()}"
|
|
@@ -835,6 +861,54 @@ def _directory_link_boundary(target: Path, path: Path, linked_prefixes: dict[str
|
|
|
835
861
|
return path
|
|
836
862
|
|
|
837
863
|
|
|
864
|
+
def _windows_inventory_query(
|
|
865
|
+
target: Path,
|
|
866
|
+
*args: str,
|
|
867
|
+
git_dir: Path,
|
|
868
|
+
work_tree: Path,
|
|
869
|
+
input_data: bytes | None = None,
|
|
870
|
+
environment_overrides: dict[str, str] | None = None,
|
|
871
|
+
) -> subprocess.CompletedProcess[bytes]:
|
|
872
|
+
"""Retry a root inventory's metadata length error with its verified literal marker."""
|
|
873
|
+
|
|
874
|
+
def query(
|
|
875
|
+
directory: Path, environment: dict[str, str] | None
|
|
876
|
+
) -> subprocess.CompletedProcess[bytes]:
|
|
877
|
+
return cast(
|
|
878
|
+
subprocess.CompletedProcess[bytes],
|
|
879
|
+
git_command(
|
|
880
|
+
target,
|
|
881
|
+
*args,
|
|
882
|
+
text=False,
|
|
883
|
+
git_dir=directory,
|
|
884
|
+
work_tree=work_tree,
|
|
885
|
+
input_data=input_data,
|
|
886
|
+
environment_overrides=environment,
|
|
887
|
+
),
|
|
888
|
+
)
|
|
889
|
+
|
|
890
|
+
result = query(git_dir, environment_overrides)
|
|
891
|
+
if (
|
|
892
|
+
result.returncode != 128
|
|
893
|
+
or result.stdout
|
|
894
|
+
or str(target) != str(work_tree)
|
|
895
|
+
or b"GIT_DIR" not in result.stderr
|
|
896
|
+
):
|
|
897
|
+
return result
|
|
898
|
+
diagnostic = b"fatal: '$GIT_DIR' too big"
|
|
899
|
+
if diagnostic not in result.stderr.splitlines():
|
|
900
|
+
# Confirm translated diagnostics without changing the actual inventory's environment.
|
|
901
|
+
probe = query(git_dir, {**(environment_overrides or {}), "LC_ALL": "C", "LANGUAGE": "C"})
|
|
902
|
+
if probe.returncode != 128 or probe.stdout or diagnostic not in probe.stderr.splitlines():
|
|
903
|
+
return result
|
|
904
|
+
with pinned_root_git_marker(target, git_dir) as marker:
|
|
905
|
+
if marker is not None:
|
|
906
|
+
retry = query(marker, environment_overrides)
|
|
907
|
+
if retry.returncode == 0 or (retry.returncode == 1 and "check-ignore" in args):
|
|
908
|
+
return retry
|
|
909
|
+
return result
|
|
910
|
+
|
|
911
|
+
|
|
838
912
|
def git_directory_snapshot_paths(target: Path) -> list[Path] | None:
|
|
839
913
|
repository_root = git_output(target, "rev-parse", "--show-toplevel")
|
|
840
914
|
if repository_root is None:
|
|
@@ -928,7 +1002,7 @@ def git_directory_snapshot_paths(target: Path) -> list[Path] | None:
|
|
|
928
1002
|
git_directory = git_output(target, "rev-parse", "--absolute-git-dir")
|
|
929
1003
|
if git_directory is None:
|
|
930
1004
|
raise SystemExit("Could not inspect the selected Git working tree.")
|
|
931
|
-
directories =
|
|
1005
|
+
directories = _windows_inventory_query(
|
|
932
1006
|
target,
|
|
933
1007
|
"--no-literal-pathspecs",
|
|
934
1008
|
"ls-files",
|
|
@@ -942,9 +1016,9 @@ def git_directory_snapshot_paths(target: Path) -> list[Path] | None:
|
|
|
942
1016
|
git_dir=Path(git_directory),
|
|
943
1017
|
work_tree=repository,
|
|
944
1018
|
)
|
|
945
|
-
if directories
|
|
1019
|
+
if directories.returncode != 0:
|
|
946
1020
|
raise SystemExit("Could not inspect directories in the selected Git working tree.")
|
|
947
|
-
pending = [target / os.fsdecode(path) for path in directories.split(b"\0") if path]
|
|
1021
|
+
pending = [target / os.fsdecode(path) for path in directories.stdout.split(b"\0") if path]
|
|
948
1022
|
while pending:
|
|
949
1023
|
children: list[Path] = []
|
|
950
1024
|
for path in pending:
|
|
@@ -983,13 +1057,12 @@ def git_directory_snapshot_paths(target: Path) -> list[Path] | None:
|
|
|
983
1057
|
if not candidates:
|
|
984
1058
|
break
|
|
985
1059
|
# Filter a directory level at once, retaining the outer repository context.
|
|
986
|
-
ignored =
|
|
1060
|
+
ignored = _windows_inventory_query(
|
|
987
1061
|
repository,
|
|
988
1062
|
"--no-literal-pathspecs",
|
|
989
1063
|
"check-ignore",
|
|
990
1064
|
"-z",
|
|
991
1065
|
"--stdin",
|
|
992
|
-
text=False,
|
|
993
1066
|
input_data=b"\0".join(candidates) + b"\0",
|
|
994
1067
|
git_dir=Path(git_directory),
|
|
995
1068
|
work_tree=repository,
|
|
@@ -1084,18 +1157,10 @@ def directory_content_digest(
|
|
|
1084
1157
|
elif stat.S_ISDIR(mode):
|
|
1085
1158
|
update_digest_field(digest, b"kind", b"directory")
|
|
1086
1159
|
elif stat.S_ISREG(mode):
|
|
1087
|
-
content_digest = hashlib.sha256()
|
|
1088
|
-
content_size = 0
|
|
1089
1160
|
try:
|
|
1090
|
-
|
|
1091
|
-
for chunk in iter(lambda: handle.read(1024 * 1024), b""):
|
|
1092
|
-
content_digest.update(chunk)
|
|
1093
|
-
content_size += len(chunk)
|
|
1161
|
+
_update_regular_file_digest(digest, path)
|
|
1094
1162
|
except OSError as exc:
|
|
1095
1163
|
raise UnreadableLocalFile(f"Could not read local file: {relative_path}") from exc
|
|
1096
|
-
update_digest_field(digest, b"kind", b"file")
|
|
1097
|
-
update_digest_field(digest, b"size", str(content_size).encode())
|
|
1098
|
-
update_digest_field(digest, b"content-sha256", content_digest.digest())
|
|
1099
1164
|
else:
|
|
1100
1165
|
raise UnsupportedLocalFileType(f"Unsupported local file type: {relative_path}")
|
|
1101
1166
|
return f"codex-security-snapshot/v1:sha256:{digest.hexdigest()}"
|
|
@@ -1213,7 +1278,12 @@ def copy_git_worktree_files(
|
|
|
1213
1278
|
destination_path = destination / relative
|
|
1214
1279
|
destination_path.parent.mkdir(parents=True, exist_ok=True)
|
|
1215
1280
|
if stat.S_ISLNK(metadata.st_mode):
|
|
1216
|
-
|
|
1281
|
+
directory_link = bool(
|
|
1282
|
+
getattr(metadata, "st_file_attributes", 0) & stat.FILE_ATTRIBUTE_DIRECTORY
|
|
1283
|
+
)
|
|
1284
|
+
destination_path.symlink_to(
|
|
1285
|
+
os.readlink(source_path), target_is_directory=directory_link
|
|
1286
|
+
)
|
|
1217
1287
|
elif stat.S_ISREG(metadata.st_mode):
|
|
1218
1288
|
shutil.copy2(source_path, destination_path, follow_symlinks=False)
|
|
1219
1289
|
elif stat.S_ISDIR(metadata.st_mode):
|
|
@@ -1311,6 +1381,7 @@ def require_remediation_target(value: str) -> Path:
|
|
|
1311
1381
|
|
|
1312
1382
|
|
|
1313
1383
|
def require_scan_target_identity(scan: sqlite3.Row) -> Path:
|
|
1384
|
+
"""Return the recorded checkout path or raise SystemExit if it no longer identifies the original directory."""
|
|
1314
1385
|
target = require_remediation_target(scan["target_path"])
|
|
1315
1386
|
expected_inode = scan["target_inode"]
|
|
1316
1387
|
if expected_inode is None:
|
|
@@ -10,11 +10,13 @@ from pathlib import Path
|
|
|
10
10
|
|
|
11
11
|
|
|
12
12
|
def stable_target_id(target: Path) -> str:
|
|
13
|
+
"""Hash the supplied path spelling into the workbench ID for a local workspace."""
|
|
13
14
|
digest = hashlib.sha256(f"local-workspace\0{target}".encode()).hexdigest()
|
|
14
15
|
return f"target_sha256_{digest}"
|
|
15
16
|
|
|
16
17
|
|
|
17
18
|
def backfill_security_targets(connection: sqlite3.Connection) -> None:
|
|
19
|
+
"""Fill missing target IDs on scans and workspaces in the caller’s transaction."""
|
|
18
20
|
rows = connection.execute(
|
|
19
21
|
"""
|
|
20
22
|
SELECT target_path FROM workspaces WHERE target_path IS NOT NULL
|
|
@@ -36,6 +38,7 @@ def backfill_security_targets(connection: sqlite3.Connection) -> None:
|
|
|
36
38
|
|
|
37
39
|
|
|
38
40
|
def ensure_security_target(connection: sqlite3.Connection, target_path: str) -> str:
|
|
41
|
+
"""Return the ID already associated with the path or insert a deterministic ID for it."""
|
|
39
42
|
existing = connection.execute(
|
|
40
43
|
"SELECT id FROM security_targets WHERE current_path = ?",
|
|
41
44
|
(target_path,),
|
|
@@ -26,6 +26,20 @@ from workbench_scan_usage import _timestamp as usage_timestamp
|
|
|
26
26
|
reject_non_finite_json = finalizer._reject_non_finite_json
|
|
27
27
|
|
|
28
28
|
|
|
29
|
+
def read_json_object(path: Path) -> dict[str, Any]:
|
|
30
|
+
"""Read a UTF-8 JSON object from path, raising SystemExit on read errors, malformed JSON, or another top-level type."""
|
|
31
|
+
try:
|
|
32
|
+
payload = json.loads(
|
|
33
|
+
path.read_text(encoding="utf-8"),
|
|
34
|
+
parse_constant=reject_non_finite_json,
|
|
35
|
+
)
|
|
36
|
+
except (OSError, ValueError) as exc:
|
|
37
|
+
raise SystemExit(f"{path.name}: invalid JSON: {exc}") from exc
|
|
38
|
+
if not isinstance(payload, dict):
|
|
39
|
+
raise SystemExit(f"{path.name}: expected a JSON object.")
|
|
40
|
+
return payload
|
|
41
|
+
|
|
42
|
+
|
|
29
43
|
def javascript_utf8(value: str) -> bytes:
|
|
30
44
|
"""Match Node's UTF-8 encoding of UTF-16 strings without changing stored text."""
|
|
31
45
|
return (
|
|
@@ -40,6 +54,7 @@ def timestamp_key(value: str) -> datetime:
|
|
|
40
54
|
|
|
41
55
|
|
|
42
56
|
def require_uuid(value: str, label: str) -> str:
|
|
57
|
+
"""Return the standard hyphenated UUID text or raise SystemExit using label to identify the invalid argument."""
|
|
43
58
|
try:
|
|
44
59
|
return str(uuid.UUID(value))
|
|
45
60
|
except ValueError as exc:
|
|
@@ -54,6 +69,7 @@ path_within_scope = finalizer.path_within_scope
|
|
|
54
69
|
|
|
55
70
|
|
|
56
71
|
def require_close_note(close_reason: str | None, note: str | None) -> None:
|
|
72
|
+
"""Require a note when closing a finding as a false positive or when declining a fix."""
|
|
57
73
|
if note is None and close_reason == "false_positive":
|
|
58
74
|
raise SystemExit("Explain why this finding is a false positive.")
|
|
59
75
|
if note is None and close_reason == "wont_fix":
|
|
@@ -92,7 +108,7 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
92
108
|
thread_count = usage.get("threadCount")
|
|
93
109
|
if (
|
|
94
110
|
coverage not in ("complete", "partial", "unavailable")
|
|
95
|
-
or usage.get("source")
|
|
111
|
+
or usage.get("source") not in ("codex_rollout", "codex_runtime")
|
|
96
112
|
or type(thread_count) is not int
|
|
97
113
|
or thread_count < 0
|
|
98
114
|
):
|
|
@@ -134,6 +150,7 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
134
150
|
|
|
135
151
|
allowed_keys = {
|
|
136
152
|
"coverage",
|
|
153
|
+
"coverageScope",
|
|
137
154
|
"source",
|
|
138
155
|
"threadCount",
|
|
139
156
|
"missingThreadCount",
|
|
@@ -144,19 +161,32 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
144
161
|
"observedAt",
|
|
145
162
|
"tokensUpdatedAt",
|
|
146
163
|
"accountRateLimits",
|
|
164
|
+
"cacheWriteInputTokensReported",
|
|
147
165
|
*SCAN_USAGE_TOKEN_KEYS,
|
|
148
166
|
}
|
|
149
167
|
if thread_count == 0 or not set(usage).issubset(allowed_keys):
|
|
150
168
|
return False
|
|
169
|
+
if "coverageScope" in usage:
|
|
170
|
+
scope = usage["coverageScope"]
|
|
171
|
+
if (
|
|
172
|
+
not isinstance(scope, list)
|
|
173
|
+
or any(not isinstance(identity, str) or not identity for identity in scope)
|
|
174
|
+
or len(set(scope)) != len(scope)
|
|
175
|
+
):
|
|
176
|
+
return False
|
|
151
177
|
if (
|
|
152
178
|
not all(type(usage.get(key)) is int and usage[key] >= 0 for key in SCAN_USAGE_TOKEN_KEYS)
|
|
153
179
|
or usage["cachedInputTokens"] + usage["cacheWriteInputTokens"] > usage["inputTokens"]
|
|
180
|
+
or "cacheWriteInputTokensReported" in usage
|
|
181
|
+
and type(usage["cacheWriteInputTokensReported"]) is not bool
|
|
154
182
|
):
|
|
155
183
|
return False
|
|
156
184
|
missing = usage.get("missingThreadCount", 0)
|
|
157
185
|
if type(missing) is not int or missing < 0:
|
|
158
186
|
return False
|
|
159
|
-
if coverage == "complete" and (
|
|
187
|
+
if coverage == "complete" and (
|
|
188
|
+
any(warning != "cost_estimate_covers_earlier_usage" for warning in warnings) or missing
|
|
189
|
+
):
|
|
160
190
|
return False
|
|
161
191
|
if coverage == "partial" and not (warnings or missing):
|
|
162
192
|
return False
|
|
@@ -177,8 +207,11 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
177
207
|
return False
|
|
178
208
|
if any(
|
|
179
209
|
not isinstance(role, dict)
|
|
180
|
-
or
|
|
210
|
+
or not keys.issubset(role)
|
|
211
|
+
or not set(role).issubset({*keys, "cacheWriteInputTokensReported"})
|
|
181
212
|
or any(type(role[key]) is not int or role[key] < 0 for key in keys)
|
|
213
|
+
or "cacheWriteInputTokensReported" in role
|
|
214
|
+
and type(role["cacheWriteInputTokensReported"]) is not bool
|
|
182
215
|
for role in roles.values()
|
|
183
216
|
):
|
|
184
217
|
return False
|
|
@@ -188,6 +221,11 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
188
221
|
|
|
189
222
|
|
|
190
223
|
def parse_scan_cost(value: str | None) -> str | None:
|
|
224
|
+
"""Return compact JSON for valid measured usage or a legacy cost estimate.
|
|
225
|
+
|
|
226
|
+
None means cost data was omitted. Invalid JSON, nonfinite numbers, or an
|
|
227
|
+
unsupported cost record raise SystemExit.
|
|
228
|
+
"""
|
|
191
229
|
if value is None:
|
|
192
230
|
return None
|
|
193
231
|
try:
|
|
@@ -210,11 +248,13 @@ def parse_scan_cost(value: str | None) -> str | None:
|
|
|
210
248
|
|
|
211
249
|
|
|
212
250
|
def bounded_output_text(value: Any, maximum_bytes: int) -> str:
|
|
251
|
+
"""Return the prefix of the stringified value that fits in maximum_bytes of UTF-8 without splitting a character."""
|
|
213
252
|
encoded = str(value).encode("utf-8")[:maximum_bytes]
|
|
214
253
|
return encoded.decode("utf-8", errors="ignore")
|
|
215
254
|
|
|
216
255
|
|
|
217
256
|
def require_occurrence(connection: sqlite3.Connection, occurrence_id: str) -> sqlite3.Row:
|
|
257
|
+
"""Return the finding occurrence row or raise SystemExit if its ID is missing or unknown."""
|
|
218
258
|
occurrence_id = optional_text(occurrence_id, maximum=256)
|
|
219
259
|
if occurrence_id is None:
|
|
220
260
|
raise SystemExit("occurrence-id is required.")
|
|
@@ -1,28 +1,24 @@
|
|
|
1
1
|
[
|
|
2
2
|
[
|
|
3
|
-
"WITH input AS (SELECT :history AS history)",
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
"
|
|
7
|
-
"
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
"
|
|
11
|
-
"
|
|
12
|
-
"
|
|
13
|
-
"
|
|
14
|
-
"
|
|
15
|
-
"
|
|
16
|
-
"
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
"
|
|
20
|
-
"
|
|
21
|
-
"
|
|
22
|
-
" 'UPDATE schema_migrations SET version = 50 WHERE version = ' || version AS value",
|
|
23
|
-
"FROM schema_migrations",
|
|
24
|
-
"WHERE version IN (34, 40, 41, 42, 43, 44, 48)",
|
|
25
|
-
" AND name = 'persist authorized source excerpt scopes';"
|
|
3
|
+
"WITH input AS (SELECT :history AS history),",
|
|
4
|
+
"previews AS (",
|
|
5
|
+
" SELECT version, CASE",
|
|
6
|
+
" WHEN version IN (48, 50, 63) AND name = 'persist scan log completion boundaries'",
|
|
7
|
+
" THEN 'UPDATE schema_migrations SET version = 64'",
|
|
8
|
+
" WHEN version IN (58, 59) AND name = 'record classification rubric provenance'",
|
|
9
|
+
" THEN 'UPDATE schema_migrations SET version = 60'",
|
|
10
|
+
" WHEN version IN (47, 48, 50, 52, 53, 54) AND name = 'freeze stopped scan checkpoint selections'",
|
|
11
|
+
" THEN 'UPDATE schema_migrations SET version = 57'",
|
|
12
|
+
" WHEN version IN (34, 40, 41, 42, 43, 44, 48) AND name = 'persist authorized source excerpt scopes'",
|
|
13
|
+
" THEN 'UPDATE schema_migrations SET version = 50'",
|
|
14
|
+
" WHEN version = 63 AND name = 'retain native investigation time allowances'",
|
|
15
|
+
" THEN 'DELETE FROM schema_migrations'",
|
|
16
|
+
" END AS repair FROM schema_migrations",
|
|
17
|
+
")",
|
|
18
|
+
"SELECT 'sql' AS operation, repair || ' WHERE version = ' || version AS value",
|
|
19
|
+
"FROM previews WHERE repair IS NOT NULL",
|
|
20
|
+
"-- Vacate checkpoint preview 50 before moving a lower source-scope receipt into it.",
|
|
21
|
+
"ORDER BY version DESC;"
|
|
26
22
|
],
|
|
27
23
|
[
|
|
28
24
|
"WITH history AS (",
|
|
@@ -488,5 +488,39 @@
|
|
|
488
488
|
"statements": [
|
|
489
489
|
"ALTER TABLE scan_severity_classifications ADD COLUMN rubric_binding_json TEXT;"
|
|
490
490
|
]
|
|
491
|
+
},
|
|
492
|
+
{
|
|
493
|
+
"version": 61,
|
|
494
|
+
"name": "record scan launch attribution",
|
|
495
|
+
"statements": [
|
|
496
|
+
"ALTER TABLE scans ADD COLUMN launch_surface TEXT;",
|
|
497
|
+
"ALTER TABLE scans ADD COLUMN launch_package_version TEXT;",
|
|
498
|
+
"ALTER TABLE scans ADD COLUMN launch_plugin_version TEXT;",
|
|
499
|
+
"ALTER TABLE scans ADD COLUMN launch_kind TEXT CHECK (launch_kind IN ('scan', 'mock', 'import'));"
|
|
500
|
+
]
|
|
501
|
+
},
|
|
502
|
+
{
|
|
503
|
+
"version": 62,
|
|
504
|
+
"name": "project scan lifecycle snapshots",
|
|
505
|
+
"statements": [
|
|
506
|
+
"CREATE TRIGGER classify_legacy_scan_recipe\nAFTER UPDATE OF recipe_json ON scans\nWHEN OLD.recipe_json IS NULL AND (NEW.launch_kind IS NULL OR NEW.launch_plugin_version IS NULL)\n AND json_valid(NEW.recipe_json)\nBEGIN\n UPDATE scans SET\n launch_kind = COALESCE(launch_kind, CASE\n WHEN json_type(recipe_json, '$.import') = 'object' THEN 'import'\n WHEN json_type(recipe_json, '$.mock') = 'true' THEN 'mock' END),\n launch_plugin_version = COALESCE(launch_plugin_version, CASE\n WHEN json_type(recipe_json, '$.pluginVersion') = 'text'\n AND trim(json_extract(recipe_json, '$.pluginVersion'), char(9, 10, 11, 12, 13, 32)) <> ''\n THEN json_extract(recipe_json, '$.pluginVersion') END)\n WHERE id = NEW.id;\nEND;",
|
|
507
|
+
"UPDATE scans\nSET launch_kind = CASE WHEN json_type(recipe_json, '$.import') = 'object' THEN 'import' ELSE 'mock' END\nWHERE launch_kind IS NULL AND CASE WHEN json_valid(recipe_json) THEN\n json_type(recipe_json, '$.import') = 'object' OR json_type(recipe_json, '$.mock') = 'true'\nEND;",
|
|
508
|
+
"UPDATE scans SET launch_plugin_version = json_extract(recipe_json, '$.pluginVersion')\nWHERE launch_plugin_version IS NULL AND CASE WHEN json_valid(recipe_json) THEN\n json_type(recipe_json, '$.pluginVersion') = 'text'\n AND trim(json_extract(recipe_json, '$.pluginVersion'), char(9, 10, 11, 12, 13, 32)) <> ''\nEND;",
|
|
509
|
+
"CREATE VIEW scan_lifecycles AS\nSELECT scans.id AS scan_id, json_object(\n 'scanId', scans.id,\n 'mode', CASE WHEN launch_kind = 'import' THEN 'import' ELSE scans.mode END,\n 'startedAt', scans.started_at,\n 'status', CASE WHEN canceled_at IS NOT NULL THEN 'canceled'\n WHEN scans.status = 'complete' THEN 'completed' ELSE scans.status END,\n 'finishedAt', COALESCE(canceled_at, completed_at),\n 'hasReportableFindings', json(CASE\n WHEN scans.status = 'complete' AND canceled_at IS NULL\n THEN (SELECT CASE WHEN reportable_findings_count > 0 THEN 'true' ELSE 'false' END\n FROM scan_progress WHERE scan_id = scans.id) END),\n 'surface', launch_surface,\n 'packageVersion', launch_package_version,\n 'pluginVersion', launch_plugin_version,\n 'mock', json(CASE WHEN launch_kind = 'mock' THEN 'true'\n WHEN launch_kind IS NOT NULL THEN 'false' END)\n) AS snapshot\nFROM scans;"
|
|
510
|
+
]
|
|
511
|
+
},
|
|
512
|
+
{
|
|
513
|
+
"version": 63,
|
|
514
|
+
"name": "retain unverified Deep Scan worker attempts",
|
|
515
|
+
"statements": [
|
|
516
|
+
"ALTER TABLE deep_scan_runs ADD COLUMN worker_usage_gap INTEGER NOT NULL DEFAULT 0 CHECK (worker_usage_gap IN (0, 1));",
|
|
517
|
+
"UPDATE deep_scan_runs SET worker_usage_gap = 1\nWHERE scan_id IN (\n SELECT w.scan_id FROM deep_scan_workers AS w\n WHERE w.kind IN ('discovery', 'dedup') AND w.attempt > 1\n AND w.started_at IS NOT NULL AND w.sdk_thread_id IS NULL\n AND NOT EXISTS (SELECT 1 FROM deep_scan_worker_threads AS t\n WHERE t.scan_id = w.scan_id AND t.worker_id = w.id)\n);",
|
|
518
|
+
"CREATE TRIGGER retain_unverified_deep_scan_worker_attempt\nAFTER UPDATE OF attempt ON deep_scan_workers\nWHEN NEW.attempt > OLD.attempt AND OLD.started_at IS NOT NULL\n AND OLD.sdk_thread_id IS NULL AND OLD.kind IN ('discovery', 'dedup')\nBEGIN\n UPDATE deep_scan_runs SET worker_usage_gap = 1 WHERE scan_id = OLD.scan_id;\nEND;"
|
|
519
|
+
]
|
|
520
|
+
},
|
|
521
|
+
{
|
|
522
|
+
"version": 64,
|
|
523
|
+
"name": "persist scan log completion boundaries",
|
|
524
|
+
"statements": ["ALTER TABLE scans ADD COLUMN log_completed_at TEXT;"]
|
|
491
525
|
}
|
|
492
526
|
]
|
|
@@ -20,11 +20,11 @@ Call `defense_factory_bootstrap` before data reads. Reuse its result within the
|
|
|
20
20
|
|
|
21
21
|
Use `defense_factory_github_search`, `defense_factory_github_repositories`, or `defense_factory_github_get` to resolve repositories on the connectors returned by bootstrap. Preserve returned repository and connector IDs, including GitHub Enterprise identities. `defense_factory_workflow_repositories` can locate repositories with recorded runs. A local checkout name alone does not identify a Cloud repository. Ask the user to choose when account or repository context is ambiguous; in noninteractive use, stop with the ambiguity and required selection. An explicit request for all accessible repositories may use that broader scope.
|
|
22
22
|
|
|
23
|
-
For a finding link, accept the selected Cloud `webOrigin` with the path `/codex/cloud/security/findings/<finding-id>` or the legacy `/codex/security/findings/<finding-id>`. Decode the final path segment once and resolve it through `defense_factory_findings_get`.
|
|
23
|
+
For a finding link, accept the selected Cloud `webOrigin` with the path `/codex/cloud/security/findings/<finding-id>` or the legacy `/codex/security/findings/<finding-id>`. Decode the final path segment once and resolve it through `defense_factory_findings_get`. Pass complete finding IDs returned by Cloud unchanged, including any source prefix. A commit-finding link under either accepted path may use a bare finding ID; pass that as `commit:<finding-id>`. Do not substitute a grouped issue, scan, or PR ID. For an unsupported origin or path, explain which finding link or ID is needed instead of guessing another record. Use returned Cloud links when available. Every direct detail or evidence read must go through its tool, even for an ID that was previously listed.
|
|
24
24
|
|
|
25
25
|
## List and inspect findings
|
|
26
26
|
|
|
27
|
-
When the findings list or detail tool offers `api_version`, select `v2` for requests that include imported scanner findings. The default `v1` view covers native findings. For an imported-only list, also set `source` to `imported` if exposed. Use
|
|
27
|
+
When the findings list or detail tool offers `api_version`, select `v2` for requests that include imported scanner findings. The default `v1` view covers native findings. For an imported-only list, also set `source` to `imported` if exposed. Use `provider` to filter scanner occurrences. To list grouped issues with published evidence from a scanner, use `defense_factory_canonical_findings_list` with `published_evidence_provider`. Scope grouped issues to a repository with its stable ID in `repo_id`. Use the provider values advertised by each tool. If the scanner has no filter value, list imported findings within the requested repository and inspect the returned provider and scanner origin where available. For example, OpenGrep uses the Semgrep provider and identifies itself in `details.scanner_origin`. Follow every page for a complete answer. If the evidence available to the caller cannot identify the scanner, report that limit.
|
|
28
28
|
|
|
29
29
|
Use `defense_factory_findings_list` with the discovered repository URL in `repo` and the user's filters; `repo` accepts comma-separated URLs, not repository IDs. Workflow tools use the returned repository ID in `repo_id`. Filters may include severity (`criticality`), lifecycle `status`, `source`, `q`, `path_prefix`, `start_at`, `end_at`, `scan_id`, `review_run_id`, `validated`, `has_patch`, `author`, and `assignee`; use the tool's current schema for available filters and their accepted values. `assignee` accepts comma-separated recorded user emails and is separate from commit authorship. Do not invent an assigned-team filter.
|
|
30
30
|
|
|
@@ -39,7 +39,7 @@ Keep these records separate in the answer:
|
|
|
39
39
|
- **Periodic fix check:** its recorded time, commit, result, and report.
|
|
40
40
|
- **Lifecycle status:** the finding's recorded state; it does not prove that a patch was checked or that a periodic fix check passed.
|
|
41
41
|
|
|
42
|
-
|
|
42
|
+
The fields available for repository-scan, PR-review, and imported findings can differ from those for commit findings. Preserve their source evidence and report absent or unknown values as unavailable or unknown, rather than success, failure, or unassigned.
|
|
43
43
|
|
|
44
44
|
## Read evidence
|
|
45
45
|
|
|
@@ -51,6 +51,6 @@ An artifact reference or download link alone is not report content. Unsupported
|
|
|
51
51
|
|
|
52
52
|
## Read scan status
|
|
53
53
|
|
|
54
|
-
Use `defense_factory_scan_history` for combined commit and repository scan history.
|
|
54
|
+
Use `defense_factory_scan_history` for combined commit and repository scan history. Use `repo_ids` for repository-scoped history. To include the caller’s private imports in combined history, set `include_private_imports: true` and omit `repo_ids` and `scan_type`. For private imports alone, set `scan_type: private_import` and omit `repo_ids`. Follow the returned cursor for more history. For repository runs, use `defense_factory_workflow_list` with its `repo_id` and `status` filters, then `defense_factory_workflow_get` for progress and failure details. When history provides a monitoring configuration ID and scan ID, use `defense_factory_monitoring_scan_get` with that configuration as `parameters.path.id` and the scan as `parameters.path.scan_id`.
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
For the current processing phase, request `view: progress` on the workflow or monitoring scan detail tool. Commit scans record status, timestamps, and success. Report when detailed failure information is unavailable. A failed, canceled, or unfinished scan with zero findings is not a clean scan. Include the source, relevant IDs, scope read, and recorded status in the answer.
|