@openai/codex-security 0.8.2 → 0.9.1
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 +201 -178
- package/_bundled_plugin/.app.json +4 -0
- package/_bundled_plugin/.mcp.json +6 -1
- package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
- package/_bundled_plugin/examples/completed-scan/report.md +11 -8
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
- package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
- package/_bundled_plugin/mcp/helpers.mjs +2 -11
- package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
- package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
- package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
- package/_bundled_plugin/mcp/package.json +1 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +51 -14
- package/_bundled_plugin/mcp/server.mjs +2 -11
- package/_bundled_plugin/mcp/server.mjs.br +0 -0
- package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
- package/_bundled_plugin/references/artifact-storage.md +1 -1
- package/_bundled_plugin/references/core-scan.md +14 -5
- package/_bundled_plugin/references/default-severity-rubric.md +33 -0
- package/_bundled_plugin/references/final-report.md +5 -3
- package/_bundled_plugin/references/finding-detail-fields.md +19 -18
- package/_bundled_plugin/references/sarif-adapter.md +8 -2
- package/_bundled_plugin/references/scan-artifacts.md +21 -12
- package/_bundled_plugin/references/scan-contract.md +27 -33
- package/_bundled_plugin/references/threat-model.md +1 -0
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
- package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
- package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
- package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
- package/_bundled_plugin/scripts/deep_scan_workbench.py +188 -454
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +317 -377
- package/_bundled_plugin/scripts/finding_preview.py +25 -29
- package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
- package/_bundled_plugin/scripts/legacy_findings.py +148 -0
- package/_bundled_plugin/scripts/posix_scan_local_files.py +198 -0
- package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
- package/_bundled_plugin/scripts/report_projection.py +167 -178
- package/_bundled_plugin/scripts/review_state.py +8 -2
- package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
- package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
- package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
- package/_bundled_plugin/scripts/validate_scan_contract.py +9 -7
- package/_bundled_plugin/scripts/windows_scan_local_files.py +600 -72
- package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
- package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
- package/_bundled_plugin/scripts/workbench/retained_coverage.py +38 -75
- package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
- package/_bundled_plugin/scripts/workbench/saved_coverage.py +152 -248
- package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
- package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
- package/_bundled_plugin/scripts/workbench/storage.py +71 -7
- package/_bundled_plugin/scripts/workbench_cli.py +121 -14
- package/_bundled_plugin/scripts/workbench_constants.py +19 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
- package/_bundled_plugin/scripts/workbench_db.py +550 -492
- package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
- package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +90 -4
- package/_bundled_plugin/scripts/workbench_native_indexes.py +29 -33
- package/_bundled_plugin/scripts/workbench_progress.py +10 -1
- package/_bundled_plugin/scripts/workbench_publication.py +14 -10
- package/_bundled_plugin/scripts/workbench_remediation.py +508 -11
- package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
- package/_bundled_plugin/scripts/workbench_scan_history.py +139 -80
- package/_bundled_plugin/scripts/workbench_scan_start.py +84 -25
- package/_bundled_plugin/scripts/workbench_scan_usage.py +666 -117
- package/_bundled_plugin/scripts/workbench_schema.py +44 -55
- package/_bundled_plugin/scripts/workbench_setup.py +251 -0
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
- package/_bundled_plugin/scripts/workbench_source_scopes.py +33 -23
- package/_bundled_plugin/scripts/workbench_target.py +330 -66
- package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
- package/_bundled_plugin/scripts/workbench_validation.py +44 -12
- package/_bundled_plugin/shared/workbench-history-repairs.json +19 -16
- package/_bundled_plugin/shared/workbench-migrations.json +53 -0
- package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -1
- package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +4 -68
- package/_bundled_plugin/skills/check-skills/SKILL.md +43 -0
- package/_bundled_plugin/skills/check-skills/agents/openai.yaml +4 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +6 -4
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
- package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -2
- package/_bundled_plugin/skills/publish-findings/SKILL.md +81 -45
- package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
- package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +5 -24
- package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
- package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +36 -9
- package/_bundled_plugin/skills/track-findings/SKILL.md +5 -3
- package/_bundled_plugin/skills/triage-finding/references/github-rest-intake.md +22 -68
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +12 -6
- package/dist/api.d.ts +45 -5
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +1144 -411
- package/dist/api.js.map +1 -1
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +10 -7
- package/dist/auth.js.map +1 -1
- package/dist/bedrock-oss-pricing.d.ts +6 -0
- package/dist/bedrock-oss-pricing.d.ts.map +1 -0
- package/dist/bedrock-oss-pricing.js +58 -0
- package/dist/bedrock-oss-pricing.js.map +1 -0
- package/dist/bedrock-pricing.d.ts +15 -0
- package/dist/bedrock-pricing.d.ts.map +1 -0
- package/dist/bedrock-pricing.js +117 -0
- package/dist/bedrock-pricing.js.map +1 -0
- package/dist/blackduck-findings.d.ts +8 -0
- package/dist/blackduck-findings.d.ts.map +1 -0
- package/dist/blackduck-findings.js +320 -0
- package/dist/blackduck-findings.js.map +1 -0
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +51 -36
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/checkmarx-evidence.d.ts +19 -0
- package/dist/checkmarx-evidence.d.ts.map +1 -0
- package/dist/checkmarx-evidence.js +36 -0
- package/dist/checkmarx-evidence.js.map +1 -0
- package/dist/checkmarx-findings.d.ts +4 -0
- package/dist/checkmarx-findings.d.ts.map +1 -0
- package/dist/checkmarx-findings.js +27 -0
- package/dist/checkmarx-findings.js.map +1 -0
- package/dist/checkmarx-one.d.ts +4 -0
- package/dist/checkmarx-one.d.ts.map +1 -0
- package/dist/checkmarx-one.js +53 -0
- package/dist/checkmarx-one.js.map +1 -0
- package/dist/checkmarx-repository.d.ts +12 -0
- package/dist/checkmarx-repository.d.ts.map +1 -0
- package/dist/checkmarx-repository.js +181 -0
- package/dist/checkmarx-repository.js.map +1 -0
- package/dist/checkmarx-xml.d.ts +12 -0
- package/dist/checkmarx-xml.d.ts.map +1 -0
- package/dist/checkmarx-xml.js +196 -0
- package/dist/checkmarx-xml.js.map +1 -0
- package/dist/classify-severity-records.d.ts +6 -9
- package/dist/classify-severity-records.d.ts.map +1 -1
- package/dist/classify-severity-records.js +9 -21
- package/dist/classify-severity-records.js.map +1 -1
- package/dist/classify-severity.d.ts +4 -1
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +30 -13
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli.d.ts +14 -5
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +2112 -1266
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.js +2 -2
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codex-prompt.d.ts +2 -0
- package/dist/codex-prompt.d.ts.map +1 -1
- package/dist/codex-prompt.js +6 -0
- package/dist/codex-prompt.js.map +1 -1
- package/dist/component-scan.d.ts +16 -3
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +32 -6
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts +2 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +221 -65
- package/dist/config.js.map +1 -1
- package/dist/continuum-findings.d.ts +7 -0
- package/dist/continuum-findings.d.ts.map +1 -0
- package/dist/continuum-findings.js +225 -0
- package/dist/continuum-findings.js.map +1 -0
- package/dist/contract-values.d.ts +30 -0
- package/dist/contract-values.d.ts.map +1 -0
- package/dist/contract-values.js +78 -0
- package/dist/contract-values.js.map +1 -0
- package/dist/contract.d.ts +2 -20
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +58 -669
- package/dist/contract.js.map +1 -1
- package/dist/cost-model.d.ts +13 -1
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +66 -115
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +61 -4
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +2560 -100
- package/dist/cost.js.map +1 -1
- package/dist/custom-publish.d.ts +4 -0
- package/dist/custom-publish.d.ts.map +1 -1
- package/dist/custom-publish.js +40 -3
- package/dist/custom-publish.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +5 -0
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/custom-validation.d.ts +2 -0
- package/dist/custom-validation.d.ts.map +1 -1
- package/dist/custom-validation.js +4 -0
- package/dist/custom-validation.js.map +1 -1
- package/dist/deduplication/deduplication-prompts.d.ts +4 -4
- package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
- package/dist/deduplication/deduplication-prompts.js +2 -2
- package/dist/deduplication/deduplication-prompts.js.map +1 -1
- package/dist/deduplication/deduplication-reviewer.d.ts +14 -11
- package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
- package/dist/deduplication/deduplication-reviewer.js +11 -4
- package/dist/deduplication/deduplication-reviewer.js.map +1 -1
- package/dist/deduplication/deduplication.js.map +1 -1
- package/dist/deduplication/finding-schema.d.ts +19 -1
- package/dist/deduplication/finding-schema.d.ts.map +1 -1
- package/dist/deduplication/finding-schema.js +25 -0
- package/dist/deduplication/finding-schema.js.map +1 -1
- package/dist/deduplication/local.d.ts +2 -2
- package/dist/deduplication/local.d.ts.map +1 -1
- package/dist/deduplication/local.js +5 -10
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/records.d.ts +8 -2
- package/dist/deduplication/records.d.ts.map +1 -1
- package/dist/deduplication/records.js +36 -8
- package/dist/deduplication/records.js.map +1 -1
- package/dist/deduplication/refusal.d.ts.map +1 -1
- package/dist/deduplication/refusal.js +25 -5
- package/dist/deduplication/refusal.js.map +1 -1
- package/dist/deduplication/scan.d.ts +3 -0
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +1 -1
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +0 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +22 -33
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-scan-defaults.d.ts +2 -0
- package/dist/deep-scan-defaults.d.ts.map +1 -1
- package/dist/deep-scan-defaults.js +28 -1
- package/dist/deep-scan-defaults.js.map +1 -1
- package/dist/deep-scan.d.ts +13 -0
- package/dist/deep-scan.d.ts.map +1 -1
- package/dist/deep-scan.js +262 -7
- package/dist/deep-scan.js.map +1 -1
- package/dist/default-severity-rubric.d.ts +1 -2
- package/dist/default-severity-rubric.d.ts.map +1 -1
- package/dist/default-severity-rubric.js +2 -66
- package/dist/default-severity-rubric.js.map +1 -1
- package/dist/endor-findings.d.ts +3 -1
- package/dist/endor-findings.d.ts.map +1 -1
- package/dist/endor-findings.js +108 -80
- package/dist/endor-findings.js.map +1 -1
- package/dist/errors.d.ts +1 -1
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +9 -2
- package/dist/errors.js.map +1 -1
- package/dist/external-findings-import.d.ts +5 -3
- package/dist/external-findings-import.d.ts.map +1 -1
- package/dist/external-findings-import.js +11 -16
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +15 -4
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +619 -225
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +20 -6
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +2356 -308
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +28 -2
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +174 -81
- package/dist/external-findings-read.js.map +1 -1
- package/dist/external-findings.d.ts +17 -3
- package/dist/external-findings.d.ts.map +1 -1
- package/dist/external-findings.js +153 -1
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +33 -1
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +335 -51
- package/dist/external-import-contract.js.map +1 -1
- package/dist/external-import-models.d.ts +1 -1
- package/dist/external-import-models.d.ts.map +1 -1
- package/dist/external-import-models.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +5 -4
- package/dist/feedback.js.map +1 -1
- package/dist/finding-prompt.d.ts +5 -0
- package/dist/finding-prompt.d.ts.map +1 -0
- package/dist/finding-prompt.js +32 -0
- package/dist/finding-prompt.js.map +1 -0
- package/dist/finding-retrieval.d.ts +3 -3
- package/dist/finding-retrieval.d.ts.map +1 -1
- package/dist/finding-retrieval.js.map +1 -1
- package/dist/finding-workflow.d.ts +6 -1
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +2 -2
- package/dist/finding-workflow.js.map +1 -1
- package/dist/findings-client.d.ts +1 -0
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +27 -3
- package/dist/findings-client.js.map +1 -1
- package/dist/git-remote.d.ts +4 -0
- package/dist/git-remote.d.ts.map +1 -1
- package/dist/git-remote.js +20 -0
- package/dist/git-remote.js.map +1 -1
- package/dist/github-advisories.d.ts +3 -12
- package/dist/github-advisories.d.ts.map +1 -1
- package/dist/github-advisories.js +9 -31
- package/dist/github-advisories.js.map +1 -1
- package/dist/github-dependabot-findings.d.ts.map +1 -1
- package/dist/github-dependabot-findings.js +22 -20
- package/dist/github-dependabot-findings.js.map +1 -1
- package/dist/github-findings.d.ts +4 -1
- package/dist/github-findings.d.ts.map +1 -1
- package/dist/github-findings.js +392 -79
- package/dist/github-findings.js.map +1 -1
- package/dist/github.d.ts +17 -7
- package/dist/github.d.ts.map +1 -1
- package/dist/github.js +43 -30
- package/dist/github.js.map +1 -1
- package/dist/host-protocol.d.ts +2 -2
- package/dist/host-protocol.d.ts.map +1 -1
- package/dist/host-protocol.js.map +1 -1
- package/dist/host-records-protocol.d.ts +10 -11
- package/dist/host-records-protocol.d.ts.map +1 -1
- package/dist/host-records-protocol.js +69 -9
- package/dist/host-records-protocol.js.map +1 -1
- package/dist/hosted-git-remotes.d.ts +5 -0
- package/dist/hosted-git-remotes.d.ts.map +1 -0
- package/dist/hosted-git-remotes.js +285 -0
- package/dist/hosted-git-remotes.js.map +1 -0
- package/dist/hosted-git-repository.d.ts +28 -0
- package/dist/hosted-git-repository.d.ts.map +1 -0
- package/dist/hosted-git-repository.js +222 -0
- package/dist/hosted-git-repository.js.map +1 -0
- package/dist/hosted-scan-protocol.js +2 -2
- package/dist/hosted-scan-protocol.js.map +1 -1
- package/dist/hosted-scan.d.ts +15 -0
- package/dist/hosted-scan.d.ts.map +1 -1
- package/dist/hosted-scan.js +71 -44
- package/dist/hosted-scan.js.map +1 -1
- package/dist/hosted-scanner-http.d.ts +21 -0
- package/dist/hosted-scanner-http.d.ts.map +1 -0
- package/dist/hosted-scanner-http.js +204 -0
- package/dist/hosted-scanner-http.js.map +1 -0
- package/dist/hosted-scanner-v1.d.ts +6 -0
- package/dist/hosted-scanner-v1.d.ts.map +1 -0
- package/dist/hosted-scanner-v1.js +60 -0
- package/dist/hosted-scanner-v1.js.map +1 -0
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +3 -0
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +24 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +15 -1
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +58 -81
- package/dist/inspector-findings.js.map +1 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +86 -10
- package/dist/knowledge-base.js.map +1 -1
- package/dist/local-git-metadata.d.ts +5 -0
- package/dist/local-git-metadata.d.ts.map +1 -0
- package/dist/local-git-metadata.js +130 -0
- package/dist/local-git-metadata.js.map +1 -0
- package/dist/multiscan.d.ts +6 -4
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +160 -77
- package/dist/multiscan.js.map +1 -1
- package/dist/native-json-findings.d.ts +2 -1
- package/dist/native-json-findings.d.ts.map +1 -1
- package/dist/native-json-findings.js +12 -2
- package/dist/native-json-findings.js.map +1 -1
- package/dist/opengrep-findings.d.ts +1 -0
- package/dist/opengrep-findings.d.ts.map +1 -1
- package/dist/opengrep-findings.js +49 -31
- package/dist/opengrep-findings.js.map +1 -1
- package/dist/operation-telemetry.d.ts +104 -0
- package/dist/operation-telemetry.d.ts.map +1 -0
- package/dist/operation-telemetry.js +293 -0
- package/dist/operation-telemetry.js.map +1 -0
- package/dist/patch-tui.d.ts.map +1 -1
- package/dist/patch-tui.js +90 -35
- package/dist/patch-tui.js.map +1 -1
- package/dist/plugin-python-probe.d.ts +4 -0
- package/dist/plugin-python-probe.d.ts.map +1 -0
- package/dist/plugin-python-probe.js +10 -0
- package/dist/plugin-python-probe.js.map +1 -0
- package/dist/private-finding-import.d.ts +341 -0
- package/dist/private-finding-import.d.ts.map +1 -0
- package/dist/private-finding-import.js +411 -0
- package/dist/private-finding-import.js.map +1 -0
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +2 -2
- package/dist/project-config.js.map +1 -1
- package/dist/provider-profile.d.ts +11 -3
- package/dist/provider-profile.d.ts.map +1 -1
- package/dist/provider-profile.js +80 -11
- package/dist/provider-profile.js.map +1 -1
- package/dist/publication-telemetry.d.ts +45 -0
- package/dist/publication-telemetry.d.ts.map +1 -0
- package/dist/publication-telemetry.js +50 -0
- package/dist/publication-telemetry.js.map +1 -0
- package/dist/publication.js +7 -1
- package/dist/publication.js.map +1 -1
- package/dist/publish.d.ts +4 -0
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +42 -2
- package/dist/publish.js.map +1 -1
- package/dist/reader-selection.d.ts +15 -0
- package/dist/reader-selection.d.ts.map +1 -0
- package/dist/reader-selection.js +89 -0
- package/dist/reader-selection.js.map +1 -0
- package/dist/record.d.ts +6 -1
- package/dist/record.d.ts.map +1 -1
- package/dist/record.js +53 -2
- package/dist/record.js.map +1 -1
- package/dist/remediation.d.ts +3 -1
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +28 -2
- package/dist/remediation.js.map +1 -1
- package/dist/request-metadata.d.ts +3 -0
- package/dist/request-metadata.d.ts.map +1 -1
- package/dist/request-metadata.js +9 -0
- package/dist/request-metadata.js.map +1 -1
- package/dist/result.d.ts +6 -0
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +3 -1
- package/dist/result.js.map +1 -1
- package/dist/retry-windows-rename.d.ts +8 -0
- package/dist/retry-windows-rename.d.ts.map +1 -0
- package/dist/retry-windows-rename.js +24 -0
- package/dist/retry-windows-rename.js.map +1 -0
- package/dist/runtime.d.ts +22 -1
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +408 -162
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +1 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -1
- package/dist/saved-scan-bootstrap.js +18 -15
- package/dist/saved-scan-bootstrap.js.map +1 -1
- package/dist/scan-activity.d.ts.map +1 -1
- package/dist/scan-activity.js +172 -64
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +10 -5
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +68 -25
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +7 -6
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +91 -79
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts +12 -1
- package/dist/scan-executor.d.ts.map +1 -1
- package/dist/scan-executor.js +22 -2
- package/dist/scan-executor.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +31 -28
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-logs.d.ts +12 -0
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +106 -77
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-measurement.d.ts +26 -0
- package/dist/scan-measurement.d.ts.map +1 -0
- package/dist/scan-measurement.js +77 -0
- package/dist/scan-measurement.js.map +1 -0
- package/dist/scan-progress.d.ts +1 -0
- package/dist/scan-progress.d.ts.map +1 -1
- package/dist/scan-progress.js +3 -0
- package/dist/scan-progress.js.map +1 -1
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +4 -1
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-settings.d.ts +1 -1
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +1 -24
- package/dist/scan-settings.js.map +1 -1
- package/dist/scanner-import.d.ts +64 -6
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +406 -48
- package/dist/scanner-import.js.map +1 -1
- package/dist/scanner-repository-url.d.ts +17 -0
- package/dist/scanner-repository-url.d.ts.map +1 -0
- package/dist/scanner-repository-url.js +71 -0
- package/dist/scanner-repository-url.js.map +1 -0
- package/dist/security-policy.d.ts +1 -1
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js.map +1 -1
- package/dist/semgrep-findings.d.ts +6 -3
- package/dist/semgrep-findings.d.ts.map +1 -1
- package/dist/semgrep-findings.js +124 -88
- package/dist/semgrep-findings.js.map +1 -1
- package/dist/semgrep-guardian-findings.d.ts +38 -0
- package/dist/semgrep-guardian-findings.d.ts.map +1 -0
- package/dist/semgrep-guardian-findings.js +165 -0
- package/dist/semgrep-guardian-findings.js.map +1 -0
- package/dist/semgrep-platform-collector.d.ts +26 -0
- package/dist/semgrep-platform-collector.d.ts.map +1 -0
- package/dist/semgrep-platform-collector.js +108 -0
- package/dist/semgrep-platform-collector.js.map +1 -0
- package/dist/semgrep-platform-findings.d.ts +213 -0
- package/dist/semgrep-platform-findings.d.ts.map +1 -0
- package/dist/semgrep-platform-findings.js +1078 -0
- package/dist/semgrep-platform-findings.js.map +1 -0
- package/dist/semgrep-platform-v1.d.ts +6 -0
- package/dist/semgrep-platform-v1.d.ts.map +1 -0
- package/dist/semgrep-platform-v1.js +83 -0
- package/dist/semgrep-platform-v1.js.map +1 -0
- package/dist/server/api.d.ts +1 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embedding-tokenizer.cdx.json +33 -0
- package/dist/server/embedding-tokenizer.d.ts +2 -0
- package/dist/server/embedding-tokenizer.d.ts.map +1 -0
- package/dist/server/embedding-tokenizer.js +322 -0
- package/dist/server/embedding-tokenizer.js.map +6 -0
- package/dist/server/embeddings.d.ts +16 -2
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +35 -5
- package/dist/server/embeddings.js.map +1 -1
- package/dist/session-lines.d.ts +5 -0
- package/dist/session-lines.d.ts.map +1 -0
- package/dist/session-lines.js +60 -0
- package/dist/session-lines.js.map +1 -0
- package/dist/severity-review.d.ts +3 -1
- package/dist/severity-review.d.ts.map +1 -1
- package/dist/severity-review.js +3 -2
- package/dist/severity-review.js.map +1 -1
- package/dist/severity-rubric.d.ts +20 -0
- package/dist/severity-rubric.d.ts.map +1 -0
- package/dist/severity-rubric.js +73 -0
- package/dist/severity-rubric.js.map +1 -0
- package/dist/severity-store.js +15 -5
- package/dist/severity-store.js.map +1 -1
- package/dist/skill-authentication.d.ts +1 -0
- package/dist/skill-authentication.d.ts.map +1 -1
- package/dist/skill-authentication.js +1 -0
- package/dist/skill-authentication.js.map +1 -1
- package/dist/snyk-findings.d.ts +7 -2
- package/dist/snyk-findings.d.ts.map +1 -1
- package/dist/snyk-findings.js +108 -84
- package/dist/snyk-findings.js.map +1 -1
- package/dist/snyk-rest-findings.d.ts +76 -0
- package/dist/snyk-rest-findings.d.ts.map +1 -0
- package/dist/snyk-rest-findings.js +1051 -0
- package/dist/snyk-rest-findings.js.map +1 -0
- package/dist/snyk-rest-v1.d.ts +28 -0
- package/dist/snyk-rest-v1.d.ts.map +1 -0
- package/dist/snyk-rest-v1.js +132 -0
- package/dist/snyk-rest-v1.js.map +1 -0
- package/dist/snyk-token-origin.d.ts +4 -0
- package/dist/snyk-token-origin.d.ts.map +1 -0
- package/dist/snyk-token-origin.js +82 -0
- package/dist/snyk-token-origin.js.map +1 -0
- package/dist/sonar-collector.d.ts +16 -0
- package/dist/sonar-collector.d.ts.map +1 -0
- package/dist/sonar-collector.js +380 -0
- package/dist/sonar-collector.js.map +1 -0
- package/dist/sonar-findings.d.ts +49 -0
- package/dist/sonar-findings.d.ts.map +1 -0
- package/dist/sonar-findings.js +288 -0
- package/dist/sonar-findings.js.map +1 -0
- package/dist/sonar-import.d.ts +111 -0
- package/dist/sonar-import.d.ts.map +1 -0
- package/dist/sonar-import.js +277 -0
- package/dist/sonar-import.js.map +1 -0
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +2 -1
- package/dist/suggest-owners.js.map +1 -1
- package/dist/target-drift.d.ts +9 -0
- package/dist/target-drift.d.ts.map +1 -0
- package/dist/target-drift.js +27 -0
- package/dist/target-drift.js.map +1 -0
- package/dist/targets.d.ts +5 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +73 -31
- package/dist/targets.js.map +1 -1
- package/dist/tenable-findings.d.ts +9 -0
- package/dist/tenable-findings.d.ts.map +1 -0
- package/dist/tenable-findings.js +122 -0
- package/dist/tenable-findings.js.map +1 -0
- package/dist/terminal-columns.d.ts +4 -0
- package/dist/terminal-columns.d.ts.map +1 -0
- package/dist/terminal-columns.js +19 -0
- package/dist/terminal-columns.js.map +1 -0
- package/dist/terminal-stream.d.ts +13 -0
- package/dist/terminal-stream.d.ts.map +1 -0
- package/dist/terminal-stream.js +35 -0
- package/dist/terminal-stream.js.map +1 -0
- package/dist/trivy-findings.d.ts +19 -0
- package/dist/trivy-findings.d.ts.map +1 -0
- package/dist/trivy-findings.js +435 -0
- package/dist/trivy-findings.js.map +1 -0
- package/dist/trivy-import.d.ts +19 -0
- package/dist/trivy-import.d.ts.map +1 -0
- package/dist/trivy-import.js +151 -0
- package/dist/trivy-import.js.map +1 -0
- package/dist/validation-records.d.ts +0 -3
- package/dist/validation-records.d.ts.map +1 -1
- package/dist/validation-records.js +1 -17
- package/dist/validation-records.js.map +1 -1
- package/dist/veracode-findings.d.ts +9 -0
- package/dist/veracode-findings.d.ts.map +1 -0
- package/dist/veracode-findings.js +409 -0
- package/dist/veracode-findings.js.map +1 -0
- package/dist/vertex-pricing.d.ts +8 -0
- package/dist/vertex-pricing.d.ts.map +1 -0
- package/dist/vertex-pricing.js +20 -0
- package/dist/vertex-pricing.js.map +1 -0
- package/dist/windows-path.d.ts +1 -0
- package/dist/windows-path.d.ts.map +1 -1
- package/dist/windows-path.js +27 -1
- package/dist/windows-path.js.map +1 -1
- package/dist/wiz-csv.d.ts +2 -2
- package/dist/wiz-csv.d.ts.map +1 -1
- package/dist/wiz-csv.js +1 -3
- package/dist/wiz-csv.js.map +1 -1
- package/dist/wiz-findings.d.ts +14 -2
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +143 -50
- package/dist/wiz-findings.js.map +1 -1
- package/docs/classify-severity-records.md +28 -13
- package/docs/cli.md +623 -843
- package/docs/dedupe-records.md +54 -24
- package/docs/findings-service.md +87 -47
- package/docs/hosted-remediation.md +14 -7
- package/docs/hosted-scans.md +64 -41
- package/docs/telemetry.md +236 -0
- package/docs/validate-records.md +78 -44
- package/package.json +19 -17
- package/schemas/external-findings.schema.json +14 -1
- package/schemas/hosted-scan-v2.fixture.json +16 -1
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
- package/_bundled_plugin/scripts/validate_tracking_source.py +0 -82
- package/_bundled_plugin/scripts/workbench_local_dedupe.py +0 -136
- package/dist/deduplication/records-protocol.d.ts +0 -4
- package/dist/deduplication/records-protocol.d.ts.map +0 -1
- package/dist/deduplication/records-protocol.js +0 -49
- package/dist/deduplication/records-protocol.js.map +0 -1
- package/dist/external-imports-feature.d.ts +0 -6
- package/dist/external-imports-feature.d.ts.map +0 -1
- package/dist/external-imports-feature.js +0 -51
- package/dist/external-imports-feature.js.map +0 -1
- package/dist/finding-normalization.d.ts +0 -5
- package/dist/finding-normalization.d.ts.map +0 -1
- package/dist/finding-normalization.js +0 -120
- package/dist/finding-normalization.js.map +0 -1
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
import { SaxesParser } from "saxes";
|
|
2
|
+
import { asRecord } from "./record.js";
|
|
3
|
+
import { checkmarxEvidence } from "./checkmarx-evidence.js";
|
|
4
|
+
import { array, normalizeRecords, record, requiredText, stableId, text, } from "./scanner-import.js";
|
|
5
|
+
function fields(element) {
|
|
6
|
+
return Object.fromEntries(element.children
|
|
7
|
+
.filter((child) => !child.children.length)
|
|
8
|
+
.map((child) => [child.name, child.text]));
|
|
9
|
+
}
|
|
10
|
+
function pathNode(element) {
|
|
11
|
+
const node = fields(element);
|
|
12
|
+
const snippet = element.children.find((child) => child.name === "Snippet");
|
|
13
|
+
if (snippet)
|
|
14
|
+
node["Snippet"] = snippet.children
|
|
15
|
+
.filter((child) => child.name === "Line")
|
|
16
|
+
.map(fields);
|
|
17
|
+
return node;
|
|
18
|
+
}
|
|
19
|
+
const viewerPath = "/cxwebclient/viewermain.aspx";
|
|
20
|
+
function viewerLink(value) {
|
|
21
|
+
const url = typeof value === "string" ? URL.parse(value) : null;
|
|
22
|
+
if (url &&
|
|
23
|
+
/^https?:$/u.test(url.protocol) &&
|
|
24
|
+
url.pathname.toLowerCase().endsWith(viewerPath))
|
|
25
|
+
return url;
|
|
26
|
+
}
|
|
27
|
+
function viewerInstance(link) {
|
|
28
|
+
return link && link.origin + link.pathname.slice(0, -viewerPath.length);
|
|
29
|
+
}
|
|
30
|
+
function instanceKey(value) {
|
|
31
|
+
const url = URL.parse(value);
|
|
32
|
+
return url && /^https?:$/u.test(url.protocol) ? url.href : value;
|
|
33
|
+
}
|
|
34
|
+
export function checkmarxXmlInstance(current, next) {
|
|
35
|
+
if (current !== undefined &&
|
|
36
|
+
next !== undefined &&
|
|
37
|
+
current !== next &&
|
|
38
|
+
instanceKey(current) !== instanceKey(next))
|
|
39
|
+
throw new Error("CxSAST viewer links must identify the same instance.");
|
|
40
|
+
return current ?? next;
|
|
41
|
+
}
|
|
42
|
+
function viewerId(link, field, expected) {
|
|
43
|
+
let selected = expected;
|
|
44
|
+
for (const [key, id] of link?.searchParams ?? []) {
|
|
45
|
+
if (!id || key.toLowerCase() !== field)
|
|
46
|
+
continue;
|
|
47
|
+
if (selected !== undefined && selected !== id)
|
|
48
|
+
throw new Error(`CxSAST DeepLink ${field} does not match the report.`);
|
|
49
|
+
selected = id;
|
|
50
|
+
}
|
|
51
|
+
return selected;
|
|
52
|
+
}
|
|
53
|
+
export function checkmarxResultViewer(source) {
|
|
54
|
+
return viewerLink(asRecord(source?.["result"])?.["DeepLink"]);
|
|
55
|
+
}
|
|
56
|
+
export function checkmarxXmlScope(source, scanId, projectId) {
|
|
57
|
+
const link = checkmarxResultViewer(source);
|
|
58
|
+
viewerId(link, "pathid", text(asRecord(source["path"])?.["PathId"]) ?? undefined);
|
|
59
|
+
const instance = source["instance"];
|
|
60
|
+
return {
|
|
61
|
+
instance: checkmarxXmlInstance(instance === undefined
|
|
62
|
+
? undefined
|
|
63
|
+
: requiredText(instance, "CxSAST instance"), viewerInstance(link)),
|
|
64
|
+
scanId: viewerId(link, "scanid", scanId),
|
|
65
|
+
projectId: viewerId(link, "projectid", projectId),
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
function readReport(contents) {
|
|
69
|
+
const rows = [];
|
|
70
|
+
const stack = [];
|
|
71
|
+
const parser = new SaxesParser({ xmlns: false });
|
|
72
|
+
let scanId = "";
|
|
73
|
+
let rootInstance;
|
|
74
|
+
const project = { projectId: "" };
|
|
75
|
+
parser.on("opentag", ({ name, attributes }) => {
|
|
76
|
+
const element = { name, attributes, children: [], text: "" };
|
|
77
|
+
if (!stack.length) {
|
|
78
|
+
if (name !== "CxXMLResults")
|
|
79
|
+
throw new Error("Expected a Checkmarx CxSAST CxXMLResults report.");
|
|
80
|
+
project.projectId = requiredText(attributes["ProjectId"], "CxSAST ProjectId");
|
|
81
|
+
scanId = requiredText(attributes["ScanId"], "CxSAST ScanId");
|
|
82
|
+
const projectName = text(attributes["ProjectName"]);
|
|
83
|
+
const team = text(attributes["TeamFullPathOnReportDate"]);
|
|
84
|
+
if (projectName)
|
|
85
|
+
project["projectName"] = projectName;
|
|
86
|
+
if (team)
|
|
87
|
+
project["teamFullPathOnReportDate"] = team;
|
|
88
|
+
const link = viewerLink(attributes["DeepLink"]);
|
|
89
|
+
viewerId(link, "scanid", scanId);
|
|
90
|
+
viewerId(link, "projectid", project.projectId);
|
|
91
|
+
rootInstance = viewerInstance(link);
|
|
92
|
+
}
|
|
93
|
+
else if ((stack.length === 1 && name !== "Query") ||
|
|
94
|
+
(stack.length === 2 && name !== "Result")) {
|
|
95
|
+
throw new Error("Expected CxSAST results directly under their Query.");
|
|
96
|
+
}
|
|
97
|
+
// Only build subtrees within the current result, then release them.
|
|
98
|
+
if (stack.length >= 3)
|
|
99
|
+
stack.at(-1).children.push(element);
|
|
100
|
+
stack.push(element);
|
|
101
|
+
});
|
|
102
|
+
function appendText(value) {
|
|
103
|
+
const element = stack.at(-1);
|
|
104
|
+
if (element)
|
|
105
|
+
element.text += value;
|
|
106
|
+
}
|
|
107
|
+
parser.on("text", appendText);
|
|
108
|
+
parser.on("cdata", appendText);
|
|
109
|
+
parser.on("closetag", () => {
|
|
110
|
+
const element = stack.pop();
|
|
111
|
+
const parent = stack.at(-1);
|
|
112
|
+
if (parent?.name !== "Query" || stack.length !== 2)
|
|
113
|
+
return;
|
|
114
|
+
const paths = element.children.filter((child) => child.name === "Path");
|
|
115
|
+
const path = paths.length === 1 ? paths[0] : undefined;
|
|
116
|
+
rows.push({
|
|
117
|
+
...project,
|
|
118
|
+
query: parent.attributes,
|
|
119
|
+
result: element.attributes,
|
|
120
|
+
path: path?.attributes ?? null,
|
|
121
|
+
nodes: path?.children
|
|
122
|
+
.filter((child) => child.name === "PathNode")
|
|
123
|
+
.map(pathNode) ?? [],
|
|
124
|
+
});
|
|
125
|
+
});
|
|
126
|
+
parser.write(contents).close();
|
|
127
|
+
return { rows, project, scanId, rootInstance };
|
|
128
|
+
}
|
|
129
|
+
/** SimilarityId groups paths, including paths with different intermediate nodes. */
|
|
130
|
+
export function checkmarxXmlId(source) {
|
|
131
|
+
const projectId = requiredText(source["projectId"], "CxSAST ProjectId");
|
|
132
|
+
const query = record(source["query"], "CxSAST Query");
|
|
133
|
+
const result = record(source["result"], "CxSAST Result");
|
|
134
|
+
const path = record(source["path"], "CxSAST Path");
|
|
135
|
+
const nodes = array(source["nodes"], "CxSAST Path nodes");
|
|
136
|
+
const route = (nodes.length ? nodes : [result]).map((value) => {
|
|
137
|
+
const node = record(value, "CxSAST path node");
|
|
138
|
+
return ["FileName", "Line", "Column", "Name", "Type"].map((field) => text(node[field]));
|
|
139
|
+
});
|
|
140
|
+
return stableId("checkmarx-cxsast", [
|
|
141
|
+
projectId,
|
|
142
|
+
requiredText(query["id"], "CxSAST Query id"),
|
|
143
|
+
requiredText(path["SimilarityId"], "CxSAST SimilarityId"),
|
|
144
|
+
route,
|
|
145
|
+
]);
|
|
146
|
+
}
|
|
147
|
+
export function normalizeCheckmarxXml(contents, repository, target) {
|
|
148
|
+
const { rows, project, scanId, rootInstance } = readReport(contents);
|
|
149
|
+
function normalize(instance) {
|
|
150
|
+
const report = {
|
|
151
|
+
format: "cxsast-xml",
|
|
152
|
+
scanId,
|
|
153
|
+
...project,
|
|
154
|
+
...(instance && { instance }),
|
|
155
|
+
sourceRepositoryUrl: repository,
|
|
156
|
+
};
|
|
157
|
+
return normalizeRecords(rows, (row) => {
|
|
158
|
+
const { query, result } = row;
|
|
159
|
+
return checkmarxEvidence(report, {
|
|
160
|
+
title: requiredText(query["name"], "CxSAST Query name"),
|
|
161
|
+
ruleId: query["id"],
|
|
162
|
+
severity: text(result["Severity"]) ?? query["Severity"],
|
|
163
|
+
description: result["Remark"],
|
|
164
|
+
status: result["Status"],
|
|
165
|
+
verdict: result["FalsePositive"]?.toLowerCase() === "true"
|
|
166
|
+
? "False positive"
|
|
167
|
+
: result["state"],
|
|
168
|
+
cwe: query["cweId"],
|
|
169
|
+
sourceData: !row["instance"] && instance ? { ...row, instance } : row,
|
|
170
|
+
}, target);
|
|
171
|
+
}, (row) => {
|
|
172
|
+
const scope = checkmarxXmlScope(row, scanId, project.projectId);
|
|
173
|
+
if (scope.instance)
|
|
174
|
+
row["instance"] = scope.instance;
|
|
175
|
+
return checkmarxXmlId(row);
|
|
176
|
+
}, target, { report });
|
|
177
|
+
}
|
|
178
|
+
const result = normalize(rootInstance);
|
|
179
|
+
let instance = rootInstance;
|
|
180
|
+
let hasUnboundRows = false;
|
|
181
|
+
for (const { evidence } of result.findings) {
|
|
182
|
+
const rowInstance = text(evidence.source_data?.["instance"]);
|
|
183
|
+
if (rowInstance)
|
|
184
|
+
instance = checkmarxXmlInstance(instance, rowInstance);
|
|
185
|
+
else
|
|
186
|
+
hasUnboundRows = true;
|
|
187
|
+
}
|
|
188
|
+
if (instance && !rootInstance) {
|
|
189
|
+
// Count inherited instance bytes before accepting linkless findings for Cloud.
|
|
190
|
+
if (hasUnboundRows)
|
|
191
|
+
return normalize(instance);
|
|
192
|
+
result.report["instance"] = instance;
|
|
193
|
+
}
|
|
194
|
+
return result;
|
|
195
|
+
}
|
|
196
|
+
//# sourceMappingURL=checkmarx-xml.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"checkmarx-xml.js","sourceRoot":"","sources":["../src/checkmarx-xml.ts"],"names":[],"mappings":"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","sourcesContent":["import { SaxesParser } from \"saxes\";\nimport { asRecord } from \"./record.js\";\nimport { checkmarxEvidence } from \"./checkmarx-evidence.js\";\nimport type { ExternalImportTarget } from \"./external-import-contract.js\";\nimport {\n array,\n normalizeRecords,\n record,\n requiredText,\n stableId,\n text,\n} from \"./scanner-import.js\";\n\ntype Attributes = Record<string, string>;\ninterface Element {\n name: string;\n attributes: Attributes;\n children: Element[];\n text: string;\n}\n\nfunction fields(element: Element): Attributes {\n return Object.fromEntries(\n element.children\n .filter((child) => !child.children.length)\n .map((child) => [child.name, child.text]),\n );\n}\n\nfunction pathNode(element: Element): Record<string, unknown> {\n const node: Record<string, unknown> = fields(element);\n const snippet = element.children.find((child) => child.name === \"Snippet\");\n if (snippet)\n node[\"Snippet\"] = snippet.children\n .filter((child) => child.name === \"Line\")\n .map(fields);\n return node;\n}\n\ninterface Row extends Record<string, unknown> {\n projectId: string;\n query: Attributes;\n result: Attributes;\n path: Attributes | null;\n nodes: Record<string, unknown>[];\n}\n\nconst viewerPath = \"/cxwebclient/viewermain.aspx\";\n\nfunction viewerLink(value: unknown) {\n const url = typeof value === \"string\" ? URL.parse(value) : null;\n if (\n url &&\n /^https?:$/u.test(url.protocol) &&\n url.pathname.toLowerCase().endsWith(viewerPath)\n )\n return url;\n}\n\nfunction viewerInstance(link: URL | undefined) {\n return link && link.origin + link.pathname.slice(0, -viewerPath.length);\n}\n\nfunction instanceKey(value: string) {\n const url = URL.parse(value);\n return url && /^https?:$/u.test(url.protocol) ? url.href : value;\n}\n\nexport function checkmarxXmlInstance(\n current: string | undefined,\n next: string | undefined,\n) {\n if (\n current !== undefined &&\n next !== undefined &&\n current !== next &&\n instanceKey(current) !== instanceKey(next)\n )\n throw new Error(\"CxSAST viewer links must identify the same instance.\");\n return current ?? next;\n}\n\nfunction viewerId(link: URL | undefined, field: string, expected?: string) {\n let selected = expected;\n for (const [key, id] of link?.searchParams ?? []) {\n if (!id || key.toLowerCase() !== field) continue;\n if (selected !== undefined && selected !== id)\n throw new Error(`CxSAST DeepLink ${field} does not match the report.`);\n selected = id;\n }\n return selected;\n}\n\nexport function checkmarxResultViewer(\n source: Record<string, unknown> | null | undefined,\n) {\n return viewerLink(asRecord(source?.[\"result\"])?.[\"DeepLink\"]);\n}\n\nexport function checkmarxXmlScope(\n source: Record<string, unknown>,\n scanId?: string,\n projectId?: string,\n) {\n const link = checkmarxResultViewer(source);\n viewerId(\n link,\n \"pathid\",\n text(asRecord(source[\"path\"])?.[\"PathId\"]) ?? undefined,\n );\n const instance = source[\"instance\"];\n return {\n instance: checkmarxXmlInstance(\n instance === undefined\n ? undefined\n : requiredText(instance, \"CxSAST instance\"),\n viewerInstance(link),\n ),\n scanId: viewerId(link, \"scanid\", scanId),\n projectId: viewerId(link, \"projectid\", projectId),\n };\n}\n\nfunction readReport(contents: string) {\n const rows: Row[] = [];\n const stack: Element[] = [];\n const parser = new SaxesParser({ xmlns: false });\n let scanId = \"\";\n let rootInstance: string | undefined;\n const project: Attributes & { projectId: string } = { projectId: \"\" };\n parser.on(\"opentag\", ({ name, attributes }) => {\n const element: Element = { name, attributes, children: [], text: \"\" };\n if (!stack.length) {\n if (name !== \"CxXMLResults\")\n throw new Error(\"Expected a Checkmarx CxSAST CxXMLResults report.\");\n project.projectId = requiredText(\n attributes[\"ProjectId\"],\n \"CxSAST ProjectId\",\n );\n scanId = requiredText(attributes[\"ScanId\"], \"CxSAST ScanId\");\n const projectName = text(attributes[\"ProjectName\"]);\n const team = text(attributes[\"TeamFullPathOnReportDate\"]);\n if (projectName) project[\"projectName\"] = projectName;\n if (team) project[\"teamFullPathOnReportDate\"] = team;\n const link = viewerLink(attributes[\"DeepLink\"]);\n viewerId(link, \"scanid\", scanId);\n viewerId(link, \"projectid\", project.projectId);\n rootInstance = viewerInstance(link);\n } else if (\n (stack.length === 1 && name !== \"Query\") ||\n (stack.length === 2 && name !== \"Result\")\n ) {\n throw new Error(\"Expected CxSAST results directly under their Query.\");\n }\n // Only build subtrees within the current result, then release them.\n if (stack.length >= 3) stack.at(-1)!.children.push(element);\n stack.push(element);\n });\n function appendText(value: string) {\n const element = stack.at(-1);\n if (element) element.text += value;\n }\n parser.on(\"text\", appendText);\n parser.on(\"cdata\", appendText);\n parser.on(\"closetag\", () => {\n const element = stack.pop()!;\n const parent = stack.at(-1);\n if (parent?.name !== \"Query\" || stack.length !== 2) return;\n const paths = element.children.filter((child) => child.name === \"Path\");\n const path = paths.length === 1 ? paths[0] : undefined;\n rows.push({\n ...project,\n query: parent.attributes,\n result: element.attributes,\n path: path?.attributes ?? null,\n nodes:\n path?.children\n .filter((child) => child.name === \"PathNode\")\n .map(pathNode) ?? [],\n });\n });\n parser.write(contents).close();\n return { rows, project, scanId, rootInstance };\n}\n\n/** SimilarityId groups paths, including paths with different intermediate nodes. */\nexport function checkmarxXmlId(source: Record<string, unknown>): string {\n const projectId = requiredText(source[\"projectId\"], \"CxSAST ProjectId\");\n const query = record(source[\"query\"], \"CxSAST Query\");\n const result = record(source[\"result\"], \"CxSAST Result\");\n const path = record(source[\"path\"], \"CxSAST Path\");\n const nodes = array(source[\"nodes\"], \"CxSAST Path nodes\");\n const route = (nodes.length ? nodes : [result]).map((value) => {\n const node = record(value, \"CxSAST path node\");\n return [\"FileName\", \"Line\", \"Column\", \"Name\", \"Type\"].map((field) =>\n text(node[field]),\n );\n });\n return stableId(\"checkmarx-cxsast\", [\n projectId,\n requiredText(query[\"id\"], \"CxSAST Query id\"),\n requiredText(path[\"SimilarityId\"], \"CxSAST SimilarityId\"),\n route,\n ]);\n}\n\nexport function normalizeCheckmarxXml(\n contents: string,\n repository: string,\n target: ExternalImportTarget,\n) {\n const { rows, project, scanId, rootInstance } = readReport(contents);\n function normalize(instance: string | undefined) {\n const report = {\n format: \"cxsast-xml\",\n scanId,\n ...project,\n ...(instance && { instance }),\n sourceRepositoryUrl: repository,\n } as const;\n return normalizeRecords(\n rows,\n (row) => {\n const { query, result } = row;\n return checkmarxEvidence(\n report,\n {\n title: requiredText(query[\"name\"], \"CxSAST Query name\"),\n ruleId: query[\"id\"],\n severity: text(result[\"Severity\"]) ?? query[\"Severity\"],\n description: result[\"Remark\"],\n status: result[\"Status\"],\n verdict:\n result[\"FalsePositive\"]?.toLowerCase() === \"true\"\n ? \"False positive\"\n : result[\"state\"],\n cwe: query[\"cweId\"],\n sourceData:\n !row[\"instance\"] && instance ? { ...row, instance } : row,\n },\n target,\n );\n },\n (row) => {\n const scope = checkmarxXmlScope(row, scanId, project.projectId);\n if (scope.instance) row[\"instance\"] = scope.instance;\n return checkmarxXmlId(row);\n },\n target,\n { report },\n );\n }\n\n const result = normalize(rootInstance);\n let instance = rootInstance;\n let hasUnboundRows = false;\n for (const { evidence } of result.findings) {\n const rowInstance = text(evidence.source_data?.[\"instance\"]);\n if (rowInstance) instance = checkmarxXmlInstance(instance, rowInstance);\n else hasUnboundRows = true;\n }\n if (instance && !rootInstance) {\n // Count inherited instance bytes before accepting linkless findings for Cloud.\n if (hasUnboundRows) return normalize(instance);\n result.report![\"instance\"] = instance;\n }\n return result;\n}\n"]}
|
|
@@ -1,5 +1,10 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
2
|
import { type SeverityDecision } from "./severity-review.js";
|
|
3
|
+
export declare const severityRubricSnapshotSchema: z.ZodObject<{
|
|
4
|
+
revision: z.ZodNumber;
|
|
5
|
+
markdown: z.ZodString;
|
|
6
|
+
sha256: z.ZodString;
|
|
7
|
+
}, z.core.$strict>;
|
|
3
8
|
/** Versioned input for repository-free classification of canonical records. */
|
|
4
9
|
export declare const classifySeverityRecordsInputSchema: z.ZodObject<{
|
|
5
10
|
version: z.ZodLiteral<1>;
|
|
@@ -9,15 +14,7 @@ export declare const classifySeverityRecordsInputSchema: z.ZodObject<{
|
|
|
9
14
|
sha256: z.ZodString;
|
|
10
15
|
}, z.core.$strict>>;
|
|
11
16
|
model: z.ZodString;
|
|
12
|
-
effort: z.
|
|
13
|
-
high: "high";
|
|
14
|
-
low: "low";
|
|
15
|
-
max: "max";
|
|
16
|
-
medium: "medium";
|
|
17
|
-
minimal: "minimal";
|
|
18
|
-
ultra: "ultra";
|
|
19
|
-
xhigh: "xhigh";
|
|
20
|
-
}>;
|
|
17
|
+
effort: z.ZodString;
|
|
21
18
|
records: z.ZodArray<z.ZodObject<{
|
|
22
19
|
id: z.ZodString;
|
|
23
20
|
revision: z.ZodNumber;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAO9B,eAAO,MAAM,4BAA4B;;;;kBAIvC,CAAC;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;kBAiBpC,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,yBAAyB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QACZ,GAAG,CACD,OAAO,EAAE,mCAAmC,EAC5C,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,gBAAgB,EAChB,WAAW,CACZ,GAAG;IACF,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,GAC9D,CACI;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,2BAA2B,EAAE,CAAA;CAAE,GACnE;IACE,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CACJ,CAAC;AAMJ;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAqFxC"}
|
|
@@ -3,12 +3,17 @@ import { defaultSeverityRubric } from "./default-severity-rubric.js";
|
|
|
3
3
|
import { createHash, randomUUID } from "node:crypto";
|
|
4
4
|
import { z } from "zod";
|
|
5
5
|
import { abortable } from "./targets.js";
|
|
6
|
-
import { parseSeverityDecision, reviewSeverity,
|
|
6
|
+
import { parseSeverityDecision, reviewSeverity, reviewRunsOption, severityDecisionSchema, severityReviewInstructions, } from "./severity-review.js";
|
|
7
7
|
const text = z
|
|
8
8
|
.string()
|
|
9
9
|
.refine((value) => value.trim().length > 0, "Must not be blank.");
|
|
10
10
|
const digest = z.string().regex(/^[a-f0-9]{64}$/u);
|
|
11
11
|
const revision = z.number().int().nonnegative();
|
|
12
|
+
export const severityRubricSnapshotSchema = z.strictObject({
|
|
13
|
+
revision: revision.positive(),
|
|
14
|
+
markdown: text,
|
|
15
|
+
sha256: digest,
|
|
16
|
+
});
|
|
12
17
|
const reportSchema = z
|
|
13
18
|
.object({
|
|
14
19
|
findingId: text,
|
|
@@ -29,24 +34,9 @@ const reportSchema = z
|
|
|
29
34
|
export const classifySeverityRecordsInputSchema = z
|
|
30
35
|
.object({
|
|
31
36
|
version: z.literal(1),
|
|
32
|
-
rubric:
|
|
33
|
-
.object({
|
|
34
|
-
revision: revision.positive(),
|
|
35
|
-
markdown: text,
|
|
36
|
-
sha256: digest,
|
|
37
|
-
})
|
|
38
|
-
.strict()
|
|
39
|
-
.optional(),
|
|
37
|
+
rubric: severityRubricSnapshotSchema.optional(),
|
|
40
38
|
model: text,
|
|
41
|
-
effort: z.
|
|
42
|
-
"minimal",
|
|
43
|
-
"low",
|
|
44
|
-
"medium",
|
|
45
|
-
"high",
|
|
46
|
-
"xhigh",
|
|
47
|
-
"max",
|
|
48
|
-
"ultra",
|
|
49
|
-
]),
|
|
39
|
+
effort: z.string(),
|
|
50
40
|
records: z.array(z
|
|
51
41
|
.object({
|
|
52
42
|
id: text,
|
|
@@ -66,9 +56,7 @@ function sha256(value) {
|
|
|
66
56
|
*/
|
|
67
57
|
export async function classifySeverityRecords(input, options) {
|
|
68
58
|
options.signal?.throwIfAborted();
|
|
69
|
-
const classificationRuns =
|
|
70
|
-
.default(3)
|
|
71
|
-
.parse(options.classificationRuns);
|
|
59
|
+
const classificationRuns = reviewRunsOption.parse(options.classificationRuns);
|
|
72
60
|
const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));
|
|
73
61
|
const rubric = data.rubric ?? {
|
|
74
62
|
revision: 1,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity-records.js","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,IAAI,GAAG,CAAC;KACX,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,oBAAoB,CAAC,CAAC;AACpE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACnD,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAChD,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;QAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;QAC7B,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,MAAM;KACf,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;IACb,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;QACb,SAAS;QACT,KAAK;QACL,QAAQ;QACR,MAAM;QACN,OAAO;QACP,KAAK;QACL,OAAO;KACR,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC;SACE,MAAM,CAAC;QACN,EAAE,EAAE,IAAI;QACR,QAAQ;QACR,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,MAAM;KACpB,CAAC;SACD,MAAM,EAAE,CACZ;CACF,CAAC;KACD,MAAM,EAAE,CAAC;AAyDZ,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAmC,EACnC,OAAuC;IAEvC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,kBAAkB,GAAG,wBAAwB;SAChD,OAAO,CAAC,CAAC,CAAC;SACV,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,kCAAkC,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI;QAC5B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,qBAAqB;QAC/B,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC;KACtC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,MAAM;QAC3C,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC,WAAW;YACnD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,EAAE;YAChC,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;IACN,CAAC;IACD,MAAM,OAAO,GAAyB;QACpC,kBAAkB;QAClB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;KAC7D,CAAC;IACF,MAAM,WAAW,GAAkC,EAAE,CAAC;IACtD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,IAAI,IAAI,GAA2C,eAAe,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,cAAc,CACjE,KAAK,IAAI,EAAE;gBACT,IAAI,GAAG,eAAe,CAAC;gBACvB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;oBACpC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;oBACjC,OAAO,OAAO,CAAC,YAAY,CAAC,GAAG,CAC7B;wBACE,SAAS,EAAE,UAAU,EAAE;wBACvB,KAAK,EAAE,yBAAyB;wBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,mBAAmB,EAAE,0BAA0B;wBAC/C,MAAM,EAAE,aAAa,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,mCAAmC,MAAM,CAAC,WAAW,GAAG;wBAC9G,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,sBAAsB,CAAC;qBAC/C,EACD,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;gBACJ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;gBACjC,IAAI,GAAG,oBAAoB,CAAC;gBAC5B,OAAO,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YACpD,CAAC,EACD,kBAAkB,CACnB,CAAC;YACF,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,WAAW,CAAC,IAAI,CAAC;gBACf,GAAG,QAAQ;gBACX,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,OAAO;gBACL,GAAG,OAAO;gBACV,MAAM,EAAE,YAAY;gBACpB,WAAW,EAAE,EAAE;gBACf,KAAK,EAAE;oBACL,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,IAAI;oBACJ,OAAO,EACL,KAAK,YAAY,KAAK;wBACpB,CAAC,CAAC,KAAK,CAAC,OAAO;wBACf,CAAC,CAAC,IAAI,KAAK,eAAe;4BACxB,CAAC,CAAC,qBAAqB;4BACvB,CAAC,CAAC,qBAAqB;iBAC9B;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAC1D,CAAC","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.js\";\nimport { defaultSeverityRubric } from \"./default-severity-rubric.js\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { abortable } from \"./targets.js\";\nimport {\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n severityDecisionSchema,\n severityReviewInstructions,\n type SeverityDecision,\n} from \"./severity-review.js\";\n\nconst text = z\n .string()\n .refine((value) => value.trim().length > 0, \"Must not be blank.\");\nconst digest = z.string().regex(/^[a-f0-9]{64}$/u);\nconst revision = z.number().int().nonnegative();\nconst reportSchema = z\n .object({\n findingId: text,\n title: text,\n summary: text,\n occurrenceId: text.optional(),\n severity: z\n .object({\n level: z.enum(SCAN_SEVERITIES),\n rationale: z.string().optional(),\n changeConditions: z.string().optional(),\n })\n .passthrough()\n .optional(),\n })\n .passthrough();\n\n/** Versioned input for repository-free classification of canonical records. */\nexport const classifySeverityRecordsInputSchema = z\n .object({\n version: z.literal(1),\n rubric: z\n .object({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n })\n .strict()\n .optional(),\n model: text,\n effort: z.enum([\n \"minimal\",\n \"low\",\n \"medium\",\n \"high\",\n \"xhigh\",\n \"max\",\n \"ultra\",\n ]),\n records: z.array(\n z\n .object({\n id: text,\n revision,\n findingJson: text,\n inputSha256: digest,\n })\n .strict(),\n ),\n })\n .strict();\n\nexport type ClassifySeverityRecordsInput = z.infer<\n typeof classifySeverityRecordsInputSchema\n>;\n\nexport interface SeverityClassificationReviewRequest {\n requestId: string;\n stage: \"severity-classification\";\n model: string;\n effort: ClassifySeverityRecordsInput[\"effort\"];\n trustedInstructions: string;\n prompt: string;\n schema: unknown;\n}\n\nexport interface ClassifySeverityRecordsOptions {\n /** Independent reviews per record: integer 1–10, default 3. */\n classificationRuns?: number;\n reviewRunner: {\n run(\n request: SeverityClassificationReviewRequest,\n options?: { signal?: AbortSignal },\n ): Promise<unknown>;\n };\n signal?: AbortSignal;\n}\n\nexport type CanonicalSeverityAssessment = Omit<\n SeverityDecision,\n \"findingId\"\n> & {\n id: string;\n revision: number;\n inputSha256: string;\n};\n\ninterface RecordsResultBinding {\n classificationRuns: number;\n version: 1;\n rubric: { revision: number; sha256: string };\n}\n\nexport type ClassifySeverityRecordsResult = RecordsResultBinding &\n (\n | { status: \"completed\"; assessments: CanonicalSeverityAssessment[] }\n | {\n status: \"unresolved\";\n assessments: [];\n error: {\n recordId: string;\n code: \"review_failed\" | \"invalid_assessment\";\n message: string;\n };\n }\n );\n\nfunction sha256(value: string): string {\n return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n/**\n * Classify immutable host-provided reports. No filesystem, auth, local model,\n * repository access, retries, or persistence. The host owns those lifecycles.\n */\nexport async function classifySeverityRecords(\n input: ClassifySeverityRecordsInput,\n options: ClassifySeverityRecordsOptions,\n): Promise<ClassifySeverityRecordsResult> {\n options.signal?.throwIfAborted();\n const classificationRuns = classificationRunsSchema\n .default(3)\n .parse(options.classificationRuns);\n const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));\n const rubric = data.rubric ?? {\n revision: 1,\n markdown: defaultSeverityRubric,\n sha256: sha256(defaultSeverityRubric),\n };\n if (sha256(rubric.markdown) !== rubric.sha256)\n throw new Error(\"Rubric SHA-256 does not match its exact UTF-8 Markdown.\");\n const ids = new Set<string>();\n for (const record of data.records) {\n if (ids.has(record.id))\n throw new Error(\"Canonical record IDs must be unique.\");\n ids.add(record.id);\n if (sha256(record.findingJson) !== record.inputSha256)\n throw new Error(\"Finding SHA-256 does not match its exact UTF-8 JSON.\");\n const report = reportSchema.parse(JSON.parse(record.findingJson));\n if (report.findingId !== record.id)\n throw new Error(\n \"The report findingId must equal its canonical record ID.\",\n );\n }\n const binding: RecordsResultBinding = {\n classificationRuns,\n version: 1,\n rubric: { revision: rubric.revision, sha256: rubric.sha256 },\n };\n const assessments: CanonicalSeverityAssessment[] = [];\n for (const record of data.records) {\n options.signal?.throwIfAborted();\n let code: \"review_failed\" | \"invalid_assessment\" = \"review_failed\";\n try {\n const { findingId: _findingId, ...decision } = await reviewSeverity(\n async () => {\n code = \"review_failed\";\n const response = await abortable(() => {\n options.signal?.throwIfAborted();\n return options.reviewRunner.run(\n {\n requestId: randomUUID(),\n stage: \"severity-classification\",\n model: data.model,\n effort: data.effort,\n trustedInstructions: severityReviewInstructions,\n prompt: `{\"rubric\":${JSON.stringify([rubric.markdown])},\"knowledgeBase\":null,\"finding\":${record.findingJson}}`,\n schema: z.toJSONSchema(severityDecisionSchema),\n },\n { signal: options.signal },\n );\n }, options.signal);\n options.signal?.throwIfAborted();\n code = \"invalid_assessment\";\n return parseSeverityDecision(response, record.id);\n },\n classificationRuns,\n );\n options.signal?.throwIfAborted();\n assessments.push({\n ...decision,\n id: record.id,\n revision: record.revision,\n inputSha256: record.inputSha256,\n });\n } catch (error) {\n options.signal?.throwIfAborted();\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code,\n message:\n error instanceof Error\n ? error.message\n : code === \"review_failed\"\n ? \"Host review failed.\"\n : \"Invalid assessment.\",\n },\n };\n }\n }\n return { ...binding, status: \"completed\", assessments };\n}\n"]}
|
|
1
|
+
{"version":3,"file":"classify-severity-records.js","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,IAAI,GAAG,CAAC;KACX,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,oBAAoB,CAAC,CAAC;AACpE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACnD,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,YAAY,CAAC;IACzD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,MAAM;CACf,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;QAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAC/C,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC;SACE,MAAM,CAAC;QACN,EAAE,EAAE,IAAI;QACR,QAAQ;QACR,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,MAAM;KACpB,CAAC;SACD,MAAM,EAAE,CACZ;CACF,CAAC;KACD,MAAM,EAAE,CAAC;AAyDZ,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAmC,EACnC,OAAuC;IAEvC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,kCAAkC,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI;QAC5B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,qBAAqB;QAC/B,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC;KACtC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,MAAM;QAC3C,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC,WAAW;YACnD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,EAAE;YAChC,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;IACN,CAAC;IACD,MAAM,OAAO,GAAyB;QACpC,kBAAkB;QAClB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;KAC7D,CAAC;IACF,MAAM,WAAW,GAAkC,EAAE,CAAC;IACtD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,IAAI,IAAI,GAA2C,eAAe,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,cAAc,CACjE,KAAK,IAAI,EAAE;gBACT,IAAI,GAAG,eAAe,CAAC;gBACvB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;oBACpC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;oBACjC,OAAO,OAAO,CAAC,YAAY,CAAC,GAAG,CAC7B;wBACE,SAAS,EAAE,UAAU,EAAE;wBACvB,KAAK,EAAE,yBAAyB;wBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,mBAAmB,EAAE,0BAA0B;wBAC/C,MAAM,EAAE,aAAa,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,mCAAmC,MAAM,CAAC,WAAW,GAAG;wBAC9G,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,sBAAsB,CAAC;qBAC/C,EACD,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;gBACJ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;gBACjC,IAAI,GAAG,oBAAoB,CAAC;gBAC5B,OAAO,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YACpD,CAAC,EACD,kBAAkB,CACnB,CAAC;YACF,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,WAAW,CAAC,IAAI,CAAC;gBACf,GAAG,QAAQ;gBACX,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,OAAO;gBACL,GAAG,OAAO;gBACV,MAAM,EAAE,YAAY;gBACpB,WAAW,EAAE,EAAE;gBACf,KAAK,EAAE;oBACL,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,IAAI;oBACJ,OAAO,EACL,KAAK,YAAY,KAAK;wBACpB,CAAC,CAAC,KAAK,CAAC,OAAO;wBACf,CAAC,CAAC,IAAI,KAAK,eAAe;4BACxB,CAAC,CAAC,qBAAqB;4BACvB,CAAC,CAAC,qBAAqB;iBAC9B;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAC1D,CAAC","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.js\";\nimport { defaultSeverityRubric } from \"./default-severity-rubric.js\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { abortable } from \"./targets.js\";\nimport {\n parseSeverityDecision,\n reviewSeverity,\n reviewRunsOption,\n severityDecisionSchema,\n severityReviewInstructions,\n type SeverityDecision,\n} from \"./severity-review.js\";\n\nconst text = z\n .string()\n .refine((value) => value.trim().length > 0, \"Must not be blank.\");\nconst digest = z.string().regex(/^[a-f0-9]{64}$/u);\nconst revision = z.number().int().nonnegative();\nexport const severityRubricSnapshotSchema = z.strictObject({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n});\n\nconst reportSchema = z\n .object({\n findingId: text,\n title: text,\n summary: text,\n occurrenceId: text.optional(),\n severity: z\n .object({\n level: z.enum(SCAN_SEVERITIES),\n rationale: z.string().optional(),\n changeConditions: z.string().optional(),\n })\n .passthrough()\n .optional(),\n })\n .passthrough();\n\n/** Versioned input for repository-free classification of canonical records. */\nexport const classifySeverityRecordsInputSchema = z\n .object({\n version: z.literal(1),\n rubric: severityRubricSnapshotSchema.optional(),\n model: text,\n effort: z.string(),\n records: z.array(\n z\n .object({\n id: text,\n revision,\n findingJson: text,\n inputSha256: digest,\n })\n .strict(),\n ),\n })\n .strict();\n\nexport type ClassifySeverityRecordsInput = z.infer<\n typeof classifySeverityRecordsInputSchema\n>;\n\nexport interface SeverityClassificationReviewRequest {\n requestId: string;\n stage: \"severity-classification\";\n model: string;\n effort: ClassifySeverityRecordsInput[\"effort\"];\n trustedInstructions: string;\n prompt: string;\n schema: unknown;\n}\n\nexport interface ClassifySeverityRecordsOptions {\n /** Independent reviews per record: integer 1–10, default 3. */\n classificationRuns?: number;\n reviewRunner: {\n run(\n request: SeverityClassificationReviewRequest,\n options?: { signal?: AbortSignal },\n ): Promise<unknown>;\n };\n signal?: AbortSignal;\n}\n\nexport type CanonicalSeverityAssessment = Omit<\n SeverityDecision,\n \"findingId\"\n> & {\n id: string;\n revision: number;\n inputSha256: string;\n};\n\ninterface RecordsResultBinding {\n classificationRuns: number;\n version: 1;\n rubric: { revision: number; sha256: string };\n}\n\nexport type ClassifySeverityRecordsResult = RecordsResultBinding &\n (\n | { status: \"completed\"; assessments: CanonicalSeverityAssessment[] }\n | {\n status: \"unresolved\";\n assessments: [];\n error: {\n recordId: string;\n code: \"review_failed\" | \"invalid_assessment\";\n message: string;\n };\n }\n );\n\nfunction sha256(value: string): string {\n return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n/**\n * Classify immutable host-provided reports. No filesystem, auth, local model,\n * repository access, retries, or persistence. The host owns those lifecycles.\n */\nexport async function classifySeverityRecords(\n input: ClassifySeverityRecordsInput,\n options: ClassifySeverityRecordsOptions,\n): Promise<ClassifySeverityRecordsResult> {\n options.signal?.throwIfAborted();\n const classificationRuns = reviewRunsOption.parse(options.classificationRuns);\n const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));\n const rubric = data.rubric ?? {\n revision: 1,\n markdown: defaultSeverityRubric,\n sha256: sha256(defaultSeverityRubric),\n };\n if (sha256(rubric.markdown) !== rubric.sha256)\n throw new Error(\"Rubric SHA-256 does not match its exact UTF-8 Markdown.\");\n const ids = new Set<string>();\n for (const record of data.records) {\n if (ids.has(record.id))\n throw new Error(\"Canonical record IDs must be unique.\");\n ids.add(record.id);\n if (sha256(record.findingJson) !== record.inputSha256)\n throw new Error(\"Finding SHA-256 does not match its exact UTF-8 JSON.\");\n const report = reportSchema.parse(JSON.parse(record.findingJson));\n if (report.findingId !== record.id)\n throw new Error(\n \"The report findingId must equal its canonical record ID.\",\n );\n }\n const binding: RecordsResultBinding = {\n classificationRuns,\n version: 1,\n rubric: { revision: rubric.revision, sha256: rubric.sha256 },\n };\n const assessments: CanonicalSeverityAssessment[] = [];\n for (const record of data.records) {\n options.signal?.throwIfAborted();\n let code: \"review_failed\" | \"invalid_assessment\" = \"review_failed\";\n try {\n const { findingId: _findingId, ...decision } = await reviewSeverity(\n async () => {\n code = \"review_failed\";\n const response = await abortable(() => {\n options.signal?.throwIfAborted();\n return options.reviewRunner.run(\n {\n requestId: randomUUID(),\n stage: \"severity-classification\",\n model: data.model,\n effort: data.effort,\n trustedInstructions: severityReviewInstructions,\n prompt: `{\"rubric\":${JSON.stringify([rubric.markdown])},\"knowledgeBase\":null,\"finding\":${record.findingJson}}`,\n schema: z.toJSONSchema(severityDecisionSchema),\n },\n { signal: options.signal },\n );\n }, options.signal);\n options.signal?.throwIfAborted();\n code = \"invalid_assessment\";\n return parseSeverityDecision(response, record.id);\n },\n classificationRuns,\n );\n options.signal?.throwIfAborted();\n assessments.push({\n ...decision,\n id: record.id,\n revision: record.revision,\n inputSha256: record.inputSha256,\n });\n } catch (error) {\n options.signal?.throwIfAborted();\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code,\n message:\n error instanceof Error\n ? error.message\n : code === \"review_failed\"\n ? \"Host review failed.\"\n : \"Invalid assessment.\",\n },\n };\n }\n }\n return { ...binding, status: \"completed\", assessments };\n}\n"]}
|
|
@@ -5,7 +5,7 @@ import { severityDecisionSchema as decisionSchema } from "./severity-review.js";
|
|
|
5
5
|
/** Full reports and explicitly supplied context from any finding source. */
|
|
6
6
|
export type SeverityClassificationFinding = Pick<Finding, "findingId" | "title" | "summary"> & Partial<Pick<Finding, "occurrenceId" | "severity">> & Record<string, unknown>;
|
|
7
7
|
export interface ClassifySeverityOptions extends Pick<ReadOnlyCodexOptions, "config" | "environment" | "model" | "reasoningEffort" | "signal" | "workingDirectory"> {
|
|
8
|
-
/**
|
|
8
|
+
/** Overrides both the bundled default and the optional remote default. */
|
|
9
9
|
rubricPath?: string;
|
|
10
10
|
/** Independent reviews per finding: integer 1–10, default 3. */
|
|
11
11
|
classificationRuns?: number;
|
|
@@ -22,7 +22,10 @@ export interface SeverityClassification {
|
|
|
22
22
|
assessedAt: string;
|
|
23
23
|
/** Absent on legacy results whose review count was not recorded. */
|
|
24
24
|
classificationRuns?: number;
|
|
25
|
+
/** SHA-256 of the exact policy text, or the ordered document digest for collections and legacy results. */
|
|
25
26
|
rubricSha256: string | null;
|
|
27
|
+
/** Revision of the bundled or remote rubric. Unversioned file inputs and legacy results omit it. */
|
|
28
|
+
rubricRevision?: number;
|
|
26
29
|
knowledgeBaseSha256: string | null;
|
|
27
30
|
assessments: SeverityAssessment[];
|
|
28
31
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity.d.ts","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"classify-severity.d.ts","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,IAAI,cAAc,EAMzC,MAAM,sBAAsB,CAAC;AAG9B,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,OAAO,EACP,WAAW,GAAG,OAAO,GAAG,SAAS,CAClC,GACC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAAC,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1B,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,oBAAoB,EAClB,QAAQ,GACR,aAAa,GACb,OAAO,GACP,iBAAiB,GACjB,QAAQ,GACR,kBAAkB,CACrB;IACC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAGxC;AAED,MAAM,WAAW,kBAAmB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;IACxE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB,GAAG,QAAQ,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2GAA2G;IAC3G,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AA0CD,yFAAyF;AACzF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,EAClD,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAEjC"}
|
|
@@ -1,11 +1,12 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { hash } from "node:crypto";
|
|
2
|
+
import { getDefaultSeverityRubric, } from "./severity-rubric.js";
|
|
2
3
|
import { findingEntry } from "./value.js";
|
|
3
4
|
import { z } from "zod";
|
|
4
5
|
import { CodexSecurityError } from "./errors.js";
|
|
5
6
|
import { workflowDigest } from "./finding-workflow.js";
|
|
6
7
|
import { readKnowledgeBaseDocuments } from "./knowledge-base.js";
|
|
7
8
|
import { runReadOnlyCodex, } from "./scan-comparison.js";
|
|
8
|
-
import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, reviewSeverity, classificationRunsSchema, } from "./severity-review.js";
|
|
9
|
+
import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, reviewSeverity, classificationRunsSchema, reviewRunsOption, } from "./severity-review.js";
|
|
9
10
|
import { CODEX_SECURITY_THREAD_SOURCES } from "./thread-source.js";
|
|
10
11
|
const textSchema = z
|
|
11
12
|
.string()
|
|
@@ -18,6 +19,7 @@ export const severityClassificationSchema = z.strictObject({
|
|
|
18
19
|
assessedAt: z.string().datetime(),
|
|
19
20
|
classificationRuns: classificationRunsSchema.optional(),
|
|
20
21
|
rubricSha256: digestSchema.nullable(),
|
|
22
|
+
rubricRevision: z.number().int().positive().optional(),
|
|
21
23
|
knowledgeBaseSha256: digestSchema.nullable(),
|
|
22
24
|
assessments: z.array(decisionSchema.extend({
|
|
23
25
|
occurrenceId: textSchema.nullable(),
|
|
@@ -32,9 +34,7 @@ export async function classifySeverity(findings, options = {}) {
|
|
|
32
34
|
/** @internal */
|
|
33
35
|
export async function classifySeverityInternal(findings, options = {}, surface = "sdk", checkpoint) {
|
|
34
36
|
options.signal?.throwIfAborted();
|
|
35
|
-
const classificationRuns =
|
|
36
|
-
.default(3)
|
|
37
|
-
.parse(options.classificationRuns);
|
|
37
|
+
const classificationRuns = reviewRunsOption.parse(options.classificationRuns);
|
|
38
38
|
const ids = new Set();
|
|
39
39
|
for (const finding of findings) {
|
|
40
40
|
if (!finding.findingId?.trim() || ids.has(finding.findingId)) {
|
|
@@ -42,21 +42,38 @@ export async function classifySeverityInternal(findings, options = {}, surface =
|
|
|
42
42
|
}
|
|
43
43
|
ids.add(finding.findingId);
|
|
44
44
|
}
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
45
|
+
let rubric;
|
|
46
|
+
let defaultRubric;
|
|
47
|
+
if (options.rubricPath === undefined) {
|
|
48
|
+
defaultRubric = await getDefaultSeverityRubric(options);
|
|
49
|
+
rubric = [defaultRubric.markdown];
|
|
50
|
+
}
|
|
51
|
+
else {
|
|
52
|
+
rubric = await readDocuments([options.rubricPath], options.signal);
|
|
53
|
+
}
|
|
48
54
|
const knowledge = options.knowledgeBasePaths?.length
|
|
49
55
|
? await readDocuments(options.knowledgeBasePaths, options.signal)
|
|
50
56
|
: null;
|
|
51
|
-
const
|
|
57
|
+
const rubricCheckpointSha256 = workflowDigest(rubric);
|
|
58
|
+
const metadata = {
|
|
52
59
|
schemaVersion: 1,
|
|
53
60
|
classificationRuns,
|
|
54
61
|
assessedAt: new Date().toISOString(),
|
|
55
|
-
|
|
62
|
+
...(defaultRubric
|
|
63
|
+
? {
|
|
64
|
+
rubricSha256: defaultRubric.sha256,
|
|
65
|
+
rubricRevision: defaultRubric.revision,
|
|
66
|
+
}
|
|
67
|
+
: {
|
|
68
|
+
rubricSha256: rubric.length === 1
|
|
69
|
+
? hash("sha256", rubric[0])
|
|
70
|
+
: rubricCheckpointSha256,
|
|
71
|
+
}),
|
|
56
72
|
knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),
|
|
57
|
-
assessments: [],
|
|
58
73
|
};
|
|
59
|
-
const
|
|
74
|
+
const result = { ...metadata, assessments: [] };
|
|
75
|
+
const binding = { ...metadata, rubricCheckpointSha256 };
|
|
76
|
+
const cached = new Map((await checkpoint?.load(binding))?.map(findingEntry));
|
|
60
77
|
for (const finding of findings) {
|
|
61
78
|
options.signal?.throwIfAborted();
|
|
62
79
|
const inputSha256 = workflowDigest(finding);
|
|
@@ -94,7 +111,7 @@ export async function classifySeverityInternal(findings, options = {}, surface =
|
|
|
94
111
|
inputSha256,
|
|
95
112
|
source: "rubric",
|
|
96
113
|
};
|
|
97
|
-
await checkpoint?.save(finding, assessment,
|
|
114
|
+
await checkpoint?.save(finding, assessment, binding);
|
|
98
115
|
result.assessments.push(assessment);
|
|
99
116
|
}
|
|
100
117
|
options.signal?.throwIfAborted();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity.js","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"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","sourcesContent":["import { defaultSeverityRubric } from \"./default-severity-rubric.js\";\nimport { findingEntry } from \"./value.js\";\nimport { z } from \"zod\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { workflowDigest } from \"./finding-workflow.js\";\nimport { readKnowledgeBaseDocuments } from \"./knowledge-base.js\";\nimport type { Finding } from \"./models.js\";\nimport {\n runReadOnlyCodex,\n type ReadOnlyCodexOptions,\n} from \"./scan-comparison.js\";\nimport {\n severityDecisionSchema as decisionSchema,\n severityReviewInstructions,\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n} from \"./severity-review.js\";\nimport { CODEX_SECURITY_THREAD_SOURCES } from \"./thread-source.js\";\n\n/** Full reports and explicitly supplied context from any finding source. */\nexport type SeverityClassificationFinding = Pick<\n Finding,\n \"findingId\" | \"title\" | \"summary\"\n> &\n Partial<Pick<Finding, \"occurrenceId\" | \"severity\">> &\n Record<string, unknown>;\n\nexport interface ClassifySeverityOptions extends Pick<\n ReadOnlyCodexOptions,\n | \"config\"\n | \"environment\"\n | \"model\"\n | \"reasoningEffort\"\n | \"signal\"\n | \"workingDirectory\"\n> {\n /** Classification policy override. Omit to use the built-in severity rubric. */\n rubricPath?: string;\n /** Independent reviews per finding: integer 1–10, default 3. */\n classificationRuns?: number;\n /** Supporting evidence, separate from classification policy. */\n knowledgeBasePaths?: readonly string[];\n /** @internal Test client for the shared read-only runtime. */\n codex?: ReadOnlyCodexOptions[\"codex\"];\n}\n\nexport interface SeverityAssessment extends z.infer<typeof decisionSchema> {\n occurrenceId: string | null;\n inputSha256: string;\n source: \"existing-severity\" | \"rubric\";\n}\n\nexport interface SeverityClassification {\n schemaVersion: 1;\n assessedAt: string;\n /** Absent on legacy results whose review count was not recorded. */\n classificationRuns?: number;\n rubricSha256: string | null;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(result: SeverityClassification): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n result: SeverityClassification,\n ): Promise<void>;\n}\n\nconst textSchema = z\n .string()\n .min(1)\n .refine((value) => value.trim().length > 0);\nconst digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);\n/** @internal */\nexport const severityClassificationSchema = z.strictObject({\n schemaVersion: z.literal(1),\n assessedAt: z.string().datetime(),\n classificationRuns: classificationRunsSchema.optional(),\n rubricSha256: digestSchema.nullable(),\n knowledgeBaseSha256: digestSchema.nullable(),\n assessments: z.array(\n decisionSchema.extend({\n occurrenceId: textSchema.nullable(),\n inputSha256: digestSchema,\n source: z.enum([\"existing-severity\", \"rubric\"]),\n }),\n ),\n}) satisfies z.ZodType<SeverityClassification>;\n\n/** Classify each supplied report independently, without scanning or writing findings. */\nexport async function classifySeverity(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n): Promise<SeverityClassification> {\n return classifySeverityInternal(findings, options);\n}\n\n/** @internal */\nexport async function classifySeverityInternal(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n checkpoint?: SeverityClassificationCheckpoint,\n): Promise<SeverityClassification> {\n options.signal?.throwIfAborted();\n const classificationRuns = classificationRunsSchema\n .default(3)\n .parse(options.classificationRuns);\n const ids = new Set<string>();\n for (const finding of findings) {\n if (!finding.findingId?.trim() || ids.has(finding.findingId)) {\n throw new CodexSecurityError(\n \"Severity classification requires unique finding IDs.\",\n );\n }\n ids.add(finding.findingId);\n }\n const rubric =\n options.rubricPath === undefined\n ? [defaultSeverityRubric]\n : await readDocuments([options.rubricPath], options.signal);\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal)\n : null;\n const result: SeverityClassification = {\n schemaVersion: 1,\n classificationRuns,\n assessedAt: new Date().toISOString(),\n rubricSha256: workflowDigest(rubric),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n assessments: [],\n };\n const cached = new Map((await checkpoint?.load(result))?.map(findingEntry));\n for (const finding of findings) {\n options.signal?.throwIfAborted();\n const inputSha256 = workflowDigest(finding);\n const previous = cached.get(finding.findingId);\n if (previous?.inputSha256 === inputSha256) {\n validateSeverityClassification({ ...result, assessments: [previous] }, [\n finding,\n ]);\n result.assessments.push(previous);\n continue;\n }\n const prompt = [\n severityReviewInstructions,\n JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),\n ].join(\"\\n\\n\");\n const decision = await reviewSeverity(async () => {\n options.signal?.throwIfAborted();\n const response = await runReadOnlyCodex(\n prompt,\n z.toJSONSchema(decisionSchema),\n options,\n {\n surface,\n command: \"classify-severity\",\n threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,\n },\n );\n options.signal?.throwIfAborted();\n try {\n return parseSeverityDecision(JSON.parse(response), finding.findingId);\n } catch (error) {\n throw new CodexSecurityError(\n \"Severity classification returned an invalid assessment.\",\n { cause: error },\n );\n }\n }, classificationRuns);\n options.signal?.throwIfAborted();\n const assessment: SeverityAssessment = {\n ...decision,\n occurrenceId: finding.occurrenceId ?? null,\n inputSha256,\n source: \"rubric\",\n };\n await checkpoint?.save(finding, assessment, result);\n result.assessments.push(assessment);\n }\n options.signal?.throwIfAborted();\n return result;\n}\n\nasync function readDocuments(\n paths: readonly string[],\n signal?: AbortSignal,\n): Promise<string[]> {\n const contents = await readKnowledgeBaseDocuments(paths, signal);\n if (contents.every((text) => !text.trim())) {\n throw new CodexSecurityError(\"Classification documents must not be empty.\");\n }\n return contents;\n}\n\n/** @internal Check parsed assessments against the actual finding evidence. */\nexport function validateSeverityClassification(\n result: SeverityClassification,\n findings: readonly SeverityClassificationFinding[],\n): SeverityClassification {\n const byId = new Map(findings.map(findingEntry));\n for (const assessment of result.assessments) {\n const finding = byId.get(assessment.findingId);\n if (\n !finding ||\n assessment.occurrenceId !== (finding.occurrenceId ?? null) ||\n assessment.inputSha256 !== workflowDigest(finding) ||\n (assessment.source === \"rubric\") !== (result.rubricSha256 !== null) ||\n (assessment.decision === \"assessed\"\n ? assessment.level === null\n : assessment.level !== null) ||\n (assessment.source === \"rubric\" &&\n (assessment.decision === \"assessed\"\n ? assessment.rubricLabel === null\n : assessment.rubricLabel !== null)) ||\n (assessment.source === \"existing-severity\" &&\n (assessment.decision !== \"assessed\" ||\n assessment.level !== finding.severity?.level))\n ) {\n throw new CodexSecurityError(\n \"Severity assessment does not match the supplied findings. Classify the findings again.\",\n );\n }\n byId.delete(assessment.findingId);\n }\n return result;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"classify-severity.js","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"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","sourcesContent":["import { hash } from \"node:crypto\";\nimport {\n getDefaultSeverityRubric,\n type SeverityRubricSnapshot,\n} from \"./severity-rubric.js\";\nimport { findingEntry } from \"./value.js\";\nimport { z } from \"zod\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { workflowDigest } from \"./finding-workflow.js\";\nimport { readKnowledgeBaseDocuments } from \"./knowledge-base.js\";\nimport type { Finding } from \"./models.js\";\nimport {\n runReadOnlyCodex,\n type ReadOnlyCodexOptions,\n} from \"./scan-comparison.js\";\nimport {\n severityDecisionSchema as decisionSchema,\n severityReviewInstructions,\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n reviewRunsOption,\n} from \"./severity-review.js\";\nimport { CODEX_SECURITY_THREAD_SOURCES } from \"./thread-source.js\";\n\n/** Full reports and explicitly supplied context from any finding source. */\nexport type SeverityClassificationFinding = Pick<\n Finding,\n \"findingId\" | \"title\" | \"summary\"\n> &\n Partial<Pick<Finding, \"occurrenceId\" | \"severity\">> &\n Record<string, unknown>;\n\nexport interface ClassifySeverityOptions extends Pick<\n ReadOnlyCodexOptions,\n | \"config\"\n | \"environment\"\n | \"model\"\n | \"reasoningEffort\"\n | \"signal\"\n | \"workingDirectory\"\n> {\n /** Overrides both the bundled default and the optional remote default. */\n rubricPath?: string;\n /** Independent reviews per finding: integer 1–10, default 3. */\n classificationRuns?: number;\n /** Supporting evidence, separate from classification policy. */\n knowledgeBasePaths?: readonly string[];\n /** @internal Test client for the shared read-only runtime. */\n codex?: ReadOnlyCodexOptions[\"codex\"];\n}\n\nexport interface SeverityAssessment extends z.infer<typeof decisionSchema> {\n occurrenceId: string | null;\n inputSha256: string;\n source: \"existing-severity\" | \"rubric\";\n}\n\nexport interface SeverityClassification {\n schemaVersion: 1;\n assessedAt: string;\n /** Absent on legacy results whose review count was not recorded. */\n classificationRuns?: number;\n /** SHA-256 of the exact policy text, or the ordered document digest for collections and legacy results. */\n rubricSha256: string | null;\n /** Revision of the bundled or remote rubric. Unversioned file inputs and legacy results omit it. */\n rubricRevision?: number;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Document collections retain their original checkpoint key. */\nexport type SeverityClassificationBinding = Omit<\n SeverityClassification,\n \"assessments\"\n> & {\n rubricCheckpointSha256: string | null;\n};\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(binding: SeverityClassificationBinding): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n binding: SeverityClassificationBinding,\n ): Promise<void>;\n}\n\nconst textSchema = z\n .string()\n .min(1)\n .refine((value) => value.trim().length > 0);\nconst digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);\n/** @internal */\nexport const severityClassificationSchema = z.strictObject({\n schemaVersion: z.literal(1),\n assessedAt: z.string().datetime(),\n classificationRuns: classificationRunsSchema.optional(),\n rubricSha256: digestSchema.nullable(),\n rubricRevision: z.number().int().positive().optional(),\n knowledgeBaseSha256: digestSchema.nullable(),\n assessments: z.array(\n decisionSchema.extend({\n occurrenceId: textSchema.nullable(),\n inputSha256: digestSchema,\n source: z.enum([\"existing-severity\", \"rubric\"]),\n }),\n ),\n}) satisfies z.ZodType<SeverityClassification>;\n\n/** Classify each supplied report independently, without scanning or writing findings. */\nexport async function classifySeverity(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n): Promise<SeverityClassification> {\n return classifySeverityInternal(findings, options);\n}\n\n/** @internal */\nexport async function classifySeverityInternal(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n checkpoint?: SeverityClassificationCheckpoint,\n): Promise<SeverityClassification> {\n options.signal?.throwIfAborted();\n const classificationRuns = reviewRunsOption.parse(options.classificationRuns);\n const ids = new Set<string>();\n for (const finding of findings) {\n if (!finding.findingId?.trim() || ids.has(finding.findingId)) {\n throw new CodexSecurityError(\n \"Severity classification requires unique finding IDs.\",\n );\n }\n ids.add(finding.findingId);\n }\n let rubric: string[];\n let defaultRubric: SeverityRubricSnapshot | undefined;\n if (options.rubricPath === undefined) {\n defaultRubric = await getDefaultSeverityRubric(options);\n rubric = [defaultRubric.markdown];\n } else {\n rubric = await readDocuments([options.rubricPath], options.signal);\n }\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal)\n : null;\n const rubricCheckpointSha256 = workflowDigest(rubric);\n const metadata = {\n schemaVersion: 1 as const,\n classificationRuns,\n assessedAt: new Date().toISOString(),\n ...(defaultRubric\n ? {\n rubricSha256: defaultRubric.sha256,\n rubricRevision: defaultRubric.revision,\n }\n : {\n rubricSha256:\n rubric.length === 1\n ? hash(\"sha256\", rubric[0]!)\n : rubricCheckpointSha256,\n }),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n };\n const result: SeverityClassification = { ...metadata, assessments: [] };\n const binding = { ...metadata, rubricCheckpointSha256 };\n const cached = new Map((await checkpoint?.load(binding))?.map(findingEntry));\n for (const finding of findings) {\n options.signal?.throwIfAborted();\n const inputSha256 = workflowDigest(finding);\n const previous = cached.get(finding.findingId);\n if (previous?.inputSha256 === inputSha256) {\n validateSeverityClassification({ ...result, assessments: [previous] }, [\n finding,\n ]);\n result.assessments.push(previous);\n continue;\n }\n const prompt = [\n severityReviewInstructions,\n JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),\n ].join(\"\\n\\n\");\n const decision = await reviewSeverity(async () => {\n options.signal?.throwIfAborted();\n const response = await runReadOnlyCodex(\n prompt,\n z.toJSONSchema(decisionSchema),\n options,\n {\n surface,\n command: \"classify-severity\",\n threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,\n },\n );\n options.signal?.throwIfAborted();\n try {\n return parseSeverityDecision(JSON.parse(response), finding.findingId);\n } catch (error) {\n throw new CodexSecurityError(\n \"Severity classification returned an invalid assessment.\",\n { cause: error },\n );\n }\n }, classificationRuns);\n options.signal?.throwIfAborted();\n const assessment: SeverityAssessment = {\n ...decision,\n occurrenceId: finding.occurrenceId ?? null,\n inputSha256,\n source: \"rubric\",\n };\n await checkpoint?.save(finding, assessment, binding);\n result.assessments.push(assessment);\n }\n options.signal?.throwIfAborted();\n return result;\n}\n\nasync function readDocuments(\n paths: readonly string[],\n signal?: AbortSignal,\n): Promise<string[]> {\n const contents = await readKnowledgeBaseDocuments(paths, signal);\n if (contents.every((text) => !text.trim())) {\n throw new CodexSecurityError(\"Classification documents must not be empty.\");\n }\n return contents;\n}\n\n/** @internal Check parsed assessments against the actual finding evidence. */\nexport function validateSeverityClassification(\n result: SeverityClassification,\n findings: readonly SeverityClassificationFinding[],\n): SeverityClassification {\n const byId = new Map(findings.map(findingEntry));\n for (const assessment of result.assessments) {\n const finding = byId.get(assessment.findingId);\n if (\n !finding ||\n assessment.occurrenceId !== (finding.occurrenceId ?? null) ||\n assessment.inputSha256 !== workflowDigest(finding) ||\n (assessment.source === \"rubric\") !== (result.rubricSha256 !== null) ||\n (assessment.decision === \"assessed\"\n ? assessment.level === null\n : assessment.level !== null) ||\n (assessment.source === \"rubric\" &&\n (assessment.decision === \"assessed\"\n ? assessment.rubricLabel === null\n : assessment.rubricLabel !== null)) ||\n (assessment.source === \"existing-severity\" &&\n (assessment.decision !== \"assessed\" ||\n assessment.level !== finding.severity?.level))\n ) {\n throw new CodexSecurityError(\n \"Severity assessment does not match the supplied findings. Classify the findings again.\",\n );\n }\n byId.delete(assessment.findingId);\n }\n return result;\n}\n"]}
|