@openai/codex-security 0.8.2 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +201 -178
- package/_bundled_plugin/.app.json +4 -0
- package/_bundled_plugin/.mcp.json +6 -1
- package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
- package/_bundled_plugin/examples/completed-scan/report.md +11 -8
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
- package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
- package/_bundled_plugin/mcp/helpers.mjs +2 -11
- package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
- package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
- package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
- package/_bundled_plugin/mcp/package.json +1 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
- package/_bundled_plugin/mcp/server.mjs +2 -11
- package/_bundled_plugin/mcp/server.mjs.br +0 -0
- package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
- package/_bundled_plugin/references/artifact-storage.md +1 -1
- package/_bundled_plugin/references/core-scan.md +14 -5
- package/_bundled_plugin/references/default-severity-rubric.md +33 -0
- package/_bundled_plugin/references/final-report.md +5 -3
- package/_bundled_plugin/references/finding-detail-fields.md +19 -18
- package/_bundled_plugin/references/sarif-adapter.md +8 -2
- package/_bundled_plugin/references/scan-artifacts.md +21 -12
- package/_bundled_plugin/references/scan-contract.md +27 -33
- package/_bundled_plugin/references/threat-model.md +1 -0
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
- package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
- package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
- package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
- package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
- package/_bundled_plugin/scripts/finding_preview.py +25 -29
- package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
- package/_bundled_plugin/scripts/legacy_findings.py +148 -0
- package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
- package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
- package/_bundled_plugin/scripts/report_projection.py +167 -178
- package/_bundled_plugin/scripts/review_state.py +8 -2
- package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
- package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
- package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
- package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
- package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
- package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
- package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
- package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
- package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
- package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
- package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
- package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
- package/_bundled_plugin/scripts/workbench/storage.py +71 -7
- package/_bundled_plugin/scripts/workbench_cli.py +121 -14
- package/_bundled_plugin/scripts/workbench_constants.py +19 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
- package/_bundled_plugin/scripts/workbench_db.py +550 -492
- package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
- package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
- package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
- package/_bundled_plugin/scripts/workbench_progress.py +10 -1
- package/_bundled_plugin/scripts/workbench_publication.py +14 -10
- package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
- package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
- package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
- package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
- package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
- package/_bundled_plugin/scripts/workbench_schema.py +44 -55
- package/_bundled_plugin/scripts/workbench_setup.py +251 -0
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
- package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
- package/_bundled_plugin/scripts/workbench_target.py +330 -66
- package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
- package/_bundled_plugin/scripts/workbench_validation.py +44 -12
- package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
- package/_bundled_plugin/shared/workbench-migrations.json +53 -0
- package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
- package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
- package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
- package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
- package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
- package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
- package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
- package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
- package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
- package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
- package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
- package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
- package/dist/api.d.ts +45 -5
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +1144 -411
- package/dist/api.js.map +1 -1
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +10 -7
- package/dist/auth.js.map +1 -1
- package/dist/bedrock-oss-pricing.d.ts +6 -0
- package/dist/bedrock-oss-pricing.d.ts.map +1 -0
- package/dist/bedrock-oss-pricing.js +58 -0
- package/dist/bedrock-oss-pricing.js.map +1 -0
- package/dist/bedrock-pricing.d.ts +15 -0
- package/dist/bedrock-pricing.d.ts.map +1 -0
- package/dist/bedrock-pricing.js +117 -0
- package/dist/bedrock-pricing.js.map +1 -0
- package/dist/blackduck-findings.d.ts +8 -0
- package/dist/blackduck-findings.d.ts.map +1 -0
- package/dist/blackduck-findings.js +320 -0
- package/dist/blackduck-findings.js.map +1 -0
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +51 -36
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/checkmarx-evidence.d.ts +19 -0
- package/dist/checkmarx-evidence.d.ts.map +1 -0
- package/dist/checkmarx-evidence.js +36 -0
- package/dist/checkmarx-evidence.js.map +1 -0
- package/dist/checkmarx-findings.d.ts +4 -0
- package/dist/checkmarx-findings.d.ts.map +1 -0
- package/dist/checkmarx-findings.js +27 -0
- package/dist/checkmarx-findings.js.map +1 -0
- package/dist/checkmarx-one.d.ts +4 -0
- package/dist/checkmarx-one.d.ts.map +1 -0
- package/dist/checkmarx-one.js +53 -0
- package/dist/checkmarx-one.js.map +1 -0
- package/dist/checkmarx-repository.d.ts +12 -0
- package/dist/checkmarx-repository.d.ts.map +1 -0
- package/dist/checkmarx-repository.js +181 -0
- package/dist/checkmarx-repository.js.map +1 -0
- package/dist/checkmarx-xml.d.ts +12 -0
- package/dist/checkmarx-xml.d.ts.map +1 -0
- package/dist/checkmarx-xml.js +196 -0
- package/dist/checkmarx-xml.js.map +1 -0
- package/dist/classify-severity-records.d.ts +6 -9
- package/dist/classify-severity-records.d.ts.map +1 -1
- package/dist/classify-severity-records.js +9 -21
- package/dist/classify-severity-records.js.map +1 -1
- package/dist/classify-severity.d.ts +4 -1
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +30 -13
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli.d.ts +14 -5
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +2112 -1266
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.js +2 -2
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codex-prompt.d.ts +2 -0
- package/dist/codex-prompt.d.ts.map +1 -1
- package/dist/codex-prompt.js +6 -0
- package/dist/codex-prompt.js.map +1 -1
- package/dist/component-scan.d.ts +16 -3
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +32 -6
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts +2 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +221 -65
- package/dist/config.js.map +1 -1
- package/dist/continuum-findings.d.ts +7 -0
- package/dist/continuum-findings.d.ts.map +1 -0
- package/dist/continuum-findings.js +225 -0
- package/dist/continuum-findings.js.map +1 -0
- package/dist/contract-values.d.ts +30 -0
- package/dist/contract-values.d.ts.map +1 -0
- package/dist/contract-values.js +78 -0
- package/dist/contract-values.js.map +1 -0
- package/dist/contract.d.ts +2 -20
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +58 -669
- package/dist/contract.js.map +1 -1
- package/dist/cost-model.d.ts +13 -1
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +66 -115
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +61 -4
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +2560 -100
- package/dist/cost.js.map +1 -1
- package/dist/custom-publish.d.ts +4 -0
- package/dist/custom-publish.d.ts.map +1 -1
- package/dist/custom-publish.js +40 -3
- package/dist/custom-publish.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +5 -0
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/custom-validation.d.ts +2 -0
- package/dist/custom-validation.d.ts.map +1 -1
- package/dist/custom-validation.js +4 -0
- package/dist/custom-validation.js.map +1 -1
- package/dist/deduplication/deduplication-prompts.d.ts +4 -4
- package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
- package/dist/deduplication/deduplication-prompts.js +2 -2
- package/dist/deduplication/deduplication-prompts.js.map +1 -1
- package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
- package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
- package/dist/deduplication/deduplication-reviewer.js +11 -4
- package/dist/deduplication/deduplication-reviewer.js.map +1 -1
- package/dist/deduplication/deduplication.js.map +1 -1
- package/dist/deduplication/finding-schema.d.ts +19 -1
- package/dist/deduplication/finding-schema.d.ts.map +1 -1
- package/dist/deduplication/finding-schema.js +25 -0
- package/dist/deduplication/finding-schema.js.map +1 -1
- package/dist/deduplication/local.d.ts +2 -2
- package/dist/deduplication/local.d.ts.map +1 -1
- package/dist/deduplication/local.js +5 -10
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/records.d.ts +8 -2
- package/dist/deduplication/records.d.ts.map +1 -1
- package/dist/deduplication/records.js +36 -8
- package/dist/deduplication/records.js.map +1 -1
- package/dist/deduplication/refusal.d.ts.map +1 -1
- package/dist/deduplication/refusal.js +25 -5
- package/dist/deduplication/refusal.js.map +1 -1
- package/dist/deduplication/scan.d.ts +3 -0
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +1 -1
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +0 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +22 -33
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-scan-defaults.d.ts +2 -0
- package/dist/deep-scan-defaults.d.ts.map +1 -1
- package/dist/deep-scan-defaults.js +28 -1
- package/dist/deep-scan-defaults.js.map +1 -1
- package/dist/deep-scan.d.ts +13 -0
- package/dist/deep-scan.d.ts.map +1 -1
- package/dist/deep-scan.js +262 -7
- package/dist/deep-scan.js.map +1 -1
- package/dist/default-severity-rubric.d.ts +1 -2
- package/dist/default-severity-rubric.d.ts.map +1 -1
- package/dist/default-severity-rubric.js +2 -66
- package/dist/default-severity-rubric.js.map +1 -1
- package/dist/endor-findings.d.ts +3 -1
- package/dist/endor-findings.d.ts.map +1 -1
- package/dist/endor-findings.js +108 -80
- package/dist/endor-findings.js.map +1 -1
- package/dist/errors.d.ts +1 -1
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +9 -2
- package/dist/errors.js.map +1 -1
- package/dist/external-findings-import.d.ts +5 -3
- package/dist/external-findings-import.d.ts.map +1 -1
- package/dist/external-findings-import.js +11 -16
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +15 -4
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +619 -225
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +20 -6
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +2356 -308
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +28 -2
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +174 -81
- package/dist/external-findings-read.js.map +1 -1
- package/dist/external-findings.d.ts +17 -3
- package/dist/external-findings.d.ts.map +1 -1
- package/dist/external-findings.js +153 -1
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +33 -1
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +335 -51
- package/dist/external-import-contract.js.map +1 -1
- package/dist/external-import-models.d.ts +1 -1
- package/dist/external-import-models.d.ts.map +1 -1
- package/dist/external-import-models.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +5 -4
- package/dist/feedback.js.map +1 -1
- package/dist/finding-prompt.d.ts +5 -0
- package/dist/finding-prompt.d.ts.map +1 -0
- package/dist/finding-prompt.js +32 -0
- package/dist/finding-prompt.js.map +1 -0
- package/dist/finding-retrieval.d.ts +3 -3
- package/dist/finding-retrieval.d.ts.map +1 -1
- package/dist/finding-retrieval.js.map +1 -1
- package/dist/finding-workflow.d.ts +6 -1
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +2 -2
- package/dist/finding-workflow.js.map +1 -1
- package/dist/findings-client.d.ts +1 -0
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +27 -3
- package/dist/findings-client.js.map +1 -1
- package/dist/git-remote.d.ts +4 -0
- package/dist/git-remote.d.ts.map +1 -1
- package/dist/git-remote.js +20 -0
- package/dist/git-remote.js.map +1 -1
- package/dist/github-advisories.d.ts +3 -12
- package/dist/github-advisories.d.ts.map +1 -1
- package/dist/github-advisories.js +9 -31
- package/dist/github-advisories.js.map +1 -1
- package/dist/github-dependabot-findings.d.ts.map +1 -1
- package/dist/github-dependabot-findings.js +22 -20
- package/dist/github-dependabot-findings.js.map +1 -1
- package/dist/github-findings.d.ts +4 -1
- package/dist/github-findings.d.ts.map +1 -1
- package/dist/github-findings.js +392 -79
- package/dist/github-findings.js.map +1 -1
- package/dist/github.d.ts +17 -7
- package/dist/github.d.ts.map +1 -1
- package/dist/github.js +43 -30
- package/dist/github.js.map +1 -1
- package/dist/host-protocol.d.ts +2 -2
- package/dist/host-protocol.d.ts.map +1 -1
- package/dist/host-protocol.js.map +1 -1
- package/dist/host-records-protocol.d.ts +10 -11
- package/dist/host-records-protocol.d.ts.map +1 -1
- package/dist/host-records-protocol.js +69 -9
- package/dist/host-records-protocol.js.map +1 -1
- package/dist/hosted-git-remotes.d.ts +5 -0
- package/dist/hosted-git-remotes.d.ts.map +1 -0
- package/dist/hosted-git-remotes.js +285 -0
- package/dist/hosted-git-remotes.js.map +1 -0
- package/dist/hosted-git-repository.d.ts +28 -0
- package/dist/hosted-git-repository.d.ts.map +1 -0
- package/dist/hosted-git-repository.js +222 -0
- package/dist/hosted-git-repository.js.map +1 -0
- package/dist/hosted-scan-protocol.js +2 -2
- package/dist/hosted-scan-protocol.js.map +1 -1
- package/dist/hosted-scan.d.ts +15 -0
- package/dist/hosted-scan.d.ts.map +1 -1
- package/dist/hosted-scan.js +71 -44
- package/dist/hosted-scan.js.map +1 -1
- package/dist/hosted-scanner-http.d.ts +21 -0
- package/dist/hosted-scanner-http.d.ts.map +1 -0
- package/dist/hosted-scanner-http.js +204 -0
- package/dist/hosted-scanner-http.js.map +1 -0
- package/dist/hosted-scanner-v1.d.ts +6 -0
- package/dist/hosted-scanner-v1.d.ts.map +1 -0
- package/dist/hosted-scanner-v1.js +60 -0
- package/dist/hosted-scanner-v1.js.map +1 -0
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +3 -0
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +24 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +15 -1
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +58 -81
- package/dist/inspector-findings.js.map +1 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +86 -10
- package/dist/knowledge-base.js.map +1 -1
- package/dist/local-git-metadata.d.ts +5 -0
- package/dist/local-git-metadata.d.ts.map +1 -0
- package/dist/local-git-metadata.js +130 -0
- package/dist/local-git-metadata.js.map +1 -0
- package/dist/multiscan.d.ts +6 -4
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +160 -77
- package/dist/multiscan.js.map +1 -1
- package/dist/native-json-findings.d.ts +2 -1
- package/dist/native-json-findings.d.ts.map +1 -1
- package/dist/native-json-findings.js +12 -2
- package/dist/native-json-findings.js.map +1 -1
- package/dist/opengrep-findings.d.ts +1 -0
- package/dist/opengrep-findings.d.ts.map +1 -1
- package/dist/opengrep-findings.js +49 -31
- package/dist/opengrep-findings.js.map +1 -1
- package/dist/operation-telemetry.d.ts +104 -0
- package/dist/operation-telemetry.d.ts.map +1 -0
- package/dist/operation-telemetry.js +293 -0
- package/dist/operation-telemetry.js.map +1 -0
- package/dist/patch-tui.d.ts.map +1 -1
- package/dist/patch-tui.js +90 -35
- package/dist/patch-tui.js.map +1 -1
- package/dist/plugin-python-probe.d.ts +4 -0
- package/dist/plugin-python-probe.d.ts.map +1 -0
- package/dist/plugin-python-probe.js +10 -0
- package/dist/plugin-python-probe.js.map +1 -0
- package/dist/private-finding-import.d.ts +341 -0
- package/dist/private-finding-import.d.ts.map +1 -0
- package/dist/private-finding-import.js +411 -0
- package/dist/private-finding-import.js.map +1 -0
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +2 -2
- package/dist/project-config.js.map +1 -1
- package/dist/provider-profile.d.ts +11 -3
- package/dist/provider-profile.d.ts.map +1 -1
- package/dist/provider-profile.js +80 -11
- package/dist/provider-profile.js.map +1 -1
- package/dist/publication-telemetry.d.ts +45 -0
- package/dist/publication-telemetry.d.ts.map +1 -0
- package/dist/publication-telemetry.js +50 -0
- package/dist/publication-telemetry.js.map +1 -0
- package/dist/publication.js +7 -1
- package/dist/publication.js.map +1 -1
- package/dist/publish.d.ts +4 -0
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +42 -2
- package/dist/publish.js.map +1 -1
- package/dist/reader-selection.d.ts +15 -0
- package/dist/reader-selection.d.ts.map +1 -0
- package/dist/reader-selection.js +89 -0
- package/dist/reader-selection.js.map +1 -0
- package/dist/record.d.ts +6 -1
- package/dist/record.d.ts.map +1 -1
- package/dist/record.js +53 -2
- package/dist/record.js.map +1 -1
- package/dist/remediation.d.ts +3 -1
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +28 -2
- package/dist/remediation.js.map +1 -1
- package/dist/request-metadata.d.ts +3 -0
- package/dist/request-metadata.d.ts.map +1 -1
- package/dist/request-metadata.js +9 -0
- package/dist/request-metadata.js.map +1 -1
- package/dist/result.d.ts +6 -0
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +3 -1
- package/dist/result.js.map +1 -1
- package/dist/retry-windows-rename.d.ts +8 -0
- package/dist/retry-windows-rename.d.ts.map +1 -0
- package/dist/retry-windows-rename.js +24 -0
- package/dist/retry-windows-rename.js.map +1 -0
- package/dist/runtime.d.ts +22 -1
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +408 -162
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +1 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -1
- package/dist/saved-scan-bootstrap.js +18 -15
- package/dist/saved-scan-bootstrap.js.map +1 -1
- package/dist/scan-activity.d.ts.map +1 -1
- package/dist/scan-activity.js +172 -64
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +10 -5
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +68 -25
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +7 -6
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +91 -79
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts +12 -1
- package/dist/scan-executor.d.ts.map +1 -1
- package/dist/scan-executor.js +22 -2
- package/dist/scan-executor.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +31 -28
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-logs.d.ts +12 -0
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +106 -77
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-measurement.d.ts +26 -0
- package/dist/scan-measurement.d.ts.map +1 -0
- package/dist/scan-measurement.js +77 -0
- package/dist/scan-measurement.js.map +1 -0
- package/dist/scan-progress.d.ts +1 -0
- package/dist/scan-progress.d.ts.map +1 -1
- package/dist/scan-progress.js +3 -0
- package/dist/scan-progress.js.map +1 -1
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +4 -1
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-settings.d.ts +1 -1
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +1 -24
- package/dist/scan-settings.js.map +1 -1
- package/dist/scanner-import.d.ts +64 -6
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +406 -48
- package/dist/scanner-import.js.map +1 -1
- package/dist/scanner-repository-url.d.ts +17 -0
- package/dist/scanner-repository-url.d.ts.map +1 -0
- package/dist/scanner-repository-url.js +71 -0
- package/dist/scanner-repository-url.js.map +1 -0
- package/dist/security-policy.d.ts +1 -1
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js.map +1 -1
- package/dist/semgrep-findings.d.ts +6 -3
- package/dist/semgrep-findings.d.ts.map +1 -1
- package/dist/semgrep-findings.js +124 -88
- package/dist/semgrep-findings.js.map +1 -1
- package/dist/semgrep-guardian-findings.d.ts +38 -0
- package/dist/semgrep-guardian-findings.d.ts.map +1 -0
- package/dist/semgrep-guardian-findings.js +165 -0
- package/dist/semgrep-guardian-findings.js.map +1 -0
- package/dist/semgrep-platform-collector.d.ts +26 -0
- package/dist/semgrep-platform-collector.d.ts.map +1 -0
- package/dist/semgrep-platform-collector.js +108 -0
- package/dist/semgrep-platform-collector.js.map +1 -0
- package/dist/semgrep-platform-findings.d.ts +213 -0
- package/dist/semgrep-platform-findings.d.ts.map +1 -0
- package/dist/semgrep-platform-findings.js +1078 -0
- package/dist/semgrep-platform-findings.js.map +1 -0
- package/dist/semgrep-platform-v1.d.ts +6 -0
- package/dist/semgrep-platform-v1.d.ts.map +1 -0
- package/dist/semgrep-platform-v1.js +83 -0
- package/dist/semgrep-platform-v1.js.map +1 -0
- package/dist/server/api.d.ts +1 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embedding-tokenizer.cdx.json +33 -0
- package/dist/server/embedding-tokenizer.d.ts +2 -0
- package/dist/server/embedding-tokenizer.d.ts.map +1 -0
- package/dist/server/embedding-tokenizer.js +322 -0
- package/dist/server/embedding-tokenizer.js.map +6 -0
- package/dist/server/embeddings.d.ts +16 -2
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +35 -5
- package/dist/server/embeddings.js.map +1 -1
- package/dist/session-lines.d.ts +5 -0
- package/dist/session-lines.d.ts.map +1 -0
- package/dist/session-lines.js +60 -0
- package/dist/session-lines.js.map +1 -0
- package/dist/severity-review.d.ts +3 -1
- package/dist/severity-review.d.ts.map +1 -1
- package/dist/severity-review.js +3 -2
- package/dist/severity-review.js.map +1 -1
- package/dist/severity-rubric.d.ts +20 -0
- package/dist/severity-rubric.d.ts.map +1 -0
- package/dist/severity-rubric.js +73 -0
- package/dist/severity-rubric.js.map +1 -0
- package/dist/severity-store.js +15 -5
- package/dist/severity-store.js.map +1 -1
- package/dist/skill-authentication.d.ts +1 -0
- package/dist/skill-authentication.d.ts.map +1 -1
- package/dist/skill-authentication.js +1 -0
- package/dist/skill-authentication.js.map +1 -1
- package/dist/snyk-findings.d.ts +7 -2
- package/dist/snyk-findings.d.ts.map +1 -1
- package/dist/snyk-findings.js +108 -84
- package/dist/snyk-findings.js.map +1 -1
- package/dist/snyk-rest-findings.d.ts +76 -0
- package/dist/snyk-rest-findings.d.ts.map +1 -0
- package/dist/snyk-rest-findings.js +1051 -0
- package/dist/snyk-rest-findings.js.map +1 -0
- package/dist/snyk-rest-v1.d.ts +28 -0
- package/dist/snyk-rest-v1.d.ts.map +1 -0
- package/dist/snyk-rest-v1.js +132 -0
- package/dist/snyk-rest-v1.js.map +1 -0
- package/dist/snyk-token-origin.d.ts +4 -0
- package/dist/snyk-token-origin.d.ts.map +1 -0
- package/dist/snyk-token-origin.js +82 -0
- package/dist/snyk-token-origin.js.map +1 -0
- package/dist/sonar-collector.d.ts +16 -0
- package/dist/sonar-collector.d.ts.map +1 -0
- package/dist/sonar-collector.js +380 -0
- package/dist/sonar-collector.js.map +1 -0
- package/dist/sonar-findings.d.ts +49 -0
- package/dist/sonar-findings.d.ts.map +1 -0
- package/dist/sonar-findings.js +288 -0
- package/dist/sonar-findings.js.map +1 -0
- package/dist/sonar-import.d.ts +111 -0
- package/dist/sonar-import.d.ts.map +1 -0
- package/dist/sonar-import.js +277 -0
- package/dist/sonar-import.js.map +1 -0
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +2 -1
- package/dist/suggest-owners.js.map +1 -1
- package/dist/target-drift.d.ts +9 -0
- package/dist/target-drift.d.ts.map +1 -0
- package/dist/target-drift.js +27 -0
- package/dist/target-drift.js.map +1 -0
- package/dist/targets.d.ts +5 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +73 -31
- package/dist/targets.js.map +1 -1
- package/dist/tenable-findings.d.ts +9 -0
- package/dist/tenable-findings.d.ts.map +1 -0
- package/dist/tenable-findings.js +122 -0
- package/dist/tenable-findings.js.map +1 -0
- package/dist/terminal-columns.d.ts +4 -0
- package/dist/terminal-columns.d.ts.map +1 -0
- package/dist/terminal-columns.js +19 -0
- package/dist/terminal-columns.js.map +1 -0
- package/dist/terminal-stream.d.ts +13 -0
- package/dist/terminal-stream.d.ts.map +1 -0
- package/dist/terminal-stream.js +35 -0
- package/dist/terminal-stream.js.map +1 -0
- package/dist/trivy-findings.d.ts +19 -0
- package/dist/trivy-findings.d.ts.map +1 -0
- package/dist/trivy-findings.js +435 -0
- package/dist/trivy-findings.js.map +1 -0
- package/dist/trivy-import.d.ts +19 -0
- package/dist/trivy-import.d.ts.map +1 -0
- package/dist/trivy-import.js +151 -0
- package/dist/trivy-import.js.map +1 -0
- package/dist/validation-records.d.ts +0 -3
- package/dist/validation-records.d.ts.map +1 -1
- package/dist/validation-records.js +1 -17
- package/dist/validation-records.js.map +1 -1
- package/dist/veracode-findings.d.ts +9 -0
- package/dist/veracode-findings.d.ts.map +1 -0
- package/dist/veracode-findings.js +409 -0
- package/dist/veracode-findings.js.map +1 -0
- package/dist/vertex-pricing.d.ts +8 -0
- package/dist/vertex-pricing.d.ts.map +1 -0
- package/dist/vertex-pricing.js +20 -0
- package/dist/vertex-pricing.js.map +1 -0
- package/dist/windows-path.d.ts +1 -0
- package/dist/windows-path.d.ts.map +1 -1
- package/dist/windows-path.js +27 -1
- package/dist/windows-path.js.map +1 -1
- package/dist/wiz-csv.d.ts +2 -2
- package/dist/wiz-csv.d.ts.map +1 -1
- package/dist/wiz-csv.js +1 -3
- package/dist/wiz-csv.js.map +1 -1
- package/dist/wiz-findings.d.ts +14 -2
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +143 -50
- package/dist/wiz-findings.js.map +1 -1
- package/docs/classify-severity-records.md +28 -13
- package/docs/cli.md +623 -843
- package/docs/dedupe-records.md +54 -24
- package/docs/findings-service.md +87 -47
- package/docs/hosted-remediation.md +14 -7
- package/docs/hosted-scans.md +64 -41
- package/docs/telemetry.md +236 -0
- package/docs/validate-records.md +78 -44
- package/package.json +19 -17
- package/schemas/external-findings.schema.json +14 -1
- package/schemas/hosted-scan-v2.fixture.json +16 -1
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
- package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
- package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
- package/dist/deduplication/records-protocol.d.ts +0 -4
- package/dist/deduplication/records-protocol.d.ts.map +0 -1
- package/dist/deduplication/records-protocol.js +0 -49
- package/dist/deduplication/records-protocol.js.map +0 -1
- package/dist/external-imports-feature.d.ts +0 -6
- package/dist/external-imports-feature.d.ts.map +0 -1
- package/dist/external-imports-feature.js +0 -51
- package/dist/external-imports-feature.js.map +0 -1
- package/dist/finding-normalization.d.ts +0 -5
- package/dist/finding-normalization.d.ts.map +0 -1
- package/dist/finding-normalization.js +0 -120
- package/dist/finding-normalization.js.map +0 -1
|
@@ -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):
|
|
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]:
|
|
@@ -0,0 +1,251 @@
|
|
|
1
|
+
"""Read-only target and setup inspection shared by the MCP server and workbench."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import argparse
|
|
6
|
+
import json
|
|
7
|
+
import os
|
|
8
|
+
import sys
|
|
9
|
+
from pathlib import Path
|
|
10
|
+
from typing import Any
|
|
11
|
+
|
|
12
|
+
from deep_scan_config import resolve_deep_scan_setup
|
|
13
|
+
from workbench_cli import parse_args
|
|
14
|
+
from workbench_constants import DIFF_TARGET_KINDS, EMPTY_GIT_TREE, EMPTY_GIT_TREES, optional_text
|
|
15
|
+
from workbench_target import (
|
|
16
|
+
git_bytes,
|
|
17
|
+
git_output,
|
|
18
|
+
git_target_metadata,
|
|
19
|
+
require_git_worktree_head,
|
|
20
|
+
worktree_content_digest,
|
|
21
|
+
)
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
def require_target(value: str) -> Path:
|
|
25
|
+
"""Return the resolved local directory or raise SystemExit if the supplied path is relative or missing."""
|
|
26
|
+
expanded = Path(value).expanduser()
|
|
27
|
+
if not expanded.is_absolute():
|
|
28
|
+
raise SystemExit("Scan target must be an absolute local directory path.")
|
|
29
|
+
target = expanded.resolve()
|
|
30
|
+
if not target.is_dir():
|
|
31
|
+
raise SystemExit(f"Scan target is not a readable local directory: {target}")
|
|
32
|
+
return target
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
def inspect_target(target: Path) -> dict[str, Any]:
|
|
36
|
+
"""Return the target path, display name, and local Git metadata used by setup."""
|
|
37
|
+
return {
|
|
38
|
+
"displayName": target.name,
|
|
39
|
+
"targetMetadata": git_target_metadata(target),
|
|
40
|
+
"targetPath": str(target),
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
|
|
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."""
|
|
46
|
+
value = optional_text(revision, maximum=512)
|
|
47
|
+
if not value:
|
|
48
|
+
raise SystemExit(f"{label} is required.")
|
|
49
|
+
resolved = git_output(
|
|
50
|
+
target,
|
|
51
|
+
"rev-parse",
|
|
52
|
+
"--verify",
|
|
53
|
+
"--end-of-options",
|
|
54
|
+
f"{value}^{{commit}}",
|
|
55
|
+
)
|
|
56
|
+
if resolved is None:
|
|
57
|
+
raise SystemExit(f"{label} does not resolve to a local Git commit: {value}")
|
|
58
|
+
return resolved
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def require_diff_target(
|
|
62
|
+
target: Path,
|
|
63
|
+
kind: str | None,
|
|
64
|
+
base_revision: str | None,
|
|
65
|
+
head_revision: str | None,
|
|
66
|
+
content_digest: str | None,
|
|
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
|
+
"""
|
|
73
|
+
current_head = require_review_changes_target(target)
|
|
74
|
+
if kind not in DIFF_TARGET_KINDS:
|
|
75
|
+
raise SystemExit("Choose which Git changes to review before starting a diff scan.")
|
|
76
|
+
if kind == "working_tree":
|
|
77
|
+
base = resolve_git_commit(target, base_revision or "HEAD", "Working-tree base")
|
|
78
|
+
head = resolve_git_commit(target, head_revision or current_head, "Working-tree HEAD")
|
|
79
|
+
current_digest = worktree_content_digest(target)
|
|
80
|
+
if base != current_head or head != current_head:
|
|
81
|
+
raise SystemExit(
|
|
82
|
+
"Repository HEAD changed after these working-tree changes were selected. "
|
|
83
|
+
"Select Uncommitted changes again."
|
|
84
|
+
)
|
|
85
|
+
if content_digest and content_digest != current_digest:
|
|
86
|
+
raise SystemExit(
|
|
87
|
+
"Working-tree contents changed after they were selected. "
|
|
88
|
+
"Select Uncommitted changes again."
|
|
89
|
+
)
|
|
90
|
+
return {
|
|
91
|
+
"kind": kind,
|
|
92
|
+
"baseRevision": current_head,
|
|
93
|
+
"headRevision": current_head,
|
|
94
|
+
"contentDigest": current_digest,
|
|
95
|
+
}
|
|
96
|
+
if kind == "commit":
|
|
97
|
+
head = resolve_git_commit(target, head_revision or "", "Commit")
|
|
98
|
+
commit = git_bytes(target, "cat-file", "-p", head)
|
|
99
|
+
if commit is None:
|
|
100
|
+
raise SystemExit(f"Commit is not available in the local checkout: {head}")
|
|
101
|
+
parent_line = next(
|
|
102
|
+
(
|
|
103
|
+
line
|
|
104
|
+
for line in commit.split(b"\n\n", 1)[0].splitlines()
|
|
105
|
+
if line.startswith(b"parent ")
|
|
106
|
+
),
|
|
107
|
+
None,
|
|
108
|
+
)
|
|
109
|
+
if parent_line is None:
|
|
110
|
+
parent = EMPTY_GIT_TREES[git_output(target, "rev-parse", "--show-object-format")]
|
|
111
|
+
else:
|
|
112
|
+
parent = resolve_git_commit(
|
|
113
|
+
target,
|
|
114
|
+
parent_line.removeprefix(b"parent ").decode("ascii").strip(),
|
|
115
|
+
"Commit parent",
|
|
116
|
+
)
|
|
117
|
+
if base_revision and base_revision != parent:
|
|
118
|
+
supplied_base = (
|
|
119
|
+
base_revision
|
|
120
|
+
if base_revision == EMPTY_GIT_TREE
|
|
121
|
+
else resolve_git_commit(target, base_revision, "Commit base")
|
|
122
|
+
)
|
|
123
|
+
if supplied_base != parent:
|
|
124
|
+
raise SystemExit("Commit base revision must match the selected commit's parent.")
|
|
125
|
+
return {"kind": kind, "baseRevision": parent, "headRevision": head}
|
|
126
|
+
base = resolve_git_commit(target, base_revision or "", "Base revision")
|
|
127
|
+
head = resolve_git_commit(target, head_revision or "", "Head revision")
|
|
128
|
+
if base == head:
|
|
129
|
+
raise SystemExit("Base and head revisions must identify different commits.")
|
|
130
|
+
return {"kind": kind, "baseRevision": base, "headRevision": head}
|
|
131
|
+
|
|
132
|
+
|
|
133
|
+
def inspect_setup_values(
|
|
134
|
+
target_path: str,
|
|
135
|
+
scope: str,
|
|
136
|
+
mode: str,
|
|
137
|
+
diff_target_kind: str | None,
|
|
138
|
+
diff_base_revision: str | None,
|
|
139
|
+
diff_head_revision: str | None,
|
|
140
|
+
diff_content_digest: str | None,
|
|
141
|
+
) -> dict[str, Any]:
|
|
142
|
+
"""Validate the target, scope, and scan mode and return their normalized values and resolved diff target."""
|
|
143
|
+
target = require_target(target_path)
|
|
144
|
+
inspected = require_scannable_target(target)
|
|
145
|
+
normalized_scope = require_scope(scope, mode, target)
|
|
146
|
+
if mode == "diff" and normalized_scope != ".":
|
|
147
|
+
raise SystemExit("Review changes requires the whole target; use scope '.'.")
|
|
148
|
+
if mode != "diff" and any(
|
|
149
|
+
value is not None
|
|
150
|
+
for value in (
|
|
151
|
+
diff_target_kind,
|
|
152
|
+
diff_base_revision,
|
|
153
|
+
diff_head_revision,
|
|
154
|
+
diff_content_digest,
|
|
155
|
+
)
|
|
156
|
+
):
|
|
157
|
+
raise SystemExit("A Git diff target requires Review changes mode.")
|
|
158
|
+
diff_target = (
|
|
159
|
+
require_diff_target(
|
|
160
|
+
target,
|
|
161
|
+
diff_target_kind,
|
|
162
|
+
diff_base_revision,
|
|
163
|
+
diff_head_revision,
|
|
164
|
+
diff_content_digest,
|
|
165
|
+
)
|
|
166
|
+
if mode == "diff"
|
|
167
|
+
else None
|
|
168
|
+
)
|
|
169
|
+
return {
|
|
170
|
+
"diffTarget": diff_target,
|
|
171
|
+
"scope": normalized_scope,
|
|
172
|
+
"target": inspected,
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
|
|
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."""
|
|
178
|
+
revision = require_git_worktree_head(target)
|
|
179
|
+
repository_root = git_output(target, "rev-parse", "--show-toplevel")
|
|
180
|
+
if repository_root is None or not Path(repository_root).samefile(target):
|
|
181
|
+
raise SystemExit(
|
|
182
|
+
"Review changes requires the checked-out Git repository root as the target."
|
|
183
|
+
)
|
|
184
|
+
return revision
|
|
185
|
+
|
|
186
|
+
|
|
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."""
|
|
189
|
+
inspected = inspect_target(target)
|
|
190
|
+
metadata = inspected["targetMetadata"]
|
|
191
|
+
if metadata["isGit"] and not metadata["isWorktree"]:
|
|
192
|
+
raise SystemExit(
|
|
193
|
+
"Codex Security requires a checked-out worktree, not a bare Git repository."
|
|
194
|
+
)
|
|
195
|
+
return inspected
|
|
196
|
+
|
|
197
|
+
|
|
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."""
|
|
200
|
+
value = scope if scope.strip() else "."
|
|
201
|
+
requested_scope = Path(value)
|
|
202
|
+
if "\\" in value and (os.name != "nt" or not requested_scope.is_absolute()):
|
|
203
|
+
raise SystemExit("Scan scope must use repository-relative POSIX paths.")
|
|
204
|
+
if ".." in requested_scope.parts:
|
|
205
|
+
raise SystemExit("Scan scope must stay inside the scanned target.")
|
|
206
|
+
try:
|
|
207
|
+
resolved_scope = (
|
|
208
|
+
requested_scope if requested_scope.is_absolute() else target / requested_scope
|
|
209
|
+
).resolve()
|
|
210
|
+
relative_scope = resolved_scope.relative_to(target)
|
|
211
|
+
except (RuntimeError, ValueError) as exc:
|
|
212
|
+
raise SystemExit("Scan scope must stay inside the scanned target.") from exc
|
|
213
|
+
normalized = relative_scope.as_posix() or "."
|
|
214
|
+
if not normalized.strip():
|
|
215
|
+
normalized = "./" + normalized
|
|
216
|
+
if mode == "deep" and normalized != ".":
|
|
217
|
+
raise SystemExit("Deep Scan is repository-wide and cannot use a scoped path.")
|
|
218
|
+
if not resolved_scope.is_dir():
|
|
219
|
+
raise SystemExit("Scan scope must reference an existing directory inside the target.")
|
|
220
|
+
return normalized
|
|
221
|
+
|
|
222
|
+
|
|
223
|
+
def inspect_selected_setup(args: argparse.Namespace) -> dict[str, Any]:
|
|
224
|
+
inspected = inspect_setup_values(
|
|
225
|
+
args.target_path,
|
|
226
|
+
args.scope,
|
|
227
|
+
args.mode,
|
|
228
|
+
args.diff_target_kind,
|
|
229
|
+
args.diff_base_revision,
|
|
230
|
+
args.diff_head_revision,
|
|
231
|
+
args.diff_content_digest,
|
|
232
|
+
)
|
|
233
|
+
if args.mode == "deep":
|
|
234
|
+
inspected["deepScanConfig"] = resolve_deep_scan_setup(
|
|
235
|
+
project_json=args.deep_scan_project_json
|
|
236
|
+
)
|
|
237
|
+
elif args.deep_scan_project_json is not None:
|
|
238
|
+
raise SystemExit("Project Deep Scan settings require Deep Scan mode.")
|
|
239
|
+
return inspected
|
|
240
|
+
|
|
241
|
+
|
|
242
|
+
def inspect_command(args: argparse.Namespace) -> dict[str, Any]:
|
|
243
|
+
if args.command == "inspect-target":
|
|
244
|
+
return inspect_target(require_target(args.target_path))
|
|
245
|
+
return inspect_selected_setup(args)
|
|
246
|
+
|
|
247
|
+
|
|
248
|
+
def main() -> None:
|
|
249
|
+
sys.stdin.reconfigure(encoding="utf-8")
|
|
250
|
+
args = parse_args("Codex Security workbench persistence.", inspection_only=True)
|
|
251
|
+
print(json.dumps(inspect_command(args), allow_nan=False, sort_keys=True))
|
|
@@ -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):
|
|
@@ -17,7 +17,7 @@ from unicodedata import normalize
|
|
|
17
17
|
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
|
18
18
|
from workbench_target import (
|
|
19
19
|
clean_worktree_content_digest,
|
|
20
|
-
|
|
20
|
+
git_command,
|
|
21
21
|
git_worktree_context,
|
|
22
22
|
)
|
|
23
23
|
from workbench_validation import reject_non_finite_json
|
|
@@ -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,23 +78,20 @@ 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:
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
if value is None:
|
|
87
|
-
os.environ.pop(name, None)
|
|
88
|
-
else:
|
|
89
|
-
os.environ[name] = value
|
|
81
|
+
"""Return raw stdout for a successful offline Git command with replacement objects disabled, otherwise None."""
|
|
82
|
+
result = git_command(
|
|
83
|
+
repository,
|
|
84
|
+
*arguments,
|
|
85
|
+
text=False,
|
|
86
|
+
offline=True,
|
|
87
|
+
environment_overrides={"GIT_NO_REPLACE_OBJECTS": "1"},
|
|
88
|
+
)
|
|
89
|
+
return result.stdout if result.returncode == 0 else None
|
|
90
90
|
|
|
91
91
|
|
|
92
92
|
@cache
|
|
93
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."""
|
|
94
95
|
content = offline_git_bytes(repository, "ls-tree", "-z", tree)
|
|
95
96
|
if content is None:
|
|
96
97
|
return None
|
|
@@ -120,9 +121,7 @@ def tree_entries(repository: Path, tree: str) -> dict[str, tuple[tuple[str, str,
|
|
|
120
121
|
return {name: tuple(matches) for name, matches in entries.items()}
|
|
121
122
|
|
|
122
123
|
|
|
123
|
-
def exact_tree_path(
|
|
124
|
-
repository: Path, tree: str, value: str, *, require_unambiguous: bool = False
|
|
125
|
-
) -> tuple[str, str, str] | None:
|
|
124
|
+
def exact_tree_path(repository: Path, tree: str, value: str) -> tuple[str, str, str] | None:
|
|
126
125
|
path = relative_path(value)
|
|
127
126
|
if path is None:
|
|
128
127
|
return None
|
|
@@ -132,12 +131,11 @@ def exact_tree_path(
|
|
|
132
131
|
return None
|
|
133
132
|
entries = tree_entries(repository, object_id) or {}
|
|
134
133
|
aliases = entries.get(normalized_path_component(name), ())
|
|
135
|
-
if
|
|
134
|
+
if len(aliases) != 1:
|
|
136
135
|
return None
|
|
137
|
-
|
|
138
|
-
if
|
|
136
|
+
entry_name, kind, object_id = aliases[0]
|
|
137
|
+
if entry_name != name:
|
|
139
138
|
return None
|
|
140
|
-
_, kind, object_id = entry
|
|
141
139
|
return path.as_posix(), kind, object_id
|
|
142
140
|
|
|
143
141
|
|
|
@@ -225,6 +223,12 @@ def capture_source_scopes(
|
|
|
225
223
|
*,
|
|
226
224
|
diff_target_kind: str | None = None,
|
|
227
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
|
+
"""
|
|
228
232
|
revision, snapshot = target_identity[:2]
|
|
229
233
|
result: dict[str, Any] = {"version": 1, "revision": revision, "scopes": []}
|
|
230
234
|
# HEAD cannot represent the uncommitted bytes reviewed by a working-tree scan.
|
|
@@ -275,6 +279,11 @@ def capture_source_scopes(
|
|
|
275
279
|
def load_source_scopes(
|
|
276
280
|
scan: sqlite3.Row, target: Path, requested: list[str]
|
|
277
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
|
+
"""
|
|
278
287
|
kind = scan["diff_target_kind"] if "diff_target_kind" in scan.keys() else None
|
|
279
288
|
if kind == "working_tree" or (
|
|
280
289
|
"mode" in scan.keys() and scan["mode"] == "diff" and kind not in ("commit", "range")
|
|
@@ -329,7 +338,7 @@ def load_source_scopes(
|
|
|
329
338
|
repository, tree = context
|
|
330
339
|
scopes = []
|
|
331
340
|
for path in paths:
|
|
332
|
-
entry = exact_tree_path(repository, tree, path
|
|
341
|
+
entry = exact_tree_path(repository, tree, path)
|
|
333
342
|
if entry is None or entry[1] not in {"file", "directory"}:
|
|
334
343
|
continue
|
|
335
344
|
kind = entry[1]
|
|
@@ -351,6 +360,7 @@ def load_source_scopes(
|
|
|
351
360
|
def source_object_for_path(
|
|
352
361
|
repository: Path, tree: str, target: Path, value: str, scope: dict[str, str]
|
|
353
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."""
|
|
354
364
|
path = relative_path(value)
|
|
355
365
|
if path is None or safe_source_path(target, value) is None:
|
|
356
366
|
return None
|
|
@@ -375,7 +385,7 @@ def source_object_for_path(
|
|
|
375
385
|
if scope["kind"] == "file":
|
|
376
386
|
return scope["objectId"] if not suffix else None
|
|
377
387
|
relative = PurePosixPath(*suffix).as_posix()
|
|
378
|
-
entry = exact_tree_path(repository, scope["objectId"], relative
|
|
388
|
+
entry = exact_tree_path(repository, scope["objectId"], relative)
|
|
379
389
|
if entry is None:
|
|
380
390
|
selected = safe_source_path(target, scope["canonicalPath"])
|
|
381
391
|
if selected is not None:
|