@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
|
@@ -26,6 +26,20 @@ from workbench_scan_usage import _timestamp as usage_timestamp
|
|
|
26
26
|
reject_non_finite_json = finalizer._reject_non_finite_json
|
|
27
27
|
|
|
28
28
|
|
|
29
|
+
def read_json_object(path: Path) -> dict[str, Any]:
|
|
30
|
+
"""Read a UTF-8 JSON object from path, raising SystemExit on read errors, malformed JSON, or another top-level type."""
|
|
31
|
+
try:
|
|
32
|
+
payload = json.loads(
|
|
33
|
+
path.read_text(encoding="utf-8"),
|
|
34
|
+
parse_constant=reject_non_finite_json,
|
|
35
|
+
)
|
|
36
|
+
except (OSError, ValueError) as exc:
|
|
37
|
+
raise SystemExit(f"{path.name}: invalid JSON: {exc}") from exc
|
|
38
|
+
if not isinstance(payload, dict):
|
|
39
|
+
raise SystemExit(f"{path.name}: expected a JSON object.")
|
|
40
|
+
return payload
|
|
41
|
+
|
|
42
|
+
|
|
29
43
|
def javascript_utf8(value: str) -> bytes:
|
|
30
44
|
"""Match Node's UTF-8 encoding of UTF-16 strings without changing stored text."""
|
|
31
45
|
return (
|
|
@@ -40,6 +54,7 @@ def timestamp_key(value: str) -> datetime:
|
|
|
40
54
|
|
|
41
55
|
|
|
42
56
|
def require_uuid(value: str, label: str) -> str:
|
|
57
|
+
"""Return the standard hyphenated UUID text or raise SystemExit using label to identify the invalid argument."""
|
|
43
58
|
try:
|
|
44
59
|
return str(uuid.UUID(value))
|
|
45
60
|
except ValueError as exc:
|
|
@@ -54,6 +69,7 @@ path_within_scope = finalizer.path_within_scope
|
|
|
54
69
|
|
|
55
70
|
|
|
56
71
|
def require_close_note(close_reason: str | None, note: str | None) -> None:
|
|
72
|
+
"""Require a note when closing a finding as a false positive or when declining a fix."""
|
|
57
73
|
if note is None and close_reason == "false_positive":
|
|
58
74
|
raise SystemExit("Explain why this finding is a false positive.")
|
|
59
75
|
if note is None and close_reason == "wont_fix":
|
|
@@ -92,7 +108,7 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
92
108
|
thread_count = usage.get("threadCount")
|
|
93
109
|
if (
|
|
94
110
|
coverage not in ("complete", "partial", "unavailable")
|
|
95
|
-
or usage.get("source")
|
|
111
|
+
or usage.get("source") not in ("codex_rollout", "codex_runtime")
|
|
96
112
|
or type(thread_count) is not int
|
|
97
113
|
or thread_count < 0
|
|
98
114
|
):
|
|
@@ -134,6 +150,7 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
134
150
|
|
|
135
151
|
allowed_keys = {
|
|
136
152
|
"coverage",
|
|
153
|
+
"coverageScope",
|
|
137
154
|
"source",
|
|
138
155
|
"threadCount",
|
|
139
156
|
"missingThreadCount",
|
|
@@ -144,19 +161,32 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
144
161
|
"observedAt",
|
|
145
162
|
"tokensUpdatedAt",
|
|
146
163
|
"accountRateLimits",
|
|
164
|
+
"cacheWriteInputTokensReported",
|
|
147
165
|
*SCAN_USAGE_TOKEN_KEYS,
|
|
148
166
|
}
|
|
149
167
|
if thread_count == 0 or not set(usage).issubset(allowed_keys):
|
|
150
168
|
return False
|
|
169
|
+
if "coverageScope" in usage:
|
|
170
|
+
scope = usage["coverageScope"]
|
|
171
|
+
if (
|
|
172
|
+
not isinstance(scope, list)
|
|
173
|
+
or any(not isinstance(identity, str) or not identity for identity in scope)
|
|
174
|
+
or len(set(scope)) != len(scope)
|
|
175
|
+
):
|
|
176
|
+
return False
|
|
151
177
|
if (
|
|
152
178
|
not all(type(usage.get(key)) is int and usage[key] >= 0 for key in SCAN_USAGE_TOKEN_KEYS)
|
|
153
179
|
or usage["cachedInputTokens"] + usage["cacheWriteInputTokens"] > usage["inputTokens"]
|
|
180
|
+
or "cacheWriteInputTokensReported" in usage
|
|
181
|
+
and type(usage["cacheWriteInputTokensReported"]) is not bool
|
|
154
182
|
):
|
|
155
183
|
return False
|
|
156
184
|
missing = usage.get("missingThreadCount", 0)
|
|
157
185
|
if type(missing) is not int or missing < 0:
|
|
158
186
|
return False
|
|
159
|
-
if coverage == "complete" and (
|
|
187
|
+
if coverage == "complete" and (
|
|
188
|
+
any(warning != "cost_estimate_covers_earlier_usage" for warning in warnings) or missing
|
|
189
|
+
):
|
|
160
190
|
return False
|
|
161
191
|
if coverage == "partial" and not (warnings or missing):
|
|
162
192
|
return False
|
|
@@ -177,8 +207,11 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
177
207
|
return False
|
|
178
208
|
if any(
|
|
179
209
|
not isinstance(role, dict)
|
|
180
|
-
or
|
|
210
|
+
or not keys.issubset(role)
|
|
211
|
+
or not set(role).issubset({*keys, "cacheWriteInputTokensReported"})
|
|
181
212
|
or any(type(role[key]) is not int or role[key] < 0 for key in keys)
|
|
213
|
+
or "cacheWriteInputTokensReported" in role
|
|
214
|
+
and type(role["cacheWriteInputTokensReported"]) is not bool
|
|
182
215
|
for role in roles.values()
|
|
183
216
|
):
|
|
184
217
|
return False
|
|
@@ -188,6 +221,11 @@ def _valid_measured_scan_usage(usage: object) -> bool:
|
|
|
188
221
|
|
|
189
222
|
|
|
190
223
|
def parse_scan_cost(value: str | None) -> str | None:
|
|
224
|
+
"""Return compact JSON for valid measured usage or a legacy cost estimate.
|
|
225
|
+
|
|
226
|
+
None means cost data was omitted. Invalid JSON, nonfinite numbers, or an
|
|
227
|
+
unsupported cost record raise SystemExit.
|
|
228
|
+
"""
|
|
191
229
|
if value is None:
|
|
192
230
|
return None
|
|
193
231
|
try:
|
|
@@ -210,11 +248,13 @@ def parse_scan_cost(value: str | None) -> str | None:
|
|
|
210
248
|
|
|
211
249
|
|
|
212
250
|
def bounded_output_text(value: Any, maximum_bytes: int) -> str:
|
|
251
|
+
"""Return the prefix of the stringified value that fits in maximum_bytes of UTF-8 without splitting a character."""
|
|
213
252
|
encoded = str(value).encode("utf-8")[:maximum_bytes]
|
|
214
253
|
return encoded.decode("utf-8", errors="ignore")
|
|
215
254
|
|
|
216
255
|
|
|
217
256
|
def require_occurrence(connection: sqlite3.Connection, occurrence_id: str) -> sqlite3.Row:
|
|
257
|
+
"""Return the finding occurrence row or raise SystemExit if its ID is missing or unknown."""
|
|
218
258
|
occurrence_id = optional_text(occurrence_id, maximum=256)
|
|
219
259
|
if occurrence_id is None:
|
|
220
260
|
raise SystemExit("occurrence-id is required.")
|
|
@@ -1,38 +1,41 @@
|
|
|
1
1
|
[
|
|
2
2
|
[
|
|
3
|
-
"WITH input AS (SELECT :history AS history)",
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
"
|
|
7
|
-
"
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
"
|
|
11
|
-
"
|
|
12
|
-
"
|
|
13
|
-
"
|
|
14
|
-
"
|
|
15
|
-
"
|
|
16
|
-
"
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
"
|
|
20
|
-
"
|
|
21
|
-
"
|
|
22
|
-
"
|
|
23
|
-
"
|
|
24
|
-
"
|
|
25
|
-
"
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
"
|
|
29
|
-
"
|
|
30
|
-
"
|
|
3
|
+
"WITH input AS (SELECT :history AS history),",
|
|
4
|
+
"previews AS (",
|
|
5
|
+
" SELECT version, CASE",
|
|
6
|
+
" -- Prefer the original timestamp when a reader reopened the 52/53 repository preview.",
|
|
7
|
+
" WHEN version IN (64, 67) AND name = 'persist repository identities'",
|
|
8
|
+
" AND EXISTS (SELECT 1 FROM schema_migrations WHERE version = 52 AND name = receipt.name)",
|
|
9
|
+
" THEN 'DELETE FROM schema_migrations'",
|
|
10
|
+
" WHEN version IN (65, 68) AND name = 'stabilize Linux repository generations'",
|
|
11
|
+
" AND EXISTS (SELECT 1 FROM schema_migrations WHERE version = 53 AND name = receipt.name)",
|
|
12
|
+
" THEN 'DELETE FROM schema_migrations'",
|
|
13
|
+
" WHEN version IN (50, 52, 53, 54, 61, 63, 64) AND name = 'persist repository identities'",
|
|
14
|
+
" THEN 'UPDATE schema_migrations SET version = 67'",
|
|
15
|
+
" WHEN version IN (51, 53, 54, 55, 62, 64, 65) AND name = 'stabilize Linux repository generations'",
|
|
16
|
+
" THEN 'UPDATE schema_migrations SET version = 68'",
|
|
17
|
+
" WHEN version IN (56, 63, 65, 66) AND name = 'distinguish unvalidated workspace targets'",
|
|
18
|
+
" THEN 'UPDATE schema_migrations SET version = 69'",
|
|
19
|
+
" WHEN version IN (64, 66, 67) AND name = 'retain checkout roots for Git discovery'",
|
|
20
|
+
" THEN 'UPDATE schema_migrations SET version = 70'",
|
|
21
|
+
" WHEN version IN (67, 68) AND name = 'retain rejected workspace checkout boundaries'",
|
|
22
|
+
" THEN 'UPDATE schema_migrations SET version = 71'",
|
|
23
|
+
" WHEN version IN (48, 50, 63) AND name = 'persist scan log completion boundaries'",
|
|
24
|
+
" THEN 'UPDATE schema_migrations SET version = 64'",
|
|
25
|
+
" WHEN version IN (58, 59) AND name = 'record classification rubric provenance'",
|
|
26
|
+
" THEN 'UPDATE schema_migrations SET version = 60'",
|
|
27
|
+
" WHEN version IN (47, 48, 50, 52, 53, 54) AND name = 'freeze stopped scan checkpoint selections'",
|
|
28
|
+
" THEN 'UPDATE schema_migrations SET version = 57'",
|
|
29
|
+
" WHEN version IN (34, 40, 41, 42, 43, 44, 48) AND name = 'persist authorized source excerpt scopes'",
|
|
30
|
+
" THEN 'UPDATE schema_migrations SET version = 50'",
|
|
31
|
+
" WHEN version = 63 AND name = 'retain native investigation time allowances'",
|
|
32
|
+
" THEN 'DELETE FROM schema_migrations'",
|
|
33
|
+
" END AS repair FROM schema_migrations AS receipt",
|
|
31
34
|
")",
|
|
32
|
-
"SELECT '
|
|
33
|
-
"
|
|
34
|
-
"
|
|
35
|
-
"
|
|
35
|
+
"SELECT 'sql' AS operation, repair || ' WHERE version = ' || version AS value",
|
|
36
|
+
"FROM previews WHERE repair IS NOT NULL",
|
|
37
|
+
"-- Vacate checkpoint preview 50 before moving a lower source-scope receipt into it.",
|
|
38
|
+
"ORDER BY version DESC;"
|
|
36
39
|
],
|
|
37
40
|
[
|
|
38
41
|
"-- mirror and early-moves: relocate numbers before checking profiles.",
|
|
@@ -54,9 +57,20 @@
|
|
|
54
57
|
"),",
|
|
55
58
|
"moves(position, version, destination, name) AS (",
|
|
56
59
|
" VALUES",
|
|
57
|
-
" (
|
|
58
|
-
" (1,
|
|
59
|
-
" (
|
|
60
|
+
" (-2, 48, 67, 'persist repository identities'),",
|
|
61
|
+
" (-1, 49, 68, 'stabilize Linux repository generations'),",
|
|
62
|
+
" (0, 44, 68, 'stabilize Linux repository generations'),",
|
|
63
|
+
" (1, 45, 68, 'stabilize Linux repository generations'),",
|
|
64
|
+
" (2, 30, 67, 'persist repository identities'),",
|
|
65
|
+
" (3, 31, 67, 'persist repository identities'),",
|
|
66
|
+
" (4, 33, 67, 'persist repository identities'),",
|
|
67
|
+
" (5, 40, 67, 'persist repository identities'),",
|
|
68
|
+
" (6, 42, 67, 'persist repository identities'),",
|
|
69
|
+
" (7, 43, 67, 'persist repository identities'),",
|
|
70
|
+
" (8, 44, 67, 'persist repository identities'),",
|
|
71
|
+
" (9, 33, 40, 'index finding identity and comparison history'),",
|
|
72
|
+
" (10, 25, 26, 'persist scan completion warnings'),",
|
|
73
|
+
" (11, 12, 20, 'phase-specific scan progress')",
|
|
60
74
|
")",
|
|
61
75
|
"SELECT 0 AS position, 'error' AS operation,",
|
|
62
76
|
" 'The Codex Security database has an unsupported mirror migration history.' AS value",
|
|
@@ -73,6 +87,34 @@
|
|
|
73
87
|
" FROM moves JOIN schema_migrations USING (version, name)",
|
|
74
88
|
"ORDER BY position;"
|
|
75
89
|
],
|
|
90
|
+
[
|
|
91
|
+
"WITH history AS (",
|
|
92
|
+
" SELECT json_extract(value, '$.version') AS version,",
|
|
93
|
+
" json_extract(value, '$.name') AS name FROM json_each(:history)",
|
|
94
|
+
")",
|
|
95
|
+
"SELECT 'error' AS operation,",
|
|
96
|
+
" 'The Codex Security database has an unsupported source-scope migration history.' AS value",
|
|
97
|
+
"FROM schema_migrations JOIN history USING (version)",
|
|
98
|
+
"WHERE version IN (43, 50) AND schema_migrations.name != history.name;"
|
|
99
|
+
],
|
|
100
|
+
[
|
|
101
|
+
"-- A released reader can add its columns while a repository preview still owns the version.",
|
|
102
|
+
"WITH released(version, table_name, column_name) AS (",
|
|
103
|
+
" VALUES (54, 'workspaces', 'deep_scan_config_json'),",
|
|
104
|
+
" (55, 'deep_scan_runs', 'pending_target_project_path'),",
|
|
105
|
+
" (58, 'deep_scan_runs', 'terminal_reviewed_surface_count'),",
|
|
106
|
+
" (59, 'deep_scan_runs', 'service_tier'),",
|
|
107
|
+
" (61, 'scans', 'launch_surface')",
|
|
108
|
+
")",
|
|
109
|
+
"SELECT 'timestamp' AS operation,",
|
|
110
|
+
" 'INSERT INTO schema_migrations (version, name, applied_at) VALUES (' ||",
|
|
111
|
+
" released.version || ', ' || quote(json_extract(history.value, '$.name')) || ', ?)' AS value",
|
|
112
|
+
"FROM released JOIN json_each(:history) AS history",
|
|
113
|
+
" ON json_extract(history.value, '$.version') = released.version",
|
|
114
|
+
"WHERE EXISTS (SELECT 1 FROM schema_migrations WHERE name = 'persist repository identities')",
|
|
115
|
+
" AND NOT EXISTS (SELECT 1 FROM schema_migrations WHERE version = released.version)",
|
|
116
|
+
" AND EXISTS (SELECT 1 FROM pragma_table_info(released.table_name) WHERE name = released.column_name);"
|
|
117
|
+
],
|
|
76
118
|
[
|
|
77
119
|
"-- A main-branch reader may have added discovery context under the old checkpoint number.",
|
|
78
120
|
"SELECT 'timestamp' AS operation,",
|
|
@@ -488,5 +488,105 @@
|
|
|
488
488
|
"statements": [
|
|
489
489
|
"ALTER TABLE scan_severity_classifications ADD COLUMN rubric_binding_json TEXT;"
|
|
490
490
|
]
|
|
491
|
+
},
|
|
492
|
+
{
|
|
493
|
+
"version": 61,
|
|
494
|
+
"name": "record scan launch attribution",
|
|
495
|
+
"statements": [
|
|
496
|
+
"ALTER TABLE scans ADD COLUMN launch_surface TEXT;",
|
|
497
|
+
"ALTER TABLE scans ADD COLUMN launch_package_version TEXT;",
|
|
498
|
+
"ALTER TABLE scans ADD COLUMN launch_plugin_version TEXT;",
|
|
499
|
+
"ALTER TABLE scans ADD COLUMN launch_kind TEXT CHECK (launch_kind IN ('scan', 'mock', 'import'));"
|
|
500
|
+
]
|
|
501
|
+
},
|
|
502
|
+
{
|
|
503
|
+
"version": 62,
|
|
504
|
+
"name": "project scan lifecycle snapshots",
|
|
505
|
+
"statements": [
|
|
506
|
+
"CREATE TRIGGER classify_legacy_scan_recipe\nAFTER UPDATE OF recipe_json ON scans\nWHEN OLD.recipe_json IS NULL AND (NEW.launch_kind IS NULL OR NEW.launch_plugin_version IS NULL)\n AND json_valid(NEW.recipe_json)\nBEGIN\n UPDATE scans SET\n launch_kind = COALESCE(launch_kind, CASE\n WHEN json_type(recipe_json, '$.import') = 'object' THEN 'import'\n WHEN json_type(recipe_json, '$.mock') = 'true' THEN 'mock' END),\n launch_plugin_version = COALESCE(launch_plugin_version, CASE\n WHEN json_type(recipe_json, '$.pluginVersion') = 'text'\n AND trim(json_extract(recipe_json, '$.pluginVersion'), char(9, 10, 11, 12, 13, 32)) <> ''\n THEN json_extract(recipe_json, '$.pluginVersion') END)\n WHERE id = NEW.id;\nEND;",
|
|
507
|
+
"UPDATE scans\nSET launch_kind = CASE WHEN json_type(recipe_json, '$.import') = 'object' THEN 'import' ELSE 'mock' END\nWHERE launch_kind IS NULL AND CASE WHEN json_valid(recipe_json) THEN\n json_type(recipe_json, '$.import') = 'object' OR json_type(recipe_json, '$.mock') = 'true'\nEND;",
|
|
508
|
+
"UPDATE scans SET launch_plugin_version = json_extract(recipe_json, '$.pluginVersion')\nWHERE launch_plugin_version IS NULL AND CASE WHEN json_valid(recipe_json) THEN\n json_type(recipe_json, '$.pluginVersion') = 'text'\n AND trim(json_extract(recipe_json, '$.pluginVersion'), char(9, 10, 11, 12, 13, 32)) <> ''\nEND;",
|
|
509
|
+
"CREATE VIEW scan_lifecycles AS\nSELECT scans.id AS scan_id, json_object(\n 'scanId', scans.id,\n 'mode', CASE WHEN launch_kind = 'import' THEN 'import' ELSE scans.mode END,\n 'startedAt', scans.started_at,\n 'status', CASE WHEN canceled_at IS NOT NULL THEN 'canceled'\n WHEN scans.status = 'complete' THEN 'completed' ELSE scans.status END,\n 'finishedAt', COALESCE(canceled_at, completed_at),\n 'hasReportableFindings', json(CASE\n WHEN scans.status = 'complete' AND canceled_at IS NULL\n THEN (SELECT CASE WHEN reportable_findings_count > 0 THEN 'true' ELSE 'false' END\n FROM scan_progress WHERE scan_id = scans.id) END),\n 'surface', launch_surface,\n 'packageVersion', launch_package_version,\n 'pluginVersion', launch_plugin_version,\n 'mock', json(CASE WHEN launch_kind = 'mock' THEN 'true'\n WHEN launch_kind IS NOT NULL THEN 'false' END)\n) AS snapshot\nFROM scans;"
|
|
510
|
+
]
|
|
511
|
+
},
|
|
512
|
+
{
|
|
513
|
+
"version": 63,
|
|
514
|
+
"name": "retain unverified Deep Scan worker attempts",
|
|
515
|
+
"statements": [
|
|
516
|
+
"ALTER TABLE deep_scan_runs ADD COLUMN worker_usage_gap INTEGER NOT NULL DEFAULT 0 CHECK (worker_usage_gap IN (0, 1));",
|
|
517
|
+
"UPDATE deep_scan_runs SET worker_usage_gap = 1\nWHERE scan_id IN (\n SELECT w.scan_id FROM deep_scan_workers AS w\n WHERE w.kind IN ('discovery', 'dedup') AND w.attempt > 1\n AND w.started_at IS NOT NULL AND w.sdk_thread_id IS NULL\n AND NOT EXISTS (SELECT 1 FROM deep_scan_worker_threads AS t\n WHERE t.scan_id = w.scan_id AND t.worker_id = w.id)\n);",
|
|
518
|
+
"CREATE TRIGGER retain_unverified_deep_scan_worker_attempt\nAFTER UPDATE OF attempt ON deep_scan_workers\nWHEN NEW.attempt > OLD.attempt AND OLD.started_at IS NOT NULL\n AND OLD.sdk_thread_id IS NULL AND OLD.kind IN ('discovery', 'dedup')\nBEGIN\n UPDATE deep_scan_runs SET worker_usage_gap = 1 WHERE scan_id = OLD.scan_id;\nEND;"
|
|
519
|
+
]
|
|
520
|
+
},
|
|
521
|
+
{
|
|
522
|
+
"version": 64,
|
|
523
|
+
"name": "persist scan log completion boundaries",
|
|
524
|
+
"statements": ["ALTER TABLE scans ADD COLUMN log_completed_at TEXT;"]
|
|
525
|
+
},
|
|
526
|
+
{
|
|
527
|
+
"version": 65,
|
|
528
|
+
"name": "bind Windows Deep Scan resume output directories",
|
|
529
|
+
"statements": [
|
|
530
|
+
"ALTER TABLE scans ADD COLUMN windows_resume_output_identity TEXT;"
|
|
531
|
+
]
|
|
532
|
+
},
|
|
533
|
+
{
|
|
534
|
+
"version": 66,
|
|
535
|
+
"name": "bind Windows Deep Scan resume checkouts",
|
|
536
|
+
"statements": [
|
|
537
|
+
"ALTER TABLE scans ADD COLUMN windows_resume_target_identity TEXT;"
|
|
538
|
+
]
|
|
539
|
+
},
|
|
540
|
+
{
|
|
541
|
+
"version": 67,
|
|
542
|
+
"name": "persist repository identities",
|
|
543
|
+
"statements": [
|
|
544
|
+
"ALTER TABLE security_targets\n ADD COLUMN repository_identity TEXT;",
|
|
545
|
+
"CREATE INDEX security_targets_by_repository_identity\n ON security_targets(repository_identity);",
|
|
546
|
+
"ALTER TABLE scans\n ADD COLUMN repository_generation TEXT;",
|
|
547
|
+
"CREATE INDEX scans_by_repository_generation\n ON scans(repository_generation);",
|
|
548
|
+
"CREATE INDEX scans_by_target_path\n ON scans(target_path);",
|
|
549
|
+
"ALTER TABLE scans\n ADD COLUMN completion_sequence INTEGER CHECK (completion_sequence >= 1);",
|
|
550
|
+
"CREATE UNIQUE INDEX scans_completion_sequence\n ON scans(completion_sequence);",
|
|
551
|
+
"CREATE TRIGGER scans_assign_inserted_completion_sequence\n AFTER INSERT ON scans\n WHEN NEW.status = 'complete' AND NEW.completion_sequence IS NULL\n BEGIN\n UPDATE scans\n SET completion_sequence = (\n SELECT COALESCE(MAX(completion_sequence), 0) + 1 FROM scans\n )\n WHERE id = NEW.id AND completion_sequence IS NULL;\n END;",
|
|
552
|
+
"CREATE TRIGGER scans_assign_updated_completion_sequence\n AFTER UPDATE OF status ON scans\n WHEN NEW.status = 'complete' AND NEW.completion_sequence IS NULL\n BEGIN\n UPDATE scans\n SET completion_sequence = (\n SELECT COALESCE(MAX(completion_sequence), 0) + 1 FROM scans\n )\n WHERE id = NEW.id AND completion_sequence IS NULL;\n END;"
|
|
553
|
+
]
|
|
554
|
+
},
|
|
555
|
+
{
|
|
556
|
+
"version": 68,
|
|
557
|
+
"name": "stabilize Linux repository generations",
|
|
558
|
+
"statements": []
|
|
559
|
+
},
|
|
560
|
+
{
|
|
561
|
+
"version": 69,
|
|
562
|
+
"name": "distinguish unvalidated workspace targets",
|
|
563
|
+
"statements": [
|
|
564
|
+
"ALTER TABLE workspaces\n ADD COLUMN target_path_unvalidated INTEGER NOT NULL DEFAULT 0\n CHECK (target_path_unvalidated IN (0, 1));"
|
|
565
|
+
]
|
|
566
|
+
},
|
|
567
|
+
{
|
|
568
|
+
"version": 70,
|
|
569
|
+
"name": "retain checkout roots for Git discovery",
|
|
570
|
+
"statements": [
|
|
571
|
+
"ALTER TABLE security_targets ADD COLUMN git_checkout_root TEXT;"
|
|
572
|
+
]
|
|
573
|
+
},
|
|
574
|
+
{
|
|
575
|
+
"version": 71,
|
|
576
|
+
"name": "retain rejected workspace checkout boundaries",
|
|
577
|
+
"statements": [
|
|
578
|
+
"ALTER TABLE workspaces ADD COLUMN rejected_checkout_roots_json TEXT;"
|
|
579
|
+
]
|
|
580
|
+
},
|
|
581
|
+
{
|
|
582
|
+
"version": 72,
|
|
583
|
+
"name": "retain external finding import selections and provenance",
|
|
584
|
+
"statements": [
|
|
585
|
+
"CREATE TABLE external_finding_imports (\n id TEXT PRIMARY KEY,\n repository TEXT NOT NULL,\n created_at TEXT NOT NULL,\n provider TEXT NOT NULL,\n source_key TEXT NOT NULL,\n provenance_json TEXT,\n selection_json TEXT NOT NULL\n);",
|
|
586
|
+
"CREATE INDEX external_finding_imports_by_repository ON external_finding_imports (repository, created_at);",
|
|
587
|
+
"CREATE TABLE external_finding_import_members (\n import_id TEXT NOT NULL REFERENCES external_finding_imports(id),\n position INTEGER NOT NULL,\n finding_id TEXT NOT NULL REFERENCES external_source_reports(id),\n version INTEGER NOT NULL,\n PRIMARY KEY (import_id, position)\n) WITHOUT ROWID;",
|
|
588
|
+
"CREATE INDEX external_finding_members_by_version\nON external_finding_import_members (finding_id, version);",
|
|
589
|
+
"CREATE TABLE external_finding_publications (\n finding_id TEXT NOT NULL REFERENCES external_source_reports(id),\n version INTEGER NOT NULL,\n cloud_api_url TEXT NOT NULL,\n account_id TEXT NOT NULL,\n destination_id TEXT NOT NULL,\n receipt_id TEXT NOT NULL,\n outcome TEXT NOT NULL,\n cloud_finding_id TEXT,\n created_at TEXT NOT NULL,\n PRIMARY KEY (finding_id, version, cloud_api_url, account_id, destination_id, receipt_id)\n) WITHOUT ROWID;"
|
|
590
|
+
]
|
|
491
591
|
}
|
|
492
592
|
]
|
|
@@ -20,11 +20,11 @@ Call `defense_factory_bootstrap` before data reads. Reuse its result within the
|
|
|
20
20
|
|
|
21
21
|
Use `defense_factory_github_search`, `defense_factory_github_repositories`, or `defense_factory_github_get` to resolve repositories on the connectors returned by bootstrap. Preserve returned repository and connector IDs, including GitHub Enterprise identities. `defense_factory_workflow_repositories` can locate repositories with recorded runs. A local checkout name alone does not identify a Cloud repository. Ask the user to choose when account or repository context is ambiguous; in noninteractive use, stop with the ambiguity and required selection. An explicit request for all accessible repositories may use that broader scope.
|
|
22
22
|
|
|
23
|
-
For a finding link, accept the selected Cloud `webOrigin` with the path `/codex/cloud/security/findings/<finding-id>` or the legacy `/codex/security/findings/<finding-id>`. Decode the final path segment once and resolve it through `defense_factory_findings_get`.
|
|
23
|
+
For a finding link, accept the selected Cloud `webOrigin` with the path `/codex/cloud/security/findings/<finding-id>` or the legacy `/codex/security/findings/<finding-id>`. Decode the final path segment once and resolve it through `defense_factory_findings_get`. Pass complete finding IDs returned by Cloud unchanged, including any source prefix. A commit-finding link under either accepted path may use a bare finding ID; pass that as `commit:<finding-id>`. Do not substitute a grouped issue, scan, or PR ID. For an unsupported origin or path, explain which finding link or ID is needed instead of guessing another record. Use returned Cloud links when available. Every direct detail or evidence read must go through its tool, even for an ID that was previously listed.
|
|
24
24
|
|
|
25
25
|
## List and inspect findings
|
|
26
26
|
|
|
27
|
-
When the findings list or detail tool offers `api_version`, select `v2` for requests that include imported scanner findings. The default `v1` view covers native findings. For an imported-only list, also set `source` to `imported` if exposed. Use
|
|
27
|
+
When the findings list or detail tool offers `api_version`, select `v2` for requests that include imported scanner findings. The default `v1` view covers native findings. For an imported-only list, also set `source` to `imported` if exposed. Use `provider` to filter scanner occurrences. To list grouped issues with published evidence from a scanner, use `defense_factory_canonical_findings_list` with `published_evidence_provider`. Scope grouped issues to a repository with its stable ID in `repo_id`. Use the provider values advertised by each tool. If the scanner has no filter value, list imported findings within the requested repository and inspect the returned provider and scanner origin where available. For example, OpenGrep uses the Semgrep provider and identifies itself in `details.scanner_origin`. Follow every page for a complete answer. If the evidence available to the caller cannot identify the scanner, report that limit.
|
|
28
28
|
|
|
29
29
|
Use `defense_factory_findings_list` with the discovered repository URL in `repo` and the user's filters; `repo` accepts comma-separated URLs, not repository IDs. Workflow tools use the returned repository ID in `repo_id`. Filters may include severity (`criticality`), lifecycle `status`, `source`, `q`, `path_prefix`, `start_at`, `end_at`, `scan_id`, `review_run_id`, `validated`, `has_patch`, `author`, and `assignee`; use the tool's current schema for available filters and their accepted values. `assignee` accepts comma-separated recorded user emails and is separate from commit authorship. Do not invent an assigned-team filter.
|
|
30
30
|
|
|
@@ -39,7 +39,7 @@ Keep these records separate in the answer:
|
|
|
39
39
|
- **Periodic fix check:** its recorded time, commit, result, and report.
|
|
40
40
|
- **Lifecycle status:** the finding's recorded state; it does not prove that a patch was checked or that a periodic fix check passed.
|
|
41
41
|
|
|
42
|
-
|
|
42
|
+
The fields available for repository-scan, PR-review, and imported findings can differ from those for commit findings. Preserve their source evidence and report absent or unknown values as unavailable or unknown, rather than success, failure, or unassigned.
|
|
43
43
|
|
|
44
44
|
## Read evidence
|
|
45
45
|
|
|
@@ -51,6 +51,6 @@ An artifact reference or download link alone is not report content. Unsupported
|
|
|
51
51
|
|
|
52
52
|
## Read scan status
|
|
53
53
|
|
|
54
|
-
Use `defense_factory_scan_history` for combined commit and repository scan history.
|
|
54
|
+
Use `defense_factory_scan_history` for combined commit and repository scan history. Use `repo_ids` for repository-scoped history. To include the caller’s private imports in combined history, set `include_private_imports: true` and omit `repo_ids` and `scan_type`. For private imports alone, set `scan_type: private_import` and omit `repo_ids`. Follow the returned cursor for more history. For repository runs, use `defense_factory_workflow_list` with its `repo_id` and `status` filters, then `defense_factory_workflow_get` for progress and failure details. When history provides a monitoring configuration ID and scan ID, use `defense_factory_monitoring_scan_get` with that configuration as `parameters.path.id` and the scan as `parameters.path.scan_id`.
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
For the current processing phase, request `view: progress` on the workflow or monitoring scan detail tool. Commit scans record status, timestamps, and success. Report when detailed failure information is unavailable. A failed, canceled, or unfinished scan with zero findings is not a clean scan. Include the source, relevant IDs, scope read, and recorded status in the answer.
|
|
@@ -1,57 +1,14 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: deep-security-scan
|
|
3
|
-
description:
|
|
3
|
+
description: Run repeated Standard security scans of a repository or scoped path when the user requests a deep, exhaustive, or multi-pass audit. For changes to a PR, commit, branch or working tree, use security-diff-scan.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Deep Security Scan
|
|
7
7
|
|
|
8
|
-
The
|
|
8
|
+
The host runs Standard audits and merges their findings. Workers in the same scan can exchange investigation leads and verify each other’s evidence. Later passes receive the titles and locations already reported. The host stops when consecutive audits add nothing new or the configured scan or time limit is reached. Its final report includes every accepted audit.
|
|
9
9
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
For a
|
|
13
|
-
|
|
14
|
-
For
|
|
15
|
-
|
|
16
|
-
Read `../../references/scan-prologue.md` for source-access, context-update, cancellation, and recovery rules. Deep has no parent capability preflight: the coordinator validates ownership, target, scope, and sandbox, and manages workers independently of this thread's delegation capacity.
|
|
17
|
-
|
|
18
|
-
## Concurrent Desktop Scans
|
|
19
|
-
|
|
20
|
-
For a newly launched native scan with authoritative context, inspect `otherRunningDeepScans` once before discovery. If another Deep scan is running, show its target, phase in plain language, and human-friendly start time. Explain the additional CPU, memory, and token use without exposing scan IDs or raw timestamps.
|
|
21
|
-
|
|
22
|
-
Ask whether to continue, with **Cancel (Recommended)** and **Continue**. Use native `request_user_input`, then `request_codex_security_user_input` or plain chat if unavailable. Wait for an explicit choice; a declined or cancelled input dialog is not a scan cancellation. If the user cancels, cancel only the new scan. Do not repeat this guard after it passes or after preflight.
|
|
23
|
-
|
|
24
|
-
## Start or Rejoin the Coordinator
|
|
25
|
-
|
|
26
|
-
Immediately before the first coordinator call, follow `../../references/access-advisory.md`. Known Bedrock and API-key-only sessions skip the advisory; it never gates scanning.
|
|
27
|
-
|
|
28
|
-
```text
|
|
29
|
-
Existing scan: start_codex_security_deep_scan({ scanId, handoffClaimToken? })
|
|
30
|
-
New scan: start_codex_security_deep_scan({ targetPath, scope: ".", userContext?, projectConfigPath? })
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
Before a new target-based scan, call `inspect_codex_security_setup({ targetPath, scope: ".", mode: "deep", projectConfigPath? })`. Show the worker count, subagents per worker, convergence threshold, review cap, discovery time limit, and their sources from `setup.deepScanConfig`. Supply a project YAML or JSON path only when the user selects it. Pass that same path at launch. Native continuations use the saved `workspace.deepScanConfig`.
|
|
34
|
-
|
|
35
|
-
Pass the existing handoff token when required, including after a waiter detaches or the server restarts. Preserve exact user context as untrusted analysis data; workers remain offline. They use the immutable context captured at independent-scan start. Persist later user changes through the context-update tool, without restarting completed phases or changing active workers' snapshots.
|
|
36
|
-
|
|
37
|
-
Wait on the coordinator call or its running execution cell. It owns discovery progress, the configured time limit, worker cancellation at that limit, and aggregation. Leave the public phase at preflight before the call; do not publish competing progress while it runs.
|
|
38
|
-
|
|
39
|
-
After an ended turn or host timeout, rejoin with the same scan ID and token. If a CLI/headless call detached before returning its ID, repeat the identical target form. It can recover the completed report for the same checkout snapshot, context, and project-file selection after a server restart. Once the report is returned, a later target-based call can start a fresh scan. A terminal failure must not trigger a replacement scan.
|
|
40
|
-
|
|
41
|
-
## Handle the Result
|
|
42
|
-
|
|
43
|
-
- **SDK-registered scan.** The coordinator returns the aggregate's `scanId`, `scanDir`, `manifestPath`, and `instructions`. End the turn with the returned identity and manifest path. The SDK owns finalization and report generation after the turn ends.
|
|
44
|
-
- **Plugin-launched scan.** The coordinator also returns `completion`. Use the returned scan ID, sealed artifacts, and generated `report.md` in the authoritative directory.
|
|
45
|
-
- **Cancelled:** stop without completion. Report retained findings and pending work without claiming a successful scan or generating a replacement report.
|
|
46
|
-
- **Terminal failure:** surface the exact stable MCP error and read the existing scan context to report preserved results and remaining work. Do not continue analysis, complete or cancel an already terminal scan, or claim a no-findings result.
|
|
47
|
-
- **Missing or malformed canonical artifacts:** surface the blocker and preserve the existing scan. Do not fabricate a report.
|
|
48
|
-
|
|
49
|
-
## Report the Completed Parent Scan
|
|
50
|
-
|
|
51
|
-
When the coordinator returns `completion`, the host has sealed the artifacts and generated `report.md`. Read measured usage from `completion.scan.usage`. Do not call completion again, submit another semantic draft, rerun worker phases, or write the report yourself.
|
|
52
|
-
|
|
53
|
-
If completion fails, surface its exact error. Preserve the accepted aggregate and handoff claim. A later continuation can rejoin the same scan to retry finalization. On explicit cancellation, call `cancel_codex_security_scan` and do not accept subsequent scan progress as success.
|
|
54
|
-
|
|
55
|
-
Return the report and canonical artifact links after completion succeeds and `report.md` exists. Report usage according to `../../references/final-report.md`. Distinguish an empty finding set after completed review from a time limit reached before any source review finished.
|
|
56
|
-
|
|
57
|
-
Detailed write-ups and hardening proposals are optional requested outputs. Read `get_codex_security_completed_scan` only when the requested output needs the full sealed documents. Preserve repository source and scope, and expose internal worker bookkeeping only when requested.
|
|
10
|
+
1. Resolve the authorized target and scope. For a scoped directory use that directory as `targetPath` and `scope: "."`. For a continuation, call `get_codex_security_scan_context` with its `scanId` and supplied `handoffClaimToken`. Use its saved identity and scope. If its mode is Standard or diff, continue with the corresponding scan skill. Follow `../../references/scan-prologue.md` for source access and context updates.
|
|
11
|
+
2. For a new target, call `inspect_codex_security_setup({ targetPath, scope: ".", mode: "deep", projectConfigPath? })`. Show the effective settings and their sources. `max_discovery_runs` caps the total number of Standard scans, including when several run together. Pass a project file only when the user selected it. Existing scans use their saved configuration.
|
|
12
|
+
3. For a newly launched native scan with a supplied scan ID, inspect `otherRunningDeepScans` in the result of `get_codex_security_scan_context` once. Target-based setup previews have no scan ID. If another Deep scan is active, show its target, phase and human-friendly start time. Explain the additional CPU, memory and token use. Offer **Cancel (Recommended)** and **Continue** using `request_user_input`, then `request_codex_security_user_input` or plain chat if unavailable. Wait for an explicit choice. A dismissed dialog is not a cancellation. Cancel only the new scan if requested.
|
|
13
|
+
4. Follow `../../references/access-advisory.md`, then call `start_codex_security_deep_scan({ scanId, handoffClaimToken? })` for an existing scan or `start_codex_security_deep_scan({ targetPath, scope: ".", userContext?, projectConfigPath? })` for a new target. Reuse the project file selected at setup. Await the tool. If the tool runner returns a running cell ID, wait on that cell until it returns the scan result. If the connection closes, rejoin with the same arguments. Report a terminal failure with its saved results. For a policy refusal, identify the worker from its saved error when available. On explicit cancellation call `cancel_codex_security_scan({ scanId })` from the owning thread.
|
|
14
|
+
5. For an SDK-owned scan, return the host's scan ID and manifest path so the SDK can finalize it. When the tool returns `completion`, link its generated `report.md` and canonical artifacts. Use `completion.scan.usage` and any separate cost estimate to report usage per `../../references/final-report.md`. Distinguish a completed audit with zero findings from a deadline reached before any audit completed.
|
|
@@ -35,6 +35,7 @@ Treat the finding as a data-flow and boundary problem, not merely the named inpu
|
|
|
35
35
|
1. Trace the reported path and inspect only the context needed to identify the real shared boundary. Return `no_change` when repository evidence shows that the reported path is already safe; do not make a speculative change.
|
|
36
36
|
2. In standard mode, when feasible, run the smallest high-signal reproduction through that boundary and one legitimate control through the same path.
|
|
37
37
|
3. Implement the smallest repository-native fix at the shared boundary. Prefer nearby helpers and established APIs. Do not broaden into unrelated redesign, cleanup, or sibling findings.
|
|
38
|
+
- If the finding includes a proposed patch for this repository, use it as the starting candidate. For AWS Continuum, read `patches[].patch` from a collector capture or `source_data.patches[].patch` from the stored finding's `evidence`. Compare the hunks with the current checkout. Keep those that enforce the security invariant and adapt or replace those that leave a bypass or break legitimate behavior. If only artifact metadata is available, develop the fix from source.
|
|
38
39
|
4. Before verification, challenge the patch rather than defending it: inspect every direct caller of each changed helper and both outcomes of each changed condition. Look for one sibling path, representation, or copy that still reaches the vulnerable sink and one ordinary or default input that the patch newly rejects or reinterprets; revise the implementation if either exists.
|
|
39
40
|
5. In standard mode, verify the resulting change:
|
|
40
41
|
- inspect the final diff and run the narrowest syntax, import, build, or type check relevant to it
|
|
@@ -53,7 +54,7 @@ Confirm review concerns against source or, in standard mode, focused execution b
|
|
|
53
54
|
|
|
54
55
|
## Workbench Remediation Stages
|
|
55
56
|
|
|
56
|
-
When a Codex Security workbench request includes a scan ID, occurrence ID, remediation request ID, action token, and expected version,
|
|
57
|
+
When a Codex Security workbench request includes a scan ID, occurrence ID, remediation request ID, action token, and expected version, pass the supplied `scanId`, `occurrenceId`, `requestId`, and `actionToken` to `get_codex_security_scan_context` when loading or refreshing the assigned finding. Follow only the requested remediation stage. The stage boundary changes when code may be written, but it does not weaken the validation requirements above.
|
|
57
58
|
|
|
58
59
|
Before creating or entering any work copy, select Python and Git from a controlled empty directory outside all checkouts. Verify that each trusted tool's absolute invocation path, resolved parent directory, and resolved executable are outside the selected target, its enclosing checkout, and all capture and rehearsal workspaces. Use the host-selected Python (`CODEX_SECURITY_PYTHON_COMMAND` in SDK runs). If absent, use a trusted absolute `PYTHON`, a host-managed runtime, or a verified system interpreter. Invoke its quoted absolute path with `-I` to import helpers from the installed plugin's scripts directory. From the same directory call `workbench_target.trusted_git_executable(target)`, which honors `CODEX_SECURITY_GIT` or discovers Git when that variable is absent. Pin the verified absolute invocation path it returns in the helper process's `CODEX_SECURITY_GIT` environment and pass it to child helpers. Stop if either tool cannot be verified. For workbench Generate and Apply Git commands, pass `offline=True` and the real target to `workbench_target.git_command`, use `-C` for the working directory, and set `-c core.hooksPath=<empty private directory>`.
|
|
59
60
|
|