@openai/codex-security 0.2.0 → 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 +437 -2692
- package/_bundled_plugin/.app.json +5 -1
- package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
- 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 +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 +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 +10 -12
- 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 +1 -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 +18 -45
- 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 +315 -232
- 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 +99 -829
- 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 +117 -172
- 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 +94 -179
- package/_bundled_plugin/scripts/workbench_db.py +427 -463
- 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 +33 -57
- 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 +23 -34
- 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 +16 -27
- 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 +3 -3
- 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 +1 -1
- package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
- package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
- 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 +60 -10
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +803 -380
- 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 +1087 -900
- 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 +38 -30
- 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 +23 -35
- 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 +15 -3
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +87 -252
- 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 +7 -1
- package/dist/deduplication/codex-review.d.ts.map +1 -1
- package/dist/deduplication/codex-review.js +126 -17
- 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 +57 -47
- 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.map +1 -1
- package/dist/deduplication/records-protocol.js +11 -24
- 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 +2 -0
- package/dist/deep-progress.d.ts.map +1 -1
- package/dist/deep-progress.js +13 -10
- 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/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 +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/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 +8 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -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 +193 -126
- 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 +40 -64
- 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 +2 -8
- 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 +15 -4
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +430 -138
- 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-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 +106 -47
- 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 +1 -0
- package/dist/worker-progress.d.ts.map +1 -1
- package/dist/worker-progress.js +27 -12
- package/dist/worker-progress.js.map +1 -1
- package/docs/cli.md +1778 -0
- package/docs/findings-service.md +402 -0
- package/package.json +18 -19
- 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
|
@@ -28,12 +28,10 @@ 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
33
|
return "".join(
|
|
36
|
-
part if index % 2 else re.sub(r"([
|
|
34
|
+
part if index % 2 else re.sub(r"([\\`*_\[\]<>])", r"\\\1", part)
|
|
37
35
|
for index, part in enumerate(re.split(r"((?<!`)`[^`\n]+`(?!`))", normalized))
|
|
38
36
|
)
|
|
39
37
|
|
|
@@ -43,12 +41,7 @@ def _strings(value: Any) -> list[str]:
|
|
|
43
41
|
value = [value]
|
|
44
42
|
if not isinstance(value, list):
|
|
45
43
|
return []
|
|
46
|
-
|
|
47
|
-
for item in value:
|
|
48
|
-
text = _text(item, "")
|
|
49
|
-
if text:
|
|
50
|
-
normalized.append(text)
|
|
51
|
-
return normalized
|
|
44
|
+
return [text for item in value if (text := _text(item, ""))]
|
|
52
45
|
|
|
53
46
|
|
|
54
47
|
def _cell(value: Any) -> str:
|
|
@@ -96,7 +89,7 @@ def _has_deep_child_metadata(finding: dict[str, Any]) -> bool:
|
|
|
96
89
|
)
|
|
97
90
|
|
|
98
91
|
|
|
99
|
-
def
|
|
92
|
+
def uses_deep_presentation(coverage: dict[str, Any], findings: list[dict[str, Any]]) -> bool:
|
|
100
93
|
if coverage.get("mode") == "deep_repository":
|
|
101
94
|
return True
|
|
102
95
|
if coverage.get("mode") != "scoped_path":
|
|
@@ -218,8 +211,8 @@ def _hardening_portfolio_path(scan: dict[str, Any]) -> str | None:
|
|
|
218
211
|
return portfolio_path
|
|
219
212
|
|
|
220
213
|
|
|
221
|
-
def
|
|
222
|
-
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 []
|
|
223
216
|
|
|
224
217
|
|
|
225
218
|
def _code_evidence_catalog(finding: dict[str, Any]) -> dict[str, dict[str, Any]]:
|
|
@@ -284,8 +277,6 @@ def merged_root_cause(value: dict[str, Any]) -> tuple[str | None, Any]:
|
|
|
284
277
|
details.append({"summary": detail})
|
|
285
278
|
elif isinstance(detail, dict):
|
|
286
279
|
details.append(detail)
|
|
287
|
-
elif detail is not None:
|
|
288
|
-
continue
|
|
289
280
|
if not details:
|
|
290
281
|
return keys[0], None
|
|
291
282
|
|
|
@@ -408,16 +399,16 @@ def _code_evidence_location(item: dict[str, Any]) -> str:
|
|
|
408
399
|
return f"{path}:{start}" if end == start else f"{path}:{start}-{end}"
|
|
409
400
|
|
|
410
401
|
|
|
411
|
-
def _code_fence(code: str) -> str:
|
|
402
|
+
def _code_fence(code: str, minimum: int = 3) -> str:
|
|
412
403
|
longest_run = max((len(match.group(0)) for match in re.finditer(r"`+", code)), default=0)
|
|
413
|
-
return "`" * max(
|
|
404
|
+
return "`" * max(minimum, longest_run + 1)
|
|
414
405
|
|
|
415
406
|
|
|
416
407
|
def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
|
|
417
408
|
lines: list[str] = []
|
|
418
409
|
for index, item in enumerate(evidence):
|
|
419
410
|
label = _text(item.get("label"), f"Code evidence {index + 1}")
|
|
420
|
-
location =
|
|
411
|
+
location = " ".join(_code_evidence_location(item).split())
|
|
421
412
|
explanation = _text(item.get("explanation"), "")
|
|
422
413
|
language = item.get("language") if isinstance(item.get("language"), str) else ""
|
|
423
414
|
language = language if re.fullmatch(r"[A-Za-z0-9_+.-]*", language) else ""
|
|
@@ -425,7 +416,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
|
|
|
425
416
|
fence = _code_fence(code)
|
|
426
417
|
heading = f"**{label}**"
|
|
427
418
|
if location:
|
|
428
|
-
|
|
419
|
+
marker = _code_fence(location, minimum=1)
|
|
420
|
+
padding = " " if location.startswith("`") or location.endswith("`") else ""
|
|
421
|
+
heading += f" — {marker}{padding}{location}{padding}{marker}"
|
|
429
422
|
lines.extend(["", heading])
|
|
430
423
|
if explanation:
|
|
431
424
|
lines.extend(["", explanation])
|
|
@@ -433,22 +426,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
|
|
|
433
426
|
return lines
|
|
434
427
|
|
|
435
428
|
|
|
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
|
-
)
|
|
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"
|
|
452
432
|
|
|
453
433
|
|
|
454
434
|
def _locations(finding: dict[str, Any]) -> str:
|
|
@@ -500,6 +480,71 @@ def _surface_notes(surface: dict[str, Any]) -> str:
|
|
|
500
480
|
return _cell(f"{notes} Evidence: {evidence}")
|
|
501
481
|
|
|
502
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
|
+
|
|
503
548
|
def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
504
549
|
validation = finding.get("validation") if isinstance(finding.get("validation"), dict) else {}
|
|
505
550
|
_, raw_root_cause = merged_root_cause(finding)
|
|
@@ -562,10 +607,6 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
562
607
|
if validation_outcomes
|
|
563
608
|
else f"{finding['confidence']['rationale']} Validation details were not recorded separately.",
|
|
564
609
|
)
|
|
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
610
|
root_cause_summary = _text(
|
|
570
611
|
raw_root_cause if isinstance(raw_root_cause, str) else root_cause.get("summary"),
|
|
571
612
|
"",
|
|
@@ -578,12 +619,9 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
578
619
|
dataflow.get("summary"),
|
|
579
620
|
f"The canonical finding records the affected path at {_locations(finding)}, but no expanded source-to-sink narrative was recorded.",
|
|
580
621
|
)
|
|
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
|
-
),
|
|
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.",
|
|
587
625
|
)
|
|
588
626
|
severity_rationale = _text(
|
|
589
627
|
severity.get("rationale"),
|
|
@@ -593,24 +631,8 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
593
631
|
severity.get("changeConditions"),
|
|
594
632
|
"Additional runtime or deployment evidence could raise or lower this severity.",
|
|
595
633
|
)
|
|
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
634
|
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))} |",
|
|
635
|
+
*_finding_header(number, finding),
|
|
614
636
|
"",
|
|
615
637
|
"#### Summary",
|
|
616
638
|
"",
|
|
@@ -627,29 +649,19 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
627
649
|
if validation_outcomes:
|
|
628
650
|
lines.extend(["", *(f"- **{label}:** {value}" for label, value in validation_outcomes)])
|
|
629
651
|
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.")])
|
|
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))))
|
|
644
659
|
lines.extend(["", "#### Dataflow", "", dataflow_summary])
|
|
645
|
-
|
|
646
|
-
lines.extend(["", "Attack steps:", *_bullets(attack_steps, "None recorded.")])
|
|
660
|
+
lines.extend(_bullet_section("Attack steps:", _strings(attack_path.get("steps"))))
|
|
647
661
|
for label, key in (("Source", "source"), ("Sink", "sink"), ("Outcome", "outcome")):
|
|
648
662
|
if dataflow.get(key):
|
|
649
663
|
lines.extend(["", f"- **{label}:** {_text(dataflow[key], 'not recorded')}"])
|
|
650
|
-
|
|
651
|
-
if transformations:
|
|
652
|
-
lines.extend(["", "Transformations:", *_bullets(transformations, "None recorded.")])
|
|
664
|
+
lines.extend(_bullet_section("Transformations:", _strings(dataflow.get("transformations"))))
|
|
653
665
|
lines.extend(_code_evidence_lines(dataflow_code_evidence))
|
|
654
666
|
lines.extend(["", "#### Reachability", "", reachability_summary])
|
|
655
667
|
for label, key in (
|
|
@@ -669,17 +681,14 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
669
681
|
]
|
|
670
682
|
)
|
|
671
683
|
)
|
|
672
|
-
|
|
673
|
-
lines.extend(["", "Preconditions:", *_bullets(preconditions, "None recorded.")])
|
|
684
|
+
lines.extend(_bullet_section("Preconditions:", preconditions))
|
|
674
685
|
for label, key in (
|
|
675
686
|
("Assumptions", "assumptions"),
|
|
676
687
|
("Existing controls", "controls"),
|
|
677
688
|
("Blind spots", "blindspots"),
|
|
678
689
|
("Limitations", "limitations"),
|
|
679
690
|
):
|
|
680
|
-
|
|
681
|
-
if values:
|
|
682
|
-
lines.extend(["", f"{label}:", *_bullets(values, "None recorded.")])
|
|
691
|
+
lines.extend(_bullet_section(f"{label}:", _strings(attack_path.get(key))))
|
|
683
692
|
lines.extend(_code_evidence_lines(reachability_code_evidence))
|
|
684
693
|
lines.extend(
|
|
685
694
|
[
|
|
@@ -713,41 +722,21 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
|
|
|
713
722
|
lines.extend(
|
|
714
723
|
["", f"{label} assessment:", *(f"- **{name}:** {value}" for name, value in details)]
|
|
715
724
|
)
|
|
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.")])
|
|
725
|
+
lines.extend(_remediation_section(finding))
|
|
728
726
|
return lines
|
|
729
727
|
|
|
730
728
|
|
|
731
729
|
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
730
|
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"):
|
|
731
|
+
lines = _finding_header(number, finding)
|
|
732
|
+
for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity"):
|
|
750
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}."])
|
|
751
740
|
return lines
|
|
752
741
|
|
|
753
742
|
|
|
@@ -777,7 +766,7 @@ def build_report_markdown(
|
|
|
777
766
|
"reportable findings have duplicate writeup reportPath values: "
|
|
778
767
|
+ ", ".join(duplicate_writeup_paths)
|
|
779
768
|
)
|
|
780
|
-
deep_presentation =
|
|
769
|
+
deep_presentation = uses_deep_presentation(coverage, findings)
|
|
781
770
|
deep_finding_groups = _deep_finding_groups(findings, writeup_paths) if deep_presentation else []
|
|
782
771
|
hardening_portfolio_path = _hardening_portfolio_path(scan)
|
|
783
772
|
include_paths = _strings(coverage.get("includePaths", scope.get("includePaths", [])))
|
|
@@ -812,20 +801,19 @@ def build_report_markdown(
|
|
|
812
801
|
f"Excluded {_text(exclusion.get('pattern'), 'unspecified')}: "
|
|
813
802
|
f"{_text(exclusion.get('reason'), 'reason not recorded')}"
|
|
814
803
|
)
|
|
815
|
-
|
|
816
|
-
lines.extend(["", "Limitations and exclusions:", *_bullets(limitations, "None recorded.")])
|
|
804
|
+
lines.extend(_bullet_section("Limitations and exclusions:", limitations))
|
|
817
805
|
summary_count_lines = (
|
|
818
806
|
[
|
|
819
807
|
f"| Reportable DSS findings | {len(deep_finding_groups)} |",
|
|
820
808
|
f"| Report instances | {len(findings)} |",
|
|
821
|
-
f"| Report severity mix | {
|
|
822
|
-
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)} |",
|
|
823
811
|
]
|
|
824
812
|
if deep_presentation
|
|
825
813
|
else [
|
|
826
814
|
f"| Reportable findings | {len(findings)} |",
|
|
827
|
-
f"| Severity mix | {
|
|
828
|
-
f"| Confidence mix | {
|
|
815
|
+
f"| Severity mix | {_level_mix(findings, 'severity', SEVERITY_ORDER)} |",
|
|
816
|
+
f"| Confidence mix | {_level_mix(findings, 'confidence', CONFIDENCE_ORDER)} |",
|
|
829
817
|
]
|
|
830
818
|
)
|
|
831
819
|
lines.extend(
|
|
@@ -837,7 +825,6 @@ def build_report_markdown(
|
|
|
837
825
|
"| --- | --- |",
|
|
838
826
|
f"| Scan outcome | {scan.get('status', 'completed')} |",
|
|
839
827
|
*summary_count_lines,
|
|
840
|
-
f"| Coverage | {coverage['completeness']} |",
|
|
841
828
|
f"| Validation mode | {_cell(scope.get('validationMode', 'not recorded'))} |",
|
|
842
829
|
"",
|
|
843
830
|
"Canonical artifacts: `scan-manifest.json`, `findings.json`, and `coverage.json`. This report is a deterministic projection of those files.",
|
|
@@ -856,20 +843,16 @@ def build_report_markdown(
|
|
|
856
843
|
"No explicit canonical threat-model summary was recorded.",
|
|
857
844
|
)
|
|
858
845
|
)
|
|
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."),
|
|
846
|
+
for heading, key in (
|
|
847
|
+
("Assets", "assets"),
|
|
848
|
+
("Trust Boundaries", "trustBoundaries"),
|
|
849
|
+
("Attacker Capabilities", "attackerCapabilities"),
|
|
850
|
+
("Security Objectives", "securityObjectives"),
|
|
851
|
+
("Assumptions", "assumptions"),
|
|
869
852
|
):
|
|
870
853
|
values = _strings(threat_model.get(key))
|
|
871
854
|
if values:
|
|
872
|
-
lines.extend(["", f"### {heading}", "", *
|
|
855
|
+
lines.extend(["", f"### {heading}", "", *(f"- {value}" for value in values)])
|
|
873
856
|
lines.extend(["", "## Findings", ""])
|
|
874
857
|
if findings:
|
|
875
858
|
if deep_presentation:
|
|
@@ -923,33 +906,6 @@ def build_report_markdown(
|
|
|
923
906
|
else:
|
|
924
907
|
lines.extend(["", *_finding_section(number, finding)])
|
|
925
908
|
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
909
|
stopped = manifest.get("scan", {}).get("status") in {
|
|
954
910
|
"failed",
|
|
955
911
|
"canceled",
|
|
@@ -963,18 +919,7 @@ def build_report_markdown(
|
|
|
963
919
|
"No findings were retained before the scan stopped. "
|
|
964
920
|
"The scan did not complete. No vulnerability conclusion can be drawn."
|
|
965
921
|
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
|
-
)
|
|
922
|
+
else "No findings were reported."
|
|
978
923
|
),
|
|
979
924
|
]
|
|
980
925
|
)
|
|
@@ -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)
|
|
@@ -4,24 +4,14 @@
|
|
|
4
4
|
from __future__ import annotations
|
|
5
5
|
|
|
6
6
|
import argparse
|
|
7
|
-
import importlib.util
|
|
8
7
|
import sys
|
|
9
8
|
from pathlib import Path
|
|
10
|
-
from types import ModuleType
|
|
11
9
|
from typing import Any
|
|
12
10
|
|
|
11
|
+
# Keep sibling helpers importable when Python starts in isolated mode.
|
|
12
|
+
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
|
13
|
+
import validate_scan_contract as SCAN_CONTRACT
|
|
13
14
|
|
|
14
|
-
def _load_scan_contract_validator() -> ModuleType:
|
|
15
|
-
script = Path(__file__).resolve().with_name("validate_scan_contract.py")
|
|
16
|
-
spec = importlib.util.spec_from_file_location("codex_security_scan_validator", script)
|
|
17
|
-
if spec is None or spec.loader is None:
|
|
18
|
-
raise RuntimeError(f"could not load scan contract validator: {script}")
|
|
19
|
-
module = importlib.util.module_from_spec(spec)
|
|
20
|
-
spec.loader.exec_module(module)
|
|
21
|
-
return module
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
SCAN_CONTRACT = _load_scan_contract_validator()
|
|
25
15
|
FINALIZER = SCAN_CONTRACT.FINALIZER
|
|
26
16
|
validate_contract = SCAN_CONTRACT.validate_contract
|
|
27
17
|
|