@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
|
@@ -8,7 +8,7 @@ import json
|
|
|
8
8
|
import os
|
|
9
9
|
import re
|
|
10
10
|
import stat
|
|
11
|
-
from collections.abc import Iterator
|
|
11
|
+
from collections.abc import Iterable, Iterator
|
|
12
12
|
from functools import partial
|
|
13
13
|
from pathlib import Path
|
|
14
14
|
from typing import Any
|
|
@@ -56,23 +56,30 @@ def _source_digests(value: Any, error: str) -> dict[str, str]:
|
|
|
56
56
|
return value
|
|
57
57
|
|
|
58
58
|
|
|
59
|
-
def _retained_source_state(
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
59
|
+
def _retained_source_state(raw: str | None) -> dict[str, Any]:
|
|
60
|
+
"""Decode stopped-scan sources, preserving the distinction between absent and frozen empty."""
|
|
61
|
+
if raw is None:
|
|
62
|
+
return {}
|
|
63
|
+
state = json.loads(raw)
|
|
64
|
+
if not isinstance(state, dict) or not isinstance(state.get("sources"), dict):
|
|
65
|
+
state = {"sources": state} # Legacy rows store only the path-to-digest map.
|
|
66
|
+
sources = _source_digests(state["sources"], "Saved stopped-scan source digests are malformed.")
|
|
67
|
+
model_source = state.get("threatModelSource")
|
|
68
|
+
if "threatModelSource" in state and (
|
|
69
|
+
not isinstance(model_source, str) or model_source not in sources
|
|
70
|
+
):
|
|
71
|
+
raise ContractError("Saved stopped-scan model source is outside its checkpoint set.")
|
|
72
|
+
return state
|
|
71
73
|
|
|
72
74
|
|
|
73
75
|
def _retained_checkpoint_state(
|
|
74
76
|
scan: Any,
|
|
75
77
|
) -> tuple[dict[str, str | None] | None, dict[str, Any] | None]:
|
|
78
|
+
"""Return selected checkpoint heads and any pending recovery record.
|
|
79
|
+
|
|
80
|
+
Older scans can store the head map directly. Recovery records also bind
|
|
81
|
+
the selection to a sealed manifest digest. A conflicting digest raises ContractError.
|
|
82
|
+
"""
|
|
76
83
|
raw = scan["retained_checkpoint_heads_json"]
|
|
77
84
|
if raw is None:
|
|
78
85
|
return None, None
|
|
@@ -125,6 +132,7 @@ def _checkpoint_paths(scan_dir: Path, directory: str) -> list[str]:
|
|
|
125
132
|
|
|
126
133
|
|
|
127
134
|
def _checkpoint_head_directory(relative: str) -> Path | None:
|
|
135
|
+
"""Return the owner directory of a current or archived checkpoint head path, or None for another file."""
|
|
128
136
|
path = Path(relative)
|
|
129
137
|
if path.name == "checkpoint-head.json":
|
|
130
138
|
return path.parent
|
|
@@ -162,6 +170,7 @@ def _capture_saved_source(
|
|
|
162
170
|
checkpoint_heads: dict[str, str | None] | None = None,
|
|
163
171
|
expected_digest: str | None = None,
|
|
164
172
|
) -> dict[str, tuple[str, int]]:
|
|
173
|
+
"""Capture digests and observation times for a saved source and its selected checkpoint or receipt inputs."""
|
|
165
174
|
if not snapshot_head or Path(relative).name != "checkpoint-head.json":
|
|
166
175
|
_, digest, observed = _read_saved_result(scan_dir, relative, scan_id, kind=kind)
|
|
167
176
|
return capture_receipt_checkpoints(
|
|
@@ -241,14 +250,18 @@ def _read_saved_result(
|
|
|
241
250
|
return draft, _digest(draft), int(observed)
|
|
242
251
|
if draft.get("scanId") != scan_id:
|
|
243
252
|
raise ContractError("checkpoint belongs to a different scan")
|
|
244
|
-
if
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
)
|
|
253
|
+
if _is_source_order_snapshot(relative):
|
|
254
|
+
return draft, _digest(draft), metadata.st_mtime_ns
|
|
255
|
+
if not isinstance(draft.get("findings"), list) or not isinstance(
|
|
256
|
+
draft.get("reviewState", draft.get("coverage", {} if kind == "dedup" else None)), dict
|
|
249
257
|
):
|
|
250
258
|
raise ContractError("checkpoint has no semantic findings or coverage")
|
|
251
259
|
digest = _digest(draft)
|
|
260
|
+
if kind == "dedup" and normalize_review:
|
|
261
|
+
# The host keeps grouping state in iteration checkpoints for resume only.
|
|
262
|
+
for finding in draft["findings"]:
|
|
263
|
+
if isinstance(finding, dict) and isinstance(finding.get("provenance"), dict):
|
|
264
|
+
finding["provenance"].pop("deepScanRepairGroups", None)
|
|
252
265
|
if normalize_review and "coverage" in draft and "reviewState" not in draft:
|
|
253
266
|
draft["reviewState"] = draft.pop("coverage")
|
|
254
267
|
return draft, digest, metadata.st_mtime_ns
|
|
@@ -388,6 +401,7 @@ def _restore_checkpoint_head(
|
|
|
388
401
|
sources: dict[str, str],
|
|
389
402
|
relative: str,
|
|
390
403
|
) -> None:
|
|
404
|
+
"""Restore the prior selection for a checkpoint directory, allowing legacy evidence with no selected head."""
|
|
391
405
|
path = Path(relative)
|
|
392
406
|
if path.name != "checkpoint-head.json":
|
|
393
407
|
return
|
|
@@ -639,25 +653,10 @@ def _require_current_deep_publication(
|
|
|
639
653
|
raise SystemExit("Deep Scan is terminal; drafts cannot replace its publication.")
|
|
640
654
|
return
|
|
641
655
|
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
match = re.fullmatch(r"dedup-([0-9]+)", Path(worker["prompt_path"]).parent.name)
|
|
645
|
-
return (int(match[1]) if match else 0, worker["id"])
|
|
646
|
-
|
|
647
|
-
reducer = max(
|
|
648
|
-
(
|
|
649
|
-
worker
|
|
650
|
-
for worker in connection.execute(
|
|
651
|
-
"SELECT * FROM deep_scan_workers WHERE scan_id = ?", (scan_id,)
|
|
652
|
-
)
|
|
653
|
-
if worker["kind"] == "dedup"
|
|
654
|
-
and worker["status"] == "succeeded"
|
|
655
|
-
and worker["result_manifest_path"]
|
|
656
|
-
),
|
|
657
|
-
key=reducer_order,
|
|
658
|
-
default=None,
|
|
656
|
+
iteration = _latest_iteration(
|
|
657
|
+
connection.execute("SELECT * FROM deep_scan_workers WHERE scan_id = ?", (scan_id,))
|
|
659
658
|
)
|
|
660
|
-
selected_result =
|
|
659
|
+
selected_result = iteration["result_manifest_path"] if iteration is not None else None
|
|
661
660
|
if publication["resultPath"] != selected_result:
|
|
662
661
|
raise SystemExit("Deep Scan aggregate belongs to a superseded publication selection.")
|
|
663
662
|
|
|
@@ -666,7 +665,15 @@ if __name__ == "__main__":
|
|
|
666
665
|
argparse.ArgumentParser(description=__doc__).parse_args()
|
|
667
666
|
|
|
668
667
|
|
|
669
|
-
def
|
|
668
|
+
def _iteration_order(worker: Any) -> tuple[int, str, str]:
|
|
669
|
+
result = worker["result_manifest_path"]
|
|
670
|
+
output = Path(result).parent if result else Path(worker["artifact_dir"])
|
|
671
|
+
label = output.parent.name if output.name == "output" else output.name
|
|
672
|
+
match = re.fullmatch(r"dedup-([0-9]+)", label)
|
|
673
|
+
return (int(match[1]) if match else 0, worker["completed_at"] or "", worker["id"])
|
|
674
|
+
|
|
675
|
+
|
|
676
|
+
def _latest_iteration(workers: Iterable[Any]) -> Any | None:
|
|
670
677
|
return max(
|
|
671
678
|
(
|
|
672
679
|
worker
|
|
@@ -675,7 +682,7 @@ def _latest_successful_reducer(workers: list[Any]) -> Any | None:
|
|
|
675
682
|
and worker["status"] == "succeeded"
|
|
676
683
|
and worker["result_manifest_path"]
|
|
677
684
|
),
|
|
678
|
-
key=
|
|
685
|
+
key=_iteration_order,
|
|
679
686
|
default=None,
|
|
680
687
|
)
|
|
681
688
|
|
|
@@ -695,7 +702,7 @@ def _worker_outputs(scan_dir: Path, worker: Any) -> list[tuple[str, int]]:
|
|
|
695
702
|
|
|
696
703
|
|
|
697
704
|
def _saved_result_paths(scan_dir: Path, workers: list[Any]) -> Iterator[tuple[str, str | None]]:
|
|
698
|
-
|
|
705
|
+
iteration = _latest_iteration(workers)
|
|
699
706
|
yield "checkpoint-head.json", None
|
|
700
707
|
for directory in ("checkpoint-heads", "checkpoints"):
|
|
701
708
|
yield from ((path, None) for path in _checkpoint_paths(scan_dir, directory))
|
|
@@ -719,7 +726,7 @@ def _saved_result_paths(scan_dir: Path, workers: list[Any]) -> Iterator[tuple[st
|
|
|
719
726
|
yield from ((path, worker["kind"]) for path in checkpoint_paths)
|
|
720
727
|
if worker["result_manifest_path"] and (
|
|
721
728
|
worker["kind"] == "discovery"
|
|
722
|
-
or (
|
|
729
|
+
or (iteration is not None and worker["id"] == iteration["id"])
|
|
723
730
|
):
|
|
724
731
|
try:
|
|
725
732
|
yield (
|
|
@@ -2,11 +2,19 @@
|
|
|
2
2
|
|
|
3
3
|
from __future__ import annotations
|
|
4
4
|
|
|
5
|
+
import hashlib
|
|
5
6
|
import os
|
|
7
|
+
import sqlite3
|
|
8
|
+
import tempfile
|
|
6
9
|
from pathlib import Path
|
|
10
|
+
from typing import Any
|
|
11
|
+
|
|
12
|
+
if os.name == "nt":
|
|
13
|
+
import windows_scan_local_files as windows_files
|
|
7
14
|
|
|
8
15
|
|
|
9
16
|
def state_dir(*, canonical: bool = True) -> Path:
|
|
17
|
+
"""Return the workbench state path, resolving symlinks unless canonical is false."""
|
|
10
18
|
configured = os.environ.get("CODEX_SECURITY_STATE_DIR")
|
|
11
19
|
if configured:
|
|
12
20
|
path = Path(configured).expanduser()
|
|
@@ -19,15 +27,91 @@ def state_dir(*, canonical: bool = True) -> Path:
|
|
|
19
27
|
|
|
20
28
|
|
|
21
29
|
def resolve_scan_root(scan_root: str | None) -> Path:
|
|
30
|
+
"""Resolve an explicit scan output root, defaulting to the scans directory under workbench state."""
|
|
22
31
|
return Path(scan_root).expanduser().resolve() if scan_root else state_dir() / "scans"
|
|
23
32
|
|
|
24
33
|
|
|
25
|
-
def
|
|
34
|
+
def worker_usage_directory(scan_id: str) -> Path:
|
|
35
|
+
"""Bind host-observed receipts beneath the persistent protected native home."""
|
|
36
|
+
return state_dir() / "codex-home" / "worker-usage" / scan_id
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def short_archive_prefix(original_name: str) -> str:
|
|
40
|
+
"""Bind a short archive name to the complete original filename."""
|
|
41
|
+
return f".previous-{hashlib.sha256(os.fsencode(original_name)).hexdigest()}-"
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def archive_source_directory(archive: Path, source: Path) -> Path | None:
|
|
45
|
+
"""Return the original sibling when the archived name identifies it."""
|
|
46
|
+
if not source.is_relative_to(archive.parent):
|
|
47
|
+
return None
|
|
48
|
+
parts = source.relative_to(archive.parent).parts
|
|
49
|
+
if not parts or ".." in parts:
|
|
50
|
+
return None
|
|
51
|
+
name = parts[0]
|
|
52
|
+
if archive.name.startswith(f"{name}.previous-") or (
|
|
53
|
+
archive.name.startswith(".previous-")
|
|
54
|
+
and archive.name.startswith(short_archive_prefix(name))
|
|
55
|
+
):
|
|
56
|
+
return archive.parent / name
|
|
57
|
+
return None
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
def archived_deep_path(scan_dir: Path, value: str | None) -> str | None:
|
|
61
|
+
"""Resolve old archive rows that still name the original sibling output."""
|
|
62
|
+
if value is None or ".previous-" not in scan_dir.name:
|
|
63
|
+
return value
|
|
64
|
+
path = Path(value)
|
|
65
|
+
original = archive_source_directory(scan_dir, path)
|
|
66
|
+
if original is None:
|
|
67
|
+
return value
|
|
68
|
+
# Keep missing files inside the archive too. Never follow the replacement scan's output.
|
|
69
|
+
return str(scan_dir / path.relative_to(original))
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
def saved_deep_workers(connection: sqlite3.Connection, scan: sqlite3.Row) -> list[Any]:
|
|
73
|
+
workers = connection.execute(
|
|
74
|
+
"SELECT * FROM deep_scan_workers WHERE scan_id = ? ORDER BY created_at, id",
|
|
75
|
+
(scan["id"],),
|
|
76
|
+
).fetchall()
|
|
77
|
+
scan_dir = Path(scan["scan_dir"])
|
|
78
|
+
if ".previous-" not in scan_dir.name:
|
|
79
|
+
return workers
|
|
80
|
+
return [
|
|
81
|
+
{
|
|
82
|
+
**worker,
|
|
83
|
+
**{
|
|
84
|
+
key: archived_deep_path(scan_dir, worker[key])
|
|
85
|
+
for key in ("artifact_dir", "prompt_path", "result_manifest_path")
|
|
86
|
+
},
|
|
87
|
+
}
|
|
88
|
+
for worker in workers
|
|
89
|
+
]
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
def create_private_directory(path: Path, *, scan_output: bool = False) -> None:
|
|
26
93
|
"""Create missing directories privately without changing existing permissions."""
|
|
27
|
-
|
|
28
|
-
path.
|
|
29
|
-
|
|
30
|
-
if path.parent == path:
|
|
31
|
-
raise
|
|
32
|
-
create_private_directory(path.parent)
|
|
94
|
+
if path.parent != path and not path.parent.is_dir():
|
|
95
|
+
create_private_directory(path.parent, scan_output=scan_output)
|
|
96
|
+
if os.name != "nt":
|
|
33
97
|
path.mkdir(mode=0o700, exist_ok=True)
|
|
98
|
+
elif not path.is_dir():
|
|
99
|
+
windows_files.create_private_directory(path, exist_ok=True, scan_output=scan_output)
|
|
100
|
+
elif scan_output:
|
|
101
|
+
windows_files.require_windows_output_path(path)
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
def create_private_temporary_directory(parent: Path, *, prefix: str) -> Path:
|
|
105
|
+
"""Create a unique private child without inheriting a permissive Windows DACL."""
|
|
106
|
+
if os.name != "nt":
|
|
107
|
+
return Path(tempfile.mkdtemp(prefix=prefix, dir=parent)).resolve()
|
|
108
|
+
|
|
109
|
+
import secrets
|
|
110
|
+
|
|
111
|
+
for _ in range(100):
|
|
112
|
+
path = parent / f"{prefix}{secrets.token_hex(4)}"
|
|
113
|
+
try:
|
|
114
|
+
return windows_files.create_private_directory(path, exist_ok=False, scan_output=True)
|
|
115
|
+
except FileExistsError:
|
|
116
|
+
continue
|
|
117
|
+
raise FileExistsError(f"Could not create a unique directory beneath {parent}.")
|
|
@@ -37,6 +37,11 @@ def add_user_context(parser: argparse.ArgumentParser, *, required: bool = False)
|
|
|
37
37
|
|
|
38
38
|
|
|
39
39
|
def parse_args(description: str, *, inspection_only: bool = False) -> argparse.Namespace:
|
|
40
|
+
"""Parse the workbench command line into the namespace consumed by its dispatcher.
|
|
41
|
+
|
|
42
|
+
For a full command, read UTF-8 user context from stdin when requested. In
|
|
43
|
+
inspection mode, recognized inspection arguments return before that read.
|
|
44
|
+
"""
|
|
40
45
|
parser = argparse.ArgumentParser(description=description)
|
|
41
46
|
subparsers = parser.add_subparsers(dest="command", required=True)
|
|
42
47
|
|
|
@@ -112,6 +117,7 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
112
117
|
)
|
|
113
118
|
|
|
114
119
|
begin_deep_scan = add_command("begin-deep-scan", "--thread-id")
|
|
120
|
+
begin_deep_scan.add_argument("--model-thread-id")
|
|
115
121
|
begin_target = begin_deep_scan.add_mutually_exclusive_group(required=True)
|
|
116
122
|
begin_target.add_argument("--scan-id")
|
|
117
123
|
begin_target.add_argument("--target-path")
|
|
@@ -149,24 +155,20 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
149
155
|
upsert_deep_worker.add_argument("--attempt", type=non_negative_int)
|
|
150
156
|
upsert_deep_worker.add_argument("--sdk-thread-id")
|
|
151
157
|
upsert_deep_worker.add_argument("--error-message")
|
|
158
|
+
upsert_deep_worker.add_argument("--terminal-failure", action="store_true")
|
|
152
159
|
upsert_deep_worker.add_argument(
|
|
153
160
|
"--replaceable-failure-kind",
|
|
154
161
|
choices=("policy_refusal", "transient_error", "invalid_discovery_artifacts"),
|
|
155
162
|
)
|
|
156
163
|
upsert_deep_worker.add_argument("--coordinator-generation", type=positive_int)
|
|
157
164
|
|
|
158
|
-
|
|
159
|
-
"
|
|
160
|
-
)
|
|
161
|
-
claim_deep_dedup.add_argument("--input-worker-id", action="append", required=True)
|
|
162
|
-
claim_deep_dedup.add_argument("--coordinator-generation", type=positive_int)
|
|
163
|
-
|
|
164
|
-
commit_deep_dedup = add_command(
|
|
165
|
-
"commit-deep-scan-dedup", "--scan-id", "--worker-id", "--result-manifest-path"
|
|
165
|
+
iteration = add_command(
|
|
166
|
+
"record-deep-scan-iteration", "--scan-id", "--worker-id", "--result-manifest-path"
|
|
166
167
|
)
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
168
|
+
iteration.add_argument("--input-worker-id", action="append", required=True)
|
|
169
|
+
iteration.add_argument("--no-new-streak", type=non_negative_int, required=True)
|
|
170
|
+
iteration.add_argument("--consecutive-errors", type=non_negative_int, required=True)
|
|
171
|
+
iteration.add_argument("--coordinator-generation", type=positive_int)
|
|
170
172
|
|
|
171
173
|
finish_deep_scan = add_command("finish-deep-scan", "--scan-id")
|
|
172
174
|
finish_deep_scan.add_argument(
|
|
@@ -191,11 +193,20 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
191
193
|
publication_failure.add_argument("--coordinator-generation", type=positive_int)
|
|
192
194
|
|
|
193
195
|
get_scan = add_command("get-scan", "--scan-id")
|
|
194
|
-
get_scan.add_argument("--
|
|
196
|
+
get_scan.add_argument("--model-thread-id")
|
|
197
|
+
get_scan.add_argument("--context-claim-token")
|
|
198
|
+
get_scan.add_argument("--request-id")
|
|
199
|
+
get_scan.add_argument("--action-token")
|
|
200
|
+
detail = get_scan.add_mutually_exclusive_group()
|
|
201
|
+
detail.add_argument("--occurrence-id")
|
|
202
|
+
detail.add_argument("--progress-only", action="store_true")
|
|
195
203
|
get_scan.add_argument("--check-target", action="store_true")
|
|
196
204
|
|
|
197
205
|
add_command("rename-scan", "--scan-id", "--name")
|
|
198
206
|
|
|
207
|
+
read_scan_usage = add_command("read-scan-usage", "--scan-id", "--thread-id")
|
|
208
|
+
read_scan_usage.add_argument("--validation-thread-id")
|
|
209
|
+
|
|
199
210
|
add_command("get-scan-feedback", "--scan-id")
|
|
200
211
|
|
|
201
212
|
update_scan_context = add_command("update-scan-context", "--scan-id")
|
|
@@ -211,11 +222,15 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
211
222
|
list_scans.add_argument("--status", choices=("running", "complete", "failed", "canceled"))
|
|
212
223
|
list_scans.add_argument("--mode", choices=MODES)
|
|
213
224
|
list_scans.add_argument("--repository")
|
|
225
|
+
list_scans.add_argument(
|
|
226
|
+
"--prefer-worktree", action="store_true", help="List scans from this checkout first."
|
|
227
|
+
)
|
|
214
228
|
list_scans.add_argument("--scan-root")
|
|
215
229
|
list_scans.add_argument("--offset", type=non_negative_int, default=0)
|
|
216
230
|
list_scans.add_argument("--limit", type=positive_int)
|
|
217
231
|
|
|
218
232
|
list_unmatched_scan_pairs = add_command("list-unmatched-scan-pairs", "--repository")
|
|
233
|
+
list_unmatched_scan_pairs.add_argument("--after-scan-id")
|
|
219
234
|
list_unmatched_scan_pairs.add_argument("--force", action="store_true")
|
|
220
235
|
|
|
221
236
|
register_cli_scan = add_command("register-cli-scan", "--scan-dir", "--repository")
|
|
@@ -231,7 +246,17 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
231
246
|
)
|
|
232
247
|
register_cli_scan.add_argument("--archived-scan-dir")
|
|
233
248
|
|
|
234
|
-
|
|
249
|
+
restore_cli_scan_archive = subparsers.add_parser("restore-cli-scan-archive")
|
|
250
|
+
restore_cli_scan_archive.add_argument("--scan-dir", required=True)
|
|
251
|
+
restore_cli_scan_archive.add_argument("--archived-scan-dir", required=True)
|
|
252
|
+
previous_scan = restore_cli_scan_archive.add_mutually_exclusive_group(required=True)
|
|
253
|
+
previous_scan.add_argument("--previous-scan-id")
|
|
254
|
+
previous_scan.add_argument("--previous-scan-absent", action="store_true")
|
|
255
|
+
|
|
256
|
+
set_scan_thread = subparsers.add_parser("set-scan-thread")
|
|
257
|
+
set_scan_thread.add_argument("--scan-id", required=True)
|
|
258
|
+
set_scan_thread.add_argument("--thread-id", required=True)
|
|
259
|
+
set_scan_thread.add_argument("--time-budget-started-at")
|
|
235
260
|
|
|
236
261
|
set_scan_cost_limit = add_command("set-scan-cost-limit", "--scan-id")
|
|
237
262
|
set_scan_cost_limit.add_argument("--max-cost-usd", required=True, type=float)
|
|
@@ -259,7 +284,9 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
259
284
|
list_global_findings.add_argument("--query")
|
|
260
285
|
list_global_findings.add_argument("--severity", choices=FINDING_SEVERITIES)
|
|
261
286
|
list_global_findings.add_argument("--status", choices=FINDING_STATUSES)
|
|
262
|
-
list_global_findings.
|
|
287
|
+
finding_repository = list_global_findings.add_mutually_exclusive_group()
|
|
288
|
+
finding_repository.add_argument("--target-id")
|
|
289
|
+
finding_repository.add_argument("--repository")
|
|
263
290
|
list_global_findings.add_argument("--offset", type=non_negative_int, default=0)
|
|
264
291
|
list_global_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
|
|
265
292
|
list_repositories = subparsers.add_parser("list-repositories")
|
|
@@ -277,6 +304,11 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
277
304
|
list_findings.add_argument("--limit", type=positive_int, default=FINDINGS_PAGE_MAX)
|
|
278
305
|
|
|
279
306
|
update_progress = add_command("update-progress", "--scan-id")
|
|
307
|
+
update_progress.add_argument("--model-update", action="store_true")
|
|
308
|
+
update_progress.add_argument(
|
|
309
|
+
"--refresh-scope-file-count", action="store_true", help=argparse.SUPPRESS
|
|
310
|
+
)
|
|
311
|
+
update_progress.add_argument("--model-thread-id")
|
|
280
312
|
update_progress.add_argument("--phase", choices=PHASES)
|
|
281
313
|
update_progress.add_argument("--phase-items-total", type=non_negative_int)
|
|
282
314
|
update_progress.add_argument("--phase-items-completed", type=non_negative_int)
|
|
@@ -294,6 +326,7 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
294
326
|
prepare_scan_completion.add_argument("--claim-token")
|
|
295
327
|
|
|
296
328
|
complete_scan = add_command("complete-scan", "--scan-id")
|
|
329
|
+
complete_scan.add_argument("--model-thread-id")
|
|
297
330
|
complete_scan.add_argument("--claim-token")
|
|
298
331
|
complete_scan.add_argument("--cost-json")
|
|
299
332
|
complete_scan.add_argument("--thread-id")
|
|
@@ -313,8 +346,10 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
313
346
|
|
|
314
347
|
cancel_scan = add_command("cancel-scan", "--scan-id")
|
|
315
348
|
cancel_scan.add_argument("--thread-id")
|
|
349
|
+
cancel_scan.add_argument("--cost-json")
|
|
316
350
|
|
|
317
351
|
fail_scan = add_command("fail-scan", "--scan-id", "--message")
|
|
352
|
+
fail_scan.add_argument("--model-thread-id")
|
|
318
353
|
fail_scan.add_argument("--claim-token")
|
|
319
354
|
fail_scan.add_argument("--cost-json")
|
|
320
355
|
|
|
@@ -330,11 +365,13 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
330
365
|
recover_scan.add_argument("--scan-id", required=True, help="ID of the stopped scan to recover.")
|
|
331
366
|
|
|
332
367
|
write_scan_draft = add_command("write-scan-draft", "--scan-id", "--draft-path")
|
|
368
|
+
write_scan_draft.add_argument("--model-thread-id")
|
|
333
369
|
write_scan_draft.add_argument("--checkpoint-path")
|
|
334
370
|
write_scan_draft.add_argument("--expected-draft-digest")
|
|
335
371
|
write_scan_draft.add_argument("--claim-token")
|
|
336
372
|
|
|
337
373
|
save_scan_artifact = add_command("save-scan-artifact", "--scan-id", "--artifact-path")
|
|
374
|
+
save_scan_artifact.add_argument("--model-thread-id")
|
|
338
375
|
save_scan_artifact.add_argument("--claim-token")
|
|
339
376
|
|
|
340
377
|
for command in ("save-artifact", "read-artifact"):
|
|
@@ -342,6 +379,8 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
342
379
|
|
|
343
380
|
mark_handoff_delivered = add_command("mark-handoff-delivered", "--scan-id", "--claim-token")
|
|
344
381
|
mark_handoff_delivered.add_argument("--thread-id")
|
|
382
|
+
mark_handoff_delivered.add_argument("--return-context", action="store_true")
|
|
383
|
+
mark_handoff_delivered.add_argument("--occurrence-id")
|
|
345
384
|
|
|
346
385
|
claim_handoff_delivery = add_command("claim-handoff-delivery", "--scan-id", "--claim-token")
|
|
347
386
|
claim_handoff_delivery.add_argument("--take-over-stale", action="store_true")
|
|
@@ -383,6 +422,7 @@ def parse_args(description: str, *, inspection_only: bool = False) -> argparse.N
|
|
|
383
422
|
set_finding_remediation.add_argument(
|
|
384
423
|
"--state", choices=REMEDIATION_UPDATE_STATES, required=True
|
|
385
424
|
)
|
|
425
|
+
set_finding_remediation.add_argument("--assigned-finding", action="store_true")
|
|
386
426
|
set_finding_remediation.add_argument("--summary")
|
|
387
427
|
set_finding_remediation.add_argument("--patch-stdin", action="store_true")
|
|
388
428
|
set_finding_remediation.add_argument("--patch-path")
|
|
@@ -36,6 +36,14 @@ FINDING_ATTACK_PATH_PREVIEW_BYTES = 4_000
|
|
|
36
36
|
FINDING_CODE_EVIDENCE_LIMIT = 4
|
|
37
37
|
FINDING_CODE_EVIDENCE_SNIPPET_BYTES = 1_500
|
|
38
38
|
FINDING_EVIDENCE_EXCERPT_BYTES = 8_000
|
|
39
|
+
FINDING_LOCATION_ORDER_SQL = "CASE WHEN role = 'root_control' THEN 0 ELSE 1 END, sort_order"
|
|
40
|
+
# The outer query binds finding_occurrences as occurrences.
|
|
41
|
+
PRIMARY_FINDING_LOCATION_SQL = f"""
|
|
42
|
+
FROM finding_locations
|
|
43
|
+
WHERE occurrence_id = occurrences.id
|
|
44
|
+
ORDER BY {FINDING_LOCATION_ORDER_SQL}
|
|
45
|
+
LIMIT 1
|
|
46
|
+
"""
|
|
39
47
|
FINDING_LOCATIONS_LIMIT = 8
|
|
40
48
|
FINDING_TITLE_BYTES = 512
|
|
41
49
|
FINDING_SUMMARY_BYTES = 2_000
|
|
@@ -50,6 +58,8 @@ GIT_REPOSITORY_ENVIRONMENT = (
|
|
|
50
58
|
"GIT_COMMON_DIR",
|
|
51
59
|
"GIT_DIR",
|
|
52
60
|
"GIT_DISCOVERY_ACROSS_FILESYSTEM",
|
|
61
|
+
"GIT_GLOB_PATHSPECS",
|
|
62
|
+
"GIT_ICASE_PATHSPECS",
|
|
53
63
|
"GIT_INDEX_FILE",
|
|
54
64
|
"GIT_NAMESPACE",
|
|
55
65
|
"GIT_OBJECT_DIRECTORY",
|
|
@@ -63,6 +73,7 @@ EMPTY_GIT_TREES = {
|
|
|
63
73
|
|
|
64
74
|
|
|
65
75
|
def optional_text(value: str | None, *, maximum: int | None = None) -> str | None:
|
|
76
|
+
"""Strip surrounding whitespace, return None for blank text, and enforce the character limit."""
|
|
66
77
|
if value is None:
|
|
67
78
|
return None
|
|
68
79
|
normalized = value.strip()
|
|
@@ -72,6 +83,7 @@ def optional_text(value: str | None, *, maximum: int | None = None) -> str | Non
|
|
|
72
83
|
|
|
73
84
|
|
|
74
85
|
def positive_int(value: str) -> int:
|
|
86
|
+
"""Parse a CLI count and reject values below one with an argparse validation error."""
|
|
75
87
|
parsed = int(value)
|
|
76
88
|
if parsed < 1:
|
|
77
89
|
raise argparse.ArgumentTypeError("expected a positive integer")
|
|
@@ -10,6 +10,7 @@ from typing import Any
|
|
|
10
10
|
|
|
11
11
|
from finalize_scan_contract import (
|
|
12
12
|
ContractError,
|
|
13
|
+
MissingScanLocalFileError,
|
|
13
14
|
_require_portable_relative_path,
|
|
14
15
|
_require_str,
|
|
15
16
|
_validate_schema_node,
|
|
@@ -108,6 +109,7 @@ def retain_recorded_receipt_ownership(
|
|
|
108
109
|
def resolve_coverage_receipts(
|
|
109
110
|
scan_dir: Path, item: dict[str, Any], worker: Any, relative: str
|
|
110
111
|
) -> Any:
|
|
112
|
+
"""Qualify worker receipt references relative to their source checkpoint for use in parent coverage."""
|
|
111
113
|
refs = item.get("receiptRefs", [])
|
|
112
114
|
if not isinstance(refs, list):
|
|
113
115
|
return refs
|
|
@@ -397,9 +399,7 @@ def _generic_surface_updates(
|
|
|
397
399
|
for ref in previous_refs if isinstance(previous_refs, list) else []:
|
|
398
400
|
if ref not in refs:
|
|
399
401
|
failure = receipt_error(ref) if repaired else None
|
|
400
|
-
replaceable = failure
|
|
401
|
-
failure.__cause__, FileNotFoundError
|
|
402
|
-
)
|
|
402
|
+
replaceable = isinstance(failure, MissingScanLocalFileError)
|
|
403
403
|
if repaired and isinstance(ref, str):
|
|
404
404
|
try:
|
|
405
405
|
normalized = _require_portable_relative_path(
|