@openai/codex-security 0.8.3 → 0.10.0
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 +36 -746
- package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
- package/_bundled_plugin/.mcp.json +7 -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/artifact-storage.md +1 -1
- package/_bundled_plugin/references/baseline-auditor.md +18 -0
- package/_bundled_plugin/references/core-scan.md +5 -42
- 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/focused-investigator.md +13 -0
- 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/scan-prologue.md +2 -2
- package/_bundled_plugin/references/scan-runtime.md +4 -2
- package/_bundled_plugin/references/security-guidance.md +14 -1
- package/_bundled_plugin/references/validate-scan-findings.md +3 -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 +192 -352
- package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
- package/_bundled_plugin/scripts/finding_preview.py +20 -0
- package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
- package/_bundled_plugin/scripts/legacy_findings.py +148 -0
- package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
- 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 +9 -2
- 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 +582 -20
- package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
- package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
- 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 +91 -7
- package/_bundled_plugin/scripts/workbench_cli.py +54 -14
- package/_bundled_plugin/scripts/workbench_constants.py +12 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
- package/_bundled_plugin/scripts/workbench_db.py +562 -303
- package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
- 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 +238 -41
- package/_bundled_plugin/scripts/workbench_progress.py +169 -4
- package/_bundled_plugin/scripts/workbench_publication.py +16 -13
- package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
- package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
- package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
- package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
- package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
- package/_bundled_plugin/scripts/workbench_schema.py +258 -63
- package/_bundled_plugin/scripts/workbench_setup.py +14 -2
- 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 +594 -136
- package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
- package/_bundled_plugin/scripts/workbench_validation.py +43 -3
- package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
- package/_bundled_plugin/shared/workbench-migrations.json +100 -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 +2 -1
- package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
- package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
- 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 +409 -0
- package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
- package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
- package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
- package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
- package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
- package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
- package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
- package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -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/bin/codex-security.mjs +2 -2
- package/dist/api.d.ts +45 -5
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +1192 -427
- package/dist/api.js.map +1 -1
- package/dist/armorcode-findings.d.ts +9 -0
- package/dist/armorcode-findings.d.ts.map +1 -0
- package/dist/armorcode-findings.js +145 -0
- package/dist/armorcode-findings.js.map +1 -0
- package/dist/artifact-export.d.ts +2 -0
- package/dist/artifact-export.d.ts.map +1 -1
- package/dist/artifact-export.js +29 -13
- package/dist/artifact-export.js.map +1 -1
- package/dist/auth.d.ts +6 -2
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +37 -18
- package/dist/auth.js.map +1 -1
- package/dist/batch-cost.d.ts +18 -0
- package/dist/batch-cost.d.ts.map +1 -0
- package/dist/batch-cost.js +41 -0
- package/dist/batch-cost.js.map +1 -0
- 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 +1 -1
- package/dist/blackduck-findings.d.ts.map +1 -1
- package/dist/blackduck-findings.js +24 -22
- 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/bundled-plugin.d.ts +4 -0
- package/dist/bundled-plugin.d.ts.map +1 -0
- package/dist/bundled-plugin.js +23 -0
- package/dist/bundled-plugin.js.map +1 -0
- 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-scan-severity.d.ts +1 -1
- package/dist/classify-scan-severity.d.ts.map +1 -1
- package/dist/classify-scan-severity.js +11 -3
- package/dist/classify-scan-severity.js.map +1 -1
- 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 +11 -10
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-argument.d.ts +4 -0
- package/dist/cli-argument.d.ts.map +1 -0
- package/dist/cli-argument.js +17 -0
- package/dist/cli-argument.js.map +1 -0
- package/dist/cli-help.d.ts +1 -1
- package/dist/cli-help.d.ts.map +1 -1
- package/dist/cli-help.js +71 -29
- package/dist/cli-help.js.map +1 -1
- package/dist/cli-hook.d.ts +3 -0
- package/dist/cli-hook.d.ts.map +1 -0
- package/dist/cli-hook.js +87 -0
- package/dist/cli-hook.js.map +1 -0
- package/dist/cli-integrations.d.ts +13 -0
- package/dist/cli-integrations.d.ts.map +1 -0
- package/dist/cli-integrations.js +333 -0
- package/dist/cli-integrations.js.map +1 -0
- package/dist/cli-mcp.d.ts +15 -0
- package/dist/cli-mcp.d.ts.map +1 -0
- package/dist/cli-mcp.js +178 -0
- package/dist/cli-mcp.js.map +1 -0
- package/dist/cli-token-view.d.ts +10 -0
- package/dist/cli-token-view.d.ts.map +1 -0
- package/dist/cli-token-view.js +41 -0
- package/dist/cli-token-view.js.map +1 -0
- package/dist/cli.d.ts +16 -8
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +3382 -2017
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +35 -33
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codex-sdk-environment.d.ts +6 -0
- package/dist/codex-sdk-environment.d.ts.map +1 -1
- package/dist/codex-sdk-environment.js +19 -0
- package/dist/codex-sdk-environment.js.map +1 -1
- package/dist/command-words.d.ts +3 -0
- package/dist/command-words.d.ts.map +1 -0
- package/dist/command-words.js +46 -0
- package/dist/command-words.js.map +1 -0
- package/dist/component-scan.d.ts +19 -4
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +67 -9
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +130 -67
- package/dist/config.js.map +1 -1
- package/dist/continuum-findings.d.ts +1 -1
- package/dist/continuum-findings.d.ts.map +1 -1
- package/dist/continuum-findings.js +149 -19
- 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 +484 -149
- 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 +29 -19
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/deduplication/local.d.ts +4 -2
- package/dist/deduplication/local.d.ts.map +1 -1
- package/dist/deduplication/local.js +9 -2
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/refusal.d.ts.map +1 -1
- package/dist/deduplication/refusal.js +26 -5
- package/dist/deduplication/refusal.js.map +1 -1
- package/dist/deduplication/scan.d.ts +5 -0
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +24 -7
- 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 +44 -19
- 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 +86 -45
- package/dist/endor-findings.js.map +1 -1
- package/dist/errors.d.ts +4 -2
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +15 -4
- package/dist/errors.js.map +1 -1
- package/dist/executable-path.d.ts +3 -0
- package/dist/executable-path.d.ts.map +1 -1
- package/dist/executable-path.js +26 -0
- package/dist/executable-path.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 +19 -7
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +69 -5
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +537 -108
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +13 -6
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +895 -1142
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +21 -2
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +130 -68
- 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 +54 -2
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +8 -12
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +51 -184
- 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 +18 -8
- 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 +73 -316
- 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-remediation.d.ts +1 -0
- package/dist/hosted-remediation.d.ts.map +1 -1
- package/dist/hosted-remediation.js +23 -3
- package/dist/hosted-remediation.js.map +1 -1
- 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/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 +21 -9
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +12 -3
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +52 -86
- package/dist/inspector-findings.js.map +1 -1
- package/dist/knowledge-base.d.ts +1 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +102 -32
- package/dist/knowledge-base.js.map +1 -1
- package/dist/linear.d.ts +11 -0
- package/dist/linear.d.ts.map +1 -1
- package/dist/linear.js.map +1 -1
- package/dist/local-git-metadata.d.ts +5 -2
- package/dist/local-git-metadata.d.ts.map +1 -1
- package/dist/local-git-metadata.js +8 -5
- package/dist/local-git-metadata.js.map +1 -1
- package/dist/multiscan.d.ts +10 -4
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +217 -102
- 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 +5 -2
- package/dist/opengrep-findings.d.ts.map +1 -1
- package/dist/opengrep-findings.js +54 -33
- 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 +99 -9
- package/dist/private-finding-import.d.ts.map +1 -1
- package/dist/private-finding-import.js +116 -152
- package/dist/private-finding-import.js.map +1 -1
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +53 -13
- package/dist/project-config.js.map +1 -1
- package/dist/prompt-files.d.ts +7 -2
- package/dist/prompt-files.d.ts.map +1 -1
- package/dist/prompt-files.js +42 -20
- package/dist/prompt-files.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 +12 -10
- 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.d.ts +1 -1
- package/dist/publication.d.ts.map +1 -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/record.d.ts +1 -5
- package/dist/record.d.ts.map +1 -1
- package/dist/record.js +3 -51
- package/dist/record.js.map +1 -1
- package/dist/remediation.d.ts +1 -4
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +6 -8
- 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 +54 -6
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +1084 -256
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +7 -1
- package/dist/saved-scan-bootstrap.d.ts.map +1 -1
- package/dist/saved-scan-bootstrap.js +269 -114
- 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-archive-path.d.ts +2 -0
- package/dist/scan-archive-path.d.ts.map +1 -0
- package/dist/scan-archive-path.js +5 -0
- package/dist/scan-archive-path.js.map +1 -0
- package/dist/scan-comparison.d.ts +10 -5
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +66 -17
- 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 +92 -43
- 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 +24 -2
- package/dist/scan-executor.js.map +1 -1
- package/dist/scan-history-renderer.d.ts +1 -0
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +34 -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 +131 -78
- 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 +25 -13
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +216 -97
- 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 +26 -6
- 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 +72 -42
- 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 +157 -6
- package/dist/semgrep-platform-findings.d.ts.map +1 -1
- package/dist/semgrep-platform-findings.js +766 -103
- package/dist/semgrep-platform-findings.js.map +1 -1
- 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 +9 -2
- package/dist/snyk-findings.d.ts.map +1 -1
- package/dist/snyk-findings.js +90 -70
- package/dist/snyk-findings.js.map +1 -1
- package/dist/snyk-rest-findings.d.ts +59 -0
- package/dist/snyk-rest-findings.d.ts.map +1 -0
- package/dist/snyk-rest-findings.js +879 -0
- package/dist/snyk-rest-findings.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-findings.d.ts +1 -1
- package/dist/sonar-findings.d.ts.map +1 -1
- package/dist/sonar-findings.js +2 -4
- package/dist/sonar-findings.js.map +1 -1
- package/dist/sonar-import.d.ts +3 -0
- package/dist/sonar-import.d.ts.map +1 -1
- package/dist/sonar-import.js +30 -34
- package/dist/sonar-import.js.map +1 -1
- package/dist/stored-finding-projection.d.ts +6 -0
- package/dist/stored-finding-projection.d.ts.map +1 -0
- package/dist/stored-finding-projection.js +104 -0
- package/dist/stored-finding-projection.js.map +1 -0
- package/dist/stored-findings-publication.d.ts +23 -0
- package/dist/stored-findings-publication.d.ts.map +1 -0
- package/dist/stored-findings-publication.js +169 -0
- package/dist/stored-findings-publication.js.map +1 -0
- 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 +8 -1
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +131 -42
- package/dist/targets.js.map +1 -1
- package/dist/tenable-findings.d.ts +6 -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 +424 -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/trusted-executable.d.ts +6 -0
- package/dist/trusted-executable.d.ts.map +1 -1
- package/dist/trusted-executable.js +140 -37
- package/dist/trusted-executable.js.map +1 -1
- package/dist/validation-records.js +1 -1
- package/dist/validation-records.js.map +1 -1
- package/dist/veracode-findings.d.ts +1 -1
- package/dist/veracode-findings.d.ts.map +1 -1
- package/dist/veracode-findings.js +19 -6
- package/dist/veracode-findings.js.map +1 -1
- package/dist/version.d.ts +3 -1
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +184 -32
- package/dist/version.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 +6 -2
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +65 -89
- package/dist/wiz-findings.js.map +1 -1
- package/docs/classify-severity-records.md +27 -12
- package/docs/cli.md +853 -639
- package/docs/dedupe-records.md +44 -24
- package/docs/findings-service.md +84 -44
- package/docs/hosted-remediation.md +27 -11
- package/docs/hosted-scans.md +50 -42
- package/docs/sdk.md +903 -0
- package/docs/telemetry.md +236 -0
- package/docs/validate-records.md +78 -44
- package/package.json +23 -16
- package/schemas/external-findings.schema.json +4 -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
- package/dist/reader-selection.d.ts +0 -13
- package/dist/reader-selection.d.ts.map +0 -1
- package/dist/reader-selection.js +0 -81
- package/dist/reader-selection.js.map +0 -1
|
@@ -1,14 +1,17 @@
|
|
|
1
1
|
"""Progress transition helpers for the Codex Security workbench."""
|
|
2
2
|
|
|
3
3
|
import argparse
|
|
4
|
+
import json
|
|
5
|
+
import os
|
|
4
6
|
import sqlite3
|
|
5
7
|
import sys
|
|
6
8
|
from pathlib import Path
|
|
7
9
|
from typing import Any
|
|
8
10
|
|
|
9
11
|
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
|
10
|
-
from deep_scan_workbench import require_current_coordinator
|
|
11
|
-
from
|
|
12
|
+
from deep_scan_workbench import independent_review_progress, require_current_coordinator
|
|
13
|
+
from finalize_scan_contract import open_scan_local_file_descriptor
|
|
14
|
+
from workbench.handoff import require_current_continuation, require_tokenless_scan_owner
|
|
12
15
|
from workbench_constants import PHASES
|
|
13
16
|
from workbench_validation import optional_text, require_uuid, user_context_argument
|
|
14
17
|
|
|
@@ -16,6 +19,7 @@ from workbench_validation import optional_text, require_uuid, user_context_argum
|
|
|
16
19
|
def reportable_count(
|
|
17
20
|
current_phase: str, requested_phase: str | None, count: int | None
|
|
18
21
|
) -> int | None:
|
|
22
|
+
"""Default a missing count to zero on entering validation or a later phase from an earlier phase."""
|
|
19
23
|
if count is None and requested_phase in PHASES[3:] and current_phase in PHASES[:3]:
|
|
20
24
|
return 0
|
|
21
25
|
return count
|
|
@@ -26,6 +30,7 @@ def update_context(
|
|
|
26
30
|
connection: sqlite3.Connection,
|
|
27
31
|
args: argparse.Namespace,
|
|
28
32
|
) -> dict[str, Any]:
|
|
33
|
+
"""Update user context on a running scan and return the refreshed scan context in the same workbench."""
|
|
29
34
|
scan_id = require_uuid(args.scan_id, "scan-id")
|
|
30
35
|
context = user_context_argument(args)
|
|
31
36
|
connection.execute("BEGIN IMMEDIATE")
|
|
@@ -67,20 +72,178 @@ def update_context(
|
|
|
67
72
|
return wb.scan_context(connection, scan_id)
|
|
68
73
|
|
|
69
74
|
|
|
75
|
+
def scan_progress_result(
|
|
76
|
+
connection: sqlite3.Connection, scan: sqlite3.Row
|
|
77
|
+
) -> tuple[dict[str, Any], str]:
|
|
78
|
+
independent_reviews = (
|
|
79
|
+
independent_review_progress(
|
|
80
|
+
connection, scan["id"], parent_running=scan["status"] == "running"
|
|
81
|
+
)
|
|
82
|
+
if scan["mode"] == "deep"
|
|
83
|
+
else None
|
|
84
|
+
)
|
|
85
|
+
progress_result = {
|
|
86
|
+
"candidates": {"reportable": scan["reportable_findings_count"]},
|
|
87
|
+
"coverage": {
|
|
88
|
+
"closedRows": scan["review_items_completed"],
|
|
89
|
+
"filesTotal": scan["scope_file_count"],
|
|
90
|
+
"worklistRows": scan["review_items_total"],
|
|
91
|
+
},
|
|
92
|
+
"phase": scan["phase"],
|
|
93
|
+
"phaseProgress": {
|
|
94
|
+
"completed": scan["phase_items_completed"],
|
|
95
|
+
"total": scan["phase_items_total"],
|
|
96
|
+
"unit": scan["phase_progress_unit"],
|
|
97
|
+
},
|
|
98
|
+
"preflightProgress": {
|
|
99
|
+
"completed": scan["preflight_checks_completed"],
|
|
100
|
+
"total": scan["preflight_checks_total"],
|
|
101
|
+
},
|
|
102
|
+
"preflightIssues": json.loads(scan["preflight_issues_json"]),
|
|
103
|
+
"reviewPass": scan["deep_review_pass"],
|
|
104
|
+
"status": "canceled" if scan["canceled_at"] else scan["status"],
|
|
105
|
+
"updatedAt": scan["progress_updated_at"],
|
|
106
|
+
}
|
|
107
|
+
review_updated_at = ""
|
|
108
|
+
if independent_reviews is not None:
|
|
109
|
+
review_updated_at = str(independent_reviews.pop("updatedAt"))
|
|
110
|
+
progress_result["independentReviews"] = independent_reviews
|
|
111
|
+
return progress_result, review_updated_at
|
|
112
|
+
|
|
113
|
+
|
|
114
|
+
def model_progress(wb: Any, connection: sqlite3.Connection, scan_id: str) -> dict[str, Any]:
|
|
115
|
+
scan = wb.scan_history.scan_with_progress(connection, scan_id)
|
|
116
|
+
progress, _ = scan_progress_result(connection, scan)
|
|
117
|
+
result = {"scanId": scan["id"], "progress": progress, "userContext": scan["user_context"]}
|
|
118
|
+
if warnings := json.loads(scan["completion_warnings_json"]):
|
|
119
|
+
result["warnings"] = warnings
|
|
120
|
+
return result
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
def deep_preflight(scan: sqlite3.Row) -> bool:
|
|
124
|
+
return scan["mode"] == "deep" and scan["phase"] == "preflight" and scan["canceled_at"] is None
|
|
125
|
+
|
|
126
|
+
|
|
127
|
+
def reported_scope_file_count(wb: Any, scan: sqlite3.Row) -> int | None:
|
|
128
|
+
"""Read the scoped helper's optional progress count, independently of scan evidence."""
|
|
129
|
+
if (
|
|
130
|
+
scan["mode"] != "standard"
|
|
131
|
+
or scan["launch_kind"] not in (None, "scan")
|
|
132
|
+
or not scan["recipe_json"]
|
|
133
|
+
):
|
|
134
|
+
return None
|
|
135
|
+
try:
|
|
136
|
+
recipe = json.loads(scan["recipe_json"])
|
|
137
|
+
target = recipe.get("target") if isinstance(recipe, dict) else None
|
|
138
|
+
if not isinstance(target, dict) or target.get("kind") != "paths":
|
|
139
|
+
return None
|
|
140
|
+
repositories = (scan["target_path"], recipe.get("repository"))
|
|
141
|
+
largest_count = 2**53 - 1 # The SDK reports this value as a JavaScript safe integer.
|
|
142
|
+
maximum = (
|
|
143
|
+
max(
|
|
144
|
+
len(json.dumps({"scanId": scan["id"], "repository": repo, "count": largest_count}))
|
|
145
|
+
for repo in repositories
|
|
146
|
+
if isinstance(repo, str)
|
|
147
|
+
)
|
|
148
|
+
+ 1
|
|
149
|
+
) # The helper includes a trailing newline.
|
|
150
|
+
scan_dir = wb.require_canonical_scan_directory(Path(scan["scan_dir"]))
|
|
151
|
+
descriptor = open_scan_local_file_descriptor(
|
|
152
|
+
scan_dir, "scoped-source-input.receipt.json", "Scoped inventory count"
|
|
153
|
+
)
|
|
154
|
+
with os.fdopen(descriptor, "rb") as stream:
|
|
155
|
+
data = stream.read(maximum + 1)
|
|
156
|
+
if len(data) > maximum:
|
|
157
|
+
return None
|
|
158
|
+
report = json.loads(data)
|
|
159
|
+
if (
|
|
160
|
+
isinstance(report, dict)
|
|
161
|
+
and report.get("scanId") == scan["id"]
|
|
162
|
+
and isinstance(report.get("repository"), str)
|
|
163
|
+
and report["repository"] in repositories
|
|
164
|
+
and type(count := report.get("count")) is int
|
|
165
|
+
and 0 <= count <= largest_count
|
|
166
|
+
):
|
|
167
|
+
return count
|
|
168
|
+
except (OSError, ValueError, RecursionError, SystemExit):
|
|
169
|
+
# An unreadable optional report leaves the stored estimate in place so the scan can continue.
|
|
170
|
+
pass
|
|
171
|
+
return None
|
|
172
|
+
|
|
173
|
+
|
|
174
|
+
def refresh_scope_file_count(
|
|
175
|
+
wb: Any, connection: sqlite3.Connection, scan_id: str, claim_token: str | None
|
|
176
|
+
) -> dict[str, int | None]:
|
|
177
|
+
scan = wb.require_scan(connection, scan_id)
|
|
178
|
+
if scan["status"] != "running":
|
|
179
|
+
return {"scopeFileCount": None}
|
|
180
|
+
ownership_error = "Scan updates are owned by another continuation."
|
|
181
|
+
require_current_continuation(scan, claim_token, error_message=ownership_error)
|
|
182
|
+
count = reported_scope_file_count(wb, scan)
|
|
183
|
+
if count is None:
|
|
184
|
+
return {"scopeFileCount": None}
|
|
185
|
+
timeout = int(connection.execute("PRAGMA busy_timeout").fetchone()[0])
|
|
186
|
+
try:
|
|
187
|
+
connection.execute("PRAGMA busy_timeout = 0")
|
|
188
|
+
with connection:
|
|
189
|
+
connection.execute("BEGIN IMMEDIATE")
|
|
190
|
+
current = wb.require_scan(connection, scan_id)
|
|
191
|
+
if current["status"] != "running" or current["scan_dir"] != scan["scan_dir"]:
|
|
192
|
+
return {"scopeFileCount": None}
|
|
193
|
+
require_current_continuation(current, claim_token, error_message=ownership_error)
|
|
194
|
+
connection.execute(
|
|
195
|
+
"UPDATE scan_progress SET scope_file_count = ?, updated_at = ? WHERE scan_id = ?",
|
|
196
|
+
(count, wb.now(), scan_id),
|
|
197
|
+
)
|
|
198
|
+
except sqlite3.OperationalError as exc:
|
|
199
|
+
if not wb.sqlite_busy(exc):
|
|
200
|
+
raise
|
|
201
|
+
return {"scopeFileCount": None, "retry": True}
|
|
202
|
+
finally:
|
|
203
|
+
connection.execute(f"PRAGMA busy_timeout = {timeout}")
|
|
204
|
+
return {"scopeFileCount": count}
|
|
205
|
+
|
|
206
|
+
|
|
70
207
|
def update_progress(
|
|
71
208
|
wb: Any,
|
|
72
209
|
connection: sqlite3.Connection,
|
|
73
210
|
args: argparse.Namespace,
|
|
74
211
|
) -> dict[str, Any]:
|
|
212
|
+
"""Record phase and review counters for a running scan and return its updated context.
|
|
213
|
+
|
|
214
|
+
Check continuation and coordinator ownership where applicable. A new phase
|
|
215
|
+
starts with fresh phase counters. A new Deep Scan review pass must start
|
|
216
|
+
with zero completed items. Invalid progress raises SystemExit.
|
|
217
|
+
"""
|
|
75
218
|
scan_id = require_uuid(args.scan_id, "scan-id")
|
|
219
|
+
if args.refresh_scope_file_count:
|
|
220
|
+
return refresh_scope_file_count(wb, connection, scan_id, args.claim_token)
|
|
76
221
|
model = optional_text(args.model, maximum=200)
|
|
77
222
|
reasoning_effort = optional_text(args.reasoning_effort, maximum=32)
|
|
78
|
-
connection.execute("BEGIN IMMEDIATE")
|
|
79
223
|
with connection:
|
|
224
|
+
scan = None
|
|
225
|
+
if args.model_update:
|
|
226
|
+
connection.execute("BEGIN")
|
|
227
|
+
scan = wb.require_scan(connection, scan_id)
|
|
228
|
+
if not deep_preflight(scan):
|
|
229
|
+
connection.rollback()
|
|
230
|
+
scan = None
|
|
231
|
+
if scan is None:
|
|
232
|
+
# Reread under the writer lock before applying any progress change.
|
|
233
|
+
wb.begin_immediate_with_retry(connection)
|
|
234
|
+
scan = wb.require_scan(connection, scan_id)
|
|
80
235
|
timestamp = wb.now()
|
|
81
|
-
scan
|
|
236
|
+
require_tokenless_scan_owner(connection, scan, getattr(args, "model_thread_id", None))
|
|
82
237
|
if scan["status"] != "running":
|
|
83
238
|
raise SystemExit("Only a running scan can update progress.")
|
|
239
|
+
if args.model_update and deep_preflight(scan):
|
|
240
|
+
if scan["handoff_claim_token"] is not None:
|
|
241
|
+
require_current_continuation(
|
|
242
|
+
scan,
|
|
243
|
+
args.claim_token,
|
|
244
|
+
error_message="Scan updates are owned by another continuation.",
|
|
245
|
+
)
|
|
246
|
+
return {"scan": model_progress(wb, connection, scan_id), "deepPreflight": True}
|
|
84
247
|
if scan["mode"] == "deep":
|
|
85
248
|
coordinator = connection.execute(
|
|
86
249
|
"SELECT * FROM deep_scan_runs WHERE scan_id = ?", (scan_id,)
|
|
@@ -195,6 +358,8 @@ def update_progress(
|
|
|
195
358
|
f"UPDATE scan_progress SET {', '.join(updates)}, updated_at = ? WHERE scan_id = ?",
|
|
196
359
|
(*values, timestamp, scan["id"]),
|
|
197
360
|
)
|
|
361
|
+
if args.model_update:
|
|
362
|
+
return {"scan": model_progress(wb, connection, scan_id)}
|
|
198
363
|
return wb.scan_context(connection, scan["id"])
|
|
199
364
|
|
|
200
365
|
|
|
@@ -12,7 +12,6 @@ import sys
|
|
|
12
12
|
from contextlib import closing
|
|
13
13
|
from pathlib import Path
|
|
14
14
|
from typing import Any
|
|
15
|
-
from urllib.parse import quote
|
|
16
15
|
|
|
17
16
|
# Some plugin hosts launch Python with safe-path isolation enabled.
|
|
18
17
|
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
|
@@ -27,10 +26,13 @@ from finalize_scan_contract import (
|
|
|
27
26
|
write_export_output,
|
|
28
27
|
write_sarif_projection,
|
|
29
28
|
)
|
|
29
|
+
from snapshot_sqlite import readonly_sqlite_uri
|
|
30
30
|
from validate_scan_contract import validate_contract
|
|
31
|
+
from workbench_constants import PRIMARY_FINDING_LOCATION_SQL
|
|
31
32
|
|
|
32
33
|
|
|
33
34
|
def destination_key(destination: Any) -> str:
|
|
35
|
+
"""Encode exact provider-specific destination IDs into a stable key for matching issue receipts."""
|
|
34
36
|
if not isinstance(destination, dict):
|
|
35
37
|
raise SystemExit("Finding issues require an exact tracker destination.")
|
|
36
38
|
kind = destination.get("type")
|
|
@@ -59,6 +61,12 @@ def verify_publication_history(
|
|
|
59
61
|
scan_directory: str,
|
|
60
62
|
findings: list[dict[str, Any]],
|
|
61
63
|
) -> None:
|
|
64
|
+
"""Require publication input to match the completed scan in local history.
|
|
65
|
+
|
|
66
|
+
Check the exact scan ID, directory, pinned manifest digest when present,
|
|
67
|
+
and the complete set of occurrence-to-finding associations. Raise
|
|
68
|
+
SystemExit if any of these disagree.
|
|
69
|
+
"""
|
|
62
70
|
try:
|
|
63
71
|
scan = db.require_scan(connection, scan_id)
|
|
64
72
|
except SystemExit as exc:
|
|
@@ -109,6 +117,7 @@ def inspect_issue_receipts(
|
|
|
109
117
|
key: str,
|
|
110
118
|
finding_ids: list[str],
|
|
111
119
|
) -> list[dict[str, Any]]:
|
|
120
|
+
"""Return receipts for the selected findings and destination, including receipts from older Linear tables."""
|
|
112
121
|
tables = {
|
|
113
122
|
row[0] for row in connection.execute("SELECT name FROM sqlite_master WHERE type = 'table'")
|
|
114
123
|
}
|
|
@@ -132,6 +141,7 @@ def inspect_issue_receipts(
|
|
|
132
141
|
|
|
133
142
|
|
|
134
143
|
def validate_issue_receipts(receipts: Any, selected: dict[str, str]) -> list[dict[str, Any]]:
|
|
144
|
+
"""Return receipts bound to the selected finding occurrences or raise SystemExit on invalid receipt data."""
|
|
135
145
|
if not isinstance(receipts, list):
|
|
136
146
|
raise SystemExit("Finding issue receipts must be an array.")
|
|
137
147
|
for receipt in receipts:
|
|
@@ -216,9 +226,8 @@ def finding_issues(db: Any, payload: Any) -> dict[str, Any]:
|
|
|
216
226
|
except PermissionError:
|
|
217
227
|
pass # Let SQLite report the open failure used by the host's state fallback.
|
|
218
228
|
if payload["action"] == "inspect":
|
|
219
|
-
database_uri = f"file:{quote(str(path), safe='')}?mode=ro"
|
|
220
229
|
try:
|
|
221
|
-
connection = sqlite3.connect(
|
|
230
|
+
connection = sqlite3.connect(readonly_sqlite_uri(path), uri=True, timeout=5)
|
|
222
231
|
except sqlite3.OperationalError as exc:
|
|
223
232
|
if str(exc) == "unable to open database file":
|
|
224
233
|
exc._codex_security_state_unavailable = True
|
|
@@ -367,6 +376,7 @@ def write_csv_export(
|
|
|
367
376
|
scan: sqlite3.Row,
|
|
368
377
|
findings_document: dict[str, Any],
|
|
369
378
|
) -> Path:
|
|
379
|
+
"""Write indexed findings to exports/findings.csv, adding candidate IDs for Deep Scans, and return its path."""
|
|
370
380
|
scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
|
|
371
381
|
output = io.StringIO(newline="")
|
|
372
382
|
writer = csv.writer(output)
|
|
@@ -412,7 +422,7 @@ def write_csv_export(
|
|
|
412
422
|
|
|
413
423
|
def finding_export_rows(connection: sqlite3.Connection, scan_id: str) -> sqlite3.Cursor:
|
|
414
424
|
return connection.execute(
|
|
415
|
-
"""
|
|
425
|
+
f"""
|
|
416
426
|
SELECT
|
|
417
427
|
occurrences.id AS occurrence_id,
|
|
418
428
|
occurrences.finding_id,
|
|
@@ -430,15 +440,8 @@ def finding_export_rows(connection: sqlite3.Connection, scan_id: str) -> sqlite3
|
|
|
430
440
|
FROM finding_occurrences AS occurrences
|
|
431
441
|
LEFT JOIN finding_triage AS triage ON triage.occurrence_id = occurrences.id
|
|
432
442
|
LEFT JOIN finding_locations AS locations
|
|
433
|
-
ON locations.
|
|
434
|
-
|
|
435
|
-
SELECT primary_location.sort_order
|
|
436
|
-
FROM finding_locations AS primary_location
|
|
437
|
-
WHERE primary_location.occurrence_id = occurrences.id
|
|
438
|
-
ORDER BY
|
|
439
|
-
CASE WHEN primary_location.role = 'root_control' THEN 0 ELSE 1 END,
|
|
440
|
-
primary_location.sort_order
|
|
441
|
-
LIMIT 1
|
|
443
|
+
ON locations.id = (
|
|
444
|
+
SELECT id {PRIMARY_FINDING_LOCATION_SQL}
|
|
442
445
|
)
|
|
443
446
|
WHERE occurrences.scan_id = ?
|
|
444
447
|
ORDER BY occurrences.created_at, occurrences.id
|
|
@@ -11,7 +11,7 @@ import re
|
|
|
11
11
|
import sqlite3
|
|
12
12
|
import sys
|
|
13
13
|
from collections.abc import Callable
|
|
14
|
-
from contextlib import ExitStack, suppress
|
|
14
|
+
from contextlib import AbstractContextManager, ExitStack, suppress
|
|
15
15
|
from datetime import datetime, timedelta, timezone
|
|
16
16
|
from pathlib import Path
|
|
17
17
|
from typing import Any, BinaryIO
|
|
@@ -30,7 +30,11 @@ from finalize_scan_contract import (
|
|
|
30
30
|
stage_scan_local_bytes,
|
|
31
31
|
)
|
|
32
32
|
from posix_scan_local_files import managed_fd
|
|
33
|
-
from workbench_constants import
|
|
33
|
+
from workbench_constants import (
|
|
34
|
+
CLAIM_LEASE_SECONDS,
|
|
35
|
+
DELIVERED_ACTION_LEASE_SECONDS,
|
|
36
|
+
PATCH_PREVIEW_BYTES,
|
|
37
|
+
)
|
|
34
38
|
from workbench_target import git_command, git_output
|
|
35
39
|
from workbench_validation import optional_text, require_occurrence, require_uuid
|
|
36
40
|
|
|
@@ -46,7 +50,144 @@ COMMANDS = {
|
|
|
46
50
|
SCAN_STATUS_ERROR = "Remediation is available only for successfully completed scans."
|
|
47
51
|
|
|
48
52
|
|
|
53
|
+
def patch_artifact_preview(
|
|
54
|
+
scan_dir: Path,
|
|
55
|
+
relative_path: str | None,
|
|
56
|
+
expected_digest: str | None,
|
|
57
|
+
open_scan_file: Callable[[Path, str], AbstractContextManager[BinaryIO]],
|
|
58
|
+
) -> tuple[str | None, dict[str, int | bool] | None]:
|
|
59
|
+
if relative_path is None or expected_digest is None:
|
|
60
|
+
return None, None
|
|
61
|
+
digest = hashlib.sha256()
|
|
62
|
+
preview = bytearray()
|
|
63
|
+
additions = 0
|
|
64
|
+
deletions = 0
|
|
65
|
+
file_count = 0
|
|
66
|
+
old_headers = 0
|
|
67
|
+
new_headers = 0
|
|
68
|
+
at_line_start = True
|
|
69
|
+
try:
|
|
70
|
+
with open_scan_file(scan_dir, relative_path) as patch:
|
|
71
|
+
while chunk := patch.readline(1024 * 1024):
|
|
72
|
+
digest.update(chunk)
|
|
73
|
+
if len(preview) <= PATCH_PREVIEW_BYTES:
|
|
74
|
+
preview.extend(chunk[: PATCH_PREVIEW_BYTES + 1 - len(preview)])
|
|
75
|
+
if at_line_start:
|
|
76
|
+
if chunk.startswith(b"diff --git "):
|
|
77
|
+
file_count += 1
|
|
78
|
+
elif chunk.startswith(b"+++ "):
|
|
79
|
+
new_headers += 1
|
|
80
|
+
elif chunk.startswith(b"--- "):
|
|
81
|
+
old_headers += 1
|
|
82
|
+
elif chunk.startswith(b"+"):
|
|
83
|
+
additions += 1
|
|
84
|
+
elif chunk.startswith(b"-"):
|
|
85
|
+
deletions += 1
|
|
86
|
+
at_line_start = chunk.endswith(b"\n")
|
|
87
|
+
except SystemExit:
|
|
88
|
+
return None, None
|
|
89
|
+
if f"sha256:{digest.hexdigest()}" != expected_digest:
|
|
90
|
+
return None, None
|
|
91
|
+
preview_truncated = len(preview) > PATCH_PREVIEW_BYTES
|
|
92
|
+
preview_text = preview[:PATCH_PREVIEW_BYTES].decode("utf-8", errors="replace")
|
|
93
|
+
if preview_truncated:
|
|
94
|
+
preview_text = f"{preview_text}\n... patch preview truncated ..."
|
|
95
|
+
return preview_text, {
|
|
96
|
+
"additions": additions,
|
|
97
|
+
"deletions": deletions,
|
|
98
|
+
"fileCount": file_count or min(old_headers, new_headers),
|
|
99
|
+
"previewTruncated": preview_truncated,
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
def reverse_reviewed_patch(
|
|
104
|
+
target: Path,
|
|
105
|
+
checkout: Path,
|
|
106
|
+
metadata: Path | None,
|
|
107
|
+
pinned_metadata: Path | None,
|
|
108
|
+
patch_digest: str,
|
|
109
|
+
pins: ExitStack,
|
|
110
|
+
patch: Path,
|
|
111
|
+
pathspec: str | None,
|
|
112
|
+
) -> tuple[Path | None, Path | None]:
|
|
113
|
+
"""Reverse reviewed bytes and select the Git references for subsequent content snapshots."""
|
|
114
|
+
|
|
115
|
+
arguments = ["--reverse", "--whitespace=nowarn"]
|
|
116
|
+
if pathspec is None:
|
|
117
|
+
arguments.append("--no-index")
|
|
118
|
+
elif pathspec != ".":
|
|
119
|
+
arguments.append(f"--directory={pathspec}")
|
|
120
|
+
arguments.append(str(patch))
|
|
121
|
+
|
|
122
|
+
def reverse(*, git_dir: Path | None, check: bool = False):
|
|
123
|
+
return git_command(
|
|
124
|
+
checkout,
|
|
125
|
+
"apply",
|
|
126
|
+
*(["--check"] if check else []),
|
|
127
|
+
*arguments,
|
|
128
|
+
text=False,
|
|
129
|
+
git_dir=git_dir,
|
|
130
|
+
work_tree=checkout if git_dir else None,
|
|
131
|
+
environment_overrides={"LC_ALL": "C", "LANGUAGE": "C"} if check else None,
|
|
132
|
+
)
|
|
133
|
+
|
|
134
|
+
applied = reverse(git_dir=metadata)
|
|
135
|
+
short = None
|
|
136
|
+
diagnostic = b"fatal: '$GIT_DIR' too big"
|
|
137
|
+
if (
|
|
138
|
+
os.name == "nt"
|
|
139
|
+
and metadata is not None
|
|
140
|
+
and applied.returncode == 128
|
|
141
|
+
and not applied.stdout
|
|
142
|
+
and b"GIT_DIR" in applied.stderr
|
|
143
|
+
):
|
|
144
|
+
# Confirm translated messages without applying the reverse patch twice.
|
|
145
|
+
failure = (
|
|
146
|
+
applied
|
|
147
|
+
if diagnostic in applied.stderr.splitlines()
|
|
148
|
+
else reverse(git_dir=metadata, check=True)
|
|
149
|
+
)
|
|
150
|
+
if (
|
|
151
|
+
failure.returncode == 128
|
|
152
|
+
and not failure.stdout
|
|
153
|
+
and diagnostic in failure.stderr.splitlines()
|
|
154
|
+
):
|
|
155
|
+
short = prepare_replay_gitfile(checkout, pinned_metadata, patch_digest, pins)
|
|
156
|
+
applied = reverse(git_dir=short)
|
|
157
|
+
if applied.returncode != 0:
|
|
158
|
+
raise SystemExit(
|
|
159
|
+
"The selected checkout does not contain the reviewed remediation patch. Apply exactly that patch before recording it as applied."
|
|
160
|
+
)
|
|
161
|
+
replay_root = None
|
|
162
|
+
if pathspec is None and short is not None:
|
|
163
|
+
selected_root = git_output(target, "rev-parse", "--show-toplevel")
|
|
164
|
+
if selected_root and Path(selected_root).samefile(target):
|
|
165
|
+
replay_root = short
|
|
166
|
+
return short, replay_root
|
|
167
|
+
|
|
168
|
+
|
|
169
|
+
def prepare_replay_gitfile(
|
|
170
|
+
checkout: Path, pinned_metadata: Path | None, patch_digest: str, pins: ExitStack
|
|
171
|
+
) -> Path:
|
|
172
|
+
"""Retain the verified patch and short metadata reference through the final snapshot."""
|
|
173
|
+
if pinned_metadata is None:
|
|
174
|
+
raise SystemExit(
|
|
175
|
+
"Could not bind the selected Windows Git directory and private patch replay directory."
|
|
176
|
+
)
|
|
177
|
+
from windows_scan_local_files import open_read_fd, pinned_replay_gitfile
|
|
178
|
+
|
|
179
|
+
try:
|
|
180
|
+
short = pins.enter_context(pinned_replay_gitfile(checkout, pinned_metadata))
|
|
181
|
+
fd = open_read_fd(checkout.parent, "reviewed.patch", "reviewed remediation patch")
|
|
182
|
+
patch = pins.enter_context(os.fdopen(fd, "rb"))
|
|
183
|
+
matching_patch_metadata(patch, patch_digest)
|
|
184
|
+
except (OSError, ValueError) as exc:
|
|
185
|
+
raise SystemExit(f"Could not verify the reviewed patch replay: {exc}") from exc
|
|
186
|
+
return short
|
|
187
|
+
|
|
188
|
+
|
|
49
189
|
def require_available(connection: sqlite3.Connection, args: Any, require_scan: Any) -> None:
|
|
190
|
+
"""Require a successfully completed scan for commands that act on a remediation request."""
|
|
50
191
|
if args.command not in COMMANDS:
|
|
51
192
|
return
|
|
52
193
|
occurrence = require_occurrence(connection, args.occurrence_id)
|
|
@@ -57,6 +198,7 @@ def require_available(connection: sqlite3.Connection, args: Any, require_scan: A
|
|
|
57
198
|
def require_request(
|
|
58
199
|
connection: sqlite3.Connection, request_id: str, occurrence: sqlite3.Row
|
|
59
200
|
) -> sqlite3.Row:
|
|
201
|
+
"""Return the request row or raise SystemExit if the request is missing or belongs to a different occurrence."""
|
|
60
202
|
current = connection.execute(
|
|
61
203
|
"SELECT * FROM finding_remediation_attempts WHERE request_id = ?",
|
|
62
204
|
(request_id,),
|
|
@@ -67,6 +209,7 @@ def require_request(
|
|
|
67
209
|
|
|
68
210
|
|
|
69
211
|
def latest_attempt(connection: sqlite3.Connection, occurrence_id: str) -> sqlite3.Row | None:
|
|
212
|
+
"""Return the newest remediation attempt for the occurrence, breaking timestamp ties by insertion order."""
|
|
70
213
|
return connection.execute(
|
|
71
214
|
"""
|
|
72
215
|
SELECT * FROM finding_remediation_attempts
|
|
@@ -344,6 +487,12 @@ def patch_metadata(
|
|
|
344
487
|
patch: bytes | None,
|
|
345
488
|
resolve_path: Callable[[str], str],
|
|
346
489
|
) -> tuple[str | None, str | None]:
|
|
490
|
+
"""Resolve a remediation attempt’s patch path and SHA-256 digest.
|
|
491
|
+
|
|
492
|
+
For newly generated bytes, compute the digest and use the existing or
|
|
493
|
+
request-specific path. For a referenced patch, validate the supplied path
|
|
494
|
+
and digest. Raise SystemExit if either conflicts with a previously reviewed value.
|
|
495
|
+
"""
|
|
347
496
|
path = args.patch_path
|
|
348
497
|
digest = args.patch_digest
|
|
349
498
|
if patch is not None:
|
|
@@ -371,6 +520,7 @@ def patch_metadata(
|
|
|
371
520
|
def same_file_version(
|
|
372
521
|
original: tuple[os.stat_result, int], current: tuple[os.stat_result, int]
|
|
373
522
|
) -> bool:
|
|
523
|
+
"""Compare file identity, size, modification time, and the platform-specific change-time token."""
|
|
374
524
|
before, before_change = original
|
|
375
525
|
after, after_change = current
|
|
376
526
|
return (
|
|
@@ -382,6 +532,7 @@ def same_file_version(
|
|
|
382
532
|
|
|
383
533
|
|
|
384
534
|
def file_digest_and_version(source: BinaryIO, label: str) -> tuple[str, tuple[os.stat_result, int]]:
|
|
535
|
+
"""Hash the remaining stream bytes and return their digest and file version, raising SystemExit if the file changes."""
|
|
385
536
|
before = scan_local_file_version(source.fileno())
|
|
386
537
|
digest = hashlib.sha256()
|
|
387
538
|
for chunk in iter(lambda: source.read(1024 * 1024), b""):
|
|
@@ -393,6 +544,7 @@ def file_digest_and_version(source: BinaryIO, label: str) -> tuple[str, tuple[os
|
|
|
393
544
|
|
|
394
545
|
|
|
395
546
|
def matching_patch_metadata(source: BinaryIO, expected_digest: str) -> tuple[os.stat_result, int]:
|
|
547
|
+
"""Return the stable patch version or raise SystemExit if its bytes differ from expected_digest."""
|
|
396
548
|
digest, version = file_digest_and_version(source, "scan-local patch")
|
|
397
549
|
if digest != expected_digest:
|
|
398
550
|
raise SystemExit("Patch digest does not match the scan-local patch file.")
|
|
@@ -402,6 +554,7 @@ def matching_patch_metadata(source: BinaryIO, expected_digest: str) -> tuple[os.
|
|
|
402
554
|
def patch_manifest_version(
|
|
403
555
|
db: Any, scan: sqlite3.Row, scan_dir: Path
|
|
404
556
|
) -> tuple[str, tuple[os.stat_result, int]]:
|
|
557
|
+
"""Verify the sealed scan manifest and return its byte digest and file version, including for legacy scans."""
|
|
405
558
|
manifest_path = db.ARTIFACTS["manifest"]
|
|
406
559
|
expected = scan["seal_manifest_digest"]
|
|
407
560
|
if expected is None:
|