@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
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
from __future__ import annotations
|
|
5
5
|
|
|
6
6
|
import argparse
|
|
7
|
+
import json
|
|
7
8
|
import re
|
|
8
9
|
from collections import Counter
|
|
9
10
|
from typing import Any
|
|
@@ -28,12 +29,10 @@ class ReportProjectionError(ValueError):
|
|
|
28
29
|
def _text(value: Any, fallback: str) -> str:
|
|
29
30
|
candidate = value if isinstance(value, str) and value.strip() else fallback
|
|
30
31
|
normalized = " ".join(candidate.split())
|
|
31
|
-
if
|
|
32
|
-
return ""
|
|
33
|
-
if re.match(r"^(?:#{1,6}\s|[-*+]\s|>\s|```|\d+\.\s|\|)", normalized):
|
|
32
|
+
if re.match(r"^(?:#{1,6}\s|[-*+]\s|>\s|```|~~~|\d+[.)]\s|\|)", normalized):
|
|
34
33
|
normalized = f"Text: {normalized}"
|
|
35
34
|
return "".join(
|
|
36
|
-
part if index % 2 else re.sub(r"([
|
|
35
|
+
part if index % 2 else re.sub(r"([\\`*_\[\]<>])", r"\\\1", part)
|
|
37
36
|
for index, part in enumerate(re.split(r"((?<!`)`[^`\n]+`(?!`))", normalized))
|
|
38
37
|
)
|
|
39
38
|
|
|
@@ -43,12 +42,21 @@ def _strings(value: Any) -> list[str]:
|
|
|
43
42
|
value = [value]
|
|
44
43
|
if not isinstance(value, list):
|
|
45
44
|
return []
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
45
|
+
return [text for item in value if (text := _text(item, ""))]
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def _path_label(value: str) -> str:
|
|
49
|
+
if "," in value or value != " ".join(value.split()) or any(ord(c) < 32 for c in value):
|
|
50
|
+
return json.dumps(value)
|
|
51
|
+
return value
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
def _path_text(value: str) -> str:
|
|
55
|
+
label = _path_label(value)
|
|
56
|
+
if label != value:
|
|
57
|
+
marker = _code_fence(label, minimum=1)
|
|
58
|
+
return f"{marker}{label}{marker}"
|
|
59
|
+
return re.sub(r"([\\`*_\[\]<>])", r"\\\1", value)
|
|
52
60
|
|
|
53
61
|
|
|
54
62
|
def _cell(value: Any) -> str:
|
|
@@ -96,7 +104,7 @@ def _has_deep_child_metadata(finding: dict[str, Any]) -> bool:
|
|
|
96
104
|
)
|
|
97
105
|
|
|
98
106
|
|
|
99
|
-
def
|
|
107
|
+
def uses_deep_presentation(coverage: dict[str, Any], findings: list[dict[str, Any]]) -> bool:
|
|
100
108
|
if coverage.get("mode") == "deep_repository":
|
|
101
109
|
return True
|
|
102
110
|
if coverage.get("mode") != "scoped_path":
|
|
@@ -218,8 +226,8 @@ def _hardening_portfolio_path(scan: dict[str, Any]) -> str | None:
|
|
|
218
226
|
return portfolio_path
|
|
219
227
|
|
|
220
228
|
|
|
221
|
-
def
|
|
222
|
-
return [f"- {item}" for item in
|
|
229
|
+
def _bullet_section(heading: str, items: list[str]) -> list[str]:
|
|
230
|
+
return ["", heading, *(f"- {item}" for item in items)] if items else []
|
|
223
231
|
|
|
224
232
|
|
|
225
233
|
def _code_evidence_catalog(finding: dict[str, Any]) -> dict[str, dict[str, Any]]:
|
|
@@ -284,8 +292,6 @@ def merged_root_cause(value: dict[str, Any]) -> tuple[str | None, Any]:
|
|
|
284
292
|
details.append({"summary": detail})
|
|
285
293
|
elif isinstance(detail, dict):
|
|
286
294
|
details.append(detail)
|
|
287
|
-
elif detail is not None:
|
|
288
|
-
continue
|
|
289
295
|
if not details:
|
|
290
296
|
return keys[0], None
|
|
291
297
|
|
|
@@ -395,29 +401,32 @@ def _root_cause_code_evidence(
|
|
|
395
401
|
def _code_evidence_location(item: dict[str, Any]) -> str:
|
|
396
402
|
location = item.get("location")
|
|
397
403
|
if isinstance(location, str):
|
|
398
|
-
return location
|
|
404
|
+
return " ".join(location.split())
|
|
399
405
|
if isinstance(location, dict):
|
|
400
406
|
item = location
|
|
401
407
|
path = item.get("path")
|
|
402
408
|
start = item.get("startLine")
|
|
403
|
-
end = item.get("endLine"
|
|
409
|
+
end = item.get("endLine")
|
|
404
410
|
if not isinstance(path, str) or not path:
|
|
405
411
|
return ""
|
|
406
|
-
|
|
412
|
+
path = _path_label(path)
|
|
413
|
+
if not isinstance(start, int) or isinstance(start, bool) or start < 1:
|
|
407
414
|
return path
|
|
408
|
-
|
|
415
|
+
if not isinstance(end, int) or isinstance(end, bool) or end <= start:
|
|
416
|
+
return f"{path}:{start}"
|
|
417
|
+
return f"{path}:{start}-{end}"
|
|
409
418
|
|
|
410
419
|
|
|
411
|
-
def _code_fence(code: str) -> str:
|
|
420
|
+
def _code_fence(code: str, minimum: int = 3) -> str:
|
|
412
421
|
longest_run = max((len(match.group(0)) for match in re.finditer(r"`+", code)), default=0)
|
|
413
|
-
return "`" * max(
|
|
422
|
+
return "`" * max(minimum, longest_run + 1)
|
|
414
423
|
|
|
415
424
|
|
|
416
425
|
def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
|
|
417
426
|
lines: list[str] = []
|
|
418
427
|
for index, item in enumerate(evidence):
|
|
419
428
|
label = _text(item.get("label"), f"Code evidence {index + 1}")
|
|
420
|
-
location =
|
|
429
|
+
location = _code_evidence_location(item)
|
|
421
430
|
explanation = _text(item.get("explanation"), "")
|
|
422
431
|
language = item.get("language") if isinstance(item.get("language"), str) else ""
|
|
423
432
|
language = language if re.fullmatch(r"[A-Za-z0-9_+.-]*", language) else ""
|
|
@@ -425,7 +434,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
|
|
|
425
434
|
fence = _code_fence(code)
|
|
426
435
|
heading = f"**{label}**"
|
|
427
436
|
if location:
|
|
428
|
-
|
|
437
|
+
marker = _code_fence(location, minimum=1)
|
|
438
|
+
padding = " " if location.startswith("`") or location.endswith("`") else ""
|
|
439
|
+
heading += f" — {marker}{padding}{location}{padding}{marker}"
|
|
429
440
|
lines.extend(["", heading])
|
|
430
441
|
if explanation:
|
|
431
442
|
lines.extend(["", explanation])
|
|
@@ -433,22 +444,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
|
|
|
433
444
|
return lines
|
|
434
445
|
|
|
435
446
|
|
|
436
|
-
def
|
|
437
|
-
counts = Counter(finding[
|
|
438
|
-
return (
|
|
439
|
-
", ".join(f"{level}: {counts[level]}" for level in SEVERITY_ORDER if counts[level])
|
|
440
|
-
or "none"
|
|
441
|
-
)
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
def _confidence_mix(findings: list[dict[str, Any]]) -> str:
|
|
445
|
-
counts = Counter(finding["confidence"]["level"] for finding in findings)
|
|
446
|
-
return (
|
|
447
|
-
", ".join(
|
|
448
|
-
f"{level}: {counts[level]}" for level in ("high", "medium", "low") if counts[level]
|
|
449
|
-
)
|
|
450
|
-
or "none"
|
|
451
|
-
)
|
|
447
|
+
def _level_mix(findings: list[dict[str, Any]], field: str, order: dict[str, int]) -> str:
|
|
448
|
+
counts = Counter(finding[field]["level"] for finding in findings)
|
|
449
|
+
return ", ".join(f"{level}: {counts[level]}" for level in order if counts[level]) or "none"
|
|
452
450
|
|
|
453
451
|
|
|
454
452
|
def _locations(finding: dict[str, Any]) -> str:
|
|
@@ -457,7 +455,7 @@ def _locations(finding: dict[str, Any]) -> str:
|
|
|
457
455
|
start = location["startLine"]
|
|
458
456
|
end = location.get("endLine", start)
|
|
459
457
|
suffix = f":{start}" if end == start else f":{start}-{end}"
|
|
460
|
-
rendered.append(f"{location['path']}{suffix}")
|
|
458
|
+
rendered.append(f"{_path_text(location['path'])}{suffix}")
|
|
461
459
|
return ", ".join(rendered)
|
|
462
460
|
|
|
463
461
|
|
|
@@ -500,6 +498,71 @@ def _surface_notes(surface: dict[str, Any]) -> str:
|
|
|
500
498
|
return _cell(f"{notes} Evidence: {evidence}")
|
|
501
499
|
|
|
502
500
|
|
|
501
|
+
def _remediation_section(finding: dict[str, Any]) -> list[str]:
|
|
502
|
+
remediation = _text(finding.get("remediation"), "No canonical remediation was recorded.")
|
|
503
|
+
lines = ["", "#### Remediation", "", remediation]
|
|
504
|
+
seen = {remediation}
|
|
505
|
+
originals: list[tuple[str, dict[str, Any]]] = []
|
|
506
|
+
pending = [("finding", finding)]
|
|
507
|
+
seen_findings: set[int] = set()
|
|
508
|
+
while pending:
|
|
509
|
+
source_id, original = pending.pop()
|
|
510
|
+
if id(original) in seen_findings:
|
|
511
|
+
continue
|
|
512
|
+
seen_findings.add(id(original))
|
|
513
|
+
originals.append((source_id, original))
|
|
514
|
+
provenance = original.get("provenance")
|
|
515
|
+
if not isinstance(provenance, dict):
|
|
516
|
+
continue
|
|
517
|
+
previous = provenance.get("previousFindings")
|
|
518
|
+
if isinstance(previous, list):
|
|
519
|
+
pending.extend(
|
|
520
|
+
(source_id, item) for item in reversed(previous) if isinstance(item, dict)
|
|
521
|
+
)
|
|
522
|
+
sources = provenance.get("sourceFindings")
|
|
523
|
+
if isinstance(sources, list):
|
|
524
|
+
pending.extend(
|
|
525
|
+
(_text(source.get("id"), "finding"), source["finding"])
|
|
526
|
+
for source in reversed(sources)
|
|
527
|
+
if isinstance(source, dict) and isinstance(source.get("finding"), dict)
|
|
528
|
+
)
|
|
529
|
+
for source_id, original in originals[1:]:
|
|
530
|
+
text = _text(original.get("remediation"), "")
|
|
531
|
+
if text and text not in seen:
|
|
532
|
+
seen.add(text)
|
|
533
|
+
lines.extend(["", f"Source {source_id}: {text}"])
|
|
534
|
+
for field, label in (
|
|
535
|
+
("remediationTests", "Tests"),
|
|
536
|
+
("preventiveControls", "Preventive controls"),
|
|
537
|
+
):
|
|
538
|
+
values = list(
|
|
539
|
+
dict.fromkeys(
|
|
540
|
+
value for _, original in originals for value in _strings(original.get(field))
|
|
541
|
+
)
|
|
542
|
+
)
|
|
543
|
+
lines.extend(_bullet_section(f"{label}:", values))
|
|
544
|
+
return lines
|
|
545
|
+
|
|
546
|
+
|
|
547
|
+
def _finding_header(number: int, finding: dict[str, Any]) -> list[str]:
|
|
548
|
+
cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
|
|
549
|
+
title = _text(finding["title"], "Untitled finding")
|
|
550
|
+
return [
|
|
551
|
+
f'<a id="finding-{number}"></a>',
|
|
552
|
+
"",
|
|
553
|
+
f"### [{number}] {title}",
|
|
554
|
+
"",
|
|
555
|
+
"| Field | Value |",
|
|
556
|
+
"| --- | --- |",
|
|
557
|
+
f"| Severity | {_cell(finding['severity']['level'])} |",
|
|
558
|
+
f"| Confidence | {_cell(finding['confidence']['level'])} |",
|
|
559
|
+
f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
|
|
560
|
+
f"| Category | {_cell(finding['taxonomy']['category'])} |",
|
|
561
|
+
f"| CWE | {_cell(cwes)} |",
|
|
562
|
+
"| Affected lines | " + _locations(finding).replace("|", "\\|") + " |",
|
|
563
|
+
]
|
|
564
|
+
|
|
565
|
+
|
|
503
566
|
def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
504
567
|
validation = finding.get("validation") if isinstance(finding.get("validation"), dict) else {}
|
|
505
568
|
_, raw_root_cause = merged_root_cause(finding)
|
|
@@ -562,10 +625,6 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
562
625
|
if validation_outcomes
|
|
563
626
|
else f"{finding['confidence']['rationale']} Validation details were not recorded separately.",
|
|
564
627
|
)
|
|
565
|
-
validation_evidence = _strings(validation.get("evidence"))
|
|
566
|
-
validation_assertions = _strings(validation.get("assertions"))
|
|
567
|
-
validation_counterevidence = _strings(validation.get("counterEvidence"))
|
|
568
|
-
validation_limitations = _strings(validation.get("limitations"))
|
|
569
628
|
root_cause_summary = _text(
|
|
570
629
|
raw_root_cause if isinstance(raw_root_cause, str) else root_cause.get("summary"),
|
|
571
630
|
"",
|
|
@@ -574,16 +633,13 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
574
633
|
validation_code_evidence = _section_code_evidence(finding, validation)
|
|
575
634
|
dataflow_code_evidence = _section_code_evidence(finding, attack_path, *dataflow_sections)
|
|
576
635
|
reachability_code_evidence = _section_code_evidence(finding, reachability)
|
|
577
|
-
dataflow_summary = _text(
|
|
578
|
-
|
|
579
|
-
|
|
636
|
+
dataflow_summary = _text(dataflow.get("summary"), "") or (
|
|
637
|
+
f"The canonical finding records the affected path at {_locations(finding)}, "
|
|
638
|
+
"but no expanded source-to-sink narrative was recorded."
|
|
580
639
|
)
|
|
581
|
-
reachability_summary = _text(
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
attack_path.get("summary"),
|
|
585
|
-
"Reachability was not recorded beyond the canonical finding summary and affected locations.",
|
|
586
|
-
),
|
|
640
|
+
reachability_summary = _text(reachability.get("summary"), "") or _text(
|
|
641
|
+
attack_path.get("summary"),
|
|
642
|
+
"Reachability was not recorded beyond the canonical finding summary and affected locations.",
|
|
587
643
|
)
|
|
588
644
|
severity_rationale = _text(
|
|
589
645
|
severity.get("rationale"),
|
|
@@ -593,24 +649,8 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
593
649
|
severity.get("changeConditions"),
|
|
594
650
|
"Additional runtime or deployment evidence could raise or lower this severity.",
|
|
595
651
|
)
|
|
596
|
-
remediation_tests = _strings(finding.get("remediationTests"))
|
|
597
|
-
preventive_controls = _strings(finding.get("preventiveControls"))
|
|
598
|
-
attack_steps = _strings(attack_path.get("steps"))
|
|
599
|
-
cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
|
|
600
|
-
title = _text(finding["title"], "Untitled finding")
|
|
601
652
|
lines = [
|
|
602
|
-
|
|
603
|
-
"",
|
|
604
|
-
f"### [{number}] {title}",
|
|
605
|
-
"",
|
|
606
|
-
"| Field | Value |",
|
|
607
|
-
"| --- | --- |",
|
|
608
|
-
f"| Severity | {_cell(severity['level'])} |",
|
|
609
|
-
f"| Confidence | {_cell(finding['confidence']['level'])} |",
|
|
610
|
-
f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
|
|
611
|
-
f"| Category | {_cell(finding['taxonomy']['category'])} |",
|
|
612
|
-
f"| CWE | {_cell(cwes)} |",
|
|
613
|
-
f"| Affected lines | {_cell(_locations(finding))} |",
|
|
653
|
+
*_finding_header(number, finding),
|
|
614
654
|
"",
|
|
615
655
|
"#### Summary",
|
|
616
656
|
"",
|
|
@@ -627,29 +667,19 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
627
667
|
if validation_outcomes:
|
|
628
668
|
lines.extend(["", *(f"- **{label}:** {value}" for label, value in validation_outcomes)])
|
|
629
669
|
lines.extend(_code_evidence_lines(validation_code_evidence))
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
"",
|
|
638
|
-
"Counterevidence and remaining uncertainty:",
|
|
639
|
-
*_bullets(validation_counterevidence, "None recorded."),
|
|
640
|
-
]
|
|
641
|
-
)
|
|
642
|
-
if validation_limitations:
|
|
643
|
-
lines.extend(["", "Limitations:", *_bullets(validation_limitations, "None recorded.")])
|
|
670
|
+
for label, key in (
|
|
671
|
+
("Assertions", "assertions"),
|
|
672
|
+
("Evidence", "evidence"),
|
|
673
|
+
("Counterevidence and remaining uncertainty", "counterEvidence"),
|
|
674
|
+
("Limitations", "limitations"),
|
|
675
|
+
):
|
|
676
|
+
lines.extend(_bullet_section(f"{label}:", _strings(validation.get(key))))
|
|
644
677
|
lines.extend(["", "#### Dataflow", "", dataflow_summary])
|
|
645
|
-
|
|
646
|
-
lines.extend(["", "Attack steps:", *_bullets(attack_steps, "None recorded.")])
|
|
678
|
+
lines.extend(_bullet_section("Attack steps:", _strings(attack_path.get("steps"))))
|
|
647
679
|
for label, key in (("Source", "source"), ("Sink", "sink"), ("Outcome", "outcome")):
|
|
648
680
|
if dataflow.get(key):
|
|
649
681
|
lines.extend(["", f"- **{label}:** {_text(dataflow[key], 'not recorded')}"])
|
|
650
|
-
|
|
651
|
-
if transformations:
|
|
652
|
-
lines.extend(["", "Transformations:", *_bullets(transformations, "None recorded.")])
|
|
682
|
+
lines.extend(_bullet_section("Transformations:", _strings(dataflow.get("transformations"))))
|
|
653
683
|
lines.extend(_code_evidence_lines(dataflow_code_evidence))
|
|
654
684
|
lines.extend(["", "#### Reachability", "", reachability_summary])
|
|
655
685
|
for label, key in (
|
|
@@ -669,17 +699,14 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
669
699
|
]
|
|
670
700
|
)
|
|
671
701
|
)
|
|
672
|
-
|
|
673
|
-
lines.extend(["", "Preconditions:", *_bullets(preconditions, "None recorded.")])
|
|
702
|
+
lines.extend(_bullet_section("Preconditions:", preconditions))
|
|
674
703
|
for label, key in (
|
|
675
704
|
("Assumptions", "assumptions"),
|
|
676
705
|
("Existing controls", "controls"),
|
|
677
706
|
("Blind spots", "blindspots"),
|
|
678
707
|
("Limitations", "limitations"),
|
|
679
708
|
):
|
|
680
|
-
|
|
681
|
-
if values:
|
|
682
|
-
lines.extend(["", f"{label}:", *_bullets(values, "None recorded.")])
|
|
709
|
+
lines.extend(_bullet_section(f"{label}:", _strings(attack_path.get(key))))
|
|
683
710
|
lines.extend(_code_evidence_lines(reachability_code_evidence))
|
|
684
711
|
lines.extend(
|
|
685
712
|
[
|
|
@@ -713,41 +740,21 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
713
740
|
lines.extend(
|
|
714
741
|
["", f"{label} assessment:", *(f"- **{name}:** {value}" for name, value in details)]
|
|
715
742
|
)
|
|
716
|
-
lines.extend(
|
|
717
|
-
[
|
|
718
|
-
"",
|
|
719
|
-
"#### Remediation",
|
|
720
|
-
"",
|
|
721
|
-
_text(finding["remediation"], "No canonical remediation was recorded."),
|
|
722
|
-
]
|
|
723
|
-
)
|
|
724
|
-
if remediation_tests:
|
|
725
|
-
lines.extend(["", "Tests:", *_bullets(remediation_tests, "No tests recorded.")])
|
|
726
|
-
if preventive_controls:
|
|
727
|
-
lines.extend(["", "Preventive controls:", *_bullets(preventive_controls, "None recorded.")])
|
|
743
|
+
lines.extend(_remediation_section(finding))
|
|
728
744
|
return lines
|
|
729
745
|
|
|
730
746
|
|
|
731
747
|
def _linked_finding_section(number: int, finding: dict[str, Any], report_path: str) -> list[str]:
|
|
732
|
-
cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
|
|
733
|
-
title = _text(finding["title"], "Untitled finding")
|
|
734
748
|
link = f"[detailed technical write-up]({report_path})"
|
|
735
|
-
lines =
|
|
736
|
-
|
|
737
|
-
"",
|
|
738
|
-
f"### [{number}] {title}",
|
|
739
|
-
"",
|
|
740
|
-
"| Field | Value |",
|
|
741
|
-
"| --- | --- |",
|
|
742
|
-
f"| Severity | {_cell(finding['severity']['level'])} |",
|
|
743
|
-
f"| Confidence | {_cell(finding['confidence']['level'])} |",
|
|
744
|
-
f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
|
|
745
|
-
f"| Category | {_cell(finding['taxonomy']['category'])} |",
|
|
746
|
-
f"| CWE | {_cell(cwes)} |",
|
|
747
|
-
f"| Affected lines | {_cell(_locations(finding))} |",
|
|
748
|
-
]
|
|
749
|
-
for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity", "Remediation"):
|
|
749
|
+
lines = _finding_header(number, finding)
|
|
750
|
+
for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity"):
|
|
750
751
|
lines.extend(["", f"#### {heading}", "", f"See the {link}."])
|
|
752
|
+
if any(
|
|
753
|
+
finding.get("provenance", {}).get(field) for field in ("sourceFindings", "previousFindings")
|
|
754
|
+
):
|
|
755
|
+
lines.extend(_remediation_section(finding))
|
|
756
|
+
else:
|
|
757
|
+
lines.extend(["", "#### Remediation", "", f"See the {link}."])
|
|
751
758
|
return lines
|
|
752
759
|
|
|
753
760
|
|
|
@@ -777,11 +784,15 @@ def build_report_markdown(
|
|
|
777
784
|
"reportable findings have duplicate writeup reportPath values: "
|
|
778
785
|
+ ", ".join(duplicate_writeup_paths)
|
|
779
786
|
)
|
|
780
|
-
deep_presentation =
|
|
787
|
+
deep_presentation = uses_deep_presentation(coverage, findings)
|
|
781
788
|
deep_finding_groups = _deep_finding_groups(findings, writeup_paths) if deep_presentation else []
|
|
782
789
|
hardening_portfolio_path = _hardening_portfolio_path(scan)
|
|
783
|
-
include_paths =
|
|
784
|
-
|
|
790
|
+
include_paths = [
|
|
791
|
+
_path_text(path) for path in coverage.get("includePaths", scope.get("includePaths", []))
|
|
792
|
+
]
|
|
793
|
+
exclude_paths = [
|
|
794
|
+
_path_text(path) for path in coverage.get("excludePaths", scope.get("excludePaths", []))
|
|
795
|
+
]
|
|
785
796
|
limitations = _strings(scope.get("limitations"))
|
|
786
797
|
explicit_exclusions = coverage.get("explicitExclusions", [])
|
|
787
798
|
lines = [
|
|
@@ -812,20 +823,19 @@ def build_report_markdown(
|
|
|
812
823
|
f"Excluded {_text(exclusion.get('pattern'), 'unspecified')}: "
|
|
813
824
|
f"{_text(exclusion.get('reason'), 'reason not recorded')}"
|
|
814
825
|
)
|
|
815
|
-
|
|
816
|
-
lines.extend(["", "Limitations and exclusions:", *_bullets(limitations, "None recorded.")])
|
|
826
|
+
lines.extend(_bullet_section("Limitations and exclusions:", limitations))
|
|
817
827
|
summary_count_lines = (
|
|
818
828
|
[
|
|
819
829
|
f"| Reportable DSS findings | {len(deep_finding_groups)} |",
|
|
820
830
|
f"| Report instances | {len(findings)} |",
|
|
821
|
-
f"| Report severity mix | {
|
|
822
|
-
f"| Report confidence mix | {
|
|
831
|
+
f"| Report severity mix | {_level_mix(findings, 'severity', SEVERITY_ORDER)} |",
|
|
832
|
+
f"| Report confidence mix | {_level_mix(findings, 'confidence', CONFIDENCE_ORDER)} |",
|
|
823
833
|
]
|
|
824
834
|
if deep_presentation
|
|
825
835
|
else [
|
|
826
836
|
f"| Reportable findings | {len(findings)} |",
|
|
827
|
-
f"| Severity mix | {
|
|
828
|
-
f"| Confidence mix | {
|
|
837
|
+
f"| Severity mix | {_level_mix(findings, 'severity', SEVERITY_ORDER)} |",
|
|
838
|
+
f"| Confidence mix | {_level_mix(findings, 'confidence', CONFIDENCE_ORDER)} |",
|
|
829
839
|
]
|
|
830
840
|
)
|
|
831
841
|
lines.extend(
|
|
@@ -837,7 +847,6 @@ def build_report_markdown(
|
|
|
837
847
|
"| --- | --- |",
|
|
838
848
|
f"| Scan outcome | {scan.get('status', 'completed')} |",
|
|
839
849
|
*summary_count_lines,
|
|
840
|
-
f"| Coverage | {coverage['completeness']} |",
|
|
841
850
|
f"| Validation mode | {_cell(scope.get('validationMode', 'not recorded'))} |",
|
|
842
851
|
"",
|
|
843
852
|
"Canonical artifacts: `scan-manifest.json`, `findings.json`, and `coverage.json`. This report is a deterministic projection of those files.",
|
|
@@ -856,20 +865,16 @@ def build_report_markdown(
|
|
|
856
865
|
"No explicit canonical threat-model summary was recorded.",
|
|
857
866
|
)
|
|
858
867
|
)
|
|
859
|
-
for heading, key
|
|
860
|
-
("Assets", "assets"
|
|
861
|
-
("Trust Boundaries", "trustBoundaries"
|
|
862
|
-
(
|
|
863
|
-
|
|
864
|
-
|
|
865
|
-
"No attacker capabilities were recorded.",
|
|
866
|
-
),
|
|
867
|
-
("Security Objectives", "securityObjectives", "No security objectives were recorded."),
|
|
868
|
-
("Assumptions", "assumptions", "No assumptions were recorded."),
|
|
868
|
+
for heading, key in (
|
|
869
|
+
("Assets", "assets"),
|
|
870
|
+
("Trust Boundaries", "trustBoundaries"),
|
|
871
|
+
("Attacker Capabilities", "attackerCapabilities"),
|
|
872
|
+
("Security Objectives", "securityObjectives"),
|
|
873
|
+
("Assumptions", "assumptions"),
|
|
869
874
|
):
|
|
870
875
|
values = _strings(threat_model.get(key))
|
|
871
876
|
if values:
|
|
872
|
-
lines.extend(["", f"### {heading}", "", *
|
|
877
|
+
lines.extend(["", f"### {heading}", "", *(f"- {value}" for value in values)])
|
|
873
878
|
lines.extend(["", "## Findings", ""])
|
|
874
879
|
if findings:
|
|
875
880
|
if deep_presentation:
|
|
@@ -923,33 +928,6 @@ def build_report_markdown(
|
|
|
923
928
|
else:
|
|
924
929
|
lines.extend(["", *_finding_section(number, finding)])
|
|
925
930
|
else:
|
|
926
|
-
deferred = coverage.get("deferred", [])
|
|
927
|
-
no_source_review = (
|
|
928
|
-
coverage.get("completeness") == "partial"
|
|
929
|
-
and isinstance(deferred, list)
|
|
930
|
-
and any(
|
|
931
|
-
isinstance(item, dict)
|
|
932
|
-
and item.get("reason")
|
|
933
|
-
== "The configured discovery time limit elapsed before any source review completed."
|
|
934
|
-
for item in deferred
|
|
935
|
-
)
|
|
936
|
-
)
|
|
937
|
-
budget_exhausted = (
|
|
938
|
-
coverage.get("completeness") == "partial"
|
|
939
|
-
and isinstance(deferred, list)
|
|
940
|
-
and any(
|
|
941
|
-
isinstance(item, dict)
|
|
942
|
-
and isinstance(item.get("reason"), str)
|
|
943
|
-
and (
|
|
944
|
-
item["reason"]
|
|
945
|
-
== "Validation was deferred because the scan reached its cost limit."
|
|
946
|
-
or item["reason"].startswith(
|
|
947
|
-
"Validation was deferred because the scan reached its cost limit: "
|
|
948
|
-
)
|
|
949
|
-
)
|
|
950
|
-
for item in deferred
|
|
951
|
-
)
|
|
952
|
-
)
|
|
953
931
|
stopped = manifest.get("scan", {}).get("status") in {
|
|
954
932
|
"failed",
|
|
955
933
|
"canceled",
|
|
@@ -963,18 +941,7 @@ def build_report_markdown(
|
|
|
963
941
|
"No findings were retained before the scan stopped. "
|
|
964
942
|
"The scan did not complete. No vulnerability conclusion can be drawn."
|
|
965
943
|
if stopped
|
|
966
|
-
else
|
|
967
|
-
"No source review completed before the configured time limit. "
|
|
968
|
-
"No vulnerability conclusion can be drawn."
|
|
969
|
-
if no_source_review
|
|
970
|
-
else (
|
|
971
|
-
"No findings were validated before the scan reached its cost limit. "
|
|
972
|
-
"Review the deferred candidates in Open Questions And Follow Up."
|
|
973
|
-
if budget_exhausted
|
|
974
|
-
else "No reportable findings survived the canonical discovery, validation, "
|
|
975
|
-
"and reportability gates."
|
|
976
|
-
)
|
|
977
|
-
)
|
|
944
|
+
else "No findings were reported."
|
|
978
945
|
),
|
|
979
946
|
]
|
|
980
947
|
)
|
|
@@ -6,6 +6,7 @@ from __future__ import annotations
|
|
|
6
6
|
import argparse
|
|
7
7
|
import sqlite3
|
|
8
8
|
from pathlib import Path
|
|
9
|
+
from urllib.parse import quote
|
|
9
10
|
|
|
10
11
|
|
|
11
12
|
def main() -> None:
|
|
@@ -15,8 +16,12 @@ def main() -> None:
|
|
|
15
16
|
args = parser.parse_args()
|
|
16
17
|
source = args.source.expanduser().resolve(strict=True)
|
|
17
18
|
destination = args.destination.expanduser().absolute()
|
|
19
|
+
# SQLite backup cannot make progress when both connections use the same file.
|
|
20
|
+
if destination.exists() and destination.samefile(source):
|
|
21
|
+
parser.error(f"Destination must not be the same file as source: {destination}")
|
|
18
22
|
destination.parent.mkdir(parents=True, exist_ok=True)
|
|
19
|
-
|
|
23
|
+
source_uri = f"file:{quote(str(source), safe='')}?mode=ro"
|
|
24
|
+
with sqlite3.connect(source_uri, uri=True) as source_connection:
|
|
20
25
|
with sqlite3.connect(destination) as destination_connection:
|
|
21
26
|
source_connection.backup(destination_connection)
|
|
22
27
|
destination.chmod(0o600)
|
|
@@ -4,13 +4,16 @@
|
|
|
4
4
|
from __future__ import annotations
|
|
5
5
|
|
|
6
6
|
import argparse
|
|
7
|
-
import importlib.util
|
|
8
7
|
import json
|
|
9
8
|
import sys
|
|
10
9
|
from collections.abc import Callable
|
|
11
10
|
from pathlib import Path
|
|
12
11
|
from typing import Any
|
|
13
12
|
|
|
13
|
+
# Keep sibling helpers importable when Python starts in isolated mode.
|
|
14
|
+
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
|
15
|
+
import report_projection as report
|
|
16
|
+
|
|
14
17
|
_STRUCTURED_SECTIONS = (
|
|
15
18
|
("Assets", "assets"),
|
|
16
19
|
("Trust Boundaries", "trustBoundaries"),
|
|
@@ -113,12 +116,6 @@ def render_threat_model(model: dict[str, Any], provenance: dict[str, Any] | None
|
|
|
113
116
|
body = threat_model_body(model)
|
|
114
117
|
if _markdown_content(model) is None:
|
|
115
118
|
body = "# Threat Model\n\n" + body
|
|
116
|
-
script = Path(__file__).resolve().with_name("report_projection.py")
|
|
117
|
-
spec = importlib.util.spec_from_file_location("codex_security_report_projection", script)
|
|
118
|
-
if spec is None or spec.loader is None:
|
|
119
|
-
raise ValueError(f"could not load report projection helper: {script}")
|
|
120
|
-
report = importlib.util.module_from_spec(spec)
|
|
121
|
-
spec.loader.exec_module(report)
|
|
122
119
|
text = report._text
|
|
123
120
|
provenance = provenance or {}
|
|
124
121
|
footer = ["---", "", "## Saved Model Context", ""]
|
|
@@ -4,25 +4,14 @@
|
|
|
4
4
|
from __future__ import annotations
|
|
5
5
|
|
|
6
6
|
import argparse
|
|
7
|
-
import importlib.util
|
|
8
7
|
import json
|
|
9
8
|
import sys
|
|
10
9
|
from pathlib import Path
|
|
11
|
-
from types import ModuleType
|
|
12
10
|
from typing import Any
|
|
13
11
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
spec = importlib.util.spec_from_file_location("codex_security_scan_contract", script)
|
|
18
|
-
if spec is None or spec.loader is None:
|
|
19
|
-
raise RuntimeError(f"could not load scan contract validator: {script}")
|
|
20
|
-
module = importlib.util.module_from_spec(spec)
|
|
21
|
-
spec.loader.exec_module(module)
|
|
22
|
-
return module
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
FINALIZER = _load_finalizer()
|
|
12
|
+
# Keep sibling helpers importable when Python starts in isolated mode.
|
|
13
|
+
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
|
14
|
+
import finalize_scan_contract as FINALIZER
|
|
26
15
|
|
|
27
16
|
|
|
28
17
|
def validate_contract(scan_dir: Path) -> dict[str, Any]:
|
|
@@ -39,26 +28,7 @@ def validate_contract(scan_dir: Path) -> dict[str, Any]:
|
|
|
39
28
|
FINALIZER.validate_against_schema(manifest, schema_dir / "scan-manifest.schema.json")
|
|
40
29
|
|
|
41
30
|
scan = FINALIZER._require_dict(manifest, "scan", "manifest")
|
|
42
|
-
|
|
43
|
-
coverage_ref = scan["coverageRef"]
|
|
44
|
-
findings, findings_bytes = FINALIZER._read_scan_local_json_bytes(
|
|
45
|
-
scan_dir,
|
|
46
|
-
findings_ref,
|
|
47
|
-
findings_ref,
|
|
48
|
-
)
|
|
49
|
-
coverage, coverage_bytes = FINALIZER._read_scan_local_json_bytes(
|
|
50
|
-
scan_dir,
|
|
51
|
-
coverage_ref,
|
|
52
|
-
coverage_ref,
|
|
53
|
-
)
|
|
54
|
-
FINALIZER._validate_existing_seal(
|
|
55
|
-
scan_dir,
|
|
56
|
-
scan,
|
|
57
|
-
artifact_contents={
|
|
58
|
-
findings_ref: findings_bytes,
|
|
59
|
-
coverage_ref: coverage_bytes,
|
|
60
|
-
},
|
|
61
|
-
)
|
|
31
|
+
findings, coverage, _ = FINALIZER._read_sealed_artifacts(scan_dir, scan)
|
|
62
32
|
findings_for_validation = FINALIZER._legacy_sealed_findings_for_validation(findings)
|
|
63
33
|
FINALIZER._validate_findings(manifest, findings_for_validation)
|
|
64
34
|
FINALIZER._validate_derived_finding_identities(manifest, findings)
|