@openai/codex-security 0.2.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +437 -2692
- package/_bundled_plugin/.app.json +5 -1
- package/_bundled_plugin/.codex-plugin/plugin.json +4 -0
- package/_bundled_plugin/.mcp.json +2 -0
- package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
- package/_bundled_plugin/examples/completed-scan/report.md +28 -26
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
- package/_bundled_plugin/mcp/helpers.mjs +1 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
- package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
- package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +556 -0
- package/_bundled_plugin/mcp/server.mjs +1 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
- package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
- package/_bundled_plugin/references/artifact-storage.md +2 -2
- package/_bundled_plugin/references/config-preflight.md +0 -4
- package/_bundled_plugin/references/core-scan.md +21 -9
- package/_bundled_plugin/references/final-report.md +11 -13
- package/_bundled_plugin/references/finding-detail-fields.md +90 -80
- package/_bundled_plugin/references/sarif-adapter.md +1 -1
- package/_bundled_plugin/references/scan-artifacts.md +1 -2
- package/_bundled_plugin/references/scan-contract.md +9 -4
- package/_bundled_plugin/references/scan-prologue.md +12 -0
- package/_bundled_plugin/references/security-guidance.md +2 -2
- package/_bundled_plugin/references/standalone-validation.md +11 -0
- package/_bundled_plugin/references/threat-model.md +1 -1
- package/_bundled_plugin/schemas/coverage.schema.json +43 -170
- package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
- package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
- package/_bundled_plugin/schemas/findings.schema.json +159 -567
- package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
- package/_bundled_plugin/schemas/scan-manifest.schema.json +78 -220
- package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
- package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
- package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
- package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
- package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
- package/_bundled_plugin/scripts/codex_session.mjs +53 -0
- package/_bundled_plugin/scripts/config_preflight.py +26 -62
- package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
- package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
- package/_bundled_plugin/scripts/finalize_scan_contract.py +321 -237
- package/_bundled_plugin/scripts/finding_preview.py +39 -9
- package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
- package/_bundled_plugin/scripts/generate_rank_input.py +115 -926
- package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
- package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
- package/_bundled_plugin/scripts/rank_preview.py +42 -918
- package/_bundled_plugin/scripts/report_projection.py +150 -183
- package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
- package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
- package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
- package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
- package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
- package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
- package/_bundled_plugin/scripts/workbench/storage.py +10 -6
- package/_bundled_plugin/scripts/workbench_cli.py +102 -184
- package/_bundled_plugin/scripts/workbench_db.py +463 -464
- package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
- package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
- package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
- package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
- package/_bundled_plugin/scripts/workbench_progress.py +14 -58
- package/_bundled_plugin/scripts/workbench_publication.py +234 -289
- package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
- package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
- package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
- package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
- package/_bundled_plugin/scripts/workbench_scan_usage.py +194 -42
- package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
- package/_bundled_plugin/scripts/workbench_target.py +430 -142
- package/_bundled_plugin/scripts/workbench_validation.py +31 -28
- package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
- package/_bundled_plugin/shared/workbench-migrations.json +414 -0
- package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
- package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
- package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
- package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
- package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
- package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
- package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
- package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +15 -1
- package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
- package/_bundled_plugin/skills/track-findings/SKILL.md +48 -176
- package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
- package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
- package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
- package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
- package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
- package/bin/codex-security.mjs +9 -2
- package/dist/api.d.ts +63 -10
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +1015 -383
- package/dist/api.js.map +1 -1
- package/dist/artifact-export.d.ts +1 -1
- package/dist/artifact-export.d.ts.map +1 -1
- package/dist/artifact-export.js +28 -13
- package/dist/artifact-export.js.map +1 -1
- package/dist/auth.d.ts +2 -6
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +19 -9
- package/dist/auth.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +1 -0
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/classify-severity.d.ts +26 -9
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +13 -30
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-help.d.ts.map +1 -1
- package/dist/cli-help.js +17 -13
- package/dist/cli-help.js.map +1 -1
- package/dist/cli-signals.d.ts +8 -0
- package/dist/cli-signals.d.ts.map +1 -0
- package/dist/cli-signals.js +28 -0
- package/dist/cli-signals.js.map +1 -0
- package/dist/cli.d.ts +4 -3
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1102 -905
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +10 -9
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codeowners.d.ts +19 -0
- package/dist/codeowners.d.ts.map +1 -0
- package/dist/codeowners.js +138 -0
- package/dist/codeowners.js.map +1 -0
- package/dist/codex-sdk-environment.d.ts +1 -0
- package/dist/codex-sdk-environment.d.ts.map +1 -1
- package/dist/codex-sdk-environment.js +40 -2
- package/dist/codex-sdk-environment.js.map +1 -1
- package/dist/component-plan.d.ts +2 -5
- package/dist/component-plan.d.ts.map +1 -1
- package/dist/component-plan.js +39 -31
- package/dist/component-plan.js.map +1 -1
- package/dist/component-scan.d.ts +6 -5
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +25 -36
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +64 -74
- package/dist/config.js.map +1 -1
- package/dist/contract.d.ts +16 -3
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +91 -255
- package/dist/contract.js.map +1 -1
- package/dist/cost-model.d.ts +13 -6
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +14 -4
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +10 -2
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +102 -104
- package/dist/cost.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +6 -5
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/custom-validation.d.ts +1 -2
- package/dist/custom-validation.d.ts.map +1 -1
- package/dist/custom-validation.js +9 -3
- package/dist/custom-validation.js.map +1 -1
- package/dist/deduplication/checkpointed-review.d.ts +4 -2
- package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
- package/dist/deduplication/checkpointed-review.js +23 -9
- package/dist/deduplication/checkpointed-review.js.map +1 -1
- package/dist/deduplication/codex-review.d.ts +8 -6
- package/dist/deduplication/codex-review.d.ts.map +1 -1
- package/dist/deduplication/codex-review.js +128 -19
- package/dist/deduplication/codex-review.js.map +1 -1
- package/dist/deduplication/deduplication-prompts.d.ts +5 -2
- package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
- package/dist/deduplication/deduplication-prompts.js +18 -4
- package/dist/deduplication/deduplication-prompts.js.map +1 -1
- package/dist/deduplication/deduplication-reviewer.d.ts +27 -5
- package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
- package/dist/deduplication/deduplication-reviewer.js +58 -48
- package/dist/deduplication/deduplication-reviewer.js.map +1 -1
- package/dist/deduplication/deduplication.d.ts.map +1 -1
- package/dist/deduplication/deduplication.js +19 -51
- package/dist/deduplication/deduplication.js.map +1 -1
- package/dist/deduplication/diagnostics.d.ts +17 -0
- package/dist/deduplication/diagnostics.d.ts.map +1 -0
- package/dist/deduplication/diagnostics.js +5 -0
- package/dist/deduplication/diagnostics.js.map +1 -0
- package/dist/deduplication/finding-schema.d.ts.map +1 -1
- package/dist/deduplication/finding-schema.js +7 -1
- package/dist/deduplication/finding-schema.js.map +1 -1
- package/dist/deduplication/local.d.ts +31 -0
- package/dist/deduplication/local.d.ts.map +1 -0
- package/dist/deduplication/local.js +166 -0
- package/dist/deduplication/local.js.map +1 -0
- package/dist/deduplication/records-protocol.d.ts +3 -8
- package/dist/deduplication/records-protocol.d.ts.map +1 -1
- package/dist/deduplication/records-protocol.js +11 -184
- package/dist/deduplication/records-protocol.js.map +1 -1
- package/dist/deduplication/records.d.ts +186 -11
- package/dist/deduplication/records.d.ts.map +1 -1
- package/dist/deduplication/records.js +10 -18
- package/dist/deduplication/records.js.map +1 -1
- package/dist/deduplication/scan.d.ts +9 -3
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +158 -39
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +2 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +4 -4
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-progress.d.ts +17 -1
- package/dist/deep-progress.d.ts.map +1 -1
- package/dist/deep-progress.js +19 -17
- package/dist/deep-progress.js.map +1 -1
- package/dist/deep-scan.d.ts +20 -0
- package/dist/deep-scan.d.ts.map +1 -0
- package/dist/deep-scan.js +113 -0
- package/dist/deep-scan.js.map +1 -0
- package/dist/errors.d.ts +2 -0
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +2 -0
- package/dist/errors.js.map +1 -1
- package/dist/executable-path.d.ts +2 -0
- package/dist/executable-path.d.ts.map +1 -0
- package/dist/executable-path.js +12 -0
- package/dist/executable-path.js.map +1 -0
- package/dist/feedback.d.ts +1 -4
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +54 -22
- package/dist/feedback.js.map +1 -1
- package/dist/finding-catalogue.d.ts.map +1 -1
- package/dist/finding-catalogue.js +4 -8
- package/dist/finding-catalogue.js.map +1 -1
- package/dist/finding-normalization.d.ts +5 -0
- package/dist/finding-normalization.d.ts.map +1 -0
- package/dist/finding-normalization.js +120 -0
- package/dist/finding-normalization.js.map +1 -0
- package/dist/finding-retrieval.d.ts +9 -0
- package/dist/finding-retrieval.d.ts.map +1 -1
- package/dist/finding-retrieval.js.map +1 -1
- package/dist/finding-workflow.d.ts +13 -8
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +14 -6
- package/dist/finding-workflow.js.map +1 -1
- package/dist/findings-client.d.ts +2 -1
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +36 -9
- package/dist/findings-client.js.map +1 -1
- package/dist/findings-errors.d.ts +16 -0
- package/dist/findings-errors.d.ts.map +1 -0
- package/dist/findings-errors.js +24 -0
- package/dist/findings-errors.js.map +1 -0
- package/dist/findings-import.d.ts +1 -1
- package/dist/findings-import.d.ts.map +1 -1
- package/dist/findings-import.js +12 -30
- package/dist/findings-import.js.map +1 -1
- package/dist/github.d.ts.map +1 -1
- package/dist/github.js +7 -1
- package/dist/github.js.map +1 -1
- package/dist/host-protocol.d.ts +19 -0
- package/dist/host-protocol.d.ts.map +1 -0
- package/dist/host-protocol.js +270 -0
- package/dist/host-protocol.js.map +1 -0
- package/dist/hosted-scan-protocol.d.ts +4 -0
- package/dist/hosted-scan-protocol.d.ts.map +1 -0
- package/dist/hosted-scan-protocol.js +25 -0
- package/dist/hosted-scan-protocol.js.map +1 -0
- package/dist/hosted-scan.d.ts +117 -0
- package/dist/hosted-scan.d.ts.map +1 -0
- package/dist/hosted-scan.js +260 -0
- package/dist/hosted-scan.js.map +1 -0
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +48 -38
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +11 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/knowledge-base.d.ts +7 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +114 -46
- package/dist/knowledge-base.js.map +1 -1
- package/dist/linear.d.ts.map +1 -1
- package/dist/linear.js +2 -7
- package/dist/linear.js.map +1 -1
- package/dist/mock-scan.d.ts.map +1 -1
- package/dist/mock-scan.js +0 -1
- package/dist/mock-scan.js.map +1 -1
- package/dist/models.d.ts +0 -2
- package/dist/models.d.ts.map +1 -1
- package/dist/models.js.map +1 -1
- package/dist/multiscan.d.ts +9 -3
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +240 -135
- package/dist/multiscan.js.map +1 -1
- package/dist/owner-evidence.d.ts +10 -2
- package/dist/owner-evidence.d.ts.map +1 -1
- package/dist/owner-evidence.js +67 -8
- package/dist/owner-evidence.js.map +1 -1
- package/dist/patch-tui.d.ts.map +1 -1
- package/dist/patch-tui.js +3 -2
- package/dist/patch-tui.js.map +1 -1
- package/dist/project-config.js +3 -3
- package/dist/project-config.js.map +1 -1
- package/dist/provider-profile.d.ts +21 -0
- package/dist/provider-profile.d.ts.map +1 -0
- package/dist/provider-profile.js +133 -0
- package/dist/provider-profile.js.map +1 -0
- package/dist/publication-events.d.ts +6 -8
- package/dist/publication-events.d.ts.map +1 -1
- package/dist/publication-events.js +25 -50
- package/dist/publication-events.js.map +1 -1
- package/dist/publication-store.d.ts.map +1 -1
- package/dist/publication-store.js +95 -109
- package/dist/publication-store.js.map +1 -1
- package/dist/publication.d.ts +1 -4
- package/dist/publication.d.ts.map +1 -1
- package/dist/publication.js +2 -13
- package/dist/publication.js.map +1 -1
- package/dist/publish.d.ts +1 -5
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +109 -160
- package/dist/publish.js.map +1 -1
- package/dist/request-metadata.d.ts +9 -0
- package/dist/request-metadata.d.ts.map +1 -0
- package/dist/request-metadata.js +13 -0
- package/dist/request-metadata.js.map +1 -0
- package/dist/runtime.d.ts +20 -6
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +407 -148
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +14 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -0
- package/dist/saved-scan-bootstrap.js +261 -0
- package/dist/saved-scan-bootstrap.js.map +1 -0
- package/dist/saved-scan.d.ts +1 -1
- package/dist/saved-scan.d.ts.map +1 -1
- package/dist/saved-scan.js +6 -12
- package/dist/saved-scan.js.map +1 -1
- package/dist/scan-activity.js +11 -8
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +28 -15
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +276 -281
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +3 -0
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +345 -77
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts +104 -0
- package/dist/scan-executor.d.ts.map +1 -0
- package/dist/scan-executor.js +62 -0
- package/dist/scan-executor.js.map +1 -0
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +54 -13
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-inputs.d.ts +6 -0
- package/dist/scan-inputs.d.ts.map +1 -0
- package/dist/scan-inputs.js +71 -0
- package/dist/scan-inputs.js.map +1 -0
- package/dist/scan-logs.d.ts +2 -3
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +12 -6
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-sessions.d.ts +4 -0
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +17 -0
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-skill-paths.d.ts +8 -0
- package/dist/scan-skill-paths.d.ts.map +1 -0
- package/dist/scan-skill-paths.js +47 -0
- package/dist/scan-skill-paths.js.map +1 -0
- package/dist/security-policy-cli.d.ts.map +1 -1
- package/dist/security-policy-cli.js +7 -27
- package/dist/security-policy-cli.js.map +1 -1
- package/dist/security-policy.d.ts +9 -5
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js +33 -14
- package/dist/security-policy.js.map +1 -1
- package/dist/server/api.d.ts +0 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js +0 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embeddings.d.ts +3 -1
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +10 -3
- package/dist/server/embeddings.js.map +1 -1
- package/dist/server/errors.d.ts +5 -2
- package/dist/server/errors.d.ts.map +1 -1
- package/dist/server/errors.js +7 -0
- package/dist/server/errors.js.map +1 -1
- package/dist/server/sqlite-store.d.ts +0 -2
- package/dist/server/sqlite-store.d.ts.map +1 -1
- package/dist/server/sqlite-store.js +54 -44
- package/dist/server/sqlite-store.js.map +1 -1
- package/dist/server/storage.d.ts +0 -2
- package/dist/server/storage.d.ts.map +1 -1
- package/dist/server/storage.js.map +1 -1
- package/dist/severity-store.js +19 -24
- package/dist/severity-store.js.map +1 -1
- package/dist/standalone-validation-prompt.d.ts +2 -0
- package/dist/standalone-validation-prompt.d.ts.map +1 -0
- package/dist/standalone-validation-prompt.js +10 -0
- package/dist/standalone-validation-prompt.js.map +1 -0
- package/dist/suggest-owners.d.ts +4 -2
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +11 -5
- package/dist/suggest-owners.js.map +1 -1
- package/dist/targets.d.ts +11 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +123 -72
- package/dist/targets.js.map +1 -1
- package/dist/trusted-executable.d.ts +2 -2
- package/dist/trusted-executable.d.ts.map +1 -1
- package/dist/trusted-executable.js +8 -6
- package/dist/trusted-executable.js.map +1 -1
- package/dist/value.js +7 -0
- package/dist/value.js.map +1 -1
- package/dist/version.js.map +1 -1
- package/dist/workbench-arguments.d.ts +3 -0
- package/dist/workbench-arguments.d.ts.map +1 -0
- package/dist/workbench-arguments.js +15 -0
- package/dist/workbench-arguments.js.map +1 -0
- package/dist/worker-progress.d.ts +44 -11
- package/dist/worker-progress.d.ts.map +1 -1
- package/dist/worker-progress.js +48 -49
- package/dist/worker-progress.js.map +1 -1
- package/docs/cli.md +1788 -0
- package/docs/findings-service.md +402 -0
- package/docs/hosted-scans.md +242 -0
- package/package.json +23 -22
- package/schemas/hosted-scan-v2.fixture.json +145 -0
- package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
- package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
- package/_bundled_plugin/scripts/workbench_findings.py +0 -221
- package/_bundled_plugin/scripts/workbench_severity.py +0 -122
- package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
- package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
- package/dist/server/dashboard/app.css +0 -2
- package/dist/server/dashboard/app.js +0 -66
- package/dist/server/dashboard/index.html +0 -18
- package/dist/server/dashboard-types.d.ts +0 -48
- package/dist/server/dashboard-types.d.ts.map +0 -1
- package/dist/server/dashboard-types.js +0 -2
- package/dist/server/dashboard-types.js.map +0 -1
- package/dist/server/dashboard.d.ts +0 -6
- package/dist/server/dashboard.d.ts.map +0 -1
- package/dist/server/dashboard.js +0 -59
- package/dist/server/dashboard.js.map +0 -1
- package/dist/server/index.d.ts +0 -2
- package/dist/server/index.d.ts.map +0 -1
- package/dist/server/index.js +0 -6
- package/dist/server/index.js.map +0 -1
- package/dist/server/routes.d.ts +0 -7
- package/dist/server/routes.d.ts.map +0 -1
- package/dist/server/routes.js +0 -98
- package/dist/server/routes.js.map +0 -1
- package/dist/server/serve.d.ts +0 -2
- package/dist/server/serve.d.ts.map +0 -1
- package/dist/server/serve.js +0 -28
- package/dist/server/serve.js.map +0 -1
- package/dist/server/server.d.ts +0 -10
- package/dist/server/server.d.ts.map +0 -1
- package/dist/server/server.js +0 -16
- package/dist/server/server.js.map +0 -1
- package/dist/server/validation.d.ts +0 -17
- package/dist/server/validation.d.ts.map +0 -1
- package/dist/server/validation.js +0 -53
- package/dist/server/validation.js.map +0 -1
package/dist/contract.js
CHANGED
|
@@ -1,9 +1,11 @@
|
|
|
1
|
+
import { isDeepStrictEqual as sameArray } from "node:util";
|
|
1
2
|
import { createHash, hash } from "node:crypto";
|
|
2
|
-
import {
|
|
3
|
+
import { normalizePersistedFindingDetails } from "./finding-normalization.js";
|
|
3
4
|
import { constants } from "node:fs";
|
|
4
5
|
import { lstat, open, readFile, realpath, } from "node:fs/promises";
|
|
5
6
|
import { isAbsolute, join, posix, resolve } from "node:path";
|
|
6
7
|
import Ajv2020 from "ajv/dist/2020.js";
|
|
8
|
+
import { regexes } from "zod";
|
|
7
9
|
import { ContractValidationError, abortReason } from "./errors.js";
|
|
8
10
|
import { isRecord } from "./record.js";
|
|
9
11
|
import { requirePrivateOutputDirectory, requireSecureOutputAncestry, } from "./runtime.js";
|
|
@@ -15,17 +17,6 @@ const DOCUMENTS = {
|
|
|
15
17
|
"coverage.json": "coverage.schema.json",
|
|
16
18
|
};
|
|
17
19
|
const PRODUCER_NAME = "codex-security-plugin";
|
|
18
|
-
const SAFE_SCHEMA_ERROR_PROPERTIES = new Set([
|
|
19
|
-
"scan",
|
|
20
|
-
"target",
|
|
21
|
-
"remote",
|
|
22
|
-
"completedAt",
|
|
23
|
-
"sealedAt",
|
|
24
|
-
"artifacts",
|
|
25
|
-
"findings",
|
|
26
|
-
"coverage",
|
|
27
|
-
"scope",
|
|
28
|
-
]);
|
|
29
20
|
export async function loadContract(scanDirectory, options) {
|
|
30
21
|
return (await loadContractWithScanDirectory(scanDirectory, options)).contract;
|
|
31
22
|
}
|
|
@@ -33,14 +24,15 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
|
|
|
33
24
|
const scanRoot = await requireScanRoot(scanDirectory, options.signal);
|
|
34
25
|
const scanDir = scanRoot.path;
|
|
35
26
|
const documentDigests = new Map();
|
|
36
|
-
const payloads = {
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
};
|
|
27
|
+
const payloads = {};
|
|
28
|
+
for (const filename of Object.keys(DOCUMENTS)) {
|
|
29
|
+
payloads[filename] = await readScanJson(scanDir, filename, documentDigests, options.signal, scanRoot);
|
|
30
|
+
}
|
|
41
31
|
throwIfAborted(options.signal);
|
|
42
|
-
|
|
43
|
-
|
|
32
|
+
// The plugin schemas are the immutable v0 contract. They are valid Draft
|
|
33
|
+
// 2020-12 but intentionally omit redundant local `type` keywords that Ajv's
|
|
34
|
+
// optional strict-schema linter requires.
|
|
35
|
+
const ajv = new Ajv2020({ allErrors: false, strict: false }).addFormat("date-time", { type: "string", validate: validRfc3339DateTime });
|
|
44
36
|
for (const [filename, schemaName] of Object.entries(DOCUMENTS)) {
|
|
45
37
|
const schema = await readJson(join(options.pluginRoot, "schemas", schemaName), options.signal);
|
|
46
38
|
let validate;
|
|
@@ -48,10 +40,7 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
|
|
|
48
40
|
let valid;
|
|
49
41
|
try {
|
|
50
42
|
validate = ajv.compile(schema);
|
|
51
|
-
payload =
|
|
52
|
-
filename === "findings.json"
|
|
53
|
-
? findingsPayload
|
|
54
|
-
: payloads[filename];
|
|
43
|
+
payload = payloads[filename];
|
|
55
44
|
const validatePayload = (payload) => {
|
|
56
45
|
const result = validate(payload);
|
|
57
46
|
if (typeof result !== "boolean") {
|
|
@@ -71,12 +60,11 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
|
|
|
71
60
|
if (!valid) {
|
|
72
61
|
throw schemaError(filename, validate.errors ?? []);
|
|
73
62
|
}
|
|
74
|
-
|
|
75
|
-
findingsPayload = payload;
|
|
63
|
+
payloads[filename] = payload;
|
|
76
64
|
throwIfAborted(options.signal);
|
|
77
65
|
}
|
|
78
66
|
const manifest = payloads["scan-manifest.json"];
|
|
79
|
-
const findings =
|
|
67
|
+
const findings = payloads["findings.json"];
|
|
80
68
|
const coverage = payloads["coverage.json"];
|
|
81
69
|
if (options.expectedScanId !== undefined &&
|
|
82
70
|
manifest.scan.id !== options.expectedScanId) {
|
|
@@ -104,7 +92,7 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
|
|
|
104
92
|
};
|
|
105
93
|
}
|
|
106
94
|
/** Normalize optional legacy details on a copy, without changing saved artifacts. */
|
|
107
|
-
|
|
95
|
+
function normalizePersistedFindings(payload) {
|
|
108
96
|
const compatible = structuredClone(payload);
|
|
109
97
|
if (!isRecord(compatible) || !Array.isArray(compatible["findings"])) {
|
|
110
98
|
return compatible;
|
|
@@ -112,149 +100,10 @@ export function normalizePersistedFindings(payload) {
|
|
|
112
100
|
for (const finding of compatible["findings"]) {
|
|
113
101
|
if (!isRecord(finding))
|
|
114
102
|
continue;
|
|
115
|
-
|
|
116
|
-
if (Array.isArray(legacyEvidence)) {
|
|
117
|
-
const compatibleEvidence = [];
|
|
118
|
-
for (const evidence of legacyEvidence) {
|
|
119
|
-
if (!isRecord(evidence))
|
|
120
|
-
continue;
|
|
121
|
-
const id = evidence["id"];
|
|
122
|
-
const code = evidence["code"];
|
|
123
|
-
if (!isNonEmptyString(id) || !isNonEmptyString(code)) {
|
|
124
|
-
continue;
|
|
125
|
-
}
|
|
126
|
-
compatibleEvidence.push(evidence);
|
|
127
|
-
}
|
|
128
|
-
finding["code_evidence"] = compatibleEvidence;
|
|
129
|
-
}
|
|
130
|
-
else if ("code_evidence" in finding && legacyEvidence !== null) {
|
|
131
|
-
delete finding["code_evidence"];
|
|
132
|
-
}
|
|
133
|
-
for (const [sectionName, listFields] of [
|
|
134
|
-
["root_cause", ["evidenceRefs", "evidence_refs"]],
|
|
135
|
-
[
|
|
136
|
-
"validation",
|
|
137
|
-
[
|
|
138
|
-
"assertions",
|
|
139
|
-
"counterEvidence",
|
|
140
|
-
"evidenceRefs",
|
|
141
|
-
"evidence_refs",
|
|
142
|
-
"limitations",
|
|
143
|
-
],
|
|
144
|
-
],
|
|
145
|
-
[
|
|
146
|
-
"attackPath",
|
|
147
|
-
[
|
|
148
|
-
"assumptions",
|
|
149
|
-
"blindspots",
|
|
150
|
-
"controls",
|
|
151
|
-
"evidenceRefs",
|
|
152
|
-
"evidence_refs",
|
|
153
|
-
"limitations",
|
|
154
|
-
"preconditions",
|
|
155
|
-
"steps",
|
|
156
|
-
],
|
|
157
|
-
],
|
|
158
|
-
]) {
|
|
159
|
-
const section = finding[sectionName];
|
|
160
|
-
if (!isRecord(section))
|
|
161
|
-
continue;
|
|
162
|
-
normalizeLegacyStringLists(section, listFields);
|
|
163
|
-
}
|
|
164
|
-
const legacyRootCause = finding["root_cause"];
|
|
165
|
-
if (isRecord(legacyRootCause)) {
|
|
166
|
-
removeUnsupportedLegacyStrings(legacyRootCause, [
|
|
167
|
-
"summary",
|
|
168
|
-
"code",
|
|
169
|
-
"language",
|
|
170
|
-
]);
|
|
171
|
-
}
|
|
172
|
-
else if ("root_cause" in finding &&
|
|
173
|
-
legacyRootCause !== null &&
|
|
174
|
-
typeof legacyRootCause !== "string") {
|
|
175
|
-
delete finding["root_cause"];
|
|
176
|
-
}
|
|
177
|
-
const validation = finding["validation"];
|
|
178
|
-
if (isRecord(validation)) {
|
|
179
|
-
if (typeof validation["evidence"] !== "string" ||
|
|
180
|
-
validation["evidence"].length === 0) {
|
|
181
|
-
normalizeLegacyStringLists(validation, ["evidence"]);
|
|
182
|
-
}
|
|
183
|
-
removeUnsupportedLegacyStrings(validation, ["method", "summary"]);
|
|
184
|
-
removeUnsupportedLegacyStrings(validation, ["status", "disposition", "result"].filter((field) => validation[field] !== null));
|
|
185
|
-
}
|
|
186
|
-
const attackPath = finding["attackPath"];
|
|
187
|
-
if (!isRecord(attackPath))
|
|
188
|
-
continue;
|
|
189
|
-
removeUnsupportedLegacyStrings(attackPath, ["summary"]);
|
|
190
|
-
for (const field of ["dataFlow", "data_flow", "dataflow", "reachability"]) {
|
|
191
|
-
const detail = attackPath[field];
|
|
192
|
-
if (detail === null) {
|
|
193
|
-
delete attackPath[field];
|
|
194
|
-
continue;
|
|
195
|
-
}
|
|
196
|
-
if (typeof detail === "string") {
|
|
197
|
-
if (detail.length === 0)
|
|
198
|
-
delete attackPath[field];
|
|
199
|
-
continue;
|
|
200
|
-
}
|
|
201
|
-
if (!isRecord(detail)) {
|
|
202
|
-
if (field in attackPath)
|
|
203
|
-
delete attackPath[field];
|
|
204
|
-
continue;
|
|
205
|
-
}
|
|
206
|
-
removeUnsupportedLegacyStrings(detail, [
|
|
207
|
-
"summary",
|
|
208
|
-
"source",
|
|
209
|
-
"sink",
|
|
210
|
-
"outcome",
|
|
211
|
-
...(field === "reachability" ? ["attacker", "entrypoint"] : []),
|
|
212
|
-
]);
|
|
213
|
-
normalizeLegacyStringLists(detail, [
|
|
214
|
-
"evidenceRefs",
|
|
215
|
-
"evidence_refs",
|
|
216
|
-
"transformations",
|
|
217
|
-
...(field === "reachability" ? ["preconditions"] : []),
|
|
218
|
-
]);
|
|
219
|
-
}
|
|
220
|
-
for (const field of ["impact", "likelihood"]) {
|
|
221
|
-
const detail = attackPath[field];
|
|
222
|
-
if (isRecord(detail)) {
|
|
223
|
-
removeUnsupportedLegacyStrings(detail, ["level", "rationale", "why"]);
|
|
224
|
-
}
|
|
225
|
-
else if (detail !== undefined &&
|
|
226
|
-
detail !== null &&
|
|
227
|
-
!isNonEmptyString(detail)) {
|
|
228
|
-
delete attackPath[field];
|
|
229
|
-
}
|
|
230
|
-
}
|
|
103
|
+
normalizePersistedFindingDetails(finding);
|
|
231
104
|
}
|
|
232
105
|
return compatible;
|
|
233
106
|
}
|
|
234
|
-
function normalizeLegacyStringLists(section, fields) {
|
|
235
|
-
for (const field of fields) {
|
|
236
|
-
if (!(field in section))
|
|
237
|
-
continue;
|
|
238
|
-
const value = section[field];
|
|
239
|
-
if (Array.isArray(value)) {
|
|
240
|
-
section[field] = value.filter(isNonEmptyString);
|
|
241
|
-
}
|
|
242
|
-
else if (isNonEmptyString(value)) {
|
|
243
|
-
section[field] = [value];
|
|
244
|
-
}
|
|
245
|
-
else {
|
|
246
|
-
delete section[field];
|
|
247
|
-
}
|
|
248
|
-
}
|
|
249
|
-
}
|
|
250
|
-
function removeUnsupportedLegacyStrings(section, fields) {
|
|
251
|
-
for (const field of fields) {
|
|
252
|
-
if (field in section &&
|
|
253
|
-
(typeof section[field] !== "string" || section[field].length === 0)) {
|
|
254
|
-
delete section[field];
|
|
255
|
-
}
|
|
256
|
-
}
|
|
257
|
-
}
|
|
258
107
|
function validateCanonicalContract(manifest, findings) {
|
|
259
108
|
const remote = manifest.scan.target.remote;
|
|
260
109
|
if (remote !== undefined) {
|
|
@@ -292,8 +141,29 @@ function validateCanonicalContract(manifest, findings) {
|
|
|
292
141
|
}
|
|
293
142
|
}
|
|
294
143
|
}
|
|
144
|
+
const findingIds = new Set();
|
|
295
145
|
for (const [findingIndex, finding] of findings.findings.entries()) {
|
|
296
146
|
const context = `findings.findings[${findingIndex}]`;
|
|
147
|
+
if (findingIds.has(finding.findingId)) {
|
|
148
|
+
throw new ContractValidationError(`${context}: duplicate finding id.`);
|
|
149
|
+
}
|
|
150
|
+
findingIds.add(finding.findingId);
|
|
151
|
+
for (const [field, value] of [
|
|
152
|
+
["title", finding.title],
|
|
153
|
+
["summary", finding.summary],
|
|
154
|
+
["remediation", finding.remediation],
|
|
155
|
+
["confidence.rationale", finding.confidence.rationale],
|
|
156
|
+
["taxonomy.category", finding.taxonomy.category],
|
|
157
|
+
["provenance.source", finding.provenance.source],
|
|
158
|
+
...(finding.severity.score === undefined
|
|
159
|
+
? []
|
|
160
|
+
: [["severity.scoringSystem", finding.severity.scoringSystem]]),
|
|
161
|
+
]) {
|
|
162
|
+
// Match the producer's Python str.strip without changing saved text.
|
|
163
|
+
if (/^[\p{White_Space}\u001c-\u001f]*$/u.test(value ?? "")) {
|
|
164
|
+
throw new ContractValidationError(`${context}.${field}: expected a non-empty string.`);
|
|
165
|
+
}
|
|
166
|
+
}
|
|
297
167
|
for (const [locationIndex, location] of finding.locations.entries()) {
|
|
298
168
|
const locationContext = `${context}.locations[${locationIndex}]`;
|
|
299
169
|
try {
|
|
@@ -302,23 +172,18 @@ function validateCanonicalContract(manifest, findings) {
|
|
|
302
172
|
catch (error) {
|
|
303
173
|
throw new ContractValidationError(`${locationContext}.path: expected a safe repository-relative POSIX path.`, { cause: error });
|
|
304
174
|
}
|
|
175
|
+
if ((location.endLine ?? location.startLine) < location.startLine) {
|
|
176
|
+
throw new ContractValidationError(`${locationContext}.endLine: expected an integer >= startLine.`);
|
|
177
|
+
}
|
|
305
178
|
}
|
|
306
|
-
const
|
|
307
|
-
"codex-security/v1",
|
|
308
|
-
manifest.scan.target.targetId,
|
|
309
|
-
finding.ruleId,
|
|
310
|
-
finding.identity.anchor,
|
|
311
|
-
finding.identity.instance ?? "",
|
|
312
|
-
].join("\0"))}`;
|
|
313
|
-
const findingId = `csf_${hash("sha256", fingerprint).slice(0, 24)}`;
|
|
314
|
-
const occurrenceId = `occ_${hash("sha256", [manifest.scan.id, fingerprint].join("\0")).slice(0, 24)}`;
|
|
179
|
+
const { findingId, occurrenceId, fingerprints } = deriveFindingIdentity(manifest.scan.id, manifest.scan.target.targetId, finding.ruleId, finding.identity);
|
|
315
180
|
if (finding.findingId !== findingId) {
|
|
316
181
|
throw new ContractValidationError(`${context}.findingId: does not match derived fingerprint identity.`);
|
|
317
182
|
}
|
|
318
183
|
if (finding.occurrenceId !== occurrenceId) {
|
|
319
184
|
throw new ContractValidationError(`${context}.occurrenceId: does not match scan occurrence identity.`);
|
|
320
185
|
}
|
|
321
|
-
if (finding.fingerprints.primary !==
|
|
186
|
+
if (finding.fingerprints.primary !== fingerprints.primary) {
|
|
322
187
|
throw new ContractValidationError(`${context}.fingerprints: does not match derived fingerprint.`);
|
|
323
188
|
}
|
|
324
189
|
}
|
|
@@ -407,18 +272,29 @@ async function validateSeal(scanDir, manifest, findings, coverage, documentDiges
|
|
|
407
272
|
throw new ContractValidationError(`${context}: sealed artifact changed or is missing.`);
|
|
408
273
|
}
|
|
409
274
|
}
|
|
275
|
+
const requireSealedReference = (reference, context) => {
|
|
276
|
+
throwIfAborted(signal);
|
|
277
|
+
if (typeof reference !== "string") {
|
|
278
|
+
throw new ContractValidationError(`${context}: expected a string.`);
|
|
279
|
+
}
|
|
280
|
+
const normalized = portableRelativePath(reference, context.toLowerCase());
|
|
281
|
+
if (!normalized.startsWith("artifacts/")) {
|
|
282
|
+
throw new ContractValidationError(`${context} must be under artifacts/: ${reference}`);
|
|
283
|
+
}
|
|
284
|
+
if (!artifactPaths.has(normalized)) {
|
|
285
|
+
throw new ContractValidationError(`${context} is missing from sealed artifacts: ${reference}`);
|
|
286
|
+
}
|
|
287
|
+
};
|
|
410
288
|
for (const surface of coverage.surfaces) {
|
|
411
289
|
for (const receipt of surface.receiptRefs) {
|
|
412
|
-
|
|
413
|
-
const normalized = portableRelativePath(receipt, "coverage receipt");
|
|
414
|
-
if (!normalized.startsWith("artifacts/")) {
|
|
415
|
-
throw new ContractValidationError(`Coverage receipt must be under artifacts/: ${receipt}`);
|
|
416
|
-
}
|
|
417
|
-
if (!artifactPaths.has(normalized)) {
|
|
418
|
-
throw new ContractValidationError(`Coverage receipt is missing from sealed artifacts: ${receipt}`);
|
|
419
|
-
}
|
|
290
|
+
requireSealedReference(receipt, "Coverage receipt");
|
|
420
291
|
}
|
|
421
292
|
}
|
|
293
|
+
const extensions = scan["extensions"];
|
|
294
|
+
const imported = isRecord(extensions) ? extensions["import"] : undefined;
|
|
295
|
+
if (isRecord(imported) && "sourceRef" in imported) {
|
|
296
|
+
requireSealedReference(imported["sourceRef"], "Import source");
|
|
297
|
+
}
|
|
422
298
|
for (const [index, finding] of findings.findings.entries()) {
|
|
423
299
|
const writeup = finding.writeup;
|
|
424
300
|
if (writeup === undefined)
|
|
@@ -545,7 +421,7 @@ async function verifyScanRoot(root, signal) {
|
|
|
545
421
|
}
|
|
546
422
|
function safeRelativePath(value, context) {
|
|
547
423
|
const parts = value.split("/");
|
|
548
|
-
if (value.
|
|
424
|
+
if (value.length === 0 ||
|
|
549
425
|
Buffer.from(value, "utf8").toString("utf8") !== value ||
|
|
550
426
|
value === "." ||
|
|
551
427
|
value.startsWith("/") ||
|
|
@@ -565,12 +441,13 @@ function safeRelativePath(value, context) {
|
|
|
565
441
|
}
|
|
566
442
|
function portableRelativePath(value, context) {
|
|
567
443
|
const normalized = safeRelativePath(value, context);
|
|
568
|
-
if (value.
|
|
444
|
+
if (value.trim().length === 0 ||
|
|
445
|
+
value.split("/").some(isWindowsUnsafePathComponent)) {
|
|
569
446
|
throw new ContractValidationError(`${context}: expected a safe scan-relative POSIX path.`);
|
|
570
447
|
}
|
|
571
448
|
return normalized;
|
|
572
449
|
}
|
|
573
|
-
function safeScopePath(value) {
|
|
450
|
+
export function safeScopePath(value) {
|
|
574
451
|
return value === "."
|
|
575
452
|
? value
|
|
576
453
|
: safeRelativePath(value, "manifest scope include path");
|
|
@@ -658,21 +535,10 @@ function validateParsedJson(value, context) {
|
|
|
658
535
|
if (!key.isWellFormed()) {
|
|
659
536
|
throw new ContractValidationError(`${context}: expected well-formed Unicode JSON keys.`);
|
|
660
537
|
}
|
|
661
|
-
validateParsedJson(item, `${context}
|
|
538
|
+
validateParsedJson(item, `${context}[${JSON.stringify(key)}]`);
|
|
662
539
|
}
|
|
663
540
|
}
|
|
664
541
|
}
|
|
665
|
-
function createValidator() {
|
|
666
|
-
// The plugin schemas are the immutable v0 contract. They are valid Draft
|
|
667
|
-
// 2020-12 but intentionally omit redundant local `type` keywords that Ajv's
|
|
668
|
-
// optional strict-schema linter requires.
|
|
669
|
-
const ajv = new Ajv2020({ allErrors: false, strict: false });
|
|
670
|
-
ajv.addFormat("date-time", {
|
|
671
|
-
type: "string",
|
|
672
|
-
validate: validRfc3339DateTime,
|
|
673
|
-
});
|
|
674
|
-
return ajv;
|
|
675
|
-
}
|
|
676
542
|
async function sha256ScanFile(scanDir, relativePath, context, signal, expectedRoot) {
|
|
677
543
|
const file = await openCheckedScanFile(scanDir, relativePath, context, signal, expectedRoot);
|
|
678
544
|
try {
|
|
@@ -763,67 +629,18 @@ function throwIfAborted(signal) {
|
|
|
763
629
|
return;
|
|
764
630
|
throw abortReason(signal);
|
|
765
631
|
}
|
|
632
|
+
const RFC3339_DATE_TIME = new RegExp(regexes.datetime({ offset: true }).source, "i");
|
|
766
633
|
function validRfc3339DateTime(value) {
|
|
767
|
-
|
|
768
|
-
if (match === null)
|
|
769
|
-
return false;
|
|
770
|
-
const year = Number(match[1]);
|
|
771
|
-
const month = Number(match[2]);
|
|
772
|
-
const day = Number(match[3]);
|
|
773
|
-
const hour = Number(match[4]);
|
|
774
|
-
const minute = Number(match[5]);
|
|
775
|
-
const second = Number(match[6]);
|
|
776
|
-
const offsetHour = Number(match[7] ?? 0);
|
|
777
|
-
const offsetMinute = Number(match[8] ?? 0);
|
|
778
|
-
if (year < 1 ||
|
|
779
|
-
month < 1 ||
|
|
780
|
-
month > 12 ||
|
|
781
|
-
day < 1 ||
|
|
782
|
-
hour > 23 ||
|
|
783
|
-
minute > 59 ||
|
|
784
|
-
second > 59 ||
|
|
785
|
-
offsetHour > 23 ||
|
|
786
|
-
offsetMinute > 59) {
|
|
787
|
-
return false;
|
|
788
|
-
}
|
|
789
|
-
const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
|
|
790
|
-
const daysInMonth = [
|
|
791
|
-
31,
|
|
792
|
-
leapYear ? 29 : 28,
|
|
793
|
-
31,
|
|
794
|
-
30,
|
|
795
|
-
31,
|
|
796
|
-
30,
|
|
797
|
-
31,
|
|
798
|
-
31,
|
|
799
|
-
30,
|
|
800
|
-
31,
|
|
801
|
-
30,
|
|
802
|
-
31,
|
|
803
|
-
][month - 1];
|
|
804
|
-
return day <= daysInMonth;
|
|
634
|
+
return !value.startsWith("0000") && RFC3339_DATE_TIME.test(value);
|
|
805
635
|
}
|
|
806
636
|
function schemaError(filename, errors) {
|
|
807
637
|
const first = errors[0];
|
|
808
|
-
const
|
|
809
|
-
|
|
810
|
-
|
|
811
|
-
: segments
|
|
812
|
-
.map((segment) => {
|
|
813
|
-
if (/^(?:0|[1-9]\d{0,9})$/.test(segment))
|
|
814
|
-
return segment;
|
|
815
|
-
return SAFE_SCHEMA_ERROR_PROPERTIES.has(segment)
|
|
816
|
-
? segment
|
|
817
|
-
: "<property>";
|
|
818
|
-
})
|
|
819
|
-
.join(".");
|
|
638
|
+
const location = first?.instancePath
|
|
639
|
+
? JSON.stringify(first.instancePath)
|
|
640
|
+
: "<root>";
|
|
820
641
|
const keyword = first?.keyword ?? "unknown";
|
|
821
642
|
const count = errors.length;
|
|
822
|
-
return new ContractValidationError(`${filename}:${location}: schema validation failed (${keyword}${keyword === "format" && first?.params["format"] === "date-time" ? "; date-time" : ""}; ${count} ${count === 1 ? "error" : "errors"}).`);
|
|
823
|
-
}
|
|
824
|
-
function sameArray(left, right) {
|
|
825
|
-
return (left.length === right.length &&
|
|
826
|
-
left.every((value, index) => value === right[index]));
|
|
643
|
+
return new ContractValidationError(`${filename}:${location}: schema validation failed (${keyword}${keyword === "format" && first?.params["format"] === "date-time" ? "; date-time" : ""}; ${count} ${count === 1 ? "error" : "errors"})${first?.message ? `: ${first.message}` : ""}.`);
|
|
827
644
|
}
|
|
828
645
|
function nodeErrorCode(error) {
|
|
829
646
|
return typeof error === "object" && error !== null && "code" in error
|
|
@@ -834,4 +651,23 @@ function nodeErrorCode(error) {
|
|
|
834
651
|
export function sha256Text(value) {
|
|
835
652
|
return hash("sha256", value);
|
|
836
653
|
}
|
|
654
|
+
export function deriveFindingIdentity(scanId, targetId, ruleId, identity) {
|
|
655
|
+
const fingerprint = `codex-security/v1:sha256:${sha256Text([
|
|
656
|
+
"codex-security/v1",
|
|
657
|
+
targetId,
|
|
658
|
+
ruleId,
|
|
659
|
+
identity.anchor,
|
|
660
|
+
identity.instance ?? "",
|
|
661
|
+
].join("\0"))}`;
|
|
662
|
+
return {
|
|
663
|
+
findingId: `csf_${sha256Text(fingerprint).slice(0, 24)}`,
|
|
664
|
+
occurrenceId: `occ_${sha256Text([scanId, fingerprint].join("\0")).slice(0, 24)}`,
|
|
665
|
+
ruleId,
|
|
666
|
+
identity,
|
|
667
|
+
fingerprints: {
|
|
668
|
+
algorithm: "codex-security/v1",
|
|
669
|
+
primary: fingerprint,
|
|
670
|
+
},
|
|
671
|
+
};
|
|
672
|
+
}
|
|
837
673
|
//# sourceMappingURL=contract.js.map
|