@openai/codex-security 0.1.31 → 0.3.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 +442 -2434
- package/_bundled_plugin/.app.json +5 -1
- package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
- package/_bundled_plugin/.mcp.json +3 -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 +7 -214
- 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 +563 -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 +5 -5
- package/_bundled_plugin/references/config-preflight.md +1 -5
- package/_bundled_plugin/references/core-scan.md +34 -10
- package/_bundled_plugin/references/final-report.md +13 -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 +3 -4
- package/_bundled_plugin/references/scan-contract.md +11 -6
- 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 +2 -2
- package/_bundled_plugin/schemas/coverage.schema.json +23 -47
- 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 +71 -192
- package/_bundled_plugin/schemas/scan-manifest.schema.json +83 -95
- 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 +245 -356
- 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 +29 -69
- package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
- package/_bundled_plugin/scripts/deep_scan_workbench.py +208 -363
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
- package/_bundled_plugin/scripts/finalize_scan_contract.py +733 -375
- package/_bundled_plugin/scripts/finding_preview.py +81 -91
- package/_bundled_plugin/scripts/generate_in_scope_files.py +48 -102
- package/_bundled_plugin/scripts/generate_rank_input.py +117 -888
- package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -6
- package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
- package/_bundled_plugin/scripts/rank_preview.py +43 -902
- package/_bundled_plugin/scripts/report_projection.py +143 -219
- package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
- package/_bundled_plugin/scripts/threat_model_projection.py +161 -0
- 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 +59 -9
- 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 +21 -6
- package/_bundled_plugin/scripts/workbench_cli.py +99 -190
- package/_bundled_plugin/scripts/workbench_constants.py +6 -14
- package/_bundled_plugin/scripts/workbench_db.py +524 -672
- package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
- package/_bundled_plugin/scripts/workbench_finding_index.py +20 -7
- 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 +28 -18
- package/_bundled_plugin/scripts/workbench_progress.py +26 -92
- package/_bundled_plugin/scripts/workbench_publication.py +77 -116
- package/_bundled_plugin/scripts/workbench_remediation.py +14 -20
- package/_bundled_plugin/scripts/workbench_saved_results.py +1402 -263
- package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
- package/_bundled_plugin/scripts/workbench_scan_start.py +109 -52
- package/_bundled_plugin/scripts/workbench_scan_usage.py +30 -49
- package/_bundled_plugin/scripts/workbench_schema.py +71 -1370
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +16 -7
- package/_bundled_plugin/scripts/workbench_target.py +526 -150
- package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
- package/_bundled_plugin/scripts/workbench_validation.py +19 -44
- package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
- package/_bundled_plugin/shared/workbench-migrations.json +397 -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 +6 -6
- package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
- 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-diff-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
- package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
- package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
- package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
- package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
- package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
- 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 -15
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +970 -553
- package/dist/api.js.map +1 -1
- package/dist/artifact-export.d.ts +70 -0
- package/dist/artifact-export.d.ts.map +1 -0
- package/dist/artifact-export.js +292 -0
- package/dist/artifact-export.js.map +1 -0
- package/dist/auth.d.ts +2 -6
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +27 -12
- package/dist/auth.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts +1 -0
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +9 -9
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/classify-scan-severity.d.ts.map +1 -1
- package/dist/classify-scan-severity.js +2 -5
- package/dist/classify-scan-severity.js.map +1 -1
- package/dist/classify-severity.d.ts +28 -17
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +16 -35
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-help.d.ts +3 -0
- package/dist/cli-help.d.ts.map +1 -0
- package/dist/cli-help.js +285 -0
- package/dist/cli-help.js.map +1 -0
- 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 +22 -24
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1660 -1556
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +11 -17
- 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-prompt.d.ts.map +1 -1
- package/dist/codex-prompt.js +1 -2
- package/dist/codex-prompt.js.map +1 -1
- package/dist/codex-sdk-environment.d.ts +3 -0
- package/dist/codex-sdk-environment.d.ts.map +1 -0
- package/dist/codex-sdk-environment.js +68 -0
- package/dist/codex-sdk-environment.js.map +1 -0
- package/dist/component-plan.d.ts +2 -5
- package/dist/component-plan.d.ts.map +1 -1
- package/dist/component-plan.js +38 -34
- package/dist/component-plan.js.map +1 -1
- package/dist/component-scan.d.ts +7 -5
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +54 -44
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +93 -104
- package/dist/config.js.map +1 -1
- package/dist/contract.d.ts +15 -2
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +124 -348
- 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 +75 -34
- 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 +116 -134
- package/dist/cost.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +7 -6
- 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 +23 -16
- 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 +33 -20
- package/dist/deduplication/checkpointed-review.js.map +1 -1
- package/dist/deduplication/codex-review.d.ts +9 -1
- package/dist/deduplication/codex-review.d.ts.map +1 -1
- package/dist/deduplication/codex-review.js +129 -20
- 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 +26 -4
- package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
- package/dist/deduplication/deduplication-reviewer.js +59 -47
- package/dist/deduplication/deduplication-reviewer.js.map +1 -1
- package/dist/deduplication/deduplication.d.ts.map +1 -1
- package/dist/deduplication/deduplication.js +59 -113
- 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.map +1 -1
- package/dist/deduplication/records-protocol.js +12 -28
- package/dist/deduplication/records-protocol.js.map +1 -1
- package/dist/deduplication/records.d.ts +188 -12
- package/dist/deduplication/records.d.ts.map +1 -1
- package/dist/deduplication/records.js +34 -24
- package/dist/deduplication/records.js.map +1 -1
- package/dist/deduplication/review.d.ts +7 -0
- package/dist/deduplication/review.d.ts.map +1 -1
- package/dist/deduplication/review.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 +159 -44
- 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 +7 -23
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-progress.d.ts +2 -1
- package/dist/deep-progress.d.ts.map +1 -1
- package/dist/deep-progress.js +32 -47
- 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 +5 -2
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +7 -7
- package/dist/errors.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +53 -21
- package/dist/feedback.js.map +1 -1
- package/dist/finding-catalogue.d.ts.map +1 -1
- package/dist/finding-catalogue.js +26 -30
- 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 +18 -13
- 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 +16 -44
- package/dist/findings-import.js.map +1 -1
- package/dist/github.d.ts.map +1 -1
- package/dist/github.js +9 -4
- package/dist/github.js.map +1 -1
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +49 -39
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +11 -5
- 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 +115 -47
- package/dist/knowledge-base.js.map +1 -1
- package/dist/linear.d.ts.map +1 -1
- package/dist/linear.js +4 -10
- 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 +24 -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 +225 -153
- 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 +69 -14
- package/dist/owner-evidence.js.map +1 -1
- package/dist/patch-tui.d.ts.map +1 -1
- package/dist/patch-tui.js +5 -6
- package/dist/patch-tui.js.map +1 -1
- package/dist/project-config-schema.d.ts +10 -0
- package/dist/project-config-schema.d.ts.map +1 -1
- package/dist/project-config-schema.js +1 -0
- package/dist/project-config-schema.js.map +1 -1
- package/dist/project-config.d.ts +1 -0
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +5 -3
- package/dist/project-config.js.map +1 -1
- package/dist/prompt-files.d.ts +0 -1
- package/dist/prompt-files.d.ts.map +1 -1
- package/dist/prompt-files.js +2 -4
- package/dist/prompt-files.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 +40 -79
- package/dist/publication-events.js.map +1 -1
- package/dist/publication-store.d.ts.map +1 -1
- package/dist/publication-store.js +48 -76
- package/dist/publication-store.js.map +1 -1
- package/dist/publication.d.ts +1 -2
- package/dist/publication.d.ts.map +1 -1
- package/dist/publication.js +7 -16
- 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 +138 -199
- package/dist/publish.js.map +1 -1
- package/dist/record.d.ts +2 -0
- package/dist/record.d.ts.map +1 -0
- package/dist/record.js +4 -0
- package/dist/record.js.map +1 -0
- 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/result.d.ts +4 -1
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +7 -0
- package/dist/result.js.map +1 -1
- package/dist/runtime.d.ts +25 -17
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +619 -255
- 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 +16 -32
- package/dist/saved-scan.js.map +1 -1
- package/dist/scan-activity.d.ts.map +1 -1
- package/dist/scan-activity.js +19 -30
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +31 -18
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +307 -347
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +3 -1
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +351 -92
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +55 -15
- 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 +14 -12
- 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 +18 -3
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-settings.d.ts +5 -0
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +4 -0
- package/dist/scan-settings.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 +15 -33
- package/dist/security-policy-cli.js.map +1 -1
- package/dist/security-policy.d.ts +17 -9
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js +131 -98
- 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 +11 -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 +55 -55
- 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 +20 -32
- 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 +6 -5
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +15 -10
- package/dist/suggest-owners.js.map +1 -1
- package/dist/targets.d.ts +12 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +124 -62
- package/dist/targets.js.map +1 -1
- package/dist/trusted-executable.d.ts +6 -1
- package/dist/trusted-executable.d.ts.map +1 -1
- package/dist/trusted-executable.js +28 -9
- package/dist/trusted-executable.js.map +1 -1
- package/dist/value.d.ts +2 -0
- package/dist/value.d.ts.map +1 -0
- package/dist/value.js +27 -0
- package/dist/value.js.map +1 -0
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +3 -6
- package/dist/version.js.map +1 -1
- package/dist/windows-path.d.ts.map +1 -1
- package/dist/windows-path.js +1 -2
- package/dist/windows-path.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 +2 -0
- package/dist/worker-progress.d.ts.map +1 -1
- package/dist/worker-progress.js +40 -46
- package/dist/worker-progress.js.map +1 -1
- package/docs/cli.md +1778 -0
- package/docs/dedupe-records.md +24 -0
- package/docs/findings-service.md +402 -0
- package/package.json +23 -23
- package/schemas/project-config.schema.json +5 -0
- package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
- package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
- 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 -119
- 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/findings-service.d.ts +0 -20
- package/dist/server/findings-service.d.ts.map +0 -1
- package/dist/server/findings-service.js +0 -31
- package/dist/server/findings-service.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 -6
- package/dist/server/routes.d.ts.map +0 -1
- package/dist/server/routes.js +0 -86
- 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 -17
- 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
|
@@ -28,22 +28,12 @@ class ReportProjectionError(ValueError):
|
|
|
28
28
|
def _text(value: Any, fallback: str) -> str:
|
|
29
29
|
candidate = value if isinstance(value, str) and value.strip() else fallback
|
|
30
30
|
normalized = " ".join(candidate.split())
|
|
31
|
-
if not normalized:
|
|
32
|
-
return ""
|
|
33
31
|
if re.match(r"^(?:#{1,6}\s|[-*+]\s|>\s|```|\d+\.\s|\|)", normalized):
|
|
34
32
|
normalized = f"Text: {normalized}"
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
rendered.append(f"`{match.group(1)}`")
|
|
40
|
-
cursor = match.end()
|
|
41
|
-
rendered.append(_escape_markdown_text(normalized[cursor:]))
|
|
42
|
-
return "".join(rendered)
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
def _escape_markdown_text(value: str) -> str:
|
|
46
|
-
return re.sub(r"([\\`*\[\]<>])", r"\\\1", value)
|
|
33
|
+
return "".join(
|
|
34
|
+
part if index % 2 else re.sub(r"([\\`*_\[\]<>])", r"\\\1", part)
|
|
35
|
+
for index, part in enumerate(re.split(r"((?<!`)`[^`\n]+`(?!`))", normalized))
|
|
36
|
+
)
|
|
47
37
|
|
|
48
38
|
|
|
49
39
|
def _strings(value: Any) -> list[str]:
|
|
@@ -51,22 +41,13 @@ def _strings(value: Any) -> list[str]:
|
|
|
51
41
|
value = [value]
|
|
52
42
|
if not isinstance(value, list):
|
|
53
43
|
return []
|
|
54
|
-
|
|
55
|
-
for item in value:
|
|
56
|
-
text = _text(item, "")
|
|
57
|
-
if text:
|
|
58
|
-
normalized.append(text)
|
|
59
|
-
return normalized
|
|
44
|
+
return [text for item in value if (text := _text(item, ""))]
|
|
60
45
|
|
|
61
46
|
|
|
62
47
|
def _cell(value: Any) -> str:
|
|
63
48
|
return _text(value, "none").replace("|", "\\|").replace("\n", "<br>")
|
|
64
49
|
|
|
65
50
|
|
|
66
|
-
def _link_label(value: Any, fallback: str) -> str:
|
|
67
|
-
return _cell(value) or _cell(fallback)
|
|
68
|
-
|
|
69
|
-
|
|
70
51
|
def _deep_report_id(finding: dict[str, Any]) -> str:
|
|
71
52
|
extensions = finding.get("extensions")
|
|
72
53
|
if isinstance(extensions, dict):
|
|
@@ -108,7 +89,7 @@ def _has_deep_child_metadata(finding: dict[str, Any]) -> bool:
|
|
|
108
89
|
)
|
|
109
90
|
|
|
110
91
|
|
|
111
|
-
def
|
|
92
|
+
def uses_deep_presentation(coverage: dict[str, Any], findings: list[dict[str, Any]]) -> bool:
|
|
112
93
|
if coverage.get("mode") == "deep_repository":
|
|
113
94
|
return True
|
|
114
95
|
if coverage.get("mode") != "scoped_path":
|
|
@@ -141,10 +122,6 @@ def _deep_title_parts(finding: dict[str, Any]) -> tuple[str, str | None]:
|
|
|
141
122
|
return normalized, None
|
|
142
123
|
|
|
143
124
|
|
|
144
|
-
def _deep_finding_title(finding: dict[str, Any]) -> str:
|
|
145
|
-
return _deep_title_parts(finding)[0]
|
|
146
|
-
|
|
147
|
-
|
|
148
125
|
def _deep_finding_groups(
|
|
149
126
|
findings: list[dict[str, Any]], writeup_paths: list[str | None]
|
|
150
127
|
) -> list[list[tuple[int, dict[str, Any], str | None]]]:
|
|
@@ -155,12 +132,9 @@ def _deep_finding_groups(
|
|
|
155
132
|
|
|
156
133
|
|
|
157
134
|
def _deep_group_titles(group: list[tuple[int, dict[str, Any], str | None]]) -> str:
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
if title not in titles:
|
|
162
|
-
titles.append(title)
|
|
163
|
-
return "<br>".join(titles)
|
|
135
|
+
return "<br>".join(
|
|
136
|
+
dict.fromkeys(_cell(_deep_title_parts(finding)[0]) for _, finding, _ in group)
|
|
137
|
+
)
|
|
164
138
|
|
|
165
139
|
|
|
166
140
|
def _deep_group_levels(
|
|
@@ -197,7 +171,7 @@ def _deep_group_report_labels(
|
|
|
197
171
|
def _deep_group_report_links(group: list[tuple[int, dict[str, Any], str | None]]) -> str:
|
|
198
172
|
labels = _deep_group_report_labels(group)
|
|
199
173
|
return "<br>".join(
|
|
200
|
-
f"[{
|
|
174
|
+
f"[{_cell(label)}](#finding-{number})"
|
|
201
175
|
for label, (number, _, _) in zip(labels, group, strict=True)
|
|
202
176
|
)
|
|
203
177
|
|
|
@@ -206,7 +180,7 @@ def _deep_group_writeup_links(group: list[tuple[int, dict[str, Any], str | None]
|
|
|
206
180
|
labels = _deep_group_report_labels(group)
|
|
207
181
|
links: list[str] = []
|
|
208
182
|
for label, (_, _, report_path) in zip(labels, group, strict=True):
|
|
209
|
-
report_id =
|
|
183
|
+
report_id = _cell(label)
|
|
210
184
|
links.append(
|
|
211
185
|
f"[Open {report_id}]({report_path})" if report_path else f"{report_id}: inline below"
|
|
212
186
|
)
|
|
@@ -237,8 +211,8 @@ def _hardening_portfolio_path(scan: dict[str, Any]) -> str | None:
|
|
|
237
211
|
return portfolio_path
|
|
238
212
|
|
|
239
213
|
|
|
240
|
-
def
|
|
241
|
-
return [f"- {item}" for item in
|
|
214
|
+
def _bullet_section(heading: str, items: list[str]) -> list[str]:
|
|
215
|
+
return ["", heading, *(f"- {item}" for item in items)] if items else []
|
|
242
216
|
|
|
243
217
|
|
|
244
218
|
def _code_evidence_catalog(finding: dict[str, Any]) -> dict[str, dict[str, Any]]:
|
|
@@ -282,15 +256,11 @@ def _section_code_evidence(
|
|
|
282
256
|
and isinstance(item.get("code"), str)
|
|
283
257
|
and item["code"].strip()
|
|
284
258
|
)
|
|
285
|
-
unique:
|
|
286
|
-
seen: set[tuple[str, str]] = set()
|
|
259
|
+
unique: dict[tuple[str, str], dict[str, Any]] = {}
|
|
287
260
|
for item in resolved:
|
|
288
261
|
key = (str(item.get("id", "")), item["code"])
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
seen.add(key)
|
|
292
|
-
unique.append(item)
|
|
293
|
-
return unique
|
|
262
|
+
unique.setdefault(key, item)
|
|
263
|
+
return list(unique.values())
|
|
294
264
|
|
|
295
265
|
|
|
296
266
|
def merged_root_cause(value: dict[str, Any]) -> tuple[str | None, Any]:
|
|
@@ -307,8 +277,6 @@ def merged_root_cause(value: dict[str, Any]) -> tuple[str | None, Any]:
|
|
|
307
277
|
details.append({"summary": detail})
|
|
308
278
|
elif isinstance(detail, dict):
|
|
309
279
|
details.append(detail)
|
|
310
|
-
elif detail is not None:
|
|
311
|
-
continue
|
|
312
280
|
if not details:
|
|
313
281
|
return keys[0], None
|
|
314
282
|
|
|
@@ -431,16 +399,16 @@ def _code_evidence_location(item: dict[str, Any]) -> str:
|
|
|
431
399
|
return f"{path}:{start}" if end == start else f"{path}:{start}-{end}"
|
|
432
400
|
|
|
433
401
|
|
|
434
|
-
def _code_fence(code: str) -> str:
|
|
402
|
+
def _code_fence(code: str, minimum: int = 3) -> str:
|
|
435
403
|
longest_run = max((len(match.group(0)) for match in re.finditer(r"`+", code)), default=0)
|
|
436
|
-
return "`" * max(
|
|
404
|
+
return "`" * max(minimum, longest_run + 1)
|
|
437
405
|
|
|
438
406
|
|
|
439
407
|
def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
|
|
440
408
|
lines: list[str] = []
|
|
441
409
|
for index, item in enumerate(evidence):
|
|
442
410
|
label = _text(item.get("label"), f"Code evidence {index + 1}")
|
|
443
|
-
location =
|
|
411
|
+
location = " ".join(_code_evidence_location(item).split())
|
|
444
412
|
explanation = _text(item.get("explanation"), "")
|
|
445
413
|
language = item.get("language") if isinstance(item.get("language"), str) else ""
|
|
446
414
|
language = language if re.fullmatch(r"[A-Za-z0-9_+.-]*", language) else ""
|
|
@@ -448,7 +416,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
|
|
|
448
416
|
fence = _code_fence(code)
|
|
449
417
|
heading = f"**{label}**"
|
|
450
418
|
if location:
|
|
451
|
-
|
|
419
|
+
marker = _code_fence(location, minimum=1)
|
|
420
|
+
padding = " " if location.startswith("`") or location.endswith("`") else ""
|
|
421
|
+
heading += f" — {marker}{padding}{location}{padding}{marker}"
|
|
452
422
|
lines.extend(["", heading])
|
|
453
423
|
if explanation:
|
|
454
424
|
lines.extend(["", explanation])
|
|
@@ -456,22 +426,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
|
|
|
456
426
|
return lines
|
|
457
427
|
|
|
458
428
|
|
|
459
|
-
def
|
|
460
|
-
counts = Counter(finding[
|
|
461
|
-
return (
|
|
462
|
-
", ".join(f"{level}: {counts[level]}" for level in SEVERITY_ORDER if counts[level])
|
|
463
|
-
or "none"
|
|
464
|
-
)
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
def _confidence_mix(findings: list[dict[str, Any]]) -> str:
|
|
468
|
-
counts = Counter(finding["confidence"]["level"] for finding in findings)
|
|
469
|
-
return (
|
|
470
|
-
", ".join(
|
|
471
|
-
f"{level}: {counts[level]}" for level in ("high", "medium", "low") if counts[level]
|
|
472
|
-
)
|
|
473
|
-
or "none"
|
|
474
|
-
)
|
|
429
|
+
def _level_mix(findings: list[dict[str, Any]], field: str, order: dict[str, int]) -> str:
|
|
430
|
+
counts = Counter(finding[field]["level"] for finding in findings)
|
|
431
|
+
return ", ".join(f"{level}: {counts[level]}" for level in order if counts[level]) or "none"
|
|
475
432
|
|
|
476
433
|
|
|
477
434
|
def _locations(finding: dict[str, Any]) -> str:
|
|
@@ -523,6 +480,71 @@ def _surface_notes(surface: dict[str, Any]) -> str:
|
|
|
523
480
|
return _cell(f"{notes} Evidence: {evidence}")
|
|
524
481
|
|
|
525
482
|
|
|
483
|
+
def _remediation_section(finding: dict[str, Any]) -> list[str]:
|
|
484
|
+
remediation = _text(finding.get("remediation"), "No canonical remediation was recorded.")
|
|
485
|
+
lines = ["", "#### Remediation", "", remediation]
|
|
486
|
+
seen = {remediation}
|
|
487
|
+
originals: list[tuple[str, dict[str, Any]]] = []
|
|
488
|
+
pending = [("finding", finding)]
|
|
489
|
+
seen_findings: set[int] = set()
|
|
490
|
+
while pending:
|
|
491
|
+
source_id, original = pending.pop()
|
|
492
|
+
if id(original) in seen_findings:
|
|
493
|
+
continue
|
|
494
|
+
seen_findings.add(id(original))
|
|
495
|
+
originals.append((source_id, original))
|
|
496
|
+
provenance = original.get("provenance")
|
|
497
|
+
if not isinstance(provenance, dict):
|
|
498
|
+
continue
|
|
499
|
+
previous = provenance.get("previousFindings")
|
|
500
|
+
if isinstance(previous, list):
|
|
501
|
+
pending.extend(
|
|
502
|
+
(source_id, item) for item in reversed(previous) if isinstance(item, dict)
|
|
503
|
+
)
|
|
504
|
+
sources = provenance.get("sourceFindings")
|
|
505
|
+
if isinstance(sources, list):
|
|
506
|
+
pending.extend(
|
|
507
|
+
(_text(source.get("id"), "finding"), source["finding"])
|
|
508
|
+
for source in reversed(sources)
|
|
509
|
+
if isinstance(source, dict) and isinstance(source.get("finding"), dict)
|
|
510
|
+
)
|
|
511
|
+
for source_id, original in originals[1:]:
|
|
512
|
+
text = _text(original.get("remediation"), "")
|
|
513
|
+
if text and text not in seen:
|
|
514
|
+
seen.add(text)
|
|
515
|
+
lines.extend(["", f"Source {source_id}: {text}"])
|
|
516
|
+
for field, label in (
|
|
517
|
+
("remediationTests", "Tests"),
|
|
518
|
+
("preventiveControls", "Preventive controls"),
|
|
519
|
+
):
|
|
520
|
+
values = list(
|
|
521
|
+
dict.fromkeys(
|
|
522
|
+
value for _, original in originals for value in _strings(original.get(field))
|
|
523
|
+
)
|
|
524
|
+
)
|
|
525
|
+
lines.extend(_bullet_section(f"{label}:", values))
|
|
526
|
+
return lines
|
|
527
|
+
|
|
528
|
+
|
|
529
|
+
def _finding_header(number: int, finding: dict[str, Any]) -> list[str]:
|
|
530
|
+
cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
|
|
531
|
+
title = _text(finding["title"], "Untitled finding")
|
|
532
|
+
return [
|
|
533
|
+
f'<a id="finding-{number}"></a>',
|
|
534
|
+
"",
|
|
535
|
+
f"### [{number}] {title}",
|
|
536
|
+
"",
|
|
537
|
+
"| Field | Value |",
|
|
538
|
+
"| --- | --- |",
|
|
539
|
+
f"| Severity | {_cell(finding['severity']['level'])} |",
|
|
540
|
+
f"| Confidence | {_cell(finding['confidence']['level'])} |",
|
|
541
|
+
f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
|
|
542
|
+
f"| Category | {_cell(finding['taxonomy']['category'])} |",
|
|
543
|
+
f"| CWE | {_cell(cwes)} |",
|
|
544
|
+
f"| Affected lines | {_cell(_locations(finding))} |",
|
|
545
|
+
]
|
|
546
|
+
|
|
547
|
+
|
|
526
548
|
def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
527
549
|
validation = finding.get("validation") if isinstance(finding.get("validation"), dict) else {}
|
|
528
550
|
_, raw_root_cause = merged_root_cause(finding)
|
|
@@ -585,10 +607,6 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
585
607
|
if validation_outcomes
|
|
586
608
|
else f"{finding['confidence']['rationale']} Validation details were not recorded separately.",
|
|
587
609
|
)
|
|
588
|
-
validation_evidence = _strings(validation.get("evidence"))
|
|
589
|
-
validation_assertions = _strings(validation.get("assertions"))
|
|
590
|
-
validation_counterevidence = _strings(validation.get("counterEvidence"))
|
|
591
|
-
validation_limitations = _strings(validation.get("limitations"))
|
|
592
610
|
root_cause_summary = _text(
|
|
593
611
|
raw_root_cause if isinstance(raw_root_cause, str) else root_cause.get("summary"),
|
|
594
612
|
"",
|
|
@@ -601,12 +619,9 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
601
619
|
dataflow.get("summary"),
|
|
602
620
|
f"The canonical finding records the affected path at {_locations(finding)}, but no expanded source-to-sink narrative was recorded.",
|
|
603
621
|
)
|
|
604
|
-
reachability_summary = _text(
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
attack_path.get("summary"),
|
|
608
|
-
"Reachability was not recorded beyond the canonical finding summary and affected locations.",
|
|
609
|
-
),
|
|
622
|
+
reachability_summary = _text(reachability.get("summary"), "") or _text(
|
|
623
|
+
attack_path.get("summary"),
|
|
624
|
+
"Reachability was not recorded beyond the canonical finding summary and affected locations.",
|
|
610
625
|
)
|
|
611
626
|
severity_rationale = _text(
|
|
612
627
|
severity.get("rationale"),
|
|
@@ -616,24 +631,8 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
616
631
|
severity.get("changeConditions"),
|
|
617
632
|
"Additional runtime or deployment evidence could raise or lower this severity.",
|
|
618
633
|
)
|
|
619
|
-
remediation_tests = _strings(finding.get("remediationTests"))
|
|
620
|
-
preventive_controls = _strings(finding.get("preventiveControls"))
|
|
621
|
-
attack_steps = _strings(attack_path.get("steps"))
|
|
622
|
-
cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
|
|
623
|
-
title = _text(finding["title"], "Untitled finding")
|
|
624
634
|
lines = [
|
|
625
|
-
|
|
626
|
-
"",
|
|
627
|
-
f"### [{number}] {title}",
|
|
628
|
-
"",
|
|
629
|
-
"| Field | Value |",
|
|
630
|
-
"| --- | --- |",
|
|
631
|
-
f"| Severity | {_cell(severity['level'])} |",
|
|
632
|
-
f"| Confidence | {_cell(finding['confidence']['level'])} |",
|
|
633
|
-
f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
|
|
634
|
-
f"| Category | {_cell(finding['taxonomy']['category'])} |",
|
|
635
|
-
f"| CWE | {_cell(cwes)} |",
|
|
636
|
-
f"| Affected lines | {_cell(_locations(finding))} |",
|
|
635
|
+
*_finding_header(number, finding),
|
|
637
636
|
"",
|
|
638
637
|
"#### Summary",
|
|
639
638
|
"",
|
|
@@ -650,29 +649,19 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
650
649
|
if validation_outcomes:
|
|
651
650
|
lines.extend(["", *(f"- **{label}:** {value}" for label, value in validation_outcomes)])
|
|
652
651
|
lines.extend(_code_evidence_lines(validation_code_evidence))
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
"",
|
|
661
|
-
"Counterevidence and remaining uncertainty:",
|
|
662
|
-
*_bullets(validation_counterevidence, "None recorded."),
|
|
663
|
-
]
|
|
664
|
-
)
|
|
665
|
-
if validation_limitations:
|
|
666
|
-
lines.extend(["", "Limitations:", *_bullets(validation_limitations, "None recorded.")])
|
|
652
|
+
for label, key in (
|
|
653
|
+
("Assertions", "assertions"),
|
|
654
|
+
("Evidence", "evidence"),
|
|
655
|
+
("Counterevidence and remaining uncertainty", "counterEvidence"),
|
|
656
|
+
("Limitations", "limitations"),
|
|
657
|
+
):
|
|
658
|
+
lines.extend(_bullet_section(f"{label}:", _strings(validation.get(key))))
|
|
667
659
|
lines.extend(["", "#### Dataflow", "", dataflow_summary])
|
|
668
|
-
|
|
669
|
-
lines.extend(["", "Attack steps:", *_bullets(attack_steps, "None recorded.")])
|
|
660
|
+
lines.extend(_bullet_section("Attack steps:", _strings(attack_path.get("steps"))))
|
|
670
661
|
for label, key in (("Source", "source"), ("Sink", "sink"), ("Outcome", "outcome")):
|
|
671
662
|
if dataflow.get(key):
|
|
672
663
|
lines.extend(["", f"- **{label}:** {_text(dataflow[key], 'not recorded')}"])
|
|
673
|
-
|
|
674
|
-
if transformations:
|
|
675
|
-
lines.extend(["", "Transformations:", *_bullets(transformations, "None recorded.")])
|
|
664
|
+
lines.extend(_bullet_section("Transformations:", _strings(dataflow.get("transformations"))))
|
|
676
665
|
lines.extend(_code_evidence_lines(dataflow_code_evidence))
|
|
677
666
|
lines.extend(["", "#### Reachability", "", reachability_summary])
|
|
678
667
|
for label, key in (
|
|
@@ -692,17 +681,14 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
692
681
|
]
|
|
693
682
|
)
|
|
694
683
|
)
|
|
695
|
-
|
|
696
|
-
lines.extend(["", "Preconditions:", *_bullets(preconditions, "None recorded.")])
|
|
684
|
+
lines.extend(_bullet_section("Preconditions:", preconditions))
|
|
697
685
|
for label, key in (
|
|
698
686
|
("Assumptions", "assumptions"),
|
|
699
687
|
("Existing controls", "controls"),
|
|
700
688
|
("Blind spots", "blindspots"),
|
|
701
689
|
("Limitations", "limitations"),
|
|
702
690
|
):
|
|
703
|
-
|
|
704
|
-
if values:
|
|
705
|
-
lines.extend(["", f"{label}:", *_bullets(values, "None recorded.")])
|
|
691
|
+
lines.extend(_bullet_section(f"{label}:", _strings(attack_path.get(key))))
|
|
706
692
|
lines.extend(_code_evidence_lines(reachability_code_evidence))
|
|
707
693
|
lines.extend(
|
|
708
694
|
[
|
|
@@ -736,41 +722,21 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
736
722
|
lines.extend(
|
|
737
723
|
["", f"{label} assessment:", *(f"- **{name}:** {value}" for name, value in details)]
|
|
738
724
|
)
|
|
739
|
-
lines.extend(
|
|
740
|
-
[
|
|
741
|
-
"",
|
|
742
|
-
"#### Remediation",
|
|
743
|
-
"",
|
|
744
|
-
_text(finding["remediation"], "No canonical remediation was recorded."),
|
|
745
|
-
]
|
|
746
|
-
)
|
|
747
|
-
if remediation_tests:
|
|
748
|
-
lines.extend(["", "Tests:", *_bullets(remediation_tests, "No tests recorded.")])
|
|
749
|
-
if preventive_controls:
|
|
750
|
-
lines.extend(["", "Preventive controls:", *_bullets(preventive_controls, "None recorded.")])
|
|
725
|
+
lines.extend(_remediation_section(finding))
|
|
751
726
|
return lines
|
|
752
727
|
|
|
753
728
|
|
|
754
729
|
def _linked_finding_section(number: int, finding: dict[str, Any], report_path: str) -> list[str]:
|
|
755
|
-
cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
|
|
756
|
-
title = _text(finding["title"], "Untitled finding")
|
|
757
730
|
link = f"[detailed technical write-up]({report_path})"
|
|
758
|
-
lines =
|
|
759
|
-
|
|
760
|
-
"",
|
|
761
|
-
f"### [{number}] {title}",
|
|
762
|
-
"",
|
|
763
|
-
"| Field | Value |",
|
|
764
|
-
"| --- | --- |",
|
|
765
|
-
f"| Severity | {_cell(finding['severity']['level'])} |",
|
|
766
|
-
f"| Confidence | {_cell(finding['confidence']['level'])} |",
|
|
767
|
-
f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
|
|
768
|
-
f"| Category | {_cell(finding['taxonomy']['category'])} |",
|
|
769
|
-
f"| CWE | {_cell(cwes)} |",
|
|
770
|
-
f"| Affected lines | {_cell(_locations(finding))} |",
|
|
771
|
-
]
|
|
772
|
-
for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity", "Remediation"):
|
|
731
|
+
lines = _finding_header(number, finding)
|
|
732
|
+
for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity"):
|
|
773
733
|
lines.extend(["", f"#### {heading}", "", f"See the {link}."])
|
|
734
|
+
if any(
|
|
735
|
+
finding.get("provenance", {}).get(field) for field in ("sourceFindings", "previousFindings")
|
|
736
|
+
):
|
|
737
|
+
lines.extend(_remediation_section(finding))
|
|
738
|
+
else:
|
|
739
|
+
lines.extend(["", "#### Remediation", "", f"See the {link}."])
|
|
774
740
|
return lines
|
|
775
741
|
|
|
776
742
|
|
|
@@ -800,7 +766,7 @@ def build_report_markdown(
|
|
|
800
766
|
"reportable findings have duplicate writeup reportPath values: "
|
|
801
767
|
+ ", ".join(duplicate_writeup_paths)
|
|
802
768
|
)
|
|
803
|
-
deep_presentation =
|
|
769
|
+
deep_presentation = uses_deep_presentation(coverage, findings)
|
|
804
770
|
deep_finding_groups = _deep_finding_groups(findings, writeup_paths) if deep_presentation else []
|
|
805
771
|
hardening_portfolio_path = _hardening_portfolio_path(scan)
|
|
806
772
|
include_paths = _strings(coverage.get("includePaths", scope.get("includePaths", [])))
|
|
@@ -835,20 +801,19 @@ def build_report_markdown(
|
|
|
835
801
|
f"Excluded {_text(exclusion.get('pattern'), 'unspecified')}: "
|
|
836
802
|
f"{_text(exclusion.get('reason'), 'reason not recorded')}"
|
|
837
803
|
)
|
|
838
|
-
|
|
839
|
-
lines.extend(["", "Limitations and exclusions:", *_bullets(limitations, "None recorded.")])
|
|
804
|
+
lines.extend(_bullet_section("Limitations and exclusions:", limitations))
|
|
840
805
|
summary_count_lines = (
|
|
841
806
|
[
|
|
842
807
|
f"| Reportable DSS findings | {len(deep_finding_groups)} |",
|
|
843
808
|
f"| Report instances | {len(findings)} |",
|
|
844
|
-
f"| Report severity mix | {
|
|
845
|
-
f"| Report confidence mix | {
|
|
809
|
+
f"| Report severity mix | {_level_mix(findings, 'severity', SEVERITY_ORDER)} |",
|
|
810
|
+
f"| Report confidence mix | {_level_mix(findings, 'confidence', CONFIDENCE_ORDER)} |",
|
|
846
811
|
]
|
|
847
812
|
if deep_presentation
|
|
848
813
|
else [
|
|
849
814
|
f"| Reportable findings | {len(findings)} |",
|
|
850
|
-
f"| Severity mix | {
|
|
851
|
-
f"| Confidence mix | {
|
|
815
|
+
f"| Severity mix | {_level_mix(findings, 'severity', SEVERITY_ORDER)} |",
|
|
816
|
+
f"| Confidence mix | {_level_mix(findings, 'confidence', CONFIDENCE_ORDER)} |",
|
|
852
817
|
]
|
|
853
818
|
)
|
|
854
819
|
lines.extend(
|
|
@@ -860,33 +825,34 @@ def build_report_markdown(
|
|
|
860
825
|
"| --- | --- |",
|
|
861
826
|
f"| Scan outcome | {scan.get('status', 'completed')} |",
|
|
862
827
|
*summary_count_lines,
|
|
863
|
-
f"| Coverage | {coverage['completeness']} |",
|
|
864
828
|
f"| Validation mode | {_cell(scope.get('validationMode', 'not recorded'))} |",
|
|
865
829
|
"",
|
|
866
830
|
"Canonical artifacts: `scan-manifest.json`, `findings.json`, and `coverage.json`. This report is a deterministic projection of those files.",
|
|
867
831
|
"",
|
|
868
832
|
"## Threat Model",
|
|
869
833
|
"",
|
|
834
|
+
]
|
|
835
|
+
)
|
|
836
|
+
content = threat_model.get("content")
|
|
837
|
+
if threat_model.get("format") == "markdown" and isinstance(content, str) and content.strip():
|
|
838
|
+
lines.append(content)
|
|
839
|
+
else:
|
|
840
|
+
lines.append(
|
|
870
841
|
_text(
|
|
871
842
|
threat_model.get("summary"),
|
|
872
843
|
"No explicit canonical threat-model summary was recorded.",
|
|
873
|
-
)
|
|
874
|
-
|
|
875
|
-
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
879
|
-
|
|
880
|
-
"
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
885
|
-
("Assumptions", "assumptions", "No assumptions were recorded."),
|
|
886
|
-
):
|
|
887
|
-
values = _strings(threat_model.get(key))
|
|
888
|
-
if values:
|
|
889
|
-
lines.extend(["", f"### {heading}", "", *_bullets(values, fallback)])
|
|
844
|
+
)
|
|
845
|
+
)
|
|
846
|
+
for heading, key in (
|
|
847
|
+
("Assets", "assets"),
|
|
848
|
+
("Trust Boundaries", "trustBoundaries"),
|
|
849
|
+
("Attacker Capabilities", "attackerCapabilities"),
|
|
850
|
+
("Security Objectives", "securityObjectives"),
|
|
851
|
+
("Assumptions", "assumptions"),
|
|
852
|
+
):
|
|
853
|
+
values = _strings(threat_model.get(key))
|
|
854
|
+
if values:
|
|
855
|
+
lines.extend(["", f"### {heading}", "", *(f"- {value}" for value in values)])
|
|
890
856
|
lines.extend(["", "## Findings", ""])
|
|
891
857
|
if findings:
|
|
892
858
|
if deep_presentation:
|
|
@@ -913,7 +879,7 @@ def build_report_markdown(
|
|
|
913
879
|
for number, (finding, report_path) in enumerate(
|
|
914
880
|
zip(findings, writeup_paths, strict=True), 1
|
|
915
881
|
):
|
|
916
|
-
title =
|
|
882
|
+
title = _cell(finding["title"])
|
|
917
883
|
finding_link = f"[{title}](#finding-{number})"
|
|
918
884
|
writeup_link = f"[Open report]({report_path})" if report_path else "inline below"
|
|
919
885
|
lines.append(
|
|
@@ -940,33 +906,6 @@ def build_report_markdown(
|
|
|
940
906
|
else:
|
|
941
907
|
lines.extend(["", *_finding_section(number, finding)])
|
|
942
908
|
else:
|
|
943
|
-
deferred = coverage.get("deferred", [])
|
|
944
|
-
no_source_review = (
|
|
945
|
-
coverage.get("completeness") == "partial"
|
|
946
|
-
and isinstance(deferred, list)
|
|
947
|
-
and any(
|
|
948
|
-
isinstance(item, dict)
|
|
949
|
-
and item.get("reason")
|
|
950
|
-
== "The configured discovery time limit elapsed before any source review completed."
|
|
951
|
-
for item in deferred
|
|
952
|
-
)
|
|
953
|
-
)
|
|
954
|
-
budget_exhausted = (
|
|
955
|
-
coverage.get("completeness") == "partial"
|
|
956
|
-
and isinstance(deferred, list)
|
|
957
|
-
and any(
|
|
958
|
-
isinstance(item, dict)
|
|
959
|
-
and isinstance(item.get("reason"), str)
|
|
960
|
-
and (
|
|
961
|
-
item["reason"]
|
|
962
|
-
== "Validation was deferred because the scan reached its cost limit."
|
|
963
|
-
or item["reason"].startswith(
|
|
964
|
-
"Validation was deferred because the scan reached its cost limit: "
|
|
965
|
-
)
|
|
966
|
-
)
|
|
967
|
-
for item in deferred
|
|
968
|
-
)
|
|
969
|
-
)
|
|
970
909
|
stopped = manifest.get("scan", {}).get("status") in {
|
|
971
910
|
"failed",
|
|
972
911
|
"canceled",
|
|
@@ -980,18 +919,7 @@ def build_report_markdown(
|
|
|
980
919
|
"No findings were retained before the scan stopped. "
|
|
981
920
|
"The scan did not complete. No vulnerability conclusion can be drawn."
|
|
982
921
|
if stopped
|
|
983
|
-
else
|
|
984
|
-
"No source review completed before the configured time limit. "
|
|
985
|
-
"No vulnerability conclusion can be drawn."
|
|
986
|
-
if no_source_review
|
|
987
|
-
else (
|
|
988
|
-
"No findings were validated before the scan reached its cost limit. "
|
|
989
|
-
"Review the deferred candidates in Open Questions And Follow Up."
|
|
990
|
-
if budget_exhausted
|
|
991
|
-
else "No reportable findings survived the canonical discovery, validation, "
|
|
992
|
-
"and reportability gates."
|
|
993
|
-
)
|
|
994
|
-
)
|
|
922
|
+
else "No findings were reported."
|
|
995
923
|
),
|
|
996
924
|
]
|
|
997
925
|
)
|
|
@@ -1078,11 +1006,7 @@ def generate_report_markdown(
|
|
|
1078
1006
|
return build_report_markdown(manifest, findings, coverage).encode("utf-8")
|
|
1079
1007
|
|
|
1080
1008
|
|
|
1081
|
-
|
|
1009
|
+
if __name__ == "__main__":
|
|
1082
1010
|
parser = argparse.ArgumentParser(description=__doc__)
|
|
1083
1011
|
parser.parse_args()
|
|
1084
|
-
|
|
1085
|
-
|
|
1086
|
-
|
|
1087
|
-
if __name__ == "__main__":
|
|
1088
|
-
raise SystemExit(main())
|
|
1012
|
+
raise SystemExit(0)
|
|
@@ -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)
|