@openai/codex-security 0.2.0 → 0.4.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 +437 -2692
- package/_bundled_plugin/.app.json +5 -1
- package/_bundled_plugin/.codex-plugin/plugin.json +4 -0
- package/_bundled_plugin/.mcp.json +2 -0
- package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
- package/_bundled_plugin/examples/completed-scan/report.md +28 -26
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
- package/_bundled_plugin/mcp/helpers.mjs +1 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
- 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/permission-profile-preflight.mjs +556 -0
- package/_bundled_plugin/mcp/server.mjs +1 -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/preflight/capability-profiles.toml +0 -13
- package/_bundled_plugin/references/artifact-storage.md +2 -2
- package/_bundled_plugin/references/config-preflight.md +0 -4
- package/_bundled_plugin/references/core-scan.md +21 -9
- package/_bundled_plugin/references/final-report.md +11 -13
- package/_bundled_plugin/references/finding-detail-fields.md +90 -80
- package/_bundled_plugin/references/sarif-adapter.md +1 -1
- package/_bundled_plugin/references/scan-artifacts.md +1 -2
- package/_bundled_plugin/references/scan-contract.md +9 -4
- package/_bundled_plugin/references/scan-prologue.md +12 -0
- package/_bundled_plugin/references/security-guidance.md +2 -2
- package/_bundled_plugin/references/standalone-validation.md +11 -0
- package/_bundled_plugin/references/threat-model.md +1 -1
- package/_bundled_plugin/schemas/coverage.schema.json +43 -170
- package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
- package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
- package/_bundled_plugin/schemas/findings.schema.json +159 -567
- package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
- package/_bundled_plugin/schemas/scan-manifest.schema.json +78 -220
- package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
- package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
- package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
- package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
- package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
- package/_bundled_plugin/scripts/codex_session.mjs +53 -0
- package/_bundled_plugin/scripts/config_preflight.py +26 -62
- package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
- package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
- package/_bundled_plugin/scripts/finalize_scan_contract.py +321 -237
- package/_bundled_plugin/scripts/finding_preview.py +39 -9
- package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
- package/_bundled_plugin/scripts/generate_rank_input.py +115 -926
- package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
- package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
- package/_bundled_plugin/scripts/rank_preview.py +42 -918
- package/_bundled_plugin/scripts/report_projection.py +150 -183
- package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
- package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
- package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
- package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
- package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
- package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
- package/_bundled_plugin/scripts/workbench/storage.py +10 -6
- package/_bundled_plugin/scripts/workbench_cli.py +102 -184
- package/_bundled_plugin/scripts/workbench_db.py +463 -464
- package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
- package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
- package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
- package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
- package/_bundled_plugin/scripts/workbench_progress.py +14 -58
- package/_bundled_plugin/scripts/workbench_publication.py +234 -289
- package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
- package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
- package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
- package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
- package/_bundled_plugin/scripts/workbench_scan_usage.py +194 -42
- package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
- package/_bundled_plugin/scripts/workbench_target.py +430 -142
- package/_bundled_plugin/scripts/workbench_validation.py +31 -28
- package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
- package/_bundled_plugin/shared/workbench-migrations.json +414 -0
- package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
- package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
- package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
- package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
- package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
- package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
- package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
- package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +15 -1
- package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
- package/_bundled_plugin/skills/track-findings/SKILL.md +48 -176
- package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
- package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
- package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
- package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
- package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
- package/bin/codex-security.mjs +9 -2
- package/dist/api.d.ts +63 -10
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +1015 -383
- package/dist/api.js.map +1 -1
- package/dist/artifact-export.d.ts +1 -1
- package/dist/artifact-export.d.ts.map +1 -1
- package/dist/artifact-export.js +28 -13
- package/dist/artifact-export.js.map +1 -1
- package/dist/auth.d.ts +2 -6
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +19 -9
- package/dist/auth.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +1 -0
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/classify-severity.d.ts +26 -9
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +13 -30
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-help.d.ts.map +1 -1
- package/dist/cli-help.js +17 -13
- package/dist/cli-help.js.map +1 -1
- package/dist/cli-signals.d.ts +8 -0
- package/dist/cli-signals.d.ts.map +1 -0
- package/dist/cli-signals.js +28 -0
- package/dist/cli-signals.js.map +1 -0
- package/dist/cli.d.ts +4 -3
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1102 -905
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +10 -9
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codeowners.d.ts +19 -0
- package/dist/codeowners.d.ts.map +1 -0
- package/dist/codeowners.js +138 -0
- package/dist/codeowners.js.map +1 -0
- package/dist/codex-sdk-environment.d.ts +1 -0
- package/dist/codex-sdk-environment.d.ts.map +1 -1
- package/dist/codex-sdk-environment.js +40 -2
- package/dist/codex-sdk-environment.js.map +1 -1
- package/dist/component-plan.d.ts +2 -5
- package/dist/component-plan.d.ts.map +1 -1
- package/dist/component-plan.js +39 -31
- package/dist/component-plan.js.map +1 -1
- package/dist/component-scan.d.ts +6 -5
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +25 -36
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +64 -74
- package/dist/config.js.map +1 -1
- package/dist/contract.d.ts +16 -3
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +91 -255
- package/dist/contract.js.map +1 -1
- package/dist/cost-model.d.ts +13 -6
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +14 -4
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +10 -2
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +102 -104
- package/dist/cost.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +6 -5
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/custom-validation.d.ts +1 -2
- package/dist/custom-validation.d.ts.map +1 -1
- package/dist/custom-validation.js +9 -3
- package/dist/custom-validation.js.map +1 -1
- package/dist/deduplication/checkpointed-review.d.ts +4 -2
- package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
- package/dist/deduplication/checkpointed-review.js +23 -9
- package/dist/deduplication/checkpointed-review.js.map +1 -1
- package/dist/deduplication/codex-review.d.ts +8 -6
- package/dist/deduplication/codex-review.d.ts.map +1 -1
- package/dist/deduplication/codex-review.js +128 -19
- package/dist/deduplication/codex-review.js.map +1 -1
- package/dist/deduplication/deduplication-prompts.d.ts +5 -2
- package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
- package/dist/deduplication/deduplication-prompts.js +18 -4
- package/dist/deduplication/deduplication-prompts.js.map +1 -1
- package/dist/deduplication/deduplication-reviewer.d.ts +27 -5
- package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
- package/dist/deduplication/deduplication-reviewer.js +58 -48
- package/dist/deduplication/deduplication-reviewer.js.map +1 -1
- package/dist/deduplication/deduplication.d.ts.map +1 -1
- package/dist/deduplication/deduplication.js +19 -51
- package/dist/deduplication/deduplication.js.map +1 -1
- package/dist/deduplication/diagnostics.d.ts +17 -0
- package/dist/deduplication/diagnostics.d.ts.map +1 -0
- package/dist/deduplication/diagnostics.js +5 -0
- package/dist/deduplication/diagnostics.js.map +1 -0
- package/dist/deduplication/finding-schema.d.ts.map +1 -1
- package/dist/deduplication/finding-schema.js +7 -1
- package/dist/deduplication/finding-schema.js.map +1 -1
- package/dist/deduplication/local.d.ts +31 -0
- package/dist/deduplication/local.d.ts.map +1 -0
- package/dist/deduplication/local.js +166 -0
- package/dist/deduplication/local.js.map +1 -0
- package/dist/deduplication/records-protocol.d.ts +3 -8
- package/dist/deduplication/records-protocol.d.ts.map +1 -1
- package/dist/deduplication/records-protocol.js +11 -184
- package/dist/deduplication/records-protocol.js.map +1 -1
- package/dist/deduplication/records.d.ts +186 -11
- package/dist/deduplication/records.d.ts.map +1 -1
- package/dist/deduplication/records.js +10 -18
- package/dist/deduplication/records.js.map +1 -1
- package/dist/deduplication/scan.d.ts +9 -3
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +158 -39
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +2 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +4 -4
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-progress.d.ts +17 -1
- package/dist/deep-progress.d.ts.map +1 -1
- package/dist/deep-progress.js +19 -17
- package/dist/deep-progress.js.map +1 -1
- package/dist/deep-scan.d.ts +20 -0
- package/dist/deep-scan.d.ts.map +1 -0
- package/dist/deep-scan.js +113 -0
- package/dist/deep-scan.js.map +1 -0
- package/dist/errors.d.ts +2 -0
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +2 -0
- package/dist/errors.js.map +1 -1
- package/dist/executable-path.d.ts +2 -0
- package/dist/executable-path.d.ts.map +1 -0
- package/dist/executable-path.js +12 -0
- package/dist/executable-path.js.map +1 -0
- package/dist/feedback.d.ts +1 -4
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +54 -22
- package/dist/feedback.js.map +1 -1
- package/dist/finding-catalogue.d.ts.map +1 -1
- package/dist/finding-catalogue.js +4 -8
- package/dist/finding-catalogue.js.map +1 -1
- package/dist/finding-normalization.d.ts +5 -0
- package/dist/finding-normalization.d.ts.map +1 -0
- package/dist/finding-normalization.js +120 -0
- package/dist/finding-normalization.js.map +1 -0
- package/dist/finding-retrieval.d.ts +9 -0
- package/dist/finding-retrieval.d.ts.map +1 -1
- package/dist/finding-retrieval.js.map +1 -1
- package/dist/finding-workflow.d.ts +13 -8
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +14 -6
- package/dist/finding-workflow.js.map +1 -1
- package/dist/findings-client.d.ts +2 -1
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +36 -9
- package/dist/findings-client.js.map +1 -1
- package/dist/findings-errors.d.ts +16 -0
- package/dist/findings-errors.d.ts.map +1 -0
- package/dist/findings-errors.js +24 -0
- package/dist/findings-errors.js.map +1 -0
- package/dist/findings-import.d.ts +1 -1
- package/dist/findings-import.d.ts.map +1 -1
- package/dist/findings-import.js +12 -30
- package/dist/findings-import.js.map +1 -1
- package/dist/github.d.ts.map +1 -1
- package/dist/github.js +7 -1
- package/dist/github.js.map +1 -1
- package/dist/host-protocol.d.ts +19 -0
- package/dist/host-protocol.d.ts.map +1 -0
- package/dist/host-protocol.js +270 -0
- package/dist/host-protocol.js.map +1 -0
- package/dist/hosted-scan-protocol.d.ts +4 -0
- package/dist/hosted-scan-protocol.d.ts.map +1 -0
- package/dist/hosted-scan-protocol.js +25 -0
- package/dist/hosted-scan-protocol.js.map +1 -0
- package/dist/hosted-scan.d.ts +117 -0
- package/dist/hosted-scan.d.ts.map +1 -0
- package/dist/hosted-scan.js +260 -0
- package/dist/hosted-scan.js.map +1 -0
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +48 -38
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +11 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/knowledge-base.d.ts +7 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +114 -46
- package/dist/knowledge-base.js.map +1 -1
- package/dist/linear.d.ts.map +1 -1
- package/dist/linear.js +2 -7
- package/dist/linear.js.map +1 -1
- package/dist/mock-scan.d.ts.map +1 -1
- package/dist/mock-scan.js +0 -1
- package/dist/mock-scan.js.map +1 -1
- package/dist/models.d.ts +0 -2
- package/dist/models.d.ts.map +1 -1
- package/dist/models.js.map +1 -1
- package/dist/multiscan.d.ts +9 -3
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +240 -135
- package/dist/multiscan.js.map +1 -1
- package/dist/owner-evidence.d.ts +10 -2
- package/dist/owner-evidence.d.ts.map +1 -1
- package/dist/owner-evidence.js +67 -8
- package/dist/owner-evidence.js.map +1 -1
- package/dist/patch-tui.d.ts.map +1 -1
- package/dist/patch-tui.js +3 -2
- package/dist/patch-tui.js.map +1 -1
- package/dist/project-config.js +3 -3
- package/dist/project-config.js.map +1 -1
- package/dist/provider-profile.d.ts +21 -0
- package/dist/provider-profile.d.ts.map +1 -0
- package/dist/provider-profile.js +133 -0
- package/dist/provider-profile.js.map +1 -0
- package/dist/publication-events.d.ts +6 -8
- package/dist/publication-events.d.ts.map +1 -1
- package/dist/publication-events.js +25 -50
- package/dist/publication-events.js.map +1 -1
- package/dist/publication-store.d.ts.map +1 -1
- package/dist/publication-store.js +95 -109
- package/dist/publication-store.js.map +1 -1
- package/dist/publication.d.ts +1 -4
- package/dist/publication.d.ts.map +1 -1
- package/dist/publication.js +2 -13
- package/dist/publication.js.map +1 -1
- package/dist/publish.d.ts +1 -5
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +109 -160
- package/dist/publish.js.map +1 -1
- package/dist/request-metadata.d.ts +9 -0
- package/dist/request-metadata.d.ts.map +1 -0
- package/dist/request-metadata.js +13 -0
- package/dist/request-metadata.js.map +1 -0
- package/dist/runtime.d.ts +20 -6
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +407 -148
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +14 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -0
- package/dist/saved-scan-bootstrap.js +261 -0
- package/dist/saved-scan-bootstrap.js.map +1 -0
- package/dist/saved-scan.d.ts +1 -1
- package/dist/saved-scan.d.ts.map +1 -1
- package/dist/saved-scan.js +6 -12
- package/dist/saved-scan.js.map +1 -1
- package/dist/scan-activity.js +11 -8
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +28 -15
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +276 -281
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +3 -0
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +345 -77
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts +104 -0
- package/dist/scan-executor.d.ts.map +1 -0
- package/dist/scan-executor.js +62 -0
- package/dist/scan-executor.js.map +1 -0
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +54 -13
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-inputs.d.ts +6 -0
- package/dist/scan-inputs.d.ts.map +1 -0
- package/dist/scan-inputs.js +71 -0
- package/dist/scan-inputs.js.map +1 -0
- package/dist/scan-logs.d.ts +2 -3
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +12 -6
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-sessions.d.ts +4 -0
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +17 -0
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-skill-paths.d.ts +8 -0
- package/dist/scan-skill-paths.d.ts.map +1 -0
- package/dist/scan-skill-paths.js +47 -0
- package/dist/scan-skill-paths.js.map +1 -0
- package/dist/security-policy-cli.d.ts.map +1 -1
- package/dist/security-policy-cli.js +7 -27
- package/dist/security-policy-cli.js.map +1 -1
- package/dist/security-policy.d.ts +9 -5
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js +33 -14
- package/dist/security-policy.js.map +1 -1
- package/dist/server/api.d.ts +0 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js +0 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embeddings.d.ts +3 -1
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +10 -3
- package/dist/server/embeddings.js.map +1 -1
- package/dist/server/errors.d.ts +5 -2
- package/dist/server/errors.d.ts.map +1 -1
- package/dist/server/errors.js +7 -0
- package/dist/server/errors.js.map +1 -1
- package/dist/server/sqlite-store.d.ts +0 -2
- package/dist/server/sqlite-store.d.ts.map +1 -1
- package/dist/server/sqlite-store.js +54 -44
- package/dist/server/sqlite-store.js.map +1 -1
- package/dist/server/storage.d.ts +0 -2
- package/dist/server/storage.d.ts.map +1 -1
- package/dist/server/storage.js.map +1 -1
- package/dist/severity-store.js +19 -24
- package/dist/severity-store.js.map +1 -1
- package/dist/standalone-validation-prompt.d.ts +2 -0
- package/dist/standalone-validation-prompt.d.ts.map +1 -0
- package/dist/standalone-validation-prompt.js +10 -0
- package/dist/standalone-validation-prompt.js.map +1 -0
- package/dist/suggest-owners.d.ts +4 -2
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +11 -5
- package/dist/suggest-owners.js.map +1 -1
- package/dist/targets.d.ts +11 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +123 -72
- package/dist/targets.js.map +1 -1
- package/dist/trusted-executable.d.ts +2 -2
- package/dist/trusted-executable.d.ts.map +1 -1
- package/dist/trusted-executable.js +8 -6
- package/dist/trusted-executable.js.map +1 -1
- package/dist/value.js +7 -0
- package/dist/value.js.map +1 -1
- package/dist/version.js.map +1 -1
- package/dist/workbench-arguments.d.ts +3 -0
- package/dist/workbench-arguments.d.ts.map +1 -0
- package/dist/workbench-arguments.js +15 -0
- package/dist/workbench-arguments.js.map +1 -0
- package/dist/worker-progress.d.ts +44 -11
- package/dist/worker-progress.d.ts.map +1 -1
- package/dist/worker-progress.js +48 -49
- package/dist/worker-progress.js.map +1 -1
- package/docs/cli.md +1788 -0
- package/docs/findings-service.md +402 -0
- package/docs/hosted-scans.md +242 -0
- package/package.json +23 -22
- package/schemas/hosted-scan-v2.fixture.json +145 -0
- package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
- package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
- package/_bundled_plugin/scripts/workbench_findings.py +0 -221
- package/_bundled_plugin/scripts/workbench_severity.py +0 -122
- package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
- package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
- package/dist/server/dashboard/app.css +0 -2
- package/dist/server/dashboard/app.js +0 -66
- package/dist/server/dashboard/index.html +0 -18
- package/dist/server/dashboard-types.d.ts +0 -48
- package/dist/server/dashboard-types.d.ts.map +0 -1
- package/dist/server/dashboard-types.js +0 -2
- package/dist/server/dashboard-types.js.map +0 -1
- package/dist/server/dashboard.d.ts +0 -6
- package/dist/server/dashboard.d.ts.map +0 -1
- package/dist/server/dashboard.js +0 -59
- package/dist/server/dashboard.js.map +0 -1
- package/dist/server/index.d.ts +0 -2
- package/dist/server/index.d.ts.map +0 -1
- package/dist/server/index.js +0 -6
- package/dist/server/index.js.map +0 -1
- package/dist/server/routes.d.ts +0 -7
- package/dist/server/routes.d.ts.map +0 -1
- package/dist/server/routes.js +0 -98
- package/dist/server/routes.js.map +0 -1
- package/dist/server/serve.d.ts +0 -2
- package/dist/server/serve.d.ts.map +0 -1
- package/dist/server/serve.js +0 -28
- package/dist/server/serve.js.map +0 -1
- package/dist/server/server.d.ts +0 -10
- package/dist/server/server.d.ts.map +0 -1
- package/dist/server/server.js +0 -16
- package/dist/server/server.js.map +0 -1
- package/dist/server/validation.d.ts +0 -17
- package/dist/server/validation.d.ts.map +0 -1
- package/dist/server/validation.js +0 -53
- package/dist/server/validation.js.map +0 -1
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
"""Validate, record, and export findings from
|
|
1
|
+
"""Validate, record, and export findings from sealed scans."""
|
|
2
2
|
|
|
3
3
|
from __future__ import annotations
|
|
4
4
|
|
|
5
5
|
import argparse
|
|
6
6
|
import csv
|
|
7
7
|
import io
|
|
8
|
+
import json
|
|
8
9
|
import os
|
|
9
10
|
import sqlite3
|
|
10
11
|
import sys
|
|
@@ -17,6 +18,7 @@ from urllib.parse import quote
|
|
|
17
18
|
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
|
18
19
|
from finalize_scan_contract import (
|
|
19
20
|
ContractError,
|
|
21
|
+
SealedArtifactError,
|
|
20
22
|
build_threat_model_export,
|
|
21
23
|
csv_cell,
|
|
22
24
|
finalize_scan,
|
|
@@ -24,92 +26,51 @@ from finalize_scan_contract import (
|
|
|
24
26
|
finding_csv_columns,
|
|
25
27
|
write_export_output,
|
|
26
28
|
write_sarif_projection,
|
|
27
|
-
write_scan_local_bytes,
|
|
28
29
|
)
|
|
30
|
+
from validate_scan_contract import validate_contract
|
|
29
31
|
|
|
30
32
|
|
|
31
|
-
def
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
destination
|
|
47
|
-
|
|
48
|
-
if not isinstance(
|
|
49
|
-
raise SystemExit("
|
|
50
|
-
|
|
51
|
-
not isinstance(destination, dict)
|
|
52
|
-
or not {"type", "teamId"}.issubset(destination)
|
|
53
|
-
or not set(destination).issubset({"type", "teamId", "projectId"})
|
|
54
|
-
or destination.get("type") != "linear"
|
|
55
|
-
or not isinstance(destination.get("teamId"), str)
|
|
56
|
-
or not destination["teamId"].strip()
|
|
57
|
-
or (
|
|
58
|
-
"projectId" in destination
|
|
59
|
-
and (
|
|
60
|
-
not isinstance(destination["projectId"], str)
|
|
61
|
-
or not destination["projectId"].strip()
|
|
62
|
-
)
|
|
63
|
-
)
|
|
64
|
-
):
|
|
65
|
-
raise SystemExit(
|
|
66
|
-
"Linear publication input must identify the exact team and optional project."
|
|
67
|
-
)
|
|
68
|
-
if not isinstance(findings, list):
|
|
69
|
-
raise SystemExit("Linear publication input must include the planned scan findings.")
|
|
70
|
-
|
|
71
|
-
seen_finding_ids: set[str] = set()
|
|
72
|
-
seen_occurrence_ids: set[str] = set()
|
|
73
|
-
for finding in findings:
|
|
74
|
-
if (
|
|
75
|
-
not isinstance(finding, dict)
|
|
76
|
-
or set(finding) != {"findingId", "occurrenceId"}
|
|
77
|
-
or not isinstance(finding.get("findingId"), str)
|
|
78
|
-
or not finding["findingId"].strip()
|
|
79
|
-
or not isinstance(finding.get("occurrenceId"), str)
|
|
80
|
-
or not finding["occurrenceId"].strip()
|
|
81
|
-
):
|
|
82
|
-
raise SystemExit("Linear publication input contains an invalid finding identity.")
|
|
83
|
-
if (
|
|
84
|
-
finding["findingId"] in seen_finding_ids
|
|
85
|
-
or finding["occurrenceId"] in seen_occurrence_ids
|
|
86
|
-
):
|
|
87
|
-
raise SystemExit("Linear publication input repeats a finding or occurrence.")
|
|
88
|
-
seen_finding_ids.add(finding["findingId"])
|
|
89
|
-
seen_occurrence_ids.add(finding["occurrenceId"])
|
|
90
|
-
|
|
91
|
-
return payload, destination, findings
|
|
33
|
+
def destination_key(destination: Any) -> str:
|
|
34
|
+
if not isinstance(destination, dict):
|
|
35
|
+
raise SystemExit("Finding issues require an exact tracker destination.")
|
|
36
|
+
kind = destination.get("type")
|
|
37
|
+
if kind == "linear":
|
|
38
|
+
required, optional = {"type", "teamId"}, {"projectId"}
|
|
39
|
+
parts = [kind, destination.get("teamId"), destination.get("projectId")]
|
|
40
|
+
elif kind == "jira":
|
|
41
|
+
required, optional = {"type", "cloudId", "projectId"}, set()
|
|
42
|
+
parts = [kind, destination.get("cloudId"), destination.get("projectId")]
|
|
43
|
+
elif kind in {"github-issue", "github-advisory"}:
|
|
44
|
+
required, optional = {"type", "hostname", "repository"}, set()
|
|
45
|
+
parts = [kind, destination.get("hostname"), destination.get("repository")]
|
|
46
|
+
else:
|
|
47
|
+
raise SystemExit("Unsupported finding issue destination.")
|
|
48
|
+
if not required.issubset(destination) or not set(destination).issubset(required | optional):
|
|
49
|
+
raise SystemExit("Finding issues require the exact provider destination fields.")
|
|
50
|
+
if any(not isinstance(value, str) or not value.strip() for value in destination.values()):
|
|
51
|
+
raise SystemExit("Finding issue destination fields must be nonempty strings.")
|
|
52
|
+
return json.dumps(parts, ensure_ascii=False, separators=(",", ":"))
|
|
92
53
|
|
|
93
54
|
|
|
94
|
-
def
|
|
55
|
+
def verify_publication_history(
|
|
95
56
|
db: Any,
|
|
96
57
|
connection: sqlite3.Connection,
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
58
|
+
scan_id: str,
|
|
59
|
+
scan_directory: str,
|
|
60
|
+
findings: list[dict[str, Any]],
|
|
61
|
+
) -> None:
|
|
100
62
|
try:
|
|
101
|
-
scan = db.require_scan(connection,
|
|
63
|
+
scan = db.require_scan(connection, scan_id)
|
|
102
64
|
except SystemExit as exc:
|
|
103
65
|
raise SystemExit(
|
|
104
66
|
"The completed scan is not present in the local Codex Security scan-history database. "
|
|
105
67
|
"Use the state directory where the scan was completed."
|
|
106
68
|
) from exc
|
|
107
|
-
if scan["id"] !=
|
|
108
|
-
raise SystemExit("
|
|
69
|
+
if scan["id"] != scan_id:
|
|
70
|
+
raise SystemExit("Publication must use the exact completed scan identifier.")
|
|
109
71
|
if scan["status"] != "complete":
|
|
110
72
|
raise SystemExit("Only completed scans can publish findings to Linear.")
|
|
111
|
-
|
|
112
|
-
requested_directory = db.require_canonical_scan_directory(Path(payload["scanDirectory"]))
|
|
73
|
+
requested_directory = db.require_canonical_scan_directory(Path(scan_directory))
|
|
113
74
|
recorded_directory = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
|
|
114
75
|
if os.path.normcase(requested_directory) != os.path.normcase(recorded_directory):
|
|
115
76
|
raise SystemExit(
|
|
@@ -117,219 +78,217 @@ def verify_linear_publication_scan(
|
|
|
117
78
|
)
|
|
118
79
|
if "seal_manifest_digest" in scan.keys():
|
|
119
80
|
db.require_recorded_manifest_digest(scan, recorded_directory)
|
|
120
|
-
|
|
121
81
|
stored_findings = {
|
|
122
82
|
row["id"]: row["finding_id"]
|
|
123
83
|
for row in connection.execute(
|
|
124
|
-
"SELECT id, finding_id FROM finding_occurrences WHERE scan_id = ?",
|
|
125
|
-
(scan["id"],),
|
|
84
|
+
"SELECT id, finding_id FROM finding_occurrences WHERE scan_id = ?", (scan_id,)
|
|
126
85
|
)
|
|
127
86
|
}
|
|
128
|
-
for finding in findings
|
|
129
|
-
|
|
130
|
-
raise SystemExit(
|
|
131
|
-
"A selected finding or occurrence does not belong to the completed scan "
|
|
132
|
-
"in local Codex Security scan history."
|
|
133
|
-
)
|
|
134
|
-
if len(stored_findings) != len(findings):
|
|
87
|
+
expected = {finding["occurrenceId"]: finding["findingId"] for finding in findings}
|
|
88
|
+
if stored_findings != expected:
|
|
135
89
|
raise SystemExit(
|
|
136
90
|
"The completed scan findings do not exactly match local Codex Security scan history."
|
|
137
91
|
)
|
|
138
|
-
return scan
|
|
139
92
|
|
|
140
93
|
|
|
141
|
-
def
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
recorded: dict[str, dict[str, str]] = {}
|
|
152
|
-
if connection.execute(
|
|
153
|
-
"SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'finding_publications'"
|
|
154
|
-
).fetchone():
|
|
155
|
-
for row in connection.execute(
|
|
156
|
-
"""
|
|
157
|
-
SELECT finding_id, occurrence_id, external_id, external_url
|
|
158
|
-
FROM finding_publications
|
|
159
|
-
WHERE scan_id = ? AND destination_type = ? AND team_id = ? AND project_id IS ?
|
|
160
|
-
ORDER BY created_at, external_id
|
|
161
|
-
""",
|
|
162
|
-
(
|
|
163
|
-
scan["id"],
|
|
164
|
-
destination["type"],
|
|
165
|
-
destination["teamId"],
|
|
166
|
-
destination.get("projectId"),
|
|
167
|
-
),
|
|
168
|
-
):
|
|
169
|
-
recorded.setdefault(
|
|
170
|
-
row["occurrence_id"],
|
|
171
|
-
{
|
|
172
|
-
"findingId": row["finding_id"],
|
|
173
|
-
"occurrenceId": row["occurrence_id"],
|
|
174
|
-
"issueIdentifier": row["external_id"],
|
|
175
|
-
**({"url": row["external_url"]} if row["external_url"] is not None else {}),
|
|
176
|
-
},
|
|
177
|
-
)
|
|
178
|
-
return {
|
|
179
|
-
"scanId": scan["id"],
|
|
180
|
-
"destination": destination,
|
|
181
|
-
"findingCount": len(findings),
|
|
182
|
-
"recorded": [
|
|
183
|
-
recorded[finding["occurrenceId"]]
|
|
184
|
-
for finding in findings
|
|
185
|
-
if finding["occurrenceId"] in recorded
|
|
186
|
-
],
|
|
187
|
-
}
|
|
94
|
+
def issue_receipt(row: sqlite3.Row) -> dict[str, Any]:
|
|
95
|
+
return {
|
|
96
|
+
"scanId": row["scan_id"],
|
|
97
|
+
"findingId": row["finding_id"],
|
|
98
|
+
"occurrenceId": row["occurrence_id"],
|
|
99
|
+
"issueIdentifier": row["external_id"],
|
|
100
|
+
"operation": row["operation"],
|
|
101
|
+
**({"url": row["external_url"]} if row["external_url"] is not None else {}),
|
|
102
|
+
**({"readback": json.loads(row["readback_json"])} if row["readback_json"] else {}),
|
|
103
|
+
}
|
|
188
104
|
|
|
189
105
|
|
|
190
|
-
def
|
|
191
|
-
db: Any,
|
|
106
|
+
def inspect_issue_receipts(
|
|
192
107
|
connection: sqlite3.Connection,
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
108
|
+
destination: dict[str, str],
|
|
109
|
+
key: str,
|
|
110
|
+
finding_ids: list[str],
|
|
111
|
+
) -> list[dict[str, Any]]:
|
|
112
|
+
tables = {
|
|
113
|
+
row[0] for row in connection.execute("SELECT name FROM sqlite_master WHERE type = 'table'")
|
|
114
|
+
}
|
|
115
|
+
selection = json.dumps(finding_ids)
|
|
116
|
+
if "finding_issue_receipts" in tables:
|
|
117
|
+
rows = connection.execute(
|
|
118
|
+
"SELECT * FROM finding_issue_receipts WHERE destination_key = ? "
|
|
119
|
+
"AND finding_id IN (SELECT value FROM json_each(?)) ORDER BY id",
|
|
120
|
+
(key, selection),
|
|
121
|
+
)
|
|
122
|
+
elif "finding_publications" in tables and destination["type"] == "linear":
|
|
123
|
+
rows = connection.execute(
|
|
124
|
+
"SELECT *, 'create' AS operation, NULL AS readback_json FROM finding_publications "
|
|
125
|
+
"WHERE destination_type = 'linear' AND team_id = ? AND project_id IS ? "
|
|
126
|
+
"AND finding_id IN (SELECT value FROM json_each(?)) ORDER BY id",
|
|
127
|
+
(destination["teamId"], destination.get("projectId"), selection),
|
|
128
|
+
)
|
|
129
|
+
else:
|
|
130
|
+
return []
|
|
131
|
+
return [issue_receipt(row) for row in rows]
|
|
205
132
|
|
|
206
133
|
|
|
207
|
-
def
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
planned = {finding["findingId"]: finding["occurrenceId"] for finding in findings}
|
|
217
|
-
current: dict[str, dict[str, str]] = {}
|
|
218
|
-
external_ids: set[str] = set()
|
|
219
|
-
for publication in publications:
|
|
220
|
-
if (
|
|
221
|
-
not isinstance(publication, dict)
|
|
222
|
-
or not {"findingId", "occurrenceId", "issueIdentifier"}.issubset(publication)
|
|
223
|
-
or not set(publication).issubset(
|
|
224
|
-
{"findingId", "occurrenceId", "issueIdentifier", "url"}
|
|
225
|
-
)
|
|
226
|
-
or not isinstance(publication.get("findingId"), str)
|
|
227
|
-
or not isinstance(publication.get("occurrenceId"), str)
|
|
228
|
-
or not isinstance(publication.get("issueIdentifier"), str)
|
|
229
|
-
or not publication["issueIdentifier"].strip()
|
|
230
|
-
or (
|
|
231
|
-
"url" in publication
|
|
232
|
-
and (not isinstance(publication["url"], str) or not publication["url"].strip())
|
|
233
|
-
)
|
|
134
|
+
def validate_issue_receipts(receipts: Any, selected: dict[str, str]) -> list[dict[str, Any]]:
|
|
135
|
+
if not isinstance(receipts, list):
|
|
136
|
+
raise SystemExit("Finding issue receipts must be an array.")
|
|
137
|
+
for receipt in receipts:
|
|
138
|
+
if not isinstance(receipt, dict):
|
|
139
|
+
raise SystemExit("Each finding issue receipt must be an object.")
|
|
140
|
+
if any(
|
|
141
|
+
not isinstance(receipt.get(field), str) or not receipt[field].strip()
|
|
142
|
+
for field in ("findingId", "occurrenceId", "issueIdentifier")
|
|
234
143
|
):
|
|
235
|
-
raise SystemExit("
|
|
236
|
-
|
|
237
|
-
issue_identifier = publication["issueIdentifier"]
|
|
238
|
-
if planned.get(finding_id) != publication["occurrenceId"]:
|
|
144
|
+
raise SystemExit("A finding issue receipt is missing its source or issue identity.")
|
|
145
|
+
if selected.get(receipt["findingId"]) != receipt["occurrenceId"]:
|
|
239
146
|
raise SystemExit(
|
|
240
|
-
"A
|
|
147
|
+
"A finding issue receipt does not belong to the selected sealed findings."
|
|
241
148
|
)
|
|
242
|
-
if
|
|
243
|
-
raise SystemExit("
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
with connection:
|
|
249
|
-
scan = verify_linear_publication_scan(db, connection, payload, findings)
|
|
250
|
-
timestamp = db.now()
|
|
251
|
-
for publication in publications:
|
|
252
|
-
conflicting = connection.execute(
|
|
253
|
-
"""
|
|
254
|
-
SELECT occurrence_id, external_url
|
|
255
|
-
FROM finding_publications
|
|
256
|
-
WHERE destination_type = ? AND team_id = ? AND project_id IS ?
|
|
257
|
-
AND external_id = ?
|
|
258
|
-
""",
|
|
259
|
-
(
|
|
260
|
-
destination["type"],
|
|
261
|
-
destination["teamId"],
|
|
262
|
-
destination.get("projectId"),
|
|
263
|
-
publication["issueIdentifier"],
|
|
264
|
-
),
|
|
265
|
-
).fetchone()
|
|
266
|
-
if (
|
|
267
|
-
conflicting is not None
|
|
268
|
-
and conflicting["occurrence_id"] != publication["occurrenceId"]
|
|
269
|
-
):
|
|
270
|
-
raise SystemExit(
|
|
271
|
-
"This Linear issue is already associated with a different finding."
|
|
272
|
-
)
|
|
149
|
+
if receipt.get("operation") not in {"create", "update", "reuse"}:
|
|
150
|
+
raise SystemExit("A finding issue receipt requires create, update, or reuse.")
|
|
151
|
+
if "url" in receipt and (not isinstance(receipt["url"], str) or not receipt["url"].strip()):
|
|
152
|
+
raise SystemExit("A finding issue URL must be a nonempty string when supplied.")
|
|
153
|
+
if "readback" in receipt:
|
|
154
|
+
readback = receipt["readback"]
|
|
273
155
|
if (
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
156
|
+
not isinstance(readback, dict)
|
|
157
|
+
or readback.get("status") not in {"verified", "failed"}
|
|
158
|
+
or ("error" in readback and not isinstance(readback["error"], str))
|
|
277
159
|
):
|
|
278
|
-
raise SystemExit("
|
|
160
|
+
raise SystemExit("A finding issue readback requires verified or failed status.")
|
|
161
|
+
return receipts
|
|
279
162
|
|
|
280
|
-
connection.execute(
|
|
281
|
-
"""
|
|
282
|
-
INSERT INTO finding_publications (
|
|
283
|
-
scan_id, finding_id, occurrence_id, destination_type,
|
|
284
|
-
team_id, project_id, external_id, external_url, created_at
|
|
285
|
-
) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
|
|
286
|
-
ON CONFLICT DO NOTHING
|
|
287
|
-
""",
|
|
288
|
-
(
|
|
289
|
-
scan["id"],
|
|
290
|
-
publication["findingId"],
|
|
291
|
-
publication["occurrenceId"],
|
|
292
|
-
destination["type"],
|
|
293
|
-
destination["teamId"],
|
|
294
|
-
destination.get("projectId"),
|
|
295
|
-
publication["issueIdentifier"],
|
|
296
|
-
publication.get("url"),
|
|
297
|
-
timestamp,
|
|
298
|
-
),
|
|
299
|
-
)
|
|
300
163
|
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
164
|
+
def finding_issues(db: Any, payload: Any) -> dict[str, Any]:
|
|
165
|
+
if not isinstance(payload, dict) or payload.get("action") not in {
|
|
166
|
+
"inspect",
|
|
167
|
+
"prepare",
|
|
168
|
+
"record",
|
|
169
|
+
}:
|
|
170
|
+
raise SystemExit("Finding issues require inspect, prepare, or record action.")
|
|
171
|
+
if not isinstance(payload.get("scanDirectory"), str):
|
|
172
|
+
raise SystemExit("Finding issues require a sealed scan directory.")
|
|
173
|
+
require_history = payload.get("requireHistory", False)
|
|
174
|
+
if not isinstance(require_history, bool):
|
|
175
|
+
raise SystemExit("requireHistory must be a boolean.")
|
|
176
|
+
key = destination_key(payload.get("destination"))
|
|
177
|
+
try:
|
|
178
|
+
validated = validate_contract(Path(payload["scanDirectory"]))
|
|
179
|
+
except (OSError, ValueError, RecursionError) as exc:
|
|
180
|
+
raise SystemExit(f"Finding issue source validation failed: {exc}") from exc
|
|
181
|
+
scan_id = validated["manifest"]["scan"]["id"]
|
|
182
|
+
if "expectedScanId" in payload and payload["expectedScanId"] != scan_id:
|
|
183
|
+
raise SystemExit("Scan artifacts do not match the selected scan identifier.")
|
|
184
|
+
findings = validated["findings"]["findings"]
|
|
185
|
+
available = {finding["findingId"]: finding["occurrenceId"] for finding in findings}
|
|
186
|
+
finding_ids = payload.get("findingIds", list(available))
|
|
187
|
+
if not isinstance(finding_ids, list) or any(
|
|
188
|
+
not isinstance(finding_id, str) or finding_id not in available for finding_id in finding_ids
|
|
189
|
+
):
|
|
190
|
+
raise SystemExit("Selected finding IDs must belong to the sealed scan.")
|
|
191
|
+
selected = {finding_id: available[finding_id] for finding_id in finding_ids}
|
|
192
|
+
receipts = (
|
|
193
|
+
validate_issue_receipts(payload.get("receipts"), selected)
|
|
194
|
+
if payload["action"] == "record"
|
|
195
|
+
else []
|
|
196
|
+
)
|
|
197
|
+
result = {
|
|
198
|
+
"scanId": scan_id,
|
|
199
|
+
"destination": payload["destination"],
|
|
200
|
+
"findingCount": len(selected),
|
|
201
|
+
"storeExists": True,
|
|
202
|
+
"receipts": [],
|
|
203
|
+
}
|
|
204
|
+
path = db.database_path()
|
|
205
|
+
if payload["action"] == "inspect" or require_history:
|
|
206
|
+
try:
|
|
207
|
+
path.stat()
|
|
208
|
+
except FileNotFoundError:
|
|
209
|
+
if require_history:
|
|
210
|
+
raise SystemExit(
|
|
211
|
+
"Cannot publish findings because the local Codex Security scan-history database "
|
|
212
|
+
"does not exist. Use the state directory where this scan was completed."
|
|
213
|
+
) from None
|
|
214
|
+
result["storeExists"] = False
|
|
215
|
+
return result
|
|
216
|
+
except PermissionError:
|
|
217
|
+
pass # Let SQLite report the open failure used by the host's state fallback.
|
|
218
|
+
if payload["action"] == "inspect":
|
|
219
|
+
database_uri = f"file:{quote(str(path), safe='')}?mode=ro"
|
|
220
|
+
try:
|
|
221
|
+
connection = sqlite3.connect(database_uri, uri=True, timeout=5)
|
|
222
|
+
except sqlite3.OperationalError as exc:
|
|
223
|
+
if str(exc) == "unable to open database file":
|
|
224
|
+
exc._codex_security_state_unavailable = True
|
|
225
|
+
raise
|
|
226
|
+
connection.row_factory = sqlite3.Row
|
|
227
|
+
else:
|
|
228
|
+
connection = db.connect()
|
|
229
|
+
with closing(connection):
|
|
230
|
+
connection.execute("BEGIN" if payload["action"] == "inspect" else "BEGIN IMMEDIATE")
|
|
231
|
+
with connection:
|
|
232
|
+
if require_history:
|
|
233
|
+
verify_publication_history(db, connection, scan_id, validated["scanDir"], findings)
|
|
234
|
+
if payload["action"] == "inspect":
|
|
235
|
+
result["receipts"] = inspect_issue_receipts(
|
|
236
|
+
connection, payload["destination"], key, list(selected)
|
|
237
|
+
)
|
|
238
|
+
elif payload["action"] == "record":
|
|
239
|
+
timestamp = db.now()
|
|
240
|
+
for receipt in receipts:
|
|
241
|
+
conflicting = connection.execute(
|
|
242
|
+
"SELECT 1 FROM finding_issue_receipts "
|
|
243
|
+
"WHERE destination_key = ? AND external_id = ? AND finding_id != ? LIMIT 1",
|
|
244
|
+
(key, receipt["issueIdentifier"], receipt["findingId"]),
|
|
245
|
+
).fetchone()
|
|
246
|
+
if conflicting is not None:
|
|
247
|
+
raise SystemExit(
|
|
248
|
+
"The issue identifier is already associated with another finding "
|
|
249
|
+
"in this destination."
|
|
250
|
+
)
|
|
251
|
+
readback = (
|
|
252
|
+
json.dumps(receipt["readback"], ensure_ascii=False)
|
|
253
|
+
if "readback" in receipt
|
|
254
|
+
else None
|
|
255
|
+
)
|
|
256
|
+
connection.execute(
|
|
257
|
+
"""
|
|
258
|
+
INSERT INTO finding_issue_receipts (
|
|
259
|
+
scan_id, finding_id, occurrence_id, destination_key,
|
|
260
|
+
external_id, external_url, operation, readback_json, created_at, updated_at
|
|
261
|
+
) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
|
|
262
|
+
ON CONFLICT (occurrence_id, destination_key, external_id, operation)
|
|
263
|
+
DO UPDATE SET
|
|
264
|
+
external_url = COALESCE(external_url, excluded.external_url),
|
|
265
|
+
readback_json = COALESCE(excluded.readback_json, readback_json),
|
|
266
|
+
updated_at = excluded.updated_at
|
|
267
|
+
""",
|
|
268
|
+
(
|
|
269
|
+
scan_id,
|
|
270
|
+
receipt["findingId"],
|
|
271
|
+
receipt["occurrenceId"],
|
|
272
|
+
key,
|
|
273
|
+
receipt["issueIdentifier"],
|
|
274
|
+
receipt.get("url"),
|
|
275
|
+
receipt["operation"],
|
|
276
|
+
readback,
|
|
277
|
+
timestamp,
|
|
278
|
+
timestamp,
|
|
279
|
+
),
|
|
280
|
+
)
|
|
281
|
+
row = connection.execute(
|
|
282
|
+
"SELECT * FROM finding_issue_receipts WHERE occurrence_id = ? "
|
|
283
|
+
"AND destination_key = ? AND external_id = ? AND operation = ?",
|
|
284
|
+
(
|
|
285
|
+
receipt["occurrenceId"],
|
|
286
|
+
key,
|
|
287
|
+
receipt["issueIdentifier"],
|
|
288
|
+
receipt["operation"],
|
|
289
|
+
),
|
|
290
|
+
).fetchone()
|
|
291
|
+
result["receipts"].append(issue_receipt(row))
|
|
333
292
|
return result
|
|
334
293
|
|
|
335
294
|
|
|
@@ -423,41 +382,27 @@ def write_csv_export(
|
|
|
423
382
|
candidate_id = finding_candidate_id(finding)
|
|
424
383
|
if isinstance(occurrence_id, str) and isinstance(candidate_id, str):
|
|
425
384
|
candidate_ids_by_occurrence[occurrence_id] = candidate_id
|
|
426
|
-
|
|
385
|
+
columns = finding_csv_columns(deep_scan)
|
|
386
|
+
writer.writerow(columns)
|
|
427
387
|
for row in finding_export_rows(connection, scan["id"]):
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
(csv_cell(candidate_ids_by_occurrence.get(row["occurrence_id"])),)
|
|
434
|
-
if deep_scan
|
|
435
|
-
else ()
|
|
436
|
-
),
|
|
437
|
-
csv_cell(row["title"]),
|
|
438
|
-
csv_cell(row["summary"]),
|
|
439
|
-
csv_cell(row["severity"]),
|
|
440
|
-
csv_cell(row["confidence"]),
|
|
441
|
-
csv_cell(row["status"]),
|
|
442
|
-
csv_cell(row["close_reason"]),
|
|
443
|
-
csv_cell(row["note"]),
|
|
444
|
-
csv_cell(row["remediation"]),
|
|
445
|
-
csv_cell(row["relative_path"]),
|
|
446
|
-
row["start_line"],
|
|
447
|
-
row["end_line"],
|
|
448
|
-
)
|
|
449
|
-
)
|
|
388
|
+
values = dict(row)
|
|
389
|
+
values["path"] = row["relative_path"]
|
|
390
|
+
values["candidate_id"] = candidate_ids_by_occurrence.get(row["occurrence_id"])
|
|
391
|
+
writer.writerow(csv_cell(values[column]) for column in columns)
|
|
392
|
+
destination = scan_dir / "exports" / "findings.csv"
|
|
450
393
|
try:
|
|
451
|
-
|
|
394
|
+
write_export_output(
|
|
452
395
|
scan_dir,
|
|
453
|
-
|
|
396
|
+
destination,
|
|
397
|
+
"csv",
|
|
454
398
|
output.getvalue().encode("utf-8"),
|
|
455
399
|
)
|
|
400
|
+
except SealedArtifactError as exc:
|
|
401
|
+
raise SystemExit(str(exc)) from exc
|
|
456
402
|
except ContractError as exc:
|
|
457
403
|
raise SystemExit(
|
|
458
404
|
"exports: expected a regular directory inside the scan directory."
|
|
459
405
|
) from exc
|
|
460
|
-
destination = scan_dir / "exports" / "findings.csv"
|
|
461
406
|
path = db.available_artifact_path(scan_dir, destination)
|
|
462
407
|
if path is None:
|
|
463
408
|
raise SystemExit("findings.csv: expected a regular file inside the scan directory.")
|
|
@@ -34,6 +34,18 @@ def require_available(connection: sqlite3.Connection, args: Any, require_scan: A
|
|
|
34
34
|
raise SystemExit(SCAN_STATUS_ERROR)
|
|
35
35
|
|
|
36
36
|
|
|
37
|
+
def require_request(
|
|
38
|
+
connection: sqlite3.Connection, request_id: str, occurrence: sqlite3.Row
|
|
39
|
+
) -> sqlite3.Row:
|
|
40
|
+
current = connection.execute(
|
|
41
|
+
"SELECT * FROM finding_remediation_attempts WHERE request_id = ?",
|
|
42
|
+
(request_id,),
|
|
43
|
+
).fetchone()
|
|
44
|
+
if current is None or current["occurrence_id"] != occurrence["id"]:
|
|
45
|
+
raise SystemExit("Codex Security finding remediation request not found.")
|
|
46
|
+
return current
|
|
47
|
+
|
|
48
|
+
|
|
37
49
|
def remediation_claim_is_active(remediation: sqlite3.Row) -> bool:
|
|
38
50
|
if remediation["pending_action_claim_token"] is None:
|
|
39
51
|
return False
|