@openai/codex-security 0.1.31 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +442 -2434
- package/_bundled_plugin/.app.json +5 -1
- package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
- package/_bundled_plugin/.mcp.json +3 -0
- package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
- package/_bundled_plugin/examples/completed-scan/report.md +28 -26
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
- package/_bundled_plugin/mcp/helpers.mjs +1 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +7 -214
- package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
- package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +563 -0
- package/_bundled_plugin/mcp/server.mjs +1 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
- package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
- package/_bundled_plugin/references/artifact-storage.md +5 -5
- package/_bundled_plugin/references/config-preflight.md +1 -5
- package/_bundled_plugin/references/core-scan.md +34 -10
- package/_bundled_plugin/references/final-report.md +13 -13
- package/_bundled_plugin/references/finding-detail-fields.md +90 -80
- package/_bundled_plugin/references/sarif-adapter.md +1 -1
- package/_bundled_plugin/references/scan-artifacts.md +3 -4
- package/_bundled_plugin/references/scan-contract.md +11 -6
- package/_bundled_plugin/references/scan-prologue.md +12 -0
- package/_bundled_plugin/references/security-guidance.md +2 -2
- package/_bundled_plugin/references/standalone-validation.md +11 -0
- package/_bundled_plugin/references/threat-model.md +2 -2
- package/_bundled_plugin/schemas/coverage.schema.json +23 -47
- package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
- package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
- package/_bundled_plugin/schemas/findings.schema.json +71 -192
- package/_bundled_plugin/schemas/scan-manifest.schema.json +83 -95
- package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
- package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
- package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
- package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +245 -356
- package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
- package/_bundled_plugin/scripts/codex_session.mjs +53 -0
- package/_bundled_plugin/scripts/config_preflight.py +29 -69
- package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
- package/_bundled_plugin/scripts/deep_scan_workbench.py +208 -363
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
- package/_bundled_plugin/scripts/finalize_scan_contract.py +733 -375
- package/_bundled_plugin/scripts/finding_preview.py +81 -91
- package/_bundled_plugin/scripts/generate_in_scope_files.py +48 -102
- package/_bundled_plugin/scripts/generate_rank_input.py +117 -888
- package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -6
- package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
- package/_bundled_plugin/scripts/rank_preview.py +43 -902
- package/_bundled_plugin/scripts/report_projection.py +143 -219
- package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
- package/_bundled_plugin/scripts/threat_model_projection.py +161 -0
- package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
- package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
- package/_bundled_plugin/scripts/windows_scan_local_files.py +59 -9
- package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
- package/_bundled_plugin/scripts/workbench/storage.py +21 -6
- package/_bundled_plugin/scripts/workbench_cli.py +99 -190
- package/_bundled_plugin/scripts/workbench_constants.py +6 -14
- package/_bundled_plugin/scripts/workbench_db.py +524 -672
- package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
- package/_bundled_plugin/scripts/workbench_finding_index.py +20 -7
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
- package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
- package/_bundled_plugin/scripts/workbench_native_indexes.py +28 -18
- package/_bundled_plugin/scripts/workbench_progress.py +26 -92
- package/_bundled_plugin/scripts/workbench_publication.py +77 -116
- package/_bundled_plugin/scripts/workbench_remediation.py +14 -20
- package/_bundled_plugin/scripts/workbench_saved_results.py +1402 -263
- package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
- package/_bundled_plugin/scripts/workbench_scan_start.py +109 -52
- package/_bundled_plugin/scripts/workbench_scan_usage.py +30 -49
- package/_bundled_plugin/scripts/workbench_schema.py +71 -1370
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +16 -7
- package/_bundled_plugin/scripts/workbench_target.py +526 -150
- package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
- package/_bundled_plugin/scripts/workbench_validation.py +19 -44
- package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
- package/_bundled_plugin/shared/workbench-migrations.json +397 -0
- package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
- package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
- package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +6 -6
- package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
- package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
- package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
- package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
- package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
- package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
- package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
- package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
- package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
- package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
- package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
- package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
- package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
- package/bin/codex-security.mjs +9 -2
- package/dist/api.d.ts +63 -15
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +970 -553
- package/dist/api.js.map +1 -1
- package/dist/artifact-export.d.ts +70 -0
- package/dist/artifact-export.d.ts.map +1 -0
- package/dist/artifact-export.js +292 -0
- package/dist/artifact-export.js.map +1 -0
- package/dist/auth.d.ts +2 -6
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +27 -12
- package/dist/auth.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts +1 -0
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +9 -9
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/classify-scan-severity.d.ts.map +1 -1
- package/dist/classify-scan-severity.js +2 -5
- package/dist/classify-scan-severity.js.map +1 -1
- package/dist/classify-severity.d.ts +28 -17
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +16 -35
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-help.d.ts +3 -0
- package/dist/cli-help.d.ts.map +1 -0
- package/dist/cli-help.js +285 -0
- package/dist/cli-help.js.map +1 -0
- package/dist/cli-signals.d.ts +8 -0
- package/dist/cli-signals.d.ts.map +1 -0
- package/dist/cli-signals.js +28 -0
- package/dist/cli-signals.js.map +1 -0
- package/dist/cli.d.ts +22 -24
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1660 -1556
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +11 -17
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codeowners.d.ts +19 -0
- package/dist/codeowners.d.ts.map +1 -0
- package/dist/codeowners.js +138 -0
- package/dist/codeowners.js.map +1 -0
- package/dist/codex-prompt.d.ts.map +1 -1
- package/dist/codex-prompt.js +1 -2
- package/dist/codex-prompt.js.map +1 -1
- package/dist/codex-sdk-environment.d.ts +3 -0
- package/dist/codex-sdk-environment.d.ts.map +1 -0
- package/dist/codex-sdk-environment.js +68 -0
- package/dist/codex-sdk-environment.js.map +1 -0
- package/dist/component-plan.d.ts +2 -5
- package/dist/component-plan.d.ts.map +1 -1
- package/dist/component-plan.js +38 -34
- package/dist/component-plan.js.map +1 -1
- package/dist/component-scan.d.ts +7 -5
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +54 -44
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +93 -104
- package/dist/config.js.map +1 -1
- package/dist/contract.d.ts +15 -2
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +124 -348
- package/dist/contract.js.map +1 -1
- package/dist/cost-model.d.ts +13 -6
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +75 -34
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +10 -2
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +116 -134
- package/dist/cost.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +7 -6
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/custom-validation.d.ts +1 -2
- package/dist/custom-validation.d.ts.map +1 -1
- package/dist/custom-validation.js +23 -16
- package/dist/custom-validation.js.map +1 -1
- package/dist/deduplication/checkpointed-review.d.ts +4 -2
- package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
- package/dist/deduplication/checkpointed-review.js +33 -20
- package/dist/deduplication/checkpointed-review.js.map +1 -1
- package/dist/deduplication/codex-review.d.ts +9 -1
- package/dist/deduplication/codex-review.d.ts.map +1 -1
- package/dist/deduplication/codex-review.js +129 -20
- package/dist/deduplication/codex-review.js.map +1 -1
- package/dist/deduplication/deduplication-prompts.d.ts +5 -2
- package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
- package/dist/deduplication/deduplication-prompts.js +18 -4
- package/dist/deduplication/deduplication-prompts.js.map +1 -1
- package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
- package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
- package/dist/deduplication/deduplication-reviewer.js +59 -47
- package/dist/deduplication/deduplication-reviewer.js.map +1 -1
- package/dist/deduplication/deduplication.d.ts.map +1 -1
- package/dist/deduplication/deduplication.js +59 -113
- package/dist/deduplication/deduplication.js.map +1 -1
- package/dist/deduplication/diagnostics.d.ts +17 -0
- package/dist/deduplication/diagnostics.d.ts.map +1 -0
- package/dist/deduplication/diagnostics.js +5 -0
- package/dist/deduplication/diagnostics.js.map +1 -0
- package/dist/deduplication/finding-schema.d.ts.map +1 -1
- package/dist/deduplication/finding-schema.js +7 -1
- package/dist/deduplication/finding-schema.js.map +1 -1
- package/dist/deduplication/local.d.ts +31 -0
- package/dist/deduplication/local.d.ts.map +1 -0
- package/dist/deduplication/local.js +166 -0
- package/dist/deduplication/local.js.map +1 -0
- package/dist/deduplication/records-protocol.d.ts.map +1 -1
- package/dist/deduplication/records-protocol.js +12 -28
- package/dist/deduplication/records-protocol.js.map +1 -1
- package/dist/deduplication/records.d.ts +188 -12
- package/dist/deduplication/records.d.ts.map +1 -1
- package/dist/deduplication/records.js +34 -24
- package/dist/deduplication/records.js.map +1 -1
- package/dist/deduplication/review.d.ts +7 -0
- package/dist/deduplication/review.d.ts.map +1 -1
- package/dist/deduplication/review.js.map +1 -1
- package/dist/deduplication/scan.d.ts +9 -3
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +159 -44
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +2 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +7 -23
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-progress.d.ts +2 -1
- package/dist/deep-progress.d.ts.map +1 -1
- package/dist/deep-progress.js +32 -47
- package/dist/deep-progress.js.map +1 -1
- package/dist/deep-scan.d.ts +20 -0
- package/dist/deep-scan.d.ts.map +1 -0
- package/dist/deep-scan.js +113 -0
- package/dist/deep-scan.js.map +1 -0
- package/dist/errors.d.ts +5 -2
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +7 -7
- package/dist/errors.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +53 -21
- package/dist/feedback.js.map +1 -1
- package/dist/finding-catalogue.d.ts.map +1 -1
- package/dist/finding-catalogue.js +26 -30
- package/dist/finding-catalogue.js.map +1 -1
- package/dist/finding-normalization.d.ts +5 -0
- package/dist/finding-normalization.d.ts.map +1 -0
- package/dist/finding-normalization.js +120 -0
- package/dist/finding-normalization.js.map +1 -0
- package/dist/finding-retrieval.d.ts +9 -0
- package/dist/finding-retrieval.d.ts.map +1 -1
- package/dist/finding-retrieval.js.map +1 -1
- package/dist/finding-workflow.d.ts +13 -8
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +18 -13
- package/dist/finding-workflow.js.map +1 -1
- package/dist/findings-client.d.ts +2 -1
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +36 -9
- package/dist/findings-client.js.map +1 -1
- package/dist/findings-errors.d.ts +16 -0
- package/dist/findings-errors.d.ts.map +1 -0
- package/dist/findings-errors.js +24 -0
- package/dist/findings-errors.js.map +1 -0
- package/dist/findings-import.d.ts +1 -1
- package/dist/findings-import.d.ts.map +1 -1
- package/dist/findings-import.js +16 -44
- package/dist/findings-import.js.map +1 -1
- package/dist/github.d.ts.map +1 -1
- package/dist/github.js +9 -4
- package/dist/github.js.map +1 -1
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +49 -39
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +11 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/knowledge-base.d.ts +7 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +115 -47
- package/dist/knowledge-base.js.map +1 -1
- package/dist/linear.d.ts.map +1 -1
- package/dist/linear.js +4 -10
- package/dist/linear.js.map +1 -1
- package/dist/mock-scan.d.ts.map +1 -1
- package/dist/mock-scan.js +0 -1
- package/dist/mock-scan.js.map +1 -1
- package/dist/models.d.ts +24 -2
- package/dist/models.d.ts.map +1 -1
- package/dist/models.js.map +1 -1
- package/dist/multiscan.d.ts +9 -3
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +225 -153
- package/dist/multiscan.js.map +1 -1
- package/dist/owner-evidence.d.ts +10 -2
- package/dist/owner-evidence.d.ts.map +1 -1
- package/dist/owner-evidence.js +69 -14
- package/dist/owner-evidence.js.map +1 -1
- package/dist/patch-tui.d.ts.map +1 -1
- package/dist/patch-tui.js +5 -6
- package/dist/patch-tui.js.map +1 -1
- package/dist/project-config-schema.d.ts +10 -0
- package/dist/project-config-schema.d.ts.map +1 -1
- package/dist/project-config-schema.js +1 -0
- package/dist/project-config-schema.js.map +1 -1
- package/dist/project-config.d.ts +1 -0
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +5 -3
- package/dist/project-config.js.map +1 -1
- package/dist/prompt-files.d.ts +0 -1
- package/dist/prompt-files.d.ts.map +1 -1
- package/dist/prompt-files.js +2 -4
- package/dist/prompt-files.js.map +1 -1
- package/dist/provider-profile.d.ts +21 -0
- package/dist/provider-profile.d.ts.map +1 -0
- package/dist/provider-profile.js +133 -0
- package/dist/provider-profile.js.map +1 -0
- package/dist/publication-events.d.ts +6 -8
- package/dist/publication-events.d.ts.map +1 -1
- package/dist/publication-events.js +40 -79
- package/dist/publication-events.js.map +1 -1
- package/dist/publication-store.d.ts.map +1 -1
- package/dist/publication-store.js +48 -76
- package/dist/publication-store.js.map +1 -1
- package/dist/publication.d.ts +1 -2
- package/dist/publication.d.ts.map +1 -1
- package/dist/publication.js +7 -16
- package/dist/publication.js.map +1 -1
- package/dist/publish.d.ts +1 -5
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +138 -199
- package/dist/publish.js.map +1 -1
- package/dist/record.d.ts +2 -0
- package/dist/record.d.ts.map +1 -0
- package/dist/record.js +4 -0
- package/dist/record.js.map +1 -0
- package/dist/request-metadata.d.ts +9 -0
- package/dist/request-metadata.d.ts.map +1 -0
- package/dist/request-metadata.js +13 -0
- package/dist/request-metadata.js.map +1 -0
- package/dist/result.d.ts +4 -1
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +7 -0
- package/dist/result.js.map +1 -1
- package/dist/runtime.d.ts +25 -17
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +619 -255
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +14 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -0
- package/dist/saved-scan-bootstrap.js +261 -0
- package/dist/saved-scan-bootstrap.js.map +1 -0
- package/dist/saved-scan.d.ts +1 -1
- package/dist/saved-scan.d.ts.map +1 -1
- package/dist/saved-scan.js +16 -32
- package/dist/saved-scan.js.map +1 -1
- package/dist/scan-activity.d.ts.map +1 -1
- package/dist/scan-activity.js +19 -30
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +31 -18
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +307 -347
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +3 -1
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +351 -92
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +55 -15
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-inputs.d.ts +6 -0
- package/dist/scan-inputs.d.ts.map +1 -0
- package/dist/scan-inputs.js +71 -0
- package/dist/scan-inputs.js.map +1 -0
- package/dist/scan-logs.d.ts +2 -3
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +14 -12
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-sessions.d.ts +4 -0
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +18 -3
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-settings.d.ts +5 -0
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +4 -0
- package/dist/scan-settings.js.map +1 -1
- package/dist/scan-skill-paths.d.ts +8 -0
- package/dist/scan-skill-paths.d.ts.map +1 -0
- package/dist/scan-skill-paths.js +47 -0
- package/dist/scan-skill-paths.js.map +1 -0
- package/dist/security-policy-cli.d.ts.map +1 -1
- package/dist/security-policy-cli.js +15 -33
- package/dist/security-policy-cli.js.map +1 -1
- package/dist/security-policy.d.ts +17 -9
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js +131 -98
- package/dist/security-policy.js.map +1 -1
- package/dist/server/api.d.ts +0 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js +0 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embeddings.d.ts +3 -1
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +11 -3
- package/dist/server/embeddings.js.map +1 -1
- package/dist/server/errors.d.ts +5 -2
- package/dist/server/errors.d.ts.map +1 -1
- package/dist/server/errors.js +7 -0
- package/dist/server/errors.js.map +1 -1
- package/dist/server/sqlite-store.d.ts +0 -2
- package/dist/server/sqlite-store.d.ts.map +1 -1
- package/dist/server/sqlite-store.js +55 -55
- package/dist/server/sqlite-store.js.map +1 -1
- package/dist/server/storage.d.ts +0 -2
- package/dist/server/storage.d.ts.map +1 -1
- package/dist/server/storage.js.map +1 -1
- package/dist/severity-store.js +20 -32
- package/dist/severity-store.js.map +1 -1
- package/dist/standalone-validation-prompt.d.ts +2 -0
- package/dist/standalone-validation-prompt.d.ts.map +1 -0
- package/dist/standalone-validation-prompt.js +10 -0
- package/dist/standalone-validation-prompt.js.map +1 -0
- package/dist/suggest-owners.d.ts +6 -5
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +15 -10
- package/dist/suggest-owners.js.map +1 -1
- package/dist/targets.d.ts +12 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +124 -62
- package/dist/targets.js.map +1 -1
- package/dist/trusted-executable.d.ts +6 -1
- package/dist/trusted-executable.d.ts.map +1 -1
- package/dist/trusted-executable.js +28 -9
- package/dist/trusted-executable.js.map +1 -1
- package/dist/value.d.ts +2 -0
- package/dist/value.d.ts.map +1 -0
- package/dist/value.js +27 -0
- package/dist/value.js.map +1 -0
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +3 -6
- package/dist/version.js.map +1 -1
- package/dist/windows-path.d.ts.map +1 -1
- package/dist/windows-path.js +1 -2
- package/dist/windows-path.js.map +1 -1
- package/dist/workbench-arguments.d.ts +3 -0
- package/dist/workbench-arguments.d.ts.map +1 -0
- package/dist/workbench-arguments.js +15 -0
- package/dist/workbench-arguments.js.map +1 -0
- package/dist/worker-progress.d.ts +2 -0
- package/dist/worker-progress.d.ts.map +1 -1
- package/dist/worker-progress.js +40 -46
- package/dist/worker-progress.js.map +1 -1
- package/docs/cli.md +1778 -0
- package/docs/dedupe-records.md +24 -0
- package/docs/findings-service.md +402 -0
- package/package.json +23 -23
- package/schemas/project-config.schema.json +5 -0
- package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
- package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
- package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
- package/_bundled_plugin/scripts/workbench_findings.py +0 -221
- package/_bundled_plugin/scripts/workbench_severity.py +0 -119
- package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
- package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
- package/dist/server/dashboard/app.css +0 -2
- package/dist/server/dashboard/app.js +0 -66
- package/dist/server/dashboard/index.html +0 -18
- package/dist/server/dashboard-types.d.ts +0 -48
- package/dist/server/dashboard-types.d.ts.map +0 -1
- package/dist/server/dashboard-types.js +0 -2
- package/dist/server/dashboard-types.js.map +0 -1
- package/dist/server/dashboard.d.ts +0 -6
- package/dist/server/dashboard.d.ts.map +0 -1
- package/dist/server/dashboard.js +0 -59
- package/dist/server/dashboard.js.map +0 -1
- package/dist/server/findings-service.d.ts +0 -20
- package/dist/server/findings-service.d.ts.map +0 -1
- package/dist/server/findings-service.js +0 -31
- package/dist/server/findings-service.js.map +0 -1
- package/dist/server/index.d.ts +0 -2
- package/dist/server/index.d.ts.map +0 -1
- package/dist/server/index.js +0 -6
- package/dist/server/index.js.map +0 -1
- package/dist/server/routes.d.ts +0 -6
- package/dist/server/routes.d.ts.map +0 -1
- package/dist/server/routes.js +0 -86
- package/dist/server/routes.js.map +0 -1
- package/dist/server/serve.d.ts +0 -2
- package/dist/server/serve.d.ts.map +0 -1
- package/dist/server/serve.js +0 -28
- package/dist/server/serve.js.map +0 -1
- package/dist/server/server.d.ts +0 -10
- package/dist/server/server.d.ts.map +0 -1
- package/dist/server/server.js +0 -17
- package/dist/server/server.js.map +0 -1
- package/dist/server/validation.d.ts +0 -17
- package/dist/server/validation.d.ts.map +0 -1
- package/dist/server/validation.js +0 -53
- package/dist/server/validation.js.map +0 -1
package/dist/contract.js
CHANGED
|
@@ -1,10 +1,15 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { isDeepStrictEqual as sameArray } from "node:util";
|
|
2
|
+
import { createHash, hash } from "node:crypto";
|
|
3
|
+
import { normalizePersistedFindingDetails } from "./finding-normalization.js";
|
|
2
4
|
import { constants } from "node:fs";
|
|
3
5
|
import { lstat, open, readFile, realpath, } from "node:fs/promises";
|
|
4
|
-
import { isAbsolute, join, posix,
|
|
6
|
+
import { isAbsolute, join, posix, resolve } from "node:path";
|
|
5
7
|
import Ajv2020 from "ajv/dist/2020.js";
|
|
6
|
-
import {
|
|
8
|
+
import { regexes } from "zod";
|
|
9
|
+
import { ContractValidationError, abortReason } from "./errors.js";
|
|
10
|
+
import { isRecord } from "./record.js";
|
|
7
11
|
import { requirePrivateOutputDirectory, requireSecureOutputAncestry, } from "./runtime.js";
|
|
12
|
+
import { isWithin as isContained } from "./trusted-executable.js";
|
|
8
13
|
import { isWindowsUnsafePathComponent } from "./windows-path.js";
|
|
9
14
|
const DOCUMENTS = {
|
|
10
15
|
"scan-manifest.json": "scan-manifest.schema.json",
|
|
@@ -12,17 +17,6 @@ const DOCUMENTS = {
|
|
|
12
17
|
"coverage.json": "coverage.schema.json",
|
|
13
18
|
};
|
|
14
19
|
const PRODUCER_NAME = "codex-security-plugin";
|
|
15
|
-
const SAFE_SCHEMA_ERROR_PROPERTIES = new Set([
|
|
16
|
-
"scan",
|
|
17
|
-
"target",
|
|
18
|
-
"remote",
|
|
19
|
-
"completedAt",
|
|
20
|
-
"sealedAt",
|
|
21
|
-
"artifacts",
|
|
22
|
-
"findings",
|
|
23
|
-
"coverage",
|
|
24
|
-
"scope",
|
|
25
|
-
]);
|
|
26
20
|
export async function loadContract(scanDirectory, options) {
|
|
27
21
|
return (await loadContractWithScanDirectory(scanDirectory, options)).contract;
|
|
28
22
|
}
|
|
@@ -30,40 +24,34 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
|
|
|
30
24
|
const scanRoot = await requireScanRoot(scanDirectory, options.signal);
|
|
31
25
|
const scanDir = scanRoot.path;
|
|
32
26
|
const documentDigests = new Map();
|
|
33
|
-
const payloads = {
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
};
|
|
27
|
+
const payloads = {};
|
|
28
|
+
for (const filename of Object.keys(DOCUMENTS)) {
|
|
29
|
+
payloads[filename] = await readScanJson(scanDir, filename, documentDigests, options.signal, scanRoot);
|
|
30
|
+
}
|
|
38
31
|
throwIfAborted(options.signal);
|
|
39
|
-
|
|
40
|
-
|
|
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 });
|
|
41
36
|
for (const [filename, schemaName] of Object.entries(DOCUMENTS)) {
|
|
42
37
|
const schema = await readJson(join(options.pluginRoot, "schemas", schemaName), options.signal);
|
|
43
38
|
let validate;
|
|
44
|
-
|
|
45
|
-
validate = ajv.compile(schema);
|
|
46
|
-
}
|
|
47
|
-
catch {
|
|
48
|
-
throw new ContractValidationError(`${schemaName}: invalid JSON Schema.`);
|
|
49
|
-
}
|
|
50
|
-
let payload = filename === "findings.json"
|
|
51
|
-
? findingsPayload
|
|
52
|
-
: payloads[filename];
|
|
39
|
+
let payload;
|
|
53
40
|
let valid;
|
|
54
41
|
try {
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
if (!valid && filename === "findings.json") {
|
|
61
|
-
payload = legacySealedFindingsForValidation(payload);
|
|
62
|
-
const compatibleResult = validate(payload);
|
|
63
|
-
if (typeof compatibleResult !== "boolean") {
|
|
42
|
+
validate = ajv.compile(schema);
|
|
43
|
+
payload = payloads[filename];
|
|
44
|
+
const validatePayload = (payload) => {
|
|
45
|
+
const result = validate(payload);
|
|
46
|
+
if (typeof result !== "boolean") {
|
|
64
47
|
throw new Error("asynchronous JSON Schema validation is unsupported");
|
|
65
48
|
}
|
|
66
|
-
|
|
49
|
+
return result;
|
|
50
|
+
};
|
|
51
|
+
valid = validatePayload(payload);
|
|
52
|
+
if (!valid && filename === "findings.json") {
|
|
53
|
+
payload = normalizePersistedFindings(payload);
|
|
54
|
+
valid = validatePayload(payload);
|
|
67
55
|
}
|
|
68
56
|
}
|
|
69
57
|
catch {
|
|
@@ -72,12 +60,11 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
|
|
|
72
60
|
if (!valid) {
|
|
73
61
|
throw schemaError(filename, validate.errors ?? []);
|
|
74
62
|
}
|
|
75
|
-
|
|
76
|
-
findingsPayload = payload;
|
|
63
|
+
payloads[filename] = payload;
|
|
77
64
|
throwIfAborted(options.signal);
|
|
78
65
|
}
|
|
79
66
|
const manifest = payloads["scan-manifest.json"];
|
|
80
|
-
const findings =
|
|
67
|
+
const findings = payloads["findings.json"];
|
|
81
68
|
const coverage = payloads["coverage.json"];
|
|
82
69
|
if (options.expectedScanId !== undefined &&
|
|
83
70
|
manifest.scan.id !== options.expectedScanId) {
|
|
@@ -104,192 +91,19 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
|
|
|
104
91
|
scanDirectory: scanRoot.path,
|
|
105
92
|
};
|
|
106
93
|
}
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
}
|
|
110
|
-
function legacySealedFindingsForValidation(payload) {
|
|
94
|
+
/** Normalize optional legacy details on a copy, without changing saved artifacts. */
|
|
95
|
+
function normalizePersistedFindings(payload) {
|
|
111
96
|
const compatible = structuredClone(payload);
|
|
112
|
-
if (!
|
|
97
|
+
if (!isRecord(compatible) || !Array.isArray(compatible["findings"])) {
|
|
113
98
|
return compatible;
|
|
114
99
|
}
|
|
115
100
|
for (const finding of compatible["findings"]) {
|
|
116
|
-
if (!
|
|
117
|
-
continue;
|
|
118
|
-
const legacyEvidence = finding["code_evidence"];
|
|
119
|
-
if (Array.isArray(legacyEvidence)) {
|
|
120
|
-
const compatibleEvidence = [];
|
|
121
|
-
for (const evidence of legacyEvidence) {
|
|
122
|
-
if (!isJsonRecord(evidence))
|
|
123
|
-
continue;
|
|
124
|
-
const id = evidence["id"];
|
|
125
|
-
const code = evidence["code"];
|
|
126
|
-
if (typeof id !== "string" ||
|
|
127
|
-
id.length === 0 ||
|
|
128
|
-
typeof code !== "string" ||
|
|
129
|
-
code.length === 0) {
|
|
130
|
-
continue;
|
|
131
|
-
}
|
|
132
|
-
compatibleEvidence.push(evidence);
|
|
133
|
-
}
|
|
134
|
-
finding["code_evidence"] = compatibleEvidence;
|
|
135
|
-
}
|
|
136
|
-
else if ("code_evidence" in finding && legacyEvidence !== null) {
|
|
137
|
-
delete finding["code_evidence"];
|
|
138
|
-
}
|
|
139
|
-
for (const [sectionName, listFields] of [
|
|
140
|
-
["root_cause", ["evidenceRefs", "evidence_refs"]],
|
|
141
|
-
[
|
|
142
|
-
"validation",
|
|
143
|
-
[
|
|
144
|
-
"assertions",
|
|
145
|
-
"counterEvidence",
|
|
146
|
-
"evidenceRefs",
|
|
147
|
-
"evidence_refs",
|
|
148
|
-
"limitations",
|
|
149
|
-
],
|
|
150
|
-
],
|
|
151
|
-
[
|
|
152
|
-
"attackPath",
|
|
153
|
-
[
|
|
154
|
-
"assumptions",
|
|
155
|
-
"blindspots",
|
|
156
|
-
"controls",
|
|
157
|
-
"evidenceRefs",
|
|
158
|
-
"evidence_refs",
|
|
159
|
-
"limitations",
|
|
160
|
-
"preconditions",
|
|
161
|
-
"steps",
|
|
162
|
-
],
|
|
163
|
-
],
|
|
164
|
-
]) {
|
|
165
|
-
const section = finding[sectionName];
|
|
166
|
-
if (!isJsonRecord(section))
|
|
167
|
-
continue;
|
|
168
|
-
normalizeLegacyStringLists(section, listFields);
|
|
169
|
-
}
|
|
170
|
-
const legacyRootCause = finding["root_cause"];
|
|
171
|
-
if (isJsonRecord(legacyRootCause)) {
|
|
172
|
-
removeUnsupportedLegacyStrings(legacyRootCause, [
|
|
173
|
-
"summary",
|
|
174
|
-
"code",
|
|
175
|
-
"language",
|
|
176
|
-
]);
|
|
177
|
-
}
|
|
178
|
-
else if ("root_cause" in finding &&
|
|
179
|
-
legacyRootCause !== null &&
|
|
180
|
-
typeof legacyRootCause !== "string") {
|
|
181
|
-
delete finding["root_cause"];
|
|
182
|
-
}
|
|
183
|
-
const validation = finding["validation"];
|
|
184
|
-
if (isJsonRecord(validation)) {
|
|
185
|
-
normalizeLegacyStringOrList(validation, "evidence");
|
|
186
|
-
removeUnsupportedLegacyStrings(validation, ["method", "summary"]);
|
|
187
|
-
removeUnsupportedLegacyNullableStrings(validation, [
|
|
188
|
-
"status",
|
|
189
|
-
"disposition",
|
|
190
|
-
"result",
|
|
191
|
-
]);
|
|
192
|
-
}
|
|
193
|
-
const attackPath = finding["attackPath"];
|
|
194
|
-
if (!isJsonRecord(attackPath))
|
|
101
|
+
if (!isRecord(finding))
|
|
195
102
|
continue;
|
|
196
|
-
|
|
197
|
-
for (const field of ["dataFlow", "data_flow", "dataflow", "reachability"]) {
|
|
198
|
-
const detail = attackPath[field];
|
|
199
|
-
if (detail === null) {
|
|
200
|
-
delete attackPath[field];
|
|
201
|
-
continue;
|
|
202
|
-
}
|
|
203
|
-
if (typeof detail === "string") {
|
|
204
|
-
if (detail.length === 0)
|
|
205
|
-
delete attackPath[field];
|
|
206
|
-
continue;
|
|
207
|
-
}
|
|
208
|
-
if (!isJsonRecord(detail)) {
|
|
209
|
-
if (field in attackPath)
|
|
210
|
-
delete attackPath[field];
|
|
211
|
-
continue;
|
|
212
|
-
}
|
|
213
|
-
removeUnsupportedLegacyStrings(detail, [
|
|
214
|
-
"summary",
|
|
215
|
-
"source",
|
|
216
|
-
"sink",
|
|
217
|
-
"outcome",
|
|
218
|
-
...(field === "reachability" ? ["attacker", "entrypoint"] : []),
|
|
219
|
-
]);
|
|
220
|
-
normalizeLegacyStringLists(detail, [
|
|
221
|
-
"evidenceRefs",
|
|
222
|
-
"evidence_refs",
|
|
223
|
-
"transformations",
|
|
224
|
-
...(field === "reachability" ? ["preconditions"] : []),
|
|
225
|
-
]);
|
|
226
|
-
}
|
|
227
|
-
for (const field of ["impact", "likelihood"]) {
|
|
228
|
-
const detail = attackPath[field];
|
|
229
|
-
if (isJsonRecord(detail)) {
|
|
230
|
-
removeUnsupportedLegacyStrings(detail, ["level", "rationale", "why"]);
|
|
231
|
-
}
|
|
232
|
-
else if (detail !== undefined &&
|
|
233
|
-
detail !== null &&
|
|
234
|
-
(typeof detail !== "string" || detail.length === 0)) {
|
|
235
|
-
delete attackPath[field];
|
|
236
|
-
}
|
|
237
|
-
}
|
|
103
|
+
normalizePersistedFindingDetails(finding);
|
|
238
104
|
}
|
|
239
105
|
return compatible;
|
|
240
106
|
}
|
|
241
|
-
function isJsonRecord(value) {
|
|
242
|
-
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
243
|
-
}
|
|
244
|
-
function normalizeLegacyStringLists(section, fields) {
|
|
245
|
-
for (const field of fields) {
|
|
246
|
-
if (!(field in section))
|
|
247
|
-
continue;
|
|
248
|
-
const value = section[field];
|
|
249
|
-
if (Array.isArray(value)) {
|
|
250
|
-
section[field] = value.filter((item) => typeof item === "string" && item.length > 0);
|
|
251
|
-
}
|
|
252
|
-
else if (typeof value === "string" && value.length > 0) {
|
|
253
|
-
section[field] = [value];
|
|
254
|
-
}
|
|
255
|
-
else {
|
|
256
|
-
delete section[field];
|
|
257
|
-
}
|
|
258
|
-
}
|
|
259
|
-
}
|
|
260
|
-
function normalizeLegacyStringOrList(section, field) {
|
|
261
|
-
if (!(field in section))
|
|
262
|
-
return;
|
|
263
|
-
const value = section[field];
|
|
264
|
-
if (typeof value === "string") {
|
|
265
|
-
if (value.length === 0)
|
|
266
|
-
delete section[field];
|
|
267
|
-
return;
|
|
268
|
-
}
|
|
269
|
-
if (!Array.isArray(value)) {
|
|
270
|
-
delete section[field];
|
|
271
|
-
return;
|
|
272
|
-
}
|
|
273
|
-
const normalized = value.filter((item) => typeof item === "string" && item.length > 0);
|
|
274
|
-
section[field] = normalized;
|
|
275
|
-
}
|
|
276
|
-
function removeUnsupportedLegacyStrings(section, fields) {
|
|
277
|
-
for (const field of fields) {
|
|
278
|
-
if (field in section &&
|
|
279
|
-
(typeof section[field] !== "string" || section[field].length === 0)) {
|
|
280
|
-
delete section[field];
|
|
281
|
-
}
|
|
282
|
-
}
|
|
283
|
-
}
|
|
284
|
-
function removeUnsupportedLegacyNullableStrings(section, fields) {
|
|
285
|
-
for (const field of fields) {
|
|
286
|
-
if (field in section &&
|
|
287
|
-
section[field] !== null &&
|
|
288
|
-
(typeof section[field] !== "string" || section[field].length === 0)) {
|
|
289
|
-
delete section[field];
|
|
290
|
-
}
|
|
291
|
-
}
|
|
292
|
-
}
|
|
293
107
|
function validateCanonicalContract(manifest, findings) {
|
|
294
108
|
const remote = manifest.scan.target.remote;
|
|
295
109
|
if (remote !== undefined) {
|
|
@@ -327,8 +141,29 @@ function validateCanonicalContract(manifest, findings) {
|
|
|
327
141
|
}
|
|
328
142
|
}
|
|
329
143
|
}
|
|
144
|
+
const findingIds = new Set();
|
|
330
145
|
for (const [findingIndex, finding] of findings.findings.entries()) {
|
|
331
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
|
+
}
|
|
332
167
|
for (const [locationIndex, location] of finding.locations.entries()) {
|
|
333
168
|
const locationContext = `${context}.locations[${locationIndex}]`;
|
|
334
169
|
try {
|
|
@@ -337,30 +172,22 @@ function validateCanonicalContract(manifest, findings) {
|
|
|
337
172
|
catch (error) {
|
|
338
173
|
throw new ContractValidationError(`${locationContext}.path: expected a safe repository-relative POSIX path.`, { cause: error });
|
|
339
174
|
}
|
|
175
|
+
if ((location.endLine ?? location.startLine) < location.startLine) {
|
|
176
|
+
throw new ContractValidationError(`${locationContext}.endLine: expected an integer >= startLine.`);
|
|
177
|
+
}
|
|
340
178
|
}
|
|
341
|
-
const
|
|
342
|
-
"codex-security/v1",
|
|
343
|
-
manifest.scan.target.targetId,
|
|
344
|
-
finding.ruleId,
|
|
345
|
-
finding.identity.anchor,
|
|
346
|
-
finding.identity.instance ?? "",
|
|
347
|
-
].join("\0"))}`;
|
|
348
|
-
const findingId = `csf_${sha256Text(fingerprint).slice(0, 24)}`;
|
|
349
|
-
const occurrenceId = `occ_${sha256Text([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);
|
|
350
180
|
if (finding.findingId !== findingId) {
|
|
351
181
|
throw new ContractValidationError(`${context}.findingId: does not match derived fingerprint identity.`);
|
|
352
182
|
}
|
|
353
183
|
if (finding.occurrenceId !== occurrenceId) {
|
|
354
184
|
throw new ContractValidationError(`${context}.occurrenceId: does not match scan occurrence identity.`);
|
|
355
185
|
}
|
|
356
|
-
if (finding.fingerprints.primary !==
|
|
186
|
+
if (finding.fingerprints.primary !== fingerprints.primary) {
|
|
357
187
|
throw new ContractValidationError(`${context}.fingerprints: does not match derived fingerprint.`);
|
|
358
188
|
}
|
|
359
189
|
}
|
|
360
190
|
}
|
|
361
|
-
function sha256Text(value) {
|
|
362
|
-
return createHash("sha256").update(value, "utf8").digest("hex");
|
|
363
|
-
}
|
|
364
191
|
export async function requireScanFile(scanDirectory, relativePath, context, signal) {
|
|
365
192
|
return (await requireCheckedScanFile(scanDirectory, relativePath, context, signal)).path;
|
|
366
193
|
}
|
|
@@ -390,15 +217,11 @@ async function requireCheckedScanFile(scanDirectory, relativePath, context, sign
|
|
|
390
217
|
}
|
|
391
218
|
const parents = [{ path: scanDir, metadata: rootMetadata }];
|
|
392
219
|
throwIfAborted(signal);
|
|
393
|
-
if (!parents[0].metadata.isDirectory() ||
|
|
394
|
-
parents[0].metadata.isSymbolicLink()) {
|
|
395
|
-
throw new Error("unsafe scan directory");
|
|
396
|
-
}
|
|
397
220
|
for (const part of parts.slice(0, -1)) {
|
|
398
221
|
current = join(current, part);
|
|
399
222
|
const metadata = await lstat(current);
|
|
400
223
|
throwIfAborted(signal);
|
|
401
|
-
if (
|
|
224
|
+
if (!metadata.isDirectory()) {
|
|
402
225
|
throw new Error("unsafe parent");
|
|
403
226
|
}
|
|
404
227
|
parents.push({ path: current, metadata });
|
|
@@ -406,7 +229,7 @@ async function requireCheckedScanFile(scanDirectory, relativePath, context, sign
|
|
|
406
229
|
const path = join(scanDir, ...parts);
|
|
407
230
|
const metadata = await lstat(path);
|
|
408
231
|
throwIfAborted(signal);
|
|
409
|
-
if (
|
|
232
|
+
if (!metadata.isFile()) {
|
|
410
233
|
throw new ContractValidationError(`${context}: expected a regular non-symlink file.`);
|
|
411
234
|
}
|
|
412
235
|
const canonical = await realpath(path);
|
|
@@ -449,18 +272,29 @@ async function validateSeal(scanDir, manifest, findings, coverage, documentDiges
|
|
|
449
272
|
throw new ContractValidationError(`${context}: sealed artifact changed or is missing.`);
|
|
450
273
|
}
|
|
451
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
|
+
};
|
|
452
288
|
for (const surface of coverage.surfaces) {
|
|
453
289
|
for (const receipt of surface.receiptRefs) {
|
|
454
|
-
|
|
455
|
-
const normalized = portableRelativePath(receipt, "coverage receipt");
|
|
456
|
-
if (!normalized.startsWith("artifacts/")) {
|
|
457
|
-
throw new ContractValidationError(`Coverage receipt must be under artifacts/: ${receipt}`);
|
|
458
|
-
}
|
|
459
|
-
if (!artifactPaths.has(normalized)) {
|
|
460
|
-
throw new ContractValidationError(`Coverage receipt is missing from sealed artifacts: ${receipt}`);
|
|
461
|
-
}
|
|
290
|
+
requireSealedReference(receipt, "Coverage receipt");
|
|
462
291
|
}
|
|
463
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
|
+
}
|
|
464
298
|
for (const [index, finding] of findings.findings.entries()) {
|
|
465
299
|
const writeup = finding.writeup;
|
|
466
300
|
if (writeup === undefined)
|
|
@@ -510,11 +344,14 @@ function validateExpectation(manifest, coverage, expectation, workbenchValidated
|
|
|
510
344
|
}
|
|
511
345
|
}
|
|
512
346
|
if (requested.kind === "paths") {
|
|
513
|
-
const
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
347
|
+
const actualPaths = scan.scope.includePaths.map(safeScopePath);
|
|
348
|
+
const actual = new Set(actualPaths);
|
|
349
|
+
if (actualPaths.length === actual.size) {
|
|
350
|
+
const expected = new Set(requested.paths);
|
|
351
|
+
if (actual.size === expected.size && actual.isSubsetOf(expected))
|
|
352
|
+
return;
|
|
517
353
|
}
|
|
354
|
+
throw new ContractValidationError("Manifest include paths do not match the requested path target.");
|
|
518
355
|
}
|
|
519
356
|
}
|
|
520
357
|
function expectedCoverageMode(target, mode) {
|
|
@@ -539,13 +376,10 @@ async function requireScanRoot(scanDirectory, signal) {
|
|
|
539
376
|
const returned = await lstat(canonical);
|
|
540
377
|
throwIfAborted(signal);
|
|
541
378
|
if (!metadata.isDirectory() ||
|
|
542
|
-
metadata.isSymbolicLink() ||
|
|
543
379
|
!current.isDirectory() ||
|
|
544
|
-
current.isSymbolicLink() ||
|
|
545
380
|
metadata.dev !== current.dev ||
|
|
546
381
|
metadata.ino !== current.ino ||
|
|
547
382
|
!returned.isDirectory() ||
|
|
548
|
-
returned.isSymbolicLink() ||
|
|
549
383
|
metadata.dev !== returned.dev ||
|
|
550
384
|
metadata.ino !== returned.ino) {
|
|
551
385
|
throw new Error("not a directory");
|
|
@@ -573,7 +407,6 @@ async function verifyScanRoot(root, signal) {
|
|
|
573
407
|
const current = await lstat(root.path);
|
|
574
408
|
throwIfAborted(signal);
|
|
575
409
|
if (!current.isDirectory() ||
|
|
576
|
-
current.isSymbolicLink() ||
|
|
577
410
|
current.dev !== root.metadata.dev ||
|
|
578
411
|
current.ino !== root.metadata.ino) {
|
|
579
412
|
throw new Error("scan directory changed while reading");
|
|
@@ -589,7 +422,7 @@ async function verifyScanRoot(root, signal) {
|
|
|
589
422
|
function safeRelativePath(value, context) {
|
|
590
423
|
const parts = value.split("/");
|
|
591
424
|
if (value.trim().length === 0 ||
|
|
592
|
-
|
|
425
|
+
Buffer.from(value, "utf8").toString("utf8") !== value ||
|
|
593
426
|
value === "." ||
|
|
594
427
|
value.startsWith("/") ||
|
|
595
428
|
/^[A-Za-z]:/.test(value) ||
|
|
@@ -622,7 +455,7 @@ async function readScanJson(scanDir, relativePath, documentDigests, signal, expe
|
|
|
622
455
|
const file = await openCheckedScanFile(scanDir, relativePath, relativePath, signal, expectedRoot);
|
|
623
456
|
try {
|
|
624
457
|
const bytes = await file.readFile({ signal });
|
|
625
|
-
documentDigests.set(relativePath,
|
|
458
|
+
documentDigests.set(relativePath, hash("sha256", bytes));
|
|
626
459
|
return parseJson(join(scanDir, relativePath), bytes);
|
|
627
460
|
}
|
|
628
461
|
catch (error) {
|
|
@@ -685,7 +518,7 @@ function validateParsedJson(value, context) {
|
|
|
685
518
|
return;
|
|
686
519
|
}
|
|
687
520
|
if (typeof value === "string") {
|
|
688
|
-
if (!
|
|
521
|
+
if (!value.isWellFormed()) {
|
|
689
522
|
throw new ContractValidationError(`${context}: expected well-formed Unicode JSON strings.`);
|
|
690
523
|
}
|
|
691
524
|
return;
|
|
@@ -698,27 +531,13 @@ function validateParsedJson(value, context) {
|
|
|
698
531
|
}
|
|
699
532
|
if (isRecord(value)) {
|
|
700
533
|
for (const [key, item] of Object.entries(value)) {
|
|
701
|
-
if (!
|
|
534
|
+
if (!key.isWellFormed()) {
|
|
702
535
|
throw new ContractValidationError(`${context}: expected well-formed Unicode JSON keys.`);
|
|
703
536
|
}
|
|
704
|
-
validateParsedJson(item, `${context}
|
|
537
|
+
validateParsedJson(item, `${context}[${JSON.stringify(key)}]`);
|
|
705
538
|
}
|
|
706
539
|
}
|
|
707
540
|
}
|
|
708
|
-
function isWellFormedUnicode(value) {
|
|
709
|
-
return Buffer.from(value, "utf8").toString("utf8") === value;
|
|
710
|
-
}
|
|
711
|
-
function createValidator() {
|
|
712
|
-
// The plugin schemas are the immutable v0 contract. They are valid Draft
|
|
713
|
-
// 2020-12 but intentionally omit redundant local `type` keywords that Ajv's
|
|
714
|
-
// optional strict-schema linter requires.
|
|
715
|
-
const ajv = new Ajv2020({ allErrors: false, strict: false });
|
|
716
|
-
ajv.addFormat("date-time", {
|
|
717
|
-
type: "string",
|
|
718
|
-
validate: validRfc3339DateTime,
|
|
719
|
-
});
|
|
720
|
-
return ajv;
|
|
721
|
-
}
|
|
722
541
|
async function sha256ScanFile(scanDir, relativePath, context, signal, expectedRoot) {
|
|
723
542
|
const file = await openCheckedScanFile(scanDir, relativePath, context, signal, expectedRoot);
|
|
724
543
|
try {
|
|
@@ -755,7 +574,6 @@ async function openCheckedScanFile(scanDir, relativePath, context, signal, expec
|
|
|
755
574
|
const current = await lstat(parent.path);
|
|
756
575
|
throwIfAborted(signal);
|
|
757
576
|
if (!current.isDirectory() ||
|
|
758
|
-
current.isSymbolicLink() ||
|
|
759
577
|
current.dev !== parent.metadata.dev ||
|
|
760
578
|
current.ino !== parent.metadata.ino) {
|
|
761
579
|
throw new ContractValidationError(`${context}: checked parent changed before opening the file.`);
|
|
@@ -764,7 +582,6 @@ async function openCheckedScanFile(scanDir, relativePath, context, signal, expec
|
|
|
764
582
|
const current = await lstat(checked.path);
|
|
765
583
|
throwIfAborted(signal);
|
|
766
584
|
if (!current.isFile() ||
|
|
767
|
-
current.isSymbolicLink() ||
|
|
768
585
|
current.dev !== checked.metadata.dev ||
|
|
769
586
|
current.ino !== checked.metadata.ino) {
|
|
770
587
|
throw new ContractValidationError(`${context}: checked file changed before reading.`);
|
|
@@ -792,7 +609,6 @@ export async function sameCheckedFileDevice(file, checked, opened, platform = pr
|
|
|
792
609
|
]);
|
|
793
610
|
if (!openedIdentity.isFile() ||
|
|
794
611
|
!checkedIdentity.isFile() ||
|
|
795
|
-
checkedIdentity.isSymbolicLink() ||
|
|
796
612
|
openedIdentity.ino !== checkedIdentity.ino) {
|
|
797
613
|
return false;
|
|
798
614
|
}
|
|
@@ -810,87 +626,47 @@ export async function sameCheckedFileDevice(file, checked, opened, platform = pr
|
|
|
810
626
|
function throwIfAborted(signal) {
|
|
811
627
|
if (!signal?.aborted)
|
|
812
628
|
return;
|
|
813
|
-
throw (signal
|
|
814
|
-
new DOMException("The operation was aborted.", "AbortError"));
|
|
629
|
+
throw abortReason(signal);
|
|
815
630
|
}
|
|
631
|
+
const RFC3339_DATE_TIME = new RegExp(regexes.datetime({ offset: true }).source, "i");
|
|
816
632
|
function validRfc3339DateTime(value) {
|
|
817
|
-
|
|
818
|
-
if (match === null)
|
|
819
|
-
return false;
|
|
820
|
-
const year = Number(match[1]);
|
|
821
|
-
const month = Number(match[2]);
|
|
822
|
-
const day = Number(match[3]);
|
|
823
|
-
const hour = Number(match[4]);
|
|
824
|
-
const minute = Number(match[5]);
|
|
825
|
-
const second = Number(match[6]);
|
|
826
|
-
const offsetHour = Number(match[7] ?? 0);
|
|
827
|
-
const offsetMinute = Number(match[8] ?? 0);
|
|
828
|
-
if (year < 1 ||
|
|
829
|
-
month < 1 ||
|
|
830
|
-
month > 12 ||
|
|
831
|
-
day < 1 ||
|
|
832
|
-
hour > 23 ||
|
|
833
|
-
minute > 59 ||
|
|
834
|
-
second > 59 ||
|
|
835
|
-
offsetHour > 23 ||
|
|
836
|
-
offsetMinute > 59) {
|
|
837
|
-
return false;
|
|
838
|
-
}
|
|
839
|
-
const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
|
|
840
|
-
const daysInMonth = [
|
|
841
|
-
31,
|
|
842
|
-
leapYear ? 29 : 28,
|
|
843
|
-
31,
|
|
844
|
-
30,
|
|
845
|
-
31,
|
|
846
|
-
30,
|
|
847
|
-
31,
|
|
848
|
-
31,
|
|
849
|
-
30,
|
|
850
|
-
31,
|
|
851
|
-
30,
|
|
852
|
-
31,
|
|
853
|
-
][month - 1];
|
|
854
|
-
return day <= daysInMonth;
|
|
633
|
+
return !value.startsWith("0000") && RFC3339_DATE_TIME.test(value);
|
|
855
634
|
}
|
|
856
635
|
function schemaError(filename, errors) {
|
|
857
636
|
const first = errors[0];
|
|
858
|
-
const
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
: segments
|
|
862
|
-
.map((segment) => {
|
|
863
|
-
if (/^(?:0|[1-9]\d{0,9})$/.test(segment))
|
|
864
|
-
return segment;
|
|
865
|
-
return SAFE_SCHEMA_ERROR_PROPERTIES.has(segment)
|
|
866
|
-
? segment
|
|
867
|
-
: "<property>";
|
|
868
|
-
})
|
|
869
|
-
.join(".");
|
|
637
|
+
const location = first?.instancePath
|
|
638
|
+
? JSON.stringify(first.instancePath)
|
|
639
|
+
: "<root>";
|
|
870
640
|
const keyword = first?.keyword ?? "unknown";
|
|
871
641
|
const count = errors.length;
|
|
872
|
-
|
|
873
|
-
const detail = keyword === "format" && format === "date-time" ? "; date-time" : "";
|
|
874
|
-
return new ContractValidationError(`${filename}:${location}: schema validation failed (${keyword}${detail}; ${count} ${count === 1 ? "error" : "errors"}).`);
|
|
875
|
-
}
|
|
876
|
-
function sameArray(left, right) {
|
|
877
|
-
return (left.length === right.length &&
|
|
878
|
-
left.every((value, index) => value === right[index]));
|
|
879
|
-
}
|
|
880
|
-
function sameSet(left, right) {
|
|
881
|
-
return (left.size === right.size && [...left].every((value) => right.has(value)));
|
|
882
|
-
}
|
|
883
|
-
function isContained(root, candidate) {
|
|
884
|
-
const child = relative(root, candidate);
|
|
885
|
-
return (child === "" ||
|
|
886
|
-
(child !== ".." && !child.startsWith(`..${sep}`) && !isAbsolute(child)));
|
|
887
|
-
}
|
|
888
|
-
function isRecord(value) {
|
|
889
|
-
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
642
|
+
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}` : ""}.`);
|
|
890
643
|
}
|
|
891
644
|
function nodeErrorCode(error) {
|
|
892
645
|
return typeof error === "object" && error !== null && "code" in error
|
|
893
646
|
? String(error.code)
|
|
894
647
|
: undefined;
|
|
895
648
|
}
|
|
649
|
+
/** @internal */
|
|
650
|
+
export function sha256Text(value) {
|
|
651
|
+
return hash("sha256", value);
|
|
652
|
+
}
|
|
653
|
+
export function deriveFindingIdentity(scanId, targetId, ruleId, identity) {
|
|
654
|
+
const fingerprint = `codex-security/v1:sha256:${sha256Text([
|
|
655
|
+
"codex-security/v1",
|
|
656
|
+
targetId,
|
|
657
|
+
ruleId,
|
|
658
|
+
identity.anchor,
|
|
659
|
+
identity.instance ?? "",
|
|
660
|
+
].join("\0"))}`;
|
|
661
|
+
return {
|
|
662
|
+
findingId: `csf_${sha256Text(fingerprint).slice(0, 24)}`,
|
|
663
|
+
occurrenceId: `occ_${sha256Text([scanId, fingerprint].join("\0")).slice(0, 24)}`,
|
|
664
|
+
ruleId,
|
|
665
|
+
identity,
|
|
666
|
+
fingerprints: {
|
|
667
|
+
algorithm: "codex-security/v1",
|
|
668
|
+
primary: fingerprint,
|
|
669
|
+
},
|
|
670
|
+
};
|
|
671
|
+
}
|
|
896
672
|
//# sourceMappingURL=contract.js.map
|